From 6605b13b86c5e15bcaa2821937f97a59c4d2bbae Mon Sep 17 00:00:00 2001 From: Jacky Zhao Date: Thu, 31 Mar 2022 23:15:54 -0700 Subject: [PATCH] more troubleshooting, backlinks reference private page fix --- content/notes/troubleshooting.md | 43 +++++++++++++++++++++++++++----- layouts/partials/backlinks.html | 9 ++++--- 2 files changed, 43 insertions(+), 9 deletions(-) diff --git a/content/notes/troubleshooting.md b/content/notes/troubleshooting.md index 226216be..d61cee7e 100644 --- a/content/notes/troubleshooting.md +++ b/content/notes/troubleshooting.md @@ -6,6 +6,40 @@ Still having trouble? Here are a list of common questions and problems people en 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 + + + + +``` + +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 \ 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 @@ -26,9 +60,6 @@ Yes! Quartz makes selective publishing really easy. Heres a guide on [excluding ### 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. @@ -42,7 +73,7 @@ source ~/.bash_profile ``` ### 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. @@ -57,7 +88,7 @@ To edit the main home page, open `/content/_index.md`. 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) @@ -65,7 +96,7 @@ 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. diff --git a/layouts/partials/backlinks.html b/layouts/partials/backlinks.html index 166e1fde..ee6c5357 100644 --- a/layouts/partials/backlinks.html +++ b/layouts/partials/backlinks.html @@ -9,9 +9,12 @@ {{if $inbound}} {{$cleanedInbound := apply (apply $inbound "index" "." "source") "replace" "." " " "-"}} {{- range $cleanedInbound | uniq -}} -
  • - {{index (index $contentTable .) "title"}} -
    • + {{$l := .}} + {{with (index $contentTable .)}} +
  • + {{index (index . "title")}} +
    • + {{end}} {{- end -}} {{else}}