| | |
|---|
| | | 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) :) |
|---|
| | | |
|---|
| | | ### 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 |
|---|
| | | |
|---|
| | | ### 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). |
|---|
| | |
|---|
| | | ### `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 |
|---|
| | |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | ### 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. |
|---|
