Projet:Infobox/Fiche/Construction

(Redirigé depuis Modèle:Fiche)


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.

Fiche modifier

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

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

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

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

{{Infobox Musique (œuvre)}}ajouter

Avantages et objections modifier

  • 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

  • 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

Liste des fiches modifier

"Vraies" fiches
{{Infobox Musique (œuvre)}}ajouter
tous les "Modèle:Fiche ..."
Fiches à faire
{{Fiche Lieu}}{{Fiche Événement}}{{Fiche Localité Guatemala}}{{Fiche Protéine}} ...

Brique de fiche modifier

Description des briques modifier

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

Les briques de suffixe « /Aide » sont dédiés aux modèles d'assistance


Exemples modifier

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

Syntaxe modifier

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

À 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

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.
  • ... ?


Style des fiches modifier

Usage de classes modifier

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

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

Documentation des fiches modifier

Modèle d'assistance de fiches modifier

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

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 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> ».}}
}}

Autres modifier

à faire
  • la documentation des fiches
  • rendre certains paramètres obligatoires.

Notes modifier

  1. Avertissement nécessaire car {{Fiche}} redirige vers cette page

Voir aussi modifier

Page connexes modifier

Autres modèles crées modifier

Liens utiles modifier