From cfb7d1232e005736dc549fb24ec5a02d53fc5206 Mon Sep 17 00:00:00 2001 From: Jacky Zhao <j.zhao2k19@gmail.com> Date: Sun, 20 Aug 2023 07:52:49 +0000 Subject: [PATCH] docs: update notes for tag and folder listings --- content/features/folder and tag listings.md | 4 ++++ 1 files changed, 4 insertions(+), 0 deletions(-) diff --git a/content/features/folder and tag listings.md b/content/features/folder and tag listings.md index caad796..dfde7c2 100644 --- a/content/features/folder and tag listings.md +++ b/content/features/folder and tag listings.md @@ -14,12 +14,16 @@ By default, Quartz will title the page `Folder: <name of folder>` and no description. You can override this by creating an `index.md` file in the folder with the `title` [[authoring content#Syntax|frontmatter]] field. Any content you write in this file will also be used in the description of the folder. +For example, for the folder `content/posts`, you can add another file `content/posts/index.md` to add a specific description for it. + ## Tag Listings Quartz will also create an index page for each unique tag in your vault and render a list of all notes with that tag. Quartz also supports tag hierarchies as well (e.g. `plugin/emitter`) and will also render a separate tag page for each layer of the tag hierarchy. It will also create a default global tag index page at `/tags` that displays a list of all the tags in your Quartz. +Like folder listings, you can also provide a description and title for a tag page by creating a file for each tag. For example, if you wanted to create a custom description for the #component tag, you would create a file at `content/tags/component.md` with a title and description. + ## Customization The layout for both the folder and content pages can be customized. By default, they use the `defaultListPageLayout` in `quartz.layouts.ts`. If you'd like to make more involved changes to the layout and don't mind editing some [[creating components|Quartz components]], you can take a look at `quartz/components/pages/FolderContent.tsx` and `quartz/components/pages/TagContent.tsx` respectively. -- Gitblit v1.10.0