Rubedo

Rubedo

The final stage in the alchemical process of building a static website

cargo install rubedo-ssg

What is Rubedo?

Rubedo is a simple, lightweight and fast static site generator.

It combines the simplicity and speed of the old web, with the convenience of a modern modular workflow, with zero JavaScript by default.

Concocted with arcane magic*

Rubedo is built on the solid foundation of a modern programming stack.

Rust, Tera, Comrak, syntect are just some of the ingredients used to transmute it.

*: Actually quite simple and hackable.

Ferris the crab, unofficial mascot for Rust
+++
title = "Your first alembic"
date = 2024-11-08+01:00
+++

The search for _beginner
alchemical supplies_
never ends! In the
[previous post](/posts/mortars)
we had a look at **mortars**,
...

Markdown powered content

Write your posts using the most ubiquitous markup language out there.

No databases or complicated CMSs, just your content front and center.

Powerful, familiar templating

Rubedo's templating engine is Tera, an intuitive and widely used engine, with a familiar syntax inspired by Jinja2.

It allows for a modular approach to templating, without reinventing the wheel.

<h2>Articles</h2>
<ul>
{% for page in site.pages %}
    {% if
        page.relative_path
        is starting_with("/articles")
    %}
        <li>
            <a href="{{ page.url }}">
                {{ page.title }}
            </a>
        </li>
    {% endif %}
{% endfor %}
</ul>
Logo of the AGPL3 license, two subtexts recite 'Free Software' and 'Free as in Freedom'

Libre, as all software should be

Rubedo is licensed under the terms of the GNU Affero General Public License, Version 3.

In other words, it respects your software freedom.