[tutorial v1.1_032] A variable with type "port" (config and doc)

2025-12-02 16:18:32 +01:00 · 2025-12-02 16:18:32 +01:00 · 0bf261f16d
commit 0bf261f16d
parent b864af407d
11 changed files with 119 additions and 103 deletions
--- a/README.md
+++ b/README.md
@ -1,11 +1,11 @@
 - [Summary](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/branch/1.1/README.md)
- [[tutorial v1.1_030] A variable with type "domainname"](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_030/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_030~1..v1.1_030))
+- [[tutorial v1.1_031] A variable with type's parameters](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_031/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_031~1..v1.1_031))

-# [tutorial v1.1_031] A variable with type's parameters
+# [tutorial v1.1_032] A variable with type "port"

-[View the diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_031~1..v1.1_031)
+[View the diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_032~1..v1.1_032)

-[Read the documentation](https://pedago.gwenaelremond.fr/bribes/rougail/tutorial/disabled.html#a-variable-with-type's-parameters)
+[Read the documentation](https://pedago.gwenaelremond.fr/bribes/rougail/tutorial/disabled.html#a-variable-with-type-"port")


 ## Screenshot
@ -31,7 +31,7 @@ pip install rougail-cli rougail-output-exporter rougail-output-doc rougail-user-
 Then switch to the tutorial page:

 ```shell
-git switch --detach v1.1_031
+git switch --detach v1.1_032
 ```

 ## Structure
@ -39,10 +39,10 @@ git switch --detach v1.1_031


 <p>
-<a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_031/./">.</a><br/>
-	└── <a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_031/./firefox/">firefox</a><br/>
-	    ├── <a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_031/./firefox/00-proxy.yml">00-proxy.yml</a><br/>
-	    └── <a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_031/./firefox/10-manual.yml">10-manual.yml</a><br/>
+<a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_032/./">.</a><br/>
+	└── <a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_032/./firefox/">firefox</a><br/>
+	    ├── <a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_032/./firefox/00-proxy.yml">00-proxy.yml</a><br/>
+	    └── <a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_032/./firefox/10-manual.yml">10-manual.yml</a><br/>
 <br/><br/></p>

 Contents of the firefox/10-manual.yml file
@ -61,6 +61,11 @@ manual:  # Manual proxy configuration
      type: domainname
      params:
        allow_ip: true
+
+    port:
+      description: HTTP Port
+      type: port
+      default: 8080
 ...

 ```
@ -85,20 +90,21 @@ rougail -m firefox/ -o doc
 > 
 > **Path**: manual.http_proxy

-| Variable                                                                                                                                                                                                    | Description                                                                                           |
-|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
-| **<a id="manual.http_proxy.address" name="manual.http_proxy.address">manual.http_proxy.address</a>**<br/>[`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | HTTP address.<br/>**Validators**: <br/>•&nbsp;type domainname<br/>•&nbsp;the domain name can be an IP |
+| Variable                                                                                                                                                                                                    | Description                                                                                                                                                                                                                |
+|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **<a id="manual.http_proxy.address" name="manual.http_proxy.address">manual.http_proxy.address</a>**<br/>[`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | HTTP address.<br/>**Validators**: <br/>•&nbsp;type domainname<br/>•&nbsp;the domain name can be an IP                                                                                                                      |
+| **<a id="manual.http_proxy.port" name="manual.http_proxy.port">manual.http_proxy.port</a>**<br/>[`port`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory`                | HTTP Port.<br/>**Validators**: <br/>•&nbsp;well-known ports (1 to 1023) are allowed<br/>•&nbsp;registred ports (1024 to 49151) are allowed<br/>•&nbsp;private ports (greater than 49152) are allowed<br/>**Default**: 8080 |

 ### Let's generate the changelog

 ```shell
 rougail -m firefox/ -o doc --doc.contents changelog
 ```
-#### Modified variable
+#### New variable

-| Variable                                                                                                                                                                                                    | Description                                                                                                      |
-|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|
-| **<a id="manual.http_proxy.address" name="manual.http_proxy.address">manual.http_proxy.address</a>**<br/>[`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | HTTP address.<br/>**Validators**: <br/>•&nbsp;type domainname<br/>•&nbsp;<ins>the domain name can be an IP</ins> |
+| Variable                                                                                                                                                                                     | Description                                                                                                                                                                                                                |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **<a id="manual.http_proxy.port" name="manual.http_proxy.port">manual.http_proxy.port</a>**<br/>[`port`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | HTTP Port.<br/>**Validators**: <br/>•&nbsp;well-known ports (1 to 1023) are allowed<br/>•&nbsp;registred ports (1024 to 49151) are allowed<br/>•&nbsp;private ports (greater than 49152) are allowed<br/>**Default**: 8080 |


 ## User datas
@ -110,6 +116,7 @@ rougail -m firefox/ -o doc --doc.contents changelog

 ```yml
 ---
+proxy_mode: Manual proxy configuration
 manual:
  http_proxy:
    address: example.net
@ -119,16 +126,19 @@ manual:
 ```shell
 rougail -m firefox/ -u yaml -yf config/01/config.yml
 ```
-<pre>╭───────────────────── Caption ─────────────────────╮
-│ Variable                           <span style="color: #ffd700">Default value</span>  │
-│ <span style="color: #ff0000">Undocumented but modified variable</span> <span style="color: #00aa00">Modified value</span> │
-╰───────────────────────────────────────────────────╯
+<pre>╭─────────────────────────── Caption ────────────────────────────╮
+│ Variable                           <span style="color: #ffd700">Default value</span>               │
+│ <span style="color: #ff0000">Undocumented but modified variable</span> <span style="color: #00aa00">Modified value</span>              │
+│                                    (⏳ Original default value) │
+╰────────────────────────────────────────────────────────────────╯
 Variables:
-<span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">Configure Proxy Access to the Internet</span>: <span style="color: #ffd700">No proxy</span>
+<span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">Configure Proxy Access to the Internet</span>: <span style="color: #00aa00">Manual proxy configuration</span> ◀ 
+<span style="color: #5c5cff">┃   </span>loaded from the YAML file "config/01/config.yml" (⏳ No proxy)
 <span style="color: #5c5cff">┗━━ </span>📂 Manual proxy configuration
 <span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📂 HTTP Proxy
-<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📓 <span style="color: #ff0000">HTTP address</span>: <span style="color: #00aa00">example.net</span> ◀ loaded from the YAML file 
-<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span>"config/01/config.yml"
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">HTTP address</span>: <span style="color: #00aa00">example.net</span> ◀ loaded from the YAML file 
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┃   </span>"config/01/config.yml"
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📓 <span style="color: #ff0000">HTTP Port</span>: <span style="color: #ffd700">8080</span>
 </pre>
 ### Example 2

@ -137,41 +147,30 @@ Variables:

 ```yml
 ---
+proxy_mode: Manual proxy configuration
 manual:
  http_proxy:
-    address: 192.168.0.1
+    address: example.net
+    port: 3128
 ```
 #### Output

 ```shell
 rougail -m firefox/ -u yaml -yf config/02/config.yml
 ```
-<pre>╭───────────────────── Caption ─────────────────────╮
-│ Variable                           <span style="color: #ffd700">Default value</span>  │
-│ <span style="color: #ff0000">Undocumented but modified variable</span> <span style="color: #00aa00">Modified value</span> │
-╰───────────────────────────────────────────────────╯
+<pre>╭─────────────────────────── Caption ────────────────────────────╮
+│ Variable                           <span style="color: #00aa00">Modified value</span>              │
+│ <span style="color: #ff0000">Undocumented but modified variable</span> (⏳ Original default value) │
+╰────────────────────────────────────────────────────────────────╯
 Variables:
-<span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">Configure Proxy Access to the Internet</span>: <span style="color: #ffd700">No proxy</span>
+<span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">Configure Proxy Access to the Internet</span>: <span style="color: #00aa00">Manual proxy configuration</span> ◀ 
+<span style="color: #5c5cff">┃   </span>loaded from the YAML file "config/02/config.yml" (⏳ No proxy)
 <span style="color: #5c5cff">┗━━ </span>📂 Manual proxy configuration
 <span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📂 HTTP Proxy
-<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📓 <span style="color: #ff0000">HTTP address</span>: <span style="color: #00aa00">192.168.0.1</span> ◀ loaded from the YAML file 
-<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span>"config/02/config.yml"
-</pre>
-#### Output when invalid user datas is an error
-
-```shell
-rougail -m firefox/ -u yaml -yf config/02/config.yml --cli.invalid_user_datas_error
-```
-<pre>╭───────────────────── Caption ─────────────────────╮
-│ Variable                           <span style="color: #ffd700">Default value</span>  │
-│ <span style="color: #ff0000">Undocumented but modified variable</span> <span style="color: #00aa00">Modified value</span> │
-╰───────────────────────────────────────────────────╯
-Variables:
-<span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">Configure Proxy Access to the Internet</span>: <span style="color: #ffd700">No proxy</span>
-<span style="color: #5c5cff">┗━━ </span>📂 Manual proxy configuration
-<span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📂 HTTP Proxy
-<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📓 <span style="color: #ff0000">HTTP address</span>: <span style="color: #00aa00">192.168.0.1</span> ◀ loaded from the YAML file 
-<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span>"config/02/config.yml"
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">HTTP address</span>: <span style="color: #00aa00">example.net</span> ◀ loaded from the YAML file 
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┃   </span>"config/02/config.yml"
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📓 <span style="color: #ff0000">HTTP Port</span>: <span style="color: #00aa00">3128</span> ◀ loaded from the YAML file 
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span>"config/02/config.yml" (⏳ 8080)
 </pre>
 ### Example 3

@ -180,9 +179,11 @@ Variables:

 ```yml
 ---
+proxy_mode: Manual proxy configuration
 manual:
  http_proxy:
-    address: not a valid domain name
+    address: example.net
+    port: 100000
 ```
 #### Output

@ -190,14 +191,22 @@ manual:
 rougail -m firefox/ -u yaml -yf config/03/config.yml
 ```
 <pre><span style="font-weight: bold; color: #ffff00">🔔 WARNINGS</span>
-<span style="color: #ffff00">┗━━ </span>the value "not a valid domain name" is an invalid domain name for 
-<span style="color: #ffff00">    </span>"manual.http_proxy.address" (HTTP address), must have dot, it will be 
-<span style="color: #ffff00">    </span>ignored when loading from the YAML file "config/03/config.yml"
-<span style="font-weight: bold; color: #ff0000">🛑 ERRORS</span>
-<span style="color: #ff0000">┗━━ </span>The following variables are mandatory but have no value:
-<span style="color: #ff0000">    </span><span style="color: #ff0000">┗━━ </span>Manual proxy configuration
-<span style="color: #ff0000">    </span><span style="color: #ff0000">    </span><span style="color: #ff0000">┗━━ </span>HTTP Proxy
-<span style="color: #ff0000">    </span><span style="color: #ff0000">    </span><span style="color: #ff0000">    </span><span style="color: #ff0000">┗━━ </span>HTTP address
+<span style="color: #ffff00">┗━━ </span>the value "100000" is an invalid port for "manual.http_proxy.port" (HTTP 
+<span style="color: #ffff00">    </span>Port), must be between 1 and 65535, it will be ignored when loading from the
+<span style="color: #ffff00">    </span>YAML file "config/03/config.yml"
+╭─────────────────────────── Caption ────────────────────────────╮
+│ Variable                           <span style="color: #ffd700">Default value</span>               │
+│ <span style="color: #ff0000">Undocumented but modified variable</span> <span style="color: #00aa00">Modified value</span>              │
+│                                    (⏳ Original default value) │
+╰────────────────────────────────────────────────────────────────╯
+Variables:
+<span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">Configure Proxy Access to the Internet</span>: <span style="color: #00aa00">Manual proxy configuration</span> ◀ 
+<span style="color: #5c5cff">┃   </span>loaded from the YAML file "config/03/config.yml" (⏳ No proxy)
+<span style="color: #5c5cff">┗━━ </span>📂 Manual proxy configuration
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📂 HTTP Proxy
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">HTTP address</span>: <span style="color: #00aa00">example.net</span> ◀ loaded from the YAML file 
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┃   </span>"config/03/config.yml"
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📓 <span style="color: #ff0000">HTTP Port</span>: <span style="color: #ffd700">8080</span>
 </pre>
 #### Output when invalid user datas is an error

@ -205,10 +214,10 @@ rougail -m firefox/ -u yaml -yf config/03/config.yml
 rougail -m firefox/ -u yaml -yf config/03/config.yml --cli.invalid_user_datas_error
 ```
 <pre><span style="font-weight: bold; color: #ff0000">🛑 ERRORS</span>
-<span style="color: #ff0000">┗━━ </span>the value "not a valid domain name" is an invalid domain name for 
-<span style="color: #ff0000">    </span>"manual.http_proxy.address" (HTTP address), must have dot, it will be 
-<span style="color: #ff0000">    </span>ignored when loading from the YAML file "config/03/config.yml"
+<span style="color: #ff0000">┗━━ </span>the value "100000" is an invalid port for "manual.http_proxy.port" (HTTP 
+<span style="color: #ff0000">    </span>Port), must be between 1 and 65535, it will be ignored when loading from the
+<span style="color: #ff0000">    </span>YAML file "config/03/config.yml"
 </pre>


- [[tutorial v1.1_032] A variable with type "port"](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_032/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_032~1..v1.1_032))
+- [[tutorial v1.1_033] A variable with type "boolean"](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_033/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_033~1..v1.1_033))
--- a/config/01/config.yml
+++ b/config/01/config.yml
@ -1,4 +1,5 @@
 ---
+proxy_mode: Manual proxy configuration
 manual:
  http_proxy:
    address: example.net
--- a/config/01/output_ro.html
+++ b/config/01/output_ro.html
@ -1,11 +1,14 @@
-<pre>╭───────────────────── Caption ─────────────────────╮
-│ Variable                           <span style="color: #ffd700">Default value</span>  │
-│ <span style="color: #ff0000">Undocumented but modified variable</span> <span style="color: #00aa00">Modified value</span> │
-╰───────────────────────────────────────────────────╯
+<pre>╭─────────────────────────── Caption ────────────────────────────╮
+│ Variable                           <span style="color: #ffd700">Default value</span>               │
+│ <span style="color: #ff0000">Undocumented but modified variable</span> <span style="color: #00aa00">Modified value</span>              │
+│                                    (⏳ Original default value) │
+╰────────────────────────────────────────────────────────────────╯
 Variables:
-<span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">Configure Proxy Access to the Internet</span>: <span style="color: #ffd700">No proxy</span>
+<span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">Configure Proxy Access to the Internet</span>: <span style="color: #00aa00">Manual proxy configuration</span> ◀ 
+<span style="color: #5c5cff">┃   </span>loaded from the YAML file "config/01/config.yml" (⏳ No proxy)
 <span style="color: #5c5cff">┗━━ </span>📂 Manual proxy configuration
 <span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📂 HTTP Proxy
-<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📓 <span style="color: #ff0000">HTTP address</span>: <span style="color: #00aa00">example.net</span> ◀ loaded from the YAML file 
-<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span>"config/01/config.yml"
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">HTTP address</span>: <span style="color: #00aa00">example.net</span> ◀ loaded from the YAML file 
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┃   </span>"config/01/config.yml"
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📓 <span style="color: #ff0000">HTTP Port</span>: <span style="color: #ffd700">8080</span>
 </pre>
--- a/config/02/cmd_invalid.txt
+++ b/config/02/cmd_invalid.txt
@ -1 +0,0 @@
-rougail -m firefox/ -u yaml -yf config/02/config.yml --cli.invalid_user_datas_error
--- a/config/02/config.yml
+++ b/config/02/config.yml
@ -1,4 +1,6 @@
 ---
+proxy_mode: Manual proxy configuration
 manual:
  http_proxy:
-    address: 192.168.0.1
+    address: example.net
+    port: 3128
--- a/config/02/output_invalid.html
+++ b/config/02/output_invalid.html
@ -1,11 +0,0 @@
-<pre>╭───────────────────── Caption ─────────────────────╮
-│ Variable                           <span style="color: #ffd700">Default value</span>  │
-│ <span style="color: #ff0000">Undocumented but modified variable</span> <span style="color: #00aa00">Modified value</span> │
-╰───────────────────────────────────────────────────╯
-Variables:
-<span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">Configure Proxy Access to the Internet</span>: <span style="color: #ffd700">No proxy</span>
-<span style="color: #5c5cff">┗━━ </span>📂 Manual proxy configuration
-<span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📂 HTTP Proxy
-<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📓 <span style="color: #ff0000">HTTP address</span>: <span style="color: #00aa00">192.168.0.1</span> ◀ loaded from the YAML file 
-<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span>"config/02/config.yml"
-</pre>
--- a/config/02/output_ro.html
+++ b/config/02/output_ro.html
@ -1,11 +1,14 @@
-<pre>╭───────────────────── Caption ─────────────────────╮
-│ Variable                           <span style="color: #ffd700">Default value</span>  │
-│ <span style="color: #ff0000">Undocumented but modified variable</span> <span style="color: #00aa00">Modified value</span> │
-╰───────────────────────────────────────────────────╯
+<pre>╭─────────────────────────── Caption ────────────────────────────╮
+│ Variable                           <span style="color: #00aa00">Modified value</span>              │
+│ <span style="color: #ff0000">Undocumented but modified variable</span> (⏳ Original default value) │
+╰────────────────────────────────────────────────────────────────╯
 Variables:
-<span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">Configure Proxy Access to the Internet</span>: <span style="color: #ffd700">No proxy</span>
+<span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">Configure Proxy Access to the Internet</span>: <span style="color: #00aa00">Manual proxy configuration</span> ◀ 
+<span style="color: #5c5cff">┃   </span>loaded from the YAML file "config/02/config.yml" (⏳ No proxy)
 <span style="color: #5c5cff">┗━━ </span>📂 Manual proxy configuration
 <span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📂 HTTP Proxy
-<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📓 <span style="color: #ff0000">HTTP address</span>: <span style="color: #00aa00">192.168.0.1</span> ◀ loaded from the YAML file 
-<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span>"config/02/config.yml"
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">HTTP address</span>: <span style="color: #00aa00">example.net</span> ◀ loaded from the YAML file 
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┃   </span>"config/02/config.yml"
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📓 <span style="color: #ff0000">HTTP Port</span>: <span style="color: #00aa00">3128</span> ◀ loaded from the YAML file 
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span>"config/02/config.yml" (⏳ 8080)
 </pre>
--- a/config/03/config.yml
+++ b/config/03/config.yml
@ -1,4 +1,6 @@
 ---
+proxy_mode: Manual proxy configuration
 manual:
  http_proxy:
-    address: not a valid domain name
+    address: example.net
+    port: 100000
--- a/config/03/output_invalid.html
+++ b/config/03/output_invalid.html
@ -1,5 +1,5 @@
 <pre><span style="font-weight: bold; color: #ff0000">🛑 ERRORS</span>
-<span style="color: #ff0000">┗━━ </span>the value "not a valid domain name" is an invalid domain name for 
-<span style="color: #ff0000">    </span>"manual.http_proxy.address" (HTTP address), must have dot, it will be 
-<span style="color: #ff0000">    </span>ignored when loading from the YAML file "config/03/config.yml"
+<span style="color: #ff0000">┗━━ </span>the value "100000" is an invalid port for "manual.http_proxy.port" (HTTP 
+<span style="color: #ff0000">    </span>Port), must be between 1 and 65535, it will be ignored when loading from the
+<span style="color: #ff0000">    </span>YAML file "config/03/config.yml"
 </pre>
--- a/config/03/output_ro.html
+++ b/config/03/output_ro.html
@ -1,10 +1,18 @@
 <pre><span style="font-weight: bold; color: #ffff00">🔔 WARNINGS</span>
-<span style="color: #ffff00">┗━━ </span>the value "not a valid domain name" is an invalid domain name for 
-<span style="color: #ffff00">    </span>"manual.http_proxy.address" (HTTP address), must have dot, it will be 
-<span style="color: #ffff00">    </span>ignored when loading from the YAML file "config/03/config.yml"
-<span style="font-weight: bold; color: #ff0000">🛑 ERRORS</span>
-<span style="color: #ff0000">┗━━ </span>The following variables are mandatory but have no value:
-<span style="color: #ff0000">    </span><span style="color: #ff0000">┗━━ </span>Manual proxy configuration
-<span style="color: #ff0000">    </span><span style="color: #ff0000">    </span><span style="color: #ff0000">┗━━ </span>HTTP Proxy
-<span style="color: #ff0000">    </span><span style="color: #ff0000">    </span><span style="color: #ff0000">    </span><span style="color: #ff0000">┗━━ </span>HTTP address
+<span style="color: #ffff00">┗━━ </span>the value "100000" is an invalid port for "manual.http_proxy.port" (HTTP 
+<span style="color: #ffff00">    </span>Port), must be between 1 and 65535, it will be ignored when loading from the
+<span style="color: #ffff00">    </span>YAML file "config/03/config.yml"
+╭─────────────────────────── Caption ────────────────────────────╮
+│ Variable                           <span style="color: #ffd700">Default value</span>               │
+│ <span style="color: #ff0000">Undocumented but modified variable</span> <span style="color: #00aa00">Modified value</span>              │
+│                                    (⏳ Original default value) │
+╰────────────────────────────────────────────────────────────────╯
+Variables:
+<span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">Configure Proxy Access to the Internet</span>: <span style="color: #00aa00">Manual proxy configuration</span> ◀ 
+<span style="color: #5c5cff">┃   </span>loaded from the YAML file "config/03/config.yml" (⏳ No proxy)
+<span style="color: #5c5cff">┗━━ </span>📂 Manual proxy configuration
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📂 HTTP Proxy
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┣━━ </span>📓 <span style="color: #ff0000">HTTP address</span>: <span style="color: #00aa00">example.net</span> ◀ loaded from the YAML file 
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┃   </span>"config/03/config.yml"
+<span style="color: #5c5cff">    </span><span style="color: #5c5cff">    </span><span style="color: #5c5cff">┗━━ </span>📓 <span style="color: #ff0000">HTTP Port</span>: <span style="color: #ffd700">8080</span>
 </pre>
--- a/tree.html
+++ b/tree.html
@ -25,10 +25,10 @@
 </head>
 <body>
 	<h1>Directory Tree</h1><p>
-	<a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_031/./">.</a><br>
-	└── <a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_031/./firefox/">firefox</a><br>
-	&nbsp;&nbsp;&nbsp; ├── <a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_031/./firefox/00-proxy.yml">00-proxy.yml</a><br>
-	&nbsp;&nbsp;&nbsp; └── <a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_031/./firefox/10-manual.yml">10-manual.yml</a><br>
+	<a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_032/./">.</a><br>
+	└── <a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_032/./firefox/">firefox</a><br>
+	&nbsp;&nbsp;&nbsp; ├── <a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_032/./firefox/00-proxy.yml">00-proxy.yml</a><br>
+	&nbsp;&nbsp;&nbsp; └── <a href="https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_032/./firefox/10-manual.yml">10-manual.yml</a><br>
 <br><br><p>

 2 directories, 2 files
				`@ -1 +0,0 @@`
				`rougail -m firefox/ -u yaml -yf config/02/config.yml --cli.invalid_user_datas_error`