rougail/doc/dictionary/rougail.md

# Les dictionnaires

## Un dictionnaire ?

Un dictionnaire est un fichier YAML dont la structure est décrite dans cette documentation.

Un dictionnaire contient en ensemble de variable chargé dans [Tiramisu](https://framagit.org/tiramisu/tiramisu), utilisable à tout moment, notamment dans des templates.

Les familles et les variables peuvent être défini dans plusieurs dictionnaires. Ces dictionnaires s'aggrègent alors.

Les dictionnaires sont chargés dans l'ordre des répertoires [définit avec le paramètre `dictionaries_dir` de la configuration](../dev/config.md). Chaque répertoire est chargé les uns après les autres. A l'intérieur de ces répertoires les fichiers YAML seront classés par ordre alphabétique.

Il n'y a pas de classement par ordre alphabétique de l'ensemble des fichiers YAML de tous les répertoires.

Il est également possible de redéfinir des éléments pour changer les comportement d'une famille ou d'une variable.

## L'espace de nom par défaut

Les familles et variables de ces dictionnaires sont classées, par défaut, dans l'espace de nom `rougail`. Il est possible de changer le nom de cet espace de nom [avec le paramètre `variable_namespace` de la configuration](../dev/config.md).

Cet espace de nom est un peu particulier, il peut accéder a des variables dans un autre espace de nom.