dictionary removed, replaced by structure file
This commit is contained in:
parent
038cd9429a
commit
0f0d955e9f
2 changed files with 15 additions and 17 deletions
|
@ -27,7 +27,7 @@ What is a consistency handling system ?
|
|||
Here is the :xref:`tiramisu library`.
|
||||
|
||||
In the Rougail scope, we call it :term:`variable`\ s and :term:`families`.
|
||||
In Rougail, the families and variables are located in the :term:`structure files <dictionaries>` (the term "dictionary" is also used as a synonym).
|
||||
In Rougail, the families and variables are located in the :term:`structure files <dictionaries>`.
|
||||
|
||||
The structure files
|
||||
---------------------
|
||||
|
@ -35,12 +35,10 @@ The structure files
|
|||
.. glossary::
|
||||
|
||||
structure file
|
||||
dictionary
|
||||
dictionaries
|
||||
|
||||
A dictionary or a a structure file in the Rougail meaning is a YAML file that describes variables
|
||||
A structure file in the Rougail meaning is a YAML file that describes variables
|
||||
and their dependencies / consistencies.
|
||||
There can be a lot of dictionary files located in many different folders.
|
||||
There can be a lot of structure files located in many different folders.
|
||||
|
||||
Rougail reads all the dictionaries and loads them into a single object
|
||||
that handles the variables consistency.
|
||||
|
@ -60,7 +58,7 @@ The YAML structure files format
|
|||
|
||||
We need to learn first the specifics of the YAML dictionaries file format in Rougail, as well as some templating concepts.
|
||||
|
||||
Here is an empty Rougail dictionary YAML file
|
||||
Here is an empty Rougail structure YAML file
|
||||
|
||||
.. extinclude:: https://forge.cloud.silique.fr/stove/rougail-tutorials/raw/tag/v1.1_000/firefox/00-proxy.yml
|
||||
:linenos:
|
||||
|
@ -81,8 +79,8 @@ You can see that there is just a `version` specification.
|
|||
|
||||
version
|
||||
|
||||
The version is here a Rougail YAML dictionary version format.
|
||||
It is set in the beginning of a YAML dictionary, or globaly in the Rougail settings
|
||||
The version is here a Rougail YAML structure file version format.
|
||||
It is set in the beginning of a YAML structure file, or globaly in the Rougail settings
|
||||
for example from the command line
|
||||
|
||||
.. note:: You can set the format in the Rougail command line tool like this:
|
||||
|
@ -98,7 +96,7 @@ Here is a :term:`structure file <dictionary>` example with a variable into it:
|
|||
|
||||
.. extinclude:: https://forge.cloud.silique.fr/stove/rougail-tutorials/raw/tag/v1.1_010/firefox/00-proxy.yml
|
||||
:language: yaml
|
||||
:caption: A Rougail dictionnary file with a variable named `proxy_mode`. It's the Rougail YAML dictionary format.
|
||||
:caption: A Rougail dictionnary file with a variable named `proxy_mode`. It's the Rougail YAML structure file format.
|
||||
:name: RougailDictionaryFirstVariable
|
||||
|
||||
..
|
||||
|
|
|
@ -13,7 +13,7 @@ Preliminaries
|
|||
|
||||
We assume that Rougail's library is :ref:`already installed <installation>` on your computer (or in a virtual environment).
|
||||
|
||||
.. type-along:: an empty dictionary
|
||||
.. type-along:: an empty structure file
|
||||
|
||||
An empty structure description file
|
||||
|
||||
|
@ -23,14 +23,14 @@ Preliminaries
|
|||
|
||||
workplace
|
||||
├── firefox
|
||||
│ └── dictionary.yml
|
||||
│ └── struct.yml
|
||||
|
||||
- Let's make a :file:`workplace` directory, with a :file:`firefox` subfolder.
|
||||
- First, we wil make a :term:`dictionary`, so let's create a :file:`dictionary.yml` file
|
||||
- First, we wil make a :term:`structure file <dictionary>`, so let's create a :file:`struct.yml` file
|
||||
located in the :file:`firefox` subfolder.
|
||||
|
||||
The dictionary
|
||||
----------------
|
||||
The structure file
|
||||
--------------------
|
||||
|
||||
This is an empty Rougail dictionnary
|
||||
|
||||
|
@ -165,14 +165,14 @@ Values are mandatory
|
|||
-------------------------
|
||||
|
||||
It is the operator's responsibility to set configuration options values.
|
||||
He does not work with the dictionary (the structure file),
|
||||
He does not work with the structure file,
|
||||
he is responsible for other files, called the configuration files.
|
||||
|
||||
.. glossary::
|
||||
|
||||
configuration file
|
||||
|
||||
A configuration file is a file where only the values of the configuration options are assigned. The structure, the consistency of the variables between them is not the responsibility of these files (but of the dictionary files).
|
||||
A configuration file is a file where only the values of the configuration options are assigned. The structure, the consistency of the variables between them is not the responsibility of these files (but of the structure files).
|
||||
|
||||
.. exercise:: Folder structure update
|
||||
|
||||
|
@ -180,7 +180,7 @@ he is responsible for other files, called the configuration files.
|
|||
|
||||
workplace
|
||||
├── firefox
|
||||
│ ├── dictionary.yml
|
||||
│ ├── struct.yml
|
||||
└── config
|
||||
└── config.yml
|
||||
|
||||
|
|
Loading…
Reference in a new issue