return to title

Using Zola

Date: 2024-09-19
Tags: blog, web

This blog runs with Rust made static site generator Zola

As official documentation, is less than limited, I had to read several 3rd party docs to undederstand how to use it.

Tutorials I used for basic creation

the css, medias, etc, must be in the static directory, that is at the same level than public and content. ex:


.
├── config.toml
├── content
│   ├── about.md
│   ├── [...]
│   └── Using_Zola.md
├── public
│   [...]
├── sass
├── static
│   ├── css
│   │   └── general.css
│   └── medias
│       └── 2024-09
│           └── Zerkalo_vremeni-QBert.jpg
├── templates
│   ├── base.html
│   ├── blog.html
│   ├── blog-page.html
│   ├── index.html
│   ├── shortcodes
│   ├── tags.html
│   └── tags-page.html
├── highlight_themes   (optional)
└── themes

And in the html template:

     <link href="/css/general.css" rel="stylesheet" type="text/css">

In the html page itself:

![Q-Bert](/medias/2024-09/Zerkalo_vremeni-QBert.avif "Q-Bert")

alternatives

An interesting alternative to Zola is MkDocs

Tags: blog, web