<!doctype html><htmllang=en><head><metacharset=utf-8><metaname=descriptioncontent="Making your own Quartz Setting up Quartz requires a basic understanding of git. If you are unfamiliar, this resource is a great place to start!"><title>Setup</title><metaname=viewportcontent="width=device-width,initial-scale=1"><linkrel="shortcut icon"type=image/pnghref=https://quartz.jzhao.xyz//icon.png><linkhref="https://fonts.googleapis.com/css2?family=Inter:wght@400;600;700&family=Source+Sans+Pro:wght@400;600;700&family=Fira+Code:wght@400;700&display=swap"rel=stylesheet><linkhref=https://quartz.jzhao.xyz/styles.cd61336c89ed6e03702366ce4a492b75.min.cssrel=stylesheet><scriptsrc=https://quartz.jzhao.xyz/js/darkmode.46b07878b7f5d9e26ad7a3c40f8a0605.min.js></script>
<script>vardoNotTrack=!1;if(!doNotTrack){window.dataLayer=window.dataLayer||[];functiongtag(){dataLayer.push(arguments)}gtag("js",newDate),gtag("config","G-XYFD95KB4J",{anonymize_ip:!1})}</script><body><divid=search-container><divid=search-space><inputautocomplete=offid=search-barname=searchtype=textaria-label=Searchplaceholder="Search for something..."><divid=results-container></div></div></div><scriptsrc=https://cdn.jsdelivr.net/npm/flexsearch@0.7.21/dist/flexsearch.bundle.jsintegrity="sha256-i3A0NZGkhsKjVMzFxv3ksk0DZh3aXqu0l49Bbh0MdjE="crossorigin=anonymousdefer></script>
<scriptdefersrc=https://quartz.jzhao.xyz/js/search.bc849b857f2c1b822264d40635bb67b6.min.js></script><divclass=singlePage><header><h1id=page-title><ahref=https://quartz.jzhao.xyz/>🪴 Quartz 3.2</a></h1><svgtabindex="0"id="search-icon"aria-labelledby="title desc"role="img"xmlns="http://www.w3.org/2000/svg"viewBox="0 0 19.9 19.7"><titleid="title">Search Icon</title><descid="desc">Icon to open search</desc><gclass="search-path"fill="none"><pathstroke-linecap="square"d="M18.5 18.3l-5.4-5.4"/><circlecx="8"cy="8"r="7"/></g></svg><divclass=spacer></div><divclass=darkmode><inputclass=toggleid=darkmode-toggletype=checkboxtabindex=-1>
<ahref=https://resources.nwplus.io/2-beginner/how-to-git-github.htmlrel=noopener>this resource</a> is a great place to start!</p><h3id=forking>Forking</h3><blockquote><p>A fork is a copy of a repository. Forking a repository allows you to freely experiment with changes without affecting the original project.</p></blockquote><p>Navigate to the GitHub repository for the Quartz project:</p><p>📁
<ahref=https://github.com/jackyzha0/quartzrel=noopener>Quartz Repository</a></p><p>Then, Fork the repository into your own GitHub account. If you don’t have an account, you can make on for free
<ahref=https://github.com/joinrel=noopener>here</a>. More details about forking a repo can be found on
<ahref=https://docs.github.com/en/get-started/quickstart/fork-a-reporel=noopener>GitHub’s documentation</a>.</p><h3id=cloning>Cloning</h3><p>After you’ve made a fork of the repository, you need to download the files locally onto your machine. Ensure you have <code>git</code>, then type the following command replacing <code>YOUR-USERNAME</code> with your GitHub username.</p><divclass=highlight><divclass=chroma><tableclass=lntable><tr><tdclass=lntd><pretabindex=0class=chroma><code><spanclass=lnt>1
</span></span></code></pre></td></tr></table></div></div><h2id=editing>Editing</h2><p>Great! Now you have everything you need to start editing and growing your digital garden. If you’re ready to start writing content already, check out the recommended flow for editing notes in Quartz.</p><p>✏️
<ahref=/notes/editingrel=noopenerclass=internal-linkdata-src=/notes/editing>Editing Notes in Quartz</a></p><p>Having problems? Checkout our
<ahref=/notes/troubleshootingrel=noopenerclass=internal-linkdata-src=/notes/troubleshooting>FAQ and Troubleshooting guide</a>.</p><h2id=updating>Updating</h2><p>Haven’t updated Quartz in a while and want all the cool new optimizations? On Unix/Mac systems you can run the following command for a one-line update! This command will show you a log summary of all commits since you last updated, press <code>q</code> to acknowledge this. Then, it will show you each change in turn and press <code>y</code> to accept the patch or <code>n</code> to reject it. Usually you should press <code>y</code> for most of these unless it conflicts with existing changes you’ve made!</p><divclass=highlight><divclass=chroma><tableclass=lntable><tr><tdclass=lntd><pretabindex=0class=chroma><code><spanclass=lnt>1
</span></span></code></pre></td></tr></table></div></div><p>Or, manually checkout the changes yourself.</p><blockquote><p>⚠️ <strong>WARNING</strong> ⚠️</p><p>If you customized the files in <code>data/</code>, or anything inside <code>layouts/</code>, your customization may be overwritten!
Make sure you have a copy of these changes if you don’t want to lose them.</p></blockquote><divclass=highlight><divclass=chroma><tableclass=lntable><tr><tdclass=lntd><pretabindex=0class=chroma><code><spanclass=lnt>1
</span><spanclass=lnt>2
</span><spanclass=lnt>3
</span><spanclass=lnt>4
</span><spanclass=lnt>5
</span><spanclass=lnt>6
</span></code></pre></td><tdclass=lntd><pretabindex=0class=chroma><codeclass=language-shelldata-lang=shell><spanclass=line><spanclass=cl><spanclass=c1># add Quartz as a remote host</span>
