zola/docs/content/themes/even/index.md
Vincent Prouillet a49af5fa48
Update themes gallery (#2309)
Co-authored-by: GitHub Action <action@github.com>
2023-09-22 11:07:16 +02:00

2.9 KiB

+++ title = "even" description = "A robust, elegant dark theme" template = "theme.html" date = 2023-09-15T21:56:17+02:00

[extra] created = 2023-09-15T21:56:17+02:00 updated = 2023-09-15T21:56:17+02:00 repository = "https://github.com/getzola/even.git" homepage = "https://github.com/getzola/even" minimum_version = "0.17.0" license = "MIT" demo = "https://getzola.github.io/even/"

[extra.author] name = "Vincent Prouillet" homepage = "https://www.vincentprouillet.com" +++

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
  • Options
    • Top menu
    • Title

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", feed = true},
    {name = "tags", feed = 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