1
+Deploying Quartz to the Web Search Icon Icon to open search
Deploying Quartz to the Web Last updated March 15, 2022
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.
Enable GitHub Actions 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!
Enable GitHub Actions
Enable GitHub Pages Head to the ‘Settings’ tab of your forked repository and go to the ‘Pages’ tab.
(IMPORTANT) Set the source to deploy from master (and not hugo) using / (root) Set a custom domain here if you have one! Enable GitHub Pages
Pushing Changes To see your changes on the internet, we need to push it them to GitHub. Quartz is a git repository so updating it is the same workflow as you would follow as if it were just a regular software project.
1
2
3
4
@@ -38,5 +38,5 @@ git push origin hugo
Have a custom domain?
Learn how to set it up with Quartz .
Now that your Quartz is live, let’s figure out how to make Quartz really yours !
🎨
Customizing Quartz
Having problems? Checkout our
-FAQ and Troubleshooting guide .
\ No newline at end of file
diff --git a/notes/ignore-notes/index.html b/notes/ignore-notes/index.html
index d2049ae7f..9b9ab0811 100644
--- a/notes/ignore-notes/index.html
+++ b/notes/ignore-notes/index.html
@@ -1,6 +1,6 @@
Ignoring Notes Search Icon Icon to open search
Ignoring Notes Last updated March 9, 2022
Quartz Ignore Edit ignoreFiles in config.toml to include paths you’d like to exclude from being rendered.
1
+1 2 3 4 5 6 .">Ignoring Notes Search Icon Icon to open search
Ignoring Notes Last updated March 15, 2022
Quartz Ignore Edit ignoreFiles in config.toml to include paths you’d like to exclude from being rendered.
1
2
3
4
@@ -24,5 +24,5 @@ draft: true
---
...
More details in
-Hugo’s documentation .
Global Ignore However, just adding to the ignoreFiles will only prevent the page from being access through Quartz. If you want to prevent the file from being pushed to GitHub (for example if you have a public repository), you need to also add the path to the .gitignore file at the root of the repository.
\ No newline at end of file
diff --git a/notes/index.html b/notes/index.html
index 372adaa52..1db707b5b 100644
--- a/notes/index.html
+++ b/notes/index.html
@@ -1,6 +1,6 @@
-
Notes Search Icon Icon to open search
+
Notes Search Icon Icon to open search
All Notes Want to see what Quartz can do? Here are some cool community gardens :)
-Quartz Documentation (this site!) Strengthening Online Social Bonds: Research Garden Jacky Zhao’s Garden Anson Yu’s Garden Shihyu’s PKM Chloe’s Garden SlRvb’s Site Course notes for Information Technology Advanced Theory Brandon Boswell’s Garden If you want to see your own on here, submit a Pull Request adding yourself to this file!...
1 minute read. Last updated March 9, 2022
Making your own Quartz Setting up Quartz requires a basic understanding of git. If you are unfamiliar, this resource is a great place to start!...
1 minute read. Last updated March 9, 2022
“[One] who works with the door open gets all kinds of interruptions, but [they] also occasionally gets clues as to what the world is and what might be important....
1 minute read. Last updated March 9, 2022
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!...
1 minute read. Last updated March 9, 2022
Setup Obsidian is the preferred way to use Quartz. You can either create a new Obsidian Vault or link one that your already have....
2 minute read. Last updated March 9, 2022
Quartz Ignore Edit ignoreFiles in config.toml to include paths you’d like to exclude from being rendered.
-1 2 3 4 5 6 ....
1 minute read. Last updated March 9, 2022
Editing Quartz runs on top of Hugo so all notes are written in Markdown.
-Obsidian I recommend using Obsidian as a way to edit and grow your digital garden....
2 minute read. Last updated March 9, 2022
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!...
2 minute read. Last updated March 9, 2022
Registrar This step is only applicable if you are using a custom domain! If you are using a <YOUR-USERNAME>.github.io domain, you can skip this step....
1 minute read. Last updated March 9, 2022
Configuration Quartz is designed to be extremely configurable. You can find the bulk of the configuration scattered throughout the repository depending on how in-depth you’d like to get....
2 minute read. Last updated March 9, 2022
1 minute read. Last updated March 15, 2022
Making your own Quartz Setting up Quartz requires a basic understanding of git. If you are unfamiliar, this resource is a great place to start!...
1 minute read. Last updated March 15, 2022
“[One] who works with the door open gets all kinds of interruptions, but [they] also occasionally gets clues as to what the world is and what might be important....
1 minute read. Last updated March 15, 2022
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!...
1 minute read. Last updated March 15, 2022
Setup Obsidian is the preferred way to use Quartz. You can either create a new Obsidian Vault or link one that your already have....
2 minute read. Last updated March 15, 2022
Quartz Ignore Edit ignoreFiles in config.toml to include paths you’d like to exclude from being rendered.
+1 2 3 4 5 6 ....
1 minute read. Last updated March 15, 2022
Editing Quartz runs on top of Hugo so all notes are written in Markdown.
+Obsidian I recommend using Obsidian as a way to edit and grow your digital garden....
2 minute read. Last updated March 15, 2022
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!...
2 minute read. Last updated March 15, 2022
Registrar This step is only applicable if you are using a custom domain! If you are using a <YOUR-USERNAME>.github.io domain, you can skip this step....
1 minute read. Last updated March 15, 2022
Configuration Quartz is designed to be extremely configurable. You can find the bulk of the configuration scattered throughout the repository depending on how in-depth you’d like to get....
2 minute read. Last updated March 15, 2022
Obsidian Vault Integration Search Icon Icon to open search
Obsidian Vault Integration Last updated March 9, 2022
Setup Obsidian is the preferred way to use Quartz. You can either create a new Obsidian Vault or link one that your already have.
New Vault If you don’t have an existing Vault,
+
Obsidian Vault Integration Search Icon Icon to open search
Obsidian Vault Integration Last updated March 15, 2022
Setup Obsidian is the preferred way to use Quartz. You can either create a new Obsidian Vault or link one that your already have.
New Vault If you don’t have an existing Vault,
download Obsidian and create a new Vault in the /content folder that you created and cloned during the
-setup step.
Linking an existing Vault The easiest way to use an existing Vault is to copy all of your files (directory and hierarchies intact) into the /content folder.
Settings Great, now that you have your Obsidian linked to your Quartz, let’s fix some settings so that they play well.
Under Options > Files and Links, set the New link format to always be Absolute Path in Vault and disabled WikiLinks so Obsidian generates regular Markdown links. Go to Settings > Files & Links > Turn “on” automatically update internal links. Use [[Wikilinks]] should be off (Wikilinks are not officially supported yet) Obsidian Settings
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.
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 recomment [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!
\ No newline at end of file
diff --git a/notes/page/2/index.html b/notes/page/2/index.html
index 0ce43eb23..a13aa7d08 100644
--- a/notes/page/2/index.html
+++ b/notes/page/2/index.html
@@ -1,4 +1,4 @@
-
Notes Search Icon Icon to open search
+
Notes Search Icon Icon to open search
All Notes Still having trouble? Here are a list of common questions and problems people encounter when installing Quartz.
-While you’re here, join our Discord :)...
3 minute read. Last updated March 9, 2022
3 minute read. Last updated March 15, 2022
Quartz Philosophy Search Icon Icon to open search
Quartz Philosophy Last updated March 9, 2022
Table of Contents Why Quartz? “[One] who works with the door open gets all kinds of interruptions, but [they] also occasionally gets clues as to what the world is and what might be important.” — Richard Hamming
Why Quartz? Hosting a public digital garden isn’t easy. There are an overwhelming number of tutorials, resources, and guides for tools like
+
Quartz Philosophy Search Icon Icon to open search
Quartz Philosophy Last updated March 15, 2022
Table of Contents Why Quartz? “[One] who works with the door open gets all kinds of interruptions, but [they] also occasionally gets clues as to what the world is and what might be important.” — Richard Hamming
Why Quartz? Hosting a public digital garden isn’t easy. There are an overwhelming number of tutorials, resources, and guides for tools like
Notion ,
Roam , and
Obsidian , yet none of them have super easy to use free tools to publish that garden to the world.
I’ve personally found that
It’s nice to access notes from anywhere Having a public digital garden invites open conversations It makes keeping personal notes and knowledge playful and fun I was really inspired by
Bianca and
-Joel ’s digital gardens and wanted to try making my own.
The goal of Quartz is to make hosting your own public digital garden free and simple. You don’t even need your own website. Quartz does all of that for you and gives your own little corner of the internet.
\ No newline at end of file
diff --git a/notes/preview-changes/index.html b/notes/preview-changes/index.html
index 92a774c5a..05902ba83 100644
--- a/notes/preview-changes/index.html
+++ b/notes/preview-changes/index.html
@@ -1,5 +1,5 @@
-
Preview Changes Search Icon Icon to open search
Preview Changes Last updated March 9, 2022
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
+
Preview Changes Search Icon Icon to open search
Preview Changes Last updated March 15, 2022
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.
1
2
3
@@ -31,5 +31,5 @@ $ cd <location-of-your-local-quartz>
$ hugo server
# View your site in a browser at http://localhost:1313/
-
\ No newline at end of file
diff --git a/notes/setup/index.html b/notes/setup/index.html
index fd11ea19a..5e0420a7e 100644
--- a/notes/setup/index.html
+++ b/notes/setup/index.html
@@ -1,5 +1,5 @@
-
Setup Search Icon Icon to open search
Setup Last updated March 9, 2022
Making your own Quartz Setting up Quartz requires a basic understanding of git. If you are unfamiliar,
+
Setup Search Icon Icon to open search
Setup Last updated March 15, 2022
Making your own Quartz Setting up Quartz requires a basic understanding of git. If you are unfamiliar,
this resource is a great place to start!
Forking A fork is a copy of a repository. Forking a repository allows you to freely experiment with changes without affecting the original project.
Navigate to the GitHub repository for the Quartz project:
📁
Quartz Repository
Then, Fork the repository into your own GitHub account. If you don’t have an account, you can make on for free
here . More details about forking a repo can be found on
@@ -7,5 +7,5 @@
$ git clone https://github.com/YOUR-USERNAME/quartz