Wikipédia:Jargon/Patch info
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.
Description détaillée
[modifier le code]- 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 identifie-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 recensés dans Catégorie:Jargon de Wikipédia.
- Les patchs de proposition de recommandations sont recensé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 conçu pour s’insérer 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) ».
Exemples
[modifier le code]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 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. (en savoir plus). ».
- À noter que dans l’exemple ci-dessus, les lettres en grasses de la phrase entre parenthèses seront remplacées par un lien vers cette page-ci lorsqu’incluses dans une autre page que celle-ci. Voir cet exemple représentatif.
Elle peut également être liée avec {{Aide détaillée}} :
- le code «
{{Aide détaillée|Wikipédia:Jargon/Géolocalisation{{!}}Géolocalisation}}
» donne :
Un ensemble de patches info de jargon peut être compilé pour créer facilement une section jargon. Voir, par exemple, le jargon de la géolocalisation :
- 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.
Convention de formatage de la page
[modifier le code]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 être 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}}}}
Recommandation et motivations
[modifier le code]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.