Skip to content
A clean blog theme for Zola
Branch: master
Clone or download
Latest commit 367381a Apr 5, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
content HTTPS for placekitten Dec 14, 2018
sass
static remove demo image from ./static Dec 13, 2018
templates Fix ToC generation Apr 4, 2019
.gitignore Make even theme work in 0.3 Jan 25, 2018
LICENSE Initial commit Nov 23, 2017
README.md README: Describe KaTeX math formula support Jan 4, 2019
config.toml
screenshot.png
theme.toml Fix ToC generation Apr 4, 2019

README.md

Even

Even is a clean, responsive theme based on the Hugo theme with the same name featuring categories, tags and pagination.

even screenshot

Contents

Installation

First download this theme to your themes directory:

$ cd themes
$ git clone https://github.com/getzola/even.git

and then enable it in your config.toml:

theme = "even"

The theme requires tags and categories taxonomies to be enabled in your config.toml:

taxonomies = [
    # You can enable/disable RSS
    {name = "categories", rss = true},
    {name = "tags", rss = true},
]

If you want to paginate taxonomies pages, you will need to overwrite the templates as it only works for non-paginated taxonomies by default.

It also requires to put the posts in the root of the content folder and to enable pagination, for example in content/_index.md:

+++
paginate_by = 5
sort_by = "date"
+++

Options

Top-menu

Set a field in extra with a key of even_menu:

# This is the default menu
even_menu = [
    {url = "$BASE_URL", name = "Home"},
    {url = "$BASE_URL/categories", name = "Categories"},
    {url = "$BASE_URL/tags", name = "Tags"},
    {url = "$BASE_URL/about", name = "About"},
]

If you put $BASE_URL in a url, it will automatically be replaced by the actual site URL.

Title

The site title is shown on the header. As it might be different from the <title> element that the title field in the config represents, you can set the even_title instead.

KaTeX math formula support

This theme contains math formula support using KaTeX, which can be enabled by setting katex_enable = true in the extra section of config.toml:

[extra]
katex_enable = true

After enabling this extension, the katex short code can be used in documents:

  • {{ katex(body="\KaTeX") }} to typeset a math formula inlined into a text, similar to $...$ in LaTeX
  • {% katex(block=true) %}\KaTeX{% end %} to typeset a block of math formulas, similar to $$...$$ in LaTeX

Automatic rendering without short codes

Optionally, \\( \KaTeX \\) inline and \\[ \KaTeX \\] / $$ \KaTeX $$ block-style automatic rendering is also supported, if enabled in the config:

[extra]
katex_enable = true
katex_auto_render = true
You can’t perform that action at this time.