From f1c9ca495e450ecb62dade70c4b60d86e106f79c Mon Sep 17 00:00:00 2001 From: vintro <77507980+vintrocode@users.noreply.github.com> Date: Sun, 13 Aug 2023 20:19:50 -0400 Subject: [PATCH] docs: note about existing content at same path on different branches --- content/index.md | 2 +- content/migrating from Quartz 3.md | 3 +++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/content/index.md b/content/index.md index cf97d31fd..45681516f 100644 --- a/content/index.md +++ b/content/index.md @@ -37,7 +37,7 @@ This will guide you through initializing your Quartz with content. Once you've d - [[SPA Routing|Ridiculously fast page loads]] and tiny bundle sizes - Fully-customizable parsing, filtering, and page generation through [[making plugins|plugins]] -For a comprehensive list of features, visit the [features page](/features). You can read more the _why_ behind these features on the [[philosophy]] page and a technical overview on the [[architecture]] page. +For a comprehensive list of features, visit the [features page](/features). You can read more about the _why_ behind these features on the [[philosophy]] page and a technical overview on the [[architecture]] page. ### 🚧 Troubleshooting + Updating diff --git a/content/migrating from Quartz 3.md b/content/migrating from Quartz 3.md index d3feb3fb9..f322e86f9 100644 --- a/content/migrating from Quartz 3.md +++ b/content/migrating from Quartz 3.md @@ -13,6 +13,9 @@ npx quartz create When running `npx quartz create`, you will be prompted as to how to initialize your content folder. Here, you can choose to import or link your previous content folder and Quartz should work just as you expect it to. +> [!note] +> If the existing content folder you'd like to use is at the _same_ path on a different branch, clone the repo again somewhere at a _different_ path in order to use it. + ## Key changes 1. **Removing Hugo and `hugo-obsidian`**: Hugo worked well for earlier versions of Quartz but it also made it hard for people outside of the Golang and Hugo communities to fully understand what Quartz was doing under the hood and be able to properly customize it to their needs. Quartz 4 now uses a Node-based static-site generation process which should lead to a much more helpful error messages and an overall smoother user experience.