Vertaling helpbestanden

, 13 december 2003

Doelstelling

Informatie omtrent het gebruik van OpenOffice.org toegankelijker maken.

Een goed afgewerkt geheel afleveren.

Opbouw Help

Bronbestanden

XML bestanden
Bepalen de opmaak en de inhoud van de help.

Afbeeldingen
Alle afbeeldingen die in de help te vinden zijn.

*.tree bestanden
Bevatten alle koppen van de inhoudsopgave.

*.css bestanden
Bepalen het uiterlijk van de help.

Te vertalen

Afbeeldingen:
Nieuwe schermafdrukken maken.

XML bestanden:
Worden vertaald middels het t9n bestand.

*.tree bestanden:
Worden handmatig aangepast. Slechts enkele regels dienen vertaald te worden.

*.css bestanden:
Geen vertaling noodzakelijk.

XML bestanden

T9N bestand

Werkwijze

T9N bestand genereren en voorvertalen.

getcontent.exe

Secties verdelen en vertalen.

statuslijst

vrijwilligers

Vertaalde secties samenvoegen.

mergecontrib.exe

Uiteindelijke help genereren.

createhelp.pl

Toekomst

Huidige vertaling migreren naar nieuwer formaat.

Beter bij blijven met nieuwe releases van OpenOffice.org.

Bronbestanden eenvoudiger bewerken.

Presentatie over de vertaling van de helpbestanden van OpenOffice.org, gehouden door Bert Meersma tijdens de OOo gebruikersdag op 13 december 2003 in Tilburg.

De voornaamste doelstelling voor het vertalen van de helpbestanden van OOo is het beter toegankelijk maken van informatie over het gebruik van OOo.

Daarnaast wordt het office pakket completer wanneer zowel de GUI als de help in het Nederlands zijn.

De help bestaat voor het grootste gedeelte uit XML bestanden. Deze bestanden bevatten de te vertalen teksten.

Daarnaast zijn er nog de afbeeldingen, die ter verduidelijking van de tekst dienen.

De inhoudsopgave van de help wordt opgebouwd middels de *.tree bestanden.

Het uiterlijk van de help wordt verzorgt door de css bestanden. Dit zijn kenmerken als het lettertype, de lettergrootte en de letterkleur. (o.a.)

Alle afbeeldingen die voorzien zijn van Engelse of Duitse teksten moeten vertaald worden. Dit wordt gedaan door nieuwe screenshots te maken en deze op te nemen in de help.

Van de XML bestanden moet alle tekst worden vertaald. Dit is ook de tekst die in de help is te lezen.

Van de *tree bestanden hoeven maar een paar regels per bestand handmatig vertaald te worden, de rest wordt uit de xml bestanden gehaald.

De *css bestanden behoeven geen vertaling, daar deze alleen maar uiterlijke kenmerken bevatten.

Bovenstaande is een voorbeeld van een gedeelte uit een xml bestand. Alle in rood aangegeven tekst dient vertaald te worden. De rest zijn tags, die de indeling van de help bepalen. Ook de links naar andere gedeelten van de help worden middels deze tags gemaakt. Ook bevatten deze tags verwijzingen naar de css bestanden waardoor iedere paragraaf en/of link en/of titel zijn eigen opmaak krijgt.

Doordat deze bestanden in deze vorm onoverzichtelijk zijn, is het lastig ze te vertalen. Het vertalen wordt daarom middels het t9n bestand gedaan. (zie volgende slide)

Bovenstaande is voorbeeld van een stukje t9n bestand. Dit bestand is softwarematig aangemaakt door alle te vertalen tekst uit de xml bestanden gestructureerd onder elkaar te plaatsen. Daarnaast is de tekst softwarematig voorvertaald wat heel wat typewerk bespaard. De softwarematige vertaling geeft echter geen correct Nederlands, waardoor alles door mensen moet worden nagelopen.

Het vertaalproces begint met het genereren van het eerder besproken t9n bestand. Wanneer dit gedaan is worden alle onderwerpen uit de help verzameld en samengevoegd tot de statuslijst. Zie www.r2g.nl/~remco/statuslijst.htm

De vrijwilligers geven vervolgens aan welk gedeelte zij willen vertalen en dit wordt aangegeven in de statuslijst, zodat iedereen van elkaar weet waar de ander mee bezig is.

Wanneer iemand een gedeelte af heeft wordt dit nagekeken door 1 persoon. Na deze controle worden de vertaalde gedeelten softwarematig samengevoegd tot een nieuw t9n bestand, die dan geheel vertaald is. De tekst uit dit t9n bestand wordt dan weer middels software ingebed in de xml bestanden, waarna middels een perl script de help wordt gegenereerd.

De vertaling van de help van OOo 1.0.x is zo goed als klaar. (december 2003). Om niet helemaal opnieuw te hoeven beginnen voor de nieuwe releases van OOo is het van belang dat de bestaande vertaling eenvoudig omgezet kan worden naar de nieuwe. Deze oplossing is echter nog niet voor handen.

Ook is er de wens om de bronbestanden eenvoudiger te bewerken, bijvoorbeeld rechtstreeks in OOo. Ook hier moet nog naar worden gekeken. Alle tips hierover zijn welkom en kunnen gemaild worden naar:

localization@nl.openoffice.org of bert.meersma@chello.nl. Hier kunt u ook voor al uw vragen betreffende deze presentatie terecht.

Bert Meersma

2003-11-13T19:08:17