Plantilla:Propiedad/doc
Esta plantilla sirve para mostrar datos de Wikidata en artículos y plantillas.
Uso[editar]
Uso básico[editar]
Los resultados de la plantilla dependerán del artículo donde se la utilice. Por ejemplo, si se utiliza en el artículo España, los resultados serán los siguientes:
{{Propiedad|P36}}→{{Propiedad|P36|enlace=no}}→{{Propiedad|P37}}→{{Propiedad|P37|uno=sí}}→
Parámetros[editar]
| Parámetro | Descripción |
|---|---|
|1=
|
Propiedad de Wikidata, por ejemplo P1082 |
|2=
|
Valor local que reemplaza al valor de Wikidata. Si se indica |prioridad=sí entonces el valor de Wikidata (de existir) tendrá precedencia por sobre el valor local. Sólo si la anulación está en blanco se recuperan los datos de Wikidata.
|
|separador=
|
Separador, por si la propiedad incluye múltiples valores. Por defecto cuando hay dos valores aparecerán separados por la conjunción «y» y cuando hay 3 o más valores por comas y el último valor por la conjunción «y». Para otros formatos (tablas listas etc.) es posible cambiar el separador. |
|módulo=
|
Módulo de formato, si se desea dar formato al valor de Wikidata con algún módulo que no forme parte de Módulo:Wikidata. |
|tipo de dato=
|
Nombre de la función para dar formato al valor, como imagen o enlace. Algunos tipos de datos:
Véase Módulo:Wikidata/Formatos para una lista más completa. |
|pie=
|
Texto al pie de imagen, en el caso de ser una imagen. |
|entidad=
|
ID del elemento, por ejemplo Q414, en caso de querer enlazar a otra entidad diferente de la página en la cual se usa. |
|calificativo=
|
Calificativo, o sub-propiedad de una propiedad dada, como el país al cual pertenece algún distribuidor. Esta opción muestra la propiedad seguido del calificador entre paréntesis. |
|calificador=
|
Calificador, o sub-propiedad de una propiedad dada, como el país al cual pertenece algún distribuidor. Esta opción muestra solamente el calificador. |
|filtro calificador=
|
Filtro por calificador, escrito de la forma calificador;valor1,valor2,... → P1234;Q234534,Q5345
|
|idioma=
|
Idioma, filtra por el idioma seleccionado en las propiedades dependientes del idioma. |
|conjunción=
|
La conjunción, si se trata de varios valores sin separador establecido. Por defecto es "y", por ejemplo "manzanas, peras y kiwis". |
|enlace=no
|
Si se desea quitar el enlace de alguna propiedad dada, úsese el valor no.
|
|uno=sí|uno=último
|
Para obtener solo el primer valor de una propiedad con múltiples valores, úsese el valor sí; para obtener el último valor, úsese último.
|
|parámetros adicionales=
|
Para agregar parámetros específicos de las funciones (abajo se muestra una serie de ejemplos) |
Ejemplos[editar]
Imágenes[editar]
Una imagen se puede obtener y formatear de diferentes maneras:
| Código | Resultado |
|---|---|
Miniatura (thumb):
{{Propiedad|PXXX|tipo de dato=imagen|6=Nueva Zelanda en su región.}}
Wikitexto equivalente: [[Archivo:New Zealand in its region.svg|miniaturadeimagen|250px|Nueva Zelanda en su región.]] |
 |
Imagen básica:
{{Propiedad|PXXX|tipo de dato=imagen|formato imagen=sinmarco|6=Escudo de armas}}
Wikitexto equivalente: [[Archivo:Coat of arms of New Zealand.svg]] Escudo de armas |
 Escudo de armas |
Listas[editar]
Con propiedades con más de un valor, es útil ordenarlas en una lista.
| Código | Resultado |
|---|---|
{{Propiedad|PXXX}}
|
|
{{Propiedad|PXXX|separador=<br>}}
|
|
{{Propiedad|PXXX|lista=no ordenada}}
|
|
{{Propiedad|PXXX|lista=ordenada}}
|
Banderas[editar]
Con el parámetro |tipo de dato=bandera se coloca una bandera junto al valor, siempre que sea una localidad válida:
{{Propiedad|PXXX|tipo de dato=bandera}}→
Fechas[editar]
Con el parámetro |formato fecha= se puede dar formato a las fechas y obtener solo ciertas partes de las fechas:
{{Propiedad|PXXX}}→{{Propiedad|PXXX|formato fecha=año}}→
Coordenadas[editar]
Es posible importar las coordenadas geográficas correspondientes al artículo de dos formas:
- Latitud y longitud con grados con decimales (dec) y sin formato:
{{Propiedad|latitud}}→ 41.651980555556{{Propiedad|longitud}}→ -4.7285611111111
- Las coordenadas incluidas en la plantilla
{{coord}}(por defecto|tipo=city,|display=inliney|formato=dms):{{Propiedad|P625}}→ Error de Lua: callParserFunction: function "#coordinates" was not found.{{Propiedad|P625|tipo=landmark|display=inline|formato=dec}}→ Error de Lua: callParserFunction: function "#coordinates" was not found.
Las coordenadas se pueden utilizar en otras plantillas, como la plantilla {{Mapa de localización}}:
{{Mapa de localización
|España
|lat_gra = {{Propiedad|latitud}}
|lat_gra = {{Propiedad|longitud}}
|etiqueta = Madrid
}}
|
→ | Plantilla:Mapa de localización |
Obras de una serie literaria[editar]
{{Propiedad
|P527
|entidad = Q3008321
|tipo de dato = formatoObraAnyo
|separador = <br>
}}
|
→ |
Uso avanzado[editar]
Parámetro prioridad[editar]
Cuando se usa esta plantilla en otra, por ejemplo en una ficha, no es necesario usar operadores {{#if: para regular la prioridad de los datos ya que en el parámetro 2 de esta plantilla se puede poner un valor o parámetro que si existe, anula el valor de Wikidata.
Por ejemplo, {{Propiedad|P17| {{{país|}}} }} devolvería el valor dado al parámetro |país= y si no se da un valor al parámetro devolvería el valor de la propiedad P17 de Wikidata, de forma que no haría falta poner {{#if: {{{país|}}} | {{{país}}} | {{Propiedad|P17}} }} o {{país| {{Propiedad|P17|}} }}.
También es posible dar prioridad a los valores de Wikidata usando el parámetro |prioridad=sí. Por ejemplo, {{Propiedad|P17| {{{país|}}} |prioridad=sí}} devolvería el valor de la propiedad P17 en Wikidata y solo devolvería el valor del parámetro |país= si la propiedad en Wikidata no está dada, de forma que no haría falta poner {{#if: {{Propiedad|P17}} | {{Propiedad|P17}} | {{{país|}}} }}, lo cual además ahorra un llamado a Wikidata.
Obtener el identificador de los valores[editar]
Se puede obtener el identificador de un valor en lugar de su etiqueta. Esto es útil si se quieren consultar los tipos de alguna obra.
Por ejemplo, en el artículo España y considerando que P36 es la propiedad «capital», es decir Madrid, cuyo identificador es Q2807, entonces:
{{Propiedad|P36|tipo de dato=formatoId}}→
Categorización en caso de error[editar]
Se puede usar un parámetro (o parámetros) para comprobar si los datos que figuran en Wikidata son los mismos que la anulación o si los datos faltan en Wikidata. Esto se puede utilizar como servicio de alerta (por ejemplo, mediante el uso de las categorías ocultas):
- Verificar que los datos de Wikidata son lo mismo que la anulación → Categoría:Paramétro que anula Wikidata imnecesario
- Comprobar los datos que faltan en Wikidata → Categoría:Valor perdido en Wikidata
- Comprobar si los datos en Wikidata son diferentes que la anulación → Categoría:Comprobar inconsistencia en Wikidata.
Forzar una entidad[editar]
A veces puede ser útil forzar el uso de un identificador de entidad de Wikidata para artículos de obras con múltiples iteraciones (como series con distintas temporadas) y se desea obtener valores de Wikidata sólo para cada iteración (es decir, artículos con fichas en el que se puede usar una misma plantilla varias veces, una por cada iteración). Al momento, no se ha implementado un parámetro para forzarlo, por lo que la solución es preguntar si se ha establecido una entidad, de lo contrario, devolver el valor establecido localmente. Esto, para evitar que la ficha devuelva los valores de la entidad asociada al artículo principal si no se especifica la entidad (lo que es indeseable en algunos casos). A continuación la sintaxis:
{{#if: {{{entidad|}}}
| {{Propiedad|PXXX|{{{parámetro|}}}|entidad={{{entidad}}}}} <!-- Se obtiene la propiedad desde Wikidata o el valor local -->
| {{{parámetro}}} <!-- Solo se establece el valor local -->
}}
Cálculos matemáticos[editar]
Esta plantilla tiene un comportamiento extraño cuando se la utiliza en cálculos matemáticos (usando #expr, #ifexpr o invocando algún módulo) que limita su uso, pero no lo impide. Aunque devuelva un valor numérico en formato compatible, genera un mensaje de error si se especifica el parámetro |2= y éste no es específicamente un número.
No funciona: {{#expr: ( {{{población}}} / {{Propiedad|P2046|{{{superficie}}} ) }}
Forma correcta: {{#expr: ( {{{población}}} / {{{superficie|{{Propiedad|P2046}}}}} ) }}- No funciona:
{{#expr: ( {{{población}}} / {{Propiedad|P2046|{{{superficie}}}|prioridad=si}} ) }} - Forma correcta:
{{#expr: ( {{{población}}} / {{Propiedad|P2046|{{{superficie}}}|prioridad=si|categorías=no}} ) }}
En el caso de que la propiedad en cuestión tenga una unidad definida en Wikidata (metros, minutos,...) y se quiera utilizar en cálculos matemáticos también se requerirá el uso del parámetro formato unidad=número, de forma que los ejemplos anteriores quedarían de la siguiente manera:
- Forma correcta:
{{#expr: ( {{{población}}} / {{{superficie|{{Propiedad|P2046|formato unidad=número}}}}} ) }} - Forma correcta:
{{#expr: ( {{{población}}} / {{Propiedad|P2046|{{{superficie}}}|prioridad=si|categorías=no|formato unidad=número}} ) }}
Véase también[editar]
- Plantilla:Wikibase. Para capturar un enlace, nombre de página o id.
- Módulo:Wikidata. Módulo Lua que usa esta plantilla
- Módulo:Wikibase. Otro módulo Lua más básico para enlazar datos de Wikidata.
TemplateData[editar]
Esta es la documentación de la plantilla, generada mediante TemplateData, que es utilizada también para su inserción y modificación en el editor visual.
TemplateData para Propiedad
Esta plantilla permite obtener valores de una propiedad de Wikidata.
| Parámetro | Descripción | Tipo | Estado | |
|---|---|---|---|---|
| Propiedad de Wikidata | 1 | La propiedad a enlazar. | Cadena | obligatorio |
| Anular | 2 | Valor para sobreescribir la propiedad con algún valor/variable local. | Cadena | opcional |
| Separador | 3 | Separador de valores. | Cadena | opcional |
| Módulo | 4 | Nombre del módulo a llamar | Cadena | opcional |
| Función | 5 | Función del módulo a usar. | Cadena | opcional |
| Leyenda de imagen | 6 | Un texto de pie de imagen opcional. | Cadena | opcional |
| Entidad de Wikidata | entidad | Un identificador de ítem de Wikidata, si se quiere enlazar a un ítem diferente del asociado a la página usada. | Cadena | opcional |
| Calificador | calificador | El calificador (o subpropiedad) a obtener. Esta opción muestra solamente el calificador. | Cadena | opcional |
| Filtro por calificador | filtro calificador | Calificador y valores del mismo por los que filtrar los valores obtenidos de la propiedad, | Cadena | opcional |
| Calificativo | calificativo | El calificador (o subpropiedad) a obtener. Esta opción muestra la propiedad seguido del calificador entre paréntesis. | Cadena | opcional |
| Idioma de la propiedad | idioma | Filtra por el idioma seleccionado en las propiedades dependientes del idioma. | Cadena | opcional |
| Conjunción | conjunción | La conjunción, si se trata de varios valores sin separador establecido. Por defecto es «y», por ejemplo «manzanas, peras y kiwis». | Cadena | opcional |
| Obtener enlace o no | enlace | Establece si se desea o no establecer el enlace. Úsese el valor «no» | Cadena | opcional |
| Obtener solo un valor de la lista | uno | Establece si se quiere obtener solo un valor de la lista. Valores posible son «sí» (primer valor de la lista) y «último» (último valor de la lista) | Cadena | opcional |
