stove/rougail
3
0
Fork 0
Code Issues 5 Pull requests 1 Projects Releases Wiki Activity

docs(v1.1_110): conditional disabled non mandatory variable

Browse source
This commit is contained in:
gwen 2026-05-18 21:28:35 +02:00
parent 8cc24d8ee4
commit e07e2c618c
2 changed files with 21 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
docs/tutorial/multiple.rst
View file

@ -29,7 +29,7 @@ A conditional disabled variable with type web_address
------------------------------------------------------------- -------------------------------------------------------------
First we need to add a variable as part of our use case with a type we haven't used yet, the `web_address` type. First we need to add a variable as part of our use case with a type we haven't used yet, the `web_address` type.
It is related to the automatic proxy configuration situation. It is related to the automatic proxy configuration :term:`situation <configuration>`.
Let's put it in the new :file:`firefox/30-auto.yml` :term:`structure file`. Let's put it in the new :file:`firefox/30-auto.yml` :term:`structure file`.
Note that this variable has a :term:`disabled` property defined: Note that this variable has a :term:`disabled` property defined:
@ -79,3 +79,21 @@ we have this output:
┣━━ 📓 Configure Proxy Access to the Internet: Automatic proxy configuration URL ◀ loaded from the YAML file "config/03/config.yml" (⏳ No proxy) ┣━━ 📓 Configure Proxy Access to the Internet: Automatic proxy configuration URL ◀ loaded from the YAML file "config/03/config.yml" (⏳ No proxy)
┗━━ 📓 Automatic proxy configuration URL: https://auto.proxy.net/wpad.dat ◀ loaded from the YAML file "config/03/config.yml" ┗━━ 📓 Automatic proxy configuration URL: https://auto.proxy.net/wpad.dat ◀ loaded from the YAML file "config/03/config.yml"
We can see that the `auto` variable has been activated here in this :term:`situation <configuration>`.
A conditional disabled non mandatory variable with type domainname and parameters
--------------------------------------------------------------------------------------
.. type-along:: For those who follow the tutorial with the help of the git repository
Now you need to checkout the :tutorial:`v1.1_110 <src/tag/v1.1_110/README.md>` version::
git switch --detach v1.1_110
In order to fit with our use case, we need to define a variable in which we could store domain names on which the proxy could be disabled.
We already used before in this tutorial the `domainname` type, which perfectly matches our needs.
We will just need to add certain parameters to this `domainname` type, as we will see.
.. This time we would need some kind of a container type, which would allow us to list the web addresses for which the proxy will be disabled.

1
docs/tutorial/preliminary.rst
View file

@ -404,6 +404,7 @@ We need to set the values ​​in separate files, called `user data files`.
We call configuration the whole system structure and user values, We call configuration the whole system structure and user values,
and when we speak of consistency, it is in relation to this whole set. and when we speak of consistency, it is in relation to this whole set.
It's a state, a possibility of state for the system, a situation.
.. keypoints:: Key points progress .. keypoints:: Key points progress