Edició de «Plantilla:Propietat/doc»

{{Subpágina de documentación}}
{{Plantilla con Lua|módulo=Wikidata}}
=== Use ===
Esta plantilla pretén ser una senzilla forma d'enllaçar les propietats de [[*Wikidata]] en artículs i plantilles. Torna les senyes de *Wikidata en els enllaços interns en els valors que procedix. També permet donar la possibilitat quan s'usa dins d'atres plantilles d'establir en esta un paràmetro que anule la senya de *Wikidata si eixe paràmetro té un valor. 

Per defecte quan hi ha dos valors apareixeran separats per la conjunció «i» i quan hi ha 3 o més valors per comes i l'últim valor per la conjunció «i». Per a atres formats (taules llestes etc.) és possible canviar el separador. 
{|class="wikitable"
|+Sintaxis de la plantilla
|align=center|
::::<code><nowiki>{{Propietat|1=<propietat>[|2=<anular>|3=<separador>|4=<módul de format>|5=<funció del módul>|6=<legenda de image>| entitat = <id entidad>| enllaç = <no> | prioritat = <sí> | categories = <no> | uno = <sí>| ranc_mayor = <sí>|]}}</nowiki></code>
|-
|bgcolor="#FFFFFF"|
:*1: Propietat de Uiquidata (obligatoria)

:*2: Anular podría ser un parámetro de la plantilla, a continuación, en forma de <code><nowiki>{{{parámetro |}}}</nowiki></code>, el cual de tener valor reemplazaría al valor de Wikidata.<br> 
:Si se indica <code>prioridad = sí</code> tendrá preferencia el/los valor/es de Wikidata  usándose los del parámetro solo si no está en el ítem de Wikidata esa propiedad.

:*3: Si hay varios valores para la misma propiedad, esta se utiliza para separar los valores.

:*4: Nombre del módulo para llamar a formatear el valor 

:*5: Nombre de la función del módulo llamado en el anterior parámetro para formatear el valor. Se necesitan dos :parámetros: el valor y una matriz que contiene los parámetros pasados a la función formatStatements. Para ejemplos ver  [[Módulo:Wikidata/Formatos]] .

:*6: Leyenda en el caso de ser una image.
:*<code>entitat</code>: Id del elemento por ejemplo (<code>Q12</code>) del cual se quiera obtener la propiedad. Si no se le da valor se obtendrá del elemento al cual está enlazada la página.
:*<code>enlace = no</code>. Hace que no aparezca el enlace interno al artículo correspondiente apareciendo solo la etiqueta del valor.
:*<code>uno = sí</code>. Hace que en el caso de que existan varios valores de la propiedad, la plantilla solo devuelva uno.
|-
|bgcolor="#FFFFFF"|

* Sólo si la anulación está en blanco se recuperan los datos de Wikidata.

* Si los datos de Wikidata son los mismos que los de la redefinición, es aconsejable quitar el valor del parámetro. Entonces cualquier actualización de Wikidata se mostrará inmediatamente.

* No es obligatorio el uso de todos los parámetros de la plantilla.
|}
==== Ejemplos ====
A continuación se ha simulado  resultados de esta plantilla en el artículo [[España]].
:*<code><nowiki>{{Propiedad|p37|enlace=no}}</nowiki></code> → {{Propiedad|p37|entidad=Q29|enlace=no}}
:*<code><nowiki>{{Propiedad|p31}}</nowiki></code> → {{Propiedad|p31|entidad=Q29}}
:*<code><nowiki>{{Propiedad|p37}}</nowiki></code> → {{Propiedad|p37|entidad=Q29}}
:<small>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í:<code><nowiki>[[idioma español|español]]</nowiki></code>.</small>

Esto es lo que pasa usando directamente <code><nowiki>{{#property:}}</nowiki></code>
:*<code><nowiki>{{property:p31}}</nowiki></code> → Estado soberano, Estado miembro de la Unión Europea
:*<code><nowiki>[[{{property:p31}}]]</nowiki></code> → [[Estado soberano, Estado miembro de la Unión Europea]]
:*<code><nowiki>{{property:p31}}</nowiki></code> → español, aranés, euskera, gallego, catalán

=====Ejemplos con formatos alternativos =====
A continuación se dan varios ejemplos de casos en los que se ha usado un módulo de formato (ejemplo 1) o se han cambiado el separador para adaptar el formato de presentación de los valores.

{| class="wikitable"
!Ejemplo !! Simulación del resultado en el artículo: [[Nueva Zelanda]]
|-
|valign="top"|
:'''Dar a valores que son imagen el formato con marco y leyenda'''<br>
<code><nowiki>{{Propiedad|1=p242|2=|3=|4=Wikidata/Formatos|5=formatImage|6=Test}}</nowiki></code> 
|bgcolor="#FFFFFF"|
[[Archivo:LocationNewZealand.png|thumb|Test]]
[[Archivo:NZL orthographic NaturalEarth.svg|thumb|Test]]
|-
|valign="top"|
:'''Cambiar el separador para que cada valor esté en una línea.'''<br>
<code><nowiki>{{Propiedad|1=p31|3=<br>}}</nowiki></code>
|bgcolor="#FFFFFF"|Estado soberano<br>[[Monarquía en la Mancomunidad de Naciones]]<br>[[país]]
|-
|valign="top"|
:'''Cambiar el separador para que los valores se pongan como una lista'''.<br>
<code><nowiki>* {{Propiedad|1=p31|lista=sí}}</nowiki></code>
|bgcolor="#FFFFFF"|<ul><li>Estado soberano</li><LI>[[Monarquía en la Mancomunidad de Naciones]]</li><LI>[[país]]</li></ul>
|-
|valign="top"|
:'''Dentro de una tabla poner los valores en una fila diferente.'''
<pre>
 {| class="wikitable"
 | {{Propiedad|1=p31|3=</td></tr><tr><td>}}
 |}</pre>
:Se podrían poner los valores en columnas diferentes con el separador: <code><nowiki></td><td></nowiki></code>
|bgcolor="#FFFFFF"|
{|class="wikitable"
|Estado soberano
|-
|[[Monarquía en la Mancomunidad de Naciones]]
|-
|[[país]]
|}
|-
|}
====== Con formatBandera ======

{|class=wikitable
!Código !! Resultado
|-
|
<pre>{{Propiedad|p17||<br>|Wikidata/Formatos|formatBandera}}<br>
{{Propiedad|p131||<br>|Wikidata/Formatos|formatBandera}}</pre>
|
{{Bandera2|España}}<br>
{{bandera2|Castilla y León}}<br>
{{Bandera2|Provincia de Valladolid}}
|}
===== Coordenadas =====
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.
:* <code><nowiki>{{Propiedad|latitud}}</nowiki></code> → 41.651980555556
:* <code><nowiki>{{Propiedad|longitud}}</nowiki></code> → -4.7285611111111
;Las coordenadas incluidas en la plantilla {{ep|coord}}.
:*<code><nowiki>{{Propiedad|p625}}</nowiki></code> → {{coord|41.651980555556|-4.7285611111111|type:city|display = inline,title|format=dms}}  - (Por defecto tipo= city, display = inline,title y formato = dms)
:*<code><nowiki>{{Propiedad|p625|tipo=landmark|display=inline|formato=dec}}</nowiki></code> → {{coord|41.651980555556|-4.7285611111111|type:landmark|display = inline|format=dec}} 

Los datos que la plantilla importa pueden ser usadas por otras plantillas como la plantilla {{ep|Mapa de localización}}.
{|class=wikitable
!Código !! Resultado
|-
|valign=top|
<pre>{{mapa de localización
|España
|label=Valladolid
|lat={{Propiedad|latitud}}
|long={{Propiedad|longitud}}
|float = none 
}}</pre>
|
{{map de localisació
|Espany
|label=Valladolit
|lat=41.651980555556
|long=-4.7285611111111
|float = none 
}}
|-
|valign=top|
<pre>{{mapa de localisació
|Valladolit
|label=Valladolit
|lat={{Propietat|latitut}}
|long={{Propietat|longitut}}
|float = none 
}}</pre>
|
{{mapa de localisació
|Valladolit
|label=Valladolit
|lat=41.651980555556
|long=-4.7285611111111
|float = none 
}}
|}

; Obras de una serie literaria
<code><nowiki>{{propiedad
  |entidad=Q3008321
  |P527
  |lista=no ordenada
  |enlace=sí
  |4=Wikidata/Formatos
  |5=formatoObraAnyo
  }}</nowiki></code> → {{propiedad
  |entidad=Q3008321
  |P527
  |lista=no ordenada
  |enlace=sí
  |4=Wikidata/Formatos
  |5=formatoObraAnyo
  }}

{{ayuda propiedad|P527}}

==== Prioridad ====
===== Prioridad valor dado en la Wikipedia local =====
Cuando se usa esta plantilla en otra, por ejemplo en una ficha, no es necesario el usar operadores <code>{{if:|...</code> 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: 
<code><nowiki>{{Propiedad|p17| {{{país|}}} }}</nowiki></code>. esto devolvería el valor dado al parámetro  <code>| país =</code>  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: 
<code><nowiki>{{#if: {{{país|}}} | {{{país}}} | {{Propiedad|p17}} }}</nowiki></code>.

===== Prioridad valor de Wikidata =====
También es posible darle prioridad al valor de la propiedad del ítem de Wikidata usando el parámetro <code>|prioridad = sí</code>. 
;Ejemplo:
<code><nowiki>{{Propiedad|p17| {{{país|}}} | prioridad = sí }}</nowiki></code>. 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 <code>país = </code> de forma que no haría falta poner: 
<code><nowiki>{{#if: {{Propiedad|p17}} | {{Propiedad|p17}} | {{{país}}} }}</nowiki></code>.

==== Otros usos de la plantilla ====

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

:Compruebar si los datos en Wikidata son diferentes que la anulación → [[:Categoría:Wikipedia:Comprobar inconsistencia en Wikidata]].

== Uso en cálculos matemáticos ==
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 {{Parámetro|2}} y éste no es específicamente un número.
;Ejemplos:
* {{No|No funciona}}: <code><nowiki>{{#expr: ( {{{población}}} / {{Propiedad|P2046|{{{superficie}}} ) }}</nowiki></code>
* {{Si|Forma correcta}}: <code><nowiki>{{#expr: ( {{{población}}} / {{{superficie|{{Propiedad|P2046}}}}} ) }}</nowiki></code>
* {{No|No funciona}}: <code><nowiki>{{#expr: ( {{{población}}} / {{Propiedad|P2046|{{{superficie}}}|prioridad=si}} ) }}</nowiki></code>
* {{Si|Forma correcta}}: <code><nowiki>{{#expr: ( {{{población}}} / {{Propiedad|P2046|{{{superficie}}}|prioridad=si|categorías=no}} ) }}</nowiki></code>

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 <code><nowiki>formato unidad=número</nowiki></code>, de forma que los ejemplos anteriores quedarían de la siguiente manera:

* {{Si|Forma correcta}}: <code><nowiki>{{#expr: ( {{{población}}} / {{{superficie|{{Propiedad|P2046|formato unidad=número}}}}} ) }}</nowiki></code>
* {{Si|Forma correcta}}: <code><nowiki>{{#expr: ( {{{población}}} / {{Propiedad|P2046|{{{superficie}}}|prioridad=si|categorías=no|formato unidad=número}} ) }}</nowiki></code>

== Véase también ==
* [[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.

<includeonly>
[[Categoría:Wikipedia:Plantillas de Wikidata]]
</includeonly>