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

@Vriullop @Joutbis @Paucabot  @Jmarchn @Townie. Afegeixo l'Eugeni (@Kette~cawiki) aprofitant la seva tornada de les vacances viquipèdiques. Si no saps de que va, quan comencis a llegir ho aniràs captant.

Fa un mes us vaig passar un missatge en aquesta discussió ("Eina de preparació per la instal·lació") amb una pàgina que havia preparat per a futurs subscriptors del sistema. En Paucabot va dir que no s'entenia sense context, cert!. Ara ja està prepara't i us ho presento.

A banda, el model que havia dissenyat (pre-infotaula que endreça tot + infotaula molt més parametritzada) tenia 3 solucions:

• la que jo havia construït (sòlida però manual i barroca)

• la proposta de Joutbis (descrita al missatge "sintaxi" en aquesta mateixa discussió), que eliminava la pre-infotaula generant informàticament un codi d'infotaula "ad-hoc" per cada subscriptor que incorporava les funcions de localització. En aquest cas, personalment penso que és massa depenent d'un procés extern.

• la proposta de Jmarchn que, seguint el disseny inicial, ha creat una pre-infotaula LUA que té un codi més estructurat i pseudo-comú per totes les infotaules ja que treballa a partir d'un diccionari d'arguments i etiquetes. Això permet que els canvis es facin modificant taules dins el codi de la pre-infotaula, si el que volem és afegir nous paràmetres, o bé a la i18n si es tracta de fer localitzacions d'etiquetes o de noms d'arguments en llengua local.

De moment, aquesta 3a. opció és a la que m'he estat dedicant (i el Jordi fent-la, és clar) i m'agradaria comptar amb les vostres opinions.

Per explicar-la millor que al meu darrer missatge, he refet un document que alguns havíeu vist en versions inicials, però que ha canviat totalment i caldria llegir-lo novament.

Ens ha de servir per explicar les "Global infoboxes" en general, si bé es basa en la "person" que és la que tenim. S'adreça a gent nova que no treballa amb les nostres infotaules (que es podran saltar la "Introducció") i pels que parteixen de les nostres versions i els diem que la canviarem. També explica a alt nivell com funciona, quins elements la componen i que caldrà fer per instal·lar-la. És un document vàlid per tenir una idea general, per que altres WPs puguin avaluar si els interessa instal·lar-la i fer-se una idea de la facilitat de la instal·lació.

No s'inclou aquí el manual detallat d'instal·lació, ni el manual d'utilització per editors d'article.

Què voldria que féssiu?:

1. Dir si el document comunica correctament això que us he explicat.
2. Donar la vostra opinió sobre la solució proposada. Ja us aviso que a mi em va costar molt entendre el que ha fet el Jordi, suposo que condicionat d'on partia jo i per la meva ignorància en LUA. Però el que valoro molt d'aquesta opció és la industrialització del procés de creació i la quasi total parametrització. Aconsegueix, en la seva funció de pre-infotaula, el mateix que jo perseguia amb les Global infobox: independitzar codi i contingut (paràmetres, etiquetes i noms locals) i, intentar ser menys depenent de l'autor.
3. La vostra opinió sobre els materials que es referencien i fan de suport a la preparació: Diccionari, llista de dependències, etiquetes a traduir, etc. En aquest punt, segur que falta molt, com ara pensar en l'eina que comentava en Joutbis per mantenir les dependències, ja que el procediment que he seguit és absolutament artesà.
4. Tot allò que vulgueu saber o afegir.

Gràcies per la vostra atenció.

Si l'objectiu és vendre la solució i que altres viquipèdies ho adoptin, crec que el document dóna massa detalls tècnics i fa poc èmfasi en els avantatges. Normal, tu els avantatges els dones per sabuts, perquè ja no ens fa fred ni calor que en un article buit, amb una sola línia de codi t'aparegui una infotaula amb la vida i miracles de la persona. Però per un que ve de fora, això és màgia pura!

Jo crec que hi ha tres coses a comunicar, per ordre:

• el què: el més important; perquè aquestes infotaules són una passada, i què hi guanyo si s'instal·len a la meva viquipèdia.
• com ho instal·lo: tasques a fer per personalitzar la infotaula a la meva viquipèdia. Però això, en un altre document. Si no, ens trobarem que TL;DR.
• com està fet: això només interessa als que vulguin col·laborar en el desenvolupament. Més amagat i totalment opcional.

Per exemple, llegint-ho, encara no em queda clar si un canvi a la infobox global es propagarà automàticament a totes les viquipèdies que ho facin servir, o s'haurà de fer alguna acció.

Sobre la solució, sense entrar en els detalls, fa bona pinta. Els principis de disseny que heu adoptat són correctes; però això importarà a un percentatge petit de gent, desenganyem-nos. El lloc dels informàtics és a la sala de màquines. Els usuaris d'un pont només saben si és pràctic i si és bonic; no els importa amb quins materials està fet, si costa de mantenir, ...

Sobre el diccionari, i resta de materials: no m'ho he mirat amb detall; sembla més una referència que un tutorial; però ja hi serem a temps a anar-ho polint.

Un altre tema que s'haurà d'abordar tard o d'hora és la feina d'adaptació de les plantilles que hi hagi actualment en una viquipèdia al nou format. En una viquipèdia mínimament establerta, ja tindran les seves infotaules.

• L'ideal seria que llencessin el codi actual i passessin a utilitzar el global, traduint els paràmetres per guanyar compatibilitat.
• O poden voler crear les noves infotaules, i qui vulgui que les utilitzi, o que vagin fent migracions manuals o amb un bot.

Si volem que optin pel primer, hem de pensar un sistema que permeti fer proves prèvies per perdre la por i comprovar la compatibilitat absoluta.

Penseu que aquesta serà la primera pregunta que ens faran; l'hem de tenir preparada.

Felicitats!

Hola!

Dels teus dubtes no entenc això de que es "propagarà automàticament", cal copiar uns mòduls i finalment les plantilles. Caldrà traduir a l'anglès les instruccions.

Si l'explicació que ha donat l'Amador és massa tècnica, val més que no et llegeixis l'explicació específica del mòdul que serveix per fer infotaules (Mòdul:Multilang infotable tools).

Però t'equivoques: l'explicació no va adreçada als usuaris, va adreçada als administradors. L'usuari, si vol, només ha d'escriure {{infotaula laquesigui}}.

De dues objeccions teves, el sistema està totalment pensat per:

• Fer proves i per traduir (adaptar) fàcilment paràmetres ja existents.
• Una vegada introduïda la taula s'envien a una categoria el nom dels articles que tenen problemes, per exemple amb un nom de paràmetre desconegut.
• Per afegir paràmetres inexistents.

Pots veure el Mòdul:Infobox person.

Mentrestant ja tinc pràcticament a punt dues infotaules per posar en marxa en la nostra Viquipèdia: Mòdul:Infobox disease i Mòdul:Infobox medical intervention, però que són totalment en lua.

Finalment les explicacions s'han de millorar, però el pitjor que li pot passar a algú que vulgui instal·lar aquestes infotaules, no és que sigui tècnica l'explicació, sinó que no trobi el que vol saber (i ho dic per experiència).

D'acord que s'ha de vendre bé el producte, però per això s'ha de posar en marxa a la nostra Viquipèdia....

Bona nit, que les neurones ja no donen per a més...

Perdoneu si no m'he explicat bé. No són objeccions per implementar-ho a la Viquipèdia. Jo això ho donava per fet. Teniu tota la confiança. El que entenc que és l'objectiu és escampar-ho a les altres viquipèdies, que parteixen de zero i no coneixen aquestes plantilles. El meu comentari, agafeu-lo com a suggeriments per fer un millor màrqueting, i prou.

Posa't a la pell d'una viquipèdia més o menys establerta (no cal que sigui de les grosses), i pensa quina serà la reacció si li venen amb aquest suggeriment: uf, quina mandra, canviar les infotaules més importants ... Per això, el primer és deixar clar què es guanya, i oferir-los una via transitable per migrar-hi. Els que vulguin mirar a sota el capó, que seran poquets, ja hi parlarem, i estarà bé que tinguin documentació. Però ara em centraria en pur màrqueting.

Jo veig que aquí fa temps que tenim un Fórmula 1: un cotxe amb unes prestacions immillorables, però que per collar un cargol necessites un enginyer (un de concret que el seu nom comença amb A, no qualsevol enginyer). El que esteu fent ara és adaptar-lo a fer producció en cadena, amb les mateixes prestacions. Però per vendre'l, hem d'explicar-lo. Dels mecànics, ja en parlarem...

Una cosa que a mi em preocupa és la propagació. A mi em fa molt respecte tocar una plantilla, poques vegades ho he fet. Imagina't que toques una plantilla d'aquestes globals, i automàticament fas modificacions no sols a la teva viquipèdia, sinó en 10 o 20 més. Què faràs? Aniràs a totes a comprovar que no has trencat res? Uf, quina por. Jo havia pensat més aviat encarar-ho com un desenvolupament obert. Els desenvolupadors van canviant coses tranquil·lament, i quan l'usuari necessita la nova versió se la baixa controladament.

Anem parlant, i compteu amb mi per repassar documentació i traduir a l'anglès.

No solament, el projecte, és per a Viquipèdies que no tenen aquestes plantilles i que parteixen de zero, també serveix per a Viquipèdies que ja les disposen i els hi pugui semblar fantàstic que es prenguin els valors de WD, i així completar elements que, manualment, no s'havien omplert.

Et prenem la paraula per a la traducció, el meu nivell d'anglès és sols intermedi (de l'"insti" de fa 45 anys)!.

Exacte. Però aquest camí l'hem fet a la Viquipèdia al llarg de ben bé cinc anys, amb canvis incrementals i per l'empenta de l'Amador. Ara anirem a oferir a la gent el producte final, que és sensacional, però que és un salt molt gros. Hem de fer-los perdre la por.

Però pas a pas, que unes quantes infotaules funcionin bé en la nostra Viquipèdia.

@Joutbis @Jmarchn Sobre el tema "propagarà automàticament". Jo el que tinc al cap és la idea primigènia del projecte "Global templates" Què deia que aquells mòduls i plantilles que fossin transversals podien residir en un espai comú, a les quals les WP es podrien subscriure (per cada element independentment). Cada cop que la còpia comuna canvies, es faria automàticament un refresc de la còpia local, sempre que no l'haguessis modificat pel teu compte.

Dic "idea primigènia", perquè veig improbable que el projecte evolucioni en la línia d'aquesta definició, ja que assumeix que les peces són autònomes i no queda clar com resoldre les diferències de versió quan hi ha dependències. Però el que em queda clar és que aquest hauria de ser el funcionament a tenir amb el "set" d'elements propis de la infotaula, és a dir, totes les peces que hem creat per a què aquesta funcioni i, en principi, no seran requerides de forma separada, fora de l'àmbit del projecte "Global infoboxes". Al voltant d'aquest "set" hi ha una segona corona que són molt més comunes i transversals i que les WP poden tenir versions preexistents iguals o diferents. Amb aquestes, cal tenir una còpia "certificada compatible" amb el nostre "set" que està en un espai comú. L'origen d'aquests elements és el més comú (i compatible) que haguem trobat. D'aquesta forma, la probabilitat d'incompatibilitats, baixa. Però, si algú té una versió que dient-se igual, no fa el que ens cal, s'ha de gestionar el conflicte a la WP afectada, amb una possible duplicitat amb redireccions.

Actualment, tenim la "còpia instal·lable" a l'espai WD (bé, el nostre set està desactualitzat i funciona amb la versió de pre-infotaula que vaig fer jo, anterior a la que presentem). La majoria d'elements de la "corona" són compatibles i, on ha calgut, hem ajustat la nostra versió que sovint era la que s'havia quedat enrere. Algun cas (ex.: module:infobox) s'ha hagut de reanomenar i fer una redirecció a casa nostra. Per contra, hi ha casos amb una versió local diferent que ens afavoreix (ex.:coordinates), ja que funcionalment són iguals a la versió certificada, però tenen una personalització en la forma de presentar les dades (W de west, per O d'oest, per exemple), la qual cosa estalvia feina a la nostra i18n.

Perdoneu l'extensió.

@Joutbis Tens raó en l'enfocament massa tècnic, però primer havia de convèncer / explicar-ho als de dins; començant per vosaltres. Amb aquesta idea, aniré pensant una reformulació del contingut.

Merci per la resposta.

Primer, haig de confessar que no m'ho he pogut llegir, només diagonalment. Moltes coses ja les hem parlat i confio que la solució final serà la bona.

Entenc en Joutbis. Tenim ja una experiència prèvia amb 18 wikis que ho estan usant. La majoria simplement ho han copiat tot, sense cap traducció, i el que realment volen és poder usar una plantilla tipus Autoinfobox i despreocupar-se'n. El seu únic problema és saber exactament què han de copiar. Si ja tenien alguna versió prèvia no els tremola la mà per matxacar-la. En dos dels casos han acabat abandonant per trobar-se amb una cadena interminable de dependències.

Només en dos casos hi han intervingut tècnics que han entrat al detall fent-hi modificacions. Les plantilles que ja tenien les han mantingut i les han anat adaptant. Només volien l'estructura base del mòdul i saber com usar-lo.

Això continuarà passant. Molts que només volen un plug&play i d'altres que no volen tabula rasa.

L'actualització dels 18 la faig manualment. Hi ha canvis que no són compatibles. Sempre hi ha algun canvi que ha d'anar coordinat. Per una cosa com canviar la sintaxi d'un paràmetre cal fer primer una versió compatible, un rastreig de l'ús i els canvis corresponents en plantilles. A banda hi ha els forks. Una opció és abandonar-los per incompatibles, però abans que em preguntin res, per què surt un error i alguna cosa que no funciona, prefereixo actuar sobre la darrera versió. Per mig hi poden haver correccions diverses.

En resum, en la línia d'en Joutbis, cal una pàgina inicial publicitària, unes instruccions plug&play, unes instruccions sobre configuració per a usuaris avançats, una explicació tècnica d'aprofundiment per a desenvolupadors, una pàgina central de discussió, ajuda i peticions.

Merci, @Vriullop. M'has fet la meitat del guió de la nova documentació.

@Vriullop (A/B) @Joutbis @Paucabot (A/B)  @Jmarchn @Townie (A) (@Kette~cawiki). Coneixeu qui és la gent que sap LUA ?. O a qui l'interessaria dedicar-se més intensament a les infotaules ?.

Estava pensant que hauríem de saber amb quines forces comptem per atendre tot aquest canvi, perquè una de les raons del canvi és, alhora, fer-ho més transversal per a què hi participi més gent.

Però primer hauríem de conèixer interessos i capacitats actuals.

Si teniu info, compartim-lo per començar a treballar.

Merci

Aprofito una conversa iniciada a la discussió d'en @Paucabot per respondre-li aquí, ja que el contingut de la meva resposta pretén millorar la comprensió del tema que ens ocupa. Com he dit en algun moment, si no ho enteneu vosaltres, més els hi costarà als que mai han sentit del tema.

Potser hi ha coses que he donat per sabudes per vosaltres i no ho hauria d'haver fet:

• Tema: Infotaules multilíngües.

• Situació actual: les infotaules de cawiki poden mostrar tot el seu contingut (labels i dades) en altres llengües
• Objectiu: Estar en condicions d'estendre les nostres infotaules a d'altres WPs, sense que els seus administradors hagin de tocar el codi principal per fer adaptacions per motius de llengua.

• Funcionalitats per evolucionar la versió actual:
  • Tractament dels paràmetres manuals en altra llengua, de forma que la seva personalització es pugui fer localment.
  • Millorar certes limitacions en la traducció i personalització de les etiquetes. També personalitzat localment.
  • Facilitat d'instal·lació. Actualització de noves versions d'aquelles WPs que no hagin derivat a versions pròpies.
• Gestió:
  • Atendre peticions de millora de la versió central (actualment cawiki), que aportin valor al conjunt. Els canvis es gestionaran unificadament per a tots els subscriptors.
  • Qualsevol WP pot fer els canvis que consideri oportú, començant la seva autonomia funcional i de manteniment.

---

• Solució tècnica proposta:

Amb independència que penseu que això no ven o que no és per certs perfils o que no toca ara, la pregunta és S'entén aquest gràfic ?.

• Si s'entén, els detalls són a Descripció Globa infoboxes. Ja veurem a quin document ha d'anar o per quin target s'ha d'explicar.
• Si no s'entén, si us plau, concreteu-me una mica més o expliqueu que sobra/manca.

Moltes gràcies per la vostra ajuda

Jo no entenc l'esquema:

• No sé quan estam xerrant de mòduls, quan de plantilles i quan de grups de plantilles. Els noms que apareixen són els noms de cada mòdul o plantilla?
• No entenc què hi fa el teclat i les fletxes.
• Els textos (customization block i core code) estan escrits en clau de qui ha fet la proposta (ex:convert local parameters to global ones) i costen d'entendre. Potser sense aquestes ajudes, l'esquema seria més clar. En realitat això de diferenciar entre core code i customization block no és gaire significatiu si no ets enginyer de programari. Si vols implementar el sistema, només t'interessa diferenciar entre els peces blaves, iguals per tothom i les peces verdes, el que hauran de personalitzar a cada wiki.

No és una presentació (ni un esquema) de Global infobox person, sinó de la solució proposta pe totes les Global infobox. En algun lloc ho diu. Per tant, als noms els hi falta un sufix, quan siguin casos reals. No he distingit entre mòdul i plantilla, precisament, per no embolicar-ho més. El teclat indica quin és l'origen, per quin element comença. Potser no és el més indica. Les fletxes indiquen el flux de control. Si m'hi he esforçat en separar el bloc esquerre del dret, bé havia d'explicar per on connecten. Si no volem separar pre-infotaula de nucli central, doncs tant se val.

He fet dos intents per simplificar l'esquema: https://postimg.cc/ZChB87Tt

En el segon, més simple, he unificat les dues plantilles (que tu anomenes pre-infobox i global infobox) en una (Infobox), he eliminat les subplantilles i no he posat /output global, que no sé que fa.

Un esquema com el que dius té sentit per un primer nivell. Però tard o d'hora els hi hauré d'explicar totes les peces que té l'invent i que ells hauran de conèixer i instal·lar. Recordo que ja m'he disculpat per barrejar tots els materials en un document.

Ningú s'ha de disculpar de res. Aquí estam fent propostes de millora. Jo usaria un esquema més similar al primer meu per ser exhaustius amb totes les plantilles i mòduls i un esquema més similar al segon per a vendre el producte.

és la idea que tenia.

Per cert, que en ares de la simplificació, canviaria customizable per local.

sí.

Merci. Faré les adaptacions i a un nivell més alt.