https://github.com/konstantine-v/minimal-zola-theme
A minimal Zola Theme with no Javascript, based roughly on the Even Theme
https://github.com/konstantine-v/minimal-zola-theme
static-site zola zola-theme
Last synced: 8 months ago
JSON representation
A minimal Zola Theme with no Javascript, based roughly on the Even Theme
- Host: GitHub
- URL: https://github.com/konstantine-v/minimal-zola-theme
- Owner: konstantine-v
- License: mit
- Created: 2020-02-05T20:10:39.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-03-01T01:30:30.000Z (over 3 years ago)
- Last Synced: 2025-01-09T12:39:54.454Z (9 months ago)
- Topics: static-site, zola, zola-theme
- Language: SCSS
- Homepage:
- Size: 55.7 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Minimal
Minimal is a minimal version of the Even [theme](https://github.com/getzola/even.git), this requires no JS to be run and the CSS is under 10kb.
## Contents
[[_TOC_]]
## Installation
First download this theme to your `themes` directory:
```bash
$ cd themes
$ git clone git@gitlab.com:MaterialFuture/minimal-zola-theme.git
```
and then enable it in your `config.toml`:
```toml
theme = "minimal"
```
you can alternatively add it as a git submodule to save space when commiting.
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.
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"},
]
```
### Homepage Content
Set the content of the homepage
```toml
# This is where you'll put content you want on the homepage however you want it.
#Homepage Stuff - You'll see this on the homepage
homepage_content = [
{content = "Another One"},
]
```
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 ``
element that the `title` field in the config represents, you can set the `even_title`
instead.
### SEO and Header Tags
Some SEO Tags have been added as well as some important head tags for browser compatibility.
I kept this as minimal as possible, but if you need more SEO tags you can find more [here in this gist I created]{https://gitlab.com/snippets/1933851}.