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

Navigation interactive dans l’historique

← Modification précédente

VisuelWikicode

Dernière version du 15 novembre 2025 à 11:04

📚 Modèle:Documentation

✏️ Documentation 🎨 CSS

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 avec DISPLAYTITLE automatique -->
+{{DISPLAYTITLE:{{PAGENAME}} (documentation)}}
-<!-- Affiche le titre sous la forme "Modèle:Nom (Documentation)" -->
+<!--
+  Système de documentation avec pré-chargement et CSS intégré
+  Dépendances : Extension:TemplateStyles
+  Utilisation : {{Documentation}}
+-->
+[[Catégorie:Modèles système]]
+{{Documentation}}
 </noinclude>
-<includeonly>
+<includeonly><templatestyles src="Modèle:Documentation/styles.css" />
-{{#ifexist: {{FULLPAGENAME}}/Documentation
+<div class="nef-doc-system">
-  | <!-- Injection automatique de DISPLAYTITLE -->
+<!-- Bandeau de documentation -->
-    {{#tag:noinclude|{{DISPLAYTITLE:{{BASEPAGENAME}} (Documentation)}}}}
+<div class="nef-doc-header">
-    {{ {{FULLPAGENAME}}/Documentation}}
+<div class="nef-doc-header-content">
-  | {{#ifexist: {{FULLPAGENAME}}/doc
+<span class="nef-doc-header-icon">📚</span>
-      | <div class="mw-documentation-compat">
+<strong>{{FULLPAGENAME}}</strong>
-          '''Note :''' Cette documentation est stockée dans <code>[[:{{FULLPAGENAME}}/doc]]</code>.
+</div>
-          <br>Pour suivre les conventions de Wikipedia fr, déplacez-la vers <code>[[:{{FULLPAGENAME}}/Documentation]]</code>.
+<div class="nef-doc-header-actions">
-          <hr>
+{{#ifexist:{{{page|{{FULLPAGENAME}}/doc}}}
-          {{ {{FULLPAGENAME}}/doc}}
+|<span class="nef-doc-btn">[[{{{page|{{FULLPAGENAME}}/doc}}}|<span class="nef-doc-btn-icon">✏️</span> Documentation]]</span>
-        </div>
+|<span class="nef-doc-btn nef-doc-btn-create">[[{{{page|{{FULLPAGENAME}}/doc}}}|<span class="nef-doc-btn-icon">➕</span> Créer la documentation]]</span>
-      | <div class="mw-documentation-missing">
+}}
-          <h2>Documentation manquante</h2>
+{{#ifexist:{{{page|{{FULLPAGENAME}}/styles.css}}}
-          <div class="mw-documentation-notice">
+|<span class="nef-doc-btn">[[{{{page|{{FULLPAGENAME}}/styles.css}}}|<span class="nef-doc-btn-icon">🎨</span> CSS]]</span>
-            '''Ce modèle n’a pas encore de documentation.'''
+|<span class="nef-doc-btn nef-doc-btn-create">[[{{{page|{{FULLPAGENAME}}/styles.css}}}|<span class="nef-doc-btn-icon">➕</span> CSS]]</span>
-            <br>Vous pouvez [[{{FULLPAGENAME}}/Documentation|créer la page de documentation]] pour expliquer son utilisation.
+}}
-          </div>
+</div>
-        </div>
+</div>
-    }}
-}}</includeonly>
+{{#ifexist: {{FULLPAGENAME}}/doc
+| <!-- Mode avec documentation existante -->
+<div class="nef-doc-box nef-doc-exists">
+{{ {{FULLPAGENAME}}/doc }}
+</div>
+| <!-- Mode sans documentation -->
+<div class="nef-doc-box nef-doc-missing">
+<div class="nef-doc-icon" aria-hidden="true">📄</div>
+<div class="nef-doc-content">
+<p><strong>Ce modèle n'a pas encore de documentation.</strong></p>
+<p>Vous pouvez [{{fullurl:{{FULLPAGENAME}}/doc
+| action=edit
+| preload=Modèle:Preload/Documentation
+| preloadparams[]={{urlencode:{{BASEPAGENAME}}}}
+}} créer la documentation] pour expliquer son utilisation.</p>
+<div class="nef-doc-instructions">
+<strong>Instructions :</strong>
+<ul>
+<li>Le système pré-remplira automatiquement la structure</li>
+<li>Décrivez chaque paramètre du modèle</li>
+<li>Ajoutez des exemples concrets</li>
+<li>Sauvegardez quand vous avez terminé</li>
+</ul>
+</div>
+</div>
+</div>
+}}
+</div></includeonly>