zola/docs/content/themes/hallo/index.md
Vincent Prouillet 14ccd898ba
Update themes gallery (#1737)
Co-authored-by: GitHub Action <action@github.com>
2022-01-18 10:56:30 +01:00

3 KiB

+++ title = "hallo" description = "A single-page theme to introduce yourself." template = "theme.html" date = 2022-01-17T03:13:30+08:00

[extra] created = 2022-01-17T03:13:30+08:00 updated = 2022-01-17T03:13:30+08:00 repository = "https://github.com/flyingP0tat0/zola-hallo.git" homepage = "https://github.com/janbaudisch/zola-hallo" minimum_version = "0.4.0" license = "MIT" demo = "https://zola-hallo.janbaudisch.dev"

[extra.author] name = "Jan Baudisch" homepage = "https://janbaudisch.dev" +++

Build Status Demo

Hallo

A single-page theme to introduce yourself.

Zola port of hallo-hugo.

Screenshot

Original

This is a port of the original hallo-hugo theme for Hugo (License).

Installation

The easiest way to install this theme is to either clone it ...

git clone https://github.com/janbaudisch/zola-hallo.git themes/hallo

... or to use it as a submodule.

git submodule add https://github.com/janbaudisch/zola-hallo.git themes/hallo

Either way, you will have to enable the theme in your config.toml.

theme = "hallo"

Introduction

The introduction text is included from templates/partials/introduction.html.

You will need to create this file and fill it with content.

Options

See config.toml for an example configuration.

Author

The given name will be used for the 'I am ...' text.

Default: Hallo

[extra.author]
name = "Hallo"

Greeting

The string will be used as a greeting.

Default: Hello!

[extra]
greeting = "Hello!"

iam

This variable defines the I am text, which you may want to swap out for another language.

Default: I am

[extra]
iam = "I am"

Links show up below the introduction. They are styled with Font Awesome, you may optionally choose the iconset (default is brands).

[extra]
links = [
    { title = "E-Mail", url = "mailto:mail@example.org", iconset = "fas", icon = "envelope" },
    { title = "GitHub", url = "https://github.com", icon = "github" },
    { title = "Twitter", url = "https://twitter.com", icon = "twitter" }
]

Theme

Change the colors used.

[extra.theme]
background = "#6FCDBD"
foreground = "#FFF" # text and portrait border
hover = "#333" # link hover