zola/docs/content/themes/even/index.md

69 lines
1.5 KiB
Markdown
Raw Normal View History

2018-02-23 17:05:46 +00:00
+++
title = "even"
description = "A robust, elegant dark theme"
template = "theme.html"
date = 2018-01-25T18:44:44+01:00
[extra]
created = 2018-02-22T19:13:36+01:00
updated = 2018-01-25T18:44:44+01:00
repository = "https://github.com/Keats/even"
homepage = "https://github.com/Keats/even"
minimum_version = "0.3"
license = "MIT"
[extra.author]
name = "Vincent Prouillet"
homepage = "https://vincent.is"
+++
# 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/Keats/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/Keats/even.git
```
and then enable it in your `config.toml`:
```toml
theme = "even"
```
## 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.