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ó 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 extraurà el valor del label de la llengua corresponent, o bé un text directe. Les etiquetes obtingudes amb un codi WD sempre són un text sense enllaçar. Si es fa servir l'opció de text directe, pot incorporar sintaxi wiki (enllaços interns, cursiva, etc.)

Canvi de les unitats de mesura

La Global Infobox recupera 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 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.

Cas de no fer servir /Tab exception, aplica convert=default (veure Mòdul:Wikidata/ús#Paràmetres_de_formatació).

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>|}}}}}}}}}
| .. ...
}}