mirror of
https://github.com/falsycat/ar.falsy.cat.git
synced 2024-12-26 00:14:51 +00:00
more troubleshooting, backlinks reference private page fix
This commit is contained in:
parent
54a68e6e5c
commit
6605b13b86
@ -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) :)
|
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
|
### 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
|
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?
|
### 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).
|
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`
|
### `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.
|
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?
|
### 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!
|
### 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.
|
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).
|
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?
|
### 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
|
```markdown
|
||||||
Example image (source is in content/notes/images/example.png)
|
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
|
### 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?
|
### 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.
|
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.
|
||||||
|
@ -9,9 +9,12 @@
|
|||||||
{{if $inbound}}
|
{{if $inbound}}
|
||||||
{{$cleanedInbound := apply (apply $inbound "index" "." "source") "replace" "." " " "-"}}
|
{{$cleanedInbound := apply (apply $inbound "index" "." "source") "replace" "." " " "-"}}
|
||||||
{{- range $cleanedInbound | uniq -}}
|
{{- range $cleanedInbound | uniq -}}
|
||||||
|
{{$l := .}}
|
||||||
|
{{with (index $contentTable .)}}
|
||||||
<li>
|
<li>
|
||||||
<a href="{{$url}}{{.}}">{{index (index $contentTable .) "title"}}</a>
|
<a href="{{$l}}">{{index (index . "title")}}</a>
|
||||||
</li>
|
</li>
|
||||||
|
{{end}}
|
||||||
{{- end -}}
|
{{- end -}}
|
||||||
{{else}}
|
{{else}}
|
||||||
<li>
|
<li>
|
||||||
|
Loading…
Reference in New Issue
Block a user