« Modèle:Documentation » : différence entre les versions

Navigation interactive dans l’historique

Dernière version du 16 octobre 2025 à 14:15

Description

Ce modèle permet d’afficher automatiquement la documentation d’un modèle depuis sa sous-page /doc.

Utilisation

1. Dans le modèle principal (ex: Modèle:Exemple), ajoutez :

{{Documentation}}

2. Créez une sous-page Modèle:Exemple/doc avec la documentation.

Exemple de structure pour une page /doc

<noinclude>
{{DISPLAYTITLE:Exemple (documentation)}}
</noinclude>
== Description ==
Ce modèle fait X et Y.

== Paramètres ==
; param1
: Description du paramètre 1.

; param2
: Description du paramètre 2.

== Exemples ==
<pre>
{{Exemple
| param1 = valeur1
| param2 = valeur2}}
</pre>

[[Catégorie:Documentation de modèle]]

Catégorisation automatique

Les pages /doc dans l’espace de noms Modèle sont automatiquement ajoutées à .

@@ Ligne 2 : / Ligne 2 : @@
 {{DISPLAYTITLE:Documentation}}
 <!--
-   Modèle minimaliste pour afficher la documentation des modèles.
+   Modèle de documentation avec CSS externe via <templatestyles>
-   Utilisation : {{Documentation}} (à placer dans le modèle principal).
+   Utilisation : {{Documentation}}
-   La documentation doit être dans une sous-page "/doc".
+   Nécessite l'extension TemplateStyles (https://www.mediawiki.org/wiki/Extension:TemplateStyles)
 -->
+<templatestyles src="Modèle:Documentation/styles.css" />
 {{Documentation}}
 </noinclude>
 <includeonly>
+<div class="nef-doc-wrapper">
 {{#ifexist: {{FULLPAGENAME}}/doc
-  | <noinclude>{{DISPLAYTITLE:{{PAGENAME}} (documentation)}}</noinclude>{{ {{FULLPAGENAME}}/doc }}
+| <!-- Contenu avec documentation -->
-  |
+<div class="nef-doc-box nef-doc-has-content">
-   <div style="
+  {{ {{FULLPAGENAME}}/doc }}
-      clear: both;
+</div>
-      margin: 1em 0;
+| <!-- Message d'absence de documentation -->
-      border: 1px solid #eaecf0;
+<div class="nef-doc-box nef-doc-missing">
-      background-color: #f8f9fa;
+   <div class="nef-doc-icon" aria-hidden="true">📖</div>
-      padding: 1em;
+   <div class="nef-doc-text">
-      border-radius: 4px;
+     <strong>Ce modèle n'a pas de documentation.</strong><br>
-   ">
+    Vous pouvez [
-     '''Ce modèle n’a pas de documentation.'''
+    {{fullurl:{{FULLPAGENAME}}/doc|action=edit&preload=Modèle:Preload/Documentation}}
-    <div style="margin-top: 0.5em;">
+    créer la page <code>/doc</code>
-      Vous pouvez [{{fullurl:{{FULLPAGENAME}}/doc|action=edit}} créer la page <code>/doc</code>]
+    ] pour en ajouter une.
-      pour ajouter une documentation.
-    </div>
    </div>
+</div>
 }}
+</div>
 </includeonly>