Algemeen
Gebruikers
Vertalers
Diversen

Technische tips

In dit document vind je handige tips voor bij het vertalen, zoals programma's, hoe een .po bestand in elkaar zit en hoe je via CVS de broncode kan downloaden.

Programma's voor vertalers

Je kunt de po bestanden vertalen met je favoriete editor. Dit werkt altijd en sommigen zweren erbij. Er zijn echter ook programma's verkrijgbaar die ervoor gemaakt zijn om het vertalen makkelijker en sneller te maken. Je kunt ze zoals altijd vinden via freshmeat.net, maar ik heb hier een klein lijstje voor de ongeduldigen onder ons:

Verder zijn er natuurlijk vele kleine programma's die je kunnen helpen. Als je een vertaling zelf wilt testen/uitproberen, dan kun je dat doen op deze manier: 

msgfmt jouwvertaling.po -o /usr/share/locale/nl/LC_MESSAGES/projectnaam.mo
projectnaam staat dus voor de naam van het programma wat je vertaalt.

Testen kun je ook doen met de opdracht "msgfmt -cvv jouwvertaling.po". Met "msgfmt --statistics" kijk je of je alles vertaald hebt.

Anatomie van een PO bestand

Een PO bestand bestaat ruwweg uit 2 delen. De kop: Daarin staan de gegevens van de vertaler, zijn team, de taal enzovoorts. Daarna komen, in deel 2, de vertalingen.

De kop van het bestand

Je moet allereerst de informatie in de kop invullen. Dan weten we dat jij het aan het vertalen bent en kunnen we je vinden als je fouten maakt :-) Het is de regel dat je vorige vertalers in de kop laat staan als commentaar. Een soort van bedankje voor het vertalen dus.

Voorbeeld: Gnome-vfs 
# Gnome-vfs translation.
# Copyright (C) 2002 Free Software Foundation, Inc.
# Dennis Smit <e-mail>, 2000.
# Mendel Mobach <e-mail>, 2000.
msgid ""
msgstr ""
"Project-Id-Version: Gnome-vfs\n"
"POT-Creation-Date: 2002-06-14 13:07+0200\n"
"PO-Revision-Date: 2002-05-28 20:49+02:00\n"
"Last-Translator: Mendel Mobach <e-mail>\n"
"Language-Team: Dutch <e-mail>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

Hier zie je dus hoe het moet. Eerst is dit bestand vertaald door Dennis Smit. Vervolgens heeft Mendel Mobach de vertaling overgenomen. De programma's genoemd onder het kopje programma's in het linker menu doen dit automatisch. Daar hoef je dan dus niets aan te doen. Je kunt het beste wel even controleren of het goed staat voordat je het doorstuurt naar de coördinator.

De vertalingen

%s, %d, etc... Voorbeeld: Gnome-vfs 
#: libgnomevfs/gnome-vfs-configuration.c:269
#, c-format
msgid "%s:%d contains no module name."
msgstr "%s:%d bevat geen modulenaam."

Hier zie je een voorbeeldvertaling. De te vertalen tekst bevat rare tekens als %s en %d. Wanneer het programma draait vervangt het deze tekens door eigen tekst. Het zijn dus een soort van variabelen. (%s = string/tekst, %d = decimal/getal). De ingevulde tekst zou dus iets zijn als "I/O-fout:30 bevat geen modulenaam" ofzoiets.

Underscores... Voorbeeld: Gnome-session 
#: gnome-session/gsm-client-editor.c:108
msgid "_Style:"
msgstr "_Stijl:"

Hier zie je een vertaling met een underscore. De underscore geeft een sneltoets aan. Dit is een Alt+(de toets waar de underscore voor staat) binding. Hij moet uniek zijn zodat de gebruiker hem kan gebruiken om te navigeren met zijn toetsenbord in plaats van met zijn muis. Andere voorbeelden zijn de alt+F (file-menu) en alt+W (bewerken). De CTRL-toets sneltoetsen worden niet beïnvloed hierdoor (CTRL+C, CTRL+V).

\n... Voorbeeld: Gnome-session 
#: gnome-session/session-properties-capplet.c:142
msgid ""
"Some changes are not saved.\n"
"Is it still OK to exit?"
msgstr ""
"Sommige wijzigingen zijn niet opgeslagen. \n"
"Wilt u toch afsluiten?"

Hier zien we een zin die een \n bevat aan het einde van de regel. Als dit in het origineel staat, dan is het blijkbaar nodig om met een \n aan te geven dat er naar de volgende regel gesprongen dient te worden. Zet het dus ook in je vertaling.

Meervouden... Voorbeeld: gnome-games 
#: gtali/gyahtzee.c:123
#, c-format
msgid "%s wins the game with %d point"
msgid_plural "%s wins the game with %d points"
msgstr[0] "%s wint het spel met %d punt!"
msgstr[1] "%s wint het spel met %d punten!"

Je ziet hier twee vertalingen, een enkelvoud en een meervoud, in een msgid. De msgstr[0] staat voor het enkelvoud en [1] voor het meervoud.

Als je dit tegenkomt moet je ook iets aan de kop toevoegen:
Plural-Forms: nplurals=2; plural=(n != 1);
Op dat moment zal de juiste vertaling worden aangeroepen voor meervoud en enkelvoud.
Gelabelde variabelen... Voorbeeld: gramps 
#: plugins/Verify.py:226
msgid "Married often: %(male_name)s married %(nfam)d times.\n"
msgstr "Vaak getrouwd: %(male_name)s is %(nfam)d keer getrouwd.\n"

Tussen de variabele-aanduiding en het type variabele zie je een label tussen haakjes staan. Hieraan kan de variabele herkend worden. Dit moet niet vertaald worden.

Een voordeel van gelabelde variabelen is dat je makkelijk kunt verwisselen omdat je makkelijk het verschil kunt zien.

Nog een laatste tip: Soms zie je de melding "fuzzy" (vaag, onduidelijk) staan in het commentaar boven een vertaling. Als je een term hebt vertaald voor een programma, en die maker verandert het origineel (hoofdletter weg, of zinsnede net iets anders), dan wordt de term fuzzy erbij gezet. De tekst zal dan niet meer automatisch vertaald worden. Het is dan jouw taak als vertaler om te controleren of de vertaling nog klopt en deze zo nodig aan te passen. Wanneer dit is gebeurd haal je het woordje "fuzzy" weg en wordt de tekst weer vertaald.

CVS-toegang

Wat is CVS?

Voor het software-beheer van gnome wordt gebruik gemaakt van CVS (Concurrent Versions System). Dat is een soort van Network Filesystem waar iedereen een eigen kopie van de broncode op zijn eigen computer heeft. De server houdt geschiedenis van veranderingen bij per bestand en de gebruikers kunnen de veranderingen per bestand via een soort van rsync-protocol (gedeeltelijk bijwerken m.b.v. patches) van de server halen of naar de server opsturen. Dit alles gaat natuurlijk veelal automagisch ;-)

Vertalers kunnen de nieuwste "CVS-versie" van software-broncode downloaden om de vertaling te testen, of gewoon om de nieuwste versie van een software-pakket te gebruiken. Het enige wat je nodig hebt om dit te kunnen doen is het programma "cvs".

Anonieme CVS-toegang

Om de software te kunnen downloaden kun je gebruik maken van de anonieme CVS-toegang. Dit vereist 3 stappen.

CVS-toegang voor mensen met een account

Voor schrijftoegang heb je een officieel account nodig. Dit is voor de meesten niet nodig. Maar voor de volledigheid:

De rest is volledig hetzelfde als bij anonieme toegang. Plus dat je een extra opdracht erbij hebt. De opdracht om iets op de server te zetten. Daarvoor gebruik je "cvs commit" vanuit de module-map.

Po-bestand bijwerken na update

Na een sync met de nieuwste CVS is je po-bestand nog niet bijgewerkt. Dat doe je door naar de map $module/po te gaan en daar de opdracht "intltool-update nl" uit te voeren. Dan wordt het po-bestand bijgewerkt en kun je de vertaling weer helemaal bijwerken.

Als je op deze manier de vertalingen gaat maken moet je er wel bijzeggen wat voor CVS-versie je hebt gebruikt zodat degene met schrijftoegang weet naar welke "branch" hij de vertaling weg moet schrijven. Anders komen er vertalingen op de verkeerde plek terecht.

Branches moet je zien als zijsporen van een treinrails. Je hebt de hoofdweg (HEAD) en je kunt een wissel ($branch) aangeven waarna er een zijspoor ontstaat Dat zijn over het algemeen de stabiele releases die later afsterven terwijl de HEAD gewoon doorgaat.

Voor meer informatie hierover kun je kijken op de pagina's op gnome.org.

Epiphany, de webbrowser voor GNOME Hosted by KovoKs.nl Valid HTML 4.01! Correct CSS! Vincent van Adrighem (webmaster)