DevLabA modern Zola theme for developers, documentation and technical blogs.Zola2026-06-30T00:00:00+00:00https://ripetitor.codeberg.page/devlab-theme/atom.xmlDevLab Theme v0.1.02026-06-30T00:00:00+00:002026-06-30T00:00:00+00:00
Unknown
https://ripetitor.codeberg.page/devlab-theme/blog/devlab-theme-v0-1-0/<p>DevLab Theme <code>v0.1.0</code> is the first public preview release of a developer-focused Zola theme for documentation sites, technical blogs and project pages.</p>
<h2 id="highlights">Highlights</h2>
<ul>
<li>Documentation layout with sidebar, table of contents, breadcrumbs and previous/next navigation</li>
<li>Blog layout</li>
<li>Client-side search</li>
<li>Light, dark and system color modes</li>
<li>SEO metadata</li>
<li>Atom feed autodiscovery</li>
<li>SVG favicon</li>
<li>Custom 404 page</li>
<li>Configurable homepage</li>
<li>Callout and card shortcodes</li>
<li>Code block headers with copy buttons</li>
<li>Mobile navigation</li>
<li>Optional docs and blog sections for clean external Zola sites</li>
</ul>
<h2 id="requirements">Requirements</h2>
<ul>
<li>Zola <code>0.22.0</code> or newer</li>
</ul>
<h2 id="installation">Installation</h2>
<p>Install the theme as a Git submodule:</p>
<pre class="giallo" style="color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);"><code data-lang="shellscript"><span class="giallo-l"><span style="color: light-dark(#6F42C1, #B392F0);">git</span><span style="color: light-dark(#032F62, #9ECBFF);"> submodule</span><span style="color: light-dark(#032F62, #9ECBFF);"> add</span><span style="color: light-dark(#032F62, #9ECBFF);"> https://codeberg.org/RiPetitor/devlab-theme</span><span style="color: light-dark(#032F62, #9ECBFF);"> themes/devlab-theme</span></span>
<span class="giallo-l"><span style="color: light-dark(#6F42C1, #B392F0);">git</span><span style="color: light-dark(#032F62, #9ECBFF);"> submodule</span><span style="color: light-dark(#032F62, #9ECBFF);"> update</span><span style="color: light-dark(#005CC5, #79B8FF);"> -</span><span style="color: light-dark(#005CC5, #79B8FF);">-init</span><span style="color: light-dark(#005CC5, #79B8FF);"> -</span><span style="color: light-dark(#005CC5, #79B8FF);">-recursive</span></span></code></pre>
<p>Enable it in your Zola config:</p>
<pre class="giallo" style="color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);"><code data-lang="toml"><span class="giallo-l"><span>theme</span><span> =</span><span style="color: light-dark(#032F62, #9ECBFF);"> "</span><span style="color: light-dark(#032F62, #9ECBFF);">devlab-theme</span><span style="color: light-dark(#032F62, #9ECBFF);">"</span></span></code></pre><h2 id="notes">Notes</h2>
<p>This is an early public release. The theme is suitable for testing, personal documentation sites and small technical projects.</p>
<p>Planned future work includes additional shortcodes, tags and taxonomies, Mermaid, KaTeX, multilingual support and CI checks.</p>
DevLab Theme 0.0.1 release candidate2026-06-06T00:00:00+00:002026-06-06T00:00:00+00:00
Unknown
https://ripetitor.codeberg.page/devlab-theme/blog/introducing-devlab-theme/<p>DevLab Theme is a modern Zola theme for developers, documentation sites and technical blogs.</p>
<p>The <code>0.0.1</code> release candidate turns the project from a local demo into a small theme package that can be installed in a separate Zola site.</p>
<div class="callout callout--info">
<p class="callout-title">Release candidate</p>
<p>This version is ready for final validation. Before tagging <code>v0.0.1</code>, the theme should be checked in this repository and installed once in a clean external Zola site.</p>
</div>
<h2 id="what-is-included">What is included</h2>
<p>The release candidate focuses on the workflows a documentation theme needs on day one:</p>
<ul>
<li>documentation layout with desktop sidebar and table of contents</li>
<li>single mobile menu with a documentation panel</li>
<li>grouped and collapsible docs navigation</li>
<li>docs breadcrumbs and previous/next links</li>
<li>client-side search</li>
<li>light and dark color modes</li>
<li>callout and card shortcodes</li>
<li>code block headers with language labels and copy buttons</li>
<li>theme metadata, MIT license and fallback <code>[extra]</code> defaults</li>
</ul>
<h2 id="install-preview">Install preview</h2>
<p>Install the theme under a Zola site's <code>themes/</code> directory:</p>
<pre class="giallo" style="color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);"><code data-lang="shellscript"><span class="giallo-l"><span style="color: light-dark(#6F42C1, #B392F0);">git</span><span style="color: light-dark(#032F62, #9ECBFF);"> clone</span><span style="color: light-dark(#032F62, #9ECBFF);"> https://codeberg.org/RiPetitor/devlab-theme</span><span style="color: light-dark(#032F62, #9ECBFF);"> themes/devlab-theme</span></span></code></pre>
<p>Enable the theme and the optional search index:</p>
<pre class="giallo" style="color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);"><code data-lang="toml"><span class="giallo-l"><span>theme</span><span> =</span><span style="color: light-dark(#032F62, #9ECBFF);"> "</span><span style="color: light-dark(#032F62, #9ECBFF);">devlab-theme</span><span style="color: light-dark(#032F62, #9ECBFF);">"</span></span>
<span class="giallo-l"><span>compile_sass</span><span> =</span><span style="color: light-dark(#005CC5, #79B8FF);"> true</span></span>
<span class="giallo-l"><span>build_search_index</span><span> =</span><span style="color: light-dark(#005CC5, #79B8FF);"> true</span></span></code></pre>
<p>The theme is designed to work without a frontend framework or build tool beyond Zola's built-in Sass and search index support.</p>
<h2 id="validation-before-tagging">Validation before tagging</h2>
<p>The final <code>0.0.1</code> tag should be cut after these checks:</p>
<ul>
<li>run <code>zola check</code></li>
<li>run <code>zola build</code></li>
<li>review light and dark modes</li>
<li>review desktop and mobile documentation navigation</li>
<li>review mobile menu open, close, backdrop click, Escape and link-click states</li>
<li>review search results and empty search state</li>
<li>review code block language labels and Copy button states</li>
<li>install the repository as <code>themes/devlab-theme</code> in a clean external Zola site</li>
</ul>
<h2 id="next-direction">Next direction</h2>
<p>After <code>0.0.1</code>, the theme can move toward more polished documentation ergonomics: richer code block metadata, more content components, better search presentation and a small set of real-world example pages.</p>