diff --git a/index.html b/index.html index e300c9b22..ad6618067 100644 --- a/index.html +++ b/index.html @@ -6,4 +6,4 @@ , 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

“He who works with the door open gets all kinds of interruptions, but he also occasionally gets clues as to what the world is and what might be important.” — Richard Hamming

The goal of Quartz is to make hosting your own public digital garden free and simple.

Get Started

The entire Quartz documentation is fully hosted using Quartz! You can navigate it using the interactive Graph view below.

If you’d prefer more traditional navigation, you can also find all relevant pages through the main directory.

👉 -Directory


Interactive Graph

\ No newline at end of file +Directory


Interactive Graph

\ No newline at end of file diff --git a/moc/directory/index.html b/moc/directory/index.html index 066028e1e..1e439682f 100644 --- a/moc/directory/index.html +++ b/moc/directory/index.html @@ -7,5 +7,5 @@ cool community digital gardens !

Troubleshooting


Interactive Graph

\ No newline at end of file diff --git a/moc/showcase/index.html b/moc/showcase/index.html index 846b572ec..d6c728aaa 100644 --- a/moc/showcase/index.html +++ b/moc/showcase/index.html @@ -1,5 +1,5 @@ Showcase

Showcase

Want to see what Quartz can do? Here are some cool community gardens :)

If you want to see your own on here, submit a Pull Request adding yourself to this file -!


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 9ebef1d51..238413cb0 100644 --- a/notes/config/index.html +++ b/notes/config/index.html @@ -32,5 +32,5 @@

Styling

Want to go even more in-depth? You can add custom CSS styling and change existing colours through editing assets/custom.scss. If you’d like to target specific parts of the site, you can add ids and classes to the HTML partials in /layouts/partials.

Partials

Partials are what dictate what actually gets rendered to the page. Want to change how pages are styled and structured? You can edit the appropriate layout in /layouts.

For example, the structure of the home page can be edited through /layouts/index.html. To customize the footer, you can edit /layouts/partials/footer.html

More info about partials on Hugo’s website.

Still having problems? Checkout our FAQ and Troubleshooting guide -.


Interactive Graph

\ No newline at end of file diff --git a/notes/editing/index.html b/notes/editing/index.html index 47f6a6cee..f78860c85 100644 --- a/notes/editing/index.html +++ b/notes/editing/index.html @@ -63,5 +63,5 @@ $ hugo-obsidian -input=content -output=

Afterwards, start the Hugo server as shown above and your local backlinks and interactive graph should be populated!

Publishing Changes

Now that you know the basics of managing your digital garden using Quartz, you can publish it to the internet!

🌍 Hosting Quartz online!

Having problems? Checkout our FAQ and Troubleshooting guide -.


Interactive Graph

\ No newline at end of file diff --git a/notes/hosting/index.html b/notes/hosting/index.html index 86e1000eb..0c3027759 100644 --- a/notes/hosting/index.html +++ b/notes/hosting/index.html @@ -22,5 +22,5 @@ , but the tldr; is to

  1. 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.

  2. 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 QuartzExample Configuration for Quartz

  3. Wait 30 minutes to an hour for the network changes to kick in.

  4. Done!

Now that your Quartz is live, let’s figure out how to make Quartz really yours!

🎨 Customizing Quarts

Having problems? Checkout our FAQ and Troubleshooting guide -.


Interactive Graph

\ No newline at end of file diff --git a/notes/obsidian/index.html b/notes/obsidian/index.html index e8cedb2d0..e159d6f62 100644 --- a/notes/obsidian/index.html +++ b/notes/obsidian/index.html @@ -3,5 +3,5 @@ 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.

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/setup/index.html b/notes/setup/index.html index 9db578fe4..469d48d24 100644 --- a/notes/setup/index.html +++ b/notes/setup/index.html @@ -11,5 +11,5 @@ is a great place to start!

Forking

A fork i

Editing

Great! Now you have everything you need to start editing and growing your digital garden. If you’re ready to start writing content already, check out the recommended flow for editing notes in Quartz.

✏️ Editing Notes in Quartz

Having problems? Checkout our FAQ and Troubleshooting guide -.


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 d78ca351f..d5e2ae24d 100644 --- a/notes/troubleshooting/index.html +++ b/notes/troubleshooting/index.html @@ -13,5 +13,5 @@ again. Make sure you wait 30 min to 1 hour for changes to take effect.

Example Image](/content/notes/images/example.png)

By default, the linkIndex.yaml (which Quartz needs to generate the Interactive Graph and Backlinks) are not regenerated locally. To set that up, see the guide on local editing

Can I use React/Vue/some other framework?

Not out of the box. You could probably make it work by editing /layouts/_default/single.html but that’s not what Quartz is designed to work with. 99% of things you are trying to do with those frameworks you can accomplish perfectly fine using just vanilla HTML/CSS/JS.

Still Stuck?

Quartz isn’t perfect! If you’re still having troubles, file an issue in the GitHub repo with as much information as you can reasonably provide.

🐛 -Submit an Issue


Interactive Graph

Made by Jacky Zhao using Quartz, © 2021

Home +Submit an Issue


Interactive Graph

\ No newline at end of file