favicon here hometagsblogmicrobio cvtech cvgpg keys

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

Some Thoughts on the Twitter Mass Exodus

Another wave of Twitter users are jettisoning the social media website in favor of alternatives. Some are landing in the Fediverse (Mastodon and other ActivityPub-enabled software). Others are going to BlueSky. Some are just outright abandoning social medi…

via Dhole MomentsNovember 19, 2024

hyper in curl Needs a Champion

tl;dr - hyper in curl is nearly complete, but it needs a champion. Without a partner actively engaged that wants to enable and ship, it’s now on the path for being deprecated and removed. It needs a champion, a backing vendor or distro. Will that be you? …

via seanmonstarNovember 19, 2024

Swift observations from a reluctant Rustacean

Recently I've been thinking about Swift in terms of Rust, & have appreciated anew some of the choices made. In Rust. There's been a proliferation of X vs Y posts on the web, especially since the advent of LLM AI, so I try to resist the format. It's often e…

via Mike KreuzerNovember 16, 2024

Go Concurrency Patterns

Goroutines Channels Select Statement Wait Groups Mutex Conditions Atomic Operations Once Context Map Real Examples Goroutines The go keyword is used to start a goroutine. A goroutine is a lightweight, managed thread used by the Go runtime to run functions …

via Posts on integralistNovember 15, 2024

anarchism starts in the now: hope for a better future

there is still time

via maia blogNovember 14, 2024

Why I Will Always Be Angry About Software Engineering

Why do I bother getting angry about software? When I started writing, it came from a place of ennui — absolute despair at the amount of waste I was seeing in the technology sector since leaving university. I was paid spectacularly well, but nothing I produ…

via LudicityNovember 12, 2024

Generated by openring-rs

favicon here hometagsblogmicrobio cvtech cvgpg keys