Projet:Infobox/Fiche/Construction
Un article de Wikipédia, l'encyclopédie libre.
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.
Sommaire |
[modifier] Fiche
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 ».
[modifier] Liste des fiches
- "Vraies" fiches
- {{Fiche Cratère terrestre}} • {{Fiche Musique (œuvre)}} • {{Fiche Ville}} • {{Fiche Personne}} • {{Fiche Émission de radio}} •
- tous les "
Modèle:Fiche
..."
Modèle:Fiche
..."- Fiches à faire
- {{Fiche Lieu}} • {{Fiche Événement}} • {{Fiche Localité Guatemala}} • {{Fiche Protéine}} ...
[modifier] Brique de fiche
[modifier] Description des briques
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).
[modifier] Liste des briques
Les briques de suffixe « /Aide
» sont dédiés aux modèles d'assistance
[modifier] Exemples
Ce procédé est en cours de test dans le code de {{Fiche Ville}}.
[modifier] Syntaxe
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}}
[modifier] Style par défaut
À 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 ».
[modifier] Paramètres supplémentaires
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.- ... ?
[modifier] Style des fiches
[modifier] Usage de classes
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.
[modifier] Les feuilles de style
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
[modifier] Documentation des fiches
[modifier] Modèle d'assistance de fiches
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 ; ...
[modifier] Syntaxe des briques pour l'assistance
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
|genre=
: ...
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> ».}} }}
[modifier] Autres
- à faire
- la documentation des fiches
- rendre certains paramètres obligatoires.
[modifier] Notes
[modifier] Voir aussi
[modifier] Page connexes
- 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 Cratère terrestre (d · h · j · ↵) • Modèle:Fiche Musique (œuvre) (d · h · j · ↵) : sont des prototypes de fiches.