2024-09-07 19:06:25 +02:00
---
gitea: none
include_toc: true
---
# Summary
2024-09-07 19:06:26 +02:00
- [[tutorial 001] An empty file](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_001/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_001~1..v1.1_001))
2024-09-07 19:06:27 +02:00
- [[tutorial 002] A first variable](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_002/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_002~1..v1.1_002))
2024-09-07 19:06:28 +02:00
- [[tutorial 003] A first variable](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_003/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_003~1..v1.1_003))
2024-09-07 19:06:29 +02:00
- [[tutorial 004] The variable description](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_004/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_004~1..v1.1_004))
2024-09-07 19:06:30 +02:00
- [[tutorial 005] A default value](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_005/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_005~1..v1.1_005))
2024-09-07 19:06:31 +02:00
- [[tutorial 006] A variable with type choice](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_006/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_006~1..v1.1_006))
2024-09-07 19:06:32 +02:00
- [[tutorial 007] Choice type is optional](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_007/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_007~1..v1.1_007))
2024-09-07 19:06:32 +02:00
- [[tutorial 010] A family](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_010/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_010~1..v1.1_010))
2024-09-07 19:06:33 +02:00
- [[tutorial 011] Conditional desactived family](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_011/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_011~1..v1.1_011))
2024-09-07 19:06:34 +02:00
- [[tutorial 012] Conditional desactived family](https://forge.cloud.silique.fr/stove/rougail-tutorials/src/commit/v1.1_012/README.md) ([diff](https://forge.cloud.silique.fr/stove/rougail-tutorials/compare/v1.1_012~1..v1.1_012))
2024-09-07 19:06:25 +02:00
# Description
< img src = "firefox.png" width = 50% height = 50% alt = "Firefox Proxy setting" / >
2024-09-07 19:06:33 +02:00
Conditional desactived family
2024-09-07 19:06:27 +02:00
2024-09-07 19:06:33 +02:00
This family will be desactived if "proxy_mode" is not "manual proxy configuration".
2024-09-07 19:06:32 +02:00
2024-09-07 19:06:33 +02:00
Desactived a variable or a family means that this variable will never be accessible.
2024-09-07 19:06:25 +02:00
# Structure
2024-09-07 19:06:26 +02:00
## firefox/00-proxy.yml
```yml
---
2024-09-07 19:06:28 +02:00
proxy_mode:
2024-09-07 19:06:29 +02:00
description: Configure Proxy Access to the Internet
2024-09-07 19:06:31 +02:00
choices:
- No proxy
- Auto-detect proxy settings for this network
- Use system proxy settings
- Manual proxy configuration
- Automatic proxy configuration URL
2024-09-07 19:06:30 +02:00
default: No proxy
2024-09-07 19:06:26 +02:00
2024-09-07 19:06:32 +02:00
```
## firefox/10-manual.yml
```yml
---
manual:
description: Manual proxy configuration
type: family
2024-09-07 19:06:33 +02:00
disabled:
variable: proxy_mode
when_not: 'Manual proxy configuration'
2024-09-07 19:06:32 +02:00
2024-09-07 19:06:26 +02:00
```
## Generated documentation
```console
foo@bar:~$ rougail -v 1.1 -m firefox/ -o doc -do github
```
2024-09-07 19:06:28 +02:00
### Variables
2024-09-07 19:06:31 +02:00
| Variable | Description |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **proxy_mode** < br /> [`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` | Configure Proxy Access to the Internet.< br /> **Choices**: < br /> - No proxy ← (default)< br /> - Auto-detect proxy settings for this network< br /> - Use system proxy settings< br /> - Manual proxy configuration< br /> - Automatic proxy configuration URL |
2024-09-07 19:06:28 +02:00
# User data
## Example 1
### config/01/config.yaml
```yml
---
```
### Output
```console
foo@bar:~$ rougail -v 1.1 -m firefox -u file -ff config/01/config.yaml
```
2024-09-07 19:06:30 +02:00
< pre > ╭────────────────────────── Caption ──────────────────────────╮
│ Variable < span style = "color: #ffd700 " > Default value</ span > │
│ < span style = "color: #5c5cff " > Undocumented variable</ span > Modified value │
│ < span style = "color: #ff0000 " > Undocumented but modified variable</ span > (< span style = "color: #00aa00 " > Original default value</ span > ) │
│ < span style = "color: #ffaf00 " > Unmodifiable variable</ span > │
╰─────────────────────────────────────────────────────────────╯
Variables:
< span style = "color: #5c5cff " > ┗━━ </ span > 📓 proxy_mode: < span style = "color: #ffd700 " > No proxy</ span >
2024-09-07 19:06:28 +02:00
< / pre >
## Example 2
### config/02/config.yaml
```yml
---
2024-09-07 19:06:32 +02:00
proxy_mode: Manual proxy configuration
2024-09-07 19:06:28 +02:00
```
### Output
```console
foo@bar:~$ rougail -v 1.1 -m firefox -u file -ff config/02/config.yaml
```
< pre > ╭────────────────────────── Caption ──────────────────────────╮
│ Variable < span style = "color: #ffd700 " > Default value</ span > │
│ < span style = "color: #5c5cff " > Undocumented variable</ span > Modified value │
│ < span style = "color: #ff0000 " > Undocumented but modified variable</ span > (< span style = "color: #00aa00 " > Original default value</ span > ) │
│ < span style = "color: #ffaf00 " > Unmodifiable variable</ span > │
╰─────────────────────────────────────────────────────────────╯
Variables:
2024-09-07 19:06:32 +02:00
< span style = "color: #5c5cff " > ┗━━ </ span > 📓 proxy_mode: Manual proxy configuration (< span style = "color: #00aa00 " > No proxy</ span > )
2024-09-07 19:06:28 +02:00
< / pre >
## Example 3
### config/03/config.yaml
```yml
---
proxy_mode: Manual proxy configuration
2024-09-07 19:06:32 +02:00
manual:
http_proxy:
address: example.net
2024-09-07 19:06:28 +02:00
```
### Output
```console
foo@bar:~$ rougail -v 1.1 -m firefox -u file -ff config/03/config.yaml
```
2024-09-07 19:06:32 +02:00
< pre > 🛑 ERRORS
< span style = "color: #ff0000 " > ┗━━ </ span > unknown option "manual" in root optiondescription
╭────────────────────────── Caption ──────────────────────────╮
2024-09-07 19:06:28 +02:00
│ Variable < span style = "color: #ffd700 " > Default value</ span > │
│ < span style = "color: #5c5cff " > Undocumented variable</ span > Modified value │
│ < span style = "color: #ff0000 " > Undocumented but modified variable</ span > (< span style = "color: #00aa00 " > Original default value</ span > ) │
│ < span style = "color: #ffaf00 " > Unmodifiable variable</ span > │
╰─────────────────────────────────────────────────────────────╯
Variables:
2024-09-07 19:06:30 +02:00
< span style = "color: #5c5cff " > ┗━━ </ span > 📓 proxy_mode: Manual proxy configuration (< span style = "color: #00aa00 " > No proxy</ span > )
2024-09-07 19:06:28 +02:00
< / pre >
2024-09-07 19:06:32 +02:00
### Output in read write mode
```console
foo@bar:~$ rougail -v 1.1 -m firefox -u file -ff config/03/config.yaml --exporter.read_write
```
< pre > 🛑 ERRORS
< span style = "color: #ff0000 " > ┗━━ </ span > unknown option "manual" in root optiondescription
╭────────────────────────── Caption ──────────────────────────╮
│ Variable < span style = "color: #ffd700 " > Default value</ span > │
│ < span style = "color: #5c5cff " > Undocumented variable</ span > Modified value │
│ < span style = "color: #ff0000 " > Undocumented but modified variable</ span > (< span style = "color: #00aa00 " > Original default value</ span > ) │
╰─────────────────────────────────────────────────────────────╯
Variables:
< span style = "color: #5c5cff " > ┗━━ </ span > 📓 proxy_mode: Manual proxy configuration (< span style = "color: #00aa00 " > No proxy</ span > )
< / pre >
2024-09-07 19:06:28 +02:00
## Example 4
### config/04/config.yaml
```yml
---
2024-09-07 19:06:32 +02:00
proxy_mode: Manual proxy configuration
manual:
http_proxy:
address: example.net
port: '3128'
2024-09-07 19:06:28 +02:00
```
### Output
```console
foo@bar:~$ rougail -v 1.1 -m firefox -u file -ff config/04/config.yaml
```
2024-09-07 19:06:31 +02:00
< pre > 🛑 ERRORS
2024-09-07 19:06:32 +02:00
< span style = "color: #ff0000 " > ┗━━ </ span > unknown option "manual" in root optiondescription
2024-09-07 19:06:31 +02:00
╭────────────────────────── Caption ──────────────────────────╮
2024-09-07 19:06:28 +02:00
│ Variable < span style = "color: #ffd700 " > Default value</ span > │
│ < span style = "color: #5c5cff " > Undocumented variable</ span > Modified value │
│ < span style = "color: #ff0000 " > Undocumented but modified variable</ span > (< span style = "color: #00aa00 " > Original default value</ span > ) │
╰─────────────────────────────────────────────────────────────╯
Variables:
2024-09-07 19:06:32 +02:00
< span style = "color: #5c5cff " > ┗━━ </ span > 📓 proxy_mode: Manual proxy configuration (< span style = "color: #00aa00 " > No proxy</ span > )
2024-09-07 19:06:28 +02:00
< / pre >
## Example 5
### config/05/config.yaml
```yml
---
2024-09-07 19:06:32 +02:00
proxy_mode: Manual proxy configuration
manual:
http_proxy:
address: http.proxy.net
port: '3128'
use_for_https: false
https_proxy:
address: https.proxy.net
2024-09-07 19:06:28 +02:00
```
### Description
2024-09-07 19:06:32 +02:00
If "use_for_https" is false, HTTPS variables are visible in read only mode and in read write mode.
2024-09-07 19:06:28 +02:00
### Output
```console
foo@bar:~$ rougail -v 1.1 -m firefox -u file -ff config/05/config.yaml
```
< pre > 🛑 ERRORS
2024-09-07 19:06:32 +02:00
< span style = "color: #ff0000 " > ┗━━ </ span > unknown option "manual" in root optiondescription
2024-09-07 19:06:30 +02:00
╭────────────────────────── Caption ──────────────────────────╮
│ Variable < span style = "color: #ffd700 " > Default value</ span > │
│ < span style = "color: #5c5cff " > Undocumented variable</ span > Modified value │
│ < span style = "color: #ff0000 " > Undocumented but modified variable</ span > (< span style = "color: #00aa00 " > Original default value</ span > ) │
╰─────────────────────────────────────────────────────────────╯
Variables:
2024-09-07 19:06:32 +02:00
< span style = "color: #5c5cff " > ┗━━ </ span > 📓 proxy_mode: Manual proxy configuration (< span style = "color: #00aa00 " > No proxy</ span > )
2024-09-07 19:06:28 +02:00
< / pre >