| | |
|---|
| | | As you already have Quartz locally, you don't need to fork or clone it again. Simply just checkout the alpha branch, install the dependencies, and import your old vault. |
|---|
| | | |
|---|
| | | ```bash |
|---|
| | | git fetch |
|---|
| | | git checkout v4 |
|---|
| | | git pull upstream v4 |
|---|
| | | npm i |
|---|
| | | npx quartz create |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | If you get an error like `fatal: 'upstream' does not appear to be a git repository`, make sure you add `upstream` as a remote origin: |
|---|
| | | |
|---|
| | | ```shell |
|---|
| | | git remote add upstream https://github.com/jackyzha0/quartz.git |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | 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] |
|---|
| | |
|---|
| | | |
|---|
| | | ## Things to update |
|---|
| | | |
|---|
| | | - You will need to update your deploy scripts. See the [[hosting]] guide for more details. |
|---|
| | | - Ensure that your default branch on GitHub is updated from `hugo` to `v4`. |
|---|
| | | - Some HTML layout may not be the same between Quartz 3 and Quartz 4. If you depended on a particular HTML hierarchy or class names, you may need to update your custom CSS to reflect these changes. |
|---|
| | | - If you customized the layout of Quartz 3, you may need to translate these changes from Go templates back to JSX as Quartz 4 no longer uses Hugo. For components, check out the guide on [[creating components]] for more details on this. |
|---|
| | | - You will also need to update your deploy scripts. See the [[hosting]] guide for more details. |
|---|
