Wikipédia:Jargon/Patch info
Un article de Wikipédia, l'encyclopédie libre.
Cette page définit un jargon de Wikipédia. Cette page est un patch info et peut-être employée en inclusion comme un modèle. |
Cette page décrit la notion de patch info.
[modifier] Définition
Un patch info est une page de l'espace de noms Wikipédia:
qui est utilisée en inclusion (à la manière d'un modèle) dans l'espace Aide:
. La partie à inclure se réduit à un simple paragraphe et expose un point précis (une règle, convention, recommandation, définition, etc). La partie hors inclusion détaille le patch en fournissant des exemples et en donnant les avantages et les réticences (le pour et le contre), la motivation, les exceptions, les sujets connexes, etc.
[modifier] Description détaillée
- Description imagée
- Pour mieux comprendre le principe de manière imagée, voici quelques analogies :
Patch info | Page | Modèle | Iceberg | Patch |
---|---|---|---|---|
énoncé (définition ou recommandation) | partie include | modèle proprement dit | partie visible | produit actif |
développement (complément d'information) | partie noinclude | documentation du modèle | partie cachée | sparadrap |
- Comment indentifie-t-on un patch info ?
-
- Conformément à la convention ci-dessous, un bandeau {{Patch Jargon}} ou {{Patch Recommandation}} figure en haut de tout patch.
- Les patchs de jargon sont recencés dans Catégorie:Jargon de Wikipédia.
- Les patchs de proposition de recommandations sont recencés dans Catégorie:Proposition de recommandation sur Wikipédia.
- Où trouve-t-on un patch info ?
-
- Dans le sous-espace
Wikipédia:Jargon
pour un jargon - Dans le sous-espace
Wikipédia:Recommandation
pour une recommandation - Dans le sous-espace d'un projet pour un patch en cours d'élaboration (une proposition)
- Dans le sous-espace
- Comment repère-t-on un patch info dans le code source d'une page d'aide ?
- Le code pour l'inclusion d'un patch est
{{Wikipédia:Jargon/<!--terme-->}}
pour un jargon ;{{Wikipédia:Recommandation/<!-- .. branche .. /nom de la recommandation-->}}
pour une recommandation.
- Comment repère-t-on un patch info dans une page d'aide ?
- Un patch info est concu pour s'inserer harmonieusement dans le texte d'une page d'aide. Toutefois, si l'on observe la convention de formatage ci-dessous, l'inclusion d'un patch info est facilement repérable par la présence d'un lien « (en savoir plus) ».
[modifier] Exemples
Cette page est un patch info. Elle peut être incluse ainsi :
- le code «
{{Wikipédia:Jargon/Patch info}}
» donne « Un patch info est une page de l'espace de nomsWikipédia:
qui est utilisée en inclusion (à la manière d'un modèle) dans l'espaceAide:
. La partie à inclure se réduit à un simple paragraphe et expose un point précis (une règle, convention, recommandation, définition, etc). La partie hors inclusion détaille le patch en fournissant des exemples et en donnant les avantages et les réticences (le pour et le contre), la motivation, les exceptions, les sujets connexes, etc (en savoir plus). ».
Elle peut également être liée avec {{Aide détaillée}} :
- le code «
{{Aide détaillée|Wikipédia:Jargon/Patch info}}
» donne :
Une liste de quelques patch info :
- Projet:Catégories/Recommandation/Modèle de fiche
- Wikipédia:Jargon/Modèle
- Wikipédia:Jargon/Espace de noms
- Wikipédia:Jargon/Sous-espace
- Wikipédia:Jargon/Sous-page
- Projet:Catégories/Jargon/Critère
Projet:Aide/Recommandation/Découpage de l'aide est un exemple (de démonstration) d'inclusions de patchs info dans une page.
[modifier] Convention de formatage de la page
Voici une convention de formatage de la page.
- Pour un jargon
<noinclude> {{Patch Jargon}} __NOTOC__ Cette page décrit le terme<!-- la notion de --> "'''{{SUBPAGENAME}}'''". ==Définition== </noinclude><!-- Un énoncé en un seul paragraphe (Attention ! ni saut de ligne, ni point final) --><includeonly> ([[{{subst:FULLPAGENAME}}|en savoir plus]])</includeonly>.<noinclude> <!-- Les sections suivantes sont données à titre indicatif --> ==Description détaillée== ==Exemples== ==Notes== ==Voir aussi== </noinclude>
- Pour une recommandation
<noinclude> {{Patch Recommandation}}<!-- modèle à paramétrer : (si ce patch info est le résultat d'un vote ou d'une discussion, cela doit ête mentionné ici) --> __NOTOC__ Cette page décrit <!--à compléter--> ==<!--Convention/Récommandation/Règle-->== </noinclude><!-- Un énoncé en un seul paragraphe (Attention ! ni saut de ligne, ni point final) --><includeonly> ([[{{subst:FULLPAGENAME}}|en savoir plus]])</includeonly>.<noinclude> <!-- Les sections suivantes sont données à titre indicatif --> ==Exemples== ==Conventions== ==Motivations== ==Avantages== ==Réticences== ==Exceptions== ==Mise en œuvre== ==Évolutions possibles== ==Voir aussi== </noinclude>
On peut également placer ce code, en haut de la page de discussion, pour tester le rendu de la page en inclusion :
==Rendu de la page en inclusion== {{{{SUBJECTSPACE}}:{{PAGENAME}}}}
[modifier] Recommandation et motivations
L'utilisation du patch info est recommandée pour la définition du jargon technique et l'écritures de nouvelles recommandations (en savoir plus).
Le patch info est donc avant tout conçu pour les recommandations et le jargon, mais il peut être employé pour une astuce/recette ou dans l'espace Projet:
pour élaborer une proposition.