Getting started

Create your first site with DevLab Theme.

DevLab Theme is a small Zola theme for documentation, project pages and technical notes. It can run as a docs site, a blog, or a simple landing page with both sections disabled.

Requirements

  • Zola 0.22.0 or newer
  • Git
  • A text editor

Install the theme

Install DevLab Theme under your site's themes/ directory:

git clone https://codeberg.org/RiPetitor/devlab-theme themes/devlab-theme

Enable the theme in your Zola config:

theme = "devlab-theme"
compile_sass = true
build_search_index = true
generate_feeds = true
feed_filenames = ["atom.xml"]

[markdown]

[markdown.highlighting]
light_theme = "github-light"
dark_theme = "github-dark"

Minimal content structure

For the smallest site, start with a home page:

content/
  _index.md

Add docs only when you want the documentation layout:

content/
  docs/
    _index.md
    getting-started.md

The docs section should use the theme templates:

+++
title = "Documentation"
sort_by = "weight"
template = "docs.html"
page_template = "doc-page.html"
+++

Run locally

Run the development server:

zola serve

Visit http://127.0.0.1:1111 in your browser. The server watches for changes and rebuilds automatically.

Next steps

  • Copy a complete minimal site from the quick start guide.
  • Configure branding and paths in the configuration guide.
  • Configure grouped docs navigation in the navigation guide.
  • Use cards and callouts from the shortcodes guide.
  • Use troubleshooting when a section renders with the wrong layout or missing navigation.