Plantilla:Propiedad/doc

De Wikiviajes, la guía libre de viajes

Esta plantilla pretende ser una sencilla forma de enlazar las propiedades de Wikidata en artículos y plantillas. Devuelve los datos de Wikidata con los enlaces internos en los valores que procede. También permite dar la posibilidad cuando se usa dentro de otras plantillas de establecer en esta un parámetro que anule el dato de Wikidata si ese parámetro tiene un valor.

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.

Parámetros[editar]

{{Propiedad|1=<propiedad>[|2=<anular>|3=<separador>|4=<módulo de formato>|5=<función del módulo>|6=<leyenda de imagen>| entidad = <id entidad>| enlace = <no> | prioridad = <sí> | categorías = <no> | uno = <sí>| rango mayor = <sí>| <parámetros adicionales> [|...] ]}}
Parámetro Descripción
|1= Propiedad de Wikidata
|2= Anular un valor local que reemplaza al valor presente en Wikidata. Si se indica prioridad = sí , el valor de Wikidata (de existir) tendrá precedencia por sobre el valor local.Plantilla:Refn
|3=

|separador=

Separador, por si la propiedad incluye múltiples valores.
|4=

|módulo=

Módulo de formato, si se desea establecer algún módulo que no forme parte de Módulo:Wikidata
|5=

|tipo de dato=

Nombre de la función para formatear el valor, como imagen o enlace.Plantilla:Refn

Véase Módulo:Wikidata/Formatos para una lista más completa.

|6= Leyenda de imagen, en el caso de ser una imagen.
|entidad= Id del elemento (ej. Q12), 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.Plantilla:Refn
|calificador= Calificador, o sub-propiedad de una propiedad dada, como el país al cual pertenece algún distribuidor.Plantilla:Refn
|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 ; 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)

Uso[editar]

Uso básico[editar]

A continuación se ha simulado resultados de esta plantilla en el artículo España.

  • {{Propiedad|p37|enlace=no}} → español, gallego, euskera, catalán y occitano
  • {{Propiedad|p31}} → estado soberano, reino, país, país mediterráneo y país de la OCDE
  • {{Propiedad|p37}} → español, gallego, euskera, catalán y occitano
Obsérvese que si no coincide la etiqueta del ítem de Wikidata con el enlace o interwiki vinculado a la Wikipedia en español se devuelve el enlace así:[[idioma español|español]].

Esto es lo que pasa usando directamente {{#property:}}

Formatear imagen[editar]

Una imagen puede ser obtenida y formateada de diferentes maneras

Código Resultado
Formatea una imagen con marco (thumb):
{{Propiedad|1=PXXXX|tipo de dato=imagen|6=Test}}
Wikitexto equivalente:
[[Archivo:LocationNewZealand.png|thumb|250px|Test]]
Test
Formatea una imagen sin marco
{{Propiedad|1=PXXXX|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

Separador[editar]

Con propiedades con más de un valor, es útil ordenarlas en una lista

Código Resultado
Lista sin separador establecido (por defecto «,»)
{{Propiedad|1=PXXXX}}
Estado soberano, Monarquía en la Mancomunidad de Naciones, país
Separados por un salto de línea (|1=<br> )
{{Propiedad|1=PXXXX|3=<br>}}
Estado soberano

Monarquía en la Mancomunidad de Naciones
país

Lista no ordenada (|lista=no ordenada ó |3=*)
{{Propiedad|PXXXX|lista=no ordenada}}
{{Propiedad|1=PXXXX|3=*}}
Lista ordenada (|lista=ordenada ó |3=#)
{{Propiedad|PXXXX|lista=ordenada}}
{{Propiedad|1=PXXXX|3=#}}
  1. Estado soberano
  2. Monarquía en la Mancomunidad de Naciones
  3. país
Dentro de una tabla
 {| class="wikitable"
   | {{Propiedad|1=PXXXX|3=</td></tr><tr><td>}}
 |}
Se podrían poner los valores en columnas diferentes con el separador: </td><td>
Estado soberano
Monarquía en la Mancomunidad de Naciones
país

Bandera[editar]

Permite colocar una bandera al costado del valor, siempre que sea una localidad válida. Use el parámetro |tipo de dato=bandera

Código Resultados
{{Propiedad|PXXXX|tipo de dato=bandera|}}

Fechas[editar]

Plantilla:Véase también También es posible formatear fechas y obtener solo ciertas parte de una cadena de fecha. Use el parámetro |formato fecha=

Coordenadas[editar]

Con la plantilla propiedad 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}}.
  • {{Propiedad|p625}}Plantilla:Coord - (Por defecto tipo= city, display = inline,title y formato = dms)
  • {{Propiedad|p625|tipo=landmark|display=inline|formato=dec}}Plantilla:Coord

Los datos que la plantilla importa pueden ser usadas por otras plantillas como la plantilla {{Mapa de localización}}.

Código Resultado
{{Mapa de localización
|1=España
|label=Valladolid
|lat={{Propiedad|latitud}}
|long={{Propiedad|longitud}}
|float = none 
}}
Valladolid
Valladolid
Valladolid (España)
{{mapa de localización
|1=Valladolid
|label=Valladolid
|lat={{Propiedad|latitud}}
|long={{Propiedad|longitud}}
|float = none 
}}

Mapa de localización no disponible en Wikiviajes. Consulte la documentación de la plantilla.

Obras de una serie literaria[editar]

Código Resultado
{{propiedad
  |PXXXX
  |entidad=QXXXXXXXX
  |lista=no ordenada
  |enlace=sí
  |tipo de dato=formatoObraAnyo
}}

Plantilla:Ayuda propiedad

Prioridad[editar]

Prioridad valor dado en la Wikipedia local[editar]

Cuando se usa esta plantilla en otra, por ejemplo en una ficha, no es necesario el usar operadores {{if:|... para regular la prioridad de los datos ya que en el parámetro 2 se puede poner un valor o parámetro que de darse se anularía el valor de Wikidata.

Ejemplo

{{Propiedad|p17| {{{país|}}} }}. esto devolvería el valor dado al parámetro | país = y si no se da el valor al parámetro devolvería el valor de la propiedad p17 en el ítem de Wikidata de forma que no haría falta poner: {{#if: {{{país|}}} | {{{país}}} | {{Propiedad|p17}} }}.

Prioridad valor de Wikidata[editar]

También es posible darle prioridad al valor de la propiedad del ítem de Wikidata usando el parámetro |prioridad = sí.

Ejemplo

{{Propiedad|p17| {{{país|}}} | prioridad = sí }}. esto devolvería el valor dado en la propiedad p17 en el ítem de Wikidata y si esa propiedad no esta dada devolvería el valor dado en el parámetro país = de forma que no haría falta poner: {{#if: {{Propiedad|p17}} | {{Propiedad|p17}} | {{{país}}} }}.

Obtener el ID del valor de alguna propiedad[editar]

También se puede obtener el ID de un valor en lugar de su etiqueta. Esto es útil si se quieren consultar los tipos de alguna obra.

  • {{Propiedad|1=PXXXX|enlace=no}} devuelve «Etiqueta»
  • {{Propiedad|1=PXXXX|tipo de dato=formatId|enlace=no}} devuelve «QXXXX»

Otros usos de la plantilla[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 puede utilizarse 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:Wikipedia:Paramétro que anula Wikidata imnecesario
Comprobar los datos que faltan en Wikidata → Categoría:Wikipedia:Valor perdido en Wikidata
Comprobar si los datos en Wikidata son diferentes que la anulación → Categoría:Wikipedia:Comprobar inconsistencia en Wikidata.

Forzar una entidad[editar]

Plantilla:Véase también A veces puede ser útil forzar el uso de un ID 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|1=PXXXX|2={{{parámetro|}}}|entidad={{entidad|}}}} <!-- Se obtiene la propiedad desde Wikidata o el valor local -->
  |{{{parámetro}}} <!-- Solo se establece el valor local -->
}}

Uso en 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.

Ejemplos
  • No No funciona: {{#expr: ( {{{población}}} / {{Propiedad|P2046|{{{superficie}}} ) }}
  • Sí Forma correcta: {{#expr: ( {{{población}}} / {{{superficie|{{Propiedad|P2046}}}}} ) }}
  • No No funciona: {{#expr: ( {{{población}}} / {{Propiedad|P2046|{{{superficie}}}|prioridad=si}} ) }}
  • Sí 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:

  • Sí Forma correcta: {{#expr: ( {{{población}}} / {{{superficie|{{Propiedad|P2046|formato unidad=número}}}}} ) }}
  • Sí Forma correcta: {{#expr: ( {{{población}}} / {{Propiedad|P2046|{{{superficie}}}|prioridad=si|categorías=no|formato unidad=número}} ) }}

Véase también[editar]

TemplateData[editar]

Plantilla:Encabezamiento de TemplateData

Esta plantilla permite obtener valores de una propiedad de Wikidata.

Parámetros de la plantilla

ParámetroDescripciónTipoEstado
Propiedad de Wikidata1

La propiedad a enlazar.

Cadenaobligatorio
Anular2

Valor para sobreescribir la propiedad con algún valor/variable local.

Cadenaopcional
Separador3

Separador de valores.

Cadenaopcional
Módulo4

Nombre del módulo a llamar

Cadenaopcional
Función5

Función del módulo a usar.

Cadenaopcional
Leyenda de imagen6

Un texto de pie de imagen opcional.

Cadenaopcional
Entidad de Wikidataentidad

Un identificador de ítem de Wikidata, si se quiere enlazar a un ítem diferente del asociado a la página usada.

Cadenaopcional
Calificadorcalificador

El calificador (o subpropiedad) a obtener. Esta opción muestra solamente el calificador.

Cadenaopcional
Calificativocalificativo

El calificador (o subpropiedad) a obtener. Esta opción muestra la propiedad seguido del calificador entre paréntesis.

Cadenaopcional
Idioma de la propiedadidioma

Filtra por el idioma seleccionado en las propiedades dependientes del idioma.

Cadenaopcional
Conjunciónconjunción

La conjunción, si se trata de varios valores sin separador establecido. Por defecto es «y», por ejemplo «manzanas, peras y kiwis».

Cadenaopcional
Obtener enlace o noenlace

Establece si se desea o no establecer el enlace. Úsese el valor «no»

Cadenaopcional
Obtener solo un valor de la listauno

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)

Cadenaopcional