From 9413831037238a5dfaed5143dd3ca41d3abd3161 Mon Sep 17 00:00:00 2001 From: gwen Date: Wed, 3 Dec 2025 22:12:08 +0100 Subject: [PATCH] domainname page ok --- docs/tutorial/domainname.rst | 36 ++++++++++++++++++++++++++++++++++-- 1 file changed, 34 insertions(+), 2 deletions(-) diff --git a/docs/tutorial/domainname.rst b/docs/tutorial/domainname.rst index c69ffd673..6db3efc41 100644 --- a/docs/tutorial/domainname.rst +++ b/docs/tutorial/domainname.rst @@ -1,5 +1,5 @@ -A few types suitable for our use case -================================================ +Some suitable types +===================== .. objectives:: Objectives @@ -409,10 +409,42 @@ Let's add one more variable in the `manual` family, with a much more basic type: - we have decided to create a new structure file :file:`firefox/20-manual.yml`. This is not necessary but usefull, please have a look at the :ref:`structure file organization and naming conventions ` +Let's switch this boolean variable to a `false` value: +.. extinclude:: https://forge.cloud.silique.fr/stove/rougail-tutorials/raw/tag/v1.1_033/config/02/config.yml + :language: yaml + :caption: A :file:`config/02/config.yml` user data file with false as a value for `use_for_https` + +.. + --- + manual: + http_proxy: + address: example.net + use_for_https: false + +:tutorial:`Download this file from the rougail-tutorials git repository ` + + +Let's run the rougail CLI: + +.. raw:: html + :class: terminal + :url: https://forge.cloud.silique.fr/stove/rougail-tutorials/raw/tag/v1.1_033/config/02/cmd_ro.txt + +.. + rougail -m firefox/ -u yaml -yf config/02/config.yml + +the result is: + +.. raw:: html + :class: output + :url: https://forge.cloud.silique.fr/stove/rougail-tutorials/raw/tag/v1.1_033/config/02/output_ro.html + +We could of course perform several tests on type validators, but here the validation is simple: only two values ​​are allowed (`true` or `false`). .. keypoints:: let's review the key points - we can assign a `domainname` type to a variable - we can set a :term:`parameter` to a `domainname` variable to refine their typing behavior - we can assign a `port` type to a variable + - we know how to set a `boolean` type variable to `true` or `false`