zola/docs/content/themes/after-dark/index.md

110 lines
2.4 KiB
Markdown
Raw Normal View History

2018-02-23 17:05:46 +00:00
+++
title = "after-dark"
description = "A robust, elegant dark theme"
template = "theme.html"
date = 2022-08-16T14:32:26-05:00
2018-02-23 17:05:46 +00:00
[extra]
created = 2022-08-16T14:32:26-05:00
updated = 2022-08-16T14:32:26-05:00
repository = "https://github.com/getzola/after-dark.git"
2018-11-17 17:27:48 +00:00
homepage = "https://github.com/getzola/after-dark"
minimum_version = "0.11.0"
2018-02-23 17:05:46 +00:00
license = "MIT"
2018-11-17 17:27:48 +00:00
demo = "https://zola-after-dark.netlify.com"
2018-02-23 17:05:46 +00:00
[extra.author]
name = "Vincent Prouillet"
2018-11-17 17:27:48 +00:00
homepage = "https://www.vincentprouillet.com"
2018-02-23 17:05:46 +00:00
+++
# after-dark
2018-11-17 17:27:48 +00:00
![after-dark screenshot](https://github.com/getzola/after-dark/blob/master/screenshot.png?raw=true)
2018-02-23 17:05:46 +00:00
## Contents
- Installation
- Options
- Top menu
- Title
- Author
2018-02-23 17:05:46 +00:00
## Installation
First download this theme to your `themes` directory:
```bash
cd themes
git clone https://github.com/getzola/after-dark.git
2018-02-23 17:05:46 +00:00
```
and then enable it in your `config.toml`:
```toml
theme = "after-dark"
```
2018-08-04 11:15:01 +00:00
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", feed = true},
{name = "tags", feed = true},
2018-08-04 11:15:01 +00:00
]
```
If you want to paginate taxonomies pages, you will need to overwrite the templates
as it only works for non-paginated taxonomies by default.
2018-02-23 17:05:46 +00:00
## Options
### Top-menu
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.
### Author
You can set this on a per page basis or in the config file.
`config.toml`:
```toml
[extra]
author = "John Smith"
```
In a page (wrap this in +++):
```toml
title = "..."
date = 1970-01-01
[extra]
author = "John Smith"
```
2018-02-23 17:05:46 +00:00
## Original
2019-04-06 09:37:49 +00:00
This template is based on the Hugo template https://git.habd.as/comfusion/after-dark
2018-02-23 17:05:46 +00:00
2018-08-04 11:15:01 +00:00