« 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 pour MediaWiki (version anti-récursive) -->
+{{DISPLAYTITLE:{{PAGENAME}} (documentation)}}
-{{DISPLAYTITLE: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" />
-{{#if:
+<div class="nef-doc-system">
-  {{#ifexist: {{FULLPAGENAME}}/doc|1|0}}
+<!-- Bandeau de documentation -->
-  |
+<div class="nef-doc-header">
-  {{#ifeq: {{PAGENAME}}|Documentation
+<div class="nef-doc-header-content">
-    | <!-- Cas spécial : on est dans Modèle:Documentation/doc, on affiche la doc manuellement -->
+<span class="nef-doc-header-icon">📚</span>
-    <div class="mw-documentation-block">
+<strong>{{FULLPAGENAME}}</strong>
-      == Description ==
+</div>
-      Ce modèle permet d'afficher la documentation des modèles via une sous-page <code>/doc</code>.
+<div class="nef-doc-header-actions">
-      [[Modèle:Documentation/doc|Voir la documentation complète]].
+{{#ifexist:{{{page|{{FULLPAGENAME}}/doc}}}
-    </div>
+|<span class="nef-doc-btn">[[{{{page|{{FULLPAGENAME}}/doc}}}|<span class="nef-doc-btn-icon">✏️</span> Documentation]]</span>
-    |
+|<span class="nef-doc-btn nef-doc-btn-create">[[{{{page|{{FULLPAGENAME}}/doc}}}|<span class="nef-doc-btn-icon">➕</span> Créer la documentation]]</span>
-    <!-- Cas normal : on inclut la sous-page /doc -->
-    {{ {{FULLPAGENAME}}/doc | 1=<noinclude>{{DISPLAYTITLE:{{PAGENAME}} (documentation)}}</noinclude> }}
-  }}
-  |
-  <!-- Si /doc n'existe pas -->
-  <div class="mw-documentation-missing" style="..."
-    <!-- [Message "Documentation manquante" inchangé, voir version précédente] -->
-  </div>
 }}
-<!-- Catégorisation (inchangée) -->
+{{#ifexist:{{{page|{{FULLPAGENAME}}/styles.css}}}
-{{#ifeq: {{NAMESPACE}} | Modèle
+|<span class="nef-doc-btn">[[{{{page|{{FULLPAGENAME}}/styles.css}}}|<span class="nef-doc-btn-icon">🎨</span> CSS]]</span>
-  | {{#if: {{SUBPAGENAME}}
+|<span class="nef-doc-btn nef-doc-btn-create">[[{{{page|{{FULLPAGENAME}}/styles.css}}}|<span class="nef-doc-btn-icon">➕</span> CSS]]</span>
-    | {{#ifeq: {{SUBPAGENAME}} | doc
-      | [[Catégorie:Documentation de modèle|{{PAGENAME}}]]
-    }}
-  }}
 }}
-</includeonly>
+</div>
+</div>
+{{#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>