While you’re here, join our Discord :)"><metaproperty="og:title"content="Troubleshooting and FAQ"><metaproperty="og:description"content="Stillhavingtrouble?HerearealistofcommonquestionsandproblemspeopleencounterwheninstallingQuartz.
While you’re here, join our Discord :)"><metaproperty="og:type"content="website"><metaproperty="og:image"content="https://ar.falsy.cat/icon.png"><metaproperty="og:url"content="https://ar.falsy.cat/notes/troubleshooting/"><metaproperty="og:width"content="200"><metaproperty="og:height"content="200"><metaname=twitter:cardcontent="summary"><metaname=twitter:titlecontent="Troubleshooting and FAQ"><metaname=twitter:descriptioncontent="Stillhavingtrouble?HerearealistofcommonquestionsandproblemspeopleencounterwheninstallingQuartz.
While you’re here, join our Discord :)"><metaname=twitter:imagecontent="https://ar.falsy.cat/icon.png"><metaname=twitter:sitecontent="_jzhao"><title>Troubleshooting and FAQ</title><metaname=viewportcontent="width=device-width,initial-scale=1"><linkrel="shortcut icon"type=image/pnghref=https://ar.falsy.cat//icon.png><linkhref=https://ar.falsy.cat/styles.b369a84b3c6e6bfd686ad1f9da65641c.min.cssrel=stylesheet><linkhref=https://ar.falsy.cat/styles/_light_syntax.86a48a52faebeaaf42158b72922b1c90.min.cssrel=stylesheetid=theme-link><scriptsrc=https://ar.falsy.cat/js/darkmode.557cde7fcc3511a3d7ca8545ecd46d77.min.js></script>
<script>window.plausible=window.plausible||function(){(window.plausible.q=window.plausible.q||[]).push(arguments)}</script></head><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>
<ahref=https://github.com/jackyzha0/quartz/tree/hugo/content/notes/troubleshooting.mdrel=noopener>Edit Source</a></p><ulclass=tags></ul><asideclass=mainTOC><details><summary>Table of Contents</summary><navid=TableOfContents><ol><li><ol><li><ahref=#does-quartz-have-latex-support>Does Quartz have Latex support?</a></li><li><ahref=#can-i-use-obsidian-plugin-in-quartz>Can I use <Obsidian Plugin> in Quartz?</a></li><li><ahref=#my-github-pages-is-just-showing-the-readme-and-not-quartz>My GitHub pages is just showing the README and not Quartz</a></li><li><ahref=#some-of-my-pages-have-january-1-0001-as-the-last-modified-date>Some of my pages have ‘January 1, 0001’ as the last modified date</a></li><li><ahref=#can-i-publish-only-a-subset-of-my-pages>Can I publish only a subset of my pages?</a></li><li><ahref=#can-i-host-this-myself-and-not-on-github-pages>Can I host this myself and not on GitHub Pages?</a></li><li><ahref=#command-not-found-hugo-obsidian><code>command not found: hugo-obsidian</code></a></li><li><ahref=#how-come-my-notes-arent-being-rendered>How come my notes aren’t being rendered?</a></li><li><ahref=#my-custom-domain-isnt-working>My custom domain isn’t working!</a></li><li><ahref=#how-do-i-setup-analytics>How do I setup analytics?</a></li><li><ahref=#how-do-i-change-the-content-on-the-home-page>How do I change the content on the home page?</a></li><li><ahref=#how-do-i-change-the-colours>How do I change the colours?</a></li><li><ahref=#how-do-i-add-images>How do I add images?</a></li><li><ahref=#my-interactive-graph-and-backlinks-arent-up-to-date>My Interactive Graph and Backlinks aren’t up to date</a></li><li><ahref=#can-i-use-reactvuesome-other-framework>Can I use React/Vue/some other framework?</a></li></ol></li><li><ahref=#still-stuck>Still Stuck?</a></li></ol></nav></details></aside><p>Still having trouble? Here are a list of common questions and problems people encounter when installing Quartz.</p><p>While you’re here, join our
<ahref=https://discord.gg/cRFFHYye7trel=noopener>Discord</a> :)</p><ahref=#does-quartz-have-latex-support><h3id=does-quartz-have-latex-support><spanclass=hanchorarialabel=Anchor># </span>Does Quartz have Latex support?</h3></a><p>Yes! See
<ahref=/notes/CJK-+-Latex-Support-%E6%B5%8B%E8%AF%95/rel=noopenerclass=internal-linkdata-src=/notes/CJK-+-Latex-Support-%E6%B5%8B%E8%AF%95/>CJK + Latex Support (测试)</a> for a brief demo.</p><ahref=#can-i-use-obsidian-plugin-in-quartz><h3id=can-i-use-obsidian-plugin-in-quartz><spanclass=hanchorarialabel=Anchor># </span>Can I use <Obsidian Plugin> in Quartz?</h3></a><p>Unless it produces direct Markdown output in the file, no. There currently is no way to bundle plugin code with Quartz.</p><p>The easiest way would be to add your own HTML partial that supports the functionality you are looking for.</p><ahref=#my-github-pages-is-just-showing-the-readme-and-not-quartz><h3id=my-github-pages-is-just-showing-the-readme-and-not-quartz><spanclass=hanchorarialabel=Anchor># </span>My GitHub pages is just showing the README and not Quartz</h3></a><p>Make sure you set the source to deploy from <code>master</code> (and not <code>hugo</code>) using <code>/ (root)</code>! See more in the
<ahref=/notes/hosting/rel=noopenerclass=internal-linkdata-src=/notes/hosting/>hosting</a> guide</p><ahref=#some-of-my-pages-have-january-1-0001-as-the-last-modified-date><h3id=some-of-my-pages-have-january-1-0001-as-the-last-modified-date><spanclass=hanchorarialabel=Anchor># </span>Some of my pages have ‘January 1, 0001’ as the last modified date</h3></a><p>This is a problem caused by <code>git</code> treating files as case-insensitive by default and some of your posts probably have capitalized file names. You can turn this off in your Quartz by running this command.</p><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></code></pre></td><tdclass=lntd><pretabindex=0class=chroma><codeclass=language-shelldata-lang=shell><spanclass=line><spanclass=cl><spanclass=c1># in the root of your Quartz (same folder as config.toml)</span>
</span></span></code></pre></td></tr></table></div></div><ahref=#can-i-publish-only-a-subset-of-my-pages><h3id=can-i-publish-only-a-subset-of-my-pages><spanclass=hanchorarialabel=Anchor># </span>Can I publish only a subset of my pages?</h3></a><p>Yes! Quartz makes selective publishing really easy. Heres a guide on
<ahref=/notes/ignore-notes/rel=noopenerclass=internal-linkdata-src=/notes/ignore-notes/>excluding pages from being published</a>.</p><ahref=#can-i-host-this-myself-and-not-on-github-pages><h3id=can-i-host-this-myself-and-not-on-github-pages><spanclass=hanchorarialabel=Anchor># </span>Can I host this myself and not on GitHub Pages?</h3></a><p>Yes! All built files can be found under <code>/public</code> in the <code>master</code> branch. More details under
<ahref=/notes/hosting/rel=noopenerclass=internal-linkdata-src=/notes/hosting/>hosting</a>.</p><ahref=#command-not-found-hugo-obsidian><h3id=command-not-found-hugo-obsidian><spanclass=hanchorarialabel=Anchor># </span><code>command not found: hugo-obsidian</code></h3></a><p>Make sure you set your <code>GOPATH</code> correctly! This will allow your terminal to correctly recognize <code>hugo-obsidian</code> as an executable.</p><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 the following 2 lines to your ~/.bash_profile</span>
</span></span></code></pre></td></tr></table></div></div><ahref=#how-come-my-notes-arent-being-rendered><h3id=how-come-my-notes-arent-being-rendered><spanclass=hanchorarialabel=Anchor># </span>How come my notes aren’t being rendered?</h3></a><p>You probably forgot to include front matter in your Markdown files. You can either setup
<ahref=/notes/obsidian/rel=noopenerclass=internal-linkdata-src=/notes/obsidian/>Obsidian</a> to do this for you or you need to manually define it. More details in
<ahref=/notes/editing/rel=noopenerclass=internal-linkdata-src=/notes/editing/>the ‘how to edit’ guide</a>.</p><ahref=#my-custom-domain-isnt-working><h3id=my-custom-domain-isnt-working><spanclass=hanchorarialabel=Anchor># </span>My custom domain isn’t working!</h3></a><p>Walk through the steps in
<ahref=/notes/hosting/rel=noopenerclass=internal-linkdata-src=/notes/hosting/>the hosting guide</a> again. Make sure you wait 30 min to 1 hour for changes to take effect.</p><ahref=#how-do-i-setup-analytics><h3id=how-do-i-setup-analytics><spanclass=hanchorarialabel=Anchor># </span>How do I setup analytics?</h3></a><p>Quartz by default uses
<ahref=https://plausible.io/rel=noopener>Plausible</a> for analytics.</p><p>If you would prefer to use Google Analytics, you can follow this
<ahref=https://gohugo.io/templates/internal/#google-analyticsrel=noopener>guide in the Hugo documentation</a>.</p><p>Alternatively, you can also import your Google Analytics data into Plausible by
<ahref=https://plausible.io/docs/google-analytics-importrel=noopener>following this guide</a>.</p><ahref=#how-do-i-change-the-content-on-the-home-page><h3id=how-do-i-change-the-content-on-the-home-page><spanclass=hanchorarialabel=Anchor># </span>How do I change the content on the home page?</h3></a><p>To edit the main home page, open <code>/content/_index.md</code>.</p><ahref=#how-do-i-change-the-colours><h3id=how-do-i-change-the-colours><spanclass=hanchorarialabel=Anchor># </span>How do I change the colours?</h3></a><p>You can change the theme by editing <code>assets/custom.scss</code>. More details on customization and themeing can be found in the
<ahref=/notes/config/rel=noopenerclass=internal-linkdata-src=/notes/config/>customization guide</a>.</p><ahref=#how-do-i-add-images><h3id=how-do-i-add-images><spanclass=hanchorarialabel=Anchor># </span>How do I add images?</h3></a><p>You can put images anywhere in the <code>/content</code> folder.</p><divclass=highlight><divclass=chroma><tableclass=lntable><tr><tdclass=lntd><pretabindex=0class=chroma><code><spanclass=lnt>1
</span><spanclass=lnt>2
</span></code></pre></td><tdclass=lntd><pretabindex=0class=chroma><codeclass=language-markdowndata-lang=markdown><spanclass=line><spanclass=cl>Example image (source is in content/notes/images/example.png)
</span></span></code></pre></td></tr></table></div></div><ahref=#my-interactive-graph-and-backlinks-arent-up-to-date><h3id=my-interactive-graph-and-backlinks-arent-up-to-date><spanclass=hanchorarialabel=Anchor># </span>My Interactive Graph and Backlinks aren’t up to date</h3></a><p>By default, the <code>linkIndex.json</code> (which Quartz needs to generate the Interactive Graph and Backlinks) are not regenerated locally. To set that up, see the guide on
<ahref=/notes/editing/rel=noopenerclass=internal-linkdata-src=/notes/editing/>local editing</a></p><ahref=#can-i-use-reactvuesome-other-framework><h3id=can-i-use-reactvuesome-other-framework><spanclass=hanchorarialabel=Anchor># </span>Can I use React/Vue/some other framework?</h3></a><p>Not out of the box. You could probably make it work by editing <code>/layouts/_default/single.html</code> but that’s not what Quartz is designed to work with. 99% of things you are trying to do with those frameworks you can accomplish perfectly fine using just vanilla HTML/CSS/JS.</p><ahref=#still-stuck><h2id=still-stuck><spanclass=hanchorarialabel=Anchor># </span>Still Stuck?</h2></a><p>Quartz isn’t perfect! If you’re still having troubles, file an issue in the GitHub repo with as much information as you can reasonably provide. Alternatively, you can message me on
<ahref=https://twitter.com/_jzhaorel=noopener>Twitter</a> and I’ll try to get back to you as soon as I can.</p><p>🐛
