Viquiprojecte:Adaptació de plantilles a Wikidata/multilingüe/migració infotaules a V5/Construcció eines instal·lació

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, tractament de propietat sense generar "alt" descriptiu. En aquest cas, la raó és evitar una col·lisió amb la barra d'àudio	param	P990	voice_recording	Q53702817	no			| P990 = voice_recording;Q53702817;x;;
	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	L_family	<sempre BUIT>	Q8436				| L_family = ;Q8436
S	S_unitPnnnn, per indicar que conté la unitat de mesura en que es vol mostrar la Pnnnn	param	S_unitP2048		Q11573	<sempre BUIT>			| S_unitP2048 = ;Q11573
	utilitzar "peus" com a unitat de mesura	excep	S_unitP2048		Q3710				| S_unitP2048 = ;Q3710
	S_collapsePnnnn, per indicar que conté el valor per plegar la llista de la Pnnnn	param	S_collapseP166		180				| S_collapseP166 = ;180
	plegar llista premis si ocupen + 250 bytes	excep	S_collapseP166		250				| S_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. El primer és més mnemotècnic, 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> és unitPnnnn, 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>|}}}}}}}}}
| .. ...
}}