quartz-research-note/content/notes/preview changes.md
Claudio Yanes 30a6697c5b Update makefile and docs
The artifacts produced by hugo-obsidian are now expected to be placed in
the assets/indices directory. This commit reflects this change in the
Makefile and in the docs.
2022-03-04 22:27:21 +00:00

1.4 KiB

title
Preview Changes

If you'd like to preview what your Quartz site looks like before deploying it to the internet, here's exactly how to do that!

Note that both of these steps need to be completed.

Install hugo-obsidian

This step will generate the list of backlinks for Hugo to parse. Ensure you have Go (>= 1.16) installed.

# Install and link `hugo-obsidian` locally
$ go install github.com/jackyzha0/hugo-obsidian@latest

# Navigate to your local Quartz folder
$ cd <location-of-your-local-quartz>

# Scrape all links in your Quartz folder and generate info for Quartz
$ hugo-obsidian -input=content -output=assets/indices -index -root=.

If you are running into an error saying that command not found: hugo-obsidian, make sure you set your GOPATH correctly! This will allow your terminal to correctly recognize hugo-obsidian as an executable.

Afterwards, start the Hugo server as shown above and your local backlinks and interactive graph should be populated!

Installing Hugo

Hugo is the static site generator that powers Quartz. Install Hugo with "extended" Sass/SCSS version first. Then,

# Navigate to your local Quartz folder
$ cd <location-of-your-local-quartz>

# Start local server
$ hugo server

# View your site in a browser at http://localhost:1313/