stove/rougail-output-doc
2
0
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity

feat: document commandline and environment variable

Browse source
This commit is contained in:
egarette@silique.fr 2025-11-27 22:17:17 +01:00
parent 2b9c251780
commit 77e311dedf
23 changed files with 629 additions and 264 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

43
README.md
View file

@ -1,2 +1,43 @@
# rougaildoc # Generate documentation
> **🛈 Informations**
>
> **<a id="doc" name="doc">doc</a>**\
> `basic` *`disabled`*\
> **Disabled**: when "[Generate documentation](#doc)" is not set in "[Select for output](#step.output)"
| Variable&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | Description&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **<a id="doc.title_level" name="doc.title_level">doc.title_level</a>**<br/>[`integer`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`<br/>**Command line**: <a id="doc.title_level" name="doc.title_level">--doc.title_level</a>, -dt<br/>**Environment variable**: <a id="doc.title_level" name="doc.title_level">ROUGAILCLI_DOC.TITLE_LEVEL</a> | Starting title level.<br/>**Default**: 1 |
| **<a id="doc.contents" name="doc.contents">doc.contents</a>**<br/>[`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`<br/>**Command line**: <a id="doc.contents" name="doc.contents">--doc.contents</a><br/>**Environment variable**: <a id="doc.contents" name="doc.contents">ROUGAILCLI_DOC.CONTENTS</a> | Generated content.<br/>**Choices**: <br/>• variables **← (default)**<br/>• example<br/>• changelog |
| **<a id="doc.previous_json_file" name="doc.previous_json_file">doc.previous_json_file</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory` *`disabled`*<br/>**Command line**: <a id="doc.previous_json_file" name="doc.previous_json_file">--doc.previous_json_file</a><br/>**Environment variable**: <a id="doc.previous_json_file" name="doc.previous_json_file">ROUGAILCLI_DOC.PREVIOUS_JSON_FILE</a> | Previous description file in JSON format.<br/>**Disabled**: changelog is not selected in "[Generated content](#doc.contents)" |
| **<a id="doc.without_family" name="doc.without_family">doc.without_family</a>**<br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*<br/>**Command line**: <br/>• <a id="doc.without_family" name="doc.without_family">--doc.without_family</a><br/>• <a id="doc.without_family" name="doc.without_family">--doc.no-without_family</a><br/>**Environment variable**: <a id="doc.without_family" name="doc.without_family">ROUGAILCLI_DOC.WITHOUT_FAMILY</a> | Do not add families in documentation.<br/>**Default**: false<br/>**Disabled**: variables is not selected in "[Generated content](#doc.contents)" |
| **<a id="doc.root" name="doc.root">doc.root</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard`<br/>**Command line**: <a id="doc.root" name="doc.root">--doc.root</a><br/>**Environment variable**: <a id="doc.root" name="doc.root">ROUGAILCLI_DOC.ROOT</a> | Document the variables from this family. |
| **<a id="doc.with_commandline" name="doc.with_commandline">doc.with_commandline</a>**<br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*<br/>**Command line**: <br/>• <a id="doc.with_commandline" name="doc.with_commandline">--doc.with_commandline</a><br/>• <a id="doc.with_commandline" name="doc.with_commandline">--doc.no-with_commandline</a><br/>**Environment variable**: <a id="doc.with_commandline" name="doc.with_commandline">ROUGAILCLI_DOC.WITH_COMMANDLINE</a> | Add command line informations in documentation.<br/>**Default**: false<br/>**Disabled**: if "[Generate document in format](#doc.output_format)" is json or variables is not selected in "[Generated content](#doc.contents)" |
| **<a id="doc.with_environment" name="doc.with_environment">doc.with_environment</a>**<br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*<br/>**Command line**: <br/>• <a id="doc.with_environment" name="doc.with_environment">--doc.with_environment</a><br/>• <a id="doc.with_environment" name="doc.with_environment">--doc.no-with_environment</a><br/>**Environment variable**: <a id="doc.with_environment" name="doc.with_environment">ROUGAILCLI_DOC.WITH_ENVIRONMENT</a> | Add environment variable informations in documentation.<br/>**Default**: false<br/>**Disabled**: if "[Generate document in format](#doc.output_format)" is json or variables is not selected in "[Generated content](#doc.contents)" |
| **<a id="doc.environment_default_environment_name" name="doc.environment_default_environment_name">doc.environment_default_environment_name</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*<br/>**Command line**: <a id="doc.environment_default_environment_name" name="doc.environment_default_environment_name">--doc.environment_default_environment_name</a><br/>**Environment variable**: <a id="doc.environment_default_environment_name" name="doc.environment_default_environment_name">ROUGAILCLI_DOC.ENVIRONMENT_DEFAULT_ENVIRONMENT_NAME</a> | Name of the default environment prefix.<br/>**Validator**: should only user uppercase characters<br/>**Default**: ROUGAIL<br/>**Disabled**: when "__.main_namespace" is not set or "[Add environment variable informations in documentation](#doc.with_environment)" is false |
# Families or variables for this family are in an other file name
> **🛈 Informations**
>
> **<a id="doc.other_root_filenames" name="doc.other_root_filenames">doc.other_root_filenames</a>**\
> This family contains lists of variable blocks.\
> `basic` *`disabled`*\
> **Disabled**: documentation must be splitted
| Variable&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | Description&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **<a id="doc.other_root_filenames.root_path" name="doc.other_root_filenames.root_path">doc.other_root_filenames.root_path</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `unique` `multiple`<br/>**Command line**: <a id="doc.other_root_filenames.root_path" name="doc.other_root_filenames.root_path">--doc.other_root_filenames.root_path</a><br/>**Environment variable**: <a id="doc.other_root_filenames.root_path" name="doc.other_root_filenames.root_path">ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.ROOT_PATH</a> | Root family name. |
| **<a id="doc.other_root_filenames.filename" name="doc.other_root_filenames.filename">doc.other_root_filenames.filename</a>**<br/>[`unix_filename`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory`<br/>**Command line**: <a id="doc.other_root_filenames.filename" name="doc.other_root_filenames.filename">--doc.other_root_filenames.filename</a><br/>**Environment variable**: <a id="doc.other_root_filenames.filename" name="doc.other_root_filenames.filename">ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.FILENAME</a> | Name of the file.<br/>**Validators**: <br/>• this filename could be a relative path<br/>• file type allowed: "directory" and "file" |
| Variable&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | Description&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **<a id="doc.disabled_modes" name="doc.disabled_modes">doc.disabled_modes</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` *`disabled`* `unique` `multiple`<br/>**Command line**: <a id="doc.disabled_modes" name="doc.disabled_modes">--doc.disabled_modes</a><br/>**Environment variable**: <a id="doc.disabled_modes" name="doc.disabled_modes">ROUGAILCLI_DOC.DISABLED_MODES</a> | Disable documentation for variables with those modes.<br/>**Validator**: verify if disable modes already exists<br/>**Disabled**: disabled when there is no mode available |
| **<a id="doc.change_default_value" name="doc.change_default_value">doc.change_default_value</a>**<br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`<br/>**Command line**: <br/>• <a id="doc.change_default_value" name="doc.change_default_value">--doc.change_default_value</a><br/>• <a id="doc.change_default_value" name="doc.change_default_value">--doc.no-change_default_value</a><br/>**Environment variable**: <a id="doc.change_default_value" name="doc.change_default_value">ROUGAILCLI_DOC.CHANGE_DEFAULT_VALUE</a> | Modify values to document leaderships and dynamics families.<br/>**Default**: true |
| **<a id="doc.comment_examples" name="doc.comment_examples">doc.comment_examples</a>**<br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*<br/>**Command line**: <br/>• <a id="doc.comment_examples" name="doc.comment_examples">--doc.comment_examples</a><br/>• <a id="doc.comment_examples" name="doc.comment_examples">--doc.no-comment_examples</a><br/>**Environment variable**: <a id="doc.comment_examples" name="doc.comment_examples">ROUGAILCLI_DOC.COMMENT_EXAMPLES</a> | Add description of variables and families when generate examples.<br/>**Default**: false<br/>**Disabled**: disabled when example in not in contents |
| **<a id="doc.comment_examples_column" name="doc.comment_examples_column">doc.comment_examples_column</a>**<br/>[`integer`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*<br/>**Command line**: <a id="doc.comment_examples_column" name="doc.comment_examples_column">--doc.comment_examples_column</a><br/>**Environment variable**: <a id="doc.comment_examples_column" name="doc.comment_examples_column">ROUGAILCLI_DOC.COMMENT_EXAMPLES_COLUMN</a> | Comment in examples starts at column.<br/>**Default**: 30<br/>**Disabled**: when the variable "[Add description of variables and families when generate examples](#doc.comment_examples)" is accessible and has the value "false" |
| **<a id="doc.output_format" name="doc.output_format">doc.output_format</a>**<br/>[`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`<br/>**Command line**: <a id="doc.output_format" name="doc.output_format">--doc.output_format</a>, -do<br/>**Environment variable**: <a id="doc.output_format" name="doc.output_format">ROUGAILCLI_DOC.OUTPUT_FORMAT</a> | Generate document in format.<br/>**Validator**: json output_format is not compatible with "changelog" and "example" contents<br/>**Choices**: <br/>• console **← (default)**<br/>• asciidoc<br/>• html<br/>• github<br/>• gitlab<br/>• json |
| **<a id="doc.force_true_color_terminal" name="doc.force_true_color_terminal">doc.force_true_color_terminal</a>**<br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`<br/>**Command line**: <br/>• <a id="doc.force_true_color_terminal" name="doc.force_true_color_terminal">--doc.force_true_color_terminal</a><br/>• <a id="doc.force_true_color_terminal" name="doc.force_true_color_terminal">--doc.no-force_true_color_terminal</a><br/>**Environment variable**: <a id="doc.force_true_color_terminal" name="doc.force_true_color_terminal">ROUGAILCLI_DOC.FORCE_TRUE_COLOR_TERMINAL</a> | Force true color terminal.<br/>**Default**: false |

292
locale/fr/LC_MESSAGES/rougail_output_doc.po
View file

@ -5,8 +5,8 @@
msgid "" msgid ""
msgstr "" msgstr ""
"Project-Id-Version: \n" "Project-Id-Version: \n"
"POT-Creation-Date: 2025-10-29 11:01+0100\n" "POT-Creation-Date: 2025-11-27 22:14+0100\n"
"PO-Revision-Date: 2025-10-29 11:02+0100\n" "PO-Revision-Date: 2025-11-27 22:14+0100\n"
"Last-Translator: \n" "Last-Translator: \n"
"Language-Team: \n" "Language-Team: \n"
"Language: fr\n" "Language: fr\n"
@ -14,128 +14,170 @@ msgstr ""
"Content-Type: text/plain; charset=UTF-8\n" "Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n" "Content-Transfer-Encoding: 8bit\n"
"Generated-By: pygettext.py 1.5\n" "Generated-By: pygettext.py 1.5\n"
"X-Generator: Poedit 3.7\n" "X-Generator: Poedit 3.8\n"
#: src/rougail/output_doc/annotator.py:325 #: src/rougail/output_doc/annotator.py:350
msgid "the value of the information \"{0}\" of the variable \"{1}\"" msgid "the value of the information \"{0}\" of the variable \"{1}\""
msgstr "la valeur de l'information \"{0}\" de la variable \"{1}\"" msgstr "la valeur de l'information \"{0}\" de la variable \"{1}\""
#: src/rougail/output_doc/annotator.py:328 #: src/rougail/output_doc/annotator.py:353
msgid "the value of the global information \"{0}\"" msgid "the value of the global information \"{0}\""
msgstr "la valeur de l'information globale \"{0}\"" msgstr "la valeur de l'information globale \"{0}\""
#: src/rougail/output_doc/annotator.py:335 #: src/rougail/output_doc/annotator.py:360
msgid "when the identifier is \"{0}\"" msgid "when the identifier is \"{0}\""
msgstr "lorsque l'identifiant est \"{0}\"" msgstr "lorsque l'identifiant est \"{0}\""
#: src/rougail/output_doc/annotator.py:337 #: src/rougail/output_doc/annotator.py:362
msgid "when the identifier is not \"{0}\"" msgid "when the identifier is not \"{0}\""
msgstr "lorsque l'identifiant n'est pas \"{0}\"" msgstr "lorsque l'identifiant n'est pas \"{0}\""
#: src/rougail/output_doc/changelog.py:144 #: src/rougail/output_doc/changelog.py:155
msgid "New variable" msgid "New variable"
msgstr "Nouvelle variable" msgstr "Nouvelle variable"
#: src/rougail/output_doc/changelog.py:146 #: src/rougail/output_doc/changelog.py:157
msgid "New variables" msgid "New variables"
msgstr "Nouvelles variables" msgstr "Nouvelles variables"
#: src/rougail/output_doc/changelog.py:158 #: src/rougail/output_doc/changelog.py:169
msgid "Modified variable" msgid "Modified variable"
msgstr "Variable modifiée" msgstr "Variable modifiée"
#: src/rougail/output_doc/changelog.py:160 #: src/rougail/output_doc/changelog.py:171
msgid "Modified variables" msgid "Modified variables"
msgstr "Variables modifiées" msgstr "Variables modifiées"
#: src/rougail/output_doc/changelog.py:172 #: src/rougail/output_doc/changelog.py:183
msgid "Deleted variable" msgid "Deleted variable"
msgstr "Variable supprimée" msgstr "Variable supprimée"
#: src/rougail/output_doc/changelog.py:174 #: src/rougail/output_doc/changelog.py:185
msgid "Deleted variables" msgid "Deleted variables"
msgstr "Variables supprimées" msgstr "Variables supprimées"
#: src/rougail/output_doc/config.py:43 #: src/rougail/output_doc/config.py:41
msgid "duplicated level rougail-doc for output \"{0}\": {1} and {2}" msgid "duplicated level rougail-doc for output \"{0}\": {1} and {2}"
msgstr "niveau dupliqué pour rougail-doc pour la sortie \"{0}\": {1} et {2}" msgstr "niveau dupliqué pour rougail-doc pour la sortie \"{0}\": {1} et {2}"
#: src/rougail/output_doc/config.py:75 #: src/rougail/output_doc/config.py:73
msgid "Configuration rougail-doc" msgid "Generate documentation"
msgstr "Configuration de rougail-doc" msgstr "Générer la documentation"
#: src/rougail/output_doc/config.py:83 #: src/rougail/output_doc/config.py:79
msgid "when \"doc\" is not set in \"step.output\""
msgstr "lorsque \"doc\" n'est pas spécifié dans \"step.output\""
#: src/rougail/output_doc/config.py:82
msgid "Starting title level" msgid "Starting title level"
msgstr "Niveau de titre de départ" msgstr "Niveau de titre de départ"
#: src/rougail/output_doc/config.py:88 #: src/rougail/output_doc/config.py:87
msgid "Generated content" msgid "Generated content"
msgstr "Contenu générer" msgstr "Contenu générer"
#: src/rougail/output_doc/config.py:97 #: src/rougail/output_doc/config.py:96
msgid "Previous description file in JSON format" msgid "Previous description file in JSON format"
msgstr "Précédent fichier de description au format JSON" msgstr "Précédent fichier de description au format JSON"
#: src/rougail/output_doc/config.py:105 #: src/rougail/output_doc/config.py:101
msgid "changelog is not selected in \"_.contents\""
msgstr "changelog n'est pas sélectionné dans \"_.contents\""
#: src/rougail/output_doc/config.py:104
msgid "Do not add families in documentation" msgid "Do not add families in documentation"
msgstr "Ne pas ajouter les familles dans la documentation" msgstr "Ne pas ajouter les familles dans la documentation"
#: src/rougail/output_doc/config.py:114 #: src/rougail/output_doc/config.py:110
msgid "variables is not selected in \"_.contents\""
msgstr "variables n'est pas sélectionné dans \"_.contents\""
#: src/rougail/output_doc/config.py:113
msgid "Document the variables from this family" msgid "Document the variables from this family"
msgstr "Documente les variables depuis cette famille" msgstr "Documente les variables depuis cette famille"
#: src/rougail/output_doc/config.py:118 #: src/rougail/output_doc/config.py:117
msgid "Add command line informations in documentation"
msgstr "Ajoute les informations de la ligne de commande dans la documentation"
#: src/rougail/output_doc/config.py:123 src/rougail/output_doc/config.py:132
msgid ""
"if \"_.output_format\" is json or variables is not selected in \"_.contents\""
msgstr ""
"si \"_.output_format\" est json ou si variables n'est pas sélectionné dans "
"\"_.contents\""
#: src/rougail/output_doc/config.py:126
msgid "Add environment variable informations in documentation"
msgstr ""
"Ajoute les informations de variable d'environnement dans la documentation"
#: src/rougail/output_doc/config.py:135
msgid "Name of the default environment prefix"
msgstr "Nom du préfixe d'environnement par défaut"
#: src/rougail/output_doc/config.py:141
msgid "should only user uppercase characters"
msgstr "doit seulement utilise des caractères en majuscule"
#: src/rougail/output_doc/config.py:146
msgid ""
"when \"__.main_namespace\" is not set or \"_.with_environment\" is false"
msgstr ""
"si \"__.main_namespace\" n'est pas défini ou \"_.with_environment\" est false"
#: src/rougail/output_doc/config.py:149
msgid "Families or variables for this family are in an other file name" msgid "Families or variables for this family are in an other file name"
msgstr "" msgstr ""
"Les familles ou variables pour cette famille sont dans un autre fichier" "Les familles ou variables pour cette famille sont dans un autre fichier"
#: src/rougail/output_doc/config.py:128 #: src/rougail/output_doc/config.py:156
msgid "documentation must be splitted and in gitlab format" msgid "documentation must be splitted"
msgstr "documentation doit être séparée et au format gitlab" msgstr "documentation doit être séparée"
#: src/rougail/output_doc/config.py:131 #: src/rougail/output_doc/config.py:159
msgid "Root family name" msgid "Root family name"
msgstr "Nom de la famille racine" msgstr "Nom de la famille racine"
#: src/rougail/output_doc/config.py:135 #: src/rougail/output_doc/config.py:163
msgid "Name of the file" msgid "Name of the file"
msgstr "Nom du fichier" msgstr "Nom du fichier"
#: src/rougail/output_doc/config.py:141 #: src/rougail/output_doc/config.py:169
msgid "Disable documentation for variables with those modes" msgid "Disable documentation for variables with those modes"
msgstr "Désactiver la documentation des variables avec ces modes" msgstr "Désactiver la documentation des variables avec ces modes"
#: src/rougail/output_doc/config.py:149 #: src/rougail/output_doc/config.py:177
msgid "disabled when there is no mode available" msgid "disabled when there is no mode available"
msgstr "désactiver lorsqu'il n'y a pas de mode valable" msgstr "désactiver lorsqu'il n'y a pas de mode valable"
#: src/rougail/output_doc/config.py:155 #: src/rougail/output_doc/config.py:183
msgid "verify if disable modes already exists" msgid "verify if disable modes already exists"
msgstr "vérifier le mode existe déjà" msgstr "vérifier le mode existe déjà"
#: src/rougail/output_doc/config.py:157 #: src/rougail/output_doc/config.py:185
msgid "Modify values to document leaderships and dynamics families" msgid "Modify values to document leaderships and dynamics families"
msgstr "Valeurs modifiées pour documenter les familles leader ou dynamique" msgstr "Valeurs modifiées pour documenter les familles leader ou dynamique"
#: src/rougail/output_doc/config.py:160 #: src/rougail/output_doc/config.py:188
msgid "Add description of variables and families when generate examples" msgid "Add description of variables and families when generate examples"
msgstr "" msgstr ""
"Ajouter la description des variables et des familles lorsqu'on génère des " "Ajouter la description des variables et des familles lorsqu'on génère des "
"exemples" "exemples"
#: src/rougail/output_doc/config.py:166 #: src/rougail/output_doc/config.py:194
msgid "disabled when example in not in contents" msgid "disabled when example in not in contents"
msgstr "désactiver lorsqu'il example n'est pas dans contents" msgstr "désactiver lorsqu'il example n'est pas dans contents"
#: src/rougail/output_doc/config.py:169 #: src/rougail/output_doc/config.py:197
msgid "Comment in examples starts at column" msgid "Comment in examples starts at column"
msgstr "Commentaire dans les exemples commence à la colonne" msgstr "Commentaire dans les exemples commence à la colonne"
#: src/rougail/output_doc/config.py:177 #: src/rougail/output_doc/config.py:205
msgid "Generate document in format" msgid "Generate document in format"
msgstr "Générer le document au format" msgstr "Générer le document au format"
#: src/rougail/output_doc/config.py:187 #: src/rougail/output_doc/config.py:215
msgid "" msgid ""
"json output_format is not compatible with \"changelog\" and \"example\" " "json output_format is not compatible with \"changelog\" and \"example\" "
"contents" "contents"
@ -143,107 +185,107 @@ msgstr ""
"le format de sortie json n'est pas compatible avec \"changelog\" et " "le format de sortie json n'est pas compatible avec \"changelog\" et "
"example\" de la variable contents" "example\" de la variable contents"
#: src/rougail/output_doc/config.py:196 #: src/rougail/output_doc/config.py:224
msgid "Force true color terminal" msgid "Force true color terminal"
msgstr "Force les vrais couleurs dans le terminal" msgstr "Force les vrais couleurs dans le terminal"
#: src/rougail/output_doc/doc.py:358 #: src/rougail/output_doc/doc.py:330
msgid "This family contains lists of variable blocks" msgid "This family contains lists of variable blocks"
msgstr "Cette famille contient des listes de bloc de variable" msgstr "Cette famille contient des listes de bloc de variable"
#: src/rougail/output_doc/doc.py:368 #: src/rougail/output_doc/doc.py:340
msgid "This family builds families dynamically" msgid "This family builds families dynamically"
msgstr "Cette famille construit des familles dynamiquement" msgstr "Cette famille construit des familles dynamiquement"
#: src/rougail/output_doc/doc.py:382 #: src/rougail/output_doc/doc.py:354
msgid "Default" msgid "Default"
msgstr "Défaut" msgstr "Défaut"
#: src/rougail/output_doc/doc.py:397 #: src/rougail/output_doc/doc.py:369
msgid "multiple" msgid "multiple"
msgstr "multiple" msgstr "multiple"
#: src/rougail/output_doc/doc.py:405 #: src/rougail/output_doc/doc.py:377
msgid "Example" msgid "Example"
msgstr "Exemple" msgstr "Exemple"
#: src/rougail/output_doc/doc.py:408 #: src/rougail/output_doc/doc.py:380
msgid "Examples" msgid "Examples"
msgstr "Exemples" msgstr "Exemples"
#: src/rougail/output_doc/doc.py:417 #: src/rougail/output_doc/doc.py:389
msgid "Tag" msgid "Tag"
msgstr "Étiquette" msgstr "Étiquette"
#: src/rougail/output_doc/doc.py:420 #: src/rougail/output_doc/doc.py:392
msgid "Tags" msgid "Tags"
msgstr "Étiquettes" msgstr "Étiquettes"
#: src/rougail/output_doc/doc.py:449 #: src/rougail/output_doc/doc.py:424
msgid "No attribute \"description\" for \"{0}\" in {1}" msgid "No attribute \"description\" for \"{0}\" in {1}"
msgstr "Aucun attribut \"description\" pour \"{0}\" dans {1}" msgstr "Aucun attribut \"description\" pour \"{0}\" dans {1}"
#: src/rougail/output_doc/doc.py:587 #: src/rougail/output_doc/doc.py:562
msgid "text based with regular expressions \"{0}\"" msgid "text based with regular expressions \"{0}\""
msgstr "texte avec expression rationnelle \"{0}\"" msgstr "texte avec expression rationnelle \"{0}\""
#: src/rougail/output_doc/doc.py:591 #: src/rougail/output_doc/doc.py:566
msgid "Validator" msgid "Validator"
msgstr "Validateur" msgstr "Validateur"
#: src/rougail/output_doc/doc.py:594 #: src/rougail/output_doc/doc.py:569
msgid "Validators" msgid "Validators"
msgstr "Validateurs" msgstr "Validateurs"
#: src/rougail/output_doc/doc.py:603 #: src/rougail/output_doc/doc.py:578
msgid "Choices" msgid "Choices"
msgstr "Choix" msgstr "Choix"
#: src/rougail/output_doc/doc.py:706 #: src/rougail/output_doc/doc.py:681
msgid "the value of the identifier" msgid "the value of the identifier"
msgstr "la valeur de l'identifiant" msgstr "la valeur de l'identifiant"
#: src/rougail/output_doc/doc.py:710 #: src/rougail/output_doc/doc.py:685
msgid "the value of the {0}" msgid "the value of the {0}"
msgstr "la valeur de l'{0}" msgstr "la valeur de l'{0}"
#: src/rougail/output_doc/doc.py:719 #: src/rougail/output_doc/doc.py:694
msgid "depends on a calculation" msgid "depends on a calculation"
msgstr "dépend d'un calcul" msgstr "dépend d'un calcul"
#: src/rougail/output_doc/doc.py:725 #: src/rougail/output_doc/doc.py:700
msgid "\"{0}\" is a calculation for {1} but has no description in {2}" msgid "\"{0}\" is a calculation for {1} but has no description in {2}"
msgstr "\"{0}\" est un calcul pour {1} mais n'a pas de description dans {2}" msgstr "\"{0}\" est un calcul pour {1} mais n'a pas de description dans {2}"
#: src/rougail/output_doc/doc.py:753 #: src/rougail/output_doc/doc.py:728
msgid "the value of the variable \"{0}\"" msgid "the value of the variable \"{0}\""
msgstr "la valeur de la variable \"{0}\"" msgstr "la valeur de la variable \"{0}\""
#: src/rougail/output_doc/doc.py:755 #: src/rougail/output_doc/doc.py:730
msgid "the value of the variable \"{0}\" if it is defined" msgid "the value of the variable \"{0}\" if it is defined"
msgstr "la valeur de la variable \"{0}\" si elle est définie" msgstr "la valeur de la variable \"{0}\" si elle est définie"
#: src/rougail/output_doc/doc.py:775 #: src/rougail/output_doc/doc.py:750
msgid "the value of an undocumented variable" msgid "the value of an undocumented variable"
msgstr "la valeur d'une variable non documentée" msgstr "la valeur d'une variable non documentée"
#: src/rougail/output_doc/doc.py:778 #: src/rougail/output_doc/doc.py:753
msgid "the values of undocumented variables" msgid "the values of undocumented variables"
msgstr "les valeurs de variables non documentées" msgstr "les valeurs de variables non documentées"
#: src/rougail/output_doc/doc.py:801 #: src/rougail/output_doc/doc.py:776
msgid "(from an undocumented variable)" msgid "(from an undocumented variable)"
msgstr "(issue d'une variable non documentée)" msgstr "(issue d'une variable non documentée)"
#: src/rougail/output_doc/doc.py:809 #: src/rougail/output_doc/doc.py:784
msgid "{0} (from an undocumented variable)" msgid "{0} (from an undocumented variable)"
msgstr "{0} (issue d'une variable non documentée)" msgstr "{0} (issue d'une variable non documentée)"
#: src/rougail/output_doc/doc.py:813 src/rougail/output_doc/doc.py:862 #: src/rougail/output_doc/doc.py:788 src/rougail/output_doc/doc.py:840
msgid "depends on an undocumented variable" msgid "depends on an undocumented variable"
msgstr "dépends d'une variable non documentée" msgstr "dépends d'une variable non documentée"
#: src/rougail/output_doc/doc.py:884 #: src/rougail/output_doc/doc.py:862
msgid "" msgid ""
"when the variable \"{{0}}\" is defined, accessible and hasn't the value " "when the variable \"{{0}}\" is defined, accessible and hasn't the value "
"\"{0}\"" "\"{0}\""
@ -251,184 +293,194 @@ msgstr ""
"lorsque la variable \"{{0}}\" est définie, accessible et n'a pas la valeur " "lorsque la variable \"{{0}}\" est définie, accessible et n'a pas la valeur "
"\"{0}\"" "\"{0}\""
#: src/rougail/output_doc/doc.py:888 #: src/rougail/output_doc/doc.py:866
msgid "when the variable \"{{0}}\" is defined and hasn't the value \"{0}\"" msgid "when the variable \"{{0}}\" is defined and hasn't the value \"{0}\""
msgstr "lorsque la variable \"{{0}}\" est définie et n'a pas la valeur \"{0}\"" msgstr "lorsque la variable \"{{0}}\" est définie et n'a pas la valeur \"{0}\""
#: src/rougail/output_doc/doc.py:892 #: src/rougail/output_doc/doc.py:870
msgid "when the variable \"{{0}}\" is accessible and hasn't the value \"{0}\"" msgid "when the variable \"{{0}}\" is accessible and hasn't the value \"{0}\""
msgstr "" msgstr ""
"lorsque la variable \"{{0}}\" est acessible et n'a pas la valeur \"{0}\"" "lorsque la variable \"{{0}}\" est acessible et n'a pas la valeur \"{0}\""
#: src/rougail/output_doc/doc.py:894 #: src/rougail/output_doc/doc.py:872
msgid "when the variable \"{{0}}\" hasn't the value \"{0}\"" msgid "when the variable \"{{0}}\" hasn't the value \"{0}\""
msgstr "lorsque la variable \"{{0}}\" n'a pas la valeur \"{0}\"" msgstr "lorsque la variable \"{{0}}\" n'a pas la valeur \"{0}\""
#: src/rougail/output_doc/doc.py:898 #: src/rougail/output_doc/doc.py:876
msgid "" msgid ""
"when the variable \"{{0}}\" is defined, is accessible and has the value " "when the variable \"{{0}}\" is defined, is accessible and has the value "
"\"{0}\"" "\"{0}\""
msgstr "" msgstr ""
"lorsque la variable \"{{0}}\" est définie, accessible et a la valeur \"{0}\"" "lorsque la variable \"{{0}}\" est définie, accessible et a la valeur \"{0}\""
#: src/rougail/output_doc/doc.py:902 #: src/rougail/output_doc/doc.py:880
msgid "when the variable \"{{0}}\" is defined and has the value \"{0}\"" msgid "when the variable \"{{0}}\" is defined and has the value \"{0}\""
msgstr "lorsque la variable \"{{0}}\" est définie et a la valeur \"{0}\"" msgstr "lorsque la variable \"{{0}}\" est définie et a la valeur \"{0}\""
#: src/rougail/output_doc/doc.py:906 #: src/rougail/output_doc/doc.py:884
msgid "when the variable \"{{0}}\" is accessible and has the value \"{0}\"" msgid "when the variable \"{{0}}\" is accessible and has the value \"{0}\""
msgstr "lorsque la variable \"{{0}}\" est accessible et a la valeur \"{0}\"" msgstr "lorsque la variable \"{{0}}\" est accessible et a la valeur \"{0}\""
#: src/rougail/output_doc/doc.py:908 #: src/rougail/output_doc/doc.py:886
msgid "when the variable \"{{0}}\" has the value \"{0}\"" msgid "when the variable \"{{0}}\" has the value \"{0}\""
msgstr "lorsque la variable \"{{0}}\" a la valeur \"{0}\"" msgstr "lorsque la variable \"{{0}}\" a la valeur \"{0}\""
#: src/rougail/output_doc/example.py:38 #: src/rougail/output_doc/example.py:45
msgid "Example with mandatory variables not filled in" msgid "Example with mandatory variables not filled in"
msgstr "Exemple avec des variables obligatoire non renseignée" msgstr "Exemple avec des variables obligatoire non renseignée"
#: src/rougail/output_doc/example.py:43 #: src/rougail/output_doc/example.py:52
msgid "Example with all variables modifiable" msgid "Example with all variables modifiable"
msgstr "Exemple avec toutes les variables modifiable" msgstr "Exemple avec toutes les variables modifiable"
#: src/rougail/output_doc/output/console.py:165 #: src/rougail/output_doc/output/asciidoc.py:152
#: src/rougail/output_doc/utils.py:820 #: src/rougail/output_doc/output/console.py:189
msgid "Variable" #: src/rougail/output_doc/output/github.py:188
msgstr "Variable" #: src/rougail/output_doc/output/gitlab.py:44
#: src/rougail/output_doc/output/console.py:166
#: src/rougail/output_doc/utils.py:820
msgid "Description"
msgstr "Description"
#: src/rougail/output_doc/output/gitlab.py:68
msgid "Informations" msgid "Informations"
msgstr "Informations" msgstr "Informations"
#: src/rougail/output_doc/utils.py:44 #: src/rougail/output_doc/output/console.py:182
#: src/rougail/output_doc/utils.py:896
msgid "Variable"
msgstr "Variable"
#: src/rougail/output_doc/output/console.py:183
#: src/rougail/output_doc/utils.py:896
msgid "Description"
msgstr "Description"
#: src/rougail/output_doc/utils.py:48
msgid "the domain name can starts by a dot" msgid "the domain name can starts by a dot"
msgstr "le nom de domaine peut commencer par un point" msgstr "le nom de domaine peut commencer par un point"
#: src/rougail/output_doc/utils.py:45 #: src/rougail/output_doc/utils.py:49
msgid "the domain name can be a hostname" msgid "the domain name can be a hostname"
msgstr "le nom de domaine peut être un nom d'hôte" msgstr "le nom de domaine peut être un nom d'hôte"
#: src/rougail/output_doc/utils.py:46 #: src/rougail/output_doc/utils.py:50
msgid "the domain name can be an IP" msgid "the domain name can be an IP"
msgstr "le nom de domaine peut être une IP" msgstr "le nom de domaine peut être une IP"
#: src/rougail/output_doc/utils.py:47 #: src/rougail/output_doc/utils.py:51
msgid "the domain name can be network in CIDR format" msgid "the domain name can be network in CIDR format"
msgstr "le nom de domaine peut être un réseau au format CIDR" msgstr "le nom de domaine peut être un réseau au format CIDR"
#: src/rougail/output_doc/utils.py:52 src/rougail/output_doc/utils.py:58 #: src/rougail/output_doc/utils.py:56 src/rougail/output_doc/utils.py:62
msgid "the minimum value is {0}" msgid "the minimum value is {0}"
msgstr "le valeur minimal est {0}" msgstr "le valeur minimal est {0}"
#: src/rougail/output_doc/utils.py:53 src/rougail/output_doc/utils.py:59 #: src/rougail/output_doc/utils.py:57 src/rougail/output_doc/utils.py:63
msgid "the maximum value is {0}" msgid "the maximum value is {0}"
msgstr "le valeur maximal est {0}" msgstr "le valeur maximal est {0}"
#: src/rougail/output_doc/utils.py:65 #: src/rougail/output_doc/utils.py:69
msgid "IP must be in CIDR format" msgid "IP must be in CIDR format"
msgstr "IP doit être au format CIDR" msgstr "IP doit être au format CIDR"
#: src/rougail/output_doc/utils.py:66 #: src/rougail/output_doc/utils.py:70
msgid "private IP are allowed" msgid "private IP are allowed"
msgstr "les IP privées sont autorisés" msgstr "les IP privées sont autorisés"
#: src/rougail/output_doc/utils.py:67 #: src/rougail/output_doc/utils.py:71
msgid "reserved IP are allowed" msgid "reserved IP are allowed"
msgstr "les IP réservés sont autorisés" msgstr "les IP réservés sont autorisés"
#: src/rougail/output_doc/utils.py:72 #: src/rougail/output_doc/utils.py:76
msgid "network must be in CIDR format" msgid "network must be in CIDR format"
msgstr "réseau doit être au format CIDR" msgstr "réseau doit être au format CIDR"
#: src/rougail/output_doc/utils.py:77 #: src/rougail/output_doc/utils.py:81
msgid "the host name can be an IP" msgid "the host name can be an IP"
msgstr "le nom d'hôte peut être une IP" msgstr "le nom d'hôte peut être une IP"
#: src/rougail/output_doc/utils.py:82 #: src/rougail/output_doc/utils.py:86
msgid "the domain name in web address can be an IP" msgid "the domain name in web address can be an IP"
msgstr "le nom de domaine dans l'adresse web peut être une IP" msgstr "le nom de domaine dans l'adresse web peut être une IP"
#: src/rougail/output_doc/utils.py:83 #: src/rougail/output_doc/utils.py:87
msgid "the domain name in web address can be only a hostname" msgid "the domain name in web address can be only a hostname"
msgstr "le nom de domaine dans l'adresse web ne peut être qu'un nom d'hôte" msgstr "le nom de domaine dans l'adresse web ne peut être qu'un nom d'hôte"
#: src/rougail/output_doc/utils.py:90 #: src/rougail/output_doc/utils.py:94
msgid "can be range of port" msgid "can be range of port"
msgstr "peut être un range de port" msgstr "peut être un range de port"
#: src/rougail/output_doc/utils.py:91 #: src/rougail/output_doc/utils.py:95
msgid "can have the protocol" msgid "can have the protocol"
msgstr "peut avoir un protocole" msgstr "peut avoir un protocole"
#: src/rougail/output_doc/utils.py:92 #: src/rougail/output_doc/utils.py:96
msgid "port 0 is allowed" msgid "port 0 is allowed"
msgstr "le port 0 est autorisé" msgstr "le port 0 est autorisé"
#: src/rougail/output_doc/utils.py:93 #: src/rougail/output_doc/utils.py:97
msgid "well-known ports (1 to 1023) are allowed" msgid "well-known ports (1 to 1023) are allowed"
msgstr "les ports connus (de 1 à 1023) sont autorisés" msgstr "les ports connus (de 1 à 1023) sont autorisés"
#: src/rougail/output_doc/utils.py:94 #: src/rougail/output_doc/utils.py:98
msgid "registred ports (1024 to 49151) are allowed" msgid "registred ports (1024 to 49151) are allowed"
msgstr "les ports enregistrés (de 1024 à 49151) sont autorisés" msgstr "les ports enregistrés (de 1024 à 49151) sont autorisés"
#: src/rougail/output_doc/utils.py:95 #: src/rougail/output_doc/utils.py:99
msgid "private ports (greater than 49152) are allowed" msgid "private ports (greater than 49152) are allowed"
msgstr "les ports privés (supérieurs à 49152) sont autorisés" msgstr "les ports privés (supérieurs à 49152) sont autorisés"
#: src/rougail/output_doc/utils.py:100 #: src/rougail/output_doc/utils.py:104
msgid "minimum length for the secret is {0} characters" msgid "minimum length for the secret is {0} characters"
msgstr "longueur minimum pour le secret est de {0} caractères" msgstr "longueur minimum pour le secret est de {0} caractères"
#: src/rougail/output_doc/utils.py:101 #: src/rougail/output_doc/utils.py:105
msgid "maximum length for the secret is {0} characters" msgid "maximum length for the secret is {0} characters"
msgstr "longueur maximal pour le secret est de {0} caractères" msgstr "longueur maximal pour le secret est de {0} caractères"
#: src/rougail/output_doc/utils.py:102 #: src/rougail/output_doc/utils.py:106
msgid "forbidden characters: {0}" msgid "forbidden characters: {0}"
msgstr "caractères interdits: {0}" msgstr "caractères interdits: {0}"
#: src/rougail/output_doc/utils.py:107 #: src/rougail/output_doc/utils.py:111
msgid "this filename could be a relative path" msgid "this filename could be a relative path"
msgstr "ce nom de fichier peut être un chemin relative" msgstr "ce nom de fichier peut être un chemin relative"
#: src/rougail/output_doc/utils.py:108 #: src/rougail/output_doc/utils.py:112
msgid "this file must exists" msgid "this file must exists"
msgstr "ce fichier doit exister" msgstr "ce fichier doit exister"
#: src/rougail/output_doc/utils.py:109 #: src/rougail/output_doc/utils.py:113
msgid "file type allowed: {0}" msgid "file type allowed: {0}"
msgstr "type de fichier autorisé : {0}" msgstr "type de fichier autorisé : {0}"
#: src/rougail/output_doc/utils.py:362 #: src/rougail/output_doc/utils.py:432
msgid "Variables for \"{0}\""
msgstr "Variables pour \"{0}\""
#: src/rougail/output_doc/utils.py:392
msgid "Identifiers" msgid "Identifiers"
msgstr "Identifiants" msgstr "Identifiants"
#: src/rougail/output_doc/utils.py:697 src/rougail/output_doc/utils.py:706 #: src/rougail/output_doc/utils.py:578
#: src/rougail/output_doc/utils.py:712 src/rougail/output_doc/utils.py:718 msgid "Command line"
#: src/rougail/output_doc/utils.py:722 msgstr "Ligne de commande"
#: src/rougail/output_doc/utils.py:581
msgid "Environment variable"
msgstr "Variable d'environnement"
#: src/rougail/output_doc/utils.py:762 src/rougail/output_doc/utils.py:771
#: src/rougail/output_doc/utils.py:777 src/rougail/output_doc/utils.py:783
#: src/rougail/output_doc/utils.py:787
msgid "(default)" msgid "(default)"
msgstr "(défaut)" msgstr "(défaut)"
#: src/rougail/output_doc/utils.py:877 #: src/rougail/output_doc/utils.py:973
msgid "{0}: {1}" msgid "{0}: {1}"
msgstr "{0} : {1}" msgstr "{0} : {1}"
#~ msgid "Configuration rougail-doc"
#~ msgstr "Configuration de rougail-doc"
#~ msgid "Variables for \"{0}\""
#~ msgstr "Variables pour \"{0}\""
#~ msgid "Generate example" #~ msgid "Generate example"
#~ msgstr "Génération de l'exemple" #~ msgstr "Génération de l'exemple"
#~ msgid "Add families in documentation"
#~ msgstr "Ajouter les familles dans la documentation"
#~ msgid "Display example in documentation" #~ msgid "Display example in documentation"
#~ msgstr "Afficher un exemple dans la documentation" #~ msgstr "Afficher un exemple dans la documentation"

283
locale/rougail_output_doc.pot
View file

@ -5,7 +5,7 @@
msgid "" msgid ""
msgstr "" msgstr ""
"Project-Id-Version: PACKAGE VERSION\n" "Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2025-10-29 11:02+0100\n" "POT-Creation-Date: 2025-11-27 22:14+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n" "Language-Team: LANGUAGE <LL@li.org>\n"
@ -15,395 +15,438 @@ msgstr ""
"Generated-By: pygettext.py 1.5\n" "Generated-By: pygettext.py 1.5\n"
#: src/rougail/output_doc/annotator.py:325 #: src/rougail/output_doc/annotator.py:350
msgid "the value of the information \"{0}\" of the variable \"{1}\"" msgid "the value of the information \"{0}\" of the variable \"{1}\""
msgstr "" msgstr ""
#: src/rougail/output_doc/annotator.py:328 #: src/rougail/output_doc/annotator.py:353
msgid "the value of the global information \"{0}\"" msgid "the value of the global information \"{0}\""
msgstr "" msgstr ""
#: src/rougail/output_doc/annotator.py:335 #: src/rougail/output_doc/annotator.py:360
msgid "when the identifier is \"{0}\"" msgid "when the identifier is \"{0}\""
msgstr "" msgstr ""
#: src/rougail/output_doc/annotator.py:337 #: src/rougail/output_doc/annotator.py:362
msgid "when the identifier is not \"{0}\"" msgid "when the identifier is not \"{0}\""
msgstr "" msgstr ""
#: src/rougail/output_doc/changelog.py:144 #: src/rougail/output_doc/changelog.py:155
msgid "New variable" msgid "New variable"
msgstr "" msgstr ""
#: src/rougail/output_doc/changelog.py:146 #: src/rougail/output_doc/changelog.py:157
msgid "New variables" msgid "New variables"
msgstr "" msgstr ""
#: src/rougail/output_doc/changelog.py:158 #: src/rougail/output_doc/changelog.py:169
msgid "Modified variable" msgid "Modified variable"
msgstr "" msgstr ""
#: src/rougail/output_doc/changelog.py:160 #: src/rougail/output_doc/changelog.py:171
msgid "Modified variables" msgid "Modified variables"
msgstr "" msgstr ""
#: src/rougail/output_doc/changelog.py:172 #: src/rougail/output_doc/changelog.py:183
msgid "Deleted variable" msgid "Deleted variable"
msgstr "" msgstr ""
#: src/rougail/output_doc/changelog.py:174 #: src/rougail/output_doc/changelog.py:185
msgid "Deleted variables" msgid "Deleted variables"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:43 #: src/rougail/output_doc/config.py:41
msgid "duplicated level rougail-doc for output \"{0}\": {1} and {2}" msgid "duplicated level rougail-doc for output \"{0}\": {1} and {2}"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:75 #: src/rougail/output_doc/config.py:73
msgid "Configuration rougail-doc" msgid "Generate documentation"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:83 #: src/rougail/output_doc/config.py:79
msgid "when \"doc\" is not set in \"step.output\""
msgstr ""
#: src/rougail/output_doc/config.py:82
msgid "Starting title level" msgid "Starting title level"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:88 #: src/rougail/output_doc/config.py:87
msgid "Generated content" msgid "Generated content"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:97 #: src/rougail/output_doc/config.py:96
msgid "Previous description file in JSON format" msgid "Previous description file in JSON format"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:105 #: src/rougail/output_doc/config.py:101
msgid "changelog is not selected in \"_.contents\""
msgstr ""
#: src/rougail/output_doc/config.py:104
msgid "Do not add families in documentation" msgid "Do not add families in documentation"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:114 #: src/rougail/output_doc/config.py:110
msgid "variables is not selected in \"_.contents\""
msgstr ""
#: src/rougail/output_doc/config.py:113
msgid "Document the variables from this family" msgid "Document the variables from this family"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:118 #: src/rougail/output_doc/config.py:117
msgid "Families or variables for this family are in an other file name" msgid "Add command line informations in documentation"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:128 #: src/rougail/output_doc/config.py:123 src/rougail/output_doc/config.py:132
msgid "documentation must be splitted and in gitlab format" msgid "if \"_.output_format\" is json or variables is not selected in \"_.contents\""
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:131 #: src/rougail/output_doc/config.py:126
msgid "Root family name" msgid "Add environment variable informations in documentation"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:135 #: src/rougail/output_doc/config.py:135
msgid "Name of the file" msgid "Name of the default environment prefix"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:141 #: src/rougail/output_doc/config.py:141
msgid "Disable documentation for variables with those modes" msgid "should only user uppercase characters"
msgstr ""
#: src/rougail/output_doc/config.py:146
msgid "when \"__.main_namespace\" is not set or \"_.with_environment\" is false"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:149 #: src/rougail/output_doc/config.py:149
msgid "disabled when there is no mode available" msgid "Families or variables for this family are in an other file name"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:155 #: src/rougail/output_doc/config.py:156
msgid "verify if disable modes already exists" msgid "documentation must be splitted"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:157 #: src/rougail/output_doc/config.py:159
msgid "Modify values to document leaderships and dynamics families" msgid "Root family name"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:160 #: src/rougail/output_doc/config.py:163
msgid "Add description of variables and families when generate examples" msgid "Name of the file"
msgstr ""
#: src/rougail/output_doc/config.py:166
msgid "disabled when example in not in contents"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:169 #: src/rougail/output_doc/config.py:169
msgid "Comment in examples starts at column" msgid "Disable documentation for variables with those modes"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:177 #: src/rougail/output_doc/config.py:177
msgid "disabled when there is no mode available"
msgstr ""
#: src/rougail/output_doc/config.py:183
msgid "verify if disable modes already exists"
msgstr ""
#: src/rougail/output_doc/config.py:185
msgid "Modify values to document leaderships and dynamics families"
msgstr ""
#: src/rougail/output_doc/config.py:188
msgid "Add description of variables and families when generate examples"
msgstr ""
#: src/rougail/output_doc/config.py:194
msgid "disabled when example in not in contents"
msgstr ""
#: src/rougail/output_doc/config.py:197
msgid "Comment in examples starts at column"
msgstr ""
#: src/rougail/output_doc/config.py:205
msgid "Generate document in format" msgid "Generate document in format"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:187 #: src/rougail/output_doc/config.py:215
msgid "json output_format is not compatible with \"changelog\" and \"example\" contents" msgid "json output_format is not compatible with \"changelog\" and \"example\" contents"
msgstr "" msgstr ""
#: src/rougail/output_doc/config.py:196 #: src/rougail/output_doc/config.py:224
msgid "Force true color terminal" msgid "Force true color terminal"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:358 #: src/rougail/output_doc/doc.py:330
msgid "This family contains lists of variable blocks" msgid "This family contains lists of variable blocks"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:368 #: src/rougail/output_doc/doc.py:340
msgid "This family builds families dynamically" msgid "This family builds families dynamically"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:382 #: src/rougail/output_doc/doc.py:354
msgid "Default" msgid "Default"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:397 #: src/rougail/output_doc/doc.py:369
msgid "multiple" msgid "multiple"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:405 #: src/rougail/output_doc/doc.py:377
msgid "Example" msgid "Example"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:408 #: src/rougail/output_doc/doc.py:380
msgid "Examples" msgid "Examples"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:417 #: src/rougail/output_doc/doc.py:389
msgid "Tag" msgid "Tag"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:420 #: src/rougail/output_doc/doc.py:392
msgid "Tags" msgid "Tags"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:449 #: src/rougail/output_doc/doc.py:424
msgid "No attribute \"description\" for \"{0}\" in {1}" msgid "No attribute \"description\" for \"{0}\" in {1}"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:587 #: src/rougail/output_doc/doc.py:562
msgid "text based with regular expressions \"{0}\"" msgid "text based with regular expressions \"{0}\""
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:591 #: src/rougail/output_doc/doc.py:566
msgid "Validator" msgid "Validator"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:594 #: src/rougail/output_doc/doc.py:569
msgid "Validators" msgid "Validators"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:603 #: src/rougail/output_doc/doc.py:578
msgid "Choices" msgid "Choices"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:706 #: src/rougail/output_doc/doc.py:681
msgid "the value of the identifier" msgid "the value of the identifier"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:710 #: src/rougail/output_doc/doc.py:685
msgid "the value of the {0}" msgid "the value of the {0}"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:719 #: src/rougail/output_doc/doc.py:694
msgid "depends on a calculation" msgid "depends on a calculation"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:725 #: src/rougail/output_doc/doc.py:700
msgid "\"{0}\" is a calculation for {1} but has no description in {2}" msgid "\"{0}\" is a calculation for {1} but has no description in {2}"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:753 #: src/rougail/output_doc/doc.py:728
msgid "the value of the variable \"{0}\"" msgid "the value of the variable \"{0}\""
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:755 #: src/rougail/output_doc/doc.py:730
msgid "the value of the variable \"{0}\" if it is defined" msgid "the value of the variable \"{0}\" if it is defined"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:775 #: src/rougail/output_doc/doc.py:750
msgid "the value of an undocumented variable" msgid "the value of an undocumented variable"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:778 #: src/rougail/output_doc/doc.py:753
msgid "the values of undocumented variables" msgid "the values of undocumented variables"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:801 #: src/rougail/output_doc/doc.py:776
msgid "(from an undocumented variable)" msgid "(from an undocumented variable)"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:809 #: src/rougail/output_doc/doc.py:784
msgid "{0} (from an undocumented variable)" msgid "{0} (from an undocumented variable)"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:813 src/rougail/output_doc/doc.py:862 #: src/rougail/output_doc/doc.py:788 src/rougail/output_doc/doc.py:840
msgid "depends on an undocumented variable" msgid "depends on an undocumented variable"
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:884 #: src/rougail/output_doc/doc.py:862
msgid "when the variable \"{{0}}\" is defined, accessible and hasn't the value \"{0}\"" msgid "when the variable \"{{0}}\" is defined, accessible and hasn't the value \"{0}\""
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:888 #: src/rougail/output_doc/doc.py:866
msgid "when the variable \"{{0}}\" is defined and hasn't the value \"{0}\"" msgid "when the variable \"{{0}}\" is defined and hasn't the value \"{0}\""
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:892 #: src/rougail/output_doc/doc.py:870
msgid "when the variable \"{{0}}\" is accessible and hasn't the value \"{0}\"" msgid "when the variable \"{{0}}\" is accessible and hasn't the value \"{0}\""
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:894 #: src/rougail/output_doc/doc.py:872
msgid "when the variable \"{{0}}\" hasn't the value \"{0}\"" msgid "when the variable \"{{0}}\" hasn't the value \"{0}\""
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:898 #: src/rougail/output_doc/doc.py:876
msgid "when the variable \"{{0}}\" is defined, is accessible and has the value \"{0}\"" msgid "when the variable \"{{0}}\" is defined, is accessible and has the value \"{0}\""
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:902 #: src/rougail/output_doc/doc.py:880
msgid "when the variable \"{{0}}\" is defined and has the value \"{0}\"" msgid "when the variable \"{{0}}\" is defined and has the value \"{0}\""
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:906 #: src/rougail/output_doc/doc.py:884
msgid "when the variable \"{{0}}\" is accessible and has the value \"{0}\"" msgid "when the variable \"{{0}}\" is accessible and has the value \"{0}\""
msgstr "" msgstr ""
#: src/rougail/output_doc/doc.py:908 #: src/rougail/output_doc/doc.py:886
msgid "when the variable \"{{0}}\" has the value \"{0}\"" msgid "when the variable \"{{0}}\" has the value \"{0}\""
msgstr "" msgstr ""
#: src/rougail/output_doc/example.py:38 #: src/rougail/output_doc/example.py:45
msgid "Example with mandatory variables not filled in" msgid "Example with mandatory variables not filled in"
msgstr "" msgstr ""
#: src/rougail/output_doc/example.py:43 #: src/rougail/output_doc/example.py:52
msgid "Example with all variables modifiable" msgid "Example with all variables modifiable"
msgstr "" msgstr ""
#: src/rougail/output_doc/output/console.py:165 #: src/rougail/output_doc/output/asciidoc.py:152
#: src/rougail/output_doc/utils.py:820 #: src/rougail/output_doc/output/console.py:189
msgid "Variable" #: src/rougail/output_doc/output/github.py:188
msgstr "" #: src/rougail/output_doc/output/gitlab.py:44
#: src/rougail/output_doc/output/console.py:166
#: src/rougail/output_doc/utils.py:820
msgid "Description"
msgstr ""
#: src/rougail/output_doc/output/gitlab.py:68
msgid "Informations" msgid "Informations"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:44 #: src/rougail/output_doc/output/console.py:182
#: src/rougail/output_doc/utils.py:896
msgid "Variable"
msgstr ""
#: src/rougail/output_doc/output/console.py:183
#: src/rougail/output_doc/utils.py:896
msgid "Description"
msgstr ""
#: src/rougail/output_doc/utils.py:48
msgid "the domain name can starts by a dot" msgid "the domain name can starts by a dot"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:45 #: src/rougail/output_doc/utils.py:49
msgid "the domain name can be a hostname" msgid "the domain name can be a hostname"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:46 #: src/rougail/output_doc/utils.py:50
msgid "the domain name can be an IP" msgid "the domain name can be an IP"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:47 #: src/rougail/output_doc/utils.py:51
msgid "the domain name can be network in CIDR format" msgid "the domain name can be network in CIDR format"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:52 src/rougail/output_doc/utils.py:58 #: src/rougail/output_doc/utils.py:56 src/rougail/output_doc/utils.py:62
msgid "the minimum value is {0}" msgid "the minimum value is {0}"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:53 src/rougail/output_doc/utils.py:59 #: src/rougail/output_doc/utils.py:57 src/rougail/output_doc/utils.py:63
msgid "the maximum value is {0}" msgid "the maximum value is {0}"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:65 #: src/rougail/output_doc/utils.py:69
msgid "IP must be in CIDR format" msgid "IP must be in CIDR format"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:66 #: src/rougail/output_doc/utils.py:70
msgid "private IP are allowed" msgid "private IP are allowed"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:67 #: src/rougail/output_doc/utils.py:71
msgid "reserved IP are allowed" msgid "reserved IP are allowed"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:72 #: src/rougail/output_doc/utils.py:76
msgid "network must be in CIDR format" msgid "network must be in CIDR format"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:77 #: src/rougail/output_doc/utils.py:81
msgid "the host name can be an IP" msgid "the host name can be an IP"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:82 #: src/rougail/output_doc/utils.py:86
msgid "the domain name in web address can be an IP" msgid "the domain name in web address can be an IP"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:83 #: src/rougail/output_doc/utils.py:87
msgid "the domain name in web address can be only a hostname" msgid "the domain name in web address can be only a hostname"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:90 #: src/rougail/output_doc/utils.py:94
msgid "can be range of port" msgid "can be range of port"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:91 #: src/rougail/output_doc/utils.py:95
msgid "can have the protocol" msgid "can have the protocol"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:92 #: src/rougail/output_doc/utils.py:96
msgid "port 0 is allowed" msgid "port 0 is allowed"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:93 #: src/rougail/output_doc/utils.py:97
msgid "well-known ports (1 to 1023) are allowed" msgid "well-known ports (1 to 1023) are allowed"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:94 #: src/rougail/output_doc/utils.py:98
msgid "registred ports (1024 to 49151) are allowed" msgid "registred ports (1024 to 49151) are allowed"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:95 #: src/rougail/output_doc/utils.py:99
msgid "private ports (greater than 49152) are allowed" msgid "private ports (greater than 49152) are allowed"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:100 #: src/rougail/output_doc/utils.py:104
msgid "minimum length for the secret is {0} characters" msgid "minimum length for the secret is {0} characters"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:101 #: src/rougail/output_doc/utils.py:105
msgid "maximum length for the secret is {0} characters" msgid "maximum length for the secret is {0} characters"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:102 #: src/rougail/output_doc/utils.py:106
msgid "forbidden characters: {0}" msgid "forbidden characters: {0}"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:107 #: src/rougail/output_doc/utils.py:111
msgid "this filename could be a relative path" msgid "this filename could be a relative path"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:108 #: src/rougail/output_doc/utils.py:112
msgid "this file must exists" msgid "this file must exists"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:109 #: src/rougail/output_doc/utils.py:113
msgid "file type allowed: {0}" msgid "file type allowed: {0}"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:362 #: src/rougail/output_doc/utils.py:432
msgid "Variables for \"{0}\""
msgstr ""
#: src/rougail/output_doc/utils.py:392
msgid "Identifiers" msgid "Identifiers"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:697 src/rougail/output_doc/utils.py:706 #: src/rougail/output_doc/utils.py:578
#: src/rougail/output_doc/utils.py:712 src/rougail/output_doc/utils.py:718 msgid "Command line"
#: src/rougail/output_doc/utils.py:722 msgstr ""
#: src/rougail/output_doc/utils.py:581
msgid "Environment variable"
msgstr ""
#: src/rougail/output_doc/utils.py:762 src/rougail/output_doc/utils.py:771
#: src/rougail/output_doc/utils.py:777 src/rougail/output_doc/utils.py:783
#: src/rougail/output_doc/utils.py:787
msgid "(default)" msgid "(default)"
msgstr "" msgstr ""
#: src/rougail/output_doc/utils.py:877 #: src/rougail/output_doc/utils.py:973
msgid "{0}: {1}" msgid "{0}: {1}"
msgstr "" msgstr ""

46
src/rougail/output_doc/config.py
View file

@ -1,6 +1,4 @@
""" """
Config file for Rougail-doc
Silique (https://www.silique.fr) Silique (https://www.silique.fr)
Copyright (C) 2024-2025 Copyright (C) 2024-2025
@ -72,12 +70,13 @@ def get_rougail_config(
output_format_default = outputs[0] output_format_default = outputs[0]
rougail_options = f""" rougail_options = f"""
doc: doc:
description: {_('Configuration rougail-doc')} description: {_('Generate documentation')}
disabled: disabled:
jinja: | jinja: |
{{% if step.output is propertyerror or step.output != 'doc' %}} {{% if step.output is propertyerror or step.output != 'doc' %}}
disabled disabled
{{% endif %}} {{% endif %}}
description: {_('when "doc" is not set in "step.output"')}
title_level: title_level:
description: {_('Starting title level')} description: {_('Starting title level')}
@ -99,7 +98,7 @@ doc:
jinja: |- jinja: |-
{{{{ "changelog" not in _.contents }}}} {{{{ "changelog" not in _.contents }}}}
return_type: boolean return_type: boolean
description: changelog is not selected description: {_('changelog is not selected in "_.contents"')}
without_family: without_family:
description: {_('Do not add families in documentation')} description: {_('Do not add families in documentation')}
@ -108,12 +107,44 @@ doc:
jinja: |- jinja: |-
{{{{ "variables" not in _.contents and "changelog" not in _.contents and _.output_format != "json" }}}} {{{{ "variables" not in _.contents and "changelog" not in _.contents and _.output_format != "json" }}}}
return_type: boolean return_type: boolean
description: variables is not selected description: {_('variables is not selected in "_.contents"')}
root: root:
description: {_('Document the variables from this family')} description: {_('Document the variables from this family')}
mandatory: false mandatory: false
with_commandline:
description: {_('Add command line informations in documentation')}
default: false
disabled:
jinja: |-
{{{{ _.output_format == "json" or "variables" not in _.contents }}}}
return_type: boolean
description: {_('if "_.output_format" is json or variables is not selected in "_.contents"')}
with_environment:
description: {_('Add environment variable informations in documentation')}
default: false
disabled:
jinja: |-
{{{{ _.output_format == "json" or "variables" not in _.contents }}}}
return_type: boolean
description: {_('if "_.output_format" is json or variables is not selected in "_.contents"')}
environment_default_environment_name:
description: {_("Name of the default environment prefix")}
default: ROUGAIL
validators:
- jinja: |-
{{{{ _.environment_default_environment_name | upper != _.environment_default_environment_name }}}}
return_type: boolean
description: {_("should only user uppercase characters")}
disabled:
jinja: |-
{{{{ __.main_namespace or _.with_environment is false }}}}
return_type: boolean
description: {_('when "__.main_namespace" is not set or "_.with_environment" is false')}
other_root_filenames: other_root_filenames:
description: {_("Families or variables for this family are in an other file name")} description: {_("Families or variables for this family are in an other file name")}
type: leadership type: leadership
@ -122,10 +153,7 @@ doc:
{{% if not _.root %}} {{% if not _.root %}}
Documents are not splitted Documents are not splitted
{{% endif %}} {{% endif %}}
{{% if _.output_format != 'gitlab' %}} description: {_('documentation must be splitted')}
anchor is available only for gitlab output_format
{{% endif %}}
description: {_('documentation must be splitted and in gitlab format')}
root_path: root_path:
description: {_("Root family name")} description: {_("Root family name")}

5
src/rougail/output_doc/doc.py
View file

@ -104,7 +104,7 @@ class RougailOutputDoc(Examples, Changelog):
def load_formatter(self) -> str: def load_formatter(self) -> str:
output_format = self.rougailconfig["doc.output_format"] output_format = self.rougailconfig["doc.output_format"]
self.formatter = self.outputs[output_format](self.rougailconfig) self.formatter = self.outputs[output_format](self.rougailconfig, support_namespace=self.support_namespace)
def print(self) -> None: def print(self) -> None:
ret, data = self.run() ret, data = self.run()
@ -395,6 +395,9 @@ class RougailOutputDoc(Examples, Changelog):
"name": name, "name": name,
"values": values, "values": values,
} }
alternative_name = variable.information.get("alternative_name", None)
if alternative_name:
informations["alternative_name"] = alternative_name
return True return True
def _populate( def _populate(

BIN
src/rougail/output_doc/locale/fr/LC_MESSAGES/rougail_output_doc.mo
View file

Binary file not shown.

6
src/rougail/output_doc/output/console.py
View file

@ -36,7 +36,7 @@ class Formatter(CommonFormatter):
"title5": "dark_green underline bold", "title5": "dark_green underline bold",
} }
def __init__(self, rougailconfig) -> None: def __init__(self, rougailconfig, **kwargs) -> None:
from rich.table import Table from rich.table import Table
from rich.theme import Theme from rich.theme import Theme
from rich.console import Console from rich.console import Console
@ -47,11 +47,11 @@ class Formatter(CommonFormatter):
self.rich_syntaxt = Syntax self.rich_syntaxt = Syntax
self.custom_theme = Theme(self.titles_color) self.custom_theme = Theme(self.titles_color)
self.max_line = 0 self.max_line = 0
super().__init__(rougailconfig) super().__init__(rougailconfig, **kwargs)
def _run(self, dico: dict, level: int, dico_is_already_treated=False) -> str: def _run(self, dico: dict, level: int, dico_is_already_treated=False) -> str:
if not dico_is_already_treated: if not dico_is_already_treated:
dico = self.dict_to_dict(dico, level) dico = self.dict_to_dict(dico, level, init=True)
return self.compute(dico) return self.compute(dico)
def compute(self, dico): def compute(self, dico):

2
src/rougail/output_doc/output/github.py
View file

@ -39,7 +39,7 @@ class Formatter(CommonFormatter):
def __init__(self, rougailconfig, **kwarg) -> None: def __init__(self, rougailconfig, **kwarg) -> None:
self.max_line_variable = 0 self.max_line_variable = 0
self.max_line_description = 0 self.max_line_description = 0
super().__init__(rougailconfig) super().__init__(rougailconfig, **kwarg)
def title( def title(
self, self,

68
src/rougail/output_doc/utils.py
View file

@ -21,12 +21,15 @@ from typing import Tuple, List, Optional
from io import BytesIO from io import BytesIO
from ruamel.yaml import YAML from ruamel.yaml import YAML
import tabulate as tabulate_module import tabulate as tabulate_module
from tiramisu.error import display_list
from tabulate import tabulate from tabulate import tabulate
from rougail.tiramisu import normalize_family from rougail.tiramisu import normalize_family
from tiramisu import undefined from tiramisu import undefined
from tiramisu.error import PropertiesOptionError from tiramisu.error import PropertiesOptionError, display_list
try:
from tiramisu_cmdline_parser.api import gen_argument_name
except:
gen_argument_name = None
from .i18n import _ from .i18n import _
@ -153,10 +156,11 @@ class CommonFormatter:
# tabulate module name # tabulate module name
name = None name = None
def __init__(self, rougailconfig, **kwarg): def __init__(self, rougailconfig, support_namespace, **kwarg):
tabulate_module.PRESERVE_WHITESPACE = True tabulate_module.PRESERVE_WHITESPACE = True
self.header_setted = False self.header_setted = False
self.rougailconfig = rougailconfig self.rougailconfig = rougailconfig
self.support_namespace = support_namespace
def run( def run(
self, informations: dict, *, dico_is_already_treated=False self, informations: dict, *, dico_is_already_treated=False
@ -168,12 +172,22 @@ class CommonFormatter:
if self.root: if self.root:
current = informations current = informations
for path in self.root.split('.'): for path in self.root.split('.'):
info = current[path]['informations']
current = current[path]["children"] current = current[path]["children"]
informations = current informations = {"informations": info, "children": current}
return self._run(informations, level, dico_is_already_treated) return self._run(informations, level, dico_is_already_treated)
return "" return ""
def options(self): def options(self):
self.with_commandline = self.rougailconfig["doc.with_commandline"]
self.with_environment = self.rougailconfig["doc.with_environment"]
if self.with_environment and not gen_argument_name:
raise Exception('please install tiramisu_cmdline_parser')
if not self.rougailconfig["main_namespace"] and self.with_environment:
if self.support_namespace:
self.prefix = ""
else:
self.prefix = self.rougailconfig["doc.environment_default_environment_name"] + "_"
self.with_family = not self.rougailconfig["doc.without_family"] self.with_family = not self.rougailconfig["doc.without_family"]
self.root = self.rougailconfig["doc.root"] self.root = self.rougailconfig["doc.root"]
self.other_root_filenames = None self.other_root_filenames = None
@ -285,15 +299,29 @@ class CommonFormatter:
modified_attributes: dict, modified_attributes: dict,
force_identifiers: Optional[str], force_identifiers: Optional[str],
*, *,
is_variable=False is_variable=False,
variable_prefix: str="",
is_bold: bool=True,
is_upper: bool=False,
) -> str: ) -> str:
ret_paths = [] ret_paths = []
path = informations["path"] path = informations["path"]
if is_bold:
bold = self.bold
else:
def bold(value):
return value
if is_upper:
def upper(value):
return value.upper()
else:
def upper(value):
return value
if "identifiers" in modified_attributes: if "identifiers" in modified_attributes:
name, previous, new = modified_attributes["identifiers"] name, previous, new = modified_attributes["identifiers"]
ret_paths.extend( ret_paths.extend(
[ [
self.bold(self.delete(calc_path(path, self, identifier))) bold(self.delete(upper(variable_prefix + calc_path(path, self, identifier))))
for identifier in previous for identifier in previous
] ]
) )
@ -304,13 +332,15 @@ class CommonFormatter:
if force_identifiers and identifier != force_identifiers: if force_identifiers and identifier != force_identifiers:
continue continue
path_ = calc_path(path, self, identifier) path_ = calc_path(path, self, identifier)
if variable_prefix:
path_ = variable_prefix + upper(path_)
if not idx: if not idx:
path_ = self.anchor(path_, path) path_ = self.anchor(path_, path)
if identifier in new: if identifier in new:
path_ = self.underline(path_) path_ = self.underline(path_)
ret_paths.append(self.bold(path_)) ret_paths.append(bold(path_))
else: else:
ret_paths.append(self.bold(self.anchor(path, path))) ret_paths.append(bold(self.anchor(variable_prefix + upper(path), path)))
return ret_paths return ret_paths
def table_header( def table_header(
@ -341,6 +371,10 @@ class CommonFormatter:
else: else:
table_datas = [] table_datas = []
ori_level = None ori_level = None
if init and self.root:
if self.with_family:
msg.extend(self.family_to_string(dico["informations"], level, False))
dico = dico["children"]
for value in dico.values(): for value in dico.values():
if value["type"] == "variable": if value["type"] == "variable":
self.variable_to_string(value, table_datas) self.variable_to_string(value, table_datas)
@ -525,10 +559,26 @@ class CommonFormatter:
multi, properties = self.property_to_string( multi, properties = self.property_to_string(
informations, calculated_properties, modified_attributes, informations, calculated_properties, modified_attributes,
) )
paths = self.display_paths(informations, modified_attributes, force_identifiers, is_variable=True)
first_col = [ first_col = [
self.join(self.display_paths(informations, modified_attributes, force_identifiers, is_variable=True)), self.join(paths),
properties, properties,
] ]
if self.with_commandline:
paths = self.display_paths(informations, modified_attributes, force_identifiers, is_variable=True, is_bold=False, variable_prefix="--")
variable_type = informations["properties"][0]["name"]
if variable_type == 'boolean':
for path in list(paths):
paths.append(gen_argument_name(path, False, True, False))
if "alternative_name" in informations:
alternative_name = informations["alternative_name"]
paths[0] += f", -{alternative_name}"
if variable_type == 'boolean':
paths[1] += ", -" + gen_argument_name(alternative_name, True, True, False)
first_col.append(self.section(_("Command line"), paths))
if self.with_environment:
paths = self.display_paths(informations, modified_attributes, force_identifiers, is_variable=True, is_bold=False, is_upper=True, variable_prefix=self.prefix)
first_col.append(self.section(_("Environment variable"), paths))
self.columns(first_col) self.columns(first_col)
return multi, first_col return multi, first_col

14
tests/changelog/40_dynamic_variable_description_mod/after/rougail/00-base.yml Normal file
View file

@ -0,0 +1,14 @@
%YAML 1.2
---
version: 1.1
var: # A suffix variable
- val1
- val2
"dyn{{ identifier }}":
description: A dynamic family
dynamic:
variable: _.var
var: # A dynamic variable
...

14
tests/changelog/40_dynamic_variable_description_mod/before/rougail/00-base.yml Normal file
View file

@ -0,0 +1,14 @@
%YAML 1.2
---
version: 1.1
var: # A suffix variable
- val1
- val2
"dyn{{ identifier }}":
description: A dynamic family {{ identifier }}
dynamic:
variable: _.var
var: # A dynamic variable {{ identifier }}
...

11
tests/changelog/40_dynamic_variable_description_mod/result.adoc Normal file
View file

@ -0,0 +1,11 @@
== Modified variable
[cols="1a,1a"]
|====
| Variable | Description
| **dyn__val1__.var** +
**dyn__val2__.var** +
`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `basic` `mandatory` | +++A dynamic variable {{ identifier }}.+++ +
#A dynamic variable.#
|====

8
tests/changelog/40_dynamic_variable_description_mod/result.gitlab.md Normal file
View file

@ -0,0 +1,8 @@
<details><summary>Modified variable</summary>
| Variable | Description |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------|
| **<a id="dyn:::identifier:::.var" name="dyn:::identifier:::.var">dyn*val1*.var</a>**<br/>**dyn*val2*.var**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory` | ~~A dynamic variable {{ identifier }}.~~<br/><ins>A dynamic variable.</ins> |
</details>

11
tests/changelog/40_dynamic_variable_description_mod/result.html Normal file
View file

@ -0,0 +1,11 @@
<h1>Modified variable</h1>
<table>
<thead>
<tr><th>Variable </th><th>Description </th></tr>
</thead>
<tbody>
<tr><td><b>dyn<i>val1</i>.var</b><br/><b>dyn<i>val2</i>.var</b><br/><mark><a href='https://rougail.readthedocs.io/en/latest/variable.html#variables-types'>string</a></mark> <mark>basic</mark> <mark>mandatory</mark></td><td><del>A dynamic variable {{ identifier }}.</del><br/><ins>A dynamic variable.</ins></td></tr>
</tbody>
</table>

6
tests/changelog/40_dynamic_variable_description_mod/result.md Normal file
View file

@ -0,0 +1,6 @@
# Modified variable
| Variable&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | Description&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **<a id="dyn:::identifier:::.var" name="dyn:::identifier:::.var">dyn*val1*.var</a>**<br/>**dyn*val2*.var**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory` | ~~A dynamic variable {{ identifier }}.~~<br/><ins>A dynamic variable.</ins> |

10
tests/changelog/40_dynamic_variable_description_mod/result.sh Normal file
View file

@ -0,0 +1,10 @@
Modified variable
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Variable  ┃ Description  ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ dynval1.var │ A dynamic variable {{ identifier }}. │
│ dynval2.var │ A dynamic variable. │
│  string   basic   mandatory  │ │
└───────────────────────────────────────┴──────────────────────────────────────┘

14
tests/changelog/40_dynamic_variable_description_mod2/after/rougail/00-base.yml Normal file
View file

@ -0,0 +1,14 @@
%YAML 1.2
---
version: 1.1
var: # A suffix variable
- val1
- val2
"dyn{{ identifier }}":
description: A dynamic family {{ identifier }}
dynamic:
variable: _.var
var: # A dynamic variable {{ identifier }}
...

14
tests/changelog/40_dynamic_variable_description_mod2/before/rougail/00-base.yml Normal file
View file

@ -0,0 +1,14 @@
%YAML 1.2
---
version: 1.1
var: # A suffix variable
- val1
- val2
"dyn{{ identifier }}":
description: A dynamic family
dynamic:
variable: _.var
var: # A dynamic variable
...

11
tests/changelog/40_dynamic_variable_description_mod2/result.adoc Normal file
View file

@ -0,0 +1,11 @@
== Modified variable
[cols="1a,1a"]
|====
| Variable | Description
| **dyn__val1__.var** +
**dyn__val2__.var** +
`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `basic` `mandatory` | +++A dynamic variable.+++ +
A dynamic variable __val1__ or __val2__.
|====

8
tests/changelog/40_dynamic_variable_description_mod2/result.gitlab.md Normal file
View file

@ -0,0 +1,8 @@
<details><summary>Modified variable</summary>
| Variable | Description |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------|
| **<a id="dyn:::identifier:::.var" name="dyn:::identifier:::.var">dyn*val1*.var</a>**<br/>**dyn*val2*.var**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory` | ~~A dynamic variable.~~<br/>A dynamic variable *val1* or *val2*. |
</details>

11
tests/changelog/40_dynamic_variable_description_mod2/result.html Normal file
View file

@ -0,0 +1,11 @@
<h1>Modified variable</h1>
<table>
<thead>
<tr><th>Variable </th><th>Description </th></tr>
</thead>
<tbody>
<tr><td><b>dyn<i>val1</i>.var</b><br/><b>dyn<i>val2</i>.var</b><br/><mark><a href='https://rougail.readthedocs.io/en/latest/variable.html#variables-types'>string</a></mark> <mark>basic</mark> <mark>mandatory</mark></td><td><del>A dynamic variable.</del><br/>A dynamic variable <i>val1</i> or <i>val2</i>.</td></tr>
</tbody>
</table>

6
tests/changelog/40_dynamic_variable_description_mod2/result.md Normal file
View file

@ -0,0 +1,6 @@
# Modified variable
| Variable&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | Description&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **<a id="dyn:::identifier:::.var" name="dyn:::identifier:::.var">dyn*val1*.var</a>**<br/>**dyn*val2*.var**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory` | ~~A dynamic variable.~~<br/>A dynamic variable *val1* or *val2*. |

10
tests/changelog/40_dynamic_variable_description_mod2/result.sh Normal file
View file

@ -0,0 +1,10 @@
Modified variable
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Variable  ┃ Description  ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ dynval1.var │ A dynamic variable. │
│ dynval2.var │ A dynamic variable val1 or val2. │
│  string   basic   mandatory  │ │
└───────────────────────────────────────┴──────────────────────────────────────┘