zola/docs/content/themes/halve-z/index.md

1.8 KiB

+++ title = "halve-z" description = "Retro two-column theme" template = "theme.html" date = 2024-09-02T05:58:27Z

[extra] created = 2024-09-02T05:58:27Z updated = 2024-09-02T05:58:27Z repository = "https://github.com/charlesrocket/halve-z.git" homepage = "https://github.com/charlesrocket/halvez" minimum_version = "0.18.0" license = "MIT" demo = "https://halve-z.netlify.app/"

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

halve-z

Netlify Status

A two-column theme for Zola.

logo

Features

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

  • search
  • taxonomies
  • PWA (dynamic cache/offline mode)
  • auto color schemes
  • ToC
  • pagination
  • media shortcodes
  • SEO
  • CSP
  • project cards
  • comments (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.