« 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 1 : / Ligne 1 : @@
 <noinclude>
-<!-- Modèle de documentation pour MediaWiki (version anti-récursive) -->
 {{DISPLAYTITLE:Documentation}}
+<!--
+  Modèle de documentation avec CSS externe via <templatestyles>
+  Utilisation : {{Documentation}}
+  Nécessite l'extension TemplateStyles (https://www.mediawiki.org/wiki/Extension:TemplateStyles)
+-->
+<templatestyles src="Modèle:Documentation/styles.css" />
+{{Documentation}}
 </noinclude>
 <includeonly>
-{{#if:
+<div class="nef-doc-wrapper">
-  {{#ifexist: {{FULLPAGENAME}}/doc|1|0}}
+{{#ifexist: {{FULLPAGENAME}}/doc
-  |
+| <!-- Contenu avec documentation -->
-   {{#ifeq: {{PAGENAME}}|Documentation
+<div class="nef-doc-box nef-doc-has-content">
-    | <!-- Cas spécial : on est dans Modèle:Documentation/doc, on affiche la doc manuellement -->
+   {{ {{FULLPAGENAME}}/doc }}
-    <div class="mw-documentation-block">
+</div>
-      == Description ==
+| <!-- Message d'absence de documentation -->
-      Ce modèle permet d'afficher la documentation des modèles via une sous-page <code>/doc</code>.
+<div class="nef-doc-box nef-doc-missing">
-      [[Modèle:Documentation/doc|Voir la documentation complète]].
+  <div class="nef-doc-icon" aria-hidden="true">📖</div>
-    </div>
+  <div class="nef-doc-text">
-     |
+    <strong>Ce modèle n'a pas de documentation.</strong><br>
-    <!-- Cas normal : on inclut la sous-page /doc -->
+     Vous pouvez [
-     {{ {{FULLPAGENAME}}/doc | 1=<noinclude>{{DISPLAYTITLE:{{PAGENAME}} (documentation)}}</noinclude> }}
+     {{fullurl:{{FULLPAGENAME}}/doc|action=edit&preload=Modèle:Preload/Documentation}}
-  }}
+    créer la page <code>/doc</code>
-  |
+     ] pour en ajouter une.
-  <!-- Si /doc n'existe pas -->
-  <div class="mw-documentation-missing" style="..."
-     <!-- [Message "Documentation manquante" inchangé, voir version précédente] -->
    </div>
+</div>
 }}
-<!-- Catégorisation (inchangée) -->
+</div>
-{{#ifeq: {{NAMESPACE}} | Modèle
-  | {{#if: {{SUBPAGENAME}}
-    | {{#ifeq: {{SUBPAGENAME}} | doc
-      | [[Catégorie:Documentation de modèle|{{PAGENAME}}]]
-    }}
-  }}
-}}
 </includeonly>