VOOZH about

URL: https://www.mediawiki.org/wiki/Extension:CommonsMetadata/fr

⇱ Extension:CommonsMetadata - MediaWiki


Jump to content
From mediawiki.org
This page is a translated version of the page Extension:CommonsMetadata and the translation is 12% complete.
Manuel des extensions MediaWiki
👁 Image
CommonsMetadata
État de la version : stable
Implémentation API
Description Tentatives d'extraction de métadonnées à partir de pages communes
Auteur(s) Brian Wolff (bawolffdiscussion)
Politique de compatibilité Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière.
MediaWiki 1.25+
PHP 5.4+
Modifie la base
de données
Non
  • $wgCommonsMetadataForceRecalculate
  • $wgCommonsMetadataPublicDomainPageUrl
  • $wgCommonsMetadataSetTrackingCategories
Licence Licence publique générale GNU v2.0 ou ultérieur
Téléchargement
Traduire l’extension CommonsMetadata sur translatewiki.net si elle y est disponible
Problèmes Tâches ouvertes · Signaler un bogue

L'extension CommonsMetadata est une tentative d'extraction de métadonnées à partir des pages Wikimedia Commons, mais est également disponible dans tous les autres projets Wikimedia. It adds some extra information to the imageinfo API, based on templates and categories in the image description. It is used by several extensions/tools (such as Extension:MultimediaViewer, Extension:VisualEditor, Extension:MobileFrontend, Mobile-Content-Service (MCS)) to provide better lightboxes or image selection dialogs.

The extension in its current form is intended to be a temporary solution, eventually replaced by Wikidata on Commons.

Installation

  • Téléchargez et placez le(s) fichier(s) dans un répertoire appelé CommonsMetadata dans votre dossier extensions/.
    Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:
    cdextensions/
    gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/CommonsMetadata
    
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
    wfLoadExtension( 'CommonsMetadata' );
    
  • 👁 Yes
    Fait
    – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Motivation & design choices

Voir mailarchive:wikitech-l/2013-August/071593.html

The assumptions of this extension are the following.

  • At some point in the future, Wikidata will take over handling metadata at Commons. To avoid disruptive changes, which will soon need to be changed again, the extension should work with common metadata as it currently is (so not introducing new parser functions). Hence, screen scraping.
  • The content of many of the fields on a Commons description page includes rich formatting (In particular: Links, italics, bold. In some cases, more complex things like embedded images).
    • As a result, the extension outputs parsed html (wikitext sucks, plain text doesn't capture the data).
    • Furthermore, the data tends to be formatted for human display rather than (for example) machine-formatted dates. When the date field says something like "circa 1600s", it's hard to convert that to a precise date (many examples can be).
    • To carry that forward, also apply formatting to EXIF metadata, which is controlled on the wiki (For example, Commons links the camera name to a Wikipedia article).
  • If we can't extract info from the description page, but the file has the author tagged in EXIF/XMP/iptc metadata, we should use that as a fallback.
  • Ideally, such a system would be as Commons-specific as possible, with the Commons and non-Commons parts separated.
  • Commons description pages have multilingual descriptions. Lots of users probably want one language.
    • This implementation applies per language conventions to dates and things. Additionally, for explicitly multi-lingual fields (description), there is an option to return all or just a single language. Even in single language mode, some things are still language-specific (like the thousands separator on numbers).

Configuration

parameter default description
$wgCommonsMetadataSetTrackingCategories false Add the following tracking categories to file pages when the corresponding information is not provided either via templates on the file page of (for some of these) EXIF metadata:
  • Files with no machine-readable license (commonsmetadata-trackingcategory-no-license)
  • Files with no machine-readable description (commonsmetadata-trackingcategory-no-description)
  • Files with no machine-readable author (commonsmetadata-trackingcategory-no-author)
  • Files with no machine-readable source (commonsmetadata-trackingcategory-no-source)
  • Files with no machine-readable patent (commonsmetadata-trackingcategory-no-patent) (for 3D files)
$wgCommonsMetadataPublicDomainPageUrl https://commons.wikimedia.org/wiki/Help:Public_domain Link used for 'license' attribute in schema.org markup for files in the public domain.
$wgCommonsMetadataForceRecalculate false Force calculation of metadata even when the image is from a foreign repository that would provide it. This is meant for local development.

Testing

👁 Avertissement
Avertissement :
If you're developing or testing this extension, we do NOT suggest you copy the Commons templates for image metadata, as they take extremely long to compile and have complicated dependencies like Scribunto. Instead, get an expanded version with only wikitext/HTML and manually put in the various parameter references (or don't). You can find an example (to be used with "Special:Import") here. Or use Vagrant which includes certain templates by default.

Lors du test avec des images distantes (par exemple des images Commons si vous avez activé $wgUseInstantCommons), vous pouvez définir $wgCommonsMetadataForceRecalculate = true; pour forcer CommonsMetadata à analyser la page de description de l'image et à extraire les métadonnées (normalement, si le référentiel distant avait également CommonsMetadata installé, il copierait simplement la sortie de l'API à partir de là).

Utilisation

Use the imageinfo API, and include extmetadata as an image info property specified via iiprop.

Example

https://commons.wikimedia.org/w/api.php?action=query&prop=imageinfo&format=json&iiprop=extmetadata&iilimit=10&titles=File%3ACommon%20Kingfisher%20Alcedo%20atthis.jpg

View this example in the API sandbox:

https://www.mediawiki.org/wiki/Special:ApiSandbox#action=query&prop=imageinfo&format=json&iiprop=extmetadata&iilimit=10&titles=File%3ACommon%20Kingfisher%20Alcedo%20atthis.jpg

Données renvoyées

The extension currently provides the following items in the extmetadata field of the response (the field names were chosen, where possible, to follow the IPTC-IIM format used in EXIF headers):

  • ImageDescriptionimage description
  • Artistauthor name (might contain complex HTML, multiple authors, etc)
  • Creditsource
  • DateTimeOriginaltime of creation (space-separated ISO 8601 timestamp whenever possible, but can be any other textual description of a date, possibly with HTML mixed in)
  • ObjectNametitle (for a book/painting; otherwise just the file name)
  • Permissioncontents of the Permission field of the template. It can be a lot of things (license template, OTRS ID, details on how to attribute...)
  • AuthorCountthe number of templates with authors (e.g., Book, Photograph...). The number of actual authors might be higher if a template describes multiple authors in a single string.
  • GPSLatitudelatitude
  • GPSLongitudelongitude
  • GPSMapDatumcoordinate type (only WGS-84 supported for now)
  • LicenseShortNameshort human-readable license name
  • LicenseUrl
  • UsageTerms
  • CopyrightedTrue or False (for public domain images)

For multi-licensed images, these values are currently unreliable.

  • Attributioncustom attribution that should replace Artist + Credit (can also originate from the Information template)
  • AttributionRequiredbooleanish (phab:T86726), tells whether there is a legal requirement to attribute
  • NonFreebooleanish, true means the image is not under a free license. (Used for non-Commons images only.)

Other data:

  • CommonsMedadataExtensioncontains the metadata parser version number; mostly for internal use
  • Licensea best guess at the license of the image (mostly for internal use by MediaViewer, might change; LicenseShortName is probably more reliable)
  • Categoriesa |-separated list of the categories of the image.
  • Assessmentsa |-separated list of the assessments of the image (currently five values are supported: poty, potd, featured, quality, valued). Based on parsing category names, probably won't work for images not hosted on Commons.
  • Restrictionsreuse restrictions such as trademarks or personality rights; an array of keywords (the class names from this table, without the restriction- prefix). See also the restrict-* icons in MediaViewer.
  • DeletionReasonif set, the template is being considered for deletion. (Based on the nuke template, probably not reliable outside Commons.) It contains a deletion reason, but it is phrased to be applicable for a log entry, so it might be misleading (e.g. past tense when actually it is not yet decided whether the image will be deleted).

Voir aussi

👁 Image
Cette extension est utilisée par au moins un des projets Wikimédia. Cela signifie probablement que l’extension est assez stable et fonctionnelle pour être utilisée sur des sites à fort trafic. Recherchez le nom de cette extension dans le CommonSettings.php de Wikimédia et dans le fichier de configuration InitialiseSettings.php pour situer les endroits où elle est installée. Une liste complète des extensions installées sur un Wiki donné peut être visualisée sur la page Special:Version de ce wiki.
👁 Image
Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets :