Configuration

Thu, 01 Jan 2026 00:00:00 +0000

All letsblaze configuration lives in hugo.toml. Below is a complete reference for every supported parameter.

Top-level settings

Key	Recommended value	Notes
`languageCode`	`en-US`	Use BCP 47 format with uppercase region subtag
`enableEmoji`	`true`	Enables `:shortcode:` emoji syntax in content
`enableGitInfo`	`true`	Sets `lastmod` in sitemap from git commit dates
`disableHugoGeneratorInject`	`false`	letsblaze keeps the Hugo generator tag intentionally

Pagination

[pagination]
 pagerSize = 10

Markup

[markup.goldmark.renderer]
 unsafe = true # required for shortcodes like <kbd>, <del>, <mark>

[markup.highlight]
 noClasses = true # required — letsblaze has no external CSS
 style = "monochrome"

Theme params

[params]
 author = "Your Name"
 copyright = "Your Name" # falls back to site title if not set
 description = "Site description" # used in meta tags and homepage
 dateFormat = "2006-01-02" # Go reference time format
 homepagePostCount = 5 # recent posts shown on homepage
 showThemeCredit = true # set false to hide "Theme: letsblaze" in footer
 # ogImage = "/og-image.png" # path to default OG image in static/

Menus

Navigation items are defined in hugo.toml:

Installation

Thu, 01 Jan 2026 00:00:00 +0000

letsblaze requires Hugo 0.134.0 or later. Run hugo version to check.

Option 1 — Git submodule (recommended)

cd your-hugo-site
git submodule add https://github.com/thomaslaurenson/letsblaze themes/letsblaze

In hugo.toml:

theme = "letsblaze"

To update the theme later:

git submodule update --remote --merge

Option 2 — Hugo module

Initialise your site as a Hugo module if you haven’t already:

hugo mod init github.com/YOUR-USERNAME/YOUR-SITE