Capítol 4. Guia per a desenvolupadors del KHangMan

El fitxer usa el format kvtml. L'etiqueta <text> és per a la paraula i l'etiqueta <comment> és per al consell, totes dues dintre d'una etiqueta <entry>. Si us plau, intenteu fer coincidir el consell amb la categoria de dificultat. La categoria Fàcil requerirà un consell en conseqüència, de la mateixa manera la categoria Difícil potser requerirà ja la definició al diccionari. En el consell mireu de no emprar paraules dintre de la mateixa família, que puguin estar indicant amb facilitat de quina paraula es tracta!

Cal tenir en compte que haureu d'emprar la codificació UTF-8 per a editar els fitxers. Si el vostre editor no ho pot fer, proveu d'usar el KWrite o el Kate. Quan obriu un fitxer amb qualsevol d'aquests dos editors podreu seleccionar la codificació amb el quadre combinat que hi ha a la part superior del diàleg per a obrir fitxers.

El següent és un exemple d'un fitxer kvtml:

<?xml version="1.0"?> 
<DOCTYPE kvtml PUBLIC "kvtml2.dtd"
"https://edu.kde.org/kvtml/kvtml2.dtd"> 
<kvtml version="2.0"> 
<information>
    <generator>converter</generator>
    <title>Animals</title><!--Translate tag content-->
    <comment>Animals from across the
planet</comment><!--Translate tag content-->
  </information>
  <identifiers>
    <identifier id="0" >
      <locale>en</locale>
    </identifier>
  </identifiers>
...
<entry id="0" >
      <inactive>false</inactive>
      <inquery>false</inquery>
      <translation id="0" >
        <text>bear</text><!--Translate all text tags
content-->
        <comment>Large heavy animal with thick
fur</comment><!--Translate all comment tags content-->
      </translation>
    </entry>
...
</kvtml>

Al començament del fitxer, haureu de traduir el contingut de les etiquetes <title> i <comment> que resten dintre de l'etiqueta <information>. El títol serà el que apareixerà en el menú Categoria de la partida (a on l'usuari tria el fitxer amb el qual juga).

Després dintre de l'etiqueta <identifier>, si us plau, poseu-hi el codi d'idioma en comptes de «en» a l'etiqueta <locale>.

Si us plau, no traduïu el nom de fitxer tanmateix com que aquests no hauran de contenir mai cap caràcter especial. De manera que deseu-lo amb el mateix nom que a l'anglès.

Editeu els fitxers kvtml amb un editor de text (a poder ser que usi el ressaltat de la sintaxi XML) i substituïu cada paraula dintre de l'etiqueta <text> amb una traducció i cada consell dintre de l'etiqueta <comment> amb un consell que hi esdevingui com a adequat. No és realment important que signifiqui el mateix, però mireu de mantenir la llargada i el nivell de dificultat al llarg del mateix.

Podeu incloure-hi paraules amb espais, guionets o punts volants, en aquest cas, aquests signes que no són lletres seran mostrats. Si us plau, contacteu amb la llista de correu kde-edu si hi ha res especial relacionat amb el vostre idioma de manera que puguem adaptar el codi a aquest nou caràcter (especialment els caràcters especials i els accents).

Senzillament podeu traduir les paraules, però després també les haureu d'adaptar a la categoria i afegir-n'hi de noves, si així ho voleu. Per exemple, «taula» està a la categoria fàcil en anglès, però al vostre idioma aquesta podria ser de categoria mitjana. Trobeu-vos lliure d'adaptar els fitxers al que necessita el vostre idioma. El nombre de paraules en un fitxer no és important, se n'hi poden afegir tantes com es vulgui.

Recordeu que totes les paraules són substantius.

Després podreu cometre els vostres fitxers a l10n-kf5/<lang_code>/data/kdeedu/kdeedu-data/. No oblideu actualitzar també el fitxer CMakeLists.txt. Si us plau, contacteu amb la llista de correu kde-edu si necessiteu quelcom més d'informació. Envieu-nos els fitxers, no us oblideu de fer menció a qualsevol caràcter especial emprat en el vostre idioma (poseu-los en un fitxer de text, un per línia i afegiu-lo a l'arxiu tar), i feu també menció a qualsevol altra peculiaritat.

Si us plau, no cometeu cap fitxer en una branca perquè podríeu fer petar el joc.