even

KO | EN

gitlite — search

#python #react #llm #deep-learning #linux #awesome #cli #vue #awesome-list #security #pytorch #mcp #ios #openai

(★ 82)

A clean blog theme for Zola

File Explorer

Download Latest Version (.zip)

- - docs.yml
- - _index.md
  - about.md
- _index.md
- eigth_post.md
- fifth_post.md
- first_post.md
- fourth_post.md
- markdown_overview.md
- ninth_post.md
- second_post.md
- seventh_post.md
- sixth_post.md
- some-article.md
- some-other-article.md
- tenth_post.md
- Theme_Overview.md
- third_post.md
- _animations.scss
- _base.scss
- _header.scss
- _main.scss
- _mobile.scss
- _normalize.scss
- _slideout.scss
- _syntax-charcoal.scss
- _toc.scss
- _variables.scss
- site.scss
- even.js
- - list.html
  - single.html
- - katex.html
- - list.html
  - single.html
- about.html
- index.html
- page.html
- post_macros.html
.gitignore
config.toml
LICENSE
README.md
screenshot.png
theme.toml

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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

![even screenshot](https://github.com/getzola/even/blob/master/screenshot.png?raw=true)

## Contents

- [Installation](#installation)
- [Options](#options)
  - [Top menu](#top-menu)
  - [Title](#title)

## Installation
First download this theme to your `themes` directory:

```bash
cd themes
git clone https://github.com/getzola/even.git
```
and then enable it in your `config.toml`:

```toml
theme = "even"
```

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

```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`:

```toml
# 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](https://katex.org/),
which can be enabled by setting `katex_enable = true` in the `extra` section
of `config.toml`:

```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:

```toml
[extra]
katex_enable = true
katex_auto_render = true
```

even

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

even

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README