Projet:Infobox/Fiche/Construction
Cette page n'est pas un modèle[1]. Elle a pour but d'élaborer une nouvelle génération d'Infobox appelées Fiches (le terme de "Fiche" reste à débattre).
Attention : Les procédés décrits sont à un stade expérimental. Les liens des titres conduisent aux pages de discussion.
Cette page décrit une recommandation pour le développement d'infobox. Elle propose la construction d'une nouvelle génération d'infobox appelées « Fiche ». Initialement, cette recommandation mettait l'accent sur la catégorisation automatique des pages par le biais des infoboxes ; mais cette considération est désormais accessoire.
Recommandation
[modifier | modifier le code]Un modèle de fiche est un modèle infobox qui obéit à des conventions sévères, de création, de formatage et de paramètrage (à définir) afin d'être exploitable en tant que métadonnées (en savoir plus). Il est souhaitable que les infobox deviennent à terme des fiches. « Fiche » signifie donc : (prototype d') « Infobox nouvelle génération »
Motivations
[modifier | modifier le code]Cette recommandation vise à concilier les faits suivants :
- Les résultats du sondage concernant le terme "infobox se résume à : il serait préférable de renommer infobox en un terme français tel que "Fiche" ; mais ce travail n'est pas à entreprendre inutilement.
- Cependant, une nécessaire harmonisation des modèles (notamment du paramétrage) entraînera fatalement le renamiement de quasiment tous les modèles d'infobox(es)
- Il est préférable d'employer un terme neuf pour les modèles nouvelle génération, ceci pour éviter les confusions entre vieux modèles et ces nouveaux modèles.
- De plus, la typographie (Infobox/InfoBox/infoboîte/...) et l'orthographe (des infoboxes/infobox) sont problématiques.
- L'utilisation de ParserFunctions permet des modèles de meilleur qualité que la infoboxes existantes (grâce à l'utilisation de
{{#formatnum: ...}}
et{{#expr: ...}}
notamment). - L'évolution de Wikipédia va vers l'incorporation de métadonnées dans les articles. Il est plus que souhaitable que cela ne se fasse pas en redondance avec les infoboxes.
- Les deux raisons précédentes font que les valeurs de paramètres des infoboxes doivent le plus souvent possible être des données brutes.
- Enfin WP doit acquérir un certain professionnalisme dans la programmation des modèles.
- En matière de catégorisation des pages, un certain "laxisme" des wikipédiens et un goût immodéré du découpage ont entrainé un piètre état des choses. Le développement de la catégorisation automatique (c.-à-d., intégrée à l'infobox) est donc souhaitable pour remédier à cela.
Caractéristiques
[modifier | modifier le code]On décrit les particularités propres aux fiches (elles restent à débattre)
- Tout modèle de fiche doit avoir le marqueur
{{Fiche ...}}
dans son nom. - Une fiche respectent les conventions générales de Projet:Modèle/Harmonisation : en particulier on harmonisera le paramétrage des fiches
- Codage CSS du style : l'apparence de la fiche est gérée par une feuille de style
- Le code d'une fiche est morcellé code en briques afin de faire disparaitre tous les aspects techniques des tableaux.
- Une fiche offre un modèle d'assistance pour son renseignement dans les articles.
- Catégorisation
- Le modèle "catégorise" les articles qui l'emploie selon un schéma rigoureux (à débattre) :
- Le modèle
{{Fiche type}}
doit (dans la mesure du possible) "catégoriser" dans[[Catégorie:type]]
. Toutefois, le choix de la catégorie peut être paramétré (selon la nationalité, par exemple). - Ce procédé de catégorisation doit être notifié dans la description de la catégorie avec {{Catégorisée par}} et dans la description du modèle avec {{Catégorise}}.
- Le modèle de fiche ne doit pas être l'occasion d'entreprendre une catégorisation alternative à la catégorisation existante.
- Avant de créer un modèle de fiche, assurez-vous que sa catégorie respectera les recommandations (de sur/sous-peuplement notamment), et annoncez-le dans le projet concerné et/ou dans le projet Modèle.
Exemples
[modifier | modifier le code]Avantages et objections
[modifier | modifier le code]- La catégorisation des pages se fera en partie de manière automatique, et s'en trouvera ainsi facilitée.
- Cette réforme permettra de mettre fin aux discordances en matière de paramétrage.
- Le terme "Fiche" (qui reflète bien l'aspect technique) se substituera progressivement au terme "Infobox" qui choque certains.
Réponses aux objections concernant la catégorisation
[modifier | modifier le code]- Cette recommandation est certe plutôt contraire à la recommandation ancienne (Utilisation de modèles qui "catégorisent" automatiquement -- 2004), mais elle est justifiée par l'évolution de Mediawiki et Wikipédia.
- « On risque de se retrouver avec des catégories regroupant tout et n'importe quoi : articles, pages de discussion, sous-pages d'utilisateurs, pages Meta. » : Non grâce aux parserfunctions. Il faut utiliser
{{#if:{{NAMESPACE}}||[[Catégorie:<nom de la catégorie>]]}}
. - Le terme "fiche", devenant de facto un terme consacré, les wikipédiens sauront que la page utilisant une fiche est automatiquement catégorisée.
- L'obligation d'annoncer la création de fiche permettra d'éviter les créations, à la va-vite, sources de certaines maladresses actuelles.
Voir aussi
[modifier | modifier le code]- Projet:Catégories/Recommandation
- Projet:Charte graphique/Apparence des Infobox
- Projet:Modèle/Harmonisation
Liste des fiches
[modifier | modifier le code]- "Vraies" fiches
- {{Infobox Musique (œuvre)}} •
- tous les "
Modèle:Fiche
..."
Modèle:Fiche
..."- Fiche 90minut
- Fiche Footballdatabase
- Fiche Footballdatabase/Documentation
- Fiche INSC
- Fiche Soccerbase
- Fiche de références
- Fiche framasoft
- Fiche framasoft/Documentation
- Fiche langue
- Fiche lequipe
- Fiche lequipe/Documentation
- Fiche societe.com
- Fiche societe.com/Documentation
- Fiche sur Footgoal
- Fiche sur Footgoal/Documentation
- Fiche sur bsdb
- Fiche sur bsdb/Documentation
- Fiches à faire
- {{Fiche Lieu}} • {{Fiche Événement}} • {{Fiche Localité Guatemala}} • {{Fiche Protéine}} ...
Description des briques
[modifier | modifier le code]L'idée est de se débarrasser de toutes les considérations techniques en les plaçant dans un petit jeu de modèles. Ce jeu sera un ensemble de briques de base pour construire les modèles d'infoboxes/fiches. Cela ressemble un peu à l'utilisation de widgets pour la construction des boites de dialogue en GUI.
Quelques caractéristiques des briques de fiches :
- Ce sont les sous-pages de {{Fiche}}.
- On utilise {{Documentation de brique de fiche}} pour leur documentation.
- Elles emploient du code HTML (non la syntaxe wiki pour les tableaux)
- Elle n'emploient aucune commande de style (mais seulement
class="fiche {{{classes|}}}"
). L'apparence d'une fiche sera donc entièrement définie par une feuille de style (CSS) (en fait pour le moment les briques conservent également une version avec un style par défaut dont les couleurs sont paramétrables).
Liste des briques
[modifier | modifier le code]Les briques de suffixe « /Aide
» sont dédiés aux modèles d'assistance
Exemples
[modifier | modifier le code]Ce procédé est en cours de test dans le code de {{Fiche Ville}}.
Syntaxe
[modifier | modifier le code]Un aperçu rapide de la syntaxe (valable pour le code CSS du style ; non pour le style par défaut) :
{{Fiche/Début|classes}} {{Fiche/Titre|1=titre}} {{Fiche/Nom|{{{nom|}}} }} {{Fiche/Sous-titre|1=titre|condition}} {{Fiche/Séparateur|condition}}<!--une forme particulière de sous-titre (sans sous-titre ;)--> {{Fiche/Image|image|légende}} ... {{Fiche/Ligne|intitulé|valeur}}<!--usage reservé aux autres briques--> {{Fiche/Ligne double|style|valeur}}<!--usage reservé aux autres briques--> {{Fiche/Ligne facultative|intitulé|valeur}} ... {{Fiche/Ligne obligatoire|condition|intitulé|valeur|message}} ... {{Fiche/Valeur numérique|intitulé|valeur|unité}} ... {{Fiche/Pays obligatoire|{{{pays|}}}}} {{Fiche/Géolocalisation|carte|latitude|longitude}}<!--le minimum--> {{Fiche/Géolocalisation|carte|latitude|longitude|légende|point|valeur|type|image}} {{Fiche/Géolocalisation/Ville|carte|latitude|longitude|ville|statut|population}} {{Fiche/Site Web|intitulé|lien}} {{Fiche/Fin}}
Style par défaut
[modifier | modifier le code]À ce stade expérimental, les briques et {{Fiche Ville}} propose un style par défaut (afin de rendre présentable les fiches à ceux qui n'emploient pas les feuilles de style). Ce style est "gravé dans le code wiki". On désactive le style par défaut {{Fiche Ville}} avec la code : {{Fiche Ville|css=1|....}}
(le style est alors défini par une feuille de style (CSS)).
Concrètement, cela permet de comparer les versions « avec class
(es) + CSS » et « avec apparence intégrée au code wiki ».
Paramètres supplémentaires
[modifier | modifier le code]Les briques de fiches possèdent momentanément des paramètres supplémentaires pour le style par défaut (voir le code de {{Fiche Ville}}). Il peut être souhaitable que certains de ces paramètre subsistent :
couleur de fond
(dans {{Fiche/Titre}}) : parce que ce paramètre risque d'être différent pour chaque modèle de fiche.largeur de colonne
(pas encore intégré) : même raisonlargeur
(dans {{Fiche/Image}}) : à cause de certaines images trop en longeur.- ... ?
Usage de classes
[modifier | modifier le code]Usage de « classes
» en paramètre de {{Fiche/Début}} :
class="charte_thème"
pour adapter l'apparence de la fiche a son thème donné.
Usage de classes (class
) dans les briques :
class="fiche"
dans l'entête ;class="ficheimage"
pour l'image et sa description ;class="fichetitre"
pour le titre (contrairement à MediaWiki:Common.css qui semble utiliser.infobox caption
) ;class="fichesoustitre"
pour le sous-titre.
Les feuilles de style
[modifier | modifier le code]Aide • Exemples |
Fonctions avancées |
Apparence Vector |
Apparence Timeless |
Projet:Scripts et gadgets |
(en) User styles |
common.css personnel |
Common.css commun |
Monobook.css commun |
Vector.css commun |
(en) Catalogue of classes |
Index des propriétés CSS2 |
common.js personnel |
Common.js commun |
Fonctions JavaScript |
Quelques styles pour les fiches. Il faut choisir l'un de ces styles pour que certaines fiches apparaissent correctement :
- style actuel : le style actuel des infoboxes
- style Antaya
- style STyx : mon futur style perso <STyx @
- style JSDX : style basé sur {{Infobox Musique (artiste)}}
N'hésitez pas à proposer ici votre style personnel (recopiez d'abord l'une de ces pages)
- Liens utiles
Le principe général est (le même que celui de {{Aide}}) :
Pour obtenir une assistance, écrire "Aide" et prévisualiser.
Bien sur, il faut supprimer "Aide" avant d'enregistrer.
Concrètement, le modèle d'assistance de la fiche {{Fiche Ville}} est {{Fiche Ville/Aide}}. {{Fiche Ville/Aide}} offre une assistance au renseignement de la fiche {{Fiche Ville}}. Le point fort de ce principe que l'aide est contextuelle. Elle permet de faire (en quelque sorte) un audit du contenu de la fiche ; d'indiquer comment remplir les paramètres omis ; d'indiquer comment convertir l'infobox en fiche ; ...
Syntaxe des briques pour l'assistance
[modifier | modifier le code]Pour simplifier l'écriture du modèle d'assistance, on emploie un procédé de decoupage en briques similaire à celui du modèle.
{{Fiche/Début/Aide|1=nom du modèle}}<!--Attention : nom sans "Modèle:" ; pas de {{PAGENAME}}--> ... {{Fiche/Ligne/Aide|1=nom du paramètre|2=texte}} {{Fiche/Ligne facultative/Aide|1=nom du paramètre|2=texte|valeur}} ... {{Fiche/Pays obligatoire/Aide|1=pays}} {{Fiche/Fin/Aide}}
Code du modèle "Fiche X "
|
Code du modèle d'assistance "Fiche X/Aide "
|
---|---|
{{Fiche/Début|...}} {{Fiche/Nom|{{{nom|}}}}} {{Fiche/Image|image={{{image|}}}|légende={{{légende|}}} }} {{Fiche/Sous-titre|Caractéristiques}} {{Fiche/Pays obligatoire|{{{pays|}}} }} {{Fiche/Ligne facultative|intitulé=Genre|valeur={{{genre|}}} }} {{Fiche/Ligne facultative|intitulé=Label|valeur={{{label|}}} }} ... {{Fiche/Fin}} |
{{Fiche/Début/Aide|Fiche X}} {{Fiche/X |image={{{image|}}} |légende={{{légende|<span class="error" style="font-size:80%;">image sans légende</span>}}} |pays={{{pays|}}} |genre={{{genre|<span class="error" style="font-size:80%;">pas de genre</span>}}} |label={{{label|<span class="error" style="font-size:80%;">pas de label</span>}}} ... }} {{Fiche/Nom/Aide|{{{nom|}}}}} {{Fiche/Image/Aide|image={{{image|}}}|légende={{{légende|}}} }} {{Fiche/Pays obligatoire/Aide|{{{pays|}}} }} {{Fiche/Ligne facultative/Aide|genre|...|valeur={{{genre|}}} }} {{Fiche/Ligne facultative/Aide|label|...|valeur={{{label|}}} }} ... {{Fiche/Fin/Aide}} |
La situation du tableau est un peu idéalisée. Les briques d'aide du modèle et de l'assistance ne correspondent pas forcément. On peut par exemple employer
{{Fiche/Ligne facultative/Aide|genre|'''Ce paramètre est obligatoire.''' ...|valeur={{{genre|}}} }}
dans l'assistance d'un modèle qui emploie
{{Fiche/Ligne obligatoire|intitulé=genre|valeur={{{genre|}}}|message=il faut un genre}}.
Le modèle
{{Fiche/Ligne/Aide|genre|...}}
affichera toujours la description Modèle:Fiche/Ligne/Aide alors que
{{Fiche/Ligne facultative/Aide|genre|'''Ce paramètre est obligatoire.''' ...|valeur={{{genre|}}} }}
n'affichera cette description que si le genre
est donnée (c.-à-d., ssi |genre=
reçoit une valeur que est autre que des espaces). De plus, on peut dans certain cas améliorer l'assistance en testant la valeur. Voici un exemple fictif :
{{#switch: {{{genre|}}} |M |F=<!--tout va bien--> |={{Fiche/Ligne/Aide|genre|Le genre est soit « <code>F</code> » (féminin), soit « <code>M</code> » (masculin).}} |#default={{Fiche/Ligne/Aide|genre|'''Le genre donné : « <code>{{{genre}}}</code> » n'est pas valide'''. Il faut soit « <code>F</code> », soit « <code>M</code> ».}} }}
- à faire
- la documentation des fiches
- rendre certains paramètres obligatoires.
Notes
[modifier | modifier le code]- Avertissement nécessaire car {{Fiche}} redirige vers cette page
Voir aussi
[modifier | modifier le code]Page connexes
[modifier | modifier le code]- Projet:Infobox (d · h · j · ↵)
- Projet:Catégories/Recommandation/Modèle de fiche (d · h · j · ↵) : définition d'un modèle de fiches, recommandations et motivations.
- Projet:Modèle/Harmonisation (d · h · j · ↵) : élaboration de normes (une charte) pour les modèles en vue d'une campagne d'harmonisation des modèles (des infoboxes plus particulièrement). (Il ne s'agit pas ici de juger des apparences des modèles (cela concerne plutôt, la charte graphique et la gestion des styles CSS), mais d'harmonisation des titres, du paramétrage, des techniques de codage, du jargon, des méta-modèles, des infoboxes...)
- Projet:Charte graphique/Apparence des InfoBox (d · h · j · ↵) : élaboration de normes pour l'apparence des infoboxes.
- Modèle:Fiche Ville (d · h · j · ↵) • Modèle:Fiche Musique (œuvre) (d · h · j · ↵) : sont des prototypes de fiches.
- Modèle:Géobox/Documentation, Utilisateur:Vincnet/Boite : Projet similaire.