Modèle:Auteur3/documentation

La bibliothèque libre.
Sauter à la navigation Sauter à la recherche

Exemple d'utilisation[modifier]

<!-- id = "Q20882" (1832 – 1923) Gustave Eiffel --> {{Auteur3|read|itemid=Q20882}} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found. <!-- id = "Q1290" (1623 – 1662) Blaise Pascal --> {{Auteur3|read|itemid=Q1290}} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Tests et déploiement de la version Auteur3[modifier]

{{Auteur3|read|id=535}} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

{{Auteur3|read|itemid=535}} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

{{Auteur3| read | itemid=535}} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Évolution du modèle Auteur2 vers Auteur3[modifier]

Ce modèle génère un en-tête pour les pages d'auteurs du Wikisource français, avec notices d'autorités.

  • Apparemment semblable à la version précédente, il est complètement réécrit en code Lua de Scribunto.
  • Les données de Wikidata sont intégrées automatiquement et il vaut mieux les corriger dans wikidata qu'ici.
  • Mais l'initiale, la clé de tri et la description automatiques ne sont pas sures pour tous les auteurs, il faut vérifier la proposition du modèle.
  • Chaque Wikisource peut sélectionner ses propres autorités, dans sa table de traductions.
  • L'argument région permet les catégories des époques anciennes de Chine ou d'Inde.
  • L'argument époque permet de modifier le siècle ou l'époque automatique d'un auteur.
  • Les arguments d'années acceptent des textes comme "vers 1872" ou "à la fin du IVe siècle" où les nombres sont reconnus automatiquement.
  • Le mode doc1 aide à documenter le modèle à partir d'un usage réel ou de tables de cas d'usages, comme dans plusieurs boites déroulantes ci-dessous.
  • Le mode edit aide les utilisateurs par des messages d'erreurs ou de conseils sur les arguments.
  • Le mode test aide les administrateurs à vérifier le module par de nombreux cas d'usages.
  • Le mode notices produit séparément les notices d'autorités d'auteurs ou de livres.


  • Ce modèle international est utilisable dans des wikisources d'autres langues, et traduit les noms d'arguments, de catégories et autres.
  • Ce modèle intègre des tables et des boîtes déroulantes souples, pour tous les wiki.
  • Les catégories peuvent s'afficher dans la langue de l'utilisateur et pointent vers la page dans la langue du wiki. Cela soutient les administrateurs qui aident d'autres wiki. Les tests en séries sont aussi partiellement traduits.
  • Certaines de ces évolutions, pour devenir automatiques ou plus sures, nécessitent des développements en cours.
Nouveaux arguments

Description[modifier]

Ce modèle crée un cartouche d’en-tête pour la page de présentation d’un auteur. Il affiche plusieurs informations (naissance, décès, courte description…) ainsi que la possibilité de montrer une image de l’auteur. Il permet aussi de catégoriser l’auteur dans les catégories spécifiées par ce modèle.
Celui ou celle qui publie des œuvres est responsable du respect des droits d’auteur . Voir l’argument droits = dans la rubrique Syntaxe complète des arguments ainsi que la rubrique Informations sur les droits d’auteur ci-dessous.
Les arguments de base sont proposés automatiquement par le modèle, mais vous devez en vérifier quelques-uns, clé de tri, initiale et description.
En mode edit, le modèle affiche aussi des messages d'informations, d'erreurs et propose des corrections de noms d'arguments.

Usage minimal[modifier]

Cet usage suffit si wikidata est bien renseigné et si le nom de l'auteur ne comporte que 2 mots.
  • Le nom et l'image deviennent automatiques et ne sont plus nécessaires.
  • droits = us ( obligatoire) : les droits de copyright et des ayants droits ne sont pas encore définis dans wikidata (). Valeur par défaut droits = us.
Celui ou celle qui publie des œuvres est responsable du respect des droits d’auteur .
  • droits = us ou droits = 70 : si les ayants droits de cet auteur(e) ont des droits de copyright aux États-Unis jusqu’à 70 ans après son décès. Valeur par défaut.
  • droits = cn ou droits = 50 : si les ayants droits de cet auteur(e) ont des droits de copyright au Canada jusqu’à 50 ans après son décès.
  • droits = mpf, si les ayants droits de cet auteur(e) mort(e) pour la France ont des droits de copyright en France jusqu’à 95 ans après son décès.
  • droits = non, si cet auteur(e) n’a pas de droits de copyright sur ses œuvres.

{{Auteur | normal | droits = cn }} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Usage avec description, CONSEILLÉ[modifier]

  • Le nom et l'image deviennent automatiques et ne sont plus nécessaires.
Si le nom de l'auteur comporte plus de 2 mots, l'initiale et la clé de tri automatiques ne sont pas surs, il faut les vérifier.
La description automatique peut être bonne ou non selon les auteurs, il faut aussi la vérifier.
Arguments pour les droits, l'initiale et la clé de tri 
  • droits = 70 : pour les droits, voir Usage minimal ci-dessus. L'entête d'auteur affiche la fin probable des droits, en bas à gauche en gris clair, ou 0 ou 1 en l'absence de droits.
  • initiale = ( obligatoire) : lettre majuscule pour classer l’auteur dans un groupe alphabétique.
  • description =  : courte description (copiée de Wikipédia par exemple). La description automatique peut être bonne ou non selon les auteurs, il faut aussi la vérifier.
  • clé = ( obligatoire) : nom de famille en ASCII, comme Hugo Victor, sans accents (pour la clé de tri des auteurs par ordre alphabétique, DEFAULTSORT, pour plus de détails voir ici) - pour connaître les règles à appliquer en cas de particule ou de nom en plusieurs parties voir les règles sur Geneawiki, ou vérifier le nom utilisé dans la notice d'autorité BNF).

{{Auteur3 | id = Q131671 | droits = us | initiale = X | clé = Xénophane, de Colophon | description = Philosophe grec présocratique }} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Époques et régions[modifier]

Tous les arguments[modifier]

{{Auteur3 | doc1 |list_all_args_title|Q535}} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Notices et autorités disponibles[modifier]

  • VIAF = 34452139 ou WORLDCATbook = 2707305499 ou autres : ces autorités s'ajoutent à celles par défaut de Wikidata.
  • autorités = ... cet argument permet de remplacer la sélection d'autorités par défaut du modèle.
  • autorités = 5, VIAF, BNF, SUDOC, ISNI, LCCN, ARC, WORLDCAT, NLA, PND, GKD sont les autorités sélectionnées par défaut par le modèle. Cette sélection signifie : sélectionner au maximum 5 autorités parmi cette liste, dans cet ordre, si elles sont définies pour cet auteur.
  • autorités = BNF, WORLDCAT, +2, VIAF, LCCN, 3, GKD signifie : sélectionner parmi celles définies pour cet auteur, les premières, puis 2 de plus parmi les suivantes, puis 3 en tout au maximum, puis GKD si possible.
  • Dès qu'un nombre limité d'autorités est atteint, la sélection s'arrète. Chaque élément de sélection n'est exécuté qu'à son tour.
  • + accepte toutes les autorités de wikidata.
  • - a la priorité sur tous les autres éléments et annule toutes les autorités de wikidata.
  • Autorités disponibles : si vous souhaitez de nouvelles autorités ou si certaines ne fonctionnent pas, vous pouvez chercher un exemple qui fonctionne et le signaler aux administrateurs.
Sélectionner une seule autorité 

{{Auteur3 | notices | autorités = - | WORLDCATbook = 2707305499}} : Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Modes et options[modifier]

  • Les modes normal, edit, doc1, notices, tests servent à des usages différents du modèle :
  • normal produit uniquement l'infobox pour un auteur. C'est le mode par défaut.
  • notice ou notices produit uniquement des liens vers des notices d'autorités.
  • edit produit l'infobox précédée d'un panneau de documentation (arguments, assistance et catégories).
  • tests produit le mode edit plus des séries de tests des fonctions de base et les contenus détaillés des tables du module (arguments, textes d'erreurs, messages, catégories, époques). Tout les utilisateurs doivent pouvoir vérifier que les fonctions de base répondent correctement dans de très nombreux cas d'usages. Ces tests aident aussi les administrateurs dans d'autres langues.
  • Les modes sont des combinaisons d'options.
Options
  • Les options proviennent indépendamment soit du mode, soit de l'argument c, et ces 2 origines se combinent.
  • Les options sont séparées seulement par des espaces, sans ponctuation.
  • docview produit le panneau de documentation (arguments, assistance et catégories).
  • docafter place après l'infobox le panneau de documentation (arguments, assistance et catégories).
  • docdata liste séparément les arguments reçus de wikidata.
  • docline place les arguments sur une seule ligne (au lieu d'une colonne).
  • docmin lister uniquement les arguments de base.
  • docdef lister uniquement les arguments contenant une valeur.
  • docmax lister tous les arguments connus du modèle, même s'ils ne contiennent pas de valeur.
  • docnotice produire une série d'exemples de toutes les notices d'autorités connues du modèle.
  • nobox ne pas produire l'infobox.
  • noerr ne pas produire l'assistance (messages et erreurs).
  • nocat ne pas produire les catégories.
  • en es fr ou toute autre langue traduite en table i18n produit les arguments, erreurs et messages dans cette langue.
  • catview montrer les catégories après l'infobox.
  • tests ajoute les tests après l'infobox.
  • docsrc montrer en couleurs l'origine des valeurs des arguments.

{{Auteur3 | doc1 | options_from_mode_title | Q535}} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

{{Auteur3 | normal | id = Q535 }} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Exemple de mode edit[modifier]

{{Auteur3 | edit | id = Q535 }} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Mode notices[modifier]

Notices d'autorité pour un auteur : {{Auteur3 | notices}} : Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Notice d'autorité pour une oeuvre (supprimer toutes les autres notices) : {{Auteur3 | notices | autorités = - | WORLDCATbook = 2707305499}} : Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Configuration du modèle[modifier]

Catégories 
  • Certaines catégories sont nouvelles ou ont évolué. C'est vous qui allez dire que faire.
Catégories particulières

Exemples :

▼ Littérature bretonne‎ (2 C, 2 P)
► Auteurs bretons‎ (17 P)
► Chants bretons‎ (2 C, 8 P)
  • Certaines catégories sont trop spécifiques et doivent être définies par l'utilisateur, comme "Chants bretons‎" ou "Poésies eddiques‎".
  • D'autres peuvent êtres produites automatiquement, comme "Auteurs bretons‎‎", à partir de traductions qui sélectionnent les variantes masculin/feminin et singulier/pluriel de chaque langue parmi des valeurs multiples. (Voir les codages language:gender, convertPlural, ...).

{{Auteur3 | doc1 | multiple_values_tests_title | Q535}} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Catégories masquées
Erreurs 
  • Le modèle détecte de nombreuses erreurs ou incertitudes.
  • Plutôt que de créer de très nombreuses catégories pour tout ces cas, il existe :
  • En mode edit, on voit les erreurs et on peut corriger en conséquence.
  • Ces deux types d'erreurs font appel à des compétences différentes.
  • Les noms exacts des catégories sont définis dans les tables de traductions pour chaque wiki.
Sélecteurs et valeurs multiples

Il y a 2 sortes de valeurs multiples :

  • Certains arguments sont limités à un petit nombre de valeurs, ce qui permet d'afficher une erreur pour les valeurs non prévues et de placer l'auteur dans une catégorie de maintenance. C'est le cas pour les droits d'auteur, la région et le sexe.
  • Les sélecteurs permettent de configurer des préférences de chaque wiki, pour les autorités et la description qui se compose des distinctions, des métiers et des fonctions.
  • Chercher dans le code authorities_selector, distinction_selector, fonction_selector et occupation_selector.
  • Ces sélecteurs et leur combinaison sont bien sur à convenir ensemble et à adapter dans chaque Wikisource.
  • La combinaison est pour l'instant figée dans le code, mais on peut l'adapter soit de manière unique pour tous les Wikisources, soit de manière plus souple mais à condition que la combinaison reste facile à comprendre pour tous.
  • Un sélecteur de quelques sélecteurs peut convenir, exemple combinaison_selector = 4,distinction_selector,fonction_selector,occupation_selector permet de garder les 4 premières distinctions, puis fonctions, puis métiers.

{{Auteur3 | doc1 | list_wiki_selectors_title}} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Il reste quelques adaptations à choisir ensemble :

Années et siècles :

  • Pour l'instant, une alerte signale une ambiguité si l'on définit un siècle en nombre romain dans anneeNaissance.
  • Le plus précis entre l'année et le siècle sert aussi à déterminer les catégories de siècle et l'époque.
  • Mais l'ancien argument siecleNaissance pourrait venir maintenant du seul argument "naissance" où le modèle sait lire les nombres décimaux des années et les nombres romains des siècles.
  • Wikidata peut fournir les dates accompagnées de leur précision, à condition de la préciser correctement, ce qui permet de choisir automatiquement entre année, mois ou siècle pour la description. Mais cette évolution est en cours dans wikidata et en projet dans le modèle.
  • De même pour anneeDeces et siecleDeces.

Notice et notices :

  • Pour l'instant, les notices sont accessibles sans l'entête d'auteur par les 2 modes identiques notice et notices.
  • Mais on pourrait les distinguer en en affichant soit une seule, soit toutes celles sélectionnées de l'auteur.
  • Les notices peuvent concerner un auteur, une oeuvre ou autres selon les bases d'autorités.
  • Les autorités sont nombreuses pour offrir un choix aux wikisources d'autres langues.
  • Il en existe bien plus dans cette liste.

Surveillance du modèle[modifier]

Catégories automatiques d’années pour les auteurs récents
Catégories automatiques d’époques
  • Un auteur est dit du xxe siècle, de 1901 à 2000, s’il a écrit pendant ce siècle de 20 ans après sa naissance à 5 ans avant son décès.
  • Ces règles automatiques peuvent placer un(e) auteur(e) dans deux époques successives.
  • Lorsqu'une année est incertaine, comme "avant 1432", ou "vers le IV siècle", l'auteur est placé dans une catégorie d’incertitude : Catégorie:Année incertaine Catégorie:Siècle incertain Catégorie:Epoque inconnue
  • La catégorie d’époque peut être modifiée en précisant une année pour définir l'époque/siècle, grâce à l'argument époque.
  • L'époque est différente selon la région : autre, chine, inde. Par défaut : autre.
  • On peut forcer le siècle à la place de l'époque grâce à la valeur région = siècle.
Catégories masquées et usages spéciaux
  • Pour voir les catégories masquées, pour le suivi de l’usage de ce modèle aller dans Mes préférences, onglet Apparence puis cocher : Afficher les catégories cachées.
  • Pour faciliter les tests et la documentation, utiliser l’argument «c = :» qui affiche les catégories au lieu de catégoriser la page.

{{Auteur3 | doc1 | missing_translations_title | Q535 }} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

{{Auteur3 | doc1 | options_from_mode_title | Q535 }} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

{{Auteur3 | doc1 | list_all_categories_title | Q535 }} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

{{Auteur3 | doc1 | list_all_errors_title | Q535 }} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

{{Auteur3 | doc1 | wikidata_any_page_title | Q535 }} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Évolutions futures[modifier]

Liste des demandes en cours pour adaptation automatique au mode edit, à la langue utilisateur et autres :

  • phab:T85419 User groups should be exposed to Scribunto
  • phab:T49930 Allow accessing data from an item not connected to the current page - arbitrary access (tracking)
  • phab:T52329 We need a common repository for Scribunto modules and templates
  • phab:T85412 The formatPropertyValues needs an option to format data from date-time, angle or geographic coordinates
  • phab:T48160 Lua: Allow using labels in mw.wikibase.entity.formatPropertyValues
  • phab:T41610 Scribunto should support global module invocations
  • phab:T53660 Detect the edit state to adapt help messages to user errors
  • phab:T67507 It should be possible to get entity id from page title
  • phab:T59656 Special:ItemDisambiguation ranking
  • phab:T68051 Get and use the user language to help to maintain a module or a template
  • phab:T87764 ugs related to time datatype
  • phab:T63958 Use existing $dateFormats to format dates on Wikidata
  • phab:T75460 [Story] Make Lua functions default to the user's language on multilingual wikis
  • T????? Todo task : Convert many modules as centralisable

------------------------------------------------------------[modifier]

Ancienne documentation[modifier]

------------------------------------------------------------[modifier]

Syntaxe simplifiée[modifier]

{{Auteur3
 | clé  = 
 | initiale  = 
 | description  = 
 | naissance  = 
 | siecleNaissance  = 
 | deces  = 
 | siecleDeces  = 
 | …
 }}
Si le nom de l'auteur comporte plus de 2 mots, l'initiale et la clé de tri automatiques ne sont pas surs, il faut les vérifier.
La description automatique peut être bonne ou non selon les auteurs, il faut aussi la vérifier.
  • droits = 70 : pour les droits, voir Usage minimal ci-dessus.
  • initiale = ( obligatoire) : lettre majuscule pour classer l’auteur dans un groupe alphabétique
  • description =  : courte description (copiée de Wikipédia par exemple)
  • clé = ( obligatoire) : nom de famille en ASCII, comme Hugo Victor, sans accents (pour la clé de tri des auteurs par ordre alphabétique, DEFAULTSORT, pour plus de détails voir ici) - pour connaître les règles à appliquer en cas de particule ou de nom en plusieurs parties voir les règles sur Geneawiki, ou vérifier le nom utilisé dans la notice d'autorité BNF).
Arguments pour les droits, l'initiale et la clé de tri 


  • nom = ( obligatoire) : nom complet, comme Victor Hugo
  • clé = ( obligatoire) : nom de famille en ASCII, comme Hugo Victor, sans accents (pour la clé de tri des auteurs par ordre alphabétique, DEFAULTSORT, pour plus de détails voir ici) - pour connaître les règles à appliquer en cas de particule ou de nom en plusieurs parties voir les règles sur Geneawiki, ou vérifier le nom utilisé dans la notice d'autorité BNF).
  • naissance =  : année (au format numérique –500 pour 500 av. J.-C.)
  • siecleNaissance =  : numéro du siècle au format numérique, –5 pour le ve siècle av. J.-C.)
  • deces =  : année au format numérique –500 pour 500 av. J.-C.
  • siecleDeces =  : numéro du siècle au format numérique, –5 pour le ve siècle av. J.-C.
  • image =  : lien vers une image sans le préfixe Fichier:

{{Auteur}} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.

Syntaxe simplifiée[modifier]

{{Auteur3
 | nom  = 
 | clé  = 
 | initiale  = 
 | description  = 
 | naissance  = 
 | siecleNaissance  = 
 | deces  = 
 | siecleDeces  = 
 | image  = 
 | …
 }}
Arguments obligatoires ou importants :
  • Les arguments ( obligatoires) peuvent venir de wikidata.
  • clé = ( obligatoire) : nom de famille en ASCII, comme Hugo Victor, sans accents (pour la clé de tri des auteurs par ordre alphabétique, DEFAULTSORT, pour plus de détails voir ci-dessous.
  • initiale = ( important) : lettre majuscule pour classer l’auteur dans un groupe alphabétique. Elle est normalement déduite de la clé de tri ou du nom, mais doit être vérifiée.

Arguments optionnels sauf indiqués[modifier]

  • nom = ( obligatoire) : nom complet, comme Victor Hugo
  • clé = ( obligatoire) : nom de famille en ASCII, comme Hugo Victor, sans accents (pour la clé de tri des auteurs par ordre alphabétique, DEFAULTSORT, pour plus de détails voir ici) - pour connaître les règles à appliquer en cas de particule ou de nom en plusieurs parties voir les règles sur Geneawiki, ou vérifier le nom utilisé dans la notice d'autorité BNF).
  • initiale = ( obligatoire) : lettre majuscule pour classer l’auteur dans un groupe alphabétique
  • description =  : courte description (copiée de Wikipédia par exemple)
  • naissance =  : année (au format numérique –500 pour 500 av. J.-C.)
  • siecleNaissance =  : numéro du siècle au format numérique, –5 pour le ve siècle av. J.-C.)
  • deces =  : année au format numérique –500 pour 500 av. J.-C.
  • siecleDeces =  : numéro du siècle au format numérique, –5 pour le ve siècle av. J.-C.
  • image =  : lien vers une image sans le préfixe Fichier:



Informations sur les droits d’auteur
Selon l’année de décès et le paramètre droits = , si les ayants-droits de l’auteur(e) sont susceptibles d’avoir des droits, un avertissement s’affiche. Mais cette information n’est qu’une aide et Celui ou celle qui publie des œuvres est responsable du respect des droits d’auteur .

{{Auteur3 | doc1 | multiple_values_rights_title | Q535}} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found. {{Auteur3 | doc1 | copyright_box_test_title | Q535}} Erreur Lua dans package.lua à la ligne 80 : module 'Module:Centralizer-s-fr' not found.




Informations sur les droits d’auteur
Selon l’année de décès et le paramètre droits = , si les ayants-droits de l’auteur(e) sont susceptibles d’avoir des droits, un avertissement s’affiche. Mais cette information n’est qu’une aide et Celui ou celle qui publie des œuvres est responsable du respect des droits d’auteur .