You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Vincent Prouillet 33d4cf14fd
Update table-of-contents.md
5 years ago
.github fix minor typo in doc template 5 years ago
ci Rename all occurrences of gutenberg to zola in code 6 years ago
completions Rebuild completions 6 years ago
components Allow default base-path command line option to be set for building and serving 5 years ago
docs Update table-of-contents.md 5 years ago
src Allow default base-path command line option to be set for building and serving 5 years ago
sublime_syntaxes Add PowerShell syntax 5 years ago
sublime_themes One more time, Dracula theme, lol 5 years ago
test_site Ensure we don't delete root index without 5 years ago
test_site_i18n Add multilingual taxonomies 5 years ago
.editorconfig Create new project 8 years ago
.gitignore Merge pull request #567 from getzola/next 5 years ago
.gitmodules Point to https submodule instead of git 6 years ago
.travis.yml Pest now requires 1.31 5 years ago
CHANGELOG.md Fix typo in docs 5 years ago
CONTRIBUTING.md Adding GH specific issues/pr templates 6 years ago
Cargo.lock Update changelog 5 years ago
Cargo.toml Add languages to config 5 years ago
EXAMPLES.md Merge pull request #567 from getzola/next 5 years ago
LICENSE USe date range for license 6 years ago
README.md fmt/clippy 5 years ago
appveyor.yml Pest now requires 1.31 5 years ago
build.rs rustfmt 6 years ago
netlify.toml Add custom data output to the comparison 6 years ago
rustfmt.toml rustfmt 6 years ago
snapcraft.yaml Add home plug to snapcraft.yml 6 years ago

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
Multilingual site
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.