docs: update to account for github changes

This commit is contained in:
Jacky Zhao 2023-03-02 09:14:29 -08:00
parent ecba6071b8
commit aa5ab03d4a
11 changed files with 29 additions and 35 deletions

View file

@ -1,5 +1,5 @@
--- ---
title: 🪴 Quartz 3. title: 🪴 Quartz 3.3
enableToc: false enableToc: false
--- ---

View file

@ -15,24 +15,10 @@ Here's a rough overview of what's what.
**To edit the main home page, open `/content/_index.md`.** **To edit the main home page, open `/content/_index.md`.**
To create a link between notes in your garden, just create a normal link using Markdown pointing to the document in question. Please note that **all links should be relative to the root `/content` path**.
```markdown
For example, I want to link this current document to `notes/config.md`.
[A link to the config page](notes/config.md)
```
Similarly, you can put local images anywhere in the `/content` folder.
```markdown
Example image (source is in content/notes/images/example.png)
![Example Image](/content/notes/images/example.png)
```
You can also use wikilinks if that is what you are more comfortable with!
### Front Matter ### Front Matter
Hugo is picky when it comes to metadata for files. Make sure that your title is double-quoted and that you have a title defined at the top of your file like so. You can also add tags here as well. Hugo is picky when it comes to metadata for files. Make sure that your title is double-quoted and that you have a title defined at the top of your file like so, otherwise the generated page will not have a title!
You can also add tags here as well.
```yaml ```yaml
--- ---

View file

@ -10,10 +10,13 @@ aliases:
## Hosting on GitHub Pages ## Hosting on GitHub Pages
Quartz is designed to be effortless to deploy. If you forked and cloned Quartz directly from the repository, everything should already be good to go! Follow the steps below. Quartz is designed to be effortless to deploy. If you forked and cloned Quartz directly from the repository, everything should already be good to go! Follow the steps below.
### Enable GitHub Actions ### Enable GitHub Actions Permissions
By default, GitHub disables workflows from running automatically on Forked Repostories. Head to the 'Actions' tab of your forked repository and Enable Workflows to setup deploying your Quartz site! By default, GitHub disables workflows from modifying your files (for good reason!). However, Quartz needs this to write the actual site files back to GitHub.
![Enable GitHub Actions](notes/images/github-actions.png)*Enable GitHub Actions* Head to `Settings > Action > General > Workflow Permissions` and choose `Read and Write Permissions`
![[notes/images/github-actions.png]]
*Enable GitHub Actions*
### Enable GitHub Pages ### Enable GitHub Pages

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 116 KiB

After

Width:  |  Height:  |  Size: 65 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 26 KiB

After

Width:  |  Height:  |  Size: 44 KiB

View file

@ -19,15 +19,18 @@ Great, now that you have your Obsidian linked to your Quartz, let's fix some set
Open Settings > Files & Links and look for these two items: Open Settings > Files & Links and look for these two items:
1. Set the **New link format** to **Absolute Path in vault**. 1. Set the **New link format** to **Absolute Path in vault**. If you have a completely flat vault (no folders), this step isn't necessary.
2. Turn **on** the **Automatically update internal links** setting. 2. Turn **on** the **Automatically update internal links** setting.
![Obsidian Settings](/notes/images/obsidian-settings.png)*Obsidian Settings*
![[notes/images/obsidian-settings.png]]*Obsidian Settings*
## Templates ## Templates
Inserting front matter everytime you want to create a new Note gets annoying really quickly. Luckily, Obsidian supports templates which makes inserting new content really easily. Inserting front matter everytime you want to create a new Note gets annoying really quickly. Luckily, Obsidian supports templates which makes inserting new content really easily.
**If you decide to overwrite the `/content` folder completely, don't remove the `/content/templates` folder!** > [!WARNING]
>
> **If you decide to overwrite the `/content` folder completely, don't remove the `/content/templates` folder!**
Head over to Options > Core Plugins and enable the Templates plugin. Then go to Options > Hotkeys and set a hotkey for 'Insert Template' (I recommend `[cmd]+T`). That way, when you create a new note, you can just press the hotkey for a new template and be ready to go! Head over to Options > Core Plugins and enable the Templates plugin. Then go to Options > Hotkeys and set a hotkey for 'Insert Template' (I recommend `[cmd]+T`). That way, when you create a new note, you can just press the hotkey for a new template and be ready to go!

View file

@ -17,9 +17,7 @@ This step will generate the list of backlinks for Hugo to parse. Ensure you have
go install github.com/jackyzha0/hugo-obsidian@latest go install github.com/jackyzha0/hugo-obsidian@latest
``` ```
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. If you are running into an error saying that `command not found: hugo-obsidian`, make sure you set your `GOPATH` correctly (see [[notes/troubleshooting#`command not found: hugo-obsidian`|the troubleshooting page]])! 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 ## Installing Hugo
Hugo is the static site generator that powers Quartz. [Install Hugo with "extended" Sass/SCSS version](https://gohugo.io/getting-started/installing/) first. Then, Hugo is the static site generator that powers Quartz. [Install Hugo with "extended" Sass/SCSS version](https://gohugo.io/getting-started/installing/) first. Then,
@ -36,8 +34,8 @@ make serve
> [!INFO] Docker Support > [!INFO] Docker Support
> >
> If you have Docker installed already, open your terminal, navigate to your folder with Quartz and run `make docker` > If you have the Docker CLI installed already, you can avoid installing `hugo-obsidian` and `hugo`. Instead, 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! Afterwards, start the Hugo server as shown above and your local backlinks and interactive graph should be populated! Now, let's get it hosted online.
> 🌍 Step 5: [Hosting Quartz online!](notes/hosting.md) > 🌍 Step 5: [Hosting Quartz online!](notes/hosting.md)

View file

@ -15,10 +15,14 @@ Navigate to the GitHub repository for the Quartz project:
📁 [Quartz Repository](https://github.com/jackyzha0/quartz) 📁 [Quartz Repository](https://github.com/jackyzha0/quartz)
Then, Fork the repository into your own GitHub account. If you don't have an account, you can make on for free [here](https://github.com/join). More details about forking a repo can be found on [GitHub's documentation](https://docs.github.com/en/get-started/quickstart/fork-a-repo). Then, Fork the repository into your own GitHub account. **Make sure that when you fork, you _uncheck_ the 'Copy the `hugo` branch only' option**.
If you don't have an account, you can make on for free [here](https://github.com/join). More details about forking a repo can be found on [GitHub's documentation](https://docs.github.com/en/get-started/quickstart/fork-a-repo).
![[notes/images/fork.png]]
### Cloning ### Cloning
After you've made a fork of the repository, you need to download the files locally onto your machine. Ensure you have `git`, then type the following command replacing `YOUR-USERNAME` with your GitHub username. After you've made a fork of the repository, you need to download the files locally onto your machine. Ensure you have `git`, then type the following command in your terminal replacing `YOUR-USERNAME` with your GitHub username.
```shell ```shell
git clone https://github.com/YOUR-USERNAME/quartz git clone https://github.com/YOUR-USERNAME/quartz

View file

@ -38,12 +38,12 @@ Yes! All built files can be found under `/public` in the `master` branch. More d
Make sure you set your `GOPATH` correctly! This will allow your terminal to correctly recognize `hugo-obsidian` as an executable. Make sure you set your `GOPATH` correctly! This will allow your terminal to correctly recognize `hugo-obsidian` as an executable.
```shell ```shell
# Add the following 2 lines to your ~/.bash_profile # Add the following 2 lines to your ~/.bash_profile (~/.zshrc if you are on Mac)
export GOPATH=/Users/$USER/go export GOPATH=/Users/$USER/go
export PATH=$GOPATH/bin:$PATH export PATH=$GOPATH/bin:$PATH
# In your current terminal, to reload the session # In your current terminal, to reload the session
source ~/.bash_profile source ~/.bash_profile # again, (~/.zshrc if you are on Mac)
``` ```
### How come my notes aren't being rendered? ### How come my notes aren't being rendered?

View file

@ -71,8 +71,8 @@
{{partial "mermaid.html" .}} {{partial "mermaid.html" .}}
<script async src="https://unpkg.com/@floating-ui/core@0.7.3"></script> <script src="https://cdn.jsdelivr.net/npm/@floating-ui/core@1.2.1"></script>
<script async src="https://unpkg.com/@floating-ui/dom@0.5.4"></script> <script src="https://cdn.jsdelivr.net/npm/@floating-ui/dom@1.2.1"></script>
{{ $popover := resources.Get "js/popover.js" | resources.Fingerprint "md5" | {{ $popover := resources.Get "js/popover.js" | resources.Fingerprint "md5" |
resources.Minify }} resources.Minify }}
<script async src="{{$popover.Permalink}}"></script> <script async src="{{$popover.Permalink}}"></script>