Pickles

Pickles is a clean, responsive blog theme based on the Hugo theme with the same name featuring pagination.

pickles screenshot

Installation

First download this theme to your themes directory:

$ cd themes
$ git clone https://github.com/lukehsiao/zola-pickles.git

and then enable it in your config.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"
+++

Options

[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

KaTeX math formula support

This theme contains math formula support using KaTeX, 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:

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.