TOC-only mode
A demo of mode toc-only — the left nav is hidden so you can focus on one document, while the right-hand TOC stays for quick jumps.
This page uses mode: toc-only. The left nav is hidden so this single
document owns the screen — but the right-hand “On this page” list stays. With
the nav gone, the content column widens to fill the freed space. Scroll down and
watch the TOC highlight the section you’re in; click any entry to jump.
This page uses mode: toc-only. The left nav is hidden so this single
document owns the screen — but the right-hand “On this page” list stays. With
the nav gone, the content column widens to fill the freed space. Scroll down and
watch the TOC highlight the section you’re in; click any entry to jump.
toc-only fits a long, standalone reference — a configuration spec, an FAQ, a
glossary, a policy — where the global nav is a distraction but moving within the
page is essential. The headings below give the TOC plenty to work with.
Installation
Install the vark binary, scaffold a project with vark new, and run vark build.
The output is a folder of static HTML you can host anywhere.
Configuration
Every project has one config file at its root. It defines the site metadata, the horizontal tabs, the theme, and any integrations.
Site metadata
Name, description, and summary feed the page title, meta tags, and the generated
llms.txt.
Navigation
The config declares the horizontal tabs; each page joins a tab’s left sidebar from
its own front matter (menu:, parent:, weight:). That sidebar is what a page
like this one hides.
Theme
Fonts and logos live in the config; colors live in the theme’s theme.scss, where
the brand primary seeds both the chrome and the Mantine island palette, so the two
stay in sync.
Content authoring
Pages are Markdown with optional front matter. Logic, when you need it, is real Python inside template tags.
Front matter
Title, description, keywords — and mode, which is how this page hid its nav.
Data files
Drop JSON, YAML, or CSV into the data directory and reference it by name from any page.
Components
Embed any Mantine component as an interactive island. Author once in Markdown; it mounts as React in the browser.
Internationalization
Author a base language at the root and translations under their own directories. A language picker appears automatically.
Search
Built in — a ⌘K search box scores a full-text index generated at build time, with no external service to configure.
Deployment
Build in CI and upload the output folder to any static host. Set the base URL so
the sitemap and llms.txt use absolute links.
Wrapping up
That’s eight sections and five subsections — enough that jumping around with the TOC genuinely beats scrolling. On a screen 1100px wide or narrower the TOC hides site-wide, so this page falls back to a plain single column.