Commons:Machine-readable data/fr

Shortcut: COM:MRD

Sur Wikimédia Commons, de nombreuses métadonnées (incluant la licence et l'auteur) ne sont pas exploitables par des programmes. Il existe un module d'API, iiprop=extmetadata, qui peut être utilisé pour extraire certaines valeurs (exemple), mais comme les informations sont entrées comme texte libre dans la page de description du fichier, le résultat n'est pas parfait. Le projet en cours, données structurées de Commons, vise à déplacer les métadonnées, en tant que données entièrement structurées, ce qui devrait au final permettre de remplacer les données exploitables par des programmes présentées sur cette page.

Dans l'intervalle, et pour faciliter la transition à venir vers des données structurées, Wikimédia Commons utilise une série de modèles qui sont exploitables par des programmes de plusieurs manières, via les balises HTML. Certains scripts utilisent déjà cette possibilité. Il est important de noter que ces données sont disponibles pour tous les wikis qui utilisent Wikimédia Commons, où elles peuvent être lues dans le code HTML de la page Fichier: tout comme les autres données locales.

Données exploitables par des programmes

Données exploitables par des programmes ajoutées par des modèles de type infobox

Voici différents éléments HTML des modèles de description qui permettent de lire les informations:

  • Les microformats qui suivent les standards et peuvent être lus par des parser déjà existants.
  • Les attributs id (identifiants) des balises <td> sont des valeurs personnalisées qui permettent de compléter ces balises, ils doivent pouvoir être lus par des outils adaptés. La plupart des boîtes d'information les plus courantes ont deux colonnes : la première contient les noms des champs et la seconde contient les valeurs associées à ces champs
    • Traditionnellement, les attributs id des balises <td> étaient utilisés pour marquer l'appel au nom d'un champ dans la première colonne d'une ligne. Pour obtenir la valeur associée, il faut récupérer le contenu de la cellule <td> suivante, située dans la seconde colonne.
    • Les modèles {{Creator}} et {{Institution}} ont une structure plus compliquée, ce qui fait que les cellules contenant les données sont marquées par des balise avec des attributs utilisant une couleur de fond magenta.
Modèle Nom du paramètre du modèle Description identifiant de l'attribut de la balise <td> microformats Commentaire
{{Information}}descriptiondescription du fichierfileinfotpl_deschProduct.description.Contient souvent plusieurs langues, annotées avec le modèle {{Lang}}.
{{Information}}datedate de création de l’œuvre originalefileinfotpl_datehCalendar vevent.dtstartContient la date de publication soit seule, soit en complément de la date de création. Ces deux dates ont un sens différent du point de vue des droits d'auteur. L'utilisation du modèle {{Date context}} permet de mentionner cette différence. Microformat ajouté par le modèle {{Date}}.
{{Information}}sourcesource du fichierfileinfotpl_srcContient souvent des tableaux complets. Nous ne disposons pas encore de moyens efficaces de gérer ce type de modèle décrivant des sources. Les modèles décrivant les sources font souvent référence à des identifiants dans des catalogues, mais ces derniers ne sont pas non plus des données exploitables par des programmes.
{{Information}}authorauteur du fichierfileinfotpl_autCeci peut être un auteur, un créateur et/ou un détenteur des droits de manière indifférenciée. Contient souvent le modèle {{Creator}}, décrit plus bas.
{{Information}}permissionlicence/permission pour le fichierfileinfotpl_perm
{{Information}}other versionsautres version du fichierfileinfotpl_ver
{{Artwork}}descriptiondescription de l’œuvrefileinfotpl_deschProduct.description
{{Artwork}}datedate de création de l’œuvre originalefileinfotpl_datehCalendar vevent.dtstartMicroformat ajouté par le modèle {{Date}}
{{Artwork}}sourcesource du fichierfileinfotpl_src
{{Artwork}}artistcréateur de l’œuvrefileinfotpl_aut"hProduct.fn value"
{{Artwork}}authorauteur de l’œuvre d'artfileinfotpl_aut"hProduct.fn value"
{{Artwork}}permissionlicence/permission pour le fichier et l’œuvrefileinfotpl_perm
{{Artwork}}other versionsautres versions du fichierfileinfotpl_ver
{{Artwork}}titletitre de l’œuvrefileinfotpl_art_titlehProduct.fn
{{Artwork}}object typeobjet de type œuvre d'artfileinfotpl_art_object_type
{{Artwork}}mediumTechniques ou matériaux utilisés pour créer l'œuvrefileinfotpl_art_medium
{{Artwork}}dimensionsdimensions de l’œuvrefileinfotpl_art_dimensions
{{Artwork}}galleryinstitution détenant l’œuvrefileinfotpl_art_gallery
{{Artwork}}locationlocalisation de l’œuvre au sein de l’institutionfileinfotpl_art_locationhProduct.locality
{{Artwork}}accession numbernuméro d'inventaire de l'œuvrefileinfotpl_art_idhProduct.identifier
{{Artwork}}object historyhistorique de l'œuvrefileinfotpl_art_object_history
{{Artwork}}exhibition historyhistorique d'exposition de l'œuvrefileinfotpl_art_exhibition_history
{{Artwork}}credit linemodalités d'entrée de l'œuvre dans la collection du muséefileinfotpl_art_credit_line
{{Artwork}}inscriptionsDescription des inscriptions, filigranes, sous-titres, armes sur l'œuvrefileinfotpl_art_inscriptions
{{Artwork}}notesCommentaires sur l’œuvre d'artfileinfotpl_art_notes
{{Artwork}}referencesRéférences liées à l’œuvre d'artfileinfotpl_art_references
{{Book}}Authorauteur du livrefileinfotpl_author
{{Book}}Editoréditeur du livrefileinfotpl_book_editor
{{Book}}Translatortraducteur du livrefileinfotpl_book_translator
{{Book}}Illustratorillustrateur du livrefileinfotpl_book_illustrator
{{Book}}Titletitre du livrefileinfotpl_book_title
{{Book}}Subtitlesous-titre du livrefileinfotpl_book_subtitle
{{Book}}Series titletitre de la série à laquelle appartient le livrefileinfotpl_book_series-title
{{Book}}Authority filedonnées du contrôle d'autoritéfileinfotpl_book_authority
{{Book}}Publisheréditeur du livrefileinfotpl_book_publisher
{{Book}}Printerimprimeur du livrefileinfotpl_book_printer
{{Book}}Year of publicationdate ou année de publication du livrefileinfotpl_date
{{Book}}Place of publicationlieu ou ville de publication du livrefileinfotpl_book_place-of-publication
{{Book}}Languagelangue du livrefileinfotpl_book_language
{{Book}}Descriptiondescription du livrefileinfotpl_desc
{{Creator}}NameNom de l'auteurcreatorvCard.fn
{{Creator}}Alternative namesAutres noms du créateurfileinfotpl_creator_alt-name_valuevCard.nickname
{{Creator}}DescriptionNationalité et profession du créateufileinfotpl_creator_desc_valuevCard.note
{{Creator}}Date of deathDate de décès du créateurfileinfotpl_creator_deathdate_value
{{Creator}}Date of birthDate de naissance du créateurfileinfotpl_creator_birthdate_valuevCard.bday
{{Creator}}Location of birth/deathLieu de décès du créateurfileinfotpl_creator_deathloc_value
{{Creator}}Location of birthLieu de naissance du créateurfileinfotpl_creator_birthloc_value
{{Creator}}Work periodPériode d'activité de l'auteurfileinfotpl_creator_work-period_value
{{Creator}}Work locationPériode d'activité de l'auteurfileinfotpl_creator_work-location_valuev
{{Creator}}ImagePortrait ou photo représentant le créateurfileinfotpl_creator_image
{{Creator}}Authority fileContrôle d'autorité en lien avec le créateurfileinfotpl_creator_authority_value


{{FileContentsByBot}}(divers)variable, merci de vous référer à la page : {{FileContentsByBot}}(various)hproduct-by-botjeu de données de grande taille et en constante augmentation, merci de vous référer à cette page : {{FileContentsByBot}}
{{Photograph}}titleTitre de la photographiefileinfotpl_art_titlehProduct.fn
{{Photograph}}descriptionDescription de la photographiefileinfotpl_deschProduct.description
{{Photograph}}original descriptiondescription d'archive d'origine de la photographiefileinfotpl_deschProduct.description
{{Photograph}}dateDate de création de l’œuvre d'art originalefileinfotpl_datehCalendar vevent.dtstartMicroformat ajouté par le modèle {{Date}}
{{Photograph}}mediumTechnique ou support de la photographiefileinfotpl_art_medium
{{Photograph}}dimensionsDimensions de la photographiefileinfotpl_art_dimensions
{{Photograph}}artistAuteur de la photographiefileinfotpl_aut"hProduct.fn value"
{{Photograph}}institutioninstitution détenant l’œuvre d'artfileinfotpl_art_gallery
{{Photograph}}locationEmplacement de la photographie au sein de l'institutionfileinfotpl_art_locationhProduct.locality
{{Photograph}}sourcesource du fichierfileinfotpl_src
{{Photograph}}permissionlicence/permission pour le fichier et l’œuvrefileinfotpl_perm
{{Photograph}}other versionsautres version du fichierfileinfotpl_ver
{{Photograph}}accession numbernuméro d'inventaire de la photographiehProduct.identifier

Format alternatif pour CommonsMetadata

Comme le format basé sur le tableau et l'identifiant s'est avéré difficile à ajouter aux modèles qui ne sont pas formatés de la même manière que modèle "information" de Commons, CommonsMetadata fournit un format alternatif, similaire à celui des bandeaux de licence : le modèle contenant les informations doit tout entier être compris dans une balise de la classe fileinfotpl et la balise contenant les informations spécifiques doit se trouver dans un élément de classe fileinfotpl_* (avec les mêmes noms que ci-dessus, mais en tant que classe et non en tant qu'id).

Données exploitables par des programmes ajoutées par des modèles de licences

Mis en place en octobre 2010, en utilisant les classes <span class="licensetpl_XXX">

licensetpl
un élément identifiant une licence. Intègre tout le code décrivant la licence et ne doit contenir qu'UNE SEULE licence, ne doit pas en contenir plusieurs.
licensetpl_short
nom abrégé de la licence : “Domaine public”, “CC-BY-SA-3.0”, “CC-by-2.0-FR”, etc.
licensetpl_long
nom complet de la licence : “Domaine public”, “Creative Commons Attribution-Share Alike 3.0”,
licensetpl_attr_req
si un crédit est nécessaire. Mettre “true” si le crédit est nécessaire ou “false” sinon.
licensetpl_attr
le crédit, si requis : texte libre.
licensetpl_link_req
si un lien vers la licence est nécessaire pour cette licence. Mettre “true” si le lien est nécessaire ou “false” sinon.
licensetpl_link
le lien vers le texte complet de la licence. “www.creativecommons.org/licenses/by-sa/XXX/YYY”
licensetpl_nonfree
“true“ s'il s'agit d'une licence non libre (non utilisé sur Commons, mais seulement sur des wikis ayant une politique de Doctrine d'Exemption (PDE))

Lorsqu'il y a plusieurs blocs licensetpl pour la même œuvre, il convient de les englober dans un bloc de niveau supérieur ayant pour classe : licensetpl_wrapper.

Modèles insérant ces informations

  • Templates setting licensetpl include:

{{PD-Layout}}, {{Cc-by-sa-3.0-migrated}}, {{Cc-by-layout}}, {{Cc-by-sa-layout}}, {{Cc-zero}}, {{FAL}}, {{GFDL}}, {{GFDL-1.2}}, {{GPL}} et {{LGPL}}.

Données exploitable par des programmes ajoutées par des modèles de mise en forme

Les modèles de mise en forme, prévus pour présenter de manière harmonisée différentes familles de bandeaux autres que des bandeaux de licences, véhiculent des données lisibles par des machines identifiant ces familles.

Modèle Objet Nom de la classe
{{Restriction-Layout}} utilisé par des avertissement concernant des restrictions d'usage restrictiontemplate
{{FoP-Layout}} utilisé par les bandeaux sur la liberté de panorama foptemplate
{{Partnership-Layout}} utilisé par les modèles de partenariat partnershiptemplate
{{Source-Layout}} utilisé par les modèles génériques décrivant la source d'une œuvre sourcetemplate
{{Created with}} utilisé par les modèles créé avec ... createdwithtemplate

Données exploitables par des programmes ajoutées par des modèles de restrictions d'usage non liées au droit d'auteur

Les modèles concernant les restrictions légales indépendantes des droits d'auteurs contiennent ces classes afin d'identifier des types de restrictions spécifiques.

Modèle(s) Objectif Nom de la classe
{{Trademarked}} Images en tant que marques déposées restriction-trademarked
{{Copydesign}} Représentation d'objet(s) dont le design est protégé par les droits d'auteur restriction-design
{{Communist symbol}} Symboles communistes restriction-communist
{{Italy-MiBAC-disclaimer}} {{Soprintendenza}} Biens culturels italiens restriction-ita-mibac
{{Australian Commonwealth reserve}} Réserves australiennes restriction-aus-reserve
{{Personality rights}} {{Romania personality rights}} Droits de la personnalité restriction-personality
{{2257}} Avertissement concernant la loi des États-Unis sur la protection des enfants et l'obscénité (Child Protection and Obscenity Enforcement Act) restriction-2257
{{Costume}} Costumes restriction-costume
{{Fan art}} Fan art restriction-fan-art
{{Currency}} Monnaie restriction-currency
{{IHL Symbol}} Symboles dont l'usage est restreint par le droit international humanitaire restriction-ihl
{{Nazi symbol}} Symboles nazis et fascistes restriction-nazi
{{Insignia}} Insigne officiel restriction-insignia

Données exploitables par des programmes ajoutées par des modèles spécifiques

D'autres données expoloitables par des programmes sont insérées. En voici une liste non exhaustive :

{{Personality rights}}
<span class="commons-template-name" style="display:none" id="commons-template-personality-rights">Personality rights</span>
{{Credit line}}
<td id="fileinfotpl_credit" class="fileinfo-paramfield fileinfotpl_credit" style=""></td>

Données exploitables par des programmes ajoutées par des modèles de localisation

Le modèle {{Location}} et les modèles similaires ajoutent des informations géographiques exploitables par des programmes au format suivant : <span class="geo">12.34;24.68</span> (latitude et longitude sous la forme de nombre à virgule flottante, séparés par un point-virgule). Les coordonnées utilisent le système WGS 84 (utilisé par le GPS et la plupart des cartes en ligne). Voir la page Commons:Géolocalisation pour plus de détails.

Utilisation

API de MediaWiki

L’API de MediaWiki renvoie actuellement une quantité limitée de métadonnées. Voyez la requête suivante :

(Ouvrir dans le bac-à-sable API) qui renvoie des informations comme Credit, Artist, LicenseUrl et Copyrighted et est utilisé par Media Viewer, notamment.

Scripts utilisant des données destinées aux programmes

Outils externes

Voir aussi

Comment définir de nouvelles données exploitables par des programmes

  • si possible, encadrez les données réelles, pas les en-têtes d'un champ. Cette méthode était utilisée historiquement dans tous les modèles Information, mais s'avère bien plus difficile à continuer à utiliser sur le long terme.
  • N'incluez que les données, pas les éléments de mise en forme de ces données.
  • Partez du principe que le formatage de données sera perdu lors de la conversion des données. L'habillage graphique ne fait pas partie des informations.
  • N'incluez pas plusieurs unités d'information dans un même champ de données. Il y a une différence entre une date de publication et une date de création. Les deux sont des dates, mais les deux sont des 'champs de données' différents. De même, CC-by-SA-4.0-3.0-2.5 n'est pas l'identifiant d'une licence, il y a en fait trois licences dont le nom commence par CC-by-SA-.
  • Assurez-vous que les valeurs des données ont une unité, ou qu'elles sont exprimées dans des unités cohérentes.
  • Don't wrap multiple units of information inside one field. There is a difference between a publication date and a creation date. Both are dates, but both are different 'data fields'. Also CC BY-SA-4.0-3.0-2.5 is not a license name, those would be 3 licenses with the name CC BY-SA-##.
  • Make sure that the data value has one unit, or outputs one consistent unit.

Problèmes

Il y a un petit nombre de choses qui ne sont PAS ou très difficilement reconnaissables. Cela comprend :

  • Derivative works
  • Works included in works. See also Category:FoP_templates
  • licenses derivates or works included in works are a mess.
  • Author vs. Copyright holder
  • usernames vs 'real names'
  • Catalogue IDs etc
  • VRTS permissions
  • Publication date vs creation date
Category:Commons help/fr
Category:Commons help/fr