Front Matter

How to config theme using front matter 🎒

Published on 2019 Mar, updated on 2023 Jul.

Built under Theme .
Table of Contents

🔥 read the update wiki on the GitHub wiki section

Global Config

Besides to Hugo Global config there are some more variables that can be used in config.toml.

Site Params


# Optional Footer
copyright = 'Name'

[params]

# True if the header must appear also in the homepage (default = True)
showHeaderOnHomepage = true

# Google Analytics G-Tag (optional)
googleAnalytics = "G-XX00000"

# True if you want to use Twemoji (optional)
twemoji = true

# Optional text for 404 text.
text404 = "Some text"

# Font Awesome 6 id. Optional, FA4 will be used without any ID provided.
fontawesomekitcode = "123456789"

Social links can be added in the homepage by writing them directly on config.toml

[[params.social]]
name = "email"
icon = "fa fa-envelope" # name of FA icon
url = "https://t.me/example" 
before = "and on " # text before the icon
after = "." # text after the icon

The header menu is also configurable:

[Menu]
[[Menu.Main]]
name = "Projects."
url = "/projects/"
weight = 1

Page config

+++
# the title that appears on the single page
title = "example title"

# optional = if provided appears on the home page instead of the title
description = "this is and example description longer that the title."


date = 2021-03-17T22:00:00Z
slug = "website-page-cool"

# optional = to display toc on bigger screens (toc on smartphones isn't supported yet)
toc = true
+++

Taxonomy

E.g. = you want use the categories and tags taxonomies.

In the config file:

[taxonomies]
	tag = "tags"
	category = "categories"

In each article:

categories = ["cat1"]
tags = ["tag1", "..."]