https://github.com/ejmg/zerm

a minimalist and dark theme for Zola
https://github.com/ejmg/zerm

dark-theme rust static-site zola zola-theme

Last synced: about 1 month ago
JSON representation

a minimalist and dark theme for Zola

• Host: GitHub
• URL: https://github.com/ejmg/zerm
• Owner: ejmg
• License: mit
• Created: 2019-07-26T19:52:39.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-05-20T07:34:18.000Z (7 months ago)
• Last Synced: 2024-08-02T12:23:24.820Z (4 months ago)
• Topics: dark-theme, rust, static-site, zola, zola-theme
• Language: HTML
• Homepage: https://zerm.ejmg.now.sh/
• Size: 1.59 MB
• Stars: 115
• Watchers: 5
• Forks: 39
• Open Issues: 18
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• my-awesome-github-stars - ejmg/zerm - a minimalist and dark theme for Zola (HTML)

README

        
# zerm

a minimalist and dark theme for [Zola](https://getzola.org).

![Screenshot](../master/zerm-preview.png?raw=true)

[**Live Preview!**](https://zerm.ejmg.now.sh/)

Largely a port of Radek Kozieł's [Terminal

Theme](https://github.com/panr/hugo-theme-terminal) for Hugo. 4/5ths of my way

through porting this theme, I discovered Paweł Romanowski own independent fork

for Zola, [Terminimal](https://github.com/pawroman/zola-theme-terminimal),

which helped me get the PostCSS to Sass styling conversion done more

quickly. My sincerest thanks to both of you!

## differences

This theme is largely true to the original by Radek, but there are some mild

differences. They are almost all stylistic in nature and are intended to

emphasize minimalism even more. Some of them are as follows:

- tags are now included in a post's meta data.

- no post image previews.

- categories are included in the taxonomy.

- bullet points have slightly more margin and different symbols for nesting.

- no social media or comment support.

Some of these might be added later and [PR's are always

welcomed](https://github.com/ejmg/zerm/pulls).

## configuration

Please follow the Zola documentation for [how to use a

theme](https://www.getzola.org/documentation/themes/installing-and-using-themes/#installing-a-theme).

In `config.toml`, you will find all values for customization that are supported

thus 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)!

## math

You can use KaTeX for mathematical typesetting.

Assets are only available if you opt-in on a per-page level through

a single line (`math=true`) on the extra section of the page frontmatter.

``` md

# index.md

+++

title="this page title"

...

[extra]

math=true

+++

Content

```

Pages wich doesn't opt-in are not affected in any way, so you doesn't have

to worry about any performance hit.

## license

MIT. See `LICENSE.md` for more details.