Zola PaperMod

A work in progress port of the hugo-PaperMod theme by @adityatelange to Zola

Due to config changes introduced with Zola 0.19, only Zola 0.19.1 and later are currently supported.

Demo @ https://cydave.github.io/zola-theme-papermod/

Features

• Blog post archive
• Blog post RSS feeds
• Tags
• Tag-based RSS feeds
• Optional: Custom taxonomies
• Light / Dark theme switching (with configurable default preference)
• Syntax highlighting for code snippets (Zola's built-in syntax highlighting)
• Custom navigation
• 3 Modes:
  • Regular Mode
  • Home-Info Mode
  • Profile Mode
• Code copy buttons
• Search page
• SEO Metadata
• Language switcher (multi-language support)

Installation

1. Download the Theme

git submodule add https://github.com/cydave/zola-theme-papermod themes/papermod

2. Add theme = "papermod" to your zola config.toml
3. Copy over the example content to get started

cp -r themes/papermod/content content

Options

Papermod customizations exist under a designated extra.papermod section. Refer to config.toml for available options.

Contributing

If you would like to help out porting hugo-Papermod to Zola feel free to pick up a feature and start working on it. All help, no matter how small the contribution is highly appreciated.

NixOS

This repo uses Zola 0.19.2 to deploy via github pages. On NixOS you need to build Zola 0.19.2 with an older GCC in a nix shell:

nix shell \
  nixpkgs#rustc \
  nixpkgs#cargo \
  nixpkgs#pkg-config \
  nixpkgs#openssl \
  nixpkgs#libsass \
  nixpkgs#gcc13 \
  -c bash

Inside that shell build Zola 0.19.2:

export CC=gcc
export CXX=g++
cargo install --locked \
  --git https://github.com/getzola/zola \
  --tag v0.19.2 \
  --root ~/.local \
  --force

Verify the build worked with ~/.local/bin/zola --version. Run the hashpool website with ~/.local/bin/zola serve.