--- gitea: none include_toc: true --- # Two columns ## Generate documentation > **🛈 Informations** > > **doc**\ > `basic` *`disabled`*\ > **Disabled**: when "[Generate documentation](#doc)" is not set in "[Select for output](#step.output)" | Variable | Description | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **doc.title_level**
[`integer`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`
**Command line**: -dt, --doc.title_level
**Environment variable**: ROUGAILCLI_DOC.TITLE_LEVEL | Starting title level.
**Default**: 1 | | **doc.contents**
[`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` `standard` `mandatory` `unique`
**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").
**Choices**:
• variables **← (default)**
• example
• changelog | | **doc.previous_json_file**
[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory` *`disabled`*
**Command line**: -dp, --doc.previous_json_file
**Environment variable**: ROUGAILCLI_DOC.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.
**Disabled**: if changelog is not selected in "[Generated content](#doc.contents)" | | **doc.without_family**
[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*
**Command line**:
• -df, --doc.without_family
• -ndf, --doc.no-without_family
**Environment variable**: ROUGAILCLI_DOC.WITHOUT_FAMILY | Do not add families in documentation.
**Default**: false
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | | **doc.with_commandline**
[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*
**Command line**:
• -dw, --doc.with_commandline
• -ndw, --doc.no-with_commandline
**Environment variable**: ROUGAILCLI_DOC.WITH_COMMANDLINE | Add command line informations in documentation.
**Default**: false
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | | **doc.with_environment**
[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*
**Command line**:
• -de, --doc.with_environment
• -nde, --doc.no-with_environment
**Environment variable**: ROUGAILCLI_DOC.WITH_ENVIRONMENT | Add environment variable informations in documentation.
**Default**: false
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | | **doc.environment_prefix**
[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*
**Command line**: -dd, --doc.environment_prefix
**Environment variable**: ROUGAILCLI_DOC.ENVIRONMENT_PREFIX | Name of the default environment prefix.
**Validator**: should only user uppercase characters
**Default**: ROUGAIL
**Disabled**: when "__.main_namespace" is not set or "[Add environment variable informations in documentation](#doc.with_environment)" is false | | **doc.default_values**
[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`
**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.
**Default**: true | | **doc.comment_examples**
[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*
**Command line**:
• -dx, --doc.comment_examples
• -ndx, --doc.no-comment_examples
**Environment variable**: ROUGAILCLI_DOC.COMMENT_EXAMPLES | Add description of variables and families when generate examples.
**Default**: false
**Disabled**: disabled when example in not in contents | | **doc.comment_examples_column**
[`integer`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*
**Command line**: --doc.comment_examples_column
**Environment variable**: ROUGAILCLI_DOC.COMMENT_EXAMPLES_COLUMN | Comment in examples starts at column.
**Default**: 30
**Disabled**: when the variable "[Add description of variables and families when generate examples](#doc.comment_examples)" is accessible and has the value "false" | | **doc.output_format**
[`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`
**Command line**: -do, --doc.output_format
**Environment variable**: ROUGAILCLI_DOC.OUTPUT_FORMAT | Generate document in format.
**Validator**: json output_format is not compatible with "changelog" and "example" contents
**Choices**:
• console **← (default)**
• asciidoc
• html
• github
• gitlab
• json | | **doc.table_model**
[`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`
**Command line**: -dm, --doc.table_model
**Environment variable**: ROUGAILCLI_DOC.TABLE_MODEL | Generate document with this table model.
**Validator**: json output_format is not compatible with "changelog" and "example" contents
**Choices**:
• two_columns **← (default)**
• three_columns
• four_columns
• five_columns
• six_columns | | **doc.true_color_terminal**
[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`
**Command line**:
• --doc.true_color_terminal
• --doc.no-true_color_terminal
**Environment variable**: ROUGAILCLI_DOC.TRUE_COLOR_TERMINAL | Force true color terminal.
**Default**: false | | **doc.root**
[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard`
**Command line**: -dr, --doc.root
**Environment variable**: ROUGAILCLI_DOC.ROOT | Document the variables from this family. | ## Families or variables for this family are in an other file name > **🛈 Informations** > > **doc.other_root_filenames**\ > This family contains lists of variable blocks.\ > `basic` *`disabled`*\ > **Disabled**: if "[Document the variables from this family](#doc.root)" haven't any value | Variable | Description | |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------| | **doc.other_root_filenames.root_path**
[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` `standard` `unique`
**Command line**: --doc.other_root_filenames.root_path
**Environment variable**: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.ROOT_PATH | Root family name. | | **doc.other_root_filenames.filename**
[`UNIX filename`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory`
**Command line**: --doc.other_root_filenames.filename
**Environment variable**: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.FILENAME | Name of the file.
**Validators**:
• this filename could be a relative path
• file type allowed: "directory" and "file" | # Three columns ## Generate documentation > **🛈 Informations** > > **doc**\ > `basic` *`disabled`*\ > **Disabled**: when "[Generate documentation](#doc)" is not set in "[Select for output](#step.output)" | Variable | Description | Default value | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------| | **doc.title_level**
[`integer`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`
**Command line**: -dt, --doc.title_level
**Environment variable**: ROUGAILCLI_DOC.TITLE_LEVEL | Starting title level. | 1 | | **doc.contents**
[`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` `standard` `mandatory` `unique`
**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").
**Choices**:
• variables
• example
• changelog | • variables | | **doc.previous_json_file**
[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory` *`disabled`*
**Command line**: -dp, --doc.previous_json_file
**Environment variable**: ROUGAILCLI_DOC.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.
**Disabled**: if changelog is not selected in "[Generated content](#doc.contents)" | | | **doc.without_family**
[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*
**Command line**:
• -df, --doc.without_family
• -ndf, --doc.no-without_family
**Environment variable**: ROUGAILCLI_DOC.WITHOUT_FAMILY | Do not add families in documentation.
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | false | | **doc.with_commandline**
[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*
**Command line**:
• -dw, --doc.with_commandline
• -ndw, --doc.no-with_commandline
**Environment variable**: ROUGAILCLI_DOC.WITH_COMMANDLINE | Add command line informations in documentation.
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | false | | **doc.with_environment**
[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*
**Command line**:
• -de, --doc.with_environment
• -nde, --doc.no-with_environment
**Environment variable**: ROUGAILCLI_DOC.WITH_ENVIRONMENT | Add environment variable informations in documentation.
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | false | | **doc.environment_prefix**
[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*
**Command line**: -dd, --doc.environment_prefix
**Environment variable**: ROUGAILCLI_DOC.ENVIRONMENT_PREFIX | Name of the default environment prefix.
**Validator**: should only user uppercase characters
**Disabled**: when "__.main_namespace" is not set or "[Add environment variable informations in documentation](#doc.with_environment)" is false | ROUGAIL | | **doc.default_values**
[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`
**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 | | **doc.comment_examples**
[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*
**Command line**:
• -dx, --doc.comment_examples
• -ndx, --doc.no-comment_examples
**Environment variable**: ROUGAILCLI_DOC.COMMENT_EXAMPLES | Add description of variables and families when generate examples.
**Disabled**: disabled when example in not in contents | false | | **doc.comment_examples_column**
[`integer`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*
**Command line**: --doc.comment_examples_column
**Environment variable**: ROUGAILCLI_DOC.COMMENT_EXAMPLES_COLUMN | Comment in examples starts at column.
**Disabled**: when the variable "[Add description of variables and families when generate examples](#doc.comment_examples)" is accessible and has the value "false" | 30 | | **doc.output_format**
[`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`
**Command line**: -do, --doc.output_format
**Environment variable**: ROUGAILCLI_DOC.OUTPUT_FORMAT | Generate document in format.
**Validator**: json output_format is not compatible with "changelog" and "example" contents
**Choices**:
• console
• asciidoc
• html
• github
• gitlab
• json | console | | **doc.table_model**
[`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`
**Command line**: -dm, --doc.table_model
**Environment variable**: ROUGAILCLI_DOC.TABLE_MODEL | Generate document with this table model.
**Validator**: json output_format is not compatible with "changelog" and "example" contents
**Choices**:
• two_columns
• three_columns
• four_columns
• five_columns
• six_columns | two_columns | | **doc.true_color_terminal**
[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`
**Command line**:
• --doc.true_color_terminal
• --doc.no-true_color_terminal
**Environment variable**: ROUGAILCLI_DOC.TRUE_COLOR_TERMINAL | Force true color terminal. | false | | **doc.root**
[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard`
**Command line**: -dr, --doc.root
**Environment variable**: ROUGAILCLI_DOC.ROOT | Document the variables from this family. | | ## Families or variables for this family are in an other file name > **🛈 Informations** > > **doc.other_root_filenames**\ > This family contains lists of variable blocks.\ > `basic` *`disabled`*\ > **Disabled**: if "[Document the variables from this family](#doc.root)" haven't any value | Variable | Description | |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------| | **doc.other_root_filenames.root_path**
[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` `standard` `unique`
**Command line**: --doc.other_root_filenames.root_path
**Environment variable**: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.ROOT_PATH | Root family name. | | **doc.other_root_filenames.filename**
[`UNIX filename`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory`
**Command line**: --doc.other_root_filenames.filename
**Environment variable**: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.FILENAME | Name of the file.
**Validators**:
• this filename could be a relative path
• file type allowed: "directory" and "file" | # Four columns ## Generate documentation > **🛈 Informations** > > **doc**\ > `basic` *`disabled`*\ > **Disabled**: when "[Generate documentation](#doc)" is not set in "[Select for output](#step.output)" | Variable | Description | Default value | Type | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|-----------------------------------------------------------------------------------------------------------| | **doc.title_level**
`standard`
**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.contents**
`standard` `unique`
**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").
**Choices**:
• variables
• example
• changelog | • variables | [`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` `mandatory` | | **doc.previous_json_file**
`basic` *`disabled`*
**Command line**: -dp, --doc.previous_json_file
**Environment variable**: ROUGAILCLI_DOC.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.
**Disabled**: if changelog is not selected in "[Generated content](#doc.contents)" | | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | **doc.without_family**
`standard` *`disabled`*
**Command line**:
• -df, --doc.without_family
• -ndf, --doc.no-without_family
**Environment variable**: ROUGAILCLI_DOC.WITHOUT_FAMILY | Do not add families in documentation.
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | **doc.with_commandline**
`standard` *`disabled`*
**Command line**:
• -dw, --doc.with_commandline
• -ndw, --doc.no-with_commandline
**Environment variable**: ROUGAILCLI_DOC.WITH_COMMANDLINE | Add command line informations in documentation.
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | **doc.with_environment**
`standard` *`disabled`*
**Command line**:
• -de, --doc.with_environment
• -nde, --doc.no-with_environment
**Environment variable**: ROUGAILCLI_DOC.WITH_ENVIRONMENT | Add environment variable informations in documentation.
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | **doc.environment_prefix**
`standard` *`disabled`*
**Command line**: -dd, --doc.environment_prefix
**Environment variable**: ROUGAILCLI_DOC.ENVIRONMENT_PREFIX | Name of the default environment prefix.
**Validator**: should only user uppercase characters
**Disabled**: when "__.main_namespace" is not set or "[Add environment variable informations in documentation](#doc.with_environment)" is false | ROUGAIL | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | **doc.default_values**
`standard`
**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.comment_examples**
`standard` *`disabled`*
**Command line**:
• -dx, --doc.comment_examples
• -ndx, --doc.no-comment_examples
**Environment variable**: ROUGAILCLI_DOC.COMMENT_EXAMPLES | Add description of variables and families when generate examples.
**Disabled**: disabled when example in not in contents | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | **doc.comment_examples_column**
`standard` *`disabled`*
**Command line**: --doc.comment_examples_column
**Environment variable**: ROUGAILCLI_DOC.COMMENT_EXAMPLES_COLUMN | Comment in examples starts at column.
**Disabled**: when the variable "[Add description of variables and families when generate examples](#doc.comment_examples)" is accessible and has the value "false" | 30 | [`integer`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | **doc.output_format**
`standard`
**Command line**: -do, --doc.output_format
**Environment variable**: ROUGAILCLI_DOC.OUTPUT_FORMAT | Generate document in format.
**Validator**: json output_format is not compatible with "changelog" and "example" contents
**Choices**:
• console
• asciidoc
• html
• github
• gitlab
• json | console | [`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | **doc.table_model**
`standard`
**Command line**: -dm, --doc.table_model
**Environment variable**: ROUGAILCLI_DOC.TABLE_MODEL | Generate document with this table model.
**Validator**: json output_format is not compatible with "changelog" and "example" contents
**Choices**:
• two_columns
• three_columns
• four_columns
• five_columns
• six_columns | two_columns | [`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | **doc.true_color_terminal**
`standard`
**Command line**:
• --doc.true_color_terminal
• --doc.no-true_color_terminal
**Environment variable**: ROUGAILCLI_DOC.TRUE_COLOR_TERMINAL | Force true color terminal. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | | **doc.root**
`standard`
**Command line**: -dr, --doc.root
**Environment variable**: ROUGAILCLI_DOC.ROOT | Document the variables from this family. | | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) | ## Families or variables for this family are in an other file name > **🛈 Informations** > > **doc.other_root_filenames**\ > This family contains lists of variable blocks.\ > `basic` *`disabled`*\ > **Disabled**: if "[Document the variables from this family](#doc.root)" haven't any value | Variable | Description | Type | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------| | **doc.other_root_filenames.root_path**
`standard` `unique`
**Command line**: --doc.other_root_filenames.root_path
**Environment variable**: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.ROOT_PATH | Root family name. | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` | | **doc.other_root_filenames.filename**
`basic`
**Command line**: --doc.other_root_filenames.filename
**Environment variable**: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.FILENAME | Name of the file.
**Validators**:
• this filename could be a relative path
• file type allowed: "directory" and "file" | [`UNIX filename`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | # Five columns ## Generate documentation > **🛈 Informations** > > **doc**\ > `basic` *`disabled`*\ > **Disabled**: when "[Generate documentation](#doc)" is not set in "[Select for output](#step.output)" | Variable | Description | Default value | Type | Access control | |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|-----------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **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` | `standard` | | **doc.contents**
`unique`
**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").
**Choices**:
• variables
• example
• changelog | • variables | [`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` `mandatory` | `standard` | | **doc.previous_json_file**
**Command line**: -dp, --doc.previous_json_file
**Environment variable**: ROUGAILCLI_DOC.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` | `basic` *`disabled`*
**Disabled**: if changelog is not selected in "[Generated content](#doc.contents)" | | **doc.without_family**
**Command line**:
• -df, --doc.without_family
• -ndf, --doc.no-without_family
**Environment variable**: ROUGAILCLI_DOC.WITHOUT_FAMILY | Do not add families in documentation. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` *`disabled`*
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | | **doc.with_commandline**
**Command line**:
• -dw, --doc.with_commandline
• -ndw, --doc.no-with_commandline
**Environment variable**: ROUGAILCLI_DOC.WITH_COMMANDLINE | Add command line informations in documentation. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` *`disabled`*
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | | **doc.with_environment**
**Command line**:
• -de, --doc.with_environment
• -nde, --doc.no-with_environment
**Environment variable**: ROUGAILCLI_DOC.WITH_ENVIRONMENT | Add environment variable informations in documentation. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` *`disabled`*
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | | **doc.environment_prefix**
**Command line**: -dd, --doc.environment_prefix
**Environment variable**: ROUGAILCLI_DOC.ENVIRONMENT_PREFIX | Name of the default environment prefix.
**Validator**: should only user uppercase characters | ROUGAIL | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` *`disabled`*
**Disabled**: when "__.main_namespace" is not set or "[Add environment variable informations in documentation](#doc.with_environment)" is false | | **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` | `standard` | | **doc.comment_examples**
**Command line**:
• -dx, --doc.comment_examples
• -ndx, --doc.no-comment_examples
**Environment variable**: ROUGAILCLI_DOC.COMMENT_EXAMPLES | Add description of variables and families when generate examples. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` *`disabled`*
**Disabled**: disabled when example in not in contents | | **doc.comment_examples_column**
**Command line**: --doc.comment_examples_column
**Environment variable**: ROUGAILCLI_DOC.COMMENT_EXAMPLES_COLUMN | Comment in examples starts at column. | 30 | [`integer`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` *`disabled`*
**Disabled**: when the variable "[Add description of variables and families when generate examples](#doc.comment_examples)" is accessible and has the value "false" | | **doc.output_format**
**Command line**: -do, --doc.output_format
**Environment variable**: ROUGAILCLI_DOC.OUTPUT_FORMAT | Generate document in format.
**Validator**: json output_format is not compatible with "changelog" and "example" contents
**Choices**:
• console
• asciidoc
• html
• github
• gitlab
• json | console | [`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` | | **doc.table_model**
**Command line**: -dm, --doc.table_model
**Environment variable**: ROUGAILCLI_DOC.TABLE_MODEL | Generate document with this table model.
**Validator**: json output_format is not compatible with "changelog" and "example" contents
**Choices**:
• two_columns
• three_columns
• four_columns
• five_columns
• six_columns | two_columns | [`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` | | **doc.true_color_terminal**
**Command line**:
• --doc.true_color_terminal
• --doc.no-true_color_terminal
**Environment variable**: ROUGAILCLI_DOC.TRUE_COLOR_TERMINAL | Force true color terminal. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` | | **doc.root**
**Command line**: -dr, --doc.root
**Environment variable**: ROUGAILCLI_DOC.ROOT | Document the variables from this family. | | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) | `standard` | ## Families or variables for this family are in an other file name > **🛈 Informations** > > **doc.other_root_filenames**\ > This family contains lists of variable blocks.\ > `basic` *`disabled`*\ > **Disabled**: if "[Document the variables from this family](#doc.root)" haven't any value | Variable | Description | Type | Access control | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|------------------| | **doc.other_root_filenames.root_path**
`unique`
**Command line**: --doc.other_root_filenames.root_path
**Environment variable**: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.ROOT_PATH | Root family name. | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` | `standard` | | **doc.other_root_filenames.filename**
**Command line**: --doc.other_root_filenames.filename
**Environment variable**: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.FILENAME | Name of the file.
**Validators**:
• this filename could be a relative path
• file type allowed: "directory" and "file" | [`UNIX filename`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `basic` | # Six columns ## Generate documentation > **🛈 Informations** > > **doc**\ > `basic` *`disabled`*\ > **Disabled**: when "[Generate documentation](#doc)" is not set in "[Select for output](#step.output)" | Variable | Description | Default value | Type | Access control | Validator | |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|-----------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------| | **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` | `standard` | | | **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").
**Choices**:
• variables
• example
• changelog | • variables | [`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` `mandatory` | `standard` | `unique` | | **doc.previous_json_file**
**Command line**: -dp, --doc.previous_json_file
**Environment variable**: ROUGAILCLI_DOC.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` | `basic` *`disabled`*
**Disabled**: if changelog is not selected in "[Generated content](#doc.contents)" | | | **doc.without_family**
**Command line**:
• -df, --doc.without_family
• -ndf, --doc.no-without_family
**Environment variable**: ROUGAILCLI_DOC.WITHOUT_FAMILY | Do not add families in documentation. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` *`disabled`*
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | | | **doc.with_commandline**
**Command line**:
• -dw, --doc.with_commandline
• -ndw, --doc.no-with_commandline
**Environment variable**: ROUGAILCLI_DOC.WITH_COMMANDLINE | Add command line informations in documentation. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` *`disabled`*
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | | | **doc.with_environment**
**Command line**:
• -de, --doc.with_environment
• -nde, --doc.no-with_environment
**Environment variable**: ROUGAILCLI_DOC.WITH_ENVIRONMENT | Add environment variable informations in documentation. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` *`disabled`*
**Disabled**: if "[Generate document in format](#doc.output_format)" is json or "[Generated content](#doc.contents)" hasn't variable or changelog | | | **doc.environment_prefix**
**Command line**: -dd, --doc.environment_prefix
**Environment variable**: ROUGAILCLI_DOC.ENVIRONMENT_PREFIX | Name of the default environment prefix. | ROUGAIL | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` *`disabled`*
**Disabled**: when "__.main_namespace" is not set or "[Add environment variable informations in documentation](#doc.with_environment)" is false | Should only user uppercase characters. | | **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` | `standard` | | | **doc.comment_examples**
**Command line**:
• -dx, --doc.comment_examples
• -ndx, --doc.no-comment_examples
**Environment variable**: ROUGAILCLI_DOC.COMMENT_EXAMPLES | Add description of variables and families when generate examples. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` *`disabled`*
**Disabled**: disabled when example in not in contents | | | **doc.comment_examples_column**
**Command line**: --doc.comment_examples_column
**Environment variable**: ROUGAILCLI_DOC.COMMENT_EXAMPLES_COLUMN | Comment in examples starts at column. | 30 | [`integer`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` *`disabled`*
**Disabled**: when the variable "[Add description of variables and families when generate examples](#doc.comment_examples)" is accessible and has the value "false" | | | **doc.output_format**
**Command line**: -do, --doc.output_format
**Environment variable**: ROUGAILCLI_DOC.OUTPUT_FORMAT | Generate document in format.
**Choices**:
• console
• asciidoc
• html
• github
• gitlab
• json | console | [`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` | Json output_format is not compatible with "changelog" and "example" contents. | | **doc.table_model**
**Command line**: -dm, --doc.table_model
**Environment variable**: ROUGAILCLI_DOC.TABLE_MODEL | Generate document with this table model.
**Choices**:
• two_columns
• three_columns
• four_columns
• five_columns
• six_columns | two_columns | [`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` | Json output_format is not compatible with "changelog" and "example" contents. | | **doc.true_color_terminal**
**Command line**:
• --doc.true_color_terminal
• --doc.no-true_color_terminal
**Environment variable**: ROUGAILCLI_DOC.TRUE_COLOR_TERMINAL | Force true color terminal. | false | [`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `mandatory` | `standard` | | | **doc.root**
**Command line**: -dr, --doc.root
**Environment variable**: ROUGAILCLI_DOC.ROOT | Document the variables from this family. | | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) | `standard` | | ## Families or variables for this family are in an other file name > **🛈 Informations** > > **doc.other_root_filenames**\ > This family contains lists of variable blocks.\ > `basic` *`disabled`*\ > **Disabled**: if "[Document the variables from this family](#doc.root)" haven't any value | Variable | Description | Type | Access control | Validator | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|-------------------------------------------------------------------------------------------------------|------------------|-----------------------------------------------------------------------------------------------------| | **doc.other_root_filenames.root_path**
**Command line**: --doc.other_root_filenames.root_path
**Environment variable**: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.ROOT_PATH | Root family name. | [`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` | `standard` | `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` | `basic` | • this filename could be a relative path
• file type allowed: "directory" and "file". |