mirror of
https://github.com/getzola/zola
synced 2025-01-10 10:59:00 +00:00
141 lines
No EOL
3.3 KiB
Markdown
141 lines
No EOL
3.3 KiB
Markdown
|
|
+++
|
|
title = "apollo"
|
|
description = "Modern and minimalistic blog theme"
|
|
template = "theme.html"
|
|
date = 2024-01-09T08:33:22+01:00
|
|
|
|
[extra]
|
|
created = 2024-01-09T08:33:22+01:00
|
|
updated = 2024-01-09T08:33:22+01: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](https://getzola.org). See a live preview [here](https://not-matthias.github.io/apollo).
|
|
|
|
<sub><sup>Named after the greek god of knowledge, wisdom and intellect</sup></sub>
|
|
|
|
<details open>
|
|
<summary>Dark theme</summary>
|
|
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary>Light theme</summary>
|
|
|
|
|
|
</details>
|
|
|
|
## Features
|
|
|
|
- [X] Pagination
|
|
- [X] Themes (light, dark, auto)
|
|
- [X] Projects page
|
|
- [X] Analytics using [GoatCounter](https://www.goatcounter.com/) / [Umami](https://umami.is/)
|
|
- [x] Social Links
|
|
- [x] MathJax Rendering
|
|
- [x] Taxonomies
|
|
- [x] 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:
|
|
|
|
```toml
|
|
[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 $..$.
|
|
|
|
```toml
|
|
[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:
|
|
|
|
```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:
|
|
|
|
```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.
|
|
|
|
```toml
|
|
title = "post title"
|
|
description = "post desc"
|
|
date = "2023-01-01"
|
|
```
|
|
|
|
## References
|
|
|
|
This theme is based on [archie-zola](https://github.com/XXXMrG/archie-zola/).
|
|
|
|
|