Richtlijnen voor vertalen¶
This manual is aiming to help the translator. First the general process of how technically a translation is done is explained. Later the translation is explained from an actual English rst document that is translated to Dutch. Finally a summary of Rules of translation is given.
Hoewel deze richtlijnen focussen op de documentatie van QGIS zijn de hieronder beschreven methoden en regels ook van toepassing op de toepassing QGIS en de vertaling van de website.
Proces van vertalen¶
Eerst worden .rst-documenten gemaakt om de documentatie te maken. Een vooraf gebouwd script maakt bestanden voor vertalingen, genaamd .po -bestanden voor de Engelse taal in de map /QGIS-Documentation/i18n/en.
Deze “originelen” worden door het script gekopieerd naar de mappen i18n voor andere talen.
De zinnen in de .po-bestanden dienen te worden vertaald vanuit het Engels naar de taal met behulp van een programma voor het bewerken van vertalingen.
Wanneer u bij wilt dragen, haal eerst een .po-bestand op en voeg de vertalingen voor de zinnen in het .po-bestand toe. Wanneer u gereed bent wordt het .po-bestand teruggeplaatst op de juiste plek en gedurende de volgende bouwfase maakt het bouwproces, naast het .po-bestand, `` .mo``-bestanden. Deze .mo-bestanden worden feitelijk door het script om de vertaalde uitvoer te maken.
Wanneer later een rst-document wordt bijgewerkt, wordt een nieuw .po-bestand gemaakt in het Engelse gedeelte. De inhoud van dit nieuwe bestand zal worden samengevoegd met de reeds bestaande .po-bestanden voor elke taal. Dit betekent dat wanneer een nieuwe regel wordt toegevoegd aan een rst-document dat al was vertaald, worden alleen de nieuwe/bijgewerkte zinnen toegevoegd aan het vertaalde .po-bestand en moeten worden vertaald. De hoeveelheid werk voor het bijwerken van vertalingen voor komende versies van QGIS zal redelijk klein zijn.
Twee verschillende programma’s worden momenteel gebruikt voor het maken van de vertalingen in QGIS:
het webplatform Transifex, de gemakkelijkste en aanbevolen manier om QGIS te vertalen, voert transparant het hierboven beschreven proces uit en verzamelt alle te vertalen teksten op één plaats voor de vertaler. Hij hoeft dan slechts de bestanden eruit te pikken die hij wil en die te vertalen
Qt Linguist, een ontwikkelprogramma voor Qt dat vereist dat de vertaler de .po-bestanden ophaalt en en vervangt in de bron.
Onthoud dat, welk programma u ook kiest, de regels voor het vertalen hetzelfde zijn.
Waarschuwing
Een belangrijke opmerking: Indien u inhoud wilt vertalen vanuit de map docs (niet web), doe dat dan nooit in de master branch. Voor vertalingen zijn altijd branches voor vertalingen beschikbaar, als een document in het Engels volledig is bijgewerkt voor een bepaalde versie. Als voorbeeld: voor het vertalen van de branch van de handleiding voor QGIS 2.8, moet u de branch manual_en_v2.8 branch gebruiken.
Vertalen van een bestand¶
We zullen de plug-in Heatmap gebruiken als voorbeeld om uit te leggen hoe het vertalen werkt. In dit voorbeeld zullen we het vertalen van Engels naar Nederlands, maar in de praktijk werkt het hetzelfde voor andere documenten in alle talen.
De bron van het document is hier te vinden:
QGIS-Documentation/source/docs/user_manual/plugins/plugins_heatmap.rst
Waarom koos ik dit document?
It is considered finished for the current release. If it is not yet completed the following statement followed by an empty line can be found in the top of the document.
|updatedisclaimer|
This will produce a visible disclaimer in the output product. To start translating a document with an update disclaimer there is a good chance that later on it needs another finishing touch.
It also includes images, captions, headers, references and replacements.
Ik schreef het, dus is het voor mij eenvoudiger om het te vertalen ;-)
Het bouwproces heeft het Engelse .po-bestand gemaakt dat hier kan worden gevonden:
QGIS-Documentation/i18n/en/LC_MESSAGES/docs/user_manual/plugins/plugins_heatmap.po
Het equivalente Nederlandse .po-bestand (in principe een kopie) is hier te vinden:
QGIS-Documentation/i18n/nl/LC_MESSAGES/docs/user_manual/plugins/plugins_heatmap.po
Naast dit bestand zult u een zeer klein .mo-bestand zien dat aangeeft dat het nog geen vertalingen bevat.
Vertalen in Transifex¶
In order to translate QGIS with Transifex, you first need to join the project. Once you got a team, click on the corresponding project and your language. You get a list of all translatable .po files. Click on the docs_user-manual_plugins_plugins-heatmap to select the heatmap plugin file and choose Translate in the prompted dialog. Note that you can also choose to download the file and translate it with tools like Qt Linguist. The next page lists all the sentences in the file. All you need to do is select the text and translate following the guidelines.
For further information on the use of Transifex Web Editor, see http://docs.transifex.com/tutorials/txeditor/.
Vertalen in Qt Linguist¶
Met Qt Linguist dient u het .po-bestand handmatig op te halen. Wanneer u het bestand voor de eerste keer opent in Qt Linguist zult u het volgende dialoogvenster zien:
Selecteer de taal voor de vertaling in het menu van Linguist
De doeltaal zou correct moeten zijn gevuld. De brontaal kan worden gelaten zoals het is met de taal POSIX en Country/Region op een willekeurig land.
When you press the [OK] button Qt Linguist is filled with sentences and you can start translating, see Figure_translation_menu.
Vertalen met behulp van het menu Linguist
In het menu ziet u de volgende knoppen die handig in het gebruik zijn.
De knop Translation Done Next is de meest belangrijke knop. Als het item vertaald moet worden, voert u een tekst in in het tekstveld en drukt op deze knop. Als het item geen vertaling nodig heeft, laat dan het tekstveld voor de vertaling leeg en druk ook op deze knop om aan te geven dat het item voltooid is en dat u doorgaat met het volgende item.
De knop Goto Previous kan worden gebruikt om terug te gaan naar een eerder vertaald item.
De knop Goto Next kan worden gebruikt om naar het volgende vertaalde item te gaan.
De knop Next Todo springt naar het eerste nog te vertalen item. Handig als het originele document is gewijzigd en alleen enkele nieuwe/gewijzigde zinnen moeten worden vertaald.
De knop Previous Todo zoekt terug en springt naar het eerste nog te vertalen item dat het vindt.
Vertalen van een handleiding¶
Nu beginnen we met het vertalen van de handleiding van de plug-in_heatmap!
Vertalen van de meeste zinnen is recht door zee. Gedurende deze sessie van vertalen zal ik aangeven welke delen (rst-argumenten) op een bijzondere manier dienen te worden vertaald.
Hieronder zien we een meer interessante zin om te vertalen:
The |heatmap| :sup:`Heatmap` plugin allows to create a heatmap from a
point vector map. A heatmap is a raster map showing the density or
magnitude of point related information. From the result "hotspots" can
easily be identified.
Deze zin bevat twee rst-argumenten:
|heatmap| woorden tussen | zijn vervangingen en deze zouden nooit moeten worden vertaald! Dit zal worden vervangen door het pictogram van de plug-in Heatmap!
:sup:`Heatmap`, het argument :sup: is een argument voor een superpositie en drukt de volgende tekst iets hoger af. Dit wordt gebruikt om de tekst van de pop-up weer te geven die verschijnt als u de muis boven het item op de werkbalk brengt en dit kan anders zijn als wanneer het in feite is vertaald in de toepassing QGIS. In het geval voor Nederlands is dat niet zo!
Alle andere platte tekst in deze zin kan worden vertaald!
Het volgende item voor vertaling bevat het argument :ref: dat over het algemeen wordt gebruikt om te verwijzen naar een ander gedeelte ergens in de handleiding! De tekst die volgt op een argument :ref: zou nooit moeten worden gewijzigd omdat het een unieke identificatie is!
First this core plugin needs to be activated using the Plugin Manager
(see Section :ref:`load_core_plugin`). After activation the heatmap icon
|heatmap| can be found in the Raster Toolbar.
In dit geval is “load_core_plugin” een unieke identificatie voor een verwijzing die is geplaatst vóór een rst-item dat een bijschrift heeft. Het argument ref zal worden vervangen door de tekst van de kopregel en een hyperlink worden. Wanneer de kopregel waarnaar deze verwijzing verwijst wordt vertaald, worden ook alle verwijzingen naar deze kopregel automatisch vertaald.
Het volgende item bevat de rst-tag :menuselection: gevolgd door de actueel weergegeven tekst in een menu in de toepassing QGIS, dit zou in de toepassing vertaald kunnen worden en zou daarom, als dat het geval is, moeten worden vertaald.
Select from menu :menuselection:`View --> Toolbars --> Raster` to activate
the Raster Toolbar when it is not yet activated.
In het hierboven vermelde item is “View –>” actueel vertaald als “Beeld –>” omdat dat de vertaling is die wordt gebruikt in de Nederlandstalige versie van de toepassing QGIS.
Een stukje verder komen we het volgende, wat lastig te vertalen, item tegen:
The |heatmap| :sup:`Heatmap` tool button starts the Dialog of the Heatmap
plugin (see figure_heatmap_settings_).
Het bevat een verwijzing naar een afbeelding figure_heatmap_settings_ en, net als een verwijzing naar een gedeelte, zou ook deze verwijzing niet moeten worden gewijzigd!! De definitie van de verwijzing zelf in het rst-document is niet opgenomen in het .po-bestand en kan daarom niet worden gewijzigd. Dit betekent dat de verwijzing naar afbeeldingen niet kan worden vertaald. Wanneer HTML wordt gemaakt zult u figure_heatmap_settings zien. Wanneer een PDF-document wordt gemaakt wordt figure_heatmap_settings_ vervangen door een nummer voor de afbeelding.
Het volgende item om te vertalen met attributen voor rst is het volgende item:
**Input Point dialog**: Provides a selection of loaded point vector maps.
Verwijder niet de sterretjes in de regel hierboven. Het zal de tekst die er tussen staat vet afdrukken. De tekst zelf is vaak tekst die is opgenomen in het dialoogvenster zelf en zou in de toepassing wel mogen worden vertaald.
Het volgende item om te vertalen bevat de rst-tag :guilabel:.
When the |checkbox| :guilabel:`Advanced` checkbox is checked it will
give access to additional advanced options.
De tekst Advanced van de tag guilabel zou zeer wel kunnen zijn vertaald in de toepassing QGIS en zal waarschijnlijk gewijzigd moeten worden!
Het volgende te vertalen item bevat ``airports``. De aanhalingstekens worden gebruikt om de grootte van het lettertype te wijzigen. In dit geval is het een letterlijke waarde en hoeft niet te worden vertaald.
For the following example, we will use the ``airports`` vector point
layer from the QGIS sample dataset (see :ref:`label_sampledata`).
Another excellent QGIS tutorial on making heatmaps can be found on
`http://qgis.spatialthoughts.com
<http://qgis.spatialthoughts.com/2012/07/tutorial-making-heatmaps-using-qgis-and.html>`_.
This item also includes a hyperlink with an url and an external presentation. The url should of course be left intact, you are allowed to change the external text http://qgis.spatialthoughts.com which is visible by the reader. Never remove the underscore at the end of the hyperlink which forms an essential part of it!!
Samenvatting Regels voor vertalingen¶
Wijzig nooit de tekst tussen twee tekens | zoals |bronze|, |checkbox|, |labels|, |selectString|, |addLayer| ... Dit zijn speciale tags om afbeeldingen te vervangen
Wijzig geen verwijzingen die beginnen met de tag :ref: of :file:
Wijzig geen verwijzingen die eindigen met een underscore, zoals figure_labels_1_
Wijzig niet de URL in hyperlinks, maar u mag de externe weergave wijzigen. Laat de underscore aan het einde van de hyperlink staan, zonder aanvullende ruimte (>`_)
Wijzig de tekst binnen de aanhalingstekens die volgen op de tags :sup:, :guilabel: en :menuselection:. Controleer of/hoe het vertaald is in de toepassing QGIS. Wijzig niet de tag zelf.
Tekst tussen dubbele sterretjes en dubbele aanhalingstekens geven vaak waarden of veldnamen aan, soms moeten zij vertaald worden, soms niet.
Zorg er voor om exact dezelfde (aantallen) speciale tekens van de brontekst te gebruiken, zoals `, ``, *, **, ::. Deze dragen bij aan het cosmetisch uiterlijk van de verschafte informatie
Begin de tekst, die wordt omsloten door speciale tekens of tags, niet met een spatie
Eindig de vertaalde tekenreeksen niet met een nieuwe alinea, anders zal de tekst niet worden vertaald bij het genereren van de HTML.
Volg de hierboven weergegeven regels en het vertaalde document zal er goed uitzien!
Neem voor vragen contact op met het QGIS Community Team of het QGIS Translation Team.