| | |
| | | |
| | | While you're here, join our [Discord](https://discord.gg/cRFFHYye7t) :) |
| | | |
| | | ### Does Quartz have Latex support? |
| | | Not by default! You can create a partial using something like Katex under `head/katex.html` and render the partial somewhere using `{{ partial "head/katex.html" . }}` (most likely in `layouts/_default/single.html`). |
| | | |
| | | ```html |
| | | <link rel="stylesheet" href="[https://cdn.jsdelivr.net/npm/katex@0.15.1/dist/katex.min.css](https://cdn.jsdelivr.net/npm/katex@0.15.1/dist/katex.min.css)" integrity="sha384-R4558gYOUz8mP9YWpZJjofhk+zx0AS11p36HnD2ZKj/6JR5z27gSSULCNHIRReVs" crossorigin="anonymous"> |
| | | <script defer src="[https://cdn.jsdelivr.net/npm/katex@0.15.1/dist/katex.min.js](https://cdn.jsdelivr.net/npm/katex@0.15.1/dist/katex.min.js)" integrity="sha384-z1fJDqw8ZApjGO3/unPWUPsIymfsJmyrDVWC8Tv/a1HeOtGmkwNd/7xUS0Xcnvsx" crossorigin="anonymous"></script> |
| | | <script defer src="[https://cdn.jsdelivr.net/npm/katex@0.15.1/dist/contrib/auto-render.min.js](https://cdn.jsdelivr.net/npm/katex@0.15.1/dist/contrib/auto-render.min.js)" integrity="sha384-+XBljXPPiv+OzfbB3cVmLHf4hdUFHlWNZN5spNQ7rmHTXpd7WvJum6fIACpNNfIR" crossorigin="anonymous" |
| | | onload="renderMathInElement(document.body);"></script> |
| | | <script> |
| | | document.addEventListener("DOMContentLoaded", function() { |
| | | renderMathInElement(document.body, { |
| | | delimiters: [ |
| | | {left: '$$', right: '$$', display: true}, |
| | | {left: '$', right: '$', display: false}, |
| | | {left: '\\(', right: '\\)', display: false}, |
| | | {left: '\\[', right: '\\]', display: true} |
| | | ], |
| | | throwOnError : false |
| | | }); |
| | | }); |
| | | </script> |
| | | ``` |
| | | |
| | | Example page: [jzhao.xyz/thoughts/object-classification](https://jzhao.xyz/thoughts/object-classification/) |
| | | |
| | | ### My <\iframe\> is not rendering! |
| | | |
| | | Hugo's safeHTML enables this! This is disabled by default for security reasons but you can do this manually by changing `{{.Content}}` to `{{.Content | safeHTML}}` in `layouts/_default/single.html`. |
| | | |
| | | ### Can I use \<Obsidian Plugin\> in Quartz? |
| | | Unless it produces direct Markdown output in the file, no. There currently is no way to bundle plugin code with Quartz. |
| | | |
| | | The easiest way would be to add your own HTML partial that supports the functionality you are looking for. |
| | | |
| | | ### My GitHub pages is just showing the README and not Quartz |
| | | Make sure you set the source to deploy from `master` (and not `hugo`) using `/ (root)`! See more in the [hosting](/notes/hosting) guide |
| | | |
| | |
| | | ### Can I host this myself and not on GitHub Pages? |
| | | Yes! All built files can be found under `/public` in the `master` branch. More details under [hosting](notes/hosting.md). |
| | | |
| | | ### Do I need a website already? |
| | | No! Setting up Quartz means you set up a site too :) |
| | | |
| | | ### `command not found: hugo-obsidian` |
| | | Make sure you set your `GOPATH` correctly! This will allow your terminal to correctly recognize `hugo-obsidian` as an executable. |
| | | |
| | |
| | | ``` |
| | | |
| | | ### How come my notes aren't being rendered? |
| | | You probably forgot to include front matter in your Markdown files. You can either setup [obsidian](notes/obsidian.md) to do this for you or you need to manually define it. More details in [the 'how to edit' guide](notes/editing.md). |
| | | You probably forgot to include front matter in your Markdown files. You can either setup [Obsidian](notes/obsidian.md) to do this for you or you need to manually define it. More details in [the 'how to edit' guide](notes/editing.md). |
| | | |
| | | ### My custom domain isn't working! |
| | | Walk through the steps in [the hosting guide](notes/hosting.md) again. Make sure you wait 30 min to 1 hour for changes to take effect. |
| | |
| | | You can change the theme by editing `assets/custom.scss`. More details on customization and themeing can be found in the [customization guide](notes/config.md). |
| | | |
| | | ### How do I add images? |
| | | You can put images anywhere in the `/content` folder. The only caveat is that you should reference them in your Markdown by prefixing it with a `/`. |
| | | You can put images anywhere in the `/content` folder. |
| | | |
| | | ```markdown |
| | | Example image (source is in content/notes/images/example.png) |
| | |
| | | ``` |
| | | |
| | | ### My Interactive Graph and Backlinks aren't up to date |
| | | By default, the `linkIndex.yaml` (which Quartz needs to generate the Interactive Graph and Backlinks) are not regenerated locally. To set that up, see the guide on [local editing](notes/editing.md) |
| | | By default, the `linkIndex.json` (which Quartz needs to generate the Interactive Graph and Backlinks) are not regenerated locally. To set that up, see the guide on [local editing](notes/editing.md) |
| | | |
| | | ### Can I use React/Vue/some other framework? |
| | | Not out of the box. You could probably make it work by editing `/layouts/_default/single.html` 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. |