favicon here hometagsblog

My experience with Zola



Soc Virnyl Estela | 2022-12-10 | reading time: ~3min

There are many static site generators out there and we all know the most popular is Hugo. This static site generator is written in Go, one of the most popular programming languages that is used to write popular technologies such as Docker and Gitea.

During my exploration of using a static site generator, I was planning to use Franklin.jl from the Julia programming language. Although the idea was to use that, I never really got the motivation around that time to build my website since personal life got so busy.

Discovering Zola§

As a Rust enthusiast, I was finding myself looking around using tools that are written in Rust. We all know about the memes such as "Blazingly fast! 🚀" on most popular Rust repositories but my discovery of Zola, admittedly, is because of well... Rust. I have completely forgotten about Franklin.jl at that time, around October 2022 because the community I was in were Rust enthusiasts.

Like Hugo, Zola is also a static site generator but written in Rust. It uses the Tera templating engine which is inspired by Jinja2 and Django template language. As I am also familiar with Django, albeit out of practice and no longer using it, I am still familiar with the Jinja2 and Django template language.

I have not used Hugo so I cannot really tell what features it has compared to Zola. Zola has various features including a configuration file config.toml where you can configure if you want to generate a ToC. And of course, it supports reading your static folder which you can put your assets and everything you want in there.

The appeal§

The number one appeal that I think what made me use Zola are templates. With the usage of the Tera template language, you can reuse html files as ... guess what ... templates. This encourage code reuse and adding some macros so you can modify your existing templates with another and extending it as you please. As you may all know, my site is built with Zola and I haven't even used its full power yet because I am still understanding how this all works and all including extending and creating Tera macros. Yet, so little features used, and I already built a website of my own. This made me happy and stick to it.

Conclusion§

Zola pretty well made it easy for me to write my own website and simplify my way of writing one with the Tera templating engine. So far, the tool is good to me and I have not experienced any hiccups yet.

Minor issues§

The only issue that I really dislike about Zola is the lack of documentation, which to me discourages new users to use it. It took me 2 hours to understand how to use the templating engine and what classes and ids should I use for the SASS/CSS files by inspecting the generated site using Firefox's Inspect tool and also reading code from custom themes from other users.

Articles from blogs I follow around the net

Perma-Vuln: D-Link DIR-859, CVE-2024-0769

Recently Sift caught an interesting payload. As it turns out, the exploit was CVE-2024-0769, which is now tagged here: D-Link DIR-859 Information Disclosure Attempt . This vulnerability is a path traversal leading to information disclosure. But, perhaps mo…

via GreyNoise LabsJune 25, 2024

Synergy Greg

Synergy Greg would like to see you in His office, it is the one down the hall, past the cubicles and dreary faces, uplifted only when He deigns to venture forth. You will know Him when you see Him, He is the one composed, of a thousand writhing forms,…

via LudicityJune 22, 2024

Status update, June 2024

Hi all! This status update will be shorter than usual because I had a lot less free time for my open-source projects than usual this month. Indeed, I recently joined SNCF Réseau (the company responsible for the French railway infrastructure) to work on OSR…

via emersionJune 18, 2024

Why People are Angry over Go 1.23 Iterators

NOTE: This is based on, but completely rewritten, from a Twitter post: https://x.com/TheGingerBill/status/1802645945642799423 TL;DR It makes Go feel too “functional” rather than being an unabashed imperative language. I recently saw a post on Twitter showi…

via Articles on gingerBillJune 17, 2024

My RSS feed has been upgraded ✨

I did some integration work to include posts written for other publications in my RSS feed. Apologies if you see some duplicated items! 📪

via Rob O'LearyJune 15, 2024

Programming at the edge with Fastly Compute

So you’ve heard about computing at the edge, and you’ve heard that Fastly let’s you run JavaScript, Go, Rust and any other language that compiles to Wasm at the edge… well, let’s take a look and while we’re at it let’s try and understand how caching works …

via Posts on integralistJune 12, 2024

Generated by openring-rs