« 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>{{Documentation}}</noinclude><includeonly>{{#ifexist:{{FULLPAGENAME}}/doc
+<noinclude>
-|<div class="documentation-header">
+{{DISPLAYTITLE:Documentation}}
-== 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>
+<div class="nef-doc-wrapper">
+{{#ifexist: {{FULLPAGENAME}}/doc
+| <!-- Contenu avec documentation -->
+<div class="nef-doc-box nef-doc-has-content">
+  {{ {{FULLPAGENAME}}/doc }}
 </div>
-<div class="documentation-content">
+| <!-- Message d'absence de documentation -->
-{{{{FULLPAGENAME}}/doc}}
+<div class="nef-doc-box nef-doc-missing">
-</div>
+  <div class="nef-doc-icon" aria-hidden="true">📖</div>
-{{#ifexist:{{FULLPAGENAME}}/Documentation/Bac à sable
+  <div class="nef-doc-text">
-|<div class="documentation-sandbox">
+    <strong>Ce modèle n'a pas de documentation.</strong><br>
-=== Bac à sable ===
+    Vous pouvez [
-{{{{FULLPAGENAME}}/Documentation/Bac à sable}}
+    {{fullurl:{{FULLPAGENAME}}/doc|action=edit&preload=Modèle:Preload/Documentation}}
-</div>
+    créer la page <code>/doc</code>
-}}
+    ] pour en ajouter une.
-{{#ifexist:{{FULLPAGENAME}}/Documentation/Test
+  </div>
-|<div class="documentation-test">
-=== Tests ===
-{{{{FULLPAGENAME}}/Documentation/Test}}
 </div>
 }}
-<div class="documentation-footer">
-----
-<small>
-[[{{FULLPAGENAME}}/Documentation|Modifier la documentation]] •
-[[{{FULLPAGENAME}}|Retour au modèle]]
-{{#ifexist:{{FULLPAGENAME}}/Documentation/Bac à sable
-| • [[{{FULLPAGENAME}}/Documentation/Bac à sable|Bac à sable]]
-}}
-{{#ifexist:{{FULLPAGENAME}}/Documentation/Test
-| • [[{{FULLPAGENAME}}/Documentation/Test|Tests]]
-}}
-</small>
-</div>
-|<div class="documentation-missing">
-== Documentation ==
-<div class="documentation-notice">
-'''Ce modèle n'a pas encore de documentation.'''
-Vous pouvez [[{{FULLPAGENAME}}/Documentation|créer la page de documentation]] pour expliquer comment utiliser ce modèle.
-</div>
 </div>
-}}</includeonly>
+</includeonly>