Table of Contents

• Generate documentation from structural files
• The variables in this family are documented in another file
• Variables and changelog documentation
• Changelog documentation
• Examples configuration

🇬🇧 (EN) - 🇫🇷 (FR)

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"

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 tabular view. A template selection allows you to choose the content of each column.	two_columns	choice mandatory	disabled Disabled: "The output format of the generated documentation" 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 multiple mandatory	hidden Hidden: "The output format of the generated documentation" in json is not compatible with changelog or example "Generated content"	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 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	disabled Disabled: 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. 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

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" 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 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".

Variables and changelog documentation

🛈 Informations

Path: doc.tabulars
disabled
Disabled: if "The output format of the generated documentation" is json or "Generated content" 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 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 variables prefix name.	ROUGAIL	string mandatory	disabled Disabled: if "main_namespace" is not set or "Add environment variable informations in documentation" is false	Should only use uppercase characters.

Changelog documentation

🛈 Informations

Path: 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

Path: 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	disabled Disabled: when the variable "Add description of variables and families when generate examples" has the value "false"