Having read the full documentation, I now have a good idea of what is missing. I’ll slowly add content as I clarify the sections. The first missing information is just a general description of Zola for people not familiar with SSGs. I’ll copy part of a new “Overview” subsection I’m writing for the “Getting Starting” section. Let me know what you think (I had to remove the links for this post; links in [ ]).
Zola at a Glance
Zola is a static site generator (SSG), similar to [Hugo], [Pelican], and [Jekyll] (for a comprehensive list of SSGs, please see the [StaticGen] site). It is written in [Rust] and uses the [Tera] template engine, which is similar to [Jinja2], [Django templates], [Liquid], and [Twig]. Content is written in [Markdown].
SSGs use dynamic templates to transform content into static HTML pages. Static sites are thus very fast and require no databases, making them easy to host. A comparison between static and dynamic sites, such as WordPress, Drupal, and Django, can be found [here].
If you are new to SSGs, please see the quick tutorial below.
First Steps with Zola
Unlike some SSGs, Zola makes no assumptions regarding the structure of your site. For this tutorial, we’ll be making a simple blog site.
This tutorial is based on Zola 0.9.
Please see the detailed [installation instructions for your platform]. With Zola installed, let’s initialize our site:
$ zola init myblog
You will be asked a few questions.
> What is the URL of your site? (https://example.com):
> Do you want to enable Sass compilation? [Y/n]:
> Do you want to enable syntax highlighting? [y/N]:
> Do you want to build a search index of the content? [y/N]:
For our blog, let’s accept the default values (i.e., press Enter for each question). We now have a
myblog directory with the following structure:
Let’s start the zola development server with:
$ zola serve
-> Creating 0 pages (0 orphan), 0 sections, and processing 0 images
This command must be run in the base Zola directory, which contains
If you point your web browser to [127.0.0.1:1111], you should see a “Welcome to Zola” message.