Configuring Book
Options live in theme.yaml's config_schema and are stored under the
book key in data/theme-config.json (editable from the admin Theme
Settings tab). Names match upstream's Book* params where Dune allows it.
Site options
| Key | Type | Default | Upstream | What it does |
|---|---|---|---|---|
book_theme |
select | auto |
BookTheme |
auto / light / dark — compiled as data-book-theme on <html> (upstream bakes one mixin into CSS at build time; this port ships all three) |
book_search |
toggle | true |
BookSearch |
Live search box at the top of the sidebar (/ or ⌘/Ctrl+K to focus) |
book_toc |
toggle | true |
BookToC |
Right-hand table of contents from h2–h4 |
book_logo |
text | (empty) | BookLogo |
Optional logo image URL next to the site title |
book_section |
text | docs |
BookSection |
Sidebar root section route; * for all top-level sections |
language_labels |
select | code |
— | code or native name via Intl.DisplayNames |
copyright |
text | (empty) | Copyright / site copyright |
Centred line under the page footer |
Example:
{
"book": {
"book_theme": "auto",
"book_search": true,
"book_toc": true,
"book_section": "*",
"copyright": "© 2026 Acme Docs"
}
}
Per-page frontmatter
| Key | Effect |
|---|---|
bookToC: false |
Hide the right-hand ToC for this page only |
There is no freeform accent colour picker — upstream hugo-book doesn't have one either. For a Dune-native docs theme with curated colour schemes, see Caravan.