DevLab - ripetitor

DevLab Theme v0.8.0

2026-09-19T00:00:00+00:00

DevLab Theme v0.8.0 is about composition. Authors can build landing sections and plans from reusable Markdown blocks, readers get a table of contents on long posts, and code examples can name the file they belong to. The release also settles the theme's own layout so sites stop patching it in Sass.

This release raises the minimum Zola version to 0.23.6 and explicitly escapes plain-text component fields when invoked from Markdown. Review overrides that put HTML in titles, labels or profile text: those fields now display it literally. Markdown bodies remain supported. Blog tables of contents are enabled by default; the theme still builds with Zola alone.

Card grids

devlab.cards arranges devlab.card children in a responsive grid. A card can link somewhere, carry an icon and a status tag, and hold Markdown:

Install

Pin a release tag and enable the theme in zola.toml.

Content components

Recipes for card grids, timelines and overview icons.

External

Codeberg

Source code, issues and release tags.

A linked card adds a trailing arrow, an absolute HTTP(S) destination switches it to the external-link marker, and a static card omits the arrow entirely. Docs overview cards gained the same icon slot through an optional [extra] icon in section or page front matter, so a documentation landing page no longer needs hand-written markup.

Status timelines

devlab.timeline presents a plan as ordered stages. Each stage declares a status and can add a date and a custom label:

Done2026-08
Bring-up
UART, bootloader, kernel, Device Tree and internal storage.
In progress2026-09
Hardware validation
Network, USB, wireless, display, audio and sensors.
PlannedQ4 2026
Preview
Test image with known limitations and pinned component versions.
Release
Supported
Regression matrix on a release candidate before the stable release.

Supported statuses are done, active, planned and blocked; an unknown value falls back to planned. The state is carried by the badge text as well as the marker colour, so a plan still reads without colour.

Blog tables of contents

Long posts now render a table of contents. On wide screens the article stays centered and the scrollable table of contents sits at the viewport edge. Below that width it collapses into a disclosure above the body. Both versions highlight the current section as the reader scrolls.

The Blog also uses a wider canvas than before, which puts that space to work without stretching the reading measure. Set devlab.blog.show_toc = false to publish posts without a table of contents; posts with fewer than two headings stay unchanged.

Code blocks that name their file

Zola already carries the name annotation of a fenced block into the rendered HTML. DevLab now shows it as the block title and demotes the language to a supporting chip:

1make -j"$(nproc)"

The toolbar reads the caption from Zola's data-name attribute and keeps it outside the copied source. The toolbar also prints readable language labels, which turns Zola's internal syntax names into Shell, Text and similar.

Syntax colors now follow the code block's own --color-pre-scheme token. A site can use dark code blocks on a light page without getting light-theme syntax colors on the dark background. Set this token alongside --color-pre-bg and --color-pre-fg in custom palettes.

Nested Docs navigation, breadcrumbs and previous/next links now preserve the current language. Blog author links use Zola's taxonomy URLs, including author names with spaces. Feed discovery follows feed_filenames, and author feed links use the first configured file with an accessible, configurable label.

Footer links used to collapse to an icon whenever one was configured. devlab.footer.show_link_names = true renders every link as its icon plus the visible name and shows the configured group label as a heading. The compact footer in the Docs sidebar and mobile panel follows the same setting, and icon-only links remain the default.

Content media and narrow tables

Content images had no theme rules at all: an oversized image could leave the column. Images are now constrained to the content width, figure images and captions are styled, and table cells tighten on narrow screens next to the existing horizontal scroll. The theme also ships a visually-hidden utility.

A quieter default

The release also removes rough edges that consumer sites were working around in their own Sass:

A callout keeps the author's title casing instead of capitalizing every word, and an unknown type falls back to info with a readable label.
Docs pages without headings no longer reserve an empty table of contents column.
Docs overview cards use the full content column instead of stopping at a fixed width, and step lists keep their spacing against the following block.
Blog article titles no longer break at a narrow character limit.

If your site patched any of these, the override can go.

Previously on the development branch

Three features that were available only on main now ship in a tagged release: the dismissible announcement banner, reusable community cards and Blog author profiles. Sites that waited for a tag can adopt them without tracking the development branch.

Upgrading from v0.7.0

Update the pinned theme tag to v0.8.0 using Install and update after the tag is published.
Upgrade Zola to 0.23.6 or newer. Review component overrides: titles, labels and profile text are plain text, while component bodies can still contain Markdown.
Posts with at least two headings now render a table of contents. Set devlab.blog.show_toc = false to opt out.
Review footer links. Icon-only links are unchanged; enable show_link_names only when the labels should be visible.
Add name= to fenced blocks whose file or path matters at a glance. Existing blocks render as before.
Remove site-owned Sass that duplicates content images, figure captions, narrow tables, callout casing, the Docs table of contents or Blog title width.
Run zola check and zola build, then inspect the new components at a narrow viewport and with a keyboard.

The complete component contracts live in Tera components, the new recipes in Content components, and every setting in the configuration reference.

Compatibility

DevLab Theme v0.8.0 requires Zola 0.23.6 or newer. Theme consumers still build with Zola alone: Node.js and npm are not runtime or site-build requirements, and the bundled diagram renderer does not depend on a remote service.

DevLab Theme v0.7.0

2026-09-01T00:00:00+00:00

DevLab Theme v0.7.0 focuses on the daily work around technical content. Maintainers can connect a Docs page to its source, writers gain reusable structures for commands and architecture, and readers get clearer code examples without adding a frontend build step to the site.

The new features are additive. Existing v0.6.0 content continues to render, page provenance remains opt-in and pages that do not use diagrams do not download the diagram renderer.

Documentation connected to its source

Docs pages can now show an authored update date, copy their current URL and link directly to contribution or issue workflows:

[extra.devlab.docs.page_actions]
show_last_updated = true
show_copy_link = true
edit_url = "https://codeberg.org/acme/project/_edit/main/content/"
report_url = "https://codeberg.org/acme/project/issues/new"
date_format = "%Y-%m-%d"

The update date is rendered only when a page defines Zola's native updated field. DevLab does not substitute a build timestamp or publication date. The edit link appends the real source-relative path, while the icon-only Copy link control preserves an active heading fragment when the Clipboard API is available. Editing lives beside the table of contents on wide screens, and the feedback destination closes the article as a dedicated discussion card.

Every action can be enabled independently. Omitting the complete table keeps the previous page footer unchanged.

Commands that keep their context

Tabs now support an optional synchronization key. Groups sharing the key remember the selected value and update together, which is useful when one guide repeats operating-system, package-manager or deployment choices.

Unix

zola serve

Windows

zola.exe serve

Without JavaScript, every panel remains readable. With enhancement enabled, the control follows the horizontal tabs keyboard pattern, mirrors arrow behavior in RTL layouts and stores only the selected value.

Project structure without hand-drawn connectors

The new file-tree components replace fragile ASCII layouts with semantic folders and files. Folders use the browser's native disclosure control and remain collapsible without JavaScript.

Release workspace

devlab-theme
- theme.tomlRelease metadata
- content
  - docsProduct documentation
  - blogRelease notes
- THIRD_PARTY_NOTICES.mdVendored dependency notices

Compact badges complement the tree when a status belongs inside a sentence: Release Stable API Beta Migration Not required.

Badge text carries the meaning independently of color, and folder or file names use automatic text direction for mixed-language documentation.

Architecture as authored content

devlab.diagram turns a compact Mermaid-compatible source into a responsive SVG that follows the active DevLab palette:

Release authoring flowSource content becomes checked documentation and then a tagged release.

The self-contained renderer is bundled with the theme and makes no font or CDN request. Its cost is isolated to pages that contain a diagram: approximately 1.6 MB minified or 495 KB gzip. The component provides a visible caption, an accessible description and a source fallback when rendering is unavailable.

Flowcharts, state, sequence, class, ER and XY diagrams are supported. Diagram input should remain trusted, repository-authored content rather than visitor input.

Code blocks with a deliberate hierarchy

Fenced code now renders as a composed panel with a language toolbar, an icon-only Copy control, clearer line numbers and a visible highlighted-line treatment. Copy feedback changes the icon while retaining localized accessible labels and a polite live announcement.

1fn release(version: &str) {
2    check_site();
3    publish_tag(version);
4}

Long lines scroll inside the panel instead of widening the page. Only blocks that actually overflow enter the keyboard tab order, and copied text continues to exclude visual line numbers.

Upgrading from v0.6.0

Update the pinned theme tag to v0.7.0 using Install and update after the tag is published.
Keep Zola 0.23.4; this release does not change the current Zola target.
Add devlab.docs.page_actions only when the site has real source and feedback destinations.
Replace hand-written command switches, file trees or architecture drawings gradually; existing Markdown does not require conversion.
Review site-owned Sass overrides that target code blocks, Docs page footers or component internals.
Account for the diagram payload before adding diagrams to frequently visited pages.
Run zola check and zola build, then inspect interactive components with a keyboard and at a narrow viewport.

The complete syntax and parameter contracts live in Tera components, while page actions are documented in the configuration reference.

Compatibility

DevLab Theme v0.7.0 targets Zola 0.23.4. Theme consumers still build with Zola alone: Node.js and npm are not runtime or site-build requirements, and the checked-in diagram renderer does not depend on a remote service.

DevLab - ripetitor

DevLab Theme v0.8.0

Card grids

Install

Content components

Codeberg

Status timelines

Bring-up

Hardware validation

Preview

Supported

Blog tables of contents

Code blocks that name their file

Navigation and feed fixes

Footer links with names

Content media and narrow tables

A quieter default

Previously on the development branch

Upgrading from v0.7.0

Compatibility

DevLab Theme v0.7.0

Documentation connected to its source

Commands that keep their context

Project structure without hand-drawn connectors

Architecture as authored content

Code blocks with a deliberate hierarchy

Upgrading from v0.6.0

Compatibility

DevLab - ripetitor

DevLab Theme v0.8.0

Card grids

Install→

Content components→

Codeberg

Status timelines

Bring-up

Hardware validation

Preview

Supported

Blog tables of contents

Code blocks that name their file

Navigation and feed fixes

Footer links with names

Content media and narrow tables

A quieter default

Previously on the development branch

Upgrading from v0.7.0

Compatibility

DevLab Theme v0.7.0

Documentation connected to its source

Commands that keep their context

Project structure without hand-drawn connectors

Architecture as authored content

Code blocks with a deliberate hierarchy

Upgrading from v0.6.0

Compatibility

Install

Content components