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.

Icône de détail Page de démonstration : Projet:Infobox/Fiche/Exemples.

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}}[ajouter]
tous les "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


Fiche/Début Fiche/Début/Aide Fiche/Fin
Fiche/Fin/Aide Fiche/Géolocalisation Fiche/Géolocalisation/Ville
Fiche/Image Fiche/Ligne Fiche/Ligne/Aide
Fiche/Ligne double Fiche/Ligne facultative Fiche/Ligne facultative/Aide
Fiche/Ligne obligatoire Fiche/Nom Fiche/Nom/Aide
Fiche/Pays obligatoire Fiche/Pays obligatoire/Aide Fiche/Site Web
Fiche/Sous-titre Fiche/Séparateur Fiche/Titre
Fiche/Valeur numérique

[modifier] Exemples

Ce procédé est en cours de test dans le code de {{Fiche Ville}}.

Icône de détail Page de démonstration : Projet:Infobox/Fiche/Exemples.

[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 raison
  • largeur (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 :

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}}
Principe général de construction du modèle d'assistance
(Bien sur, la situation est un peu idéalisée)
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

[modifier] Autres modèles crées

[modifier] Liens utiles