obsidian-version-history-diff - GitLite

KO | EN

gitlite — search

#hacktoberfest #react #ai #llm #go #machine-learning #nodejs #windows #awesome #kubernetes #vue #ios #mcp #open-source

obsidian-version-history-diff

(★ 164)

Get a diff view of your Obsidian Sync, File Recovery and Git version history

파일 탐색기

최종 버전 다운로드 (.zip)

- - releases.yml
- dependabot.yml
- git-diff-colorblind-light.png
- git-diff-colorblind.png
- sync-diff-2.png
- sync-diff-3.png
- sync-diff.png
- abstract_diff_view.ts
- constants.ts
- diff_utils.ts
- diff_view.ts
- file_modal.ts
- git_diff_view.ts
- interfaces.ts
- main.ts
- recovery_diff_view.ts
- settings.ts
- styles.scss
.eslintrc.json
.gitattributes
.gitignore
.prettierrc
CHANGELOG.md
esbuild.mjs
jest.config.js
LICENSE
manifest.json
package.json
README.md
tsconfig.json
versions.json

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/kometenstaub/obsidian-version-history-diff

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd obsidian-version-history-diff

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Version History Diff (for Sync and File Recovery Core plugins and Git)

## Note

This plugin uses private APIs, so it may break at any time. Use at your own risk.

## Features

It can

1. display diffs of the **Sync** 
2. and the **File Recovery** 
3. and **Git** version history for the currently active file, 
   - For this to work, the [Obsidian Git](https://obsidian.md/plugins?id=obsidian-git) plugin needs to be installed.
4. open a selected version in a modal and 
5. render it as either markdown or 
6. plain text and 
7. you can overwrite the file with this version as well. 
8. There is a colour-blind mode
9. And you can switch between `line-by-line` and `side-by-side` view in the settings. The latter is only recommended on bigger screens.

The reason for showing you the note before you revert to this state is that the diffs can be misleading.

### Sync Diff example

![Sync Diff changes modal](https://raw.githubusercontent.com/kometenstaub/obsidian-version-history-diff/main/demo/sync-diff.png)

![Sync Diff rendered version](https://raw.githubusercontent.com/kometenstaub/obsidian-version-history-diff/main/demo/sync-diff-2.png)

![Sync Diff plain text version](https://raw.githubusercontent.com/kometenstaub/obsidian-version-history-diff/main/demo/sync-diff-3.png)

### Git Diff example with colour-blind mode

![Git Diff dark mode colourblind mode deletion](https://raw.githubusercontent.com/kometenstaub/obsidian-version-history-diff/main/demo/git-diff-colorblind.png)

![Git Diff light mode colourblind mode addition](https://raw.githubusercontent.com/kometenstaub/obsidian-version-history-diff/main/demo/git-diff-colorblind-light.png)

## Usage

There are two columns. The chosen version on the right side should be newer than the one on the left side for the diffs to make sense.

I personally find the file recovery diffs better as they are less frequent, but the Sync diffs might be helpful as well.

For *Sync*, it only displays the Sync versions. For *File Recovery* and *Git*, it also shows the current state of the file from disk as latest version.

The Git diff lets you copy the hash by clicking on it. By default, only the first seven characters are copied. `Shift-click` to copy the full hash.

## Contributing

**Please open an issue before you make a PR.**

## Credits

All licenses and attributions can be found in the `esbuild.mjs` file for the code (and therefore in the `main.js` release), the CSS license is in `src/styles.scss`. Should any license/attribution be missing, please let me know, and I will look into it.

Special thanks to @SlRvb for adapting the CSS to Obsidian and making the colour-blind mode and to @Vinzent03 for creating the necessary APIs in the Obsidian Git plugin.