this repo has no description
hauleth.dev
1# zerm
2
3a minimalist and dark theme for [Zola](https://getzola.org).
4
5
6
7[**Live Preview!**](https://zerm.ejmg.now.sh/)
8
9Largely a port of Radek Kozieł's [Terminal
10Theme](https://github.com/panr/hugo-theme-terminal) for Hugo. 4/5ths of my way
11through porting this theme, I discovered Paweł Romanowski own independent fork
12for Zola, [Terminimal](https://github.com/pawroman/zola-theme-terminimal),
13which helped me get the PostCSS to Sass styling conversion done more
14quickly. My sincerest thanks to both of you!
15
16## differences
17
18This theme is largely true to the original by Radek, but there are some mild
19differences. They are almost all stylistic in nature and are intended to
20emphasize minimalism even more. Some of them are as follows:
21- tags are now included in a post's meta data.
22- no post image previews.
23- categories are included in the taxonomy.
24- bullet points have slightly more margin and different symbols for nesting.
25- no social media or comment support.
26
27Some of these might be added later and [PR's are always
28welcomed](https://github.com/ejmg/zerm/pulls).
29
30## configuration
31
32Please follow the Zola documentation for [how to use a
33theme](https://www.getzola.org/documentation/themes/installing-and-using-themes/#installing-a-theme).
34
35In `config.toml`, you will find all values for customization that are supported
36thus far have documentation explaining how they are used. If there is any confusion or something is not working as intended, [please open an issue](https://github.com/ejmg/zerm/issues)!
37
38## math
39You can use KaTeX for mathematical typesetting.
40Assets are only available if you opt-in on a per-page level through
41a single line (`math=true`) on the extra section of the page frontmatter.
42
43``` md
44# index.md
45+++
46title="this page title"
47...
48
49[extra]
50math=true
51+++
52
53Content
54```
55
56Pages wich doesn't opt-in are not affected in any way, so you doesn't have
57to worry about any performance hit.
58
59## license
60
61MIT. See `LICENSE.md` for more details.