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.
For this last bit to take effect, you also need to create a CNAME record with the DNS provider you register your domain with (i.e. NameCheap, Google Domains).
Go to your forked repository (github.com/<YOUR-GITHUB-USERNAME>/quartz) settings page and go to the Pages tab. Under “Custom domain”, type your custom domain, then click Save.
Go to your DNS Provider and create a CNAME record that points from your domain to <YOUR-GITHUB-USERNAME.github.io. (yes, with the trailing period).
Example Configuration for Quartz
Wait 30 minutes to an hour for the network changes to kick in.
\ No newline at end of file
diff --git a/index.html b/index.html
index 97e87a081..471479300 100644
--- a/index.html
+++ b/index.html
@@ -1,4 +1,4 @@
-šŖ“ Quartz 3
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.
The majority of configuration can be be found under data/config.yaml. An annotated example configuration is shown below.
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.
The majority of configuration can be be found under data/config.yaml. An annotated example configuration is shown below.
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.
For this last bit to take effect, you also need to create a CNAME record with the DNS provider you register your domain with (i.e. NameCheap, Google Domains).
Go to your forked repository (github.com/<YOUR-GITHUB-USERNAME>/quartz) settings page and go to the Pages tab. Under “Custom domain”, type your custom domain, then click Save.
Go to your DNS Provider and create a CNAME record that points from your domain to <YOUR-GITHUB-USERNAME.github.io. (yes, with the trailing period).
Example Configuration for Quartz
Wait 30 minutes to an hour for the network changes to kick in.
\ No newline at end of file
diff --git a/notes/editing/index.html b/notes/editing/index.html
index 3b276c962..9367ca455 100644
--- a/notes/editing/index.html
+++ b/notes/editing/index.html
@@ -1,5 +1,5 @@
Editing Content in Quartz
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. It comes with a really nice editor and graphical interface to preview all of your local files.
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 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 essentially a git repository so updating it is the same workflow as you would follow as normal.
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 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 essentially a git repository so updating it is the same workflow as you would follow as normal.
\ No newline at end of file
diff --git a/notes/ignore-notes/index.html b/notes/ignore-notes/index.html
index 5401eb6a7..da4b88cc2 100644
--- a/notes/ignore-notes/index.html
+++ b/notes/ignore-notes/index.html
@@ -1,5 +1,5 @@
Ignoring 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 :)...
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 If you want to see your own on here, submit a Pull Request adding yourself to this file!...
ā[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....
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....
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!...
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....
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 If you want to see your own on here, submit a Pull Request adding yourself to this file!...
ā[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....
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....
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!...
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....
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....
\ No newline at end of file
diff --git a/notes/index.xml b/notes/index.xml
index f72d462da..5cc1f47e8 100644
--- a/notes/index.xml
+++ b/notes/index.xml
@@ -1,4 +1,4 @@
-Notes onhttps://quartz.jzhao.xyz/notes/Recent content in Notes onHugo -- gohugo.ioen-usConfigurationhttps://quartz.jzhao.xyz/notes/config/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/config/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.Deploying Quartz to the Webhttps://quartz.jzhao.xyz/notes/hosting/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/hosting/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!Editing Content in Quartzhttps://quartz.jzhao.xyz/notes/editing/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/editing/Editing Quartz runs on top of Hugo so all notes are written in Markdown.
+Notes onhttps://quartz.jzhao.xyz/notes/Recent content in Notes onHugo -- gohugo.ioen-usConfigurationhttps://quartz.jzhao.xyz/notes/config/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/config/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.Custom Domainhttps://quartz.jzhao.xyz/notes/custom-Domain/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/custom-Domain/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.Deploying Quartz to the Webhttps://quartz.jzhao.xyz/notes/hosting/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/hosting/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!Editing Content in Quartzhttps://quartz.jzhao.xyz/notes/editing/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/editing/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.Ignoring Noteshttps://quartz.jzhao.xyz/notes/ignore-notes/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/ignore-notes/Quartz Ignore Edit ignoreFiles in config.toml to include paths you’d like to exclude from being rendered.
1 2 3 4 5 6 .Obsidian Vault Integrationhttps://quartz.jzhao.xyz/notes/obsidian/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/obsidian/Setup Obsidian is the preferred way to use Quartz. You can either create a new Obsidian Vault or link one that your already have.Preview Changeshttps://quartz.jzhao.xyz/notes/preview-changes/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/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!Quartz Philosophyhttps://quartz.jzhao.xyz/notes/philosophy/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/philosophy/ā[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.Setuphttps://quartz.jzhao.xyz/notes/setup/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/setup/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!Showcasehttps://quartz.jzhao.xyz/notes/showcase/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/showcase/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 If you want to see your own on here, submit a Pull Request adding yourself to this file!Troubleshooting and FAQhttps://quartz.jzhao.xyz/notes/troubleshooting/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/troubleshooting/Still having trouble? Here are a list of common questions and problems people encounter when installing Quartz.
diff --git a/notes/obsidian/index.html b/notes/obsidian/index.html
index 18fe50aab..1f6424f3c 100644
--- a/notes/obsidian/index.html
+++ b/notes/obsidian/index.html
@@ -1,4 +1,4 @@
-Obsidian Vault Integration
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
new file mode 100644
index 000000000..ae2441c2a
--- /dev/null
+++ b/notes/page/2/index.html
@@ -0,0 +1,13 @@
+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 :)...
\ No newline at end of file
diff --git a/notes/philosophy/index.html b/notes/philosophy/index.html
index 6591e002a..2aa81e66e 100644
--- a/notes/philosophy/index.html
+++ b/notes/philosophy/index.html
@@ -1,4 +1,4 @@
-Quartz Philosophy
ā[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
Last updated January 27, 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.ā ā 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
diff --git a/notes/preview-changes/index.html b/notes/preview-changes/index.html
index f8c373da3..a779c64d3 100644
--- a/notes/preview-changes/index.html
+++ b/notes/preview-changes/index.html
@@ -1,4 +1,4 @@
-
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
diff --git a/notes/showcase/index.html b/notes/showcase/index.html
index 5e5aaf24b..f7bfd5aa0 100644
--- a/notes/showcase/index.html
+++ b/notes/showcase/index.html
@@ -1,5 +1,5 @@
\ No newline at end of file
diff --git a/notes/troubleshooting/index.html b/notes/troubleshooting/index.html
index 3010325cc..e2bcefd7a 100644
--- a/notes/troubleshooting/index.html
+++ b/notes/troubleshooting/index.html
@@ -1,5 +1,5 @@
Troubleshooting and FAQ
Some of my pages have ‘January 1, 0001’ as the last modified date
This is a problem caused by git treating files as case-insensitive by default and some of your posts probably have capitalized file names. You can turn this off in your Quartz by running this command.
1
2
3
diff --git a/sitemap.xml b/sitemap.xml
index 702a1fa4d..eefe0b5e5 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1 +1 @@
-https://quartz.jzhao.xyz/custom-Domain/0https://quartz.jzhao.xyz/categories/https://quartz.jzhao.xyz/notes/config/2022-01-10T13:08:50-08:00https://quartz.jzhao.xyz/notes/hosting/2022-01-10T13:08:50-08:00https://quartz.jzhao.xyz/notes/editing/2022-01-10T13:08:50-08:00https://quartz.jzhao.xyz/notes/ignore-notes/2022-01-10T13:08:50-08:00https://quartz.jzhao.xyz/notes/2022-01-10T13:08:50-08:00https://quartz.jzhao.xyz/notes/obsidian/2022-01-10T13:08:50-08:00https://quartz.jzhao.xyz/notes/preview-changes/2022-01-10T13:08:50-08:00https://quartz.jzhao.xyz/notes/philosophy/2022-01-10T13:08:50-08:00https://quartz.jzhao.xyz/notes/setup/2022-01-10T13:08:50-08:00https://quartz.jzhao.xyz/tags/setup/2022-01-10T13:08:50-08:00https://quartz.jzhao.xyz/notes/showcase/2022-01-10T13:08:50-08:00https://quartz.jzhao.xyz/tags/2022-01-10T13:08:50-08:00https://quartz.jzhao.xyz/notes/troubleshooting/2022-01-10T13:08:50-08:00https://quartz.jzhao.xyz/2022-01-10T13:08:50-08:00
\ No newline at end of file
+https://quartz.jzhao.xyz/categories/https://quartz.jzhao.xyz/notes/config/2022-01-27T09:38:28-08:00https://quartz.jzhao.xyz/notes/custom-Domain/2022-01-27T09:38:28-08:00https://quartz.jzhao.xyz/notes/hosting/2022-01-27T09:38:28-08:00https://quartz.jzhao.xyz/notes/editing/2022-01-27T09:38:28-08:00https://quartz.jzhao.xyz/notes/ignore-notes/2022-01-27T09:38:28-08:00https://quartz.jzhao.xyz/notes/2022-01-27T09:38:28-08:00https://quartz.jzhao.xyz/notes/obsidian/2022-01-27T09:38:28-08:00https://quartz.jzhao.xyz/notes/preview-changes/2022-01-27T09:38:28-08:00https://quartz.jzhao.xyz/notes/philosophy/2022-01-27T09:38:28-08:00https://quartz.jzhao.xyz/notes/setup/2022-01-27T09:38:28-08:00https://quartz.jzhao.xyz/tags/setup/2022-01-27T09:38:28-08:00https://quartz.jzhao.xyz/notes/showcase/2022-01-27T09:38:28-08:00https://quartz.jzhao.xyz/tags/2022-01-27T09:38:28-08:00https://quartz.jzhao.xyz/notes/troubleshooting/2022-01-27T09:38:28-08:00https://quartz.jzhao.xyz/2022-01-27T09:38:28-08:00
\ No newline at end of file
diff --git a/tags/index.html b/tags/index.html
index c2d32e1e3..3d7fa59f1 100644
--- a/tags/index.html
+++ b/tags/index.html
@@ -1,4 +1,4 @@
-Tags
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 January 27, 2022
\ No newline at end of file
diff --git a/tags/setup/index.html b/tags/setup/index.html
index f86fd7acd..a324dfa75 100644
--- a/tags/setup/index.html
+++ b/tags/setup/index.html
@@ -1,4 +1,4 @@
-setup
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....
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!...
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....
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....
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!...
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....
Example Configuration for Quartz
Example Configuration for Quartz
Enable GitHub Actions
Enable GitHub Pages
Obsidian Settings