mirror of https://github.com/getzola/zola synced 2025-01-10 02:48:45 +00:00

Vincent Prouillet 90bddf0ef5

Co-authored-by: GitHub Action <action@github.com>

2022-02-10 10:09:25 +01:00

2.4 KiB

Raw Blame History

+++ title = "Hook" description = "Clean and simple personal site/blog theme" template = "theme.html" date = 2022-02-09T00:41:54+05:30

[extra] created = 2022-02-09T00:41:54+05:30 updated = 2022-02-09T00:41:54+05:30 repository = "https://github.com/InputUsername/zola-hook.git" homepage = "https://github.com/InputUsername/zola-hook" minimum_version = "0.15.2" license = "MIT" demo = "https://inputusername.github.io/zola-hook/"

[extra.author] name = "Koen Bolhuis" homepage = "https://koen.bolhu.is" +++

Hook

A clean and simple personal site/blog theme for Zola.

Demo

Setup

Clone this repo into your themes folder:

cd themes
git clone https://github.com/InputUsername/zola-hook.git hook

Then, enable it in your config.toml:

theme = "hook"

Features

The following templates are built-in:

index.html - the homepage;
page.html - pages and posts (extends index.html);
section.html - archive of pages in a section, mostly for a blog (extends page.html);
404.html - 404 page (extends page.html).

Templates have the following Tera blocks:

title - to override the default <title> (config.title);
extra_head - to override styles and anything else in <head>;
header - to change the header (best to put this in a <header>);
content - to change the content (best to put this in a <main>).

You can define links to include in the header on the homepage in config.toml:

[extra]

links = [
    { title = "Link display text", href = "http://example.com" },
    # ...
]

Pages in the root section can define extra.in_header = true to be included in the header links on the homepage.

The content in the root _index.md is included in the homepage if present.

Below that is a list of the 20 most recent posts. For this, the blog/_index.md section is expected to exist (will error if it doesn't exist). There is also a link to an archive of all blog posts by year.

Hook supports light/dark mode based on the user's preference. There is also a manual toggle button (requires JavaScript).