Help:Extension:Translate/Page translation example/nl

Welkom! Na het doornemen van deze tutorial weet u hoe u vertaalbare pagina's kunt aanmaken en beheren, hierbij wordt de extensie Translate gebruikt. Wij proberen in deze tutorial compact te zijn en alleen de basisconcepten en taken aan te geven. Deze functie is ook gedetailleerd beschreven.

Onderdeel van de tutorial zijn ook een aantal video's die uit proberen te leggen hoe u de extensie Translate kunt leren te gebruiken:



Stap 1: Voordat je begint
In deze tutorial wordt aangenomen dat de extensie Translate al geconfigureerd is. Als u al weet welke pagina u wilt vertalen of u wilt de onderstaande voorbeeld pagina vertalen, probeer dan de stappen in deze tutorial uit op uw eigen wiki.

Dit is een pagina die de denkbeeldige gemeente Fréttinga beschrijft.

Dit is de bijbehorende wikicode:

Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing. Tourists like to visit it in the summertime. == Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.


 * 1. Ga in uw wiki naar de pagina  (of een conceptpagina) en klik op Aanmaken.
 * 2. Plak de bovenstaande inhoud en sla het op.



Stap 2: Voorbereiding
Nu hebben we een pagina met wat tekst.

Als de pagina nog veel wijzigingen zal ondergaan, dan is het beter te wachten tot men klaar is met het doen van inhoudelijke wijzigingen aan de pagina voordat men aangeeft dat het een vertaalbare pagina is of dat men de pagina vrij geeft voor vertaling. Dat voorkomt dat de vertalers conceptversies gaan vertalen en dus mogelijk vertalingen maken die achteraf niet nodig zijn.

Is de pagina klaar voor vertaling? De pagina vertaalbaar maken:


 * 3. Bewerk
 * 4. Zet de hele inhoud binnen  tags zoals op onderstaande figuur gedaan
 * 5. Sla de pagina op

 Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing. Tourists like to visit it in the summertime. == Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day. 

U hoeft geen tags toe te voegen aan alle elementen.

Voeg nooit markeringen als zelf toe; de extensie doet dat in de volgende stap.



Stap 3: Vertalingen mogelijk maken
Na het opslaan ziet u een link bovenaan de pagina "" — of "" als u geen vertaalbeheerder bent. Als u een vertaalbeheerder bent, klik op de link "". De pagina wordt nu automatisch opgedeeld in vier vertaalberichten. De eerste unit is de paginatitel, de tweede de eerste alinea, de derde is de kopregel van de tweede alinea en de vierde is de tekst van de tweede alinea. Een vertaalbericht is het basisitem van een vertaalbare pagina; elk vertaalbericht is onafhankelijk van elkaar; een vertaalbericht moet als een geheel worden vertaald; wijzigingen aan de pagina-inhoud gaan per vertaalbericht. Een vertaalbericht kan verplaatst worden of verwijderd.

Er is ook een sjabloonweergave van de paginavertaling, die komt later aan bod. U kunt een naam geven aan elke vertaaleenheid, maar ze hebben al een standaardnaam, dus dat doen we geven ze geen eigen naam.


 * 6. Klik op de link ""
 * 7. Zorg ervoor dat de pagina body correct in drie delen wordt gesplitst.
 * 8. Klik op de knop "" (dit is alleen voor vertaalbeheerders weggelegd)
 * 9. Ga terug naar de pagina

Er staat nu bovenaan een nieuwe link "", daarmee kunnen vertalers de pagina vertalen. Bekijk ook eens deze tutorial die dit voorbeeld vertaald en probeer wat vertalingen te doen. Keer dan hier terug voor de volgende stap.



Stap 4: Wijzigingen aanbrengen


Begrijpen hoe wijzigingen gevolgen hebben op vertalingen en vertaalberichten
Het kunnen volgen van wijzigingen is erg belangrijk, laten we eens kijken hoe we dat zien als we wat wijzigingen gedaan hebben. Als u de pagina voor het bewerken opent, dan ziet u wat er gewijzigd is aangegeven worden met markeringen als. Deze worden door de extensie toegevoegd en geven aan wat een vertaalbericht is en welke het is. U kunt deze verplaatsen en bewerken. Bij het bewerken van de tekst dienen deze markeringen te blijven staan. Als u een vertaalbericht verplaatst dan moet u de bijbehorende markeringen mee verplaatsen.

Als u alle tekst in het vertaalbericht verwijderd, dan moet u ook de markering ervan verwijderen. Bij het toevoegen van alinea's zullen er automatisch nieuwe markeringen worden toegevoegd. Doe dit niet handmatig, het kan de software in verwarring brengen. De door u verwijderde markeringen/vertaalberichten zullen later automatisch door een bot uit de bestaande vertalingen worden verwijderd.

Als u maar kleine wijzigingen doet in het bestaande vertaalbericht (paar woorden aanpassen of een link toevoegen), laat de markering staan. Als u een hele alinea verwijdert en opnieuw schrijft, verwidjer dan de markering. Op deze manier hebben vertalers verschillende taken, het beoordelen van verouderde vertalingen en het voor het eerst vertalen van een vertaalbericht.



Laten we iets wijzigen
Dit is wat u dient te doen:


 * 10. Doe de hierboven aangegeven aanvullingen
 * 11. Klik op de link "Deze pagina markeren voor vertalen" bovenaan de pagina
 * 12. Bekijk de wijzigingen
 * 13. Klik op de knop "" (dit is alleen voor vertaalbeheerders weggelegd)
 * 14. Ga terug naar de originele pagina

Indien u deze oefening volgt en de voorgestelde wijzigingen heeft gedaan, dan zou u nu deze wijzigingen moeten kunnen herkennen. U ziet nu ook dat de percentage van elke bestaande vertaling gezakt is, die is nu zeker geen 100% meer. Als u naar de weergave met de vertaling gaat, dan ziet u dat de vertaaleenheid is gemerkt om aan te geven dat de vertaaleenheid bijgewerkt moet worden.

Verouderde vertalingen worden met een roze achtergrond aangegeven, de lezer ziet dan dat de vertaling niet volledig is.

In de weergave met het vertaalsjabloon ziet u de delen die constant zijn in alle taalversies (de "", de delen buiten de  tags) en toont u ook of er delen verplaatst of verwijderd zijn.

Er kan wat vertraging optreden voordat alle vertaalde versies zijn aangepast, omdat het best veel pagina's kan betreffen.

Dit is de basiskennis, maar deze tutorial gaat verder met wat zaken die u waarschijnlijk ook wel zult tegenkomen.



Stap 5: Andere wiki elementen toevoegen


Afbeelding toevoegen, een categorie en een aantal vertalingmarkeringen
De pagina is nu vertaalbaar, maar het is niet echt een sprankelende pagina. We gaan ene afbeeldingen toevoegen en nog wat dingen om het een echte wiki-pagina te maken, dit om te zien wat dit voor het vertalen voor een gevolgen heeft.

We hebben een alinea verwijderd, met dus de markering van die vertaaleenheid. We hebben een lijst toegevoegd.


 * 15. Voer een afbeelding, categorie en een lijst aan de pagina toe, zoals hieronder aangegeven.
 * 16. Sla de pagina op
 * 17. Klik op de link "Deze pagina markeren voor vertalen" bovenaan de pagina
 * 18. Controleer of de wijzigingen naar uw tevredenheid zijn verwerkt en de tekst nu goed is.
 * 19. Klik op de knop ""
 * 20. Ga terug naar de vertaalbare pagina



Een vertaling documenteren
Toestaan dat alleen de afbeeldingstitel wordt vertaald:

Or allowing to change the image file in the translated page (for localized version for example) and the title:

Here you can see that we left most of the image markup outside of a translation unit and have it in the translation page template instead. (reminder: the translation page template doesn't change between the different translated pages) This is usually okay, but sometimes translators may want to change the image, especially if it contains linguistic content (text). In those cases it's usually easiest to include the whole markup in a unit (as we did for the category).

When the translation of a unit involves or interacts with markup it's a good idea to write a small tip to the translators about it. You can do this with the following steps.


 * 21. Click "" link at the top
 * 22. Select "qqq - " language
 * 23. Click the message name which contains the message "A typical view of Fréttinga"
 * 24. Write "Description of an image" and click "Save"

Now, the documentation "Description of an image" is shown next to the to-be-translated-title of the image.



Over links
Similarly, for links there are many ways to do it. We used, which automatically redirects to the translated version of the page depending on the users' interface language (if that translation exists). This isn't an ultimate solution, because users will always be redirected to the interface language they are using, not to the language they are currently reading. Special:MyLanguage also interferes with Special:WhatLinksHere and makes it not work. The good thing about Special:MyLanguage is that you always get some version of the page, even if the requested translation doesn't exist.



Over categorieën
In this example, the whole category assignment is a translation unit. This lets translators change it to or whatever naming convention you want to use for categories. If it were outside the translation template, you would have all the pages Foo, Foo/de, Foo/ru, Foo/ta and so on in the same category. Sometimes this is okay, but usually it distracts the users. Make sure your translators know what the local convention is.



Over titels
To have titles considered as separated elements than text, don't forget to add a blank line (if there isn't one already) between the title and the paragraph following it.

The following example will only create one translation unit:

== Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

The next one will create two translation units, including one for the title.

== Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

Adding a blank line allows translators to know when they can take a break. Plus it prevents issues with wikitext.

<span id="Last_words">

Afsluiten
<span id="Operating_on_the_whole_page_and_its_translations">

Werken op de hele pagina en de vertalingen ervan
It is also possible to move translatable pages including all their translations to a new name. Because many pages may need to be moved, this operation is not instant. You can delete either the whole page including all translations, or just one translated version of a page. You can access these functions from the same place they are on all other pages.

<span id="Managing_all_wiki&#039;s_pages_translations_with_Special_pages">

Beheren van alle wiki's vertalingen met de Speciale pagina's
Special:PageTranslation lists all the pages in the system. Besides giving you an overview of all translatable pages, it is also possible to discourage pages from translation. This hides the page from most lists. It does not prevent further translations.

<span id="Now,_you_know!">

Nu, weet je het!
You have now created a translatable page and tried all of the common actions that can be performed on translatable pages.

<span id="Going_deeper?">

Meer details?
For more information, or if you want to understand the feature more deeply, please continue reading on the in-depth documentation of page translation feature. It also contains discussion about different ways of handling links, categories and templates, or pros and cons of using larger or smaller translation units.

<span id="See_also">

Zie ook

 * Extensie Translate, administratie pagina vertaling