A dark theme for Zola, based on After Dark.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

77 lines
2.1 KiB

# nighttime
7 years ago
This is a fork of [After Dark](https://github.com/getzola/after-dark/), a theme for [Zola](https://www.getzola.org/), with aditional suppot for tags and sections.
![after-dark screenshot](https://github.com/jbiason/nighttime/blob/master/screenshot.png?raw=true)
7 years ago
## 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/jbiason/nighttime.git
7 years ago
```
and then enable it in your `config.toml`:
```toml
theme = "nighttime"
7 years ago
```
This theme requires your index section (`content/_index.md`) to be paginated to work:
```toml
paginate_by = 5
```
The posts should therefore be in directly under the `content` folder.
The theme requires tags and categories taxonomies to be enabled in your `config.toml`:
```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.
7 years ago
## Options
Because this is, mostly, After Dark with support for extra stuff, it still uses the same options as After Dark.
If you're already using After Dark, there are no changes in your configs that need to be done, besides changing the theme name.
7 years ago
### Top-menu
7 years ago
Set a field in `extra` with a key of `after_dark_menu`:
```toml
after_dark_menu = [
{url = "$BASE_URL", name = "Home"},
{url = "$BASE_URL/categories", name = "Categories"},
{url = "$BASE_URL/tags", name = "Tags"},
{url = "https://google.com", name = "Google"},
]
```
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 homepage. As it might be different from the `<title>`
element that the `title` field in the config represents, you can set the `after_dark_title`
instead.
7 years ago
## Original
This template is based on the Hugo template https://github.com/comfusion/after-dark