Mòdul:Location/ús

Aquesta és una subpàgina de documentació per a la Mòdul:Location
Té la informació d'ús, les categories i qualsevol altre contingut que no forma part essencial del codi del mòdul.

Aquest mòdul és utilitzat en més de 100000 pàgines pàgines.
Per evitar la interrupció a gran escala i la innecessària càrrega del servidor, qualsevol canvi en aquest mòdul primer hauria de ser provat en la subpàgina /proves, o /tests. Els canvis assajats després es poden afegir a aquesta pàgina en una sola edició. Si us plau: considereu discutir qualsevol canvi en la pàgina de discussió abans d'implementar-los.

There is a version in English of this documentation at Module:Location/en.

Aquest mòdul afegeix un referent entre parèntesis a l'etiqueta d'una localitat o unitat administrativa obtinguda de Wikidata, d'acord amb Viquipèdia:Localitats. Per exemple: "Mataró (Maresme)" o "Berlín (Alemanya)".

Sintaxi modifica

En una pàgina de proves:
{{#invoke:Location|debug|<Qid>|<Qid2>|lang=<codi>}}
Des d'un altre mòdul:
require('Module:Location').naming(<etiqueta>, _, <lang>, <Qid>, <Qid2>)
Amb la sintaxi de la funció claim del Mòdul:Wikidades:
case=location

case=locationcontext

Paràmetres:

El paràmetre <Qid>, necessari, és l'id de l'element de Wikidata de la localitat. Amb case=location només s'usa aquest paràmetre considerant que el referent és atemporal, vàlid amb l'estructura administrativa actual.
El paràmetre <Qid2>, opcional, és l'id de la pàgina on s'obtindrà una data de context per a evitar referents anacrònics. Amb case=locationcontext s'obté aquest segon paràmetre de la pàgina actual.
El paràmetre lang és el codi de llengua, per defecte la llengua local del wiki.
El paràmetre <etiqueta>, usat des d'un altre mòdul, s'utilitza per a evitar referents redundants.

Usat amb el paràmetre case de la funció claim del Mòdul:Wikidades, aquests tres paràmetres ja són obtinguts per aquell mòdul.

No està previst l'ús des d'una plantilla. Comenteu-ho a la discussió si fos necessari.

Dades modifica

Les dades s'obtenen de Wikidata a partir de la definició de Estat (P17), i en casos amb més detall amb el Mòdul:Wikidades funció getParentValues a partir de la definició de Localitzat a l'entitat territorial administrativa (P131) de forma recursiva. Vegeu la documentació a Mòdul:Wikidades#Funció getParentValues. En casos suposadament incoherents comproveu a Wikidata com estan definides aquestes propietats.

Si es condiciona el referent a una data de context, per exemple en dades biogràfiques amb case=locationcontext, aquesta data s'obté de la pàgina actual:

Propietats Data de defunció (P570), Data de naixement (P569) o Inici del període d'activitat (P2031).
Qualificadors Data d'inici (P580) o Data (P585) de les propietats Cònjuge (P26), Premis (P166), Nominacions (P1411), Càrrec (P39) o Residència (P551).

Aquesta data es compara amb la data del referent que indica a partir de quan és vàlid. La data del referent es pot definir en els criteris per llengua, per exemple les províncies d'Espanya és 1800. Altrament:

De la taula anachronic_date amb casos particulars.
De la propietat Creació (P571).
Per defecte 1945.

Criteris modifica

El referent general és per estat. En cada llengua hi poden haver criteris específics segons les normes d'estil local. Actualment estan definits en català i en anglès. Vegeu els submòduls corresponents per la documentació dels criteris usats. Per a definir criteris en altres llengües ho podeu demanar a la pàgina de discussió.