docs: make update command and clarify update steps/potential danger

hugo
Jacky Zhao 3 years ago
parent 9509a64354
commit a7abc6ab96

@ -9,5 +9,10 @@ update: ## Update Quartz to the latest version on Github
git log --oneline --decorate --graph ..upstream/hugo git log --oneline --decorate --graph ..upstream/hugo
git checkout -p upstream/hugo -- layouts .github Makefile assets/js assets/styles/base.scss assets/styles/darkmode.scss config.toml data git checkout -p upstream/hugo -- layouts .github Makefile assets/js assets/styles/base.scss assets/styles/darkmode.scss config.toml data
update-force: ## Forcefully pull all changes and don't ask to patch
@git remote show upstream || (echo "remote 'upstream' not present, setting 'upstream'" && git remote add upstream https://github.com/jackyzha0/quartz.git)
git fetch upstream
git checkout upstream/hugo -- layouts .github Makefile assets/js assets/styles/base.scss assets/styles/darkmode.scss config.toml data
serve: ## Serve Quartz locally serve: ## Serve Quartz locally
hugo-obsidian -input=content -output=assets/indices -index -root=. && hugo server --enableGitInfo hugo-obsidian -input=content -output=assets/indices -index -root=. && hugo server --enableGitInfo

@ -31,11 +31,21 @@ Great! Now you have everything you need to start editing and growing your digita
Having problems? Checkout our [FAQ and Troubleshooting guide](notes/troubleshooting.md). Having problems? Checkout our [FAQ and Troubleshooting guide](notes/troubleshooting.md).
## Updating ## Updating
Haven't updated Quartz in a while and want all the cool new optimizations? Haven't updated Quartz in a while and want all the cool new optimizations? On Unix/Mac systems you can run the following command for a one-line update! This command will show you a log summary of all commits since you last updated, press `q` to acknowledge this. Then, it will show you each change in turn and press `y` to accept the patch or `n` to reject it. Usually you should press `y` for most of these unless it conflicts with existing changes you've made!
```shell
make update
# or, if you don't want the interactive parts and just want the update
make update-force
```
Or, manually checkout the changes yourself.
> ⚠️ **WARNING** ⚠️ > ⚠️ **WARNING** ⚠️
> >
> if you customized `assets/styles/custom.scss`, the files in `data/`, or anything inside `layouts/`, your customization may be overwritten! > If you customized the files in `data/`, or anything inside `layouts/`, your customization may be overwritten!
> Make sure you have a copy of these changes if you don't want to lose them.
```shell ```shell
@ -44,5 +54,5 @@ git remote add upstream git@github.com:jackyzha0/quartz.git
# index and fetch changes # index and fetch changes
git fetch upstream git fetch upstream
git checkout upstream/hugo -- layouts .github Makefile assets config.toml data static git checkout -p upstream/hugo -- layouts .github Makefile assets/js assets/styles/base.scss assets/styles/darkmode.scss config.toml data
``` ```

Loading…
Cancel
Save