CVS gebruiken voor de vertaling van Mozilla produkten

De code van de vertaling staat in de CVS van Mozilla. Hierin worden alle wijzigen bijgehouden zodat makkelijk fouten ontdekt kunnen worden. Als je de code wilt downloaden en patches wilt maken voor problemen in (testversies van) Firefox, Thunderbird of Calendar, zodat het vertaalteam deze fouten makkelijk kan oplossen, heb je een CVS-programma nodig. Tortoise is zo’n programma dat bijna geen kennis over het CVS-protocol vereist. Hieronder wordt uigelegd hoe je het kan gebruiken.

In dit artikel zal uitgelegd hoe Firefox en Thunderbird vertaald worden, maar ook voor Nvu is de vertalingscode online te vinden en via CVS aan te passen. Op de Nvu-projectpagina kun je vinden welke gegevens je nodig hebt om patches te maken voor de Nvu-vertaling.

Voorbereidingen treffen

Tortoise CVS heb je nodig om deze tutorial te volgen en is te downloaden vanaf tortoisecvs.org.
Klik bovenaan op Download en selecteer de Stable-versie. Na het downloaden krijg je een Nederlandstalig installatieprogramma dat je door het installatieproces heen leidt. Na het opnieuw opstarten van de PC kun je Tortoise CVS gebruiken.

Op andere besturingssystemen kun je verschillende tutorials doorlezen over hoe je CVS kunt gebruiken via de commandline. Deze pagina gaat uit van Tortoise CVS voor Windows aangezien er voor het gebruik van CVS via de commandline genoeg tutorials beschikbaar zijn. Voor Linux wordt een commandlineversie meegeleverd en anders is vanaf cvshome.org ook een commandlineversie te downloaden voor veel verschillende besturingssystemen. Zorg er wel voor dat je een versie download waar Stable achter staat, andere versies zijn testversies en het is dus niet aangeraden om die te downloaden.

De broncode downloaden

Voor we verbeteringen aan de vertaling van Firefox en Thunderbird kunnen aanbrengen moeten we eerst de vertaling downloaden. Waarschijnlijk heb je het meeste aan de tekst onder Tortoise.

Commandline

Als je een CVS-client voor de commandline gebruikt kun je via het volgende commando de code uit CVS downloaden:

cvs -d :pserver:anonymous@cvs-mirror.mozilla.org:/l10n checkout l10n/nl
wachtwoord: anonymous

Verder dan zover zullen we niet gaan wat betreft de commandline. De rest van deze tutorial gaat verder over Tortoise.

Tortoise

In Tortoise kun je ook de code zelf downloaden van de CVS server. Klik daarvoor op een lege plek in de Verkenner met de rechtermuisknop en selecteer CVS ophalen uit het contextmenu. Je krijgt dan het venster ‘Module ophalen’. Vul dan op de volgende plekken deze gegevens in:

Protocol

Wachtwoordserver (:pserver:)

Server

cvs-mirror.mozilla.org

Repositorymap

/l10n

Gebruikersnaam

anonymous

Module

l10n/nl

Op de schermafbeelding hieronder zie je ook waar je alles kunt vinden:

Je zult waarschijnlijk geen wachtwoord moeten invoeren. Als Tortoise daar wel om vraagt dan is dat ook anonymous.

Nu Firefox 2 dichter bij een release komt is er een vertakking in de code gemaakt (de aftakking voor versie 1.5 wordt doorontwikkeld naar versie 2) en om de meest actuele vertaling te hebben is het nodig om in het tabblad Revisie de optie Kies een tak of tag aan te vinken. Als tag- of taknaam kun je dan MOZILLA_1_8_BRANCH opgeven. Als je nog via de HEAD werkt kan het zijn dat je dingen gaat wijzigingen die al gedaan zijn, of dat de bestanden op de computer niet meer gelijk zijn aan de bestanden die op de Mozilla-server staan.

In plaats van handmatig de naam in te voeren is het ook mogelijk om Scan submappen aan te vinken en dan op de knop Lijst bijwerken te klikken. In plaats van HEAD is dan ook voor MOZILLA_1_8_BRANCH te kiezen.

Verbeteringen doorvoeren

Je hebt nu een map gedownload en als je Tortoise CVS geïnstalleerd hebt hebben alle bestanden in de map met
vertaalbestanden een extra logo. Als je nu een bestand bewerkt zal dit pictogram veranderen, zoals op de
afbeelding te zien is (groen vs oranje).

Een oranje pictogram zal verschijnen bij ieder aangepast bestand, de rest blijft groen. Als je denkt dat je alle dingen gewijzigd hebt die je wilde wijzigen
(eventueel door speciale woorden in alle bestanden te laten vervangen) kun je doorgaan naar de volgende stap om de patch
ook echt te maken.

Verbeteringen doorgeven

Ga naar de hoofdmap van de vertaling, in ons geval de map nl. Klik daar met de rechtermuisknop op de map en kies eerst
voor CVS Bijwerken. De code wordt nu van de server gedownload en zo wordt opgemerkt of er ondertussen geen
andere dingen zijn veranderd. Het kan zijn dat er een zogenaamd conflict optreedt, in dat geval is op de server ook
al wat aan jouw bestand veranderd. Je moet dan handmatig naar dat bestand gaan en even kijken naar de dubbele regels
die Tortoise erin heeft gezet. Zo kun je het conflict handmatig oplossen. Bij de bestanden waar een conflict optreedt
zie je een rood vraagteken verschijnen.

Als hier geen problemen mee zijn of als je het conflict hebt opgelost kun je voor CVS > Maak patch
kiezen en wordt je gevraagd waar je het patch-bestand wilt opslaan.

Als je de patch af hebt kun je deze aan de bugdatabase van Mozilla toevoegen. Hiervoor heb je wel een account nodig voor Bugzilla, de naam van het systeem. Kijk op de betreffende projectpagina welke bugs er momenteel gebruikt worden.

Als je 1 kleine opmerking hebt kun je deze ook kwijt op de mailinglijst, mozillanl@mozdev.org. Het is wel fijn als je je hiervoor aanmeldt, zodat je ook reacties kunt blijven volgen. Een patch via bugzilla is echter nog makkelijker, zie hierboven.

Tips

Bij het vertalen is het goed om de volgende dingen in je achterhoofd te houden:

• Als je twijfelt over bepaalde woorden, bekijk ook even ons vertaalwoordenboek
• Als je trema’s en andere rare tekens gebruikt moet je zorgen dat je het bestand als UTF-8 opslaat.
  Dit verschilt per programma, maar is bij Kladblok via ‘Opslaan als’ te vinden.