quartz-research-note/content/notes/config.md

---
title: "Configuration"
tags:
- setup
---

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

```yaml
name: Your name here! # Shows in the footer
enableToc: true # Whether to show a Table of Contents
enableLinkPreview: true # whether to render card previews for links
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`.

```yaml
enableLegend: false # automatically generate a legend
enableDrag: true # allow dragging nodes in the graph
enableZoom: true # allow zooming and panning the graph
depth: -1 # how many neighbours of the current node to show (-1 is all nodes)
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.](https://gohugo.io/templates/partials/)

Still having problems? Checkout our [FAQ and Troubleshooting guide](notes/troubleshooting.md).

## Multilingual
Want to support languages that read from right-to-left (like Arabic)? Hugo (and by proxy, Quartz) supports this natively.

Follow the steps [Hugo provides here](https://gohugo.io/content-management/multilingual/#configure-languages) and modify your `config.toml`

For example:

```toml
defaultContentLanguage = 'ar'
[languages]
  [languages.ar]
    languagedirection = 'rtl'
    title = 'مدونتي'
    weight = 1
```
add base pages 2021-07-18 15:54:00 +00:00			`---`
proper backlink and graph display in footer 2021-07-18 17:02:53 +00:00			`title: "Configuration"`
base tags 2021-12-27 02:13:21 +00:00			`tags:`
			`- setup`
add base pages 2021-07-18 15:54:00 +00:00			`---`
more docs + link fixing 2021-07-18 19:19:58 +00:00
flesh out docs 2021-07-18 20:40:53 +00:00			`## 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.

			```yaml
			`name: Your name here! # Shows in the footer`
			`enableToc: true # Whether to show a Table of Contents`
docs update 2022-01-04 16:39:22 +00:00			`enableLinkPreview: true # whether to render card previews for links`
flesh out docs 2021-07-18 20:40:53 +00:00			`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`.

			```yaml
			`enableLegend: false # automatically generate a legend`
			`enableDrag: true # allow dragging nodes in the graph`
			`enableZoom: true # allow zooming and panning the graph`
dedupe backlinks 2021-12-27 18:15:10 +00:00			`depth: -1 # how many neighbours of the current node to show (-1 is all nodes)`
flesh out docs 2021-07-18 20:40:53 +00:00			`paths: # colour specific nodes path off of their path`
			`- /moc: "#4388cc"`
			```


more docs + link fixing 2021-07-18 19:19:58 +00:00			`## Styling`
flesh out docs 2021-07-18 20:40:53 +00:00			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.](https://gohugo.io/templates/partials/)`

rtl docs 2022-02-17 15:49:41 +00:00			`Still having problems? Checkout our [FAQ and Troubleshooting guide](notes/troubleshooting.md).`

			`## Multilingual`
			`Want to support languages that read from right-to-left (like Arabic)? Hugo (and by proxy, Quartz) supports this natively.`

			Follow the steps [Hugo provides here](https://gohugo.io/content-management/multilingual/#configure-languages) and modify your `config.toml`

			`For example:`

			```toml
			`defaultContentLanguage = 'ar'`
			`[languages]`
			`[languages.ar]`
			`languagedirection = 'rtl'`
			`title = 'مدونتي'`
			`weight = 1`
			```