Skip to Main Content

Caution

Ametrine is currently in the pre-alpha state and SHOULD NOT be used in production, it is far from being ready.

Ametrine is a Zola theme made specifically for personal websites and blogs, it provides good defaults and easy configuration, while being powerful on demand. Its design is rather unique and changes from time to time, and the development pace is rather rapid.

Some of Ametrine’s features:

What Is This Again

This is a theme for the Zola static site generator; thingy that converts Markdown files (which is used by Reddit, Tumblr, Discord, any many others) into a fully functional websites. Zola cannot build websites without a set of templates and styles, and this theme is exactly that. Ametrine also provides some custom functionality that is not present in Zola, such as Mastodon-powered comments, various useful shortcodes for simplifying various tasks, and more.

You can learn more about Zola and its themes at https://www.getzola.org.

Installation

If you have Git set up in your project, add Ametrine as a submodule:

git submodule init
git submodule add https://codeberg.org/daudix/ametrine.git themes/ametrine

Important

It is highly recommended to switch from the main branch to the latest release:

cd themes/ametrine
git checkout tags/v0.1.0

Then, enable Ametrine in your config.toml:

theme = "ametrine"

To update Ametrine, simply switch to a new tag:

Important

Check the changelog for all versions after the one you are using; there may be breaking changes that require manual involvement.

git submodule update --remote --merge
cd themes/ametrine
git checkout tags/v0.1.0

Why It Looks the Way It Does

Personally, I’m sick of flat, sterile, dead UIs all over the place, and I’ve always liked skeuomorphism because it’s fun, alive, and pleasant to look at. While it’s not very feasible to make things look overly realistic, some edge highlights, nice shadows, and a vibrant palette make a big difference. The design system that Ametrine uses is made of slightly frosted colored acrylic, everything is rounded, but the edges are not so rounded, so the edge highlight is rather thin, you can think of it as Lego bricks, fun and nice to touch. The animations are very bouncy to raise the fun level even higher. Still, the balance between fun and not annoying is maintained. Did I succeed with this premise? I don’t know, you tell me :P

To-Do

Right now Ametrine is not ready to be used in production and is in active development, here’s a short roadmap of features that need to be added and things to be done before the initial release:

Table of Contents