Edició de «Plantilla:Propietat/doc»

{{Subpàgina de documentació}}
{{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=<llegenda d'image>| entitat = <id entitat>| enllaç = <no> | prioritat = <sí> | categories = <no> | uno = <sí>| ranc_major = <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.
|}
==== Eixemples ====
A continuació s'ha simulat  resultats d'esta plantilla en l'artícul [[Espanya]].
:*<code><nowiki>{{Propietat|p37|enlace=no}}</nowiki></code> → {{Propietat|p37|entitat=Q29|enllaç=no}}
:*<code><nowiki>{{Propietat|p31}}</nowiki></code> → {{Propietat|p31|entitat=Q29}}
:*<code><nowiki>{{Propietat|p37}}</nowiki></code> → {{Propietat|p37|entitat=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 espanyol|espanyol]]</nowiki></code>.</small>

Açò és lo que passa usant directament <code><nowiki>{{#property:}}</nowiki></code>
:*<code><nowiki>{{property:p31}}</nowiki></code> → Estat sobirà, Estat membre de l'Unió Europea
:*<code><nowiki>[[{{property:p31}}]]</nowiki></code> → [[Estat sobirà, Estat membre de l'Unió Europea]]
:*<code><nowiki>{{property:p31}}</nowiki></code> → espanyol, @aranés, vasc, gallec, català

=====Eixemples en formats alternatius =====
A continuació es donen varis eixemples de casos en els que s'ha usat un mòdul de format (eixemple 1) o s'han canviat el separador per a adaptar el format de presentació dels valors.

{| class="wikitable"
!Eixemple !! Simulació del resultat en el artícul: [[Nova Zelanda]]
|-
|valign="top"|
:'''Donar a valors que són image el format en marc i llegenda'''<br>
<code><nowiki>{{Propietat|1=p242|2=|3=|4=Wikidata/Formatos|5=formatImage|6=Test}}</nowiki></code> 
|bgcolor="#FFFFFF"|
[[Archiu:LocationNewZealand.png|thumb|Test]]
[[Archiu:NZL orthographic NaturalEarth.svg|thumb|Test]]
|-
|valign="top"|
:'''Canviar el separador per a que cada valor estiga en una llínea.'''<br>
<code><nowiki>{{Propiedad|1=p31|3=<br>}}</nowiki></code>
|bgcolor="#FFFFFF"|Estat sobirà<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>
:Es podrien posar els valors en columnes diferents en el separador: <code><nowiki></td><td></nowiki></code>
|bgcolor="#FFFFFF"|
{|class="wikitable"
|Estado soberano
|-
|[[Monarquía en la Mancomunidad de Naciones]]
|-
|[[país]]
|}
|-
|}
====== En formatBandera ======

{|class=wikitable
!Còdic !! Resultat
|-
|
<pre>{{Propietat|p17||<br>|Wikidata/Formats|formatBandera}}<br>
{{Propietat|p131||<br>|Wikidata/Formats|formatBandera}}</pre>
|
{{Bandera2|Espanya}}<br>
{{bandera2|Castile and León}}<br>
{{Bandera2|Província de Valladolit}}
|}

===== 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}} 

Les senyes que la plantilla importa poden ser usades per atres plantilles com la plantilla {{ep|Mapa de localisació}}.
{|class=wikitable
!Código !! Resultado
|-
|valign=top|
<pre>{{mapa de localisació
|Espanya
|label=Valladolit
|lat={{Propietat|latitut}}
|long={{Propietat|longitut}}
|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>.

==== Atres usos de la plantilla ====

Es pot usar un paràmetro (o paràmetros) per a comprovar si les senyes que figuren en Uiquidata són els mateixos que l'anulació o si les senyes falten en Uiquiidata. Açò pot utilisar-se com a servici d'alerta (per eixemple, per mig de l'us de les categories amagades)

:Verificar que les senyes de Uiquidata són lo mateix que l'anulació → [[:Categoria:Uiquipedia:Paràmetro que anula Uiquidata innecesari]] 

:Comprovar les senyes que falten en Uiquidata → [[:Categoria:Uiquipedia:Valor perdut en Uiquidata]]

:Comprovar si les senyes en Uiquidata són diferents que l'anulació → [[:Categoria:Uiquipedia:Comprovar inconsistència en Uiquidata]].

== 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ó}}} / {{Propietat|P2046|{{{superfície}}} ) }}</nowiki></code>
* {{Si|Forma correcta}}: <code><nowiki>{{#expr: ( {{{població}}} / {{{superfície|{{Propietat|P2046}}}}} ) }}</nowiki></code>
* {{No|No funciona}}: <code><nowiki>{{#expr: ( {{{població}}} / {{Propiedad|P2046|{{{superficie}}}|prioritat=si}} ) }}</nowiki></code>
* {{Si|Forma correcta}}: <code><nowiki>{{#expr: ( {{{població}}} / {{Propietat|P2046|{{{superfície}}}|prioritat=si|categories=no}} ) }}</nowiki></code>

En el cas de que la propietat en qüestió tinga una unitat definida en Uiquidata (metros, minuts,...) i es vullga utilisar en càlculs matemàtics també es requerirà l'us del paràmetro <code><nowiki>format unitat=número</nowiki></code>, de manera que els eixemples anteriors quedarien de la següent manera:

* {{Si|Forma correcta}}: <code><nowiki>{{#expr: ( {{{població}}} / {{{superficie|{{Propiedad|P2046|formato unidad=número}}}}} ) }}</nowiki></code>
* {{Si|Forma correcta}}: <code><nowiki>{{#expr: ( {{{població}}} / {{Propietat|P2046|{{{superfície}}}|prioritat=si|categories=no|format unitat=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>