Help:Extension:Translate/Page translation example/de

Herzlich Willkommen! Nach Abschluss dieses Tutorial werden Sie wissen, wie man übersetzbare Seiten mit der Übersetzungserweiterung erstellt und verwaltet. Wir sind bestrebt, dieses Tutorial so kurz wie möglich zu halten, während der Einführung aller grundlegenden Begriffe und Aufgaben. Nach Abschluss dieses Tutorial können Sie die ausführliche Dokumentation über Merkmale der Seitenübersetzung benutzen.

Schritt 1: Vor dem Start
Dieses Tutorial geht davon aus, daß die Erweiterung "Translate" bereits installiert und konfiguriert ist. Vielleicht haben Sie bereits eine Seite vor Augen, die übersetzt werden muß. Ansonsten können Sie die untenstehende Beispielseite in Ihrem eigenen Wiki nutzen, um die verschiedenen Schritte dieses Tutorial nachzuvollziehen.

Dies ist eine Seite, die die imaginäre Gemeinde Fréttinga beschreibt. 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 summer time. == Services == It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day.
 * 1. Gehen Sie auf die Seite Fréttinga in Ihrem Wiki und klicken Sie auf Quelltext bearbeiten.
 * 2. Fügen Sie den obrigen Inhalt ein und speichern ihn.

Schritt 2: Vorbereitung
Jetzt haben wir eine Seite mit etwas Text. Wenn an dieser Seite noch sehr viele Veränderungen oder größere Überarbeitungen vorgenommen werden, ist es vielleicht besser noch etwas zu warten, bis die Zahl der Änderungen auf ein normales Niveau fällt., bevor man die Seite in das Übersetzungssystem aufnimmt. Dies ist angeraten, um die Arbeit für die Übersetzer gering zu halten, da sie mit den auflaufenden Änderungen Schritt halten müssen.

&lt;translate> 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 summer time. == Services == It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day. &lt;/translate>
 * 3. Fréttinga Quelltext bearbeiten
 * 4. Nun am Anfang ein und an das Ende -Tag einfügen, wie unten im Beispiel gezeigt.
 * 5. Jetzt wieder die Seite speichern

Schritt 3: Übersetzungen aktivieren
Nach dem Speichern der Seite ist über dem Text ein neuer Link zu sehen: "Markieren Sie diese Seite für die Übersetzung" (oder "Diese Seite enthält Änderungen, die nicht für die Übersetzung gekennzeichnet sind." Wenn Sie kein eine Übersetzungsadministrator sind). Klicken Sie nun auf diesen Link. Die Seite wurde automatisch in vier Übersetzungseinheiten aufgeteilt. Die erste Einheit ist der Titel der Seite, der zweite ist der erste Absatz, der dritte ist die Kopfzeile des zweiten Absatzes, und der vierte ist der Text des zweiten Absatzes. Dieses ist der Ursprungtextbereiche der übersetzbaren Seite. Jeder Abschnitt ist unabhängig zu ändern, er sollte als Ganzes übersetzt werden, damit Änderungen an der Ursprungsseite in den Letzten Änderungen verfolgt werden können. Einheiten können neu angeordnet oder gelöscht werden.

Dies ist ebenfalls eine Ansicht von der Änderungsübersicht. Diese können wir später weiter aufteilen. Sie können den Übersetzungsabschnitten Namen geben, aber in diesem Beispiel bleiben wir bei den Standardeinstellungen.


 * 6. Klicken Sie auf den "Markiere diese Seite für die Übersetzung"-Link
 * 7. Überzeuge dich, dass die Seite richtig in drei Einheiten aufgeteilt wurde
 * 8. Klicken Sie auf die "Markiere diese Version für die Übersetzung"-Taste
 * 9. Zuletzt nun zurück zu der Seite

Now you will see a new link at the top, "Translate this page", that lets translators to translate the page. You might have a look at the translation tutorial which uses this page as an example and try out few translations now. Then return here for the next step.

Schritt 4: Änderungen durchführen
Tracking changes is a very important feature, so let's make some changes and see how it works. When you open the page for editing you will see that it has been modified with markers like. These are added by the extension and help it identify which unit is which. This allows you to rearrange and edit those units. When editing the page, the markers should be left alone and their position in relation to the unit they belong to should not be changed. When moving a unit, move the unit marker, too. When deleting a unit, delete the marker too. When adding new paragraphs, new markers will be added by the software. Do not try to do this manually, it may confuse the software. &lt;languages /> &lt;translate> &lt;!--T:1--> 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 summer time. It has marvelous beaches with a lot of seagulls. == Services == &lt;!--T:2--> &lt;!--T:3--> It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day. In 2009 January the roof of the church in the island fell down. It was rebuilt collaboratively in the following summer. &lt;/translate>


 * 10. Make some additions as highlighted above
 * 11. Click the "marked for translation" link at the top
 * 12. Observe the changes
 * 13. Click the "Mark for translation" button
 * 14. Return to the original page

If you made translations as suggested in the previous step, you can now see those translations linked at the top of the page. You will also see that the translation is not 100 % up to date. If you look at the translated version, you will see the new paragraph in English, and the changed paragraphs are replaced with the English text. If you go to the translation view, you see that the unit is marked as in need of updating.

The translation template view helps you to see what parts of the page are constant in all language versions (the "translation page template", i.e. the parts outside translate tags) and also shows you if units have been moved around or deleted.

There might be a slight delay before all translated versions are updated, because there can be many pages to update.

You now know the basics, but this tutorial will continue with more things that you are likely to encounter.

Schritt 5: Andere Wiki-Elemente hinzufügen
You have a basic translatable page now, but it is very dull. Let's add an image and some other stuff to make it look more like a normal wiki page and see how those elements interact with translation.

We also removed a paragraph, including its unit marker, and replaced it with a list, so you can see what happens.

&lt;languages /> &lt;translate> &lt;!--T:1--> 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 and tourists like to visit it in the summer time. It has marvelous beaches with a lot of seagulls. == Services == &lt;!--T:2--> &lt;!--T:3--> It doesn't have many services. There is a shop and a car ferry visits the island from the mainland once a day. Main events: * The roof of the church fell down in 2009 * New church was built in 1877 &lt;/translate>
 * 15. Add an image, a category and a list to the page as shown below
 * 16. Save the page
 * 17. Click the link "marked for translation" at the top of the page
 * 18. Verify that the changes look as intended
 * 19. Click the "Mark this version for translation" button
 * 20. Return to the translatable page

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. 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 "Translate this page" link at the top
 * 22. Select "qqq - Page documentation" 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"

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.

Similarly, for links there are many ways to do it. We used " Special:MyLanguage/Seagull ", 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're 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.

Last words
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.

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.

You have now created a translatable page and tried all of the common actions that can be performed on translatable pages. 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.