Commons:Machine-readable data/es

Shortcut: COM:MRD

On Wikimedia Commons, a lot of metadata (including license and author) are not machine readable. There is an API module, iiprop=extmetadata which can be used to retrieve some values (example), but as the information is entered as free text into the file description page itself, this is not perfect. The ongoing Structured data on Commons project aims to move the metadata as fully-structured data and will eventually supersede the machine-readable data presented in this page.

In the meantime, and to ease a transition towards more structured data at a future time, Wikimedia Commons use a set of standard templates which have been made machine-readable in some ways, through HTML elements. Some scripts already make use of that. It is worth noting that this data is available for any wiki using Wikimedia Commons, where it can be read from the html of the File: page just as other local data.

Máquina de datos legibles

Datos de lectura mecánica establecido por Ficha de plantillas

Estos son estándar y varias ficha de plantillas etiquetada en distintos elementos de plantilla con diversas etiquetas para permitir el análisis sintáctico de la información. Se utilizan varios estilos diferentes de etiquetas:

  • Microformatos las etiquetas siguen estándares de la industria y se pueden analizar por herramientas ya existentes
  • <td> atributos id (identificadores) son marcas personalizadas que permiten etiquetas más completas, cuando tienen que ser leídas por las herramientas personalizadas. Muchos de la mayoría de los infoboxes universales tienen dos columnas estructura: Columna #1 tiene el nombre del campo y la columna #2 contiene el valor
    • Tradicionalmente <td> los atributos id se utilizaron para etiquetar la llamada del nombre de la primera columna en una fila. Para obtener los datos, usted tendría la siguiente <td> célula en la segunda columna.
    • {{Creator}} and {{Institution}} templates have more complicated structure, so the cells with the actual data are tagged with attributes using magenta background.
Plantilla Nombre del parámetro de la plantilla Descripción <td> id atributo Microformato Comentario
{{Information}}descriptionDescripción del archivofileinfotpl_deschProduct.description.Often contains multiple languages annotated with {{Lang}}.
{{Information}}datefecha original de creación de la obrafileinfotpl_datehCalendar vevent.dtstartmicroformato añadido por la plantilla {{Date}}
{{Information}}sourcefuente del archivofileinfotpl_srcOften contains entire tables. We have no good way to deal with this source templates yet. Source templates often have references to catalogue IDs, but these are also not machine readable.
{{Information}}authorautor del archivofileinfotpl_autThis can be author, creator and/or copyright holder and is used mixed. Often contains the {{Creator}} template which is described below.
{{Information}}permissionpermiso/licencia para el archivofileinfotpl_perm
{{Information}}other versionsotras versiones del archivofileinfotpl_ver
{{Artwork}}descriptiondescripción de la obra de artefileinfotpl_deschProduct.description
{{Artwork}}datefecha original de creación de la obra de artefileinfotpl_datehCalendar vevent.dtstartmicroformat added by {{Date}} template
{{Artwork}}sourcefuente del archivofileinfotpl_src
{{Artwork}}artistcreador de la obra de artefileinfotpl_aut"hProduct.fn value"
{{Artwork}}authorautor de la obra de artefileinfotpl_aut"hProduct.fn value"
{{Artwork}}permissionpermiso/licencia para el archivo y la obra de artefileinfotpl_perm
{{Artwork}}other versionsotras versiones del archivofileinfotpl_ver
{{Artwork}}titletítulo de la obra de artefileinfotpl_art_titlehProduct.fn
{{Artwork}}object typetipo de objeto de la obra de artefileinfotpl_art_object_type
{{Artwork}}mediumtécnica o medio de la obra de artefileinfotpl_art_medium
{{Artwork}}dimensionsdimensiones de la obra de artefileinfotpl_art_dimensions
{{Artwork}}galleryinstitución que hospeda la obra de artefileinfotpl_art_gallery
{{Artwork}}locationubicación de la obra de arte dentro de la instituciónfileinfotpl_art_locationhProduct.locality
{{Artwork}}accession numbernúmero de accesión de la obra de artefileinfotpl_art_idhProduct.identifier
{{Artwork}}object historyobjeto histórico de la obra de artefileinfotpl_art_object_history
{{Artwork}}exhibition historyhistorial de exhibición de la obra de artefileinfotpl_art_exhibition_history
{{Artwork}}credit linelínea de crédito de la obra de artefileinfotpl_art_credit_line
{{Artwork}}inscriptionsinscripciones de la obra de artefileinfotpl_art_inscriptions
{{Artwork}}notesnotas acerca de la obra de artefileinfotpl_art_notes
{{Artwork}}referencesreferencias relacionadas a la obra de artefileinfotpl_art_references
{{Book}}Authorautor del librofileinfotpl_author
{{Book}}Editoreditor del librofileinfotpl_book_editor
{{Book}}Translatortraductor del librofileinfotpl_book_translator
{{Book}}Illustratorilustrador del librofileinfotpl_book_illustrator
{{Book}}Titletítulo del librofileinfotpl_book_title
{{Book}}Subtitlesubtítulo del librofileinfotpl_book_subtitle
{{Book}}Series titletítulo de la serie del librofileinfotpl_book_series-title
{{Book}}Authority filedato del control de autoridadfileinfotpl_book_authority
{{Book}}Publishereditor del librofileinfotpl_book_publisher
{{Book}}Printerilustrador del librofileinfotpl_book_printer
{{Book}}Year of publicationfecha o año de la plublicación del librofileinfotpl_date
{{Book}}Place of publicationsitio o ciudad de la publicación del librofileinfotpl_book_place-of-publication
{{Book}}Languageidioma del librofileinfotpl_book_language
{{Book}}Descriptiondescripción del librofileinfotpl_desc
{{Creator}}NameNombre del creadorcreatorvCard.fn
{{Creator}}Alternative namesNombres alternativos del creadorfileinfotpl_creator_alt-name_valuevCard.nickname
{{Creator}}DescriptionNacionalidad y ocupación(es) del creadorfileinfotpl_creator_desc_valuevCard.note
{{Creator}}Date of deathFecha de muerte del creadorfileinfotpl_creator_deathdate_value
{{Creator}}Date of birthFecha de nacimiento del creadorfileinfotpl_creator_birthdate_valuevCard.bday
{{Creator}}Location of birth/deathLugar de muerte del creadorfileinfotpl_creator_deathloc_value
{{Creator}}Location of birthLugar de nacimiento del creadorfileinfotpl_creator_birthloc_value
{{Creator}}Work periodPeriodo de trabajo del creadorfileinfotpl_creator_work-period_value
{{Creator}}Work locationLugar de trabajo del creadorfileinfotpl_creator_work-location_valuev
{{Creator}}Imageel retrato o foto que muestra al creadorfileinfotpl_creator_image
{{Creator}}Authority fileControl de autoridad relacionado con el creadorfileinfotpl_creator_authority_value


{{FileContentsByBot}}(varios)depende, por favor leer {{FileContentsByBot}}(various)hproduct-by-botel conjunto de datos es grande y sigue creciendo, por favor leer {{FileContentsByBot}}
{{Photograph}}titletítulo de la fotografíafileinfotpl_art_titlehProduct.fn
{{Photograph}}descriptiondescripción de la fotografíafileinfotpl_deschProduct.description
{{Photograph}}original descriptiondescripción original archivado de la fotografíafileinfotpl_deschProduct.description
{{Photograph}}datefecha de creación original de la obra de artefileinfotpl_datehCalendar vevent.dtstartmicroformat added by {{Date}} template
{{Photograph}}mediumtécnica o medio de la fotografíafileinfotpl_art_medium
{{Photograph}}dimensionsdimensiones de la fotografíafileinfotpl_art_dimensions
{{Photograph}}artistcreador de la fotografíafileinfotpl_aut"hProduct.fn value"
{{Photograph}}institutioninstitución que aloja la obra de artefileinfotpl_art_gallery
{{Photograph}}locationubicación de la fotografía dentro de la instituciónfileinfotpl_art_locationhProduct.locality
{{Photograph}}sourcefuente del archivofileinfotpl_src
{{Photograph}}permissionpermiso/licencia para el archivo y la obra de artefileinfotpl_perm
{{Photograph}}other versionsotras versiones del archivofileinfotpl_ver
{{Photograph}}accession numbernúmero de accesión de la fotografíahProduct.identifier

Formato alternativo para CommonsMetadata

Because the table + id based format proved very hard to add to templates which were not formatted similarly to the Commons information template, CommonsMetadata allows an alternative format, similar to license templates: the whole information template has to be enclosed in a fileinfotpl class and the tag containing the specific information needs to have a fileinfotpl_* class (same names as above, but class, not id).

Machine readable data set by license templates

Introduced in October 2010, using classes <span class="licensetpl_XXX">

licensetpl
An element identifying a license. Wraps the entire license code and should be a SINGLE license, not a multi license.
licensetpl_short
Short name of the license: “Public domain”, “CC BY-SA 3.0”, “CC by 2.0 fr”, etc.
licensetpl_long
Long name of the license: “Public domain”, “Creative Commons Attribution-Share Alike 3.0”,
licensetpl_attr_req
Whether attribution is required. “true” or “false”.
licensetpl_attr
The requested attribution: Free text.
licensetpl_link_req
Whether a link to the license is required for this license. “true” or “false”.
licensetpl_link
The link to the license deed. “www.creativecommons.org/licenses/by-sa/XXX/YYY”
licensetpl_nonfree
“true“ if this is a non-free license (not used on Commons, only on wikis with an EDP)

Multiple licensetpl blocks for the same work might be wrapped in a block using the class licensetpl_wrapper.

Templates setting this information

  • 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}} y {{LGPL}}.

Machine readable data set by style formatting templates

Style formatting templates, meant to provide uniform styles to different families of non-license templates, carry machine readable data identifying these families.

Plantilla Propósito nombre de la clase
{{Restriction-Layout}} usado por etiquetas de Restricción restrictiontemplate
{{FoP-Layout}} usado por etiquetas de libertad de panorama foptemplate
{{Partnership-Layout}} usado por plantillas de Sociedades partnershiptemplate
{{Source-Layout}} usado por plantillas Fuentes genéricas sourcetemplate
{{Created with}} usado por Creado por ... plantillas createdwithtemplate

Templates regarding non-copyright legal restrictions carry these classes to identify specific types of restrictions.

Plantilla(s) Propósito nombre de clase
{{Trademarked}} Trademarked images restriction-trademarked
{{Copydesign}} Copyrighted designs restriction-design
{{Communist symbol}} Símbolos comunistas restriction-communist
{{Italy-MiBAC-disclaimer}} {{Soprintendenza}} Bienes culturales italianos restriction-ita-mibac
{{Australian Commonwealth reserve}} Reservas australianas restriction-aus-reserve
{{Personality rights}} {{Romania personality rights}} Derechos de personalidad restriction-personality
{{2257}} Child Protection and Obscenity Enforcement Act warning (United States) restriction-2257
{{Costume}} Personalizando restriction-costume
{{Fan art}} Seguidor del arte restriction-fan-art
{{Currency}} Currency restriction-currency
{{IHL Symbol}} Symbols restricted by International Humanitarian Law restriction-ihl
{{Nazi symbol}} Símbolos nazis y fascistas restriction-nazi
{{Insignia}} Insignia Oficial restriction-insignia

Machine readable data set by specific templates

More machine-readable data are set. Here is a non-exhaustive list:

{{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>

Machine-readable data set by location templates

{{Location}} and similar templates add machine-readable geocodes in the following format: <span class="geo">12.34;24.68</span> (latitude and longitude as floating-point numbers, separated by a semicolon). The coordinates use the en:WGS84 system (same as the GPS and most online maps). See Commons:Geocoding for more details.

Uso

API de MediaWiki

The MediaWiki API now serves a limited number of metadata. Consider the following query:

(Open in API Sandbox) that returns some useful parameters such as Credit, Artist, LicenseUrl and Copyrighted and is used by Media Viewer, for example.

Scripts using machine-readable data

Herramientas externas

== Véase también

Definiendo nueva máquina de datos legibles

  • Do NOT use HTML id's, use classes. An ID can only be used once per page and most of these fields can occur multiple times per page. Consider for instance descriptions of derivative works, which can include information about the original and the derivative.
  • When possible, wrap the actual data, not some field header. This last method is historically used for all our Information templates, but much harder to support in the long run.
  • Wrap data, not the way the data is formatted.
  • Expect that formatting is lost when converting to data. Visual dress up is not part of the information.
  • 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.

Problemas

There are a few things that are currently NOT or badly recognizable. These include:

  • 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/es
Category:Commons help/es