diff --git a/README.md b/README.md index 77e2ed59..e0b4adbd 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,9 @@ - [Summary](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/branch/1.1/README.md) -- [[tutorial v1.1_025] A variable with type "port"](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_025/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_025~1..v1.1_025)) +- [[tutorial v1.1_026] A variable with type "boolean"](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_026/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_026~1..v1.1_026)) -# [tutorial v1.1_026)] A variable with type "boolean" +# [tutorial v1.1_027)] Copy HTTP manual proxy to HTTPS manual proxy -[View the diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_026~1..v1.1_026) +[View the diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_027~1..v1.1_027) ## Screenshot @@ -71,13 +71,26 @@ version: 1.1 manual: use_for_https: true # Also use this proxy for HTTPS + + https_proxy: # HTTPS Proxy + + address: + description: HTTPS address + type: domainname + params: + allow_ip: true + + port: + description: HTTPS Port + type: port + default: 8080 ... ``` ### Let's generate the documentation ```console -foo@bar:~$ git switch --detach v1.1_026 +foo@bar:~$ git switch --detach v1.1_027 foo@bar:~$ rougail -m firefox/ -o doc ``` | Variable                                                                                        | Description                                                                                     | @@ -105,17 +118,29 @@ foo@bar:~$ rougail -m firefox/ -o doc |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **manual.use_for_https**
[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | Also use this proxy for HTTPS.
**Default**: true | +##### HTTPS Proxy + +**manual.https_proxy** + + + +| Variable                                                                                            | Description                                                                                         | +|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| **manual.https_proxy.address**
[`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | HTTPS address.
**Validator**: the domain name can be an IP | +| **manual.https_proxy.port**
[`port`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | HTTPS Port.
**Validators**:
- well-known ports (1 to 1023) are allowed
- registred ports (1024 to 49151) are allowed
- private ports (greater than 49152) are allowed
**Default**: 8080 | + ### Let's generate the changelog ```console -foo@bar:~$ git switch --detach v1.1_026 +foo@bar:~$ git switch --detach v1.1_027 foo@bar:~$ rougail -m firefox/ -o doc --doc.contents changelog ``` -#### New variable +#### New variables -| Variable                                                                                         | Description                                                                                      | -|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| **manual.use_for_https**
[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | Also use this proxy for HTTPS.
**Default**: true | +| Variable                                                                                            | Description                                                                                         | +|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| **manual.https_proxy.address**
[`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | HTTPS address.
**Validator**: the domain name can be an IP | +| **manual.https_proxy.port**
[`port`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | HTTPS Port.
**Validators**:
- well-known ports (1 to 1023) are allowed
- registred ports (1024 to 49151) are allowed
- private ports (greater than 49152) are allowed
**Default**: 8080 | ## User datas @@ -132,14 +157,16 @@ foo@bar:~$ rougail -m firefox/ -o doc --doc.contents changelog #### Output ```console -foo@bar:~$ git switch --detach v1.1_026 +foo@bar:~$ git switch --detach v1.1_027 foo@bar:~$ rougail -m firefox/ -u yaml -ff config/01/config.yaml ```
🛑 ERRORS
 ┗━━ The following variables are mandatory but have no value:
     ┗━━ Manual proxy configuration
-        ┗━━ HTTP Proxy
-            ┗━━ HTTP address
+        ┣━━ HTTP Proxy
+        ┗━━ HTTP address
+        ┗━━ HTTPS Proxy
+            ┗━━ HTTPS address
 
### Example 2 @@ -154,14 +181,16 @@ proxy_mode: No proxy #### Output ```console -foo@bar:~$ git switch --detach v1.1_026 +foo@bar:~$ git switch --detach v1.1_027 foo@bar:~$ rougail -m firefox/ -u yaml -ff config/02/config.yaml ```
🛑 ERRORS
 ┗━━ The following variables are mandatory but have no value:
     ┗━━ Manual proxy configuration
-        ┗━━ HTTP Proxy
-            ┗━━ HTTP address
+        ┣━━ HTTP Proxy
+        ┗━━ HTTP address
+        ┗━━ HTTPS Proxy
+            ┗━━ HTTPS address
 
### Example 3 @@ -176,14 +205,16 @@ proxy_mode: Manual proxy configuration #### Output ```console -foo@bar:~$ git switch --detach v1.1_026 +foo@bar:~$ git switch --detach v1.1_027 foo@bar:~$ rougail -m firefox/ -u yaml -ff config/03/config.yaml ```
🛑 ERRORS
 ┗━━ The following variables are mandatory but have no value:
     ┗━━ Manual proxy configuration
-        ┗━━ HTTP Proxy
-            ┗━━ HTTP address
+        ┣━━ HTTP Proxy
+        ┗━━ HTTP address
+        ┗━━ HTTPS Proxy
+            ┗━━ HTTPS address
 
### Example 4 @@ -198,7 +229,7 @@ proxy_mode: foo #### Output ```console -foo@bar:~$ git switch --detach v1.1_026 +foo@bar:~$ git switch --detach v1.1_027 foo@bar:~$ rougail -m firefox/ -u yaml -ff config/04/config.yaml ```
🔔 WARNINGS
@@ -207,8 +238,10 @@ foo@bar:~$ rougail -m firefox/ -u yaml -ff config/04/config.yaml
 🛑 ERRORS
 ┗━━ The following variables are mandatory but have no value:
     ┗━━ Manual proxy configuration
-        ┗━━ HTTP Proxy
-            ┗━━ HTTP address
+        ┣━━ HTTP Proxy
+        ┗━━ HTTP address
+        ┗━━ HTTPS Proxy
+            ┗━━ HTTPS address
 
### Example 5 @@ -223,7 +256,7 @@ proxy_mode: 1 #### Output ```console -foo@bar:~$ git switch --detach v1.1_026 +foo@bar:~$ git switch --detach v1.1_027 foo@bar:~$ rougail -m firefox/ -u yaml -ff config/05/config.yaml ```
🔔 WARNINGS
@@ -232,9 +265,11 @@ foo@bar:~$ rougail -m firefox/ -u yaml -ff config/05/config.yaml
 🛑 ERRORS
 ┗━━ The following variables are mandatory but have no value:
     ┗━━ Manual proxy configuration
-        ┗━━ HTTP Proxy
-            ┗━━ HTTP address
+        ┣━━ HTTP Proxy
+        ┗━━ HTTP address
+        ┗━━ HTTPS Proxy
+            ┗━━ HTTPS address
 
-- [[tutorial v1.1_027] Copy HTTP manual proxy to HTTPS manual proxy](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_027/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_027~1..v1.1_027)) +- [[tutorial v1.1_030] A disabled family](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)) diff --git a/config/01/output_ro.html b/config/01/output_ro.html index ec666c15..45e42766 100644 --- a/config/01/output_ro.html +++ b/config/01/output_ro.html @@ -1,6 +1,8 @@
🛑 ERRORS
 ┗━━ The following variables are mandatory but have no value:
     ┗━━ Manual proxy configuration
-        ┗━━ HTTP Proxy
-            ┗━━ HTTP address
+        ┣━━ HTTP Proxy
+        ┗━━ HTTP address
+        ┗━━ HTTPS Proxy
+            ┗━━ HTTPS address
 
diff --git a/config/02/output_ro.html b/config/02/output_ro.html index ec666c15..45e42766 100644 --- a/config/02/output_ro.html +++ b/config/02/output_ro.html @@ -1,6 +1,8 @@
🛑 ERRORS
 ┗━━ The following variables are mandatory but have no value:
     ┗━━ Manual proxy configuration
-        ┗━━ HTTP Proxy
-            ┗━━ HTTP address
+        ┣━━ HTTP Proxy
+        ┗━━ HTTP address
+        ┗━━ HTTPS Proxy
+            ┗━━ HTTPS address
 
diff --git a/config/03/output_ro.html b/config/03/output_ro.html index ec666c15..45e42766 100644 --- a/config/03/output_ro.html +++ b/config/03/output_ro.html @@ -1,6 +1,8 @@
🛑 ERRORS
 ┗━━ The following variables are mandatory but have no value:
     ┗━━ Manual proxy configuration
-        ┗━━ HTTP Proxy
-            ┗━━ HTTP address
+        ┣━━ HTTP Proxy
+        ┗━━ HTTP address
+        ┗━━ HTTPS Proxy
+            ┗━━ HTTPS address
 
diff --git a/config/04/output_ro.html b/config/04/output_ro.html index 82882481..9ec69044 100644 --- a/config/04/output_ro.html +++ b/config/04/output_ro.html @@ -4,6 +4,8 @@ 🛑 ERRORS ┗━━ The following variables are mandatory but have no value: ┗━━ Manual proxy configuration - ┗━━ HTTP Proxy - ┗━━ HTTP address + ┣━━ HTTP Proxy + ┗━━ HTTP address + ┗━━ HTTPS Proxy + ┗━━ HTTPS address diff --git a/config/05/output_ro.html b/config/05/output_ro.html index 1c53cef3..498a23ea 100644 --- a/config/05/output_ro.html +++ b/config/05/output_ro.html @@ -4,6 +4,8 @@ 🛑 ERRORS ┗━━ The following variables are mandatory but have no value: ┗━━ Manual proxy configuration - ┗━━ HTTP Proxy - ┗━━ HTTP address + ┣━━ HTTP Proxy + ┗━━ HTTP address + ┗━━ HTTPS Proxy + ┗━━ HTTPS address