Plantilla:GetTabParam/ús

Servei per recuperar elements de les taules {{Global Infobox person/Tab param}} i {{Global Infobox person/Tab exception}}

Descripció

Aquestes dues taules contenen la parametrització de la {{Global Infobox person}}:

• La totalitat dels valors per defecte a {{Global Infobox person/Tab param}}
• Els valors de personalització de cada entorn a {{Global Infobox person/Tab exception}}

Aquest servei atén peticions per recuperar el valor corresponent entre ambdues taules (1er. exception, 2n. param) i edita la resposta segons el tipus de cerca demanada.

Format taula

Hi ha una entrada per cadascun dels elements que es vulguin aportar a la infotaula en forma de paràmetre, és a dir, on el contingut no formi part del codi intern i, per tant, sigui personalitzable. El format genèric de cada entrada és:

• |<codi>=<nom_param>;<label_a_mostrar>;<ind.ruby>;<valors extra>;<llista qualifiers>

Hi ha 4 tipus d'entrada que s'identifiquen per la seva inicial

ESTRUCTURA per /tab param

tipus entrada	codi	nom param.	label	ind.ruby	valors extra	qualifiers		Estructura final de l'entrada a Tab_param
P: property WD	Pnnn (property) Pnnn-nn (variant d'una Pnnn) Pnnn-Pnnn (prop-qualif)	xxxx	Qnnn / aaaa	no (o nul)	Pmmm / M_kkkk ...	Prrr / Pssss /		Pnnn = param;label;noruby;extra-property;qualifiers
M: continguts manuals	M_xxxx	xxxx	Qnnn / aaaa	no (o nul)	Pmmm / M_kkkk ...			M_xxxx = xxxx;label;noruby;extra-property
L: labels no vinculades a cap contingut	L_yyyy		Qnnn / aaaa	no (o nul)	Pmmm / M_kkkk ...			L_yyyy = ;label;noruby;extra-property
S: strings valors de parametrització	S_zzzz		bbbb					S_zzzz = ;value

On:

• <codi> és el codi únic de cada fila de la taula que permet recuperar continguts
  • Per les entrades de tipus Pnnn, corresponent a un codi de property, també pot tenir el format Pnnn-nn (ex.:P859-02) quan cal generar més d'un val_Pnnn/lbl_Pnnn per gestionar dos tractaments diferents d'una propietat dins la infobox.
  • També existeix el format Pnnn-Pmmm per gestionar valors i etiquetes d'un qualificador d'una propietat. Ex.: P18-P2096 per gestionar el peu de foto.
• <nom_param> és un nom únic que descriu en "text comprensible" el <codi>. Internament la infotaula tracta com a sinònims tant el contingut de <codi> com el de <nom_param>, facilitant la comprensió de la utilització d'aquests paràmetres.
• <label> contingut de l'etiqueta del paràmetre. Pot ser un codi de property o d'item (Pnnn/Qnnnn) d'on s'obtindrà el text a mostrar a l'etiqueta per aquesta entrada. També pot contenir directament un text.
  • En les entrades tipus S conté el valor de parametrització (xifra, codi d'unitat de mesura, categoria, etc.)
• <ind.ruby> indica que "no" generi <ruby> per la label
• <valors extra> llista de codis de contingut (Pnnn/Mxxx) que s'afegiran dins la generació de <ruby> darrera de lbl_Pnnn + val_Pnnn. Es fa servir quan una etiqueta representa més d'un "val_Pnnn".
• <llista de qualifiers> llista de qualificadors gestionats per la property (amb / darrera de cadascun). Només és vàlid per les entrades tipus "property"

Les entrades de tipus P, M, L permeten generar una variable tipus lbl_P/M/L_ amb el contingut de label. El contingut s'encapsula dins un <ruby>lbl_Pnnn + val_Pnnn</ruby> per documentar en un hint quin és el nom del paràmetre d'etiqueta i de contingut relacionats. L'encapsulament <ruby> es pot evitar indicant-lo amb el paràmetre "no ruby". Les entrades de tipus P, M, S permeten generar una variable tipus val_P/M/S_ que serveixen perquè s'hi aportin manualment continguts. En el cas dels tipus P/M els continguts formen part del que la infotaula mostrarà. En el cas del tipus S el contingut és un valor utilitzat internament com a element de parametrització (xifra, codi d'unitat de mesura, etc.).

Sintaxi

{{GetTabParam|<tipus_cerca>|<codi_cercat>}}

Els tipus de cerca o serveis previstos són:

• preIB: Servei de recuperació del <nom_local>, és a dir el primer dels valors de la fila que coincideixi amb el <codi_cercat>. El retorn pot ser:

• Si existeix a la taula exception i el seu valor és NONE, >>> retorna >>>> NONE
• en cas contrari, construeix un string amb una estructura {{{val_Pnnn|{{{nom_param|{{{nom_local|}}}}}}}}},

sense incorporar la sintaxi {{{nom_local|}}} quan no existeix o estigui buida la corresponent entrada a la taula exception i

sense incorporar la sintaxi {{{nom_param|}}} quan no existeix o estigui buida la corresponent entrada a la taula param.

• labelIB: Servei de recuperació del <label_a_mostrar>, és a dir el segon dels valors de la fila que coincideixi amb el <codi_cercat>. El retorn serà:

• el valor trobat a {{Global Infobox person/Tab exception}} prioritàriament per sobre del trobat a {{Global Infobox person/Tab param}}
• el format de retorn serà el label de WD corresponent al valor trobat, quan sigui del tipus Qnnnnn o Pnnnn. Si no és el cas, retorna el contingut trobat.

• valueIB: Servei de recuperació del <valor_parametre>, és a dir el valors de la fila que coincideixi amb el <codi_cercat>. El retorn serà:

• <valor trobat>, agafant el valor de {{Global Infobox person/Tab exception}} prioritàriament per sobre del trobat a {{Global Infobox person/Tab param}}. El cas dels valors s'aplica a les entrades de tipus S; NO hi ha opció a <nom_parametre_local>.

altres funcions comodí per obtenir valors directes de les taules són

• param = retorna el valor del <nom_param> de la taula /tab param.
• label = retorna el valor del <label_a_mostrar> de la taula /tab param.
• noruby = retorna el valor del <ind.ruby> de la taula /tab param.
• extra = retorna el valor del <valors_extra> de la taula /tab param.
• qualif = retorna el valor del <llista qualifiers> de la taula /tab param.

• param_exc = retorna el valor del <nom_param> de la taula /tab exception.
• label_exc = retorna el valor del <label_a_mostrar> de la taula /tab exception.