From 41c443dbf079e65ed69f57d3b9a5ce58dc403e6d Mon Sep 17 00:00:00 2001 From: earnest ma <me@earne.link> Date: Fri, 11 Feb 2022 22:15:28 +0000 Subject: [PATCH] Add disableToc parameter to not show TOC on a page --- content/notes/editing.md | 28 ++++++++++++++++++++-------- 1 files changed, 20 insertions(+), 8 deletions(-) diff --git a/content/notes/editing.md b/content/notes/editing.md index db76af8..17730ef 100644 --- a/content/notes/editing.md +++ b/content/notes/editing.md @@ -1,21 +1,23 @@ --- title: "Editing Content in Quartz" +tags: +- setup --- ## Editing Quartz runs on top of [Hugo](https://gohugo.io/) so all notes are written in [Markdown](https://www.markdownguide.org/getting-started/). ### Obsidian -I *strongly* recommend using [Obsidian](http://obsidian.md/) 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. +I recommend using [Obsidian](http://obsidian.md/) 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. -**🔗 [How to link your Obsidian Vault](notes/obsidian.md)** +This step is **highly recommended**. -Of course, all the files are in Markdown so you could just use your favourite text editor of choice. +🔗 [How to setup your Obsidian Vault to work with Quartz](notes/obsidian.md) ### Ignoring Files Only want to publish a subset of all of your notes? Don't worry, Quartz makes this a simple two-step process. -❌ [Excluding pages from being published](notes/ignore-notes.md) +❌ [Excluding pages from being published](notes/ignore%20notes.md) ### Folder Structure Here's a rough overview of what's what. @@ -31,21 +33,31 @@ [A link to the config page](notes/config.md) ``` +Similarly, you can put local images anywhere in the `/content` folder. The only caveat is that you should reference them in your Markdown by prefixing it with a `/`. + +```markdown +Example image (source is in content/notes/images/example.png) + +``` + ### 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: +Hugo is picky when it comes to metadata for files. Make sure that your title is double-quoted and that you have a title defined at the top of your file like so. You can also add tags here as well. ```markdown --- title: "Example Title" +tags: +- example-tag +disableToc: true # do not show a table of contents on this page if enabled --- Rest of your content here... ``` ## Previewing Changes -This step is purely optional and mostly for those who want to see the published version of their digital garden locally before opening it up to the internet. This is *highly recommended*. +This step is purely optional and mostly for those who want to see the published version of their digital garden locally before opening it up to the internet. This is *highly recommended* but not required. -👀 [Preview Quartz Changes](notes/preview-changes.md) +👀 [Preview Quartz Changes](notes/preview%20changes.md) For those who like to live life more on the edge, viewing the garden through Obsidian gets you pretty close to the real thing. @@ -54,4 +66,4 @@ 🌍 [Hosting Quartz online!](notes/hosting.md) -Having problems? Checkout our [FAQ and Troubleshooting guide](notes/troubleshooting.md). \ No newline at end of file +Having problems? Checkout our [FAQ and Troubleshooting guide](notes/troubleshooting.md). -- Gitblit v1.10.0