mirror of https://github.com/getzola/zola
253 lines
5.9 KiB
Markdown
253 lines
5.9 KiB
Markdown
|
|
+++
|
|
title = "anatole-zola"
|
|
description = "A port of farbox-theme-Anatole for zola"
|
|
template = "theme.html"
|
|
date = 2024-09-02T05:58:27Z
|
|
|
|
[extra]
|
|
created = 2024-09-02T05:58:27Z
|
|
updated = 2024-09-02T05:58:27Z
|
|
repository = "https://github.com/longfangsong/anatole-zola.git"
|
|
homepage = "https://github.com/longfangsong/anatole-zola"
|
|
minimum_version = "0.4.0"
|
|
license = "MIT"
|
|
demo = "https://longfangsong.github.io"
|
|
|
|
[extra.author]
|
|
name = "longfangsong"
|
|
homepage = "https://github.com/longfangsong"
|
|
+++
|
|
|
|
# Anatole Theme for Zola
|
|
|
|
*[Anatole theme for Farbox](https://github.com/hi-caicai/farbox-theme-Anatole) ported to Zola*
|
|
___
|
|
[Zola Homepage](https://www.getzola.org/themes/anatole-zola/) | [Demo with customizations](https://longfangsong.github.io/)
|
|
___
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
First download this theme to your `themes` directory:
|
|
|
|
```bash
|
|
$ cd themes
|
|
$ git clone https://github.com/longfangsong/anatole-zola.git
|
|
```
|
|
and then enable it in your `config.toml`:
|
|
|
|
```toml
|
|
theme = "anatole-zola"
|
|
```
|
|
|
|
And copy the `content/about`, `content/archive`, `content/_index.md` in the theme folder to your own content folder. And edit the `_index.md` in `about` folder to edit the content of your `about` page.
|
|
|
|
## Options
|
|
|
|
### Basic
|
|
|
|
Add `title`, `description` and `base_url`:
|
|
|
|
```toml
|
|
title = "Anatole"
|
|
description = "A other zola theme"
|
|
base_url = "https://example.com"
|
|
```
|
|
|
|
### Mode
|
|
|
|
Though the origin theme only support light mode, we added a dark mode option here.
|
|
|
|
You can either
|
|
- set the `extra.mode` field in `config.toml` to use the dark/light mode
|
|
- or set the `extra.default_mode` field in `config.toml` to read the dark/light mode from `localStorage` (the key is `'mode'`), and use some Javascript to control the theme each reader is using
|
|
- or do nothing, we'll use light mode by default
|
|
|
|
### Language
|
|
|
|
Currently, we have English, Chinese, German and Swedish translations, set the `default_language` if necessary:
|
|
|
|
```toml
|
|
# 如果你想要中文
|
|
default_language = "zh"
|
|
```
|
|
|
|
If there are complications, you can copy this snippet to your `config.toml`:
|
|
|
|
```toml
|
|
[languages.en.translations]
|
|
language_name = "English"
|
|
about = "About"
|
|
home = "Home"
|
|
tags = "Tags"
|
|
archive = "Archive"
|
|
links = "Links"
|
|
date_format = "%Y-%m-%d"
|
|
next_page = "Next Page"
|
|
last_page = "Last Page"
|
|
|
|
[languages.zh.translations]
|
|
language_name = "中文"
|
|
home = "首页"
|
|
about = "关于"
|
|
tags = "标签"
|
|
archive = "归档"
|
|
links = "友链"
|
|
date_format = "%Y-%m-%d"
|
|
next_page = "下一页"
|
|
last_page = "上一页"
|
|
|
|
[languages.de.translations]
|
|
language_name = "Deutsch"
|
|
about = "Info"
|
|
home = "Home"
|
|
tags = "Kategorien"
|
|
archive = "Archiv"
|
|
links = "Links"
|
|
date_format = "%d-%m-%Y"
|
|
next_page = "Nächste Seite"
|
|
last_page = "Vorherige Seite"
|
|
|
|
[languages.sv.translations]
|
|
language_name = "Svenska"
|
|
about = "Info"
|
|
home = "Hem"
|
|
tags = "Etiketter"
|
|
archive = "Arkiv"
|
|
links = "Länkar"
|
|
date_format = "%Y-%m-%d"
|
|
next_page = "Nästa Sidan"
|
|
last_page = "Sista Sidan"
|
|
```
|
|
|
|
Feel free to create a pull request if you want to translate the theme into other languages!
|
|
#### Multilingual
|
|
|
|
The theme will become multilingual automatically if you specify another language except `default_language`.
|
|
|
|
You'll see a language-switching button on top right.
|
|
|
|
|
|
### Sections
|
|
|
|
Tags and links sections are optional.
|
|
|
|
- If you want to enable the tags page, add
|
|
```toml
|
|
taxonomies = [
|
|
{name = "tags"},
|
|
]
|
|
|
|
[extra.show]
|
|
tags = true
|
|
```
|
|
To your `config.toml`
|
|
|
|
- If you want to enable the links page, add
|
|
|
|
```toml
|
|
[extra.show]
|
|
links = true
|
|
```
|
|
|
|
and copy `content/links` to your own `content` library. And edit the `_index.md` in it to modify its content.
|
|
|
|
- If you want to add the author's name on each page, add:
|
|
|
|
```toml
|
|
[extra]
|
|
author = "John Doe"
|
|
```
|
|
|
|
### Sidebar menu
|
|
|
|
We support a bunch of social links:
|
|
|
|
```toml
|
|
[extra.social]
|
|
github = ""
|
|
gitlab = ""
|
|
stackoverflow = "" # use user_id
|
|
twitter = ""
|
|
mastodon = "" # use hostname/@username
|
|
facebook = ""
|
|
instagram = ""
|
|
dribbble = ""
|
|
weibo = ""
|
|
linkedin = ""
|
|
flickr = ""
|
|
```
|
|
|
|
Fill in your username if you want! And the logo won't appear if you leave it empty.
|
|
|
|
|
|
|
|
### Comment system
|
|
|
|
We currently support...
|
|
|
|
- [Valine](https://valine.js.org/quickstart.html):
|
|
|
|
```toml
|
|
[extra.comment.valine]
|
|
appid = "Your appid goes here"
|
|
appkey = "Your appkey goes here"
|
|
notify = false # true/false: mail notify https://github.com/xCss/Valine/wiki/Valine-%E8%AF%84%E8%AE%BA%E7%B3%BB%E7%BB%9F%E4%B8%AD%E7%9A%84%E9%82%AE%E4%BB%B6%E6%8F%90%E9%86%92%E8%AE%BE%E7%BD%AE
|
|
verify = false # true/false: verify code
|
|
avatar = "mm" # avatar style https://github.com/xCss/Valine/wiki/avatar-setting-for-valine
|
|
placeholder = "Say something here"
|
|
```
|
|
|
|
- [Disqus](https://disqus.com/admin/create/), note that Disqus does not work in Mainland China:
|
|
|
|
```toml
|
|
[extra.comment.disqus]
|
|
name = "longfangsong"
|
|
```
|
|
|
|
- [Utterances](https://utteranc.es/):
|
|
|
|
```toml
|
|
[extra.comment.utterances]
|
|
repo = "Your repo for comments"
|
|
issue_term = "pathname"
|
|
theme = "github-light"
|
|
```
|
|
|
|
|
|
## Customize
|
|
|
|
There are several options I left in the origin templates for you to customize your site.
|
|
|
|
### More style
|
|
|
|
You can create a `blog.scss` or something similiar in the your `sass` folder, add a `templates.html` with following content:
|
|
|
|
```html
|
|
{%/* extends "anatole-zola/templates/basic.html" */%}
|
|
{%/* block extra_head */%}
|
|
<link rel="stylesheet" href="{{/* get_url(path="blog.css") */}}">
|
|
{%/* endblock */%}
|
|
```
|
|
|
|
### More social links
|
|
|
|
You can add more social links by adding a `templates.html` with some content added to `more_social_link` block:
|
|
|
|
```html
|
|
{%/* extends "anatole-zola/templates/basic.html" */%}
|
|
{%/* block more_social_link */%}
|
|
<div id="pirate" data-wordart-src="//cdn.wordart.com/json/685czi4rqil5" style="width: 100%;" data-wordart-show-attribution></div>
|
|
{%/* endblock */%}
|
|
```
|
|
|
|
If you want to use some awesome logos, [FontAwesome icons](https://fontawesome.com/icons?d=gallery) are already available.
|
|
|
|
|