mirror of https://github.com/getzola/zola
75 lines
1.8 KiB
Markdown
75 lines
1.8 KiB
Markdown
|
|
+++
|
|
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`
|
|
[](https://app.netlify.com/sites/halve-z/deploys)
|
|
|
|
A two-column theme for **Zola**.
|
|
|
|
|
|
|
|
## Features
|
|
|
|
This is a _retro_ port of [Halve](https://github.com/TaylanTatli/Halve) (**Jekyll**). It features:
|
|
|
|
* search
|
|
* taxonomies
|
|
* PWA (dynamic cache/offline mode)
|
|
* auto color schemes
|
|
* ToC
|
|
* pagination
|
|
* media shortcodes
|
|
* SEO
|
|
* CSP
|
|
* project cards
|
|
* comments ([Cactus](https://gitlab.com/cactus-comments/)/[Giscus](https://github.com/giscus/giscus))
|
|
* read time
|
|
|
|
## Installation
|
|
|
|
Add theme submodule using `git`:
|
|
|
|
```sh
|
|
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](https://github.com/charlesrocket/halve-z/blob/trunk/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](https://halve-z.netlify.app/posts/).
|
|
|
|
|