zola/docs/content/themes/zola-pickles/index.md

115 lines
2.8 KiB
Markdown
Raw Normal View History

2020-04-15 16:53:46 +00:00
+++
title = "pickles"
description = "A modern, simple, clean blog theme for Zola."
template = "theme.html"
date = 2021-08-18T01:00:57-07:00
2020-04-15 16:53:46 +00:00
[extra]
created = 2021-08-18T01:00:57-07:00
updated = 2021-08-18T01:00:57-07:00
2020-04-15 16:53:46 +00:00
repository = "https://github.com/lukehsiao/zola-pickles.git"
homepage = "https://github.com/lukehsiao/zola-pickles"
minimum_version = "0.13.0"
2020-04-15 16:53:46 +00:00
license = "MIT OR Apache-2.0"
demo = ""
[extra.author]
name = "Luke Hsiao"
2020-12-14 19:47:32 +00:00
homepage = "https://luke.hsiao.dev"
2020-04-15 16:53:46 +00:00
+++
# Pickles
Pickles is a clean, responsive blog theme based on the Hugo theme with the same name featuring pagination.
![pickles screenshot](https://github.com/lukehsiao/zola-pickles/blob/master/screenshot.png?raw=true)
## Installation
First download this theme to your `themes` directory:
```bash
$ cd themes
$ git clone https://github.com/lukehsiao/zola-pickles.git
```
and then enable it in your `config.toml`:
```toml
theme = "zola-pickles"
```
The theme requires putting 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"
insert_anchor_links = "right"
+++
```
## Reference guides
## Configuration Options
2020-04-15 16:53:46 +00:00
```toml
[extra]
# A line to display underneath the main title
subtitle = "Example subtitle"
# Text to display in the footer of the page
copyright = "Copyright authors year"
# Your Google Analytics ID
analytics = ""
# See below
katex_enable = false
# See below
instantpage_enable = false
2020-04-15 16:53:46 +00:00
```
A full example configuration is included in config.toml.
Note how pickles also expects `title` and `description` to also be set in the
Zola configuration.
2020-04-15 16:53:46 +00:00
### KaTeX math formula support
This theme contains math formula support using [KaTeX](https://katex.org/),
which can be enabled by setting `katex_enable = true` in the `extra` section
of `config.toml`.
After enabling this extension, the `katex` short code can be used in documents:
* `{%/* katex(block=true) */%}\KaTeX{%/* end */%}` to typeset a block of math formulas,
similar to `$$...$$` in LaTeX
### Figure Shortcode
This them also includes a figure shortcode for convenience in captioning figures.
```
{%/* figure(link="https://www.example.com/", src="https://www.example.com/img.jpeg", alt="sample alt text") */%}
Your caption here.
{%/* end */%}
```
### Fontawesome
This theme includes fontawesome, so that fontawesome icons can be directly used.
### Instant.page
The theme contains instant.page prefetching. This can be enabled by setting
`instantpage_enable = true` in the `extra` section of `config.toml`.
## Showing article summaries
By default, the theme will use the first 280 characters of your post as a
summary, if a proper [page
summary](https://www.getzola.org/documentation/content/page/#summary) using
`<!-- more -->` is not provided. For more sensible summaries, we recommend using
the manual more indicator.
2020-04-15 16:53:46 +00:00