+++ title = "halve-z" description = "Retro two-column theme" template = "theme.html" date = 2026-02-19T18:51:13-05:00

[taxonomies] theme-tags = []

[extra] created = 2026-02-19T18:51:13-05:00 updated = 2026-02-19T18:51:13-05:00 repository = "https://github.com/charlesrocket/halve-z.git" homepage = "https://github.com/charlesrocket/halvez" minimum_version = "0.21.0" license = "MIT" demo = "https://halve-z.netlify.app/"

[extra.author] name = "-k" homepage = "https://failsafe.monster/" +++

halve-z

A two-column theme for Zola.

Features

This is a retro port of Halve (Jekyll). It features:

• search
• taxonomies
• PWA (dynamic cache/offline mode)
• notifications
• auto color schemes
• ToC
• pagination
• media shortcodes
• SEO
• CSP
• project cards
• comments (Mastodon/Cactus/Giscus)
• read time

Installation

Add theme submodule using git:

git submodule add https://github.com/charlesrocket/halve-z themes/halve-z

Updates

Use the following command to update theme to the latest version:

git submodule update --recursive --remote

Configuration

1. Copy theme's config.toml into your project's root directory. Set variables as required and add theme = "halve-z" at the top of the config file.
2. Copy the content to get started:

cp -R -f themes/halve-z/content/ content/

Usage

See demo posts.