Plantilla:GetLabelFix/proves

Documentació de la plantilla [ mostra ] [ modifica el codi ] [ mostra l'historial ] [ refresca ]

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ó

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

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

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

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

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.

La documentació de més amunt està transclosa de Plantilla:GetLabelFix/ús. (modifica | historial)
Els editors poden fer proves amb aquesta plantilla al seu espai de proves (crea | modifica)
Afegiu categories en la subpàgina /ús. Vegeu les subpàgines d'aquesta plantilla, utilització de paràmetres.