Plantilla:GetLabelFix/ús
Aquesta és una subpàgina de documentació per a la Plantilla:GetLabelFix Té la informació d'ús, les categories i qualsevol altre contingut que no forma part essencial del codi de la plantilla. |
Aquesta plantilla és utilitzada en més de 400000 pàgines. Per evitar la interrupció a gran escala i la innecessària càrrega del servidor, qualsevol canvi en aquesta plantilla primer hauria de ser provat en la subpàgina /proves, o en el vostre propi espai d'usuari. 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. |
Descripció
[modifica]Funció per recuperar els labels de propietats i items WD en la llengua determinada pel paràmetre |lang=
per tal de posar-les a les etiquetes de les infotaules.
El retorn té en compte la possible existència d'una excepció al text del label trobat a WD per un altre de més ajustat al que es vol mostrar com a etiqueta d'una infotaula. Per exemple, fer servir un text més curt, sigles o algun sinònim que expressi millor el contingut presentat.
Dins la llista d'excepcions s'inclouen també tots aquells textos que, sense tenir una propietat o ítem WD de referència, apareixen a la infotaula i són susceptibles de ser traduïts. Per exemple, els headers, les etiquetes de paràmetres manuals sense WD, o aquells textos que formen part de l'edició de resultats un cop s'han recuperat i tractat (ex.: conversió dels "No value" en un altre significat)
En tots dos casos -etiquetes i textos- es pot recuperar indicant el codi de propietat (Pnnnn), el codi d'un ítem la definició del qual s'ajusti al text que ens cal (Qnnnnn) o bé un text especial que gestionarem a la llista d'excepcions (Tnnn).
Gestió de les excepcions
[modifica]La llista d'excepcions es defineix a Mòdul:Wikidades/labels dins l'apartat infoboxLabelsFromId
.
Quan algun dels textos de tipus Pnnnn o Qnnnnn que ens retorna no s'ajusten al que esperàvem, per exemple, si el text que es mostra a la llengua que estem tractant és massa llarg o la redacció no és la més adient per a l'etiqueta d'infotaula, es podria solucionar:
- modificant el label de la propietat/ítem directament a WD. Això no sempre és possible perquè podríem estar alterant el seu sentit i afectaríem a tots els usuaris d'aquest contingut.
- si no volem o no podem canviar el nom de la propietat/ítem a WD, és pot crear una excepció per aquell cas dins Mòdul:Wikidades/labels i s'aplicarà en substitució del text que ens subministraria WD, sense necessitat de modificar el codi de la infotaula.
Sintaxi
[modifica]{{GetLabelFix|<codi>|lang=<llengua>|linked=yes/no|case=gender/ucfirst,...|itemgender=<itemgender>}}
- Parametres
- el primer és posicional: Obligatori. Codi per obtenir el text a partir del label WD en la
llengua
corresponent. Pots ser:- Pnnn, per recuperar el label d'una propietat
- Qnnnnnn, per recuperar el label d'un item WD
- Txxx, per recuperar un text definit dins la llista d'excepcions que no prové de WD
- lang: opcional. Codi de llengua en que es vol recuperar el label definit en
codi
. Si no s'informe fa servir la llengua local. - linked: opcional. "yes" indica que el valor retornat serà un enllaç a l'article de la wiki local o, a l'item WD, cas de no existir article. Si no s'informa, retorna text sense enllaçar.
- case: opcional. Mateixes funcions que s'apliquen a claim de mòdul:Wikidades
- itemgender: opcional. Mateixes funcions que s'apliquen a claim de mòdul:Wikidades.
Exemples
[modifica]Casos basats en Professor (Q37226)
- cap paràmetre: Professor
- case=plural: Professors
- itemgender=Qid de dona: Professora
- case=plural + itemgender=Qid de dona: Professores
- link=yes: Professor
Manteniment
[modifica]Diferents situacions:
- Afegir un nou paràmetre (label + data) a la infotaula:
- Si es recupera un valor WD, simplement cal afegir una crida cap a aquesta plantilla posant com a paràmetre el codi de propietat/ítem del que volem recuperar el label.
- Si es tracta d'un text de tipus Tnnn, és a dir que no es recuperen de WD, cal fer una nova entrada a Mòdul:Wikidades/labels amb el següent codi "Tnnn" disponible i posar el text que vulguem pel label. A la Infotaula s'afegirà una crida a aquesta plantilla posant com a primer paràmetre el nou codi de "label" creat.
- Crear una excepció per canviar el text resultant d'un crida amb codi tipus Pnnn o Qnnnnn:
- Afegir una entrada dins Mòdul:Wikidades/labels amb el mateix codi que volem reemplaçar per a què s'agafi el seu valor abans que el de WD.