The structure files

What do you mean by structure file?

A structure file is a YAML file whose structure is described in this documentation page.

A structure file contains a set of variables loaded into Tiramisu, usable at any time, especially in a templates.

Families and variables can be defined in several structure files. These structure files are then aggregated.

Structure files are loaded in the directory order defined by the dictionaries_dir configuration parameter. Each directory is loaded one after the other. Inside these directories the YAML files will be classified in alphabetical order.

There is no alphabetical ordering of all YAML files in all directories.

It is also possible to redefine elements to change the behavior of a family or a variable.

The default namespace

The families and variables contained in these structure files are ordered, by default, in the rougail namespace. It is possible to change the name of this namespace with the variable namespace parameter of the configuration.

This namespace is a bit special, it can access variables in another namespace.

The extra structure files

An extra is a different namespace. The idea is to be able to classify the variables by theme.

Extra namespaces must be declared when configuring Rougail.

In this namespace we cannot access variables from another extra namespace. On the other hand, it is possible to access the variable of the default namespace.