Viquiprojecte:Adaptació de plantilles a Wikidata/multilingüe/Notes per gl/Geografia política

Aquesta pàgina recull el projecte d'implantació de la {{Infotaula geografia política}} dins Galipedia (GLwiki), a petició de Breogan2008 i publicat a la Taberna el setembre de 2023.

Situació de partida

Els articles de geografia política de GL estan repartits en una cinquantena de plantilles. Els orígens de la majoria d'elles deriven d'ESwiki.
GL té instal·lada una versió antiga de mòdul:wikidades que han reanomenat com WikidataFichas i és utilitzada de forma parcial per diverses infotaules, moltes d'elles de categoria específica.
El pla que proposem és:
- Mantenir com està el WikidataFichas per tal que segueixi fent de servidor del grup de plantilles que el tenen.
- Instal·lar el Wikidades, sense canviar-li el nom ni fer-li modificacions que l'allunyin del màster per poder seguir facilitant la seva actualització quan hi hagi canvis.
- Fer la instal·lació de Infotaula geografia política com es descriu a continuació i comptar amb la metodologia i joc d'eines que permet la instal·lació futura d'altres infotaules transversals.

Full de ruta

(hi ha una pàgina paral·lela a aquesta amb les activitats de GLwiki)

Inventari orígens
- Identificar funcionalitats o paràmetres no coberts pel codi "màster" (GLwiki)
Canvis a fer al codi màster per internacionalitzar-lo i facilitar traspàs a GL. (CAwiki)
Identificació i acord de noves funcionalitats a incorporar al màster (CAwiki)
- codis geogràfics ? (GLwiki)
Implantar els 2 punts anteriors a Infobox political geography, Infobox political geography/formatglobal, Infobox political geography/codes (CAwiki)
- Crear o actualitzar valors requerits a module:itemgroup (CAwiki)
Inventari mòduls i plantilles requerides pel codi màster (CAwiki)
Comprovació de compatibilitat de mòduls i plantilles amb pre-existents a GL (CAwiki) + (GLwiki)
- Realitzar canvis necessaris i fer proves de compatibilitat amb utilitzacions (CAwiki)
Construir diccionari de noms de paràmetres locals vs codis interns (GLwiki)
- Crear pre-plantilles i redireccions (GLwiki)
Crear sub-funcions inicials de Wikidades per GL (/i18n /labels /units) (CAwiki) + (GLwiki)
- Personalitzacions de module:Itemgroup, Templatestyles i subfuncions Wikidades
- Traducció de textos fixes. (GLwiki)
- ~~mòdul:location ??? (CAwiki)~~
Instal·lar a GL i superar proves (CAwiki) + (GLwiki)

2. Canvis a fer al codi màster per internacionalitzar-lo i facilitar traspàs a GL.

La {{infotaula geografia política}} té una versió molt estable i fa temps que no se l'hi ha fet una modernització per facilitar la internacionalització.

La infotaula de referència en quan als mecanismes que anem a implantar és la {{infobox event}} i {{infobox event/formatglobal}}, que és el màster d'{{infotaula esdeveniment}}.

Canvis/millores a fer:
Acció	Voluntari	Comentaris	Resultat
Crear Infobox political geography, Infobox political geography/formatglobal, Infobox political geography/codes, a partir d'una còpia de la versió actual (de noms en català) sobe la que farem tots els canvis descrits en aquesta secció.	Quelet	On cal crear-la? @Quelet: a CAwiki. Anem a fer "internacionalitzable" l'actual infotaula, començant per tenir una nova versió en anglès.	Traducció de comentaris alcodi ca->en Fet! Traducció de topònims dins dels comentaris TBD
Identificar paràmetres manuals que han quedat obsolets o sense ús pràctic. Fer llista per comentar la supressió del seu tractament. Eines: Cerca per nom de paràmetre, ex.: malnom: `insource:/malnom = / hastemplate:"Infotaula geografia política"`	amador		Eliminats +250 paràmetres, molts d'ells comodins que no es feien servir.
Cercar possibles propietats per allotjar paràmetres manuals amb contingut d'interès. Fer llista del casos identificats, analitzar els valors més habituals que ja hi existeixen per validar que es tracta del mateix concepte que el que volem integrar i analitzar els qualificadors que es fan servir per decidir quins incorporarem a la nova crida a WD. Eines: A la pàg. de discussió de la propietat trobarem una query construïda per cadascuna d'aquestes dues consultes.	amador		+ P2670, per nombre subdivisions circumscripcions i escons parlament, Fet!
Crear TemplateStyles per Infobox political geography i adaptar els paràmetres de style de la crida a Infobox que hi ha . Eines: Veure cas real a Infobox event/formatglobal i template:Infobox event/styles.css	amador	quasi igual a template:Infobox event/styles.css, llevat del color background	Fet!
Corregir codi per tal que el valor "NONE" del paràmetre manual comporti la "no recuperació de dades WD" i, òbviament, no surti tampoc el valor manual. Podem trobar-nos tractaments amb "noWD"; això correspon a un tractament antic que comportava validar-ho abans de fer la crida WD. Actualment el mòdul:Wikidades ignora la crida que li han fet si el paràmetre `value={{{nom parametre\|}}} = NONE,` simplificant el codi de la infotaula en evitar haver de filtrar prèviament l'existència del NONE.	amador		Fet!
Identificar l'ús de valors constants dins el codi. Ex: Qid en una comparació o com a whitelist/blacklist dins una crida a wikidades, una imatge que es fa servir d'icona, etc. Tots aquells valors que pugin ser objecte de personalització per part de la WP han de desaparèixer del codi i ser traslladat al module:Itemgroup.	amador	blacklist_layer (Q94979808) a Munta_mapa: whitelist Curs d'aigua (Q355304), default marker-color5 (7e7e7e), default stroke4 (0000FF), default marker-color7 (FF0000), mida_mapa (170) a Mapes localització: default mida_mapa (300) a Infobox_political_geography: `no_image_categ`, per indicar si és vol categoritzar (i on) els articles sense cap imatge.	Fet!
Reanomenar paràmetres manuals per vincular-los amb les propietats i no amb els noms en una llengua concreta. Pels casos on no hi ha una propietat associada, fer servir un text en anglès. Veure model a infobox event. Anar confeccionant una taula d'equivalències similar al codi de {{Infotaula esdeveniment}} que ens farà la funnció de "pre-infotaula" per traduir els paràmetres des de la llengua a la nomenclatura interna.	Quelet		Fet!

3. Identificació i acord de noves funcionalitats a incorporar al màster

Noves funcionalitats
Acció	Voluntari	Resultat
Imatge principal amb carrusel ({{Switcher2}} amb Vista aèria (P8592), Imatge (P18), Fotomuntatge (P2716), Vista panoràmica (P4291), Vista hivernal (P5252). Ex.: a {{Infotaula indret}}		Fet!
Protegir crides Wikidades amb `shownovalue=no` i `showsomevalue=no`quan es recuperin imatges, per evitar mostrar resultat que no són una imatge		Fet!
Eliminar us {{una o dos imatges dins infotaula}} per {{Multiple image}}, amb aquest codi: special:diff/32543056 ~~!!!! abans cal crear, provar i analitzar impacte en ''legacy''~~	Amador	Fet!
Poder deixar de mostrar els headers intermedis a nivell de plataforma. Paràmetre de configuració `header_to_show` instal·lats a Itemgroup/groups		Fet!
Enllaç a article de llista d'eleccions des de la Llista de l'element (P2354)		Fet!
Incorporar bloc de Protecció patrimonial		Fet!
afegir-ne més....

5. Inventari mòduls i plantilles requerides pel codi màster

Els mòduls i plantilles comuns utilitzats per diverses components de la WP estan inventariats a la pàgina d'adaptacions per a GL.

Hi ha poques diferències entre la versió GL i la CA. El resum de les modificacions a fer són degudes a canvis de noms de mòduls comuns, pràctica desaconsellada a "funcionament genèric", i a desactualitzacions en mòduls bàsics que requereixen un anivellament als requeriments de la versió màster de CAwiki. Veure el detall a pàgina d'adaptacions per a GL.

A la taula següent hi ha la llista específica de Infotaula geografia política.

Bloc específic
Requeriment	GL	WD
Template:Infobox political geography	copiar de cawiki
Template:Infobox political geography/codes	copiar de cawiki
Template:Infobox political geography/formatglobal	copiar de cawiki
Template:Infobox political geography/styles.css	copiar de cawiki
Template:Infobox political geography/ús	copiar de cawiki
Template:Infobox political geography/example intro	copiar de cawiki
Template:Heritage protection/P1435	copiar de cawiki
Template:Heritage protection/prepare	copiar de cawiki
Template:Heritage protection/showblocks	copiar de cawiki
Template:Heritage protection/colors	copiar de cawiki
Template:UNESCO heritage region	copiar de cawiki
~~template:Posaunitat~~	Integrar dins codi ?

8. Crear sub-funcions inicials de Wikidades per GL

TemplateStyles

Les TemplateStyles són un instrument que, en format de plantilla, emmagatzema definicions de classe CSS per a ser utilitzades des de pàgines i plantilles. El seu codi és prioritari al que figuri a MediaWiki:Common.css. Per tant, evita haver de modificar paràmetres que pertanyen al conjunt de la WP i poder-los personalitzar sense haver de fer-ho dins el codi de la plantilla que els fa servir. Una TemplateStyles pot estar compartida per diverses plantilles, no obstant això, a CAwiki en fem servir una per cada infotaula que, partint d'un mateix patró per mantenir una homogeneïtat d'estils, poden ser personalitzades sense dependències entre elles.

En el cas de les TemplateStyles d'infotaules han de tenir una definició per cada classe de les que entén i aplica el module:Infobox, que és qui construeix físicament l'estructura HTML (infobox_bodystyle, infobox_titlestyle, infobox_headerstyle, infobox_subheaderstyle, infobox-label, etc.) . A més a més, es poden afegir altres classes amb els styles que siguin requerits específicament per la infotaula que la faci servir. Un exemple d'aquest cas és la Infobox_election/styles.css on a més dels estàndards d'Infobox, fa servir txtquestion i topbarcandidate per un text i una barra específica d'aquesta infotaula.

Les infotaules de CAwiki incorporades en altres WP són personalitzables en el seus styles (colors, tipus i mida de text,..), modificant la seva còpia de TemplateStyles, sense haver de modificar el codi de la infotaula.

La versió de partida a copiar amb els mateix nom és Plantilla:Infobox political geography/styles.css.