Arxius de traducció

Hi ha dos tipus d'arxius per a la traducció de Drupal. Tots dos tipus d'arxius són de text, amb un format especial: els .po i els .pot. Els .po són els arxius que contenen la traducció pròpiament dita, i que importarem al drupal des de la pàgina corresponent del mòdul 'locale', mentre que els .pot són les plantilles a partir de les quals es poden generar els arxius .po.

Podrem obrir aquests arxius amb qualsevol programa de text però si volem treballar més còmodes necessitarem un programa d'edició d'arxius .po. En trobareu una llista a http://drupal.org/node/11131. Assegureu-vos de llegir la pàgina d'incidències si useu poEdit de windows

Les traduccions a Drupal.cat

Equip de traducció

Objectiu

L'objectiu de l'equip de traducció de Drupal és disposar d'aquest programari completament en català, tant el nucli com els seus mòduls. Així, els esforços de traducció s'haurien de centrar en traduir en el següent ordre:

* Traduir el nucli de Drupal.
* Traduir els mòduls més utilitzats o catalogats com a imprescindibles.
* Traduir la resta de mòduls.

I sempre centrant els seus esforços en la darrera versió d'aquest sistema.

Detecció de necessitats

Abans de traduir res cal saber quines són les necessitats reals, és a dir, quins mòduls no estan traduïts al català ni s'estan traduint actualment.

Si existís alguna forma de gestionar les necessitats de traducció dels mòduls de Drupal al servidor de traduccions (com per exemple mitjançant incidències i assignacions d'aquestes) no caldria fer cap tipus de procés de coordinació; però actualment, això no és possible, i per tant, cal establir una metodologia per a la coordinació, tant de traduccions com de necessitats.

* En principi els membres de l'equip de traducció són a la vegada usuaris de Drupal, i per tant, poden fer un seguiment de quins mòduls no estan traduïts al català.
* Cal disposar d'un llistat on s'indiqui l'estat de traducció dels mòduls en que es vagi treballant, així com les versions afectades. D'aquesta manera, els traductors podran saber en què han de treballar i indicar-hi si hi ha algú treballant-hi o no. El procediment per anar construint aquesta taula pot ser el següent:
* La gent detecta un mòdul que creu que hauria d'estar traduït al català i ho comunica a l'equip a través del fòrum o bé edita directament la taula.
* La persona responsable del manteniment de la taula hi afegeix el nom del mòdul.

Coordinació

Com la plataforma de traducció de Drupal no permet una coordinació explícita de les traduccions, cal crear un mecanisme per a dur-la a terme.

L'artefacte per a la coordinació de traduccions és la llista de traduccions completes, pendents i en progrés.

Glossari

S'ha creat un glossari de termes que podem trobar habitualment a la interfície de Drupal. Aquest es pot complementar amb d'altres termes que es creguin interessants, així com encetar una discussió sobre alguna traducció d'algun terme que ja existeixi o que s'hi vulgui afegir.

Cicle de vida de les traduccions

Abans de tot, cal tenir en compte que el sistema amb el que Drupal usa les cadenes fa impossible acotar-les a un únic mòdul, ja que estan compartides per tots ells, de manera que es pot aprovar una traducció per a un mòdul que no hauria de perquè ser correcte per a un altre. Això és un problema que no podem solucionar ara com ara fins que no s'integri un sistema de contexts.

Tot i que el procés de traducció és molt flexible i permet que qualsevol se l'adapti a la seva manera de treballar, hi ha un cicle de vida de la traducció que sempre serà el mateix:

* El traductor troba quelcom per traduir i ho comunica al fòrum o edita la llista per assignar-se el mòdul. En cas que no hi hagi ningú més treballant en la traducció i que l'usuari no tingui permisos d'edició de la llista, un altre membre li assignarà la traducció.
* El traductor actualitzarà el llistat de traduccions (o bé afegint-hi la traducció si és nova, o bé canviant-li l'estat a "en progrés" si ja era a la llista).
* El traductor procedirà a fer la traducció segons el mètode que li sigui més convenient. És recomanat fer la traducció en local amb l'ajuda del mòdul Localization client i una vegada acabada, exportar-la amb l'ajuda del mòdul Translation template extractor i importar-la al l.d.o.
* Un cop acabada la traducció, el traductor actualitzarà l'estat al llistat de traduccions ("per revisar"). Igualment, pot escriure un missatge al fòrum o bé enviar un correu a algun administrador de traduccions per informar-ne.
* Un revisor comprovarà la traducció (canviarà l'estat a "en revisió"). En cas de trobar errors, el revisor pot modificar la traducció o bé declinar el suggeriment. Si queden cadenes per traduir, marcarà la traducció com "per completar". Això pot comportar que el traductor hagi d'aplicar canvis i enviar tornar a començar el cicle.
* Un cop el revisor hagi acceptat totes les cadenes, el mòdul es marcarà com a "pujat".

Enllaços

Guies de traducció

* Eines de localització de Softcatalà
* Guia d'estil per a la traducció de programari de Softcatalà

Referència

Llengua

* Glossari de termes de Drupal
* Recull de termes de Softcatalà
* Centre de terminologia TERMCAT
* Diccionari en línia de l'Institut d'Estudis Catalans (IEC)
* Diccionari en línia de l'Enciclopèdia Catalana
* Diccionari en línia multilingüe de l'Enciclopèdia Catalana
* Memòria de traducció de projectes de programari lliure
* Corrector ortogràfic de català de Softcatalà

Eines

* Manual del gettext (ordres per a l'edició i manipulació de fitxers PO, descripció de l'estructura dels fitxers PO)
* Descripció de l'estructura dels fitxers PO utilitzats en les traduccions.

Funcionament de Drupal

Drupal està dissenyat de forma modular per tal que siga fàcil d'ampliar i millorar. Açò vol dir que cada funcionalitat de Drupal és, més o menys, independent de la resta, llevat del que anomenem cor (CORE), que és la base de tot. Aquest disseny permet que varies persones traballen paral·lelament per ampliar Drupal sense que es produeixquen incompatibilitats. Evidentment aquesta modularitat no és extrema, i si que hi ha funcionalitats que depenen d'altres, d'altra manera es crearia codi redundant.

El mòduls són, doncs, funcionalitats de Drupal. Teòricament un mateix mòdul pot allotjar més d'una funcionalitat, però aquesta pràctica no és recomanable. Cada mòdul conté les funcions necessàries per tal d'acomplir la funcionalitat pertinent. Tots els mòduls han d'estar al directori "modules" de Drupal, podent tindre el seu propi directori al si d'aquest.

La comunicació entre el mòdul i el cor es realitza a través de "hooks" (ganxos, garfis, no sé com traduir-ho, però tots coneguem a peter-pan). Per explicar-ho senzillament, els hooks són les funcions del mòdul a les quals el cor intentarà cridar. Per exemple, existeix el hook anomenat "hook_help". Si nosaltres volguéssim implementar un mòdul i incorporar-hi un text per a l'ajuda, hauríem d'implementar una funció que s'anomenés "nommodul_help". Açò ja ens dona una idea de com podem utilitzar-los. Bàsicament la implementació d'un hook serà la creació d'una funció, el nom de la qual serà el nom del mòdul més un subratllat i el nom del hook a implementar (nommodul_nomhook). Durant tot aquest manual anirem explicant els hooks més important que hem de tenir en compte a l'hora de crear un nou mòdul.

Nota de l'autor:
Aquest manual anirà ampliant-se conforme jo vaja coneixent l'ús dels diferents hooks, o algú altre els explique.

Tipus de móduls

Per tal d'explicar la creació de mòduls m'ha paregut interessant classificar-los en diferents grups per tal de fer més senzilla l'explicació dels diferents hooks. Aquesta classificació no és oficial (és la que jo em faig personalment).

<

p>

Mòduls d'implementació de nodes

Són aquells que defineixen nous tipus de continguts. A Drupal cada unitat de contingut s'anomena node. Per tant una pàgina és un node, també ho són una enquesta, un event, un article, etc...

<

p>

Mòduls d'implementació de modificacions als nodes

Són aquells que en si no creen nous tipus de nodes, però modifiquen d'alguna manera els tipus existents. Per exemple, poden afegir camps a l'edició de nodes. El mòdul taxonomy pot afegir nous camps a l'edició d'un node per incorporar-hi temes. O el mòdul upload, que permet adjuntar fitxers a un node.

<

p>

Mòduls d'implementació de modificacions als usuaris

Són molt pareguts als d'implementació de modificacions als nodes, però enfocats als usuaris. A aquesta categoria podem trobar per exemple el mòdul profile.

<

p>

Mòduls d'implementació de filtres

Són mòduls per a la creació de filtres per a les àrees de text. Aquestos són els que permeten la introducció d'etiquetes especials al cos dels nodes per tal d'aconseguir algun tipus d'efecte, com ara d'incorporació d'imatges, de fitxers, o simplement l'eliminació de paraules malsonants.

<

p>

Mòduls d'implementació de modificacions d'APIs

Són mòduls que modifiquen d'alguna manera el comportament de certes funcions de les APIs, Personalment sols he trobat mòduls que modifiquen l'API dels formularis. D'aquest tipus serien tots els mòduls d'editors de text JavaScript.

<

p>

Mòduls d'implementació d'accés remot

Són aquells que implementen comunicacions bilateral amb altres webs, o aplicacions. Drupal implementa una API de comunicació XMLRPC, però probablement es pogués crear una nova API per a la comunicació SOAP, per exemple. Aquestos mòduls serien aquells que utilitzaren aquestes APIs.

<

p>

Mòduls d'implementació d'APIs

Aquestos mòduls afegeixen noves APIs a Drupal. Per exemple el conjunt de mòduls ecommerce, o el mòdul VotingAPI.

Hi ha altres tipus de mòduls que no m'he decidit a classificar, tant per la seua simplicitat, com complexitat. No obstant aquesta classificació és orientativa, i serà més una eina per classificar els hooks que per classificar els mòduls.

Els fitxers que composen un mòdul

Són tres els fitxers que composen un mòdul. No necessàriament s'han d'implementar els tres, i no necessàriament sols han de ser tres. Per mantenir certa organització és aconsellable col·locar tots aquests fitxers dintre d'un directori amb el nom del mòdul.

• El primer, el qual és imprescindible, és el fitxer .module. Aquest fitxer és el que conté l'implementació dels hooks. Sense aquest no hi ha mòdul.
• El segon, també és imprescindible a partir de la versió 5 de Drupal. Aquest és el .info. Aquest dóna informació sobre el mòdul. Per exemple el nom, el paquet al que pertany, o les dependències. Aquest fitxer fou introduït per primer cop a la versió 5 de Drupal.
• Finalment, el tercer fitxer és molt important si el nostre mòdul treballa amb les seues pròpies taules. Aquest és el .install. Amb aquest fitxer podem fer que Drupal cree les taules necessàries per fer funcionar el nostre mòdul. Aquest fitxer fou introduït per primer cop amb la versió 4.7 de Drupal. No obstant a la versió 5 de Drupal s'introduí el hook_uninstall, per automatitzar el procés de desinstal·lació.

D'altra banda el mòdul pot necessitar per al seu bon funcionament altres fitxers, com ara un .css o un .js. Més endavant veurem com fer referència a ells al sí del mòdul.