From fa3bc3de9273d2cb437605d1b229d9a8d79331b5 Mon Sep 17 00:00:00 2001 From: Jacky Zhao <j.zhao2k19@gmail.com> Date: Fri, 11 Feb 2022 22:24:54 +0000 Subject: [PATCH] Merge pull request #48 from earnestma/earne/configurable-page-toc --- content/notes/troubleshooting.md | 22 ++++++++++++++++++---- 1 files changed, 18 insertions(+), 4 deletions(-) diff --git a/content/notes/troubleshooting.md b/content/notes/troubleshooting.md index 3a96659..6aab5ef 100644 --- a/content/notes/troubleshooting.md +++ b/content/notes/troubleshooting.md @@ -2,9 +2,23 @@ title: "Troubleshooting and FAQ" --- -## Common Pitfalls +Still having trouble? Here are a list of common questions and problems people encounter when installing Quartz. + +While you're here, join our [Discord](https://discord.gg/cRFFHYye7t) :) + +### Some of my pages have 'January 1, 0001' as the last modified date +This is a problem caused by `git` 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. + +```shell +# in the root of your Quartz (same folder as config.toml) +git config core.ignorecase true + +# or globally (not recommended) +git config --global core.ignorecase true +``` + ### Can I publish only a subset of my pages? -Yes! Quartz makes selective publishing really easy. Heres a guide on [excluding pages from being published](notes/ignore-notes.md). +Yes! Quartz makes selective publishing really easy. Heres a guide on [excluding pages from being published](notes/ignore%20notes.md). ### 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). @@ -15,7 +29,7 @@ ### `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. -``` +```shell # Add the following 2 lines to your ~/.bash_profile export GOPATH=/Users/$USER/go export PATH=$GOPATH/bin:$PATH @@ -25,7 +39,7 @@ ``` ### 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) 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. -- Gitblit v1.10.0