Theme Configuration

Mon, 20 Jan 2025 00:00:00 +0000

This post covers all configuration options available in the Mono theme. For a getting started guide, see Getting Started with Mono.

Theme Configuration

Theme-wide settings are specified in hugo.toml. This file controls the overall behavior and appearance of Mono.

Site Parameters

The [params] section defines site metadata, features, and appearance:

toml
[params]
 author = "Your Name"
 description = "Site description for SEO"

 # Features
 showToC = true # Site-wide Table of Contents (override per-page)
 show_updated = true # Show visible "Updated" line when lastmod differs from date
 dateFormat = "Jan 2, 2006" # Go reference layout applied to post dates

 # Home page
 homePostCount = 3 # Number of recent posts on the home page
 homeProjectCount = 3 # Number of projects on the home page

 # SEO
 favicon = "images/favicon.svg"
 og_image = "images/og.png" # Default Open Graph image (override per-page)

 # Math (KaTeX only). Leave off to opt in per-page via `math: true` front matter.
 katex = false

 # Search
 enableSearch = true # Show header search icon and build /search/

 # Custom assets
 customCSS = ["css/custom.css"]
 customJS = ["js/custom.js"]

Parameter	Description
`author`	Displayed in footer and meta tags. Can be overridden per-page via front matter.
`description`	SEO meta description fallback when pages don’t specify one
`favicon`	Path relative to `static/` folder
`og_image`	Default social sharing image. Can be overridden per-page via front matter.
`homePostCount` / `homeProjectCount`	Number of items shown on the home page (default 3)
`customCSS`	CSS files in `assets/css/` (processed by Hugo)
`customJS`	JS files in `static/js/` (served as-is)

Language

Mono includes translations for UI elements in five languages. Set the default language at the top level of hugo.toml:

Customization on Mono

Theme Configuration

Theme Configuration

Site Parameters

Language