Usage guide

#特徴

Halve-Zは、Zola用のレトロな2カラムテーマです。検索、タクソノミー、自動配色、メディアショートコード、プロジェクトカード、コメントシステム（Cactus/Giscus）を備えています。

#フロントマター

利用可能な (extra) オプション:

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

h1ヘッダーは、ページのタイトル（左/上ブロック）とサブタイトル（任意、右/下ブロック）用に予約されています。

デフォルトの変数に加えて、ページには画像、サブタイトル、カテゴリー、曲、CSP文字列、複数のタグを設定できます。

+++
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変数は、アーティスト名とトラック名を含む配列を受け取ります。LASTFM_KEY環境変数が存在する場合、名前は自動修正され、Last.fmのウェブサイトにリンクされます。

#設定

プロジェクトのconfig.tomlでthemeをhalve-zに設定し、以下の例に従ってオプションを調整してください。

###
base_url = "https://geekforce.co.jp"
title = "株式会社ギークフォース"
description = "株式会社ギークフォースは最新技術を駆使した Webシステム開発 を中心に、 React / Vue / TypeScript / Rust / PHP / Python / Ruby など幅広い技術スタックに精通したエンジニアが、 お客様の課題解決と価値創造を力強く支援します。"
default_language = "en"
author = "Geek Force"
theme = "halve-z"

compile_sass = true
minify_html = true
generate_feeds = true
build_search_index = false
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]
unsafe = true
highlight_code = true
highlight_theme = "css"
highlight_themes_css = [
    { theme = "OneHalfDark", filename = "syntax-theme-dark.css" },
    { theme = "OneHalfLight", filename = "syntax-theme-light.css" },
]
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 = "Geek Force"
subtitle = "技術オタクの力で、世界を永遠に変えていく"
glitch = false
logo = { enabled = false, height = "100", width = "100" }
footer = true

[extra.images]
home = "home.webp" #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
categories = [
    { name = "media", image = "https://raw.githubusercontent.com/bearcott/8bit-art/master/cities/urban.gif" },
]

[extra.menu]
posts = false
posts_label = "Posts"
links = [
    { name = "About", url = "/about/" },
    { name = "Services", url = "/services/" },
]

[extra.footer]
enabled = false
author = false
copyright = false
hash = false
stack = false
links = [
    { name = "posts", url = "/posts/" },
]

[extra.social]
email = "user_email"
phone = "+81-3-6758-9166"
# mastodon = "server/@user_name"
# twitter = "user_name"
# facebook = "user_name"
# codeberg = "username"
# github = "user_name"
# gitlab = "user_name"
# bitbucket = "user_name"
# stackoverflow = "12345/user_name"
# linkedin = "user_name"
# instagram = "user_name"
# lastfm = "user_name"
# twitch = "user_name"
# reddit = "user_name"
# flickr = "user_name"
# keybase = "user_name"
# hackernews = "user_name"

[extra.mastodon]
author = "@user@server"

[extra.comments]
system = ""

[extra.comments.mastodon]
username = "user"
server = "server"

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

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

[extra.cursor]
enabled = true
debug = false
server_url = "wss://geekforce.co.jp/ws"