diff --git a/index.html b/index.html index 9058965dd..f2496a18a 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/index.xml b/index.xml index 61d94eea9..75ef7f81b 100644 --- a/index.xml +++ b/index.xml @@ -1,11 +1,17 @@ -<link>https://quartz.jzhao.xyz/</link><description>Recent content on</description><generator>Hugo -- gohugo.io</generator><language>en-us</language><atom:link href="https://quartz.jzhao.xyz/index.xml" rel="self" type="application/rss+xml"/><item><title>Configurationhttps://quartz.jzhao.xyz/notes/config/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/config/Styling Layouts Home Page PartialsDeploying to GitHub Pageshttps://quartz.jzhao.xyz/notes/hosting/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/hosting/GitHub Pages Custom subdomain Change baseURL in /config.toml -1 baseURL = &#34;https://quartz.jzhao.xyz/&#34; Having problems? Checkout our FAQ and Troubleshooting guide .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 . +<link>https://quartz.jzhao.xyz/</link><description>Recent content on</description><generator>Hugo -- gohugo.io</generator><language>en-us</language><atom:link href="https://quartz.jzhao.xyz/index.xml" rel="self" type="application/rss+xml"/><item><title>Configurationhttps://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&rsquo;d like to get. +The majority of configuration can be be found under data/config.yaml. An annotated example configuration is shown below. +1 2 3 4 5 6 7 8 9 10 name:Your name here!# Shows in the footerenableToc:true# Whether to show a Table of Contentsdescription:Page description to show to search enginespage_title:Quartz Example Page# Default Page Titlelinks:# Links to show in footer- link_name:Twitterlink:https://twitter.Deploying to GitHub Pageshttps://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! You can head to &lt;YOUR-GITHUB-USERNAME.github.io/quartz to see it live. +By default, Github Actions will run on forks of repos. You should not need to do any more config to see it up to date. +Custom subdomain Have a fancy custom domain or want to subdomain your Quartz?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 . All content in your garden can found in the /content folder. To make edits, you can open any of the files and make changes directly and save it. You can organize content into any folder you&rsquo;d like. -To create a link, 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.Obsidian Vault Integrationhttps://quartz.jzhao.xyz/notes/obsidian/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/obsidian/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&rsquo;t have an existing Vault, download -Linking an existing VaultQuartz Documentationhttps://quartz.jzhao.xyz/moc/directory/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/moc/directory/Setup Welcome to Quartz! Whether you&rsquo;re setting up a website and project for the first time or a seasoned digital gardener, I hope that you&rsquo;ll find something useful about this project. +To edit the main home page, open /content/_index.md. +To create a link, just create a normal link using Markdown pointing to the document in question.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. +New Vault If you don&rsquo;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.Quartz Documentationhttps://quartz.jzhao.xyz/moc/directory/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/moc/directory/Setup Welcome to Quartz! Whether you&rsquo;re setting up a website and project for the first time or a seasoned digital gardener, I hope that you&rsquo;ll find something useful about this project. Let&rsquo;s get to business and get you started! -πŸ“š Setup your own digital garden using Quartz πŸ”— Linking with an Obsidian Vault 🎨 Customizing and Styling Quartz 🌍 Hosting Quartz online! Troubleshooting 🚧 Troubleshooting and FAQ πŸ› Submit an IssueSetuphttps://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! +πŸ“š Setup your own digital garden using Quartz πŸ”— Linking with an Obsidian Vault 🎨 Customizing and Styling Quartz 🌍 Hosting Quartz online! Not convinced yet?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/ \ No newline at end of file +πŸ“ 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 :) +Quartz Documentation (this site!) Jacky Zhao&rsquo;s Garden 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/Common Pitfalls How come my notes aren&rsquo;t being rendered? You probably forgot to include front matter in your Markdown files. You can either setup Obsidian to do this for you or you need to manually define it. More details in the &lsquo;how to edit&rsquo; guide . +My custom domain isn&rsquo;t working! Walk through the steps in the hosting guide again. Make sure you wait 30 min to 1 hour for changes to take effect. \ No newline at end of file diff --git a/moc/directory/index.html b/moc/directory/index.html index 008e08bc9..25fd32a65 100644 --- a/moc/directory/index.html +++ b/moc/directory/index.html @@ -3,7 +3,8 @@ Setup your own digital garden using Quartz
  • πŸ”— Linking with an Obsidian Vault
  • 🎨 Customizing and Styling Quartz
  • 🌍 -Hosting Quartz online!
  • Troubleshooting

    Not convinced yet? Look at some +cool digital gardens

    Troubleshooting


    Interactive Graph

    \ No newline at end of file diff --git a/moc/index.xml b/moc/index.xml index 9fb0bddab..fdd584664 100644 --- a/moc/index.xml +++ b/moc/index.xml @@ -1,3 +1,4 @@ Mocs onhttps://quartz.jzhao.xyz/moc/Recent content in Mocs onHugo -- gohugo.ioen-usQuartz Documentationhttps://quartz.jzhao.xyz/moc/directory/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/moc/directory/Setup Welcome to Quartz! Whether you&rsquo;re setting up a website and project for the first time or a seasoned digital gardener, I hope that you&rsquo;ll find something useful about this project. Let&rsquo;s get to business and get you started! -πŸ“š Setup your own digital garden using Quartz πŸ”— Linking with an Obsidian Vault 🎨 Customizing and Styling Quartz 🌍 Hosting Quartz online! Troubleshooting 🚧 Troubleshooting and FAQ πŸ› Submit an Issue \ No newline at end of file +πŸ“š Setup your own digital garden using Quartz πŸ”— Linking with an Obsidian Vault 🎨 Customizing and Styling Quartz 🌍 Hosting Quartz online! Not convinced yet?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 :) +Quartz Documentation (this site!) Jacky Zhao&rsquo;s Garden If you want to see your own on here, submit a Pull Request adding yourself to this file ! \ No newline at end of file diff --git a/moc/showcase/index.html b/moc/showcase/index.html new file mode 100644 index 000000000..b9cc2b100 --- /dev/null +++ b/moc/showcase/index.html @@ -0,0 +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

    \ No newline at end of file diff --git a/notes/config/index.html b/notes/config/index.html index e6742507d..a0b3df24a 100644 --- a/notes/config/index.html +++ b/notes/config/index.html @@ -1,3 +1,36 @@ Configuration
    -

    Configuration

    Styling

    Layouts

    Home Page

    Partials


    Interactive Graph

    Made by Jacky Zhao using Quartz, Β© 2021

    Home +

    Configuration

    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.

    The majority of configuration can be be found under data/config.yaml. An annotated example configuration is shown below.

     1
    + 2
    + 3
    + 4
    + 5
    + 6
    + 7
    + 8
    + 9
    +10
    +
    name: Your name here! # Shows in the footer
    +enableToc: true # Whether to show a Table of Contents
    +description: Page description to show to search engines
    +page_title: Quartz Example Page # Default Page Title
    +
    +links: # Links to show in footer
    +  - link_name: Twitter
    +    link: https://twitter.com/_jzhao
    +  - link_name: Github
    +    link: https://github.com/jackyzha0
    +

    Graph View

    To customize the Interactive Graph view, you can poke around data/graphConfig.yaml.

    1
    +2
    +3
    +4
    +5
    +
    enableLegend: false # automatically generate a legend
    +enableDrag: true # allow dragging nodes in the graph
    +enableZoom: true # allow zooming and panning the graph
    +paths: # colour specific nodes path off of their path
    +  - /moc: "#4388cc"
    +

    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 42119840f..f3eab991c 100644 --- a/notes/editing/index.html +++ b/notes/editing/index.html @@ -1,12 +1,24 @@ Editing Content in Quartz
    -

    Editing Content in Quartz

    Editing

    Quartz runs on top of +

    Editing Content in Quartz

    Editing

    Quartz runs on top of Hugo so all notes are written in Markdown -.

    All content in your garden can found in the /content folder. To make edits, you can open any of the files and make changes directly and save it. You can organize content into any folder you’d like.

    To create a link, 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.

    1
    +.

    All content in your garden can found in the /content folder. To make edits, you can open any of the files and make changes directly and save it. You can organize content into any folder you’d like.

    To edit the main home page, open /content/_index.md.

    To create a link, 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.

    1
     2
     
    For example, I want to link this current document to `config.md`.
     [A link to the config page](config.md)
    +

    Front Matter

    Hugo is picky when it comes to metadata for files. Ensure that you have a title defined at the top of your file like so:

    1
    +2
    +3
    +4
    +5
    +6
    +
    ---
    +title: "Example Title"
    +---
    +
    +## Headers should start at H2
    +Rest of your content here...
     

    Obsidian

    I strongly 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 my local files.

    πŸ”— @@ -51,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 532818813..0b5db75c7 100644 --- a/notes/hosting/index.html +++ b/notes/hosting/index.html @@ -1,7 +1,26 @@ Deploying to GitHub Pages
    -

    Deploying to GitHub Pages

    GitHub Pages

    Custom subdomain

    Change baseURL in /config.toml

    1
    -
    baseURL = "https://quartz.jzhao.xyz/"
    -

    Having problems? Checkout our +

    Deploying to GitHub Pages

    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! You can head to <YOUR-GITHUB-USERNAME.github.io/quartz to see it live.

    By default, Github Actions will run on forks of repos. You should not need to do any more config to see it up to date.

    Custom subdomain

    Have a fancy custom domain or want to subdomain your Quartz? That’s easy too.

    Change baseURL in /config.toml. +Reference.

    1
    +
    baseURL = "https://<YOUR-DOMAIN>/"
    +

    Change cname in /.github/workflows/deploy.yaml. +Reference.

    1
    +2
    +3
    +4
    +5
    +6
    +7
    +
    - name: Deploy  
    +  uses: peaceiris/actions-gh-pages@v3  
    +  with:  
    +	github_token: ${{ secrets.GITHUB_TOKEN }}  
    +	publish_dir: ./public  
    +	publish_branch: master
    +	cname: <YOUR-DOMAIN>
    +

    Registrar

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

    GitHub has some +documentation on this +, 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/images/google-domains.png b/notes/images/google-domains.png new file mode 100644 index 000000000..a43826999 Binary files /dev/null and b/notes/images/google-domains.png differ diff --git a/notes/index.xml b/notes/index.xml index c2ffbd3af..17dbad923 100644 --- a/notes/index.xml +++ b/notes/index.xml @@ -1,9 +1,14 @@ -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/Styling Layouts Home Page PartialsDeploying to GitHub Pageshttps://quartz.jzhao.xyz/notes/hosting/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/hosting/GitHub Pages Custom subdomain Change baseURL in /config.toml -1 baseURL = &#34;https://quartz.jzhao.xyz/&#34; Having problems? Checkout our FAQ and Troubleshooting guide .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&rsquo;d like to get. +The majority of configuration can be be found under data/config.yaml. An annotated example configuration is shown below. +1 2 3 4 5 6 7 8 9 10 name:Your name here!# Shows in the footerenableToc:true# Whether to show a Table of Contentsdescription:Page description to show to search enginespage_title:Quartz Example Page# Default Page Titlelinks:# Links to show in footer- link_name:Twitterlink:https://twitter.Deploying to GitHub Pageshttps://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! You can head to &lt;YOUR-GITHUB-USERNAME.github.io/quartz to see it live. +By default, Github Actions will run on forks of repos. You should not need to do any more config to see it up to date. +Custom subdomain Have a fancy custom domain or want to subdomain your Quartz?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 . All content in your garden can found in the /content folder. To make edits, you can open any of the files and make changes directly and save it. You can organize content into any folder you&rsquo;d like. -To create a link, 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.Obsidian Vault Integrationhttps://quartz.jzhao.xyz/notes/obsidian/Mon, 01 Jan 0001 00:00:00 +0000https://quartz.jzhao.xyz/notes/obsidian/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&rsquo;t have an existing Vault, download -Linking an existing VaultSetuphttps://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! +To edit the main home page, open /content/_index.md. +To create a link, just create a normal link using Markdown pointing to the document in question.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. +New Vault If you don&rsquo;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.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/ \ No newline at end of file +πŸ“ 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 How come my notes aren&rsquo;t being rendered? You probably forgot to include front matter in your Markdown files. You can either setup Obsidian to do this for you or you need to manually define it. More details in the &lsquo;how to edit&rsquo; guide . +My custom domain isn&rsquo;t working! Walk through the steps in the hosting guide again. Make sure you wait 30 min to 1 hour for changes to take effect. \ No newline at end of file diff --git a/notes/obsidian/index.html b/notes/obsidian/index.html index efa2b7b11..f7fed0f6e 100644 --- a/notes/obsidian/index.html +++ b/notes/obsidian/index.html @@ -1,3 +1,7 @@ Obsidian Vault Integration
    -

    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

    Linking an existing Vault


    Interactive Graph

    Made by Jacky Zhao using Quartz, Β© 2021

    Home +

    Obsidian Vault Integration

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

    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 85f8525b8..f33ef8291 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 3375cf25b..d18717e35 100644 --- a/notes/troubleshooting/index.html +++ b/notes/troubleshooting/index.html @@ -1,3 +1,17 @@ Troubleshooting and FAQ
    -

    Troubleshooting and FAQ


    Interactive Graph

    Made by Jacky Zhao using Quartz, Β© 2021

    Home +

    Troubleshooting and FAQ

    Common Pitfalls

    How come my notes aren’t being rendered?

    You probably forgot to include front matter in your Markdown files. You can either setup +Obsidian +to do this for you or you need to manually define it. More details in +the ‘how to edit’ guide +.

    My custom domain isn’t working!

    Walk through the steps in +the hosting guide +again. Make sure you wait 30 min to 1 hour for changes to take effect.

    How do I setup Google Analytics?

    You can edit it in config.toml and either use a V3 (UA-) or V4 (G-) tag.

    How do I change the content on the home page?

    To edit the main home page, open /content/_index.md.

    How do I change the colours?

    You can change the theme by editing assets/custom.scss. More details on customization and themeing can be found in the +customization guide +.

    How do I add images?

    You can put images anywhere in the /content folder. The only caveat is that you should reference them in your Markdown by prefixing it with a /.

    1
    +2
    +
    Example image (source is in content/notes/images/example.png)
    +![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

    \ No newline at end of file diff --git a/sitemap.xml b/sitemap.xml index ae9105315..4c4a65dca 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -1 +1 @@ -https://quartz.jzhao.xyz/0https://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/moc/https://quartz.jzhao.xyz/notes/https://quartz.jzhao.xyz/notes/obsidian/https://quartz.jzhao.xyz/moc/directory/https://quartz.jzhao.xyz/notes/setup/https://quartz.jzhao.xyz/tags/https://quartz.jzhao.xyz/notes/troubleshooting/ \ No newline at end of file +https://quartz.jzhao.xyz/0https://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/moc/https://quartz.jzhao.xyz/notes/https://quartz.jzhao.xyz/notes/obsidian/https://quartz.jzhao.xyz/moc/directory/https://quartz.jzhao.xyz/notes/setup/https://quartz.jzhao.xyz/moc/showcase/https://quartz.jzhao.xyz/tags/https://quartz.jzhao.xyz/notes/troubleshooting/ \ No newline at end of file