« 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>{{Documentation}}</noinclude><includeonly>{{#ifexist:{{FULLPAGENAME}}/doc
+<noinclude>
-|<div class="documentation-header">
+{{DISPLAYTITLE:{{PAGENAME}} (documentation)}}
-== 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><templatestyles src="Modèle:Documentation/styles.css" />
+<div class="nef-doc-system">
+<!-- Bandeau de documentation -->
+<div class="nef-doc-header">
+<div class="nef-doc-header-content">
+<span class="nef-doc-header-icon">📚</span>
+<strong>{{FULLPAGENAME}}</strong>
 </div>
-<div class="documentation-content">
+<div class="nef-doc-header-actions">
-{{{{FULLPAGENAME}}/Documentation}}
+{{#ifexist:{{{page|{{FULLPAGENAME}}/doc}}}
+|<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>
+}}
+{{#ifexist:{{{page|{{FULLPAGENAME}}/styles.css}}}
+|<span class="nef-doc-btn">[[{{{page|{{FULLPAGENAME}}/styles.css}}}|<span class="nef-doc-btn-icon">🎨</span> CSS]]</span>
+|<span class="nef-doc-btn nef-doc-btn-create">[[{{{page|{{FULLPAGENAME}}/styles.css}}}|<span class="nef-doc-btn-icon">➕</span> CSS]]</span>
+}}
 </div>
-{{#ifexist:{{FULLPAGENAME}}/Documentation/Bac à sable
-|<div class="documentation-sandbox">
-=== Bac à sable ===
-{{{{FULLPAGENAME}}/Documentation/Bac à sable}}
 </div>
-}}
-{{#ifexist:{{FULLPAGENAME}}/Documentation/Test
+{{#ifexist: {{FULLPAGENAME}}/doc
-|<div class="documentation-test">
+| <!-- Mode avec documentation existante -->
-=== Tests ===
+<div class="nef-doc-box nef-doc-exists">
-{{{{FULLPAGENAME}}/Documentation/Test}}
+{{ {{FULLPAGENAME}}/doc }}
 </div>
-}}
+| <!-- Mode sans documentation -->
-<div class="documentation-footer">
+<div class="nef-doc-box nef-doc-missing">
-----
+<div class="nef-doc-icon" aria-hidden="true">📄</div>
-<small>
+<div class="nef-doc-content">
-[[{{FULLPAGENAME}}/Documentation|Modifier la documentation]] •
+<p><strong>Ce modèle n'a pas encore de documentation.</strong></p>
-[[{{FULLPAGENAME}}|Retour au modèle]]
+<p>Vous pouvez [{{fullurl:{{FULLPAGENAME}}/doc
-{{#ifexist:{{FULLPAGENAME}}/Documentation/Bac à sable
+| action=edit
-| • [[{{FULLPAGENAME}}/Documentation/Bac à sable|Bac à sable]]
+| preload=Modèle:Preload/Documentation
-}}
+| preloadparams[]={{urlencode:{{BASEPAGENAME}}}}
-{{#ifexist:{{FULLPAGENAME}}/Documentation/Test
+}} créer la documentation] pour expliquer son utilisation.</p>
-| • [[{{FULLPAGENAME}}/Documentation/Test|Tests]]
-}}
+<div class="nef-doc-instructions">
-</small>
+<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 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>
+}}
+</div></includeonly>