Data Glossary 🧠

Search

Search IconIcon to open search

General Infos (Folder Structure, Links)

Last updated Sep 27, 2022 - Edit Source

Quartz runs on top of  Hugo so all notes are written in  Markdown and can be edited through any editor.

# Folder Structure

The content of the Glossary is in content/term folder. The rest outside of content/ is the website/framework.

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

To create a link between terms in the glossary, 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 `term/config.md`.
[A link to the config page](term/config.md)

Similarly, you can put local images anywhere in the /content folder.

1
2
Example image (source is in content/images/example.png)
![Example Image](/content/images/example.png)

# Lower Case

Terms are lower case that links are also lowercase. When we create a link to a term, I usually capitalize the beginning of each word to make it look nice. E.g [Apache Arrow](term/apache%20arrow.md). Other such as YAML I write all in capitals.

We didn’t activate wikilinks, but that would be an option as well. See more on editing.

# Metatag with Front Matter

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.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
---
title: "What is a Glossary?"
tags:
- example-tag
- here i can add more we keep it lower case
url: "term/my-other-domain"
aliases:
- Digital Garden
- Second Brain
---

Rest of your content here.