No description
Find a file
2025-11-30 18:15:53 +01:00
locale feat: document commandline and environment variable 2025-11-27 22:17:17 +01:00
src/rougail/output_doc feat: personalise column number 2025-11-30 18:15:53 +01:00
tests feat: personalise column number 2025-11-30 18:15:53 +01:00
CHANGELOG.md bump: version 0.2.0a38 → 0.2.0a39 2025-11-21 08:15:09 +01:00
LICENSE feat: black + improvement 2024-11-01 11:45:38 +01:00
pyproject.toml bump: version 0.2.0a38 → 0.2.0a39 2025-11-21 08:15:09 +01:00
README.md feat: personalise column number 2025-11-30 18:15:53 +01:00

Table of Contents

Two columns

Générer la documentation

🛈 Informations

doc
basic désactivé
Désactivé : lorsque "Générer la documentation" n'est pas spécifié dans "Sélection pour sortie"

Variable Description
doc.title_level
integer standard obligatoire
Niveau de titre de départ.
Défaut : 1
doc.contents
choice multiple standard obligatoire unique
Contenu générer.
Choix :
• variables ← (défaut)
• example
• changelog
doc.previous_json_file
string basic obligatoire désactivé
Précédent fichier de description au format JSON.
Désactivé : changelog n'est pas sélectionné dans "Contenu générer"
doc.without_family
boolean standard obligatoire désactivé
Ne pas ajouter les familles dans la documentation.
Défaut : false
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
doc.root
string standard
Documente les variables depuis cette famille.
doc.with_commandline
boolean standard obligatoire désactivé
Ajoute les informations de la ligne de commande dans la documentation.
Défaut : false
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
doc.with_environment
boolean standard obligatoire désactivé
Ajoute les informations de variable d'environnement dans la documentation.
Défaut : false
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
doc.environment_default_environment_name
string standard obligatoire désactivé
Nom du préfixe d'environnement par défaut.
Validateur : doit seulement utilise des caractères en majuscule
Défaut : ROUGAIL
Désactivé : si "__.main_namespace" n'est pas défini ou "Ajoute les informations de variable d'environnement dans la documentation" est false

Les familles ou variables pour cette famille sont dans un autre fichier

🛈 Informations

doc.other_root_filenames
Cette famille contient des listes de bloc de variable.
basic désactivé
Désactivé : documentation doit être séparée

Variable Description
doc.other_root_filenames.root_path
string multiple standard unique
Nom de la famille racine.
doc.other_root_filenames.filename
UNIX filename basic obligatoire
Nom du fichier.
Validateurs :
• this filename could be a relative path
• file type allowed: "fichier" et "répertoire"
Variable Description
doc.disabled_modes
string multiple standard désactivé unique
Désactiver la documentation des variables avec ces modes.
Validateur : vérifier si le mode existe déjà
Désactivé : désactiver lorsqu'il n'y a pas de mode valable
doc.change_default_value
boolean standard obligatoire
Valeurs modifiées pour documenter les familles leader ou dynamique.
Défaut : true
doc.comment_examples
boolean standard obligatoire désactivé
Ajouter la description des variables et des familles lorsqu'on génère des exemples.
Défaut : false
Désactivé : désactiver lorsqu'il example n'est pas dans contents
doc.comment_examples_column
integer standard obligatoire désactivé
Commentaire dans les exemples commence à la colonne.
Défaut : 30
Désactivé : lorsque la variable "Ajouter la description des variables et des familles lorsqu'on génère des exemples" est accessible et a la valeur "false"
doc.output_format
choice standard obligatoire
Générer le document au format.
Validateur : le format de sortie json n'est pas compatible avec "changelog" et example" de la variable contents
Choix :
• console ← (défaut)
• asciidoc
• html
• github
• gitlab
• json
doc.table_model
choice standard obligatoire
Generate document inside table model.
Validateur : le format de sortie json n'est pas compatible avec "changelog" et example" de la variable contents
Choix :
• two_columns ← (défaut)
• three_columns
• four_columns
• five_columns
• six_columns
doc.force_true_color_terminal
boolean standard obligatoire
Force les vrais couleurs dans le terminal.
Défaut : false

Three columns

Générer la documentation

🛈 Informations

doc
basic désactivé
Désactivé : lorsque "Générer la documentation" n'est pas spécifié dans "Sélection pour sortie"

Variable Description Default value
doc.title_level
integer standard obligatoire
Niveau de titre de départ. 1
doc.contents
choice multiple standard obligatoire unique
Contenu générer.
Choix :
• variables
• example
• changelog

• variables
doc.previous_json_file
string basic obligatoire désactivé
Précédent fichier de description au format JSON.
Désactivé : changelog n'est pas sélectionné dans "Contenu générer"
doc.without_family
boolean standard obligatoire désactivé
Ne pas ajouter les familles dans la documentation.
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
false
doc.root
string standard
Documente les variables depuis cette famille.
doc.with_commandline
boolean standard obligatoire désactivé
Ajoute les informations de la ligne de commande dans la documentation.
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
false
doc.with_environment
boolean standard obligatoire désactivé
Ajoute les informations de variable d'environnement dans la documentation.
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
false
doc.environment_default_environment_name
string standard obligatoire désactivé
Nom du préfixe d'environnement par défaut.
Validateur : doit seulement utilise des caractères en majuscule
Désactivé : si "__.main_namespace" n'est pas défini ou "Ajoute les informations de variable d'environnement dans la documentation" est false
ROUGAIL

Les familles ou variables pour cette famille sont dans un autre fichier

🛈 Informations

doc.other_root_filenames
Cette famille contient des listes de bloc de variable.
basic désactivé
Désactivé : documentation doit être séparée

Variable Description
doc.other_root_filenames.root_path
string multiple standard unique
Nom de la famille racine.
doc.other_root_filenames.filename
UNIX filename basic obligatoire
Nom du fichier.
Validateurs :
• this filename could be a relative path
• file type allowed: "fichier" et "répertoire"
Variable Description Default value
doc.disabled_modes
string multiple standard désactivé unique
Désactiver la documentation des variables avec ces modes.
Validateur : vérifier si le mode existe déjà
Désactivé : désactiver lorsqu'il n'y a pas de mode valable
doc.change_default_value
boolean standard obligatoire
Valeurs modifiées pour documenter les familles leader ou dynamique. true
doc.comment_examples
boolean standard obligatoire désactivé
Ajouter la description des variables et des familles lorsqu'on génère des exemples.
Désactivé : désactiver lorsqu'il example n'est pas dans contents
false
doc.comment_examples_column
integer standard obligatoire désactivé
Commentaire dans les exemples commence à la colonne.
Désactivé : lorsque la variable "Ajouter la description des variables et des familles lorsqu'on génère des exemples" est accessible et a la valeur "false"
30
doc.output_format
choice standard obligatoire
Générer le document au format.
Validateur : le format de sortie json n'est pas compatible avec "changelog" et example" de la variable contents
Choix :
• console
• asciidoc
• html
• github
• gitlab
• json
console
doc.table_model
choice standard obligatoire
Generate document inside table model.
Validateur : le format de sortie json n'est pas compatible avec "changelog" et example" de la variable contents
Choix :
• two_columns
• three_columns
• four_columns
• five_columns
• six_columns
two_columns
doc.force_true_color_terminal
boolean standard obligatoire
Force les vrais couleurs dans le terminal. false

Four columns

Générer la documentation

🛈 Informations

doc
basic désactivé
Désactivé : lorsque "Générer la documentation" n'est pas spécifié dans "Sélection pour sortie"

Variable Description Default value Type
doc.title_level
standard
Niveau de titre de départ. 1 integer obligatoire
doc.contents
standard unique
Contenu générer.
Choix :
• variables
• example
• changelog

• variables
choice multiple obligatoire
doc.previous_json_file
basic désactivé
Précédent fichier de description au format JSON.
Désactivé : changelog n'est pas sélectionné dans "Contenu générer"
string obligatoire
doc.without_family
standard désactivé
Ne pas ajouter les familles dans la documentation.
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
false boolean obligatoire
doc.root
standard
Documente les variables depuis cette famille. string
doc.with_commandline
standard désactivé
Ajoute les informations de la ligne de commande dans la documentation.
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
false boolean obligatoire
doc.with_environment
standard désactivé
Ajoute les informations de variable d'environnement dans la documentation.
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
false boolean obligatoire
doc.environment_default_environment_name
standard désactivé
Nom du préfixe d'environnement par défaut.
Validateur : doit seulement utilise des caractères en majuscule
Désactivé : si "__.main_namespace" n'est pas défini ou "Ajoute les informations de variable d'environnement dans la documentation" est false
ROUGAIL string obligatoire

Les familles ou variables pour cette famille sont dans un autre fichier

🛈 Informations

doc.other_root_filenames
Cette famille contient des listes de bloc de variable.
basic désactivé
Désactivé : documentation doit être séparée

Variable Description Type
doc.other_root_filenames.root_path
standard unique
Nom de la famille racine. string multiple
doc.other_root_filenames.filename
basic
Nom du fichier.
Validateurs :
• this filename could be a relative path
• file type allowed: "fichier" et "répertoire"
UNIX filename obligatoire
Variable Description Default value Type
doc.disabled_modes
standard désactivé unique
Désactiver la documentation des variables avec ces modes.
Validateur : vérifier si le mode existe déjà
Désactivé : désactiver lorsqu'il n'y a pas de mode valable
string multiple
doc.change_default_value
standard
Valeurs modifiées pour documenter les familles leader ou dynamique. true boolean obligatoire
doc.comment_examples
standard désactivé
Ajouter la description des variables et des familles lorsqu'on génère des exemples.
Désactivé : désactiver lorsqu'il example n'est pas dans contents
false boolean obligatoire
doc.comment_examples_column
standard désactivé
Commentaire dans les exemples commence à la colonne.
Désactivé : lorsque la variable "Ajouter la description des variables et des familles lorsqu'on génère des exemples" est accessible et a la valeur "false"
30 integer obligatoire
doc.output_format
standard
Générer le document au format.
Validateur : le format de sortie json n'est pas compatible avec "changelog" et example" de la variable contents
Choix :
• console
• asciidoc
• html
• github
• gitlab
• json
console choice obligatoire
doc.table_model
standard
Generate document inside table model.
Validateur : le format de sortie json n'est pas compatible avec "changelog" et example" de la variable contents
Choix :
• two_columns
• three_columns
• four_columns
• five_columns
• six_columns
two_columns choice obligatoire
doc.force_true_color_terminal
standard
Force les vrais couleurs dans le terminal. false boolean obligatoire

Five columns

Générer la documentation

🛈 Informations

doc
basic désactivé
Désactivé : lorsque "Générer la documentation" n'est pas spécifié dans "Sélection pour sortie"

Variable Description Default value Type Access control
doc.title_level Niveau de titre de départ. 1 integer obligatoire standard
doc.contents
unique
Contenu générer.
Choix :
• variables
• example
• changelog

• variables
choice multiple obligatoire standard
doc.previous_json_file
désactivé
Précédent fichier de description au format JSON. string obligatoire basic désactivé
Désactivé : changelog n'est pas sélectionné dans "Contenu générer"
Désactivé : changelog n'est pas sélectionné dans "Contenu générer"
doc.without_family
désactivé
Ne pas ajouter les familles dans la documentation. false boolean obligatoire standard désactivé
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
doc.root Documente les variables depuis cette famille. string standard
doc.with_commandline
désactivé
Ajoute les informations de la ligne de commande dans la documentation. false boolean obligatoire standard désactivé
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
doc.with_environment
désactivé
Ajoute les informations de variable d'environnement dans la documentation. false boolean obligatoire standard désactivé
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
doc.environment_default_environment_name
désactivé
Nom du préfixe d'environnement par défaut.
Validateur : doit seulement utilise des caractères en majuscule
ROUGAIL string obligatoire standard désactivé
Désactivé : si ".main_namespace" n'est pas défini ou "Ajoute les informations de variable d'environnement dans la documentation" est false
Désactivé : si "
.main_namespace" n'est pas défini ou "Ajoute les informations de variable d'environnement dans la documentation" est false

Les familles ou variables pour cette famille sont dans un autre fichier

🛈 Informations

doc.other_root_filenames
Cette famille contient des listes de bloc de variable.
basic désactivé
Désactivé : documentation doit être séparée

Variable Description Type Access control
doc.other_root_filenames.root_path
unique
Nom de la famille racine. string multiple standard
doc.other_root_filenames.filename Nom du fichier.
Validateurs :
• this filename could be a relative path
• file type allowed: "fichier" et "répertoire"
UNIX filename obligatoire basic
Variable Description Default value Type Access control
doc.disabled_modes
désactivé unique
Désactiver la documentation des variables avec ces modes.
Validateur : vérifier si le mode existe déjà
string multiple standard désactivé
Désactivé : désactiver lorsqu'il n'y a pas de mode valable
Désactivé : désactiver lorsqu'il n'y a pas de mode valable
doc.change_default_value Valeurs modifiées pour documenter les familles leader ou dynamique. true boolean obligatoire standard
doc.comment_examples
désactivé
Ajouter la description des variables et des familles lorsqu'on génère des exemples. false boolean obligatoire standard désactivé
Désactivé : désactiver lorsqu'il example n'est pas dans contents
Désactivé : désactiver lorsqu'il example n'est pas dans contents
doc.comment_examples_column
désactivé
Commentaire dans les exemples commence à la colonne. 30 integer obligatoire standard désactivé
Désactivé : lorsque la variable "Ajouter la description des variables et des familles lorsqu'on génère des exemples" est accessible et a la valeur "false"
Désactivé : lorsque la variable "Ajouter la description des variables et des familles lorsqu'on génère des exemples" est accessible et a la valeur "false"
doc.output_format Générer le document au format.
Validateur : le format de sortie json n'est pas compatible avec "changelog" et example" de la variable contents
Choix :
• console
• asciidoc
• html
• github
• gitlab
• json
console choice obligatoire standard
doc.table_model Generate document inside table model.
Validateur : le format de sortie json n'est pas compatible avec "changelog" et example" de la variable contents
Choix :
• two_columns
• three_columns
• four_columns
• five_columns
• six_columns
two_columns choice obligatoire standard
doc.force_true_color_terminal Force les vrais couleurs dans le terminal. false boolean obligatoire standard

Six columns

Générer la documentation

🛈 Informations

doc
basic désactivé
Désactivé : lorsque "Générer la documentation" n'est pas spécifié dans "Sélection pour sortie"

Variable Description Default value Type Access control Validateur
doc.title_level Niveau de titre de départ. 1 integer obligatoire standard
doc.contents
unique
Contenu générer.
Choix :
• variables
• example
• changelog

• variables
choice multiple obligatoire standard
doc.previous_json_file
désactivé
Précédent fichier de description au format JSON. string obligatoire basic désactivé
Désactivé : changelog n'est pas sélectionné dans "Contenu générer"
Désactivé : changelog n'est pas sélectionné dans "Contenu générer"
doc.without_family
désactivé
Ne pas ajouter les familles dans la documentation. false boolean obligatoire standard désactivé
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
doc.root Documente les variables depuis cette famille. string standard
doc.with_commandline
désactivé
Ajoute les informations de la ligne de commande dans la documentation. false boolean obligatoire standard désactivé
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
doc.with_environment
désactivé
Ajoute les informations de variable d'environnement dans la documentation. false boolean obligatoire standard désactivé
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
Désactivé : if "Générer le document au format" is json or "Contenu générer" hasn't variable or changelog
doc.environment_default_environment_name
désactivé
Nom du préfixe d'environnement par défaut. ROUGAIL string obligatoire standard désactivé
Désactivé : si ".main_namespace" n'est pas défini ou "Ajoute les informations de variable d'environnement dans la documentation" est false
Désactivé : si "
.main_namespace" n'est pas défini ou "Ajoute les informations de variable d'environnement dans la documentation" est false
Doit seulement utilise des caractères en majuscule.

Les familles ou variables pour cette famille sont dans un autre fichier

🛈 Informations

doc.other_root_filenames
Cette famille contient des listes de bloc de variable.
basic désactivé
Désactivé : documentation doit être séparée

Variable Description Type Access control Validateur
doc.other_root_filenames.root_path
unique
Nom de la famille racine. string multiple standard
doc.other_root_filenames.filename Nom du fichier. UNIX filename obligatoire basic
• this filename could be a relative path
• file type allowed: "fichier" et "répertoire".
Variable Description Default value Type Access control Validateur
doc.disabled_modes
désactivé unique
Désactiver la documentation des variables avec ces modes. string multiple standard désactivé
Désactivé : désactiver lorsqu'il n'y a pas de mode valable
Désactivé : désactiver lorsqu'il n'y a pas de mode valable
Vérifier si le mode existe déjà.
doc.change_default_value Valeurs modifiées pour documenter les familles leader ou dynamique. true boolean obligatoire standard
doc.comment_examples
désactivé
Ajouter la description des variables et des familles lorsqu'on génère des exemples. false boolean obligatoire standard désactivé
Désactivé : désactiver lorsqu'il example n'est pas dans contents
Désactivé : désactiver lorsqu'il example n'est pas dans contents
doc.comment_examples_column
désactivé
Commentaire dans les exemples commence à la colonne. 30 integer obligatoire standard désactivé
Désactivé : lorsque la variable "Ajouter la description des variables et des familles lorsqu'on génère des exemples" est accessible et a la valeur "false"
Désactivé : lorsque la variable "Ajouter la description des variables et des familles lorsqu'on génère des exemples" est accessible et a la valeur "false"
doc.output_format Générer le document au format.
Choix :
• console
• asciidoc
• html
• github
• gitlab
• json
console choice obligatoire standard Le format de sortie json n'est pas compatible avec "changelog" et example" de la variable contents.
doc.table_model Generate document inside table model.
Choix :
• two_columns
• three_columns
• four_columns
• five_columns
• six_columns
two_columns choice obligatoire standard Le format de sortie json n'est pas compatible avec "changelog" et example" de la variable contents.
doc.force_true_color_terminal Force les vrais couleurs dans le terminal. false boolean obligatoire standard