zola/docs/content/themes/clean-blog/index.md
Vincent Prouillet 294505f4bc
Update themes gallery (#1887)
Co-authored-by: GitHub Action <action@github.com>
2022-06-06 10:46:29 +02:00

79 lines
No EOL
2.1 KiB
Markdown

+++
title = "Clean Blog"
description = "A port of Start Bootstrap Clean Blog for Zola"
template = "theme.html"
date = 2022-06-03T14:22:50-07:00
[extra]
created = 2022-06-03T14:22:50-07:00
updated = 2022-06-03T14:22:50-07:00
repository = "https://github.com/dave-tucker/zola-clean-blog.git"
homepage = "https://github.com/dave-tucker/zola-clean-blog"
minimum_version = "0.4.0"
license = "MIT"
demo = "https://zola-clean-blog.netlify.com/"
[extra.author]
name = "Dave Tucker"
homepage = "https://dtucker.co.uk"
+++
zola-clean-blog
===============
![screenshot](screenshot.png)
A port of the StartBootstrap Clean Blog theme, for Zola.
## Demo
[Live Demo](https://zola-clean-blog.netlify.com)
## Usage
To use the theme, clone this repository to your `themes` directory.
It requires that you use the categories and tags taxonomies.
This can be done with the following additions to `config.toml`:
```toml
theme = "zola-clean-blog"
taxonomies = [
{name = "categories", rss = true, paginate_by=5},
{name = "tags", rss = true, paginate_by=5},
]
```
## Features
- Paginated Home/Categories/Tag Pages
- Customizable Menu
- Customizable Social Links
## How To Customize
- To replace header images, add a new image to `static/img/$page-bg.jpg` where `$page` is one of `about`, `home`, `post` or `contact`.
- To replace the copyright field, create your own `templates/index.html` to extend the template and add a `copyright` block:
```
{%/* extends "zola-clean-blog/templates/index.html" */%}
{%/* block copyright */%}
Copyright %copy; Example, Inc. 2016-2019
{%/* endblock copyright */%}
```
- To add a new menu item, override `clean_blog_menu` in your `config.toml`. You can use `$BASE_URL` to reference your own site.
- To add a new social link, override `clean_blog_social` in your `config.toml`. You can use `$BASE_URL` to reference your own site.
- To add Google Analytics, you may add your script to the `extrascripts` block using your own `index.html`
```
{%/* extends "zola-clean-blog/templates/index.html" */%}
{%/* block analytics */%}
<script>
...
</script>
{%/* endblock analytics */%}
```