Vés al contingut

Plantilla:GetTabParam/ús

De la Viquipèdia, l'enciclopèdia lliure

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

Descripció

[modifica]

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

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

[modifica]

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

[modifica]
{{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à:
  • valueIB: Servei de recuperació del <valor_parametre>, és a dir el valors de la fila que coincideixi amb el <codi_cercat>. El retorn serà:
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.

Vegeu també

[modifica]