Utilisateur:Rical/Auteur/Documentation

Ce module EN TEST génère un cadre d'en-tête pour les pages d'auteurs du WikiSource français (en remplacement de l'actuel Modèle:Auteur).

• Ce module Module:Auteur utilise Module:ControlArgs et Module:MathRoman.

Livres (avec notices ?)

• Sous les toits de Paris.
• Recueil de poèmes.

Fonctions et conception

• http://fr.wikisource.org/wiki/Module:Auteur
• Ce module dessine un cadre d'entête de page d'auteur dans wikisource français.
• Il est appelé par le Modèle:Auteur
• Il utilise le Module:ControlArgs pour vérifier les paramètres (arguments en anglais), et pour alerter ou conseiller l'utilisateur.

• This module draws a header of Author page in french wikisource
• It is called by templates Template:Auteur
• It uses the Module:ControlArgs to verify arguments (les paramètres en français), and to warm or advise the user.

• Le Module:Auteur utilise le Module:ControlArgs ainsi :
• L'assistance à l'utilisateur génère des messages sur les paramètres à problèmes.
• Une table des arguments permet de repérer les arguments nécessaires, manquants, synonymes, numérotés ...
• Des tables de traductions permettent de recevoir les arguments ou de générer les messages en plusieurs langues.

Example of complex template with many arguments

Exemple de modèle complexe avec de nombreux paramètres

{ {Auteur |c=:|options=fr test params

|nom=Hugo|prénom=Victor|prénomGall= Arthur

|cle=Hugo Victor|initiale=H

|image=Victor Hugo.jpg |description=écrivain français

|texte=vie |categorie=Auteurs |lien=du |liaison=de l'

|texteNaissance=a |categorieNaissance=Auteurs

|incertitudeNaissance= vers |lienNaissance=du |liaisonNaissance=en

|anneeNaissance= 1802 |siecleNaissance= 19

|texteDeces=a |categorieDeces=Auteurs

|incertitudeDeces= après |lienDeces= du |liaisonDeces=en

|anneeDeces= 1885 |siecleDeces= 19

|droits=non |pseudo=Monsieur Legrand

|genre=Romanciers/Poètes/Auteurs de théatre

|langue=français |pays=France/Italie/Grèce

|metier=Académiciens/Personnalités politiques

|prix=Prix Nobel de littérature

|VIAF=34452139|NLA=35096649|BNF=cb11888266r|SELIBR=34648|PND=11850133X|LCCN=n/50/23101

|border=0

} }

GESTION DES PARAMETRES DU MODELE, MANAGING PARAMETERS OF THE TEMPLATE

• La gestion des paramètres permet de :
  • Lire et mémoriser tous des paramètres fournis par le modèle (voir arg_input arg_memorize)
  • S'adapter à la langue du wiki pour les paramètres, et à la langue de l'utilisateur pour les messages.
  • Lire ou modifier simplement la valeur mémorisée chaque fois que nécessaire, indépendamment de la langue (voir argv arg_memorize)
  • Lister les paramètres, tous(docmax), ou ceux définis(docdef), ou selon la spécialisation (docmin, doc1 à doc3)
  • Aider à documenter le modèle selon divers aspects, types, usages ...
  • Lire d'abord tous les paramètres définis, puis calculer les interactions des noms, prénoms, et autres.
  • Développer la vérification des paramètres, de leurs valeurs, de leurs interdépendances.
• Une table args_known décrit les paramètres, leurs types, leurs valeurs et leurs appelations dans diverses langues.
• Les types sont ctr = controle, dat = donnée, ntc = notice, opt = options, syn = synonyme, prg = géré uniquement par le programme
• Les langues sont : en = anglais, es = espagnol, fr = français et il est facile d'en ajouter.
• L'objet MArgms, tables et fonctions, est développé ici pour être déplacée dans un module indépendant et partagé.
• Le 2013-01-27, l'objet MArgms est prévu pour fonctionner comme une classe, avec héritage et fonction New, mais n'est pas encore validé.