This is a demo announcement, dismissible and configured in site.json.
Switch to latest

hugo.toml

The complete Hugo configuration the theme needs, copy-paste ready.

This is the full hugo.toml for a Bora site. Copy it, change baseURL and the module path style to your setup, and you are done:

hugo.tomltoml 
baseURL = "https://docs.example.com/"
languageCode = "en-us"
title = "My Docs"

disableKinds = ["taxonomy", "term"]   # no tags/categories in a docs site

[markup.highlight]
  noClasses = false
  style     = "github"

# ── Output formats used by the theme ────────────────────────────────


[outputFormats.SearchIndex]       # section-chunked search index
  mediaType      = "application/json"
  baseName       = "searchindex"
  isPlainText    = true
  notAlternative = true

[outputFormats.LLMS]              # llms.txt for AI assistants
  mediaType      = "text/plain"
  baseName       = "llms"
  isPlainText    = true
  notAlternative = true

[mediaTypes."text/markdown"]
  suffixes = ["md"]

[outputFormats.Markdown]          # raw markdown per page (linked from llms.txt)
  mediaType      = "text/markdown"
  baseName       = "index"
  isPlainText    = true
  notAlternative = true

[outputs]
  home = ["HTML", "SearchIndex", "LLMS"]
  page = ["HTML", "Markdown"]

[module]
  [[module.imports]]
    path = "gitlab.com/natitec_public/bora"

What each piece does

Setting Why
markup.highlight.noClasses = false Hugo emits CSS classes so theme-syntax.css can color code per theme
outputFormats.SearchIndex + home output emits /searchindex.json. Without it, search shows “Search is unavailable”
Edit this page