No description
Find a file
Enmanuel de la Nuez e2f2f4f779
Briefly explain TOML tables (#1576)
* Briefly explain TOML tables

There's a warning about a possible source of errors, but it doesn't give you the relevant information to actually make sense of it. I hope this saves someone a search since I personally had to find this out reading the TOML spec.

Any other ways to phrase this?

* Update configuration.md
2021-08-03 09:20:34 +02:00
.github Update PULL_REQUEST_TEMPLATE.md 2019-05-07 07:18:26 -07:00
completions Make path to config.toml independent from root dir (#1023) 2020-05-23 11:55:45 +02:00
components Add class based syntax higlighting + line numbers (#1531) 2021-07-10 08:53:19 +02:00
docs Briefly explain TOML tables (#1576) 2021-08-03 09:20:34 +02:00
src Allow functions to look into current theme static folder 2021-06-24 23:12:05 +02:00
sublime Add protobuf syntax highlighting 2021-05-10 22:09:36 +02:00
test_site Merge branch 'master' into next 2021-07-18 13:53:27 +02:00
test_site_i18n Move taxonomies to language options dict 2021-04-07 22:13:15 +02:00
.dockerignore add .dockerignore file to reduce intermediate docker image size and build time 2020-06-09 12:16:01 +02:00
.editorconfig Create new project 2016-12-06 14:51:33 +09:00
.gitignore Add class based syntax higlighting + line numbers (#1531) 2021-07-10 08:53:19 +02:00
.gitmodules Add protobuf syntax highlighting 2021-05-10 22:09:36 +02:00
azure-pipelines.yml Update version of zola for docs + version of ubuntu for release 2021-07-19 20:12:41 +02:00
build.rs Use Rust 2018 edition (#885) 2020-02-02 17:48:43 -08:00
Cargo.lock Update deps 2021-07-18 14:03:14 +02:00
Cargo.toml Tweaks to load_data + update deps 2021-04-21 21:43:02 +02:00
CHANGELOG.md Update release date 2021-07-19 19:32:26 +02:00
CONTRIBUTING.md Merge branch 'master' into next 2021-07-18 13:53:27 +02:00
Dockerfile Update dockerfile to remove hardcoded version number (#939) 2020-02-02 17:42:43 -08:00
EXAMPLES.md Fix uggla blog git repo location 2021-07-26 19:25:43 +02:00
is-ehh.svg improve README comparison svgs 2019-04-09 14:36:55 -04:00
is-no.svg improve README comparison svgs 2019-04-09 14:36:55 -04:00
is-yes.svg improve README comparison svgs 2019-04-09 14:36:55 -04:00
LICENSE USe date range for license 2018-01-16 13:39:56 +01:00
netlify.toml Update version of zola for docs + version of ubuntu for release 2021-07-19 20:12:41 +02:00
README.md Add Cloudflare Pages support to README (#1396) 2021-03-22 19:21:57 +01:00
rustfmt.toml rustfmt 2018-10-31 08:18:57 +01:00
snapcraft.yaml Update MSRV 2021-05-09 23:03:19 +02:00

zola (né Gutenberg)

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 yes yes yes no
Language Rust Rust Go Python
Syntax highlighting yes yes yes yes
Sass compilation yes yes yes yes
Assets co-location yes yes yes yes
Multilingual site ehh no yes yes
Image processing yes no yes yes
Sane & powerful template engine yes yes ehh yes
Themes yes no yes yes
Shortcodes yes no yes yes
Internal links yes no yes yes
Link checker yes no no yes
Table of contents yes no yes yes
Automatic header anchors yes no yes yes
Aliases yes no yes yes
Pagination yes no yes yes
Custom taxonomies yes no yes no
Search yes no no yes
Data files yes yes yes no
LiveReload yes no yes yes
Netlify support yes no yes no
Vercel support yes no yes yes
Cloudflare Pages support yes no yes yes
Breadcrumbs yes no no yes
Custom output formats no no yes no

Supported content formats

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

ehh explanations

Hugo gets ehh for the template engine because while it is probably the most powerful template engine in the list (after Jinja2) it personally drives me insane, to the point of writing my own template engine and static site generator. Yes, this is a bit biased.

Zola gets ehh for multi-language support as it only has a basic support and does not (yet) offer things like i18n in templates.

Pelican notes

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