Skip to content

Customization

Configure the site brand, navigation, layout, search, languages, versions, print output, and agent output.

Use this section to configure site parameters in hugo.yml, data files under data/, and style entry points under assets/. To write individual pages and their front matter, see Authoring.

Find it by what you want to change

What you want to change Page
Site name, logo, favicon Brand and appearance
Colors, light and dark mode, fonts Brand and appearance
The navbar menu and its dropdowns Navigation and menus
Sidebar width, icon density, outline depth Layouts and page types
The home page and landing pages Home and landing pages
Full-text search and its index scope Search
What appears in the command palette Command palette
Keyboard shortcuts Keyboard navigation
Adding a language Languages
Multi-version sites and the archive banner Versions
Tags and categories Taxonomies
Edit this page, last modified, contributors Repository links and page info
Print and whole-chapter export Print
llms.txt and the per-page .md output AI-agent support
A parameter’s type and default Configuration

Comments, analytics, and deployment require an external service. See Operations.

Find every site parameter that the theme reads, with its type, default, description, and related guide.

Change the site name, logo, favicon, accent color, light and dark palettes, and fonts. Use configuration and two SCSS entry points.

Build a home page from one local YAML file. Add hero, cards, capability panels, timeline, pricing, case studies, and downloads. Reuse these sections on landing pages.

Configure the navbar menu, dropdowns, section switcher, breadcrumbs, page actions, pager, and footer links.

Select the page shell with type. Set sidebar width and icons, outline depth, section index style, and page width.

Enable local search. Control index size and result ranking, and configure useful CJK query matches.

Use one dialog for page search, page actions, and site commands. Open the palette, use its groups, and add custom commands.

Use single-key shortcuts and understand when typing disables them. Disable shortcuts for the site or individual pages.

Add a language and keep translations beside their originals. Configure menus and interface strings per language. Use matching heading anchors across languages.

Configure the version switcher and archive banner, and select a deployment layout for multiple documentation versions.

Use tags and categories to index pages across directories, with automatic term pages, term cards, rail clouds, and navbar panels.

Connect “edit this page”, “open an issue”, and “view history” to your repository. Show last-modified information, contributors, and feedback at the page end.

Print one page with the browser’s Cmd/Ctrl+P. Use the print output format to combine a section into one continuous document.

Publish a .md version of each page and an llms.txt site index. Let readers open the current page in ChatGPT or Claude.