mirror
/
zola
mirror of https://github.com/getzola/zola
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
zola/docs/content/themes/zerm/index.md

2.5 KiB
Raw Permalink Blame History

+++ title = "zerm" description = "A minimalistic and dark theme based on Radek Kozieł's theme for Hugo" template = "theme.html" date = 2024-09-02T05:58:27Z

[extra] created = 2024-09-02T05:58:27Z updated = 2024-09-02T05:58:27Z repository = "https://github.com/ejmg/zerm.git" homepage = "https://github.com/ejmg/zerm" minimum_version = "0.8.0" license = "MIT" demo = "https://zerm.ejmg.now.sh/"

[extra.author] name = "elias julian marko garcia" homepage = "https://github.com/ejmg" +++

zerm

a minimalist and dark theme for Zola.

Screenshot

Live Preview!

Largely a port of Radek Kozieł's Terminal Theme for Hugo. 4/5ths of my way through porting this theme, I discovered Paweł Romanowski own independent fork for Zola, 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.

configuration

Please follow the Zola documentation for how to use 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!

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.

# 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.