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

+++ title = "apollo" description = "Modern and minimalistic blog theme" template = "theme.html" date = 2023-08-20T14:37:38+02:00

[extra] created = 2023-08-20T14:37:38+02:00 updated = 2023-08-20T14:37:38+02:00 repository = "https://github.com/not-matthias/apollo.git" homepage = "https://github.com/not-matthias/apollo" minimum_version = "0.14.0" license = "MIT" demo = "https://not-matthias.github.io/apollo"

[extra.author] name = "not-matthias" homepage = "https://github.com/not-matthias" +++

apollo

Modern and minimalistic blog theme powered by Zola. See a live preview here.

_{^{Named after the greek god of knowledge, wisdom and intellect}}

Dark theme

Light theme

Features

• Pagination
• Themes (light, dark, auto)
• Projects page
• Analytics using GoatCounter
• Social Links
• MathJax Rendering
• Meta Tags For Individual Pages
• Search
• Categories

Installation

1. Download the theme

git submodule add https://github.com/not-matthias/apollo themes/apollo

2. Add theme = "apollo" to your config.toml
3. Copy the example content

cp -r themes/apollo/content content

Options

Additional stylesheets

You can add stylesheets to override the theme:

[extra]
stylesheets = [
    "override.css",
    "something_else.css"
]

These filenames are relative to the root of the site. In this example, the two CSS files would be in the static folder.

MathJax

To enable MathJax equation rendering, set the variable mathjax to true in the extra section of your config.toml. Set mathjax_dollar_inline_enable to true to render inline math by surrounding them inside ...

[extra]
mathjax = true
mathjax_dollar_inline_enable = true

Config

Customize <meta/> tags

The following TOML and YAML code will yiled two <meta/> tags, <meta property="og:title" content="the og title"/>, <meta property="og:description" content="the og description"/>.

TOML:

title = "post title"
description = "post desc"
date = "2023-01-01"

[extra]
meta = [
    {property = "og:title", content = "the og title"},
    {property = "og:description", content = "the og description"},
]

YAML:

title: "post title"
description: "post desc"
date: "2023-01-01"
extra: 
    meta: 
        - property: "og:title"
          content: "the og title"
        - property: "og:description"
          content: "the og description"

If the og:title, the og:description, or the "description" are not set, the page's title and description will be used. That is, the following TOML code generates <meta property="og:title" content="post title"/>, <meta property="og:description" content="post desc"/>, and <meta property="og:description" content="post desc"/> as default values.

title = "post title"
description = "post desc"
date = "2023-01-01"

References

This theme is based on archie-zola.