Projet:Laboratoire/Espaces de noms/Modèle/Sandbox/Module Documentation

Sommaire de l’expérience Modèle
Suivi du modèle documentation
Sous-documentation ; Sous-documentation aide
Module Documentation
Module:Documentation Module:Documentation/config
Modèle Documentation
Modèle:Documentation Modèle:Documentation/start box Modèle:Documentation/end box Modèle:Documentation/docspace Modèle:Documentation/mirror Modèle:Documentation/preload Modèle:Documentation/preload-sandbox Modèle:Documentation/preload-testcases Modèle:Documentation/preload-module-doc Bandeaux {{Sous-page de documentation}} {{Sous-page de test}} Accès au navigateur - Expérience Sous-documentation

Observation du module Documentation dans l’environnement Wikimedia

L’implémentation des deux sous-pages, suppose l’implémentation du module "Documentation". Il existe deux approches :

1. La première (via Mediawiki ou en:wikipedia) met en œuvre un fichier de configuration local :

   mw:Module:Documentation, de WikiMedia propose un fichier de configuration pour faciliter le portage sur un autre projet.

   mw:Module:Documentation/config/doc La page de documentation MediaWiki ou l’on peut envisager une traduction française ("comment utiliser le fichier config ?", en français pour tous les services MediaWiki).

   w:en:Module:Documentation/config, exemple Wikipedia anglophone de mise en œuvre du fichier config,

   w:pt:Módulo:Documentação/config exemple fichier cfg lusophone.

2. La seconde consiste à développer un module Documentation personnalisé :

   w:fr:Module:Documentation Wikipédia propose sa version, l’aventure semble douloureuse et la solution est spécifique aux besoins WP.

L’opération est beaucoup plus complexe que d’ajouter deux simples liens.

Nous traduisons les commentaires du fichier de configuration : mw:Module:Documentation/config/doc/fr pour mieux appréhender la tâche.

Nous évaluons ci-dessous la liste des objets nécessaires à la première solution, plus souple et mieux documentée.

Le module Documentation

Nous disposons des sous-pages du modèle Module:Documentation avec son fichier de configuration Module:Documentation/config.

Nous vérifions maintenant les dépendances du modèle.

Dépendances

• Module:Message box et ses dépendances

le fichier de configuration du module Module:Message box/configuration

• Module:Category handler et sa sous-page Module:Category handler/config

le fichier de configuration permet d’adapter le module aux wiki local ; sans modifier son code.

les sous-pages Module:Category handler/data et Module:Category handler/shared et aussi Module:Category handler/blacklist sont nécessaires.

• Module:Namespace detect ; pour la détection automatique des espaces locaux

Module:Namespace detect/data ; Module:Namespace detect/config

• Module:TableTools une bibliothèque pour la manipulation de tables Lua.
• Module:Yesno Une fonction pour le traitement efficient des entrées wikitexte, en tant que valeur booléenne.

Traduire en ajoutant les items francophones (conserver les items anglophone).