2021-07-20 01:02:16 +03:00
---
title: "Preview Changes"
2022-06-30 03:03:41 +03:00
tags:
- setup
weight: -2
2021-07-20 01:02:16 +03:00
---
2022-11-21 02:09:58 +03:00
If you'd like to preview what your Quartz site looks like before deploying it to the internet, the following
instructions guide you through installing the proper dependencies to run it locally.
2021-07-20 01:02:16 +03:00
2022-02-17 18:44:39 +03:00
2021-07-20 01:02:16 +03:00
## Install `hugo-obsidian`
This step will generate the list of backlinks for Hugo to parse. Ensure you have [Go ](https://golang.org/doc/install ) (>= 1.16) installed.
2022-08-01 04:02:06 +03:00
```bash
2021-07-20 01:02:16 +03:00
# Install and link `hugo-obsidian` locally
2022-07-14 09:37:54 +03:00
go install github.com/jackyzha0/hugo-obsidian@latest
2021-07-20 01:02:16 +03:00
```
2022-02-17 18:44:39 +03:00
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.
2021-07-20 01:02:16 +03:00
Afterwards, start the Hugo server as shown above and your local backlinks and interactive graph should be populated!
## Installing Hugo
2022-01-31 23:18:26 +03:00
Hugo is the static site generator that powers Quartz. [Install Hugo with "extended" Sass/SCSS version ](https://gohugo.io/getting-started/installing/ ) first. Then,
2021-07-20 01:02:16 +03:00
2022-08-01 04:02:06 +03:00
```bash
2021-07-20 01:02:16 +03:00
# Navigate to your local Quartz folder
2022-07-14 09:37:54 +03:00
cd < location-of-your-local-quartz >
2021-07-20 01:02:16 +03:00
# Start local server
2022-07-14 09:37:54 +03:00
make serve
2021-07-20 01:02:16 +03:00
# View your site in a browser at http://localhost:1313/
2022-01-31 23:18:26 +03:00
```
2022-06-30 02:57:36 +03:00
2022-11-21 02:09:58 +03:00
> [!INFO] Docker Support
>
> If you have Docker installed already, open your terminal, navigate to your folder with Quartz and run `make docker`
Now that you are happy with how your Quartz instance looks, let's get it hosted!
> 🌍 Step 5: [Hosting Quartz online!](notes/hosting.md)