Ir al contenido

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 y país mediterráneo
    • {{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ódigoResultado
    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ódigoResultados
    {{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ódigoResultado
    {{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ódigoResultado
    {{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