2018-10-18 20:50:06 +00:00
# zola (né Gutenberg)
2018-11-17 14:33:01 +00:00
[](https://travis-ci.com/getzola/zola)
2018-11-17 13:34:18 +00:00
[](https://ci.appveyor.com/project/Keats/zola/branch/master)
2016-12-11 06:05:03 +00:00
2018-03-09 11:53:13 +00:00
A fast static site generator in a single binary with everything built-in.
2016-12-11 06:05:03 +00:00
2018-10-18 20:50:06 +00:00
Documentation is available on [its site ](https://www.getzola.org/documentation/getting-started/installation/ ) or
2018-11-23 17:25:19 +00:00
in the `docs/content` folder of the repository and the community can use [its forum ](https://zola.discourse.group ).
2017-03-30 04:15:55 +00:00
2018-03-07 16:52:33 +00:00
## Comparisons with other static site generators
2018-10-18 20:50:06 +00:00
| | Zola | Cobalt | Hugo | Pelican |
2018-08-04 13:39:21 +00:00
|:-------------------------------:|:---------:|--------|------|---------|
| Single binary | ✔ | ✔ | ✔ | ✕ |
| Language | Rust | Rust | Go | Python |
| Syntax highlighting | ✔ | ✔ | ✔ | ✔ |
| Sass compilation | ✔ | ✔ | ✔ | ✔ |
| Assets co-location | ✔ | ✔ | ✔ | ✔ |
2018-12-29 10:17:43 +00:00
| Multilingual site | ✔ | ✕ | ✔ | ✔ |
2018-08-04 13:39:21 +00:00
| Image processing | ✔ | ✕ | ✔ | ✔ |
| Sane & powerful template engine | ✔ | ~ | ~ | ✔ |
| Themes | ✔ | ✕ | ✔ | ✔ |
| Shortcodes | ✔ | ✕ | ✔ | ✔ |
| Internal links | ✔ | ✕ | ✔ | ✔ |
| Link checker | ✔ | ✕ | ✕ | ✔ |
| Table of contents | ✔ | ✕ | ✔ | ✔ |
| Automatic header anchors | ✔ | ✕ | ✔ | ✔ |
| Aliases | ✔ | ✕ | ✔ | ✔ |
| Pagination | ✔ | ✕ | ✔ | ✔ |
| Custom taxonomies | ✔ | ✕ | ✔ | ✕ |
| Search | ✔ | ✕ | ✕ | ✔ |
2018-10-18 15:32:30 +00:00
| Data files | ✔ | ✔ | ✔ | ✕ |
2018-08-04 13:39:21 +00:00
| LiveReload | ✔ | ✕ | ✔ | ✔ |
2018-10-18 20:50:06 +00:00
| Netlify support | ~ | ✕ | ✔ | ✕ |
2018-11-18 04:47:48 +00:00
| Breadcrumbs | ✔ | ✕ | ✕ | ✔ |
2018-12-01 08:18:21 +00:00
| Custom output formats | ✕ | ✕ | ✔ | ? |
2018-08-04 13:39:21 +00:00
### Supported content formats
2018-03-12 17:09:28 +00:00
2018-10-18 20:50:06 +00:00
- Zola: markdown
2018-03-12 17:09:28 +00:00
- Cobalt: markdown
- Hugo: markdown, asciidoc, org-mode
- Pelican: reStructuredText, markdown, asciidoc, org-mode, whatever-you-want
2018-08-04 13:39:21 +00:00
### Template engine explanation
Cobalt gets `~` as, while based on [Liquid ](https://shopify.github.io/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
2018-07-31 15:10:46 +00:00
to use because of version mismatch or lacking documentation. Netlify supports Python
and Pipenv but you still need to install your dependencies manually.
