DevLab Theme v1.2
Language catalogs, translation status notices, and a steadier layout when pages load.
On this page
DevLab v1.2 makes multilingual sites easier to maintain. It adds language catalog files and translation status notices, and keeps the navigation steady while pages load. The minimum Zola version remains 0.23.6.
Localize a site
- Put interface labels in
data/i18n/<lang>.toml. The same catalog can supply labels for the site brand, navigation, footer, announcement, collections, downloads and taxonomies. Regional languages still inherit missing labels from their base language and English. - Breadcrumbs, navigation and links in components such as cards follow the page language. Navigation links to untranslated pages can be hidden or configured to open the default-language page.
- Mark a translation as outdated in
data/i18n/status.tomlor in the page's front matter. The notice links to the original and can link to a translation editor throughtranslate_url.
See the language reference for catalog and status file examples.
Navigation and page layout
- On narrow screens, the compact menu is in place from the first frame. It opens through the browser's native popover and its links work with JavaScript disabled.
- Documentation starts with the current branch open. Readers can expand other branches without JavaScript. With JavaScript, the theme remembers which branches they opened.
- The active desktop navigation link keeps its width. The landing page reserves space for supported local hero images before they load.
Upgrade an existing site
Follow the installation guide to pin
the theme to v1.2 and rebuild. Existing translation tables in zola.toml
still work. If you override the menu or documentation sidebar templates or
styles, review those overrides for the new popover and disclosure markup.