The Wayback Machine - https://web.archive.org/web/20190323133339/https://github.com/getzola/zola
Skip to content
Please note that GitHub no longer supports your web browser.

We recommend upgrading to the latest Google Chrome or Firefox.

A fast static site generator in a single binary with everything built-in.
Branch: master
Clone or download
Keats Merge pull request #627 from JordanShurmer/patch-1
Fix minor documentation quirks in templates/overview
Latest commit bf95649 Feb 28, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
ci
completions Rebuild completions Nov 12, 2018
components cargo fmt + update Dec 10, 2018
docs Fix minor documentation quirks in templates/overview Feb 27, 2019
src Update deps + fmt Nov 14, 2018
sublime_syntaxes Add Dart syntax highlighting Dec 4, 2018
sublime_themes
test_site Fix broken taxonomies pagination Nov 29, 2018
.editorconfig Create new project Dec 6, 2016
.gitignore
.gitmodules Point to https submodule instead of git Nov 15, 2018
.travis.yml
CHANGELOG.md
CONTRIBUTING.md Adding GH specific issues/pr templates Nov 30, 2018
Cargo.lock
Cargo.toml cargo fmt + update Dec 10, 2018
EXAMPLES.md
LICENSE
README.md
appveyor.yml Update tokens and badges Nov 17, 2018
build.rs
netlify.toml
rustfmt.toml rustfmt Oct 31, 2018
snapcraft.yaml

README.md

zola (né Gutenberg)

Build Status Build status

A fast static site generator in a single binary with everything built-in.

Documentation is available on its site or in the docs/content folder of the repository and the community can use its forum.

Comparisons with other static site generators

Zola Cobalt Hugo Pelican
Single binary
Language Rust Rust Go Python
Syntax highlighting
Sass compilation
Assets co-location
i18n
Image processing
Sane & powerful template engine ~ ~
Themes
Shortcodes
Internal links
Link checker
Table of contents
Automatic header anchors
Aliases
Pagination
Custom taxonomies
Search
Data files
LiveReload
Netlify support ~
Breadcrumbs
Custom output formats ?

Supported content formats

  • Zola: markdown
  • Cobalt: markdown
  • Hugo: markdown, asciidoc, org-mode
  • Pelican: reStructuredText, markdown, asciidoc, org-mode, whatever-you-want

Template engine explanation

Cobalt gets ~ as, while based on Liquid, the Rust library doesn't implement all its features but there is no documentation on what is and isn't implemented. The errors are also cryptic. Liquid itself is not powerful enough to do some of things you can do in Jinja2, Go templates or Tera.

Hugo gets ~. It is probably the most powerful template engine in the list after Jinja2 (hard to beat python code in templates) but personally drives me insane, to the point of writing my own template engine and static site generator. Yes, this is a bit biased.

Pelican notes

Many features of Pelican are coming from plugins, which might be tricky to use because of version mismatch or lacking documentation. Netlify supports Python and Pipenv but you still need to install your dependencies manually.

You can’t perform that action at this time.