LinuxCommandLibrary

zola

Fast Rust-based static site generator

TLDR

Create a new site

$ zola init [site_name]
copy
Build the site
$ zola build
copy
Start development server
$ zola serve
copy
Serve on specific port
$ zola serve -p [8080]
copy
Build with custom output directory
$ zola build -o [public]
copy
Check for errors without building
$ zola check
copy

SYNOPSIS

zola [options] command [arguments]

DESCRIPTION

Zola is a fast static site generator written in Rust. It combines content (Markdown files), templates (Tera templating), and configuration into a static website.
The site structure includes:
- content/ - Markdown files organized as sections
- templates/ - Tera HTML templates
- static/ - Static assets copied directly
- themes/ - Optional downloadable themes
- config.toml - Site configuration
Zola features include syntax highlighting, automatic table of contents, taxonomies (tags, categories), shortcodes, and built-in Sass compilation.
The development server provides live reload, rebuilding automatically when files change.

PARAMETERS

-c, --config file

Path to config file (default: config.toml)
-r, --root dir
Site root directory
--base-url url
Override base URL
-o, --output-dir dir
Output directory for build
-p, --port port
Port for serve command
-i, --interface addr
Interface to bind server
--drafts
Include draft content

SUBCOMMANDS

init name

Create new site scaffolding
build
Build the static site
serve
Start local development server with live reload
check
Validate site without building
completion shell
Generate shell completions

CAVEATS

Zola uses Tera templating, which differs from Hugo, Jekyll, or other static site generators. Template migration requires rewriting.
No plugin system. Extensibility is limited to shortcodes and templates.
Large sites with many pages may have noticeable build times, though Zola is generally faster than alternatives.

SEE ALSO

hugo(1), jekyll(1), mdbook(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community