94 KiB
Table of Contents
Two columns
Generate documentation
🛈 Informations
doc
disabled
Disabled: if doc is not set in "Select for output"
| Variable | Description |
|---|---|
doc.output_formatchoice mandatoryCommand line: -do, --doc.output_format Environment variable: ROUGAILCLI_DOC.OUTPUT_FORMAT |
The output format of the generated documentation. Choices: • console ← (default) • asciidoc • html • github • gitlab • json |
doc.tabular_templatechoice mandatory disabledCommand line: -dm, --doc.tabular_template Environment variable: ROUGAILCLI_DOC.TABULAR_TEMPLATE |
Generate document with this tabular model. The variables are documented with a table view. A template selection allows you to choose the content of each column. Choices: • two_columns ← (default) • three_columns • four_columns • five_columns • six_columns Disabled: "The output format of the generated documentation" in json is not compatible with "Generate document with this tabular model" |
doc.contentschoice multiple mandatory hidden uniqueCommand 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 Hidden: the value json is not compatible with changelog and example "Generated content" |
doc.title_levelinteger mandatoryCommand line: -dt, --doc.title_level Environment variable: ROUGAILCLI_DOC.TITLE_LEVEL |
Starting title level. Default: 1 |
doc.default_valuesboolean mandatoryCommand 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.true_colorboolean mandatory disabledCommand line: • --doc.true_color • --doc.no-true_color Environment variable: ROUGAILCLI_DOC.TRUE_COLOR |
Display documentation in console always with true color terminal. Default: false Disabled: when the variable "The output format of the generated documentation" hasn't the value "console" |
doc.rootstringCommand line: -dr, --doc.root Environment variable: ROUGAILCLI_DOC.ROOT |
Document the child variables of the family. |
The variables in this family are documented in another file
🛈 Informations
doc.other_root_filenames
This family contains lists of variable blocks.
disabled
Disabled: if "Document the child variables of the family" haven't any value
| Variable | Description |
|---|---|
doc.other_root_filenames.root_pathstring multiple uniqueCommand line: --doc.other_root_filenames.root_path Environment variable: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.ROOT_PATH |
Family name. |
doc.other_root_filenames.filenameUNIX filename mandatoryCommand 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: "file" |
Variable and changelog documentation
🛈 Informations
doc.tabulars
disabled
Disabled: if "The output format of the generated documentation" is json or "Generated content" hasn't variable or changelog
| Variable | Description |
|---|---|
doc.tabulars.without_familyboolean mandatoryCommand 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. Default: false |
doc.tabulars.with_commandlineboolean mandatoryCommand 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. Default: false |
doc.tabulars.with_environmentboolean mandatoryCommand 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. Default: false |
doc.tabulars.environment_prefixstring mandatory disabledCommand line: -dv, --doc.tabulars.environment_prefix Environment variable: ROUGAILCLI_DOC.TABULARS.ENVIRONMENT_PREFIX |
Environment variable prefix name. Validator: should only use uppercase characters Default: ROUGAIL Disabled: if "main_namespace" is not set or "Add environment variable informations in documentation" is false |
Changelog documentation
🛈 Informations
doc.changelog
disabled
Disabled: if changelog in not in "Generated content"
| Variable | Description |
|---|---|
doc.changelog.previous_json_filestring mandatoryCommand 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. |
Examples configuration
🛈 Informations
doc.examples
disabled
Disabled: if example is not in "Generated content"
| Variable | Description |
|---|---|
doc.examples.commentboolean mandatoryCommand 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. Default: false |
doc.examples.comment_columninteger mandatory disabledCommand line: --doc.examples.comment_column Environment variable: ROUGAILCLI_DOC.EXAMPLES.COMMENT_COLUMN |
Comment in examples starts at column. Default: 30 Disabled: when the variable "Add description of variables and families when generate examples" has the value "false" |
Three columns
Generate documentation
🛈 Informations
doc
disabled
Disabled: if doc is not set in "Select for output"
| Variable | Description | Default value |
|---|---|---|
doc.output_formatchoice mandatoryCommand line: -do, --doc.output_format Environment variable: ROUGAILCLI_DOC.OUTPUT_FORMAT |
The output format of the generated documentation. Choices: • console • asciidoc • html • github • gitlab • json |
console |
doc.tabular_templatechoice mandatory disabledCommand line: -dm, --doc.tabular_template Environment variable: ROUGAILCLI_DOC.TABULAR_TEMPLATE |
Generate document with this tabular model. The variables are documented with a table view. A template selection allows you to choose the content of each column. Choices: • two_columns • three_columns • four_columns • five_columns • six_columns Disabled: "The output format of the generated documentation" in json is not compatible with "Generate document with this tabular model" |
two_columns |
doc.contentschoice multiple mandatory hidden uniqueCommand 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 Hidden: the value json is not compatible with changelog and example "Generated content" |
• variables |
doc.title_levelinteger mandatoryCommand line: -dt, --doc.title_level Environment variable: ROUGAILCLI_DOC.TITLE_LEVEL |
Starting title level. | 1 |
doc.default_valuesboolean mandatoryCommand 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.true_colorboolean mandatory disabledCommand line: • --doc.true_color • --doc.no-true_color Environment variable: ROUGAILCLI_DOC.TRUE_COLOR |
Display documentation in console always with true color terminal. Disabled: when the variable "The output format of the generated documentation" hasn't the value "console" |
false |
doc.rootstringCommand line: -dr, --doc.root Environment variable: ROUGAILCLI_DOC.ROOT |
Document the child variables of the family. |
The variables in this family are documented in another file
🛈 Informations
doc.other_root_filenames
This family contains lists of variable blocks.
disabled
Disabled: if "Document the child variables of the family" haven't any value
| Variable | Description |
|---|---|
doc.other_root_filenames.root_pathstring multiple uniqueCommand line: --doc.other_root_filenames.root_path Environment variable: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.ROOT_PATH |
Family name. |
doc.other_root_filenames.filenameUNIX filename mandatoryCommand 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: "file" |
Variable and changelog documentation
🛈 Informations
doc.tabulars
disabled
Disabled: if "The output format of the generated documentation" is json or "Generated content" hasn't variable or changelog
| Variable | Description | Default value |
|---|---|---|
doc.tabulars.without_familyboolean mandatoryCommand 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 |
doc.tabulars.with_commandlineboolean mandatoryCommand 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 |
doc.tabulars.with_environmentboolean mandatoryCommand 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 |
doc.tabulars.environment_prefixstring mandatory disabledCommand line: -dv, --doc.tabulars.environment_prefix Environment variable: ROUGAILCLI_DOC.TABULARS.ENVIRONMENT_PREFIX |
Environment variable prefix name. Validator: should only use uppercase characters Disabled: if "main_namespace" is not set or "Add environment variable informations in documentation" is false |
ROUGAIL |
Changelog documentation
🛈 Informations
doc.changelog
disabled
Disabled: if changelog in not in "Generated content"
| Variable | Description |
|---|---|
doc.changelog.previous_json_filestring mandatoryCommand 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. |
Examples configuration
🛈 Informations
doc.examples
disabled
Disabled: if example is not in "Generated content"
| Variable | Description | Default value |
|---|---|---|
doc.examples.commentboolean mandatoryCommand 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 |
doc.examples.comment_columninteger mandatory disabledCommand line: --doc.examples.comment_column Environment variable: ROUGAILCLI_DOC.EXAMPLES.COMMENT_COLUMN |
Comment in examples starts at column. Disabled: when the variable "Add description of variables and families when generate examples" has the value "false" |
30 |
Four columns
Generate documentation
🛈 Informations
doc
disabled
Disabled: if doc is not set in "Select for output"
| Variable | Description | Default value | Type |
|---|---|---|---|
| doc.output_format Command line: -do, --doc.output_format Environment variable: ROUGAILCLI_DOC.OUTPUT_FORMAT |
The output format of the generated documentation. Choices: • console • asciidoc • html • github • gitlab • json |
console | choice mandatory |
doc.tabular_templatedisabledCommand line: -dm, --doc.tabular_template Environment variable: ROUGAILCLI_DOC.TABULAR_TEMPLATE |
Generate document with this tabular model. The variables are documented with a table view. A template selection allows you to choose the content of each column. Choices: • two_columns • three_columns • four_columns • five_columns • six_columns Disabled: "The output format of the generated documentation" in json is not compatible with "Generate document with this tabular model" |
two_columns | choice mandatory |
doc.contentshidden uniqueCommand 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 Hidden: the value json is not compatible with changelog and example "Generated content" |
• variables | choice multiple mandatory |
| doc.title_level Command line: -dt, --doc.title_level Environment variable: ROUGAILCLI_DOC.TITLE_LEVEL |
Starting title level. | 1 | integer 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 mandatory |
doc.true_colordisabledCommand line: • --doc.true_color • --doc.no-true_color Environment variable: ROUGAILCLI_DOC.TRUE_COLOR |
Display documentation in console always with true color terminal. Disabled: when the variable "The output format of the generated documentation" hasn't the value "console" |
false | boolean mandatory |
| doc.root Command line: -dr, --doc.root Environment variable: ROUGAILCLI_DOC.ROOT |
Document the child variables of the family. | string |
The variables in this family are documented in another file
🛈 Informations
doc.other_root_filenames
This family contains lists of variable blocks.
disabled
Disabled: if "Document the child variables of the family" haven't any value
| Variable | Description | Type |
|---|---|---|
doc.other_root_filenames.root_pathuniqueCommand line: --doc.other_root_filenames.root_path Environment variable: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.ROOT_PATH |
Family name. | string multiple |
| 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: "file" |
UNIX filename mandatory |
Variable and changelog documentation
🛈 Informations
doc.tabulars
disabled
Disabled: if "The output format of the generated documentation" is json or "Generated content" hasn't variable or changelog
| Variable | Description | Default value | Type |
|---|---|---|---|
| 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 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 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 mandatory |
doc.tabulars.environment_prefixdisabledCommand line: -dv, --doc.tabulars.environment_prefix Environment variable: ROUGAILCLI_DOC.TABULARS.ENVIRONMENT_PREFIX |
Environment variable prefix name. Validator: should only use uppercase characters Disabled: if "main_namespace" is not set or "Add environment variable informations in documentation" is false |
ROUGAIL | string mandatory |
Changelog documentation
🛈 Informations
doc.changelog
disabled
Disabled: if changelog in not in "Generated content"
| 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 mandatory |
Examples configuration
🛈 Informations
doc.examples
disabled
Disabled: if example is not in "Generated content"
| Variable | Description | Default value | Type |
|---|---|---|---|
| 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 mandatory |
doc.examples.comment_columndisabledCommand line: --doc.examples.comment_column Environment variable: ROUGAILCLI_DOC.EXAMPLES.COMMENT_COLUMN |
Comment in examples starts at column. Disabled: when the variable "Add description of variables and families when generate examples" has the value "false" |
30 | integer mandatory |
Five columns
Generate documentation
🛈 Informations
doc
disabled
Disabled: if doc is not set in "Select for output"
| Variable | Description | Default value | Type | Access control |
|---|---|---|---|---|
| doc.output_format Command line: -do, --doc.output_format Environment variable: ROUGAILCLI_DOC.OUTPUT_FORMAT |
The output format of the generated documentation. Choices: • console • asciidoc • html • github • gitlab • json |
console | choice mandatory |
|
| 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 table view. A template selection allows you to choose the content of each column. Choices: • two_columns • three_columns • four_columns • five_columns • six_columns |
two_columns | choice mandatory |
disabledDisabled: "The output format of the generated documentation" in json is not compatible with "Generate document with this tabular model" |
doc.contentsuniqueCommand 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 multiple mandatory |
hiddenHidden: the value json is not compatible with changelog and example "Generated content" |
| doc.title_level Command line: -dt, --doc.title_level Environment variable: ROUGAILCLI_DOC.TITLE_LEVEL |
Starting title level. | 1 | integer 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 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 mandatory |
disabledDisabled: when the variable "The output format of the generated documentation" hasn't the value "console" |
| doc.root Command line: -dr, --doc.root Environment variable: ROUGAILCLI_DOC.ROOT |
Document the child variables of the family. | string |
The variables in this family are documented in another file
🛈 Informations
doc.other_root_filenames
This family contains lists of variable blocks.
disabled
Disabled: if "Document the child variables of the family" haven't any value
| Variable | Description | Type |
|---|---|---|
doc.other_root_filenames.root_pathuniqueCommand line: --doc.other_root_filenames.root_path Environment variable: ROUGAILCLI_DOC.OTHER_ROOT_FILENAMES.ROOT_PATH |
Family name. | string multiple |
| 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: "file" |
UNIX filename mandatory |
Variable and changelog documentation
🛈 Informations
doc.tabulars
disabled
Disabled: if "The output format of the generated documentation" is json or "Generated content" hasn't variable or changelog
| Variable | Description | Default value | Type | Access control |
|---|---|---|---|---|
| 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 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 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 mandatory |
|
| doc.tabulars.environment_prefix Command line: -dv, --doc.tabulars.environment_prefix Environment variable: ROUGAILCLI_DOC.TABULARS.ENVIRONMENT_PREFIX |
Environment variable prefix name. Validator: should only use uppercase characters |
ROUGAIL | string mandatory |
disabledDisabled: if "main_namespace" is not set or "Add environment variable informations in documentation" is false |
Changelog documentation
🛈 Informations
doc.changelog
disabled
Disabled: if changelog in not in "Generated content"
| 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 mandatory |
Examples configuration
🛈 Informations
doc.examples
disabled
Disabled: if example is not in "Generated content"
| 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 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 mandatory |
disabledDisabled: when the variable "Add description of variables and families when generate examples" has the value "false" |
Six columns
Generate documentation
🛈 Informations
doc
disabled
Disabled: if doc is not set in "Select for 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 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 table view. A template selection allows you to choose the content of each column. |
two_columns | choice mandatory |
disabledDisabled: "The output format of the generated documentation" in json is not compatible with "Generate document with this tabular model" |
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 multiple mandatory |
hiddenHidden: the value json is not compatible with changelog and example "Generated content" |
uniqueChoices: • variables • example • changelog |
| doc.title_level Command line: -dt, --doc.title_level Environment variable: ROUGAILCLI_DOC.TITLE_LEVEL |
Starting title level. | 1 | integer 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 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 mandatory |
disabledDisabled: when the variable "The output format of the generated documentation" hasn't the value "console" |
|
| doc.root Command line: -dr, --doc.root Environment variable: ROUGAILCLI_DOC.ROOT |
Document the child variables of the family. | string |
The variables in this family are documented in another file
🛈 Informations
doc.other_root_filenames
This family contains lists of variable blocks.
disabled
Disabled: if "Document the child variables of the family" haven't any value
| 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 |
Family name. | string 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 mandatory |
• this filename could be a relative path • file type allowed: "file". |
Variable and changelog documentation
🛈 Informations
doc.tabulars
disabled
Disabled: if "The output format of the generated documentation" is json or "Generated content" hasn't variable 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 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 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 mandatory |
||
| doc.tabulars.environment_prefix Command line: -dv, --doc.tabulars.environment_prefix Environment variable: ROUGAILCLI_DOC.TABULARS.ENVIRONMENT_PREFIX |
Environment variable prefix name. | ROUGAIL | string mandatory |
disabledDisabled: if "main_namespace" is not set or "Add environment variable informations in documentation" is false |
Should only use uppercase characters. |
Changelog documentation
🛈 Informations
doc.changelog
disabled
Disabled: if changelog in not in "Generated content"
| 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 mandatory |
Examples configuration
🛈 Informations
doc.examples
disabled
Disabled: if example is not in "Generated content"
| 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 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 mandatory |
disabledDisabled: when the variable "Add description of variables and families when generate examples" has the value "false" |