mirror of
https://github.com/falsycat/ar.falsy.cat.git
synced 2024-08-24 16:23:48 +00:00
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.
1.4 KiB
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/