Skip to content

UI & configuration

Change one aspect of the interface and compare the result. These are independent native Zensical builds, all using the same field-guide content. Page-level options are demonstrated separately.

Branding · Footer · Customization · Build behavior

Page-level layout · Site behavior · External services

Plain navigation

The sidebar uses collapsible groups. Open Guides, then return here to compare the expanded version.

Open live plain navigation demo

Screenshot: Plain navigation

Plain navigation: native desktop layout

Settings used in this comparison
features = []

Classic theme

Compare the header, typography, spacing, and code blocks with the modern baseline. The content is identical.

Open live classic theme demo

Screenshot: Classic theme

Classic theme: native desktop layout

Settings used in this comparison
features = []
variant = "classic"

Top-level sections become tabs. Scroll down: the tab bar stays visible. On a narrow screen, use the menu instead.

Open live navigation tabs demo

Screenshot: Navigation tabs

Navigation tabs: native desktop layout

Settings used in this comparison
features = ["navigation.tabs", "navigation.tabs.sticky"]

Top-level groups are visible section labels instead of collapsed containers. Compare this with Plain navigation.

Open live navigation sections demo

Screenshot: Navigation sections

Navigation sections: native desktop layout

Settings used in this comparison
features = ["navigation.sections"]

Expanded navigation

All navigation groups start expanded. This suits short manuals but gets noisy on large sites.

Open live expanded navigation demo

Screenshot: Expanded navigation

Expanded navigation: native desktop layout

Settings used in this comparison
features = ["navigation.expand"]

Pruned navigation

Only the current branch is expanded in the generated navigation. Enter Guides to see its children. This reduces large navigation trees.

Open live pruned navigation demo

Screenshot: Pruned navigation

Pruned navigation: native desktop layout

Settings used in this comparison
features = ["navigation.prune", "navigation.indexes"]

Open Guides → Field notes. Breadcrumbs expose the hierarchy and the footer moves through the reading sequence.

Open live breadcrumbs and section indexes demo

Screenshot: Breadcrumbs and section indexes

Breadcrumbs and section indexes: native desktop layout

Settings used in this comparison
features = ["navigation.path", "navigation.indexes", "navigation.footer"]

Table of contents in navigation

The current page headings appear in the left navigation. Scroll through the page to follow the active section.

Open live table of contents in navigation demo

Screenshot: Table of contents in navigation

Table of contents in navigation: native desktop layout

Settings used in this comparison
features = ["toc.integrate", "toc.follow"]

Instant navigation and previews

Follow an internal link without a full page reload. Hover the preview link for a page preview; scroll upward near the bottom for the back-to-top control.

Open live instant navigation and previews demo

Screenshot: Instant navigation and previews

Instant navigation and previews: native desktop layout

Settings used in this comparison
features = ["navigation.instant", "navigation.instant.prefetch", "navigation.instant.progress", "navigation.instant.preview", "navigation.tracking", "navigation.top"]

Dark color scheme

A fixed dark palette changes surfaces and code colors. Compare the same callout and code block in the light baseline.

Open live dark color scheme demo

Screenshot: Dark color scheme

Dark color scheme: native desktop layout

Settings used in this comparison
features = []
palette = { scheme = "slate", primary = "teal", accent = "amber" }

Primary and accent colors

A teal primary color and orange accent change navigation and interactive emphasis. Hover a link to see the accent.

Open live primary and accent colors demo

Screenshot: Primary and accent colors

Primary and accent colors: native desktop layout

Settings used in this comparison
features = []
palette = { scheme = "default", primary = "teal", accent = "orange" }

Alternative typography

Serif body text gives long prose a different texture; monospace source uses Fira Code. Font loading requires a network connection.

Open live alternative typography demo

Screenshot: Alternative typography

Alternative typography: native desktop layout

Settings used in this comparison
features = []
font = { text = "Lora", code = "Fira Code" }

System fonts

The theme uses locally available system fonts without fetching Google Fonts. Compare text width and code with the typography variant.

Open live system fonts demo

Screenshot: System fonts

System fonts: native desktop layout

Settings used in this comparison
features = []
font = false

Arabic and right-to-left layout

The navigation and interface run right to left. The Arabic sample shows text direction; English examples remain intentionally visible for comparison.

Open live arabic and right-to-left layout demo

Screenshot: Arabic and right-to-left layout

Arabic and right-to-left layout: native desktop layout

Settings used in this comparison
features = []
language = "ar"
direction = "rtl"

Autohiding header

Scroll down until the header leaves view, then scroll upward to reveal it. This creates more reading space.

Open live autohiding header demo

Screenshot: Autohiding header

Autohiding header: native desktop layout

Settings used in this comparison
features = ["header.autohide", "navigation.tabs"]

Page and code actions

Use the source/view links near the title and the copy/select controls in the code block. The repository links point to the shared fixture generator.

Open live page and code actions demo

Screenshot: Page and code actions

Page and code actions: native desktop layout

Settings used in this comparison
features = ["content.action.edit", "content.action.view", "content.code.copy", "content.code.select", "content.code.annotate"]

Search suggestions and highlighting

Search for kestrel. Follow a result to see matching text highlighted. Use the share control to preserve a search query in a URL.

Open live search suggestions and highlighting demo

Screenshot: Search suggestions and highlighting

Search suggestions and highlighting: native desktop layout

Settings used in this comparison
features = ["search.suggest", "search.highlight", "search.share"]

Screenshot comparisons

The screenshot gallery compares actual desktop renders. Expand the screenshot beside any live demo above for its initial view.

Choosing a layout

Use sections for a short manual whose structure should stay visible. Tabs suit several major audiences or product areas. Expanded navigation is useful when the entire tree fits comfortably on screen. Pruning helps large trees; it cannot be combined with expansion. An integrated contents list saves a sidebar but cannot be combined with section indexes.

Official navigation guide · Colors · Fonts · Language