From d76d8cb0fe1012a31d2a7fcc8f92c1c560bfd375 Mon Sep 17 00:00:00 2001 From: jackyzha0 Date: Mon, 25 Oct 2021 06:46:34 +0000 Subject: [PATCH] deploy: 1835b97a7a2faf23809bb39d0bec7a2b77b3b81c --- index.html | 22 +++++++--------------- index.xml | 3 ++- moc/showcase/index.html | 4 ++-- notes/config/index.html | 4 ++-- notes/editing/index.html | 4 ++-- notes/external-hosting/index.html | 4 ++-- notes/hosting/index.html | 4 ++-- notes/ignore-notes/index.html | 4 ++-- notes/index.xml | 3 ++- notes/obsidian/index.html | 4 ++-- notes/philosophy/index.html | 18 ++++++++++++++++++ notes/preview-changes/index.html | 4 ++-- notes/setup/index.html | 4 ++-- notes/troubleshooting/index.html | 4 ++-- sitemap.xml | 2 +- 15 files changed, 50 insertions(+), 38 deletions(-) create mode 100644 notes/philosophy/index.html diff --git a/index.html b/index.html index 0a48ffdd1..71ec39570 100644 --- a/index.html +++ b/index.html @@ -1,24 +1,16 @@ -🪓 Quartz v2.1

🪓 Quartz v2.1

Search IconIcon to open search
-

Host your second brain and digital garden -for free.

Curious what it can do? You’re on it right now! The entire Quartz documentation is fully hosted using Quartz.

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

  1. It’s nice to access notes from anywhere
  2. Having a public digital garden invites open conversations
  3. It makes keeping personal notes and knowledge playful and fun

ā€œ[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

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.

Get Started

šŸ“š +for free. Quartz features

  1. Extremely fast full-text search by pressing /
  2. Beautiful, out-of-the-box website creation and deployment
  3. Display for backlinks of each note
  4. A customizable graph view
  5. Endlessly powerful page and theme customization

Get Started

šŸ“š Setup your own digital garden using Quartz

Not convinced yet? Look at some community digital gardens -built with Quartz!

Troubleshooting


Interactive Graph

\ No newline at end of file +Submit an Issue

Interactive Graph

\ No newline at end of file diff --git a/index.xml b/index.xml index d171ff6e0..fb9eb1c64 100644 --- a/index.xml +++ b/index.xml @@ -10,7 +10,8 @@ Of course, all the files are in Markdown so you could just use your favourite te 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 . Linking an existing Vault The easiest way to use an existing Vault is to copy all of our files (directory and hierarchies intact) into the /content folder.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! 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 4 5 6 7 8 # Install and link `hugo-obsidian` locally $ go install github.com/jackyzha0/hugo-obsidian # 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=data -index=true Afterwards, start the Hugo server as shown above and your local backlinks and interactive graph should be populated!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! +1 2 3 4 5 6 7 8 # Install and link `hugo-obsidian` locally $ go install github.com/jackyzha0/hugo-obsidian # 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=data -index=true Afterwards, start the Hugo server as shown above and your local backlinks and interactive graph should be populated!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.ā€ — 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.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! 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.Showcasehttps://quartz.jzhao.xyz/moc/showcase/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/moc/showcase/Want to see what Quartz can do? Here are some cool community gardens :) diff --git a/moc/showcase/index.html b/moc/showcase/index.html index 725fa39c7..4c0725912 100644 --- a/moc/showcase/index.html +++ b/moc/showcase/index.html @@ -1,4 +1,4 @@ -Showcase

Showcase

Search IconIcon to open search

Interactive Graph

Made by Jacky Zhao using Quartz, Ā© 2021

Home +!


Interactive Graph

\ No newline at end of file diff --git a/notes/config/index.html b/notes/config/index.html index 4fc52049e..80a5a3a05 100644 --- a/notes/config/index.html +++ b/notes/config/index.html @@ -1,4 +1,4 @@ -Configuration

Interactive Graph

Made by Jacky Zhao using Quartz, Ā© 2021

Home +.


Interactive Graph

\ No newline at end of file diff --git a/notes/editing/index.html b/notes/editing/index.html index 6056784a2..6e45877cc 100644 --- a/notes/editing/index.html +++ b/notes/editing/index.html @@ -1,4 +1,4 @@ -Editing Content in Quartz

Interactive Graph

Made by Jacky Zhao using Quartz, Ā© 2021

Home +.


Interactive Graph

\ No newline at end of file diff --git a/notes/external-hosting/index.html b/notes/external-hosting/index.html index 015f4aa12..9606f8fc6 100644 --- a/notes/external-hosting/index.html +++ b/notes/external-hosting/index.html @@ -1,8 +1,8 @@ -External Hosting

External Hosting

Search IconIcon to open search
-

Interactive Graph

Made by Jacky Zhao using Quartz, Ā© 2021

Home +

Interactive Graph

\ No newline at end of file diff --git a/notes/hosting/index.html b/notes/hosting/index.html index 57aeaa51c..3bddb5bc1 100644 --- a/notes/hosting/index.html +++ b/notes/hosting/index.html @@ -1,4 +1,4 @@ -Deploying Quartz to the Web

Interactive Graph

Made by Jacky Zhao using Quartz, Ā© 2021

Home +.


Interactive Graph

\ No newline at end of file diff --git a/notes/ignore-notes/index.html b/notes/ignore-notes/index.html index f080bc02c..a48a9d92a 100644 --- a/notes/ignore-notes/index.html +++ b/notes/ignore-notes/index.html @@ -1,4 +1,4 @@ -Ignoring Notes

Interactive Graph

Made by Jacky Zhao using Quartz, Ā© 2021

Home +.

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.


Interactive Graph

\ No newline at end of file diff --git a/notes/index.xml b/notes/index.xml index 7a7b4df78..89e85951e 100644 --- a/notes/index.xml +++ b/notes/index.xml @@ -10,7 +10,8 @@ Of course, all the files are in Markdown so you could just use your favourite te 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 . Linking an existing Vault The easiest way to use an existing Vault is to copy all of our files (directory and hierarchies intact) into the /content folder.
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! 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 4 5 6 7 8 # Install and link `hugo-obsidian` locally $ go install github.com/jackyzha0/hugo-obsidian # 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=data -index=true Afterwards, start the Hugo server as shown above and your local backlinks and interactive graph should be populated!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! +1 2 3 4 5 6 7 8 # Install and link `hugo-obsidian` locally $ go install github.com/jackyzha0/hugo-obsidian # 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=data -index=true Afterwards, start the Hugo server as shown above and your local backlinks and interactive graph should be populated!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.ā€ — 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.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! 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.Troubleshooting and FAQhttps://quartz.jzhao.xyz/notes/troubleshooting/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/troubleshooting/Common Pitfalls Can I publish only a subset of my pages? Yes! Quartz makes selective publishing really easy. Heres a guide on excluding pages from being published . diff --git a/notes/obsidian/index.html b/notes/obsidian/index.html index f03ad061a..61a792319 100644 --- a/notes/obsidian/index.html +++ b/notes/obsidian/index.html @@ -1,4 +1,4 @@ -Obsidian Vault Integration

Interactive Graph

Made by Jacky Zhao using Quartz, Ā© 2021

Home +.

Linking an existing Vault

The easiest way to use an existing Vault is to copy all of our 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.

Obsidian SettingsObsidian Settings

Templates

Inserting front matter everytime you want to create a new Note gets really 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’. That way, when you create a new note, you can just press the hotkey for a new template and be ready to go!


Interactive Graph

\ No newline at end of file diff --git a/notes/philosophy/index.html b/notes/philosophy/index.html new file mode 100644 index 000000000..0353c64bb --- /dev/null +++ b/notes/philosophy/index.html @@ -0,0 +1,18 @@ +Quartz Philosophy

Quartz Philosophy

Search IconIcon to open search
+

ā€œ[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

  1. It’s nice to access notes from anywhere
  2. Having a public digital garden invites open conversations
  3. 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.


Interactive Graph

\ No newline at end of file diff --git a/notes/preview-changes/index.html b/notes/preview-changes/index.html index f06b1908b..e2f138cc4 100644 --- a/notes/preview-changes/index.html +++ b/notes/preview-changes/index.html @@ -1,4 +1,4 @@ -Preview Changes

Interactive Graph


Interactive Graph

\ No newline at end of file diff --git a/notes/setup/index.html b/notes/setup/index.html index 256911373..31fd14f25 100644 --- a/notes/setup/index.html +++ b/notes/setup/index.html @@ -1,4 +1,4 @@ -Setup

Interactive Graph

Made by Jacky Zhao using Quartz, Ā© 2021

Home +.


Interactive Graph

\ No newline at end of file diff --git a/notes/troubleshooting/index.html b/notes/troubleshooting/index.html index 3d140dbe1..b53aab371 100644 --- a/notes/troubleshooting/index.html +++ b/notes/troubleshooting/index.html @@ -1,4 +1,4 @@ -Troubleshooting and FAQ

Interactive Graph

Made by Jacky Zhao using Quartz, Ā© 2021

Home +Submit an Issue


Interactive Graph

\ No newline at end of file diff --git a/sitemap.xml b/sitemap.xml index e49796509..28a15293c 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -1 +1 @@ -https://quartz.jzhao.xyz/categories/https://quartz.jzhao.xyz/notes/config/https://quartz.jzhao.xyz/notes/hosting/https://quartz.jzhao.xyz/notes/editing/https://quartz.jzhao.xyz/notes/external-hosting/https://quartz.jzhao.xyz/notes/ignore-notes/https://quartz.jzhao.xyz/moc/https://quartz.jzhao.xyz/notes/https://quartz.jzhao.xyz/notes/obsidian/https://quartz.jzhao.xyz/notes/preview-changes/https://quartz.jzhao.xyz/notes/setup/https://quartz.jzhao.xyz/moc/showcase/https://quartz.jzhao.xyz/tags/https://quartz.jzhao.xyz/notes/troubleshooting/https://quartz.jzhao.xyz/ \ No newline at end of file +https://quartz.jzhao.xyz/categories/https://quartz.jzhao.xyz/notes/config/https://quartz.jzhao.xyz/notes/hosting/https://quartz.jzhao.xyz/notes/editing/https://quartz.jzhao.xyz/notes/external-hosting/https://quartz.jzhao.xyz/notes/ignore-notes/https://quartz.jzhao.xyz/moc/https://quartz.jzhao.xyz/notes/https://quartz.jzhao.xyz/notes/obsidian/https://quartz.jzhao.xyz/notes/preview-changes/https://quartz.jzhao.xyz/notes/philosophy/https://quartz.jzhao.xyz/notes/setup/https://quartz.jzhao.xyz/moc/showcase/https://quartz.jzhao.xyz/tags/https://quartz.jzhao.xyz/notes/troubleshooting/https://quartz.jzhao.xyz/ \ No newline at end of file