--- gitea: none include_toc: true --- [🇬🇧 (EN)](README.md) - [🇫🇷 (FR)](README.fr.md) ## Generate documentation from structural files > **🛈 Informations** > > The structural files contain all the information related to the variables. This output generates the documentation for all or some of these variables.\ > **Path**: doc\ > *`disabled`*\ > **Disabled**: if doc is not set in "[Select for output](#step.output)" | Variable | Description | Default value | Type | Access control | Validator | |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|-----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------| | **doc.output_format**
**Command line**: -do, --doc.output_format
**Environment variable**: ROUGAILCLI_DOC.OUTPUT_FORMAT | The output format of the generated documentation. | console | [`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | **Choices**:
• console
• asciidoc
• html
• github
• gitlab
• json | | **doc.tabular_template**
**Command line**: -dm, --doc.tabular_template
**Environment variable**: ROUGAILCLI_DOC.TABULAR_TEMPLATE | Generate document with this tabular model.
The variables are documented with a tabular view. A template selection allows you to choose the content of each column. | two_columns | [`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | *`disabled`*
**Disabled**: "[The output format of the generated documentation](#doc.output_format)" in json is not compatible with this variable
| **Choices**:
• two_columns
• three_columns
• four_columns
• five_columns
• six_columns | | **doc.contents**
**Command line**: -dc, --doc.contents
**Environment variable**: ROUGAILCLI_DOC.CONTENTS | Generated content.
You can generate three type of document. All variables ("variables"), an example file in YAML format ("example") or change log ("changelog"). | • variables | [`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` `mandatory` | *`hidden`*
**Hidden**: "[The output format of the generated documentation](#doc.output_format)" in json is not compatible with changelog or example "[Generated content](#doc.contents)"
| `unique`
**Choices**:
• variables
• example
• changelog | | **doc.title_level**
**Command line**: -dt, --doc.title_level
**Environment variable**: ROUGAILCLI_DOC.TITLE_LEVEL | Starting title level. | 1 | [`integer`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | | | **doc.default_values**
**Command line**:
• --doc.default_values
• --doc.no-default_values
**Environment variable**: ROUGAILCLI_DOC.DEFAULT_VALUES | Modify values to document all variables.
To document leadership or dynamic family variables, it is sometimes necessary to generate values, which can change the values in the configuration. Be careful if you reuse this configuration. | true | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | | | **doc.true_color**
**Command line**:
• --doc.true_color
• --doc.no-true_color
**Environment variable**: ROUGAILCLI_DOC.TRUE_COLOR | Display documentation in console always with true color terminal. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | *`disabled`*
**Disabled**: when the variable "[The output format of the generated documentation](#doc.output_format)" hasn't the value "console" | | | **doc.root**
**Command line**: -dr, --doc.root
**Environment variable**: ROUGAILCLI_DOC.ROOT | Document the child variables of the family.
By default, all accessible variables are included in the documentation. It is possible to define the family from which the documentation should be generated. | | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) | | | ### The variables in this family are documented in another file > **🛈 Informations** > > If you separate the variables into different files, the links between the variables will break. Therefore, you must define different filenames for the files containing these variables.\ > This family contains lists of variable blocks.\ > **Path**: doc.other_root_filenames\ > *`disabled`*\ > **Disabled**: when the variable "[Document the child variables of the family](#doc.root)" has the value "null" | Variable | Description | Type | Validator | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------|-------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------| | **doc.other_root_filenames.root_path**
**Command line**: --doc.other_root_filenames.root_path
**Environment variable**: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.ROOT_PATH | This file contains child variables of the family. | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` | `unique` | | **doc.other_root_filenames.filename**
**Command line**: --doc.other_root_filenames.filename
**Environment variable**: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.FILENAME | Name of the file. | [`UNIX filename`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | • this filename could be a relative path
• file type allowed: "file". | ### Variables and changelog documentation > **🛈 Informations** > > **Path**: doc.tabulars\ > *`disabled`*\ > **Disabled**: if "[The output format of the generated documentation](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variables or changelog | Variable | Description | Default value | Type | Access control | Validator | |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------|-----------------|-------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------| | **doc.tabulars.without_family**
**Command line**:
• -df, --doc.tabulars.without_family
• -ndf, --doc.tabulars.no-without_family
**Environment variable**: ROUGAILCLI_DOC.TABULARS.WITHOUT_FAMILY | Do not add families in documentation. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | | | **doc.tabulars.with_commandline**
**Command line**:
• -dw, --doc.tabulars.with_commandline
• -ndw, --doc.tabulars.no-with_commandline
**Environment variable**: ROUGAILCLI_DOC.TABULARS.WITH_COMMANDLINE | Add command line informations in documentation. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | | | **doc.tabulars.with_environment**
**Command line**:
• -de, --doc.tabulars.with_environment
• -nde, --doc.tabulars.no-with_environment
**Environment variable**: ROUGAILCLI_DOC.TABULARS.WITH_ENVIRONMENT | Add environment variable informations in documentation. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | | | **doc.tabulars.environment_prefix**
**Command line**: -dv, --doc.tabulars.environment_prefix
**Environment variable**: ROUGAILCLI_DOC.TABULARS.ENVIRONMENT_PREFIX | Environment variables prefix name. | ROUGAIL | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | *`disabled`*
**Disabled**: if "main_namespace" is not set or "[Add environment variable informations in documentation](#doc.tabulars.with_environment)" is false | Should only use uppercase characters. | ### Changelog documentation > **🛈 Informations** > > **Path**: doc.changelog\ > *`disabled`*\ > **Disabled**: if changelog in not in "[Generated content](#doc.contents)" | Variable | Description | Type | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| | **doc.changelog.previous_json_file**
**Command line**: -dp, --doc.changelog.previous_json_file
**Environment variable**: ROUGAILCLI_DOC.CHANGELOG.PREVIOUS_JSON_FILE | Previous description file in JSON format.
To generate the changelog, you need to compare the old list of variables (in json format) with the current variables. | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | ### Examples configuration > **🛈 Informations** > > **Path**: doc.examples\ > *`disabled`*\ > **Disabled**: if example is not in "[Generated content](#doc.contents)" | Variable | Description | Default value | Type | Access control | |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------|-----------------|-------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **doc.examples.comment**
**Command line**:
• -dx, --doc.examples.comment
• -ndx, --doc.examples.no-comment
**Environment variable**: ROUGAILCLI_DOC.EXAMPLES.COMMENT | Add description of variables and families when generate examples. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | | **doc.examples.comment_column**
**Command line**: --doc.examples.comment_column
**Environment variable**: ROUGAILCLI_DOC.EXAMPLES.COMMENT_COLUMN | Comment in examples starts at column. | 30 | [`integer`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | *`disabled`*
**Disabled**: when the variable "[Add description of variables and families when generate examples](#doc.examples.comment)" has the value "false" |