Usage guide

#Features

Halve-Z is a retro two-column theme for Zola. It features search, taxonomies, automatic color schemes, media shortcodes, project cards, and a comment system (Cactus/Giscus).

#Front matter

Available (extra) options:

• subtitle
• image
• csp_img
• disable_comments
• disable_toc
• music

h1 headers are reserved for page title (left/top block) and subtitle (optional, right/bottom block).

In addition to default variables, a page can have an image, a subtitle, a category, a song, CSP strings, and multiple tags.

+++
title = "Example"
date = 2009-09-09
[taxonomies]
categories = ["general"]
tags = ["tag"]
[extra]
subtitle = "Example subtitle"
disable_comments = true
disable_toc = true
image = "https://example.com/image.png"
csp_img = ["example.com/", "foo.org/example"]
music = ["Michael Pitt", "Death to Birth"]
+++

music variable takes an array that includes an artist and a track name. If LASTFM_KEY environment variable is present, names are autocorrected and linked to the Last.fm website.

#Configuration

Set theme to halve-z in your project's config.toml and adjust options according to the example below:

###
base_url = "desolationrow.band"
title = "Desolation Row"
description = "Alternative metal band from Athens, Greece"
default_language = "en"
author = "huskee"
theme = "halve-z"

compile_sass = true
minify_html = true
generate_feeds = true
build_search_index = true
generate_sitemap = true

taxonomies = [
    { name = "categories", feed = true },
    { name = "tags", feed = true },
]

[search]
include_title = true
include_description = true
include_path = false
include_content = true
index_format = "elasticlunr_json"

[markdown]
render_emoji = false
external_links_target_blank = true

[slugify]
paths = "safe"
taxonomies = "safe"
anchors = "safe"

[extra]
locale = "en_US"
logo = "icon-192x192.png"
manifest = "manifest.json"
read_time = true
toc = true
csp = true

[extra.placeholders]
tags = false
subtitle = false

[extra.home]
title = "Desolation Row"
subtitle = "Alternative metal band from Athens, Greece"
glitch = false
logo = { enabled = false, height = "100", width = "100" }
footer = true

[extra.images]
home = "highres-1.png" #https://failsafe.monster/c1tyh4ll.png
post_list = "bk-prk.png" #https://failsafe.monster/bk-prk.jpg
default_post = "bk-prk.png" #https://failsafe.monster/bk-prk.jpg


[extra.menu]
links = [
    { name = "Bio", url = "/about/" },
    { name = "Releases", url = "/releases/" },
    { name = "Merch", url = "https://desolation-row.bandcamp.com/merch" },
]
posts = true
posts_label = "News"

[extra.footer]
enabled = true
author = true
copyright = true
hash = true
stack = true
links = [
    { name = "contact us", url = "/contact/" },
]

[extra.social]
youtube = "UCKcbNZqPT5XJqGu3DZw0Nrw"
spotify = "https://open.spotify.com/artist/6OMrodF0aG0g8Nj32sCZpj"
applemusic = "https://music.apple.com/us/artist/desolation-row/1707678367"
bandcamp = "https://desolation-row.bandcamp.com"
facebook = "desolationn.roww"
instagram = "desolationrow._"
tiktok = "desolationrow._"

[extra.comments]
system = "none"

[extra.comments.cactus]
site = "site_name"
page_size = 10
guest_posting = true
update_interval = 0

[extra.comments.giscus]
repo = "user_name/repo"
repo_id = ""
category = "Comments"
category_id = ""
mapping = "pathname"
strict = "1"
reactions = "1"
lang = "en"