79 lines
3.8 KiB
Markdown
79 lines
3.8 KiB
Markdown
---
|
|
title: "Troubleshooting and FAQ"
|
|
---
|
|
|
|
Still having trouble? Here are a list of common questions and problems people encounter when installing Amethyst.
|
|
|
|
### Does Amethyst have Latex support?
|
|
Yes! See [LaTeX](features/latex.md) for a brief demo.
|
|
|
|
### Can I use \<Obsidian Plugin\> in Amethyst?
|
|
Unless it produces direct Markdown output in the file, no. There currently is no way to bundle plugin code with Amethyst.
|
|
|
|
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
|
|
Make sure you set the source to deploy from the `deploy` branch (and not `main`) using `/ (root)`! See more in the [hosting](/setup/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 Amethyst by running this command.
|
|
|
|
```shell
|
|
# in the root folder (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! Amethyst makes selective publishing really easy. Heres a guide on [excluding pages from being published](setup/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](setup/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
|
|
|
|
# In your current terminal, to reload the session
|
|
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](setup/obsidian.md) to do this for you or you need to manually define it. More details in [the 'how to edit' guide](setup/editing.md).
|
|
|
|
### My custom domain isn't working!
|
|
Walk through the steps in [the hosting guide](setup/hosting.md) again. Make sure you wait 30 min to 1 hour for changes to take effect.
|
|
|
|
### How do I setup Google Analytics?
|
|
You can edit it in `config.toml` and either use a V3 (UA-) or V4 (G-) tag.
|
|
|
|
### How do I change the content on the home page?
|
|
To edit the main home page, open `/content/_index.md`.
|
|
|
|
### How do I change the colours?
|
|
You can change the theme by editing `assets/custom.scss`. More details on customization and themeing can be found in the [customization guide](setup/config.md).
|
|
|
|
### How do I add images?
|
|
You can put images anywhere in the `/content` folder.
|
|
|
|
```markdown
|
|
Example image (source is in content/setup/images/example.png)
|
|
|
|
```
|
|
|
|
### My Interactive Graph and Backlinks aren't up to date
|
|
By default, the `linkIndex.json` (which Amethyst needs to generate the Interactive Graph and Backlinks) are not regenerated locally. To set that up, see the guide on [local editing](setup/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 Amethyst 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.
|
|
|
|
## Still Stuck?
|
|
Amethyst isn't perfect! If you're still having troubles, file an issue in the GitHub repo with as much information as you can reasonably provide. Alternatively, [send me a message](https://bencuan.me/contact) using your preferred communication method!
|
|
|
|
🐛 [Submit an Issue](https://github.com/64bitpandas/amethyst/issues) |