<html><head><title>Configuration</title><metacharSet="utf-8"/><metaname="viewport"content="width=device-width, initial-scale=1.0"/><metaproperty="og:title"content="Configuration"/><metaproperty="og:description"content="Quartz is meant to be extremely configurable, even if you don’t know any coding. Most of the configuration you should need can be done by just editing quartz."/><metaproperty="og:image"content="https://roadmap.logos.co/static/og-image.png"/><metaproperty="og:width"content="1200"/><metaproperty="og:height"content="675"/><linkrel="icon"href="./static/icon.png"/><metaname="description"content="Quartz is meant to be extremely configurable, even if you don’t know any coding. Most of the configuration you should need can be done by just editing quartz."/><metaname="generator"content="Logos Roadmaps"/><linkrel="preconnect"href="https://fonts.googleapis.com"/><linkrel="preconnect"href="https://fonts.gstatic.com"/><linkhref="./index.css"rel="stylesheet"type="text/css"spa-preserve/><linkhref="https://cdn.jsdelivr.net/npm/katex@0.16.0/dist/katex.min.css"rel="stylesheet"type="text/css"spa-preserve/><linkhref="https://fonts.googleapis.com/css2?family=IBM Plex Mono&family=Schibsted Grotesk:wght@400;700&family=Source Sans Pro:ital,wght@0,400;0,600;1,400;1,600&display=swap"rel="stylesheet"type="text/css"spa-preserve/><scriptsrc="./prescript.js"type="application/javascript"spa-preserve></script><scripttype="application/javascript"spa-preserve>constfetchData=fetch(`./static/contentIndex.json`).then(data=>data.json())</script></head><bodydata-slug="configuration"><divid="quartz-root"class="page"><divid="quartz-body"><divclass="left sidebar"><h1class="page-title"><ahref=".">Logos Collective Project Roadmaps</a></h1><divclass="spacer mobile-only"></div><divclass="search"><divid="search-icon"><p>Search</p><div></div><svgtabIndex="0"aria-labelledby="title desc"role="img"xmlns="http://www.w3.org/2000/svg"viewBox="0 0 19.9 19.7"><titleid="title">Search</title><descid="desc">Search</desc><gclass="search-path"fill="none"><pathstroke-linecap="square"d="M18.5 18.3l-5.4-5.4"></path><circlecx="8"cy="8"r="7"></circle></g></svg></div><divid="search-container"><divid="search-space"><inputautocomplete="off"id="search-bar"name="search"type="text"aria-label="Search for something"placeholder="Search for something"/><divid="results-container"></div></div></div></div><divclass="darkmode"><inputclass="toggle"id="darkmode-toggle"type="checkbox"tabIndex="-1"/><labelid="toggle-label-light"for="darkmode-toggle"tabIndex="-1"><svgxmlns="http://www.w3.org/2000/svg"xmlnsXlink="http://www.w3.org/1999/xlink"version="1.1"id="dayIcon"x="0px"y="0px"viewBox="0 0 35 35"style="enable-background:new 0 0 35 35;"xmlSpace="preserve"><title>Light mode</title><pathd="M6,17.5C6,16.672,5.328,16,4.5,16h-3C0.672,16,0,16.672,0,17.5S0.672,19,1.5,19h3C5.328,19,6,18.328,6,17.5zM7.5,26c-0.414,0-0.789,0.168-1.061,0.439l-2,2C4.168,28.711,4,29.086,4,29.5C4,30.328,4.671,31,5.5,31c0.414,0,0.789-0.168,1.06-0.44l2-2C8.832,28.289,9,27.914,9,27.5C9,26.672,8.329,26,7.5,26zM17.5,6C18.329,6,19,5.328,19,4.5v-3C19,0.672,18.329,0,17.5,0S16,0.672,16,1.5v3C16,5.328,16.671,6,17.5,6zM27.5,9c0.414,0,0.789-0.168,1.06-0.439l2-2C30.832,6.289,31,5.914,31,5.5C31,4.672,30.329,4,29.5,4c-0.414,0-0.789,0.168-1.061,0.44l-2,2C26.168,6.711,26,7.086,26,7.5C26,8.328,26.671,9,27.5,9zM6.439,8.561C6.711,8.832,7.086,9,7.5,9C8.328,9,9,8.328,9,7.5c0-0.414-0.168-0.789-0.439-1.061l-2-2C6.289,4.168,5.914,4,5.5,4C4.672,4,4,4.672,4,5.5c0,0.414,0.168,0.789,0.439,1.06L6.439,8.561zM33.5,16h-3c-0.828,0-1.5,0.672-1.5,1.5s0.672,1.5,1.5,1.5h3c0.828,0,1.5-0.672,1.5-1.5S34.328,16,33.5,16zM28.561,26.439C28.289,26.168,27.914,26,27.5,26c-0.828,0-1.5,0.672-1.5,1.5c0,0.414,0.168,0.789,0.439,1.06l2,2C28.711,30.832,29.086,31,29.5,31c0.828,0,1.5-0.672,1.5-1.5c0-0.414-0.168-0.789-0.439-1.061L28.561,26.439zM17.5,29c-0.829,0-1.5,0.672-1.5,1.5v3c0,0.828,0.671,1.5,1.5,1.5s1.5-0.672,1.5
<p>If you edit Quartz configuration using a text-editor that has TypeScript language support like VSCode, it will warn you when you you’ve made an error in your configuration, helping you avoid configuration mistakes!</p>
</blockquote>
<p>The configuration of Quartz can be broken down into two main parts:</p>
<p>This part of the configuration concerns anything that can affect the whole site. The following is a list breaking down all the things you can configure:</p>
<ul>
<li><code>pageTitle</code>: title of the site. This is also used when generating the <ahref="./RSS-Feed"class="internal">RSS Feed</a> for your site.</li>
<li><code>enableSPA</code>: whether to enable <ahref="./SPA-Routing"class="internal">SPA Routing</a> on your site.</li>
<li><code>enablePopovers</code>: whether to enable <ahref="./popover-previews"class="internal">popover previews</a> on your site.</li>
<li><code>analytics</code>: what to use for analytics on your site. Values can be
<ul>
<li><code>null</code>: don’t use analytics;</li>
<li><code>{ provider: 'plausible' }</code>: use <ahref="https://plausible.io/"class="external">Plausible</a>, a privacy-friendly alternative to Google Analytics; or</li>
<li><code>{ provider: 'google', tagId: <your-google-tag> }</code>: use Google Analytics</li>
</ul>
</li>
<li><code>baseUrl</code>: this is used for sitemaps and RSS feeds that require an absolute URL to know where the canonical ‘home’ of your site lives. This is normally the deployed URL of your site (e.g. <code>quartz.jzhao.xyz</code> for this site). Do not include the protocol (i.e. <code>https://</code>) or any leading or trailing slashes.
<ul>
<li>This should also include the subpath if you are <ahref="./hosting"class="internal">hosting</a> on GitHub pages without a custom domain. For example, if my repository is <code>jackyzha0/quartz</code>, GitHub pages would deploy to <code>https://jackyzha0.github.io/quartz</code> and the <code>baseUrl</code> would be <code>jackyzha0.github.io/quartz</code></li>
<li>Note that Quartz 4 will avoid using this as much as possible and use relative URLs whenever it can to make sure your site works no matter <em>where</em> you end up actually deploying it.</li>
</ul>
</li>
<li><code>ignorePatterns</code>: a list of <ahref="https://en.wikipedia.org/wiki/Glob_(programming)"class="external">glob</a> patterns that Quartz should ignore and not search through when looking for files inside the <code>content</code> folder. See <ahref="./private-pages"class="internal">private pages</a> for more details.</li>
<li><code>theme</code>: configure how the site looks.
<ul>
<li><code>typography</code>: what fonts to use. Any font available on <ahref="https://fonts.google.com/"class="external">Google Fonts</a> works here.
<ul>
<li><code>header</code>: Font to use for headers</li>
<li><code>code</code>: Font for inline and block quotes.</li>
<li><code>body</code>: Font for everything</li>
</ul>
</li>
<li><code>colors</code>: controls the theming of the site.
<li><code>secondary</code>: link colour, current <ahref="./graph-view"class="internal">graph</a> node</li>
<li><code>tertiary</code>: hover states and visited <ahref="./graph-view"class="internal">graph</a> nodes</li>
<li><code>highlight</code>: internal link background, highlighted text, <ahref="./syntax-highlighting"class="internal">highlighted lines of code</a></li>
<li><ahref="./making-plugins#transformers"class="internal">Transformers</a><strong>map</strong> over content (e.g. parsing frontmatter, generating a description)</li>
<li><ahref="./making-plugins#filters"class="internal">Filters</a><strong>filter</strong> content (e.g. filtering out drafts)</li>
<li><ahref="./making-plugins#emitters"class="internal">Emitters</a><strong>reduce</strong> over content (e.g. creating an RSS feed or pages that list all files with a specific tag)</li>
</ul>
<p>By adding, removing, and reordering plugins from the <code>tranformers</code>, <code>filters</code>, and <code>emitters</code> fields, you can customize the behaviour of Quartz.</p>
<p>Each node is modified by every transformer <em>in order</em>. Some transformers are position-sensitive so you may need to take special note of whether it needs come before or after any other particular plugins.</p>
</blockquote>
<p>Additionally, plugins may also have their own configuration settings that you can pass in. For example, the <ahref="./Latex"class="internal">Latex</a> plugin allows you to pass in a field specifying the <code>renderEngine</code> to choose between Katex and MathJax.</p>
<p>If you’d like to make your own plugins, read the guide on <ahref="./making-plugins"class="internal">making plugins</a> for more information.</p></article></div><divclass="right sidebar"><divclass="graph"><h3>Graph View</h3><divclass="graph-outer"><divid="graph-container"data-cfg="{"drag":true,"zoom":true,"depth":1,"scale":1.1,"repelForce":0.5,"centerForce":0.3,"linkDistance":30,"fontSize":0.6,"opacityScale":1}"></div><svgversion="1.1"id="global-graph-icon"xmlns="http://www.w3.org/2000/svg"xmlnsXlink="http://www.w3.org/1999/xlink"x="0px"y="0px"viewBox="0 0 55 55"fill="currentColor"xmlSpace="preserve"><pathd="M49,0c-3.309,0-6,2.691-6,6c0,1.035,0.263,2.009,0.726,2.86l-9.829,9.829C32.542,17.634,30.846,17,29,17
