La traducció de la documentació

De KDE Català
La revisió el 19:50, 16 juny 2011 per Txemaq (Discussió | contribucions) (Petits canvis d'estil.)

Dreceres ràpides: navegació, cerca
Logo KDE.png

 cat >> KDE

  Ubicació: cat >> KDE Inici

La traducció de la documentació


Tot i que en fem un petit llistat, el procediment s'explica al The KDE Translation HOWTO.


Procediment

La documentació es crea originalment en format docbook (veure aquí), i es converteix a plantilles de catàlegs de traducció (fitxers .pot) per a facilitar-ne la seva traducció des dels catàlegs de traducció (fitxers .po). Quan aquests es consideren estables i abans de congelar-los, els traductors o responsables hauran de generar-ne els docbook corresponents i pujar-los al SVN (veure aquí) junt amb les captures de pantalla que hi estiguin relacionades.

La seva traducció implica tot un seguit de qüestions involucrades entre si:

ksgmltools2

  • S'ha de mantenir al dia el directori "kdelibs/kdoctools/customization/ca", que conté les entitats i parts comunes a tots els manuals d'aplicacions (p. ex. l'explicació del menú Ajuda, que és idèntic a totes les aplicacions).
NOTA: El contingut s'instal·la al directori $KDEDIR/share/apps/ksgmltools2/customization/ca en fitxers codificats amb UTF-8 (la codificació estàndard del KDE).
IMPORTANT: Assegureu-vos que el contingut es correspon a la mateixa versió del KDE amb la que esteu treballant.
  • Parlant d'entitats i parts comunes, us aconsello que us llegiu o imprimiu el contingut de:
  • $KDEDIR/share/apps/ksgmltools2/customization/ca/user.entities

Traducció

Com pretenem facilitar informació, més que duplicar-la, consulteu el procés de traducció.

Consell: Amb la referència d'ordres

En comptes de fer clic múltiples vegades sobre un menú per a consultar l'exactitud de l'entrada, fem servir el programa KSnapshot en mode de captura «Regió rectangular», i agafem una captura de pantalla de dit menú.

Això us permetrà visualitzar-lo alhora que traduïu. Naturalment, també us serà d'utilitat en mode de captura «Secció de finestra» per a tenir visible una pàgina de l'arranjament i l'aplicació sobre la que traduïu desbloquejada per a d'altres consultes.

Revisar l'ortografia

El seu ús és molt important però no cal explicar gaire. Useu el menú Eines -> Ortografia... amb el catàleg de traducció obert a la utilitat Lokalize.

Per a més informació consulteu el respectiu manual (Diàleg de verificació d'ortografia).

Usar l'eina pology

En breu.

Revisar la documentació en format HTML

Una vegada generats els fitxers DocBook a partir dels catàlegs de traducció executeu l'ordre «meinproc4 index.docbook» i es generaran tots els fitxers HTML necessaris pel manual en qüestió.

Ara visualitzeu el fitxer index.html (amb el Konqueror, Rekonq, Firefox, etc.) i navegueu pel manual tot revisant qualsevol incongruència en el text.

Captures de pantalla

Creeu-les seguint aquests consells i podeu usar aquest script:

#!/bin/sh
#
# S'han de seguir les regles
# «http://l10n.kde.org/docs/screenshots.php»

for i in *.png
 do
    pngnq -s 1 $i && optipng ${i%.*}-nq8.png && mv -f ${i%.*}-nq8.png $i
 done

Entreu a la carpeta a on es troben les imatges i crideu-lo des de la línia d'ordres (Només una vegada!). Aconseguireu imatges més comprimides i amb una pèrdua de qualitat assumible.

Estat de la documentació

També us encoratgem a emprar la interfície web per a saber com avancen les traduccions de la documentació:


Atentament

L'equip de traducció del KDE al català.