Viquiprojecte:Adaptació de plantilles a Wikidata/multilingüe/migració infotaules a V5/Construcció eines instal·lació: diferència entre les revisions
m →Casos d'ús: ajust doc |
|||
Línia 351: | Línia 351: | ||
| rowspan="2" |L |
| rowspan="2" |L |
||
| rowspan="2" |descriu continguts de text no vinculats a un paràmetre. |
| rowspan="2" |descriu continguts de text no vinculats a un paràmetre. |
||
| rowspan="2" |<span style="color: blue;">''' |
| rowspan="2" |<span style="color: blue;">'''L_'''abcabcabc</span> |
||
| rowspan="2" |les entrades tipus "label" només |
| rowspan="2" |les entrades tipus "label" només |
||
tenen paràmetres d'etiqueta |
tenen paràmetres d'etiqueta |
||
Línia 357: | Línia 357: | ||
|<code><nowiki>{{{lbl_<codi>|}}}</nowiki></code> |
|<code><nowiki>{{{lbl_<codi>|}}}</nowiki></code> |
||
|- |
|- |
||
|<code><nowiki>{{{ |
|<code><nowiki>{{{lbl_L_biography|}}}</nowiki></code> |
||
|- |
|- |
||
| rowspan="4" | |
| rowspan="4" |S |
||
| rowspan="2" |descriu la <u>unitat de mesura</u> |
| rowspan="2" |descriu la <u>unitat de mesura</u> |
||
en que es vol mostrar la Pnnnn |
en que es vol mostrar la Pnnnn |
||
| rowspan="2" |<span style="color: blue;">''' |
| rowspan="2" |<span style="color: blue;">'''S_unit'''Pnnnn</span> |
||
| rowspan="4" |les entrades tipus "valor", |
| rowspan="4" |les entrades tipus "valor", |
||
només tenen el format |
només tenen el format |
||
Línia 370: | Línia 370: | ||
| rowspan="4" | |
| rowspan="4" | |
||
|- |
|- |
||
|<code><nowiki>{{{ |
|<code><nowiki>{{{val_S_unitP2048|}}}</nowiki></code> |
||
|- |
|- |
||
| rowspan="2" |descriu el valor per <u>plegar la llista</u> de la Pnnnn |
| rowspan="2" |descriu el valor per <u>plegar la llista</u> de la Pnnnn |
||
| rowspan="2" |<span style="color: blue;">''' |
| rowspan="2" |<span style="color: blue;">'''S_collapse'''Pnnnn</span> |
||
|<code><nowiki>{{{val_<codi>|}}}</nowiki></code> |
|<code><nowiki>{{{val_<codi>|}}}</nowiki></code> |
||
|- |
|- |
||
|<code><nowiki>{{{ |
|<code><nowiki>{{{val_S_collapseP166|}}}</nowiki></code> |
||
|- |
|- |
||
|} |
|} |
Revisió del 13:12, 17 feb 2020
Codificació del contingut de taules
Tipus d'entrades a les taules
A la taula {{Global Infobox person/Tab param}}:
- molts valors són obligatoris, ja que representen el valor per defecte. L'absència d'un d'aquests continguts pot fer que no sigui tractat per la infotaula, tot i tenir el codi adient.
- el <nom_param> cal que sigui en anglès per assegurar el seu ús transversal. Per aplicar noms en llengua local, cal fer-ho a
/Tab exception
amb el mateix codi.
A la taula {{Global Infobox person/Tab exception}}
- l'absència de contingut en un valor opcional, significa que s'aplicarà el valor per defecte definit a
/Tab param
. - no és necessari tenir una entrada si no es vol personalitzar el "nom del paràmetre" ni el "label a mostrar".
Tipus | Funció | /Tab | format
<codi> |
<nom_param> | <label_a_mostrar> | <NO ruby> | <valors extra> | <llista qualifiers>
(només per propietats) |
---|---|---|---|---|---|---|---|---|
Propietat | descriu una propietat | param | Pnnnn | obligatori.
text |
obligatori.
text final o Qnnnnnn/Pnnnn |
opc.
no |
opcional.
Pnnn / ... Mnnn |
opcional.
Pnnn/Pnnn/..../Pmmm/ |
except | opcional.
text |
opcional.
text final o Qnnnnnn/Pnnnn |
<sempre BUIT> | <sempre BUIT> | ||||
except | NONE | <sempre BUIT> | ||||||
descriu nom i etiqueta per tractaments alternatius d'una propietat.
Similar a tenir un paràmetre manual, però amb un nom més descriptiu. |
param | Pnnnn_nn | obligatori.
text |
obligatori.
text final o Qnnnnnn/Pnnnn |
opc.
no |
opcional.
Pnnn / ... Mnnn | ||
Pqualificador | descriu un qualificador d'una propietat específica | param | Pnnnn-Qnnnn | obligatori.
text |
obligatori.
text final o Qnnnnnn/Pnnnn |
<sempre BUIT> | ||
except | opcional.
text |
opcional.
text final o Qnnnnnn/Pnnnn | ||||||
Manual | descriu un paràmetre manual | param | M_abcabcabc | obligatori.
text |
obligatori.
text final o Qnnnnnn/Pnnnn |
opc.
no |
opcional.
Pnnn / ... Mnnn | |
except | opcional.
text |
opcional.
text final o Qnnnnnn/Pnnnn |
<sempre BUIT> | |||||
Label | descriu continguts de text no vinculats a un paràmetre. | param | L_abcabcabc | <sempre BUIT> | obligatori.
text final o Qnnnnnn/Pnnnn |
opc.
no |
opcional.
Pnnn / ... Mnnn | |
except | opcional.
text final o Qnnnnnn/Pnnnn |
<sempre BUIT> | ||||||
String | descriu valors de parametrització (unitats, categories, valors de comparació, etc.) | param | S_abcabcabc | obligatori.
Qnnnnnn / xxxxxx | ||||
except | obligatori.
Qnnnnnn / xxxxxx |
Casos d'ús
Exemples de quins paràmetres calen/es poden utilitzar per construir entrades a cada taula, segons allò que es vulgui obtindre.
Cas | /Tab | <Codi> | <nom_param> | <label_a_mostrar> | <NO ruby> | <valors extra> | <llista qualifiers> | Valor a la taula | |
---|---|---|---|---|---|---|---|---|---|
P | Pnnnn,
cas bàsic |
param | P800 | notable_work | P800 | P571/P577/P585/P800-P1191/ | | P800 = notable_work;P800;P571/P577/P585/P800-P1191/ | ||
nom de paràmetre en llengua local, fent servir el <label_a_mostrar> estàndard | except | P800 | obres_notables | <sempre BUIT> | <sempre BUIT> | | P800 = obres_notables; | |||
etiqueta personalitzada amb una etiqueta pròpia, fent
servir el <nom_param> estàndard |
except | P800 | Q627364 | | P800 = ;Q627364 | |||||
etiqueta personalitzada amb enllaç intern, fent servir el <nom_param> estàndard | except | P597 | [[Associació de tennis femení|WTA]] | | P597 = ;[[Associació de tennis femení|WTA]] | |||||
Pnnnn,
tractament de propietat amb alternativa (ex. valor base) |
param | P859 | sponsor | P859 | P580/P582/ | | P859 = sponsor;P859;P580/P582/ | |||
Pnnnn_nn tractament de propietat amb alternativa (ex. valor alternatiu) | param | P859_02 | art_patron | Q15472169 | <sempre BUIT> | | P859_02 = art_patron;Q15472169 | |||
tractament de propietat amb alternativa (ex. valor alternatiu) | except | P859_02 | mecenatge | Mecenatge | <sempre BUIT> | | P859_02 = mecenes;Mecenatge | |||
Pnnnn-Qnnnn,
cas bàsic |
param | P611-P585 | date_ordination | Q41463697 | | P611-P585 = date_ordination;Q41463697 | ||||
etiqueta personalitzada amb enllaç intern, fent servir el <nom_param> estàndard | except | P611-P585 | Ordenació | <sempre BUIT> | | P611-P585 = ;Ordenació | ||||
M | M_abcabcabc,
cas bàsic |
param | M_orchestra | orchestra | Q42998 | | M_orchestra = orchestra;Q42998 | |||
nom_param i etiqueta personalitzat en plural | except | M_orchestra | orquestres | Orquestres | <sempre BUIT> | | M_orchestra = orquestres;Orquestres | |||
L | L_abcabcabc,
per definir continguts de seccions o qualsevol altre text dins la infotaula, no vinculats a continguts extrets de WD. |
param | header_family | <sempre BUIT> | Q8436 | | header_family = ;Q8436 | |||
S | S_unitPnnnn,
per indicar que conté la unitat de mesura |
param | unitP2048 | Q11573 | <sempre BUIT> | | unitP2048 = Q11573 | |||
utilitzar "peus" com a unitat de mesura | excep | unitP2048 | Q3710 | | unitP2048 = Q3710 | |||||
S_collapsePnnnn,
per indicar que conté el valor per plegar la llista de la Pnnnn |
param | collapseP166 | 180 | | collapseP166 = 180 | |||||
plegar llista premis si ocupen + 250 bytes | excep | collapseP166 | 250 | | collapseP166 = 250 |
Codificació paràmetres dins la Infobox
Els paràmetres que gestiona la Global Infobox person tenen un format normalitzat que deriva de les codificacions que hi consten a les taules de parametrització.
Hi ha dos grans grups de paràmetres: els de continguts i els d'etiquetes.
Tipus | Funció | format
<codi> |
descripció | paràmetre
valor |
paràmetre
etiqueta |
---|---|---|---|---|---|
P | descriu una propietat | Pnnnn | Els paràmetres de propietats
i manuals, poden adoptar dos formats a elecció de l'editor de l'article, que la infotaula gestiona com sinònims.
fent referència a la seva condició, mentre el segon està pensat per qui prefereixi nom menys "codificats". |
{{{val_<codi>|}}} o {{{<nom_param>|}}}
|
{{{lbl_<codi>_<nom_para>|}}}
|
Ex.: {{{val_P742|}}} o {{{pseudonym|}}}
|
Ex.:{{{lbl_P742_pseudonym|}}}
| ||||
descriu nom i etiqueta per tractaments alternatius d'una propietat.
Similar a tenir un paràmetre manual, però amb un nom més descriptiu. |
Pnnnn_nn | {{{val_<codi>|}}} o {{{<nom_param>|}}}
|
{{{lbl_<codi>_<nom_para>|}}}
| ||
Ex.:{{{val_P859_02|}}} o {{{art_patron|}}}
|
{{{lbl_P859_02_art_patron|}}}
| ||||
Pq | descriu un qualificador d'una propietat específica | Pnnnn-Qnnnn | {{{val_<codi>|}}} o {{{<nom_param>|}}}
|
{{{lbl_<codi>_<nom_para>|}}}
| |
Ex.: {{{val_P1026-P2699|}}} o {{{thesis_url|}}}
|
{{{lbl_P1026-P2699_thesis_url|}}}
| ||||
M | descriu un paràmetre manual | M_abcabcabc | {{{val_<codi>|}}} o {{{<nom_param>|}}}
|
{{{lbl_<codi>|}}}
| |
Ex.: {{{val_M_art|}}} o {{{art|}}}}}}
|
Ex.: {{{lbl_M_art|}}}
| ||||
L | descriu continguts de text no vinculats a un paràmetre. | L_abcabcabc | les entrades tipus "label" només
tenen paràmetres d'etiqueta |
{{{lbl_<codi>|}}}
| |
{{{lbl_L_biography|}}}
| |||||
S | descriu la unitat de mesura
en que es vol mostrar la Pnnnn |
S_unitPnnnn | les entrades tipus "valor",
només tenen el format bàsic de paràmetre |
{{{val_<codi>|}}}
|
|
{{{val_S_unitP2048|}}}
| |||||
descriu el valor per plegar la llista de la Pnnnn | S_collapsePnnnn | {{{val_<codi>|}}}
| |||
{{{val_S_collapseP166|}}}
|
Pre-infotaula
La {{Global Infobox person}} és directament utilitzable i, en condicions normals, no cal passar-li cap paràmetre addicional.
La utilització de paràmetres, amb la codificació descrita, dins una crida a la Infobox, afecta exclusivament a l'article on es fa servir.
- Recordem que es poden modificar, a nivell de plataforma (per a tots els articles)
- els valors de les etiquetes que es mostraran, incorporant el valor desitjat a la
/Tab exception
. - les unitats de mesura per fer que la Infobox adapti els resultats a unitats locals. Aquest canvi també es fa incorporant el valor a la
/Tab exception
.
Com fer personalitzacions ?
- Canvi de nom
- Crear una plantilla (la pre-infotaula) amb el nom local desitjat.
- Si només es vol canviar el nom sense tractar paràmetres, es pot fer simplement una redirecció
#REDIRECT [[Global Infobox person]]
- Si a més es volen utilitzar paràmetres manuals en llengua local o altres operacions de preparació de continguts manuals, veure la secció Pre-infotaula.
- Canvi del text que es mostrarà a les etiquetes
La Global Infobox recupera a cada utilització la versió local de les etiquetes que es troba a la /Tab exception.
- Crear o actualitzar l'entrada corresponent de la
/tab exception
indicant el <label a mostrar> dins l'expressió|<codi>=<nom local>;<label a mostrar>
. El <label a mostrar> pot ser un codi Pnnnnn o Qnnnnnn de WD, del qual extreurà el valor del label de la llengua corresponent, o bé un text directe. Si cal amb sintaxi wiki (enllaços interns, cursiva, etc.)
- Canvi de les unitats de mesura
La Global Infobox recupera a cada utilització la versió local de les unitats de mesura que es troba a la /Tab exception.
- Crear o actualitzar l'entrada corresponent de la
/tab exception
indicant el <Qid de la unitat> dins l'expressió|<codi>=<Qid de la unitat>
. El format del <codi> ésunitPnnnn
, on Pnnnn és la propietat de la que es vol indicar la unitat de mesura; la unitat s'indica amb el Qid que la defineix a WD.
Pre-infotaula
La pre-infotaula és una capa de codi on es poden fer les adaptacions que es desitgin per ajustar el funcionament de la Global Infobox a nivell de la plataforma. Permet:
- fer que la crida a la Infobox sigui amb un nom local.
- fer que es puguin utilitzar noms de paràmetres en llengua local, mitjançant el tractament d'equivalència entre el nom de paràmetres locals descrits a la
/tab exception
i els noms de paràmetres corresponents, descrits més amunt. - fer altres modificacions de continguts manuals abans de ser processats per la infobox.
La creació i manteniment de la pre-infotaula correspon als administradors de cada plataforma.
- Utilitzar paràmetres manuals amb nom en llengua local
- Crear o actualitzar l'entrada corresponent de la
/tab exception
indicant el <nom_param> que es desitgi dins l'expressió|<codi>=<nom_param>
- incorporar dins el codi de la pre-infotaula la preparació de traspàs del valor amb el següent codi:
{{Global Infobox person | val_Pnnn = {{{val_Pnnn|{{{<nom_param de /Tab_param>|{{{<nom_param de /Tab_exception>|}}}}}}}}} | val_M_<nom_param de /Tab_param> = {{{val_M_<nom_param de /Tab_param>|{{{<nom_param de /Tab_param>|{{{<nom_param de /Tab_exception>|}}}}}}}}} | .. ... }}