Skip to content

Creating a theme! ๐Ÿฆž

Breadcrumb edited this page Jun 7, 2021 · 2 revisions

Let's create a cool theme for Rootbeer!

To make a theme, you create a folder with the name of the theme in the themes/ directory. Then, in the config file, on the theme variable, put the name of the theme (the folder name it is case sensitive). Like if the name of the theme was, "My Epic Theme", then your folder should be named: My Epic Theme

And in the config file, change the theme: RBDefault too theme: My Epic Theme

Rootbeer's themes use the Jinja2 templating engine. It's syntax are ALWAYS surrounded by { }.

Example:

Variable placement will look like this: {{ variable }}
Expressions will look like this: {% if this %} ... {% endif %}
Comments will look like this: {# This will be ignored #}

Jinja2 tags such as if, else, and for all need to have an end statement. Like this:

{% if this == that %}
    {% for this in my_list %}
    {% endfor %}
{% else %}
    <h1>yo</h1>
{% endif %}

You can see what special variables you can use in your theme in the API Reference Wiki page.

If you are still confused, you can take a look at the default theme that comes with Rootbeer called RBDefault.