Help:Extension:Translate/Page translation administration/de

Was? Das Seitenübersetzungs-Feature erlaubt eine geregelte Übersetzung von Wikiseiten in andere Sprachen. Das bedeutet, dass der Inhalt jeder Übersetzung in der Regel auf dem gleichen Stand ist wie die Quellseite. Im Gegensatz dazu sind zum Beispiel die verschiedenen Versionen von Wikipedia-Artikeln in unterschiedlichen Sprachen vollständig unabhängig voneinander. Es wird angenommen, dass die Seiten von lediglich einer primären Sprache in andere übersetzt werden, aber Übersetzer können auch andere Übersetzungen nutzen, falls sie existieren.

Weshalb? Ohne Hilfe wird das Übersetzen in andere Sprachen schnell im besten Fall zu einem Zeitfresser, im schlimmsten Falle jedoch zu einem nicht mehr wartbaren Chaos. Mit dem Seitenübersetzungs-Feature kannst Du dieses Chaos vermeiden und den Übersetzungsprozess strukturieren. Der Grundgedanke ist, dass der Quelltext in kleinere Einheiten, die einzeln übersetzt werden, aufgeteilt wird. Bei diesem Verfahren können Änderungen eingegrenzt werden und die Übersetzer müssen lediglich die Übersetzungen der Einheiten, deren Quelltext verändert worden ist, aktualisieren. Außerdem versetzt es Übersetzer in die Lage, an Einheiten überschaubarer Größe zu arbeiten und die Arbeit auf mehrere Übersetzer zu verteilen oder die Übersetzung später fortzusetzen, weil sie nicht alles auf einmal übersetzen müssen.

Wer? Diese Seite erweitert das Seitenübersetzungsbeispiel um einen tieferen Einblick in die Funktionen des Systems und empfiehlt bewährte Vorgehensweisen für eine breite Auswahl an Anwendungsfällen. Diese Seite ist für Übersetzungsadministratoren und generell alle, die den Ausgangstext der zu übersetzenden Seiten bearbeiten, auch wenn das Administrationsrecht zum Genehmigen von Übersetzungsänderungen fehlt.

Lebenslauf einer übersetzbaren Seite
Rollen. Mehrere Personen sind in den Prozess des Schreibens und Übersetzens einer Wiki-Seite involviert: Der ursprüngliche Schreiber erstellt die Seite, jemand korrigiert Schreibfehler, ein Übersetzungsadministrator markiert die Seite für die Übersetzung, Übersetzer übersetzen, jemand nimmt Änderungen an der Seite vor, ein Übersetzungsadministrator markiert diese Änderungen für die Übersetzung und Übersetzer aktualisieren die Übersetzungen. Diese Rollen können sich überlappen, aber die Letztverantwortung für eine reibungslose Übersetzung bleibt beim (Seiten-)Übersetzungsadministrator. Der Administrator entscheidet, wann eine Seite zum ersten Mal bereit ist für eine Übersetzung, stellt sicher, dass die Segmentierung zweckdienlich ist und genehmigt (oder korrigiert) Änderungen.

Vorbereitung. Um etwas zu übersetzen, muss es erst geschrieben werden. Wenn du schon einmal mit der Translate-Extension übersetzt hast, siehe den Abschnitt zur Migration weiter unten. Wenn du viele Übersetzungen und auch noch schnell brauchst, ist entscheidend, dass der Ausgangstext in gutem Zustand ist. Bevor du eine Seite zur Übersetzung freigibst, bitte jemanden, die Seite Korrektur zu lesen, und bitte, sofern möglich, einen Sprachexperten, den Text noch klarer und prägnanter zu formulieren. Schwieriger Wortschatz und schwer zu verstehende Sätze sind ein K.O.-Kriterium für viele freiwilligen Übersetzungen. Auch Markup kann Übersetzern Schwierigkeiten bereiten, aber als Übersetzungsadministrator kannst du diese Punkte vermeiden, siehe auch den Abschnitt über den Umgang mit Markup weiter unten. Natürlich forcieren Änderungen am Ausgangstext die Aktualisierung der bestehenden Übersetzungen, demnach ist es besser zu warten, bis sich die Inhalte der Seite stabilisiert haben. Andererseits passieren immer wieder Änderungen, doch das System kann damit gut umgehen, siehe auch den Abschnitt über Änderungen weiter unten.

Kennzeichnen. Wenn der Text bereit ist zur Übersetzung, kann jeder die zu übersetzenden Textteile für die Übersetzung kennzeichnen, indem diese Teile innerhalb des -Tags gesetzt werden und ein $language-„Schlüssel“ der Seite hinzugefügt wird. Der letztere fügt eine Liste aller Übersetzungen der Seite hinzu, inklusive Vollständigkeits- und Aktualitäts-Angaben (in Prozent). Dies ist der einzige Hinweis darauf, dass Übersetzungen existieren. Siehe auch den Abschnitt über das Wiki-Markup. Das System erkennt, wenn die Tags auf der Seite eingefügt werden, und die Seite bekommt einen Link, um zur Übersetzung markiert zu werden. Es wird sich auch beschweren und das Speichern verhindern, wenn du zum Beispiel einen schließenden Tag vergessen hast. Die zu übersetzende Seite wird auch auf Special:PageTranslation als „bereit zum Markieren“ angezeigt.

Freigeben. Nach dem Kennzeichnen gibt der Übersetzungsadministrator die Seite zur Übersetzung frei. Die Bedieneroberfläche dazu ist im Seitenübersetzungsbeispiel erklärt. Der Übersetzungsadministrator trägt dabei die Verantwortung, eine sinnvolle Aufteilung und eine ordnungsgemäße Kennzeichnung sicherzustellen. Die Seite kann nach zwischenzeitlichen Abänderungen erneut freigegeben werden, siehe unten, wie man Änderungen macht, die nur eine geringe Störung verursachen. Das Freigeben der Seite startet einen Hintergrundprozess mittels der MediaWiki-Auftragswarteschlange. Dieser Prozess geht durch jede Übersetzungsseite und erneuert sie: Änderungen in der Übersetzungsseiten-Vorlage zeigen sich als veraltete Übersetzungen und werden zeitweilig vom Text der Originalquelle ersetzt. Andererseits wird die Übersetzungs-Bedieneroberfläche unmittelbar auf den neuesten Stand gebracht.

Änderungen. Benutzer können weiterhin Änderungen am übersetzbaren Seitenquelltext vornehmen. Die Änderungen werden für Benutzer sichtbar, die die Seite in der Ausgangssprache ansehen, jedoch stehen die Übersetzungen den Übersetzungseinheiten entgegen, die aus der letzten  übersetzbaren Seitenversion &npsp;– die als übersetzt markiert wurde&npsp;– extrahiert wurden: Die Übersetzungsseiten werden dann als zu 100&#8239;% aktuell angezeigt, wenn alle Übersetzungseinheiten übersetzt wurden, auch wenn die Quellseite neue Änderungen enthält. Man kann leicht erkennen, ob es nicht markierte Änderungen gibt, indem man die übersetzbare Seite in der Ausgangssprache anschaut: oben befindet sich ein Hinweis, der besagt, dass man diese Seite übersetzen kann und der auch auf die Änderungen verlinkt, falls irgendwelche vorhanden sind.

Ungültigkeit. Falls Änderungen an der übersetzbaren Ausgangsseite vorgenommen werden, erhält der Übersetzungsadministrator für jeden Abschnitt die Option „Übersetzungen nicht als veraltet markieren“. Wenn ein Abschnitt ungültig ist (nicht als veraltet markiert wurde), bekommen die übersetzbaren Sprachen für jene Abschnitte eine rosa Hintergrundfarbe und im Übersetzungsassistenten wird ein Uhrensymbol angezeigt. Wenn ein Abschnitt nicht ungültig gemacht wird, sind keine Änderungen für die Leser der übersetzten Seiten sichtbar, und die Übersetzer müssen den Abschnitt innerhalb des Übersetzungsassistenten prüfen, um die Änderungen zu sehen.

Ausgangssprache. Es gibt auch eine Übersetzungsseite mit dem Sprachcode der Ausgangssprache: Sie enthält keine zusätzlichen Tags und sonstigen Markups für die Seitenübersetzung, die in der übersetzbaren Seitenquelle verwendet werden. Diese Seite ist nicht über die Benutzeroberfläche verlinkt, ist jedoch praktisch, wenn Du beispielsweise die Seite transkludieren (normalerweise für übersetzbare Vorlagen) oder exportieren möchtest. Zum Beispiel, diese Seite ist verfügbar auf Help:Extension:Translate/Page translation administration/en.

Ändern der Ausgangssprache. Die Erweiterung setzt normalerweise voraus, dass sich die übersetzbare Quellseite in der Standardsprache des Wikis befindet. Administratoren können die Spracheinstellung einer bestimmten Seite mithilfe der Seite "Spezial: Seitensprache" ändern, sodass sie als Quellseite für die Übersetzung verwendet werden kann. Weitere Informationen findest Du unter Sprache des Seiteninhalts.

Gesperrte Übersetzungsanfragen. Einige übersetzbare Seiten haben einen Inhalt, der nur für einen bestimmten Zeitraum interessant ist. Zum Beispiel Ankündigungen und regelmäßige Statusupdates, wie die Wikimedia-Monatshighlights. Du kannst diese Seiten mit Übersetzungen versehen, sie jedoch vor der Übersetzungsoberfläche verbergen. Dies verhindert keine weiteren Übersetzungen der Seiten, verringert jedoch die Wahrscheinlichkeit, dass ein Benutzer versehentlich mit der Übersetzung der Seite beginnt, erheblich. Entmutigen und seine Rückgängigmachung erfolgen aus Special:PageTranslation.

Priorisieren von Sprachen. Du kannst auch eine Liste von Sprachen definieren, in die Du bevorzugt übersetzt haben willst. Wenn Du die Sprachenliste leer lässt, werden alle Sprachen zugelassen. Die Seite verhält sich für die Sprachen, die nicht in der Prioritätsliste aufgeführt sind, wie eine entmutigte Seite (siehe vorherigen Absatz), und Übersetzer werden benachrichtigt, wenn sie in diese Sprachen übersetzen. Du kannst auch die Übersetzung in andere Sprachen verhindern, z. B. wenn Übersetzungen gerade an anderer Stelle verwendet werden und Du sie nur in bestimmten Sprachen verwenden kannst.

Gruppieren. Es ist möglich, zusammengehörende Seiten zu gruppieren. Diese Gruppen funktionieren wie alle anderen Nachrichtengruppen. Sie haben ihre eigenen Statistiken und enthalten alle Nachrichten der Untergruppen: in diesem Fall übersetzbare Seiten. Diese Funktionalität befindet sich derzeit in Special:AggregateGroups. Aggregierte Nachrichtengruppen werden standardmäßig in Special:LanguageStats in der Gruppenauswahl unter Special:Translate reduziert.

Verschieben. Du kannst übersetzbare Seiten wie jede andere Seite verschieben. Beim Verschieben kannst Du wählen, ob Du auch nicht übersetzte Unterseiten verschieben möchtest. Beim Verschieben werden die vielen verwandten Seiten mithilfe eines Hintergrundjobs verschoben. Während des Verschiebens kann die Seite nicht übersetzt werden. Der Abschluss wird im Seitenübersetzungsprotokoll vermerkt.


 * Warnung: Fehler beim Verschieben von Unterseiten: Wenn die übersetzte Seite, die Du verschieben möchtest, auch übersetzte Unterseiten enthält, musst Du die Unterseiten zuerst verschieben, bevor Du die übergeordnete Seite verschiebst . Siehe den Bug für Details: T114592.

Löschen. Wie beim Verschieben wird auf das Löschen vom normalen Ort aus zugegriffen. Du kannst entweder die gesamte übersetzbare Seite oder nur eine Übersetzungsseite über die Schaltfläche "Löschen" löschen. Durch das Löschen werden auch alle zugehörigen Übersetzungs-Seiten gelöscht. Während des Verschiebens werden die Seiten im Hintergrund mit der Zeit gelöscht, und der Abschluss wird im Seitenübersetzungsprotokoll vermerkt. Das Löschen erfordert die Berechtigung "Löschen" und "Übersetzung", aber einzelne übersetzte Seiten können immer mit "Löschen" gelöscht werden.

Zurücksetzen. Ebenso funktioniert das Zurücksetzen von fehlerhaften Bearbeitungen wie gewohnt (einschließlich der Rollback-Schaltfläche): Du musst nur den betroffenen Übersetzungsteil bearbeiten, und die Übersetzungsseite wird ebenfalls aktualisiert. Um die Bearbeitung des Übersetzungsabsatzes von der Bearbeitungs- zur Übersetzungsseite zu finden, klicke einfach auf den Link "" für den Editor und suche die zugehörige Bearbeitung.

Schützen. Es ist möglich, die übersetzbare Seite zu schützen. Übersetzte Seiten können weder geschützt werden, noch erstreckt sich der Schutz der übersetzbaren Seite auf sie. Um weitere Änderungen an Übersetzungen zu verhindern, solltest Du die Ausgangssprache als einzige Prioritätssprache hinzufügen und Übersetzungen in andere Sprachen deaktivieren (siehe oben: Priorisierung von Sprachen). Zusammen verhindern diese beiden Aktionen effektiv Änderungen sowohl an der Quellseite als auch an den Übersetzungsseiten mit den Seiten der Übersetzungseinheiten. Es ist möglich, einzelne Seiten von Übersetzungseinheiten zu schützen, dies ist jedoch nicht ratsam.

Entfernung aus der Übersetzung. Es ist auch möglich, die Freigabe einer Seite zur Übersetzung aufzuheben. Zuerst musst Du alle -Tags von der Seite entfernen. Dann kannst Du Special:PageTranslation verwenden oder dem Link oben auf der übersetzbaren Seite folgen, um sie aus der Übersetzung zu entfernen. Dadurch werden alle mit der Seitenübersetzung zusammenhängenden Strukturen entfernt, aber alle vorhandenen Seiten bleiben unverändert und können frei bearbeitet werden. Diese Aktion wird nicht empfohlen.

Anatomie einer übersetzbaren Seite
Die Übersetzung einer übersetzbaren Seite erzeugt viele Unterseiten, die im weitesten Sinne alle zusammen die übersetzbare Seite bilden: Ihr Titel wird durch den Titel der übersetzbaren  bestimmt:


 * (die Quellseite)
 * (die Übersetzungsseiten plus eine Kopie der Quellseite ohne Markup)
 * (alle Seiten der Übersetzungseinheit)

Darüber hinaus gibt es die Übersetzungsseitenvorlage und die Quellen für Übersetzungseinheiten, die aus der Quellseite extrahiert und in der Datenbank gespeichert wurden. Das System verfolgt, welche Versionen der Quellseite Übersetzungs-Tags enthalten und welche Version für die Übersetzung markiert wurde.

Jedes Mal, wenn eine Übersetzungseinheitsseite aktualisiert wird, generiert das System auch die entsprechende Übersetzungsseite neu. Dies führt zu zwei Änderungen. Die Bearbeitung der Übersetzungseinheitsseite ist in den letzten Änderungen standardmäßig ausgeblendet und kann durch Auswahl von "Übersetzungen anzeigen" im Übersetzungsfilter angezeigt werden. Andere Aktionen als das Bearbeiten (Löschen und Verschieben) der Übersetzungseinheiten-Seiten lösen keine Neuerstellung der entsprechenden Übersetzungsseite aus.

Wenn Du die Kopie der Quellseite ohne Markup benötigst, z. B. um sie in ein anderes Wiki ohne Translate einzufügen, Der Text wird angezeigt oder gespeichert.
 * Identifiziere den Quellsprachencode (für Englisch, en ) und rufe die Seite  auf.
 * Klicke auf die Schaltfläche "", um zu einer Adresse wie dieser zu gelangen, und ersetze  durch   in der Adressleiste. Drücke die Eingabetaste:

Aufteilung
Grundprinzipien:


 * 1) Der gesamte zu übersetzende Text muss von -Tags umschlossen sein. Auf einer Seite können mehrere solcher Tags-Paare vorhanden sein.
 * 2) Alles außerhalb dieser Tags wird auf keiner Übersetzungsseite geändert. Dieser statische Text wird zusammen mit den Platzhaltern, die die Stelle markieren, an der die Übersetzung jeder Übersetzungseinheit ersetzt wird, als Übersetzungsseitenvorlage bezeichnet.
 * 3) Zu viel Markup im Text erschwert es den Übersetzern, zu übersetzen. Verwende eine sinnvollere Platzierung von -Tags, wenn zu viele Markups vorhanden sind.
 * 4) Der Text innerhalb der -Tags wird in Übersetzungseinheiten aufgeteilt, zwischen denen sich eine oder mehrere Leerzeilen befinden (zwei oder mehr Zeilenvorschübe).

Einschränkungen. Die Seitenübersetzungsfunktion fügt Einschränkungen in den Text ein. Es sollte kein Markup geben, das sich über zwei oder mehr Übersetzungseinheiten erstreckt. Mit anderen Worten sollte jeder Absatz in sich geschlossen sein. Dies wird derzeit durch die Software nicht erzwungen, ein Verstoß dagegen führt jedoch zu einer falschen Wiedergabe der Seite. Dessen Schweregrad hängt davon ab, ob MediaWiki in der Lage ist, die resultierende HTML-Ausgabe zu korrigieren oder nicht.

Parsing order. Beware, the tags work differently from other tags, because they do not go through the parser. This should not cause problems usually, but may if you are trying something fancy. In more detail, they are parsed before any other tags like or, with the exception of  which is recognized by the Translate extension in some circumstances (such as rendering a page) but not in others (such as generating the list on Special:PageTranslation of pages containing ). If you want to have the literal expression "" in the source text, you should escape it like " ".

Tag placing. If possible, try to put the tags on their own lines, with no empty lines between the content and the tags. Sometimes this is not possible, for example if you want to translate some content surrounded by the markup, but not the markup itself. This is fine too, for example:

To make this work, the extension has a simple whitespace handling: whitespace is preserved, except if an opening or closing  tag is the only thing on a line. In that case the newline after the opening tag or before the closing tag is eaten. This means that they don't cause extra space in the rendered version of the page.

Variables. It is possible to use variables similar to template variables. The syntax for this is. For translators these will show up only as, and in translation pages will automatically be replaced by the value defined in the translatable page (so they are global "constants" across all its translation pages). Variables can be used to hide untranslatable content in the middle of a translation unit. It also works for things like numbers that need to be updated often. You can update the number in all translations by changing the number in the translatable page source and re-marking the page. You do not need to invalidate translations, because the number is not part of the translation unit pages.

Comma-separated values. For content such as Graph data, that needs to be parsed by the software as comma-separated values, you should separate the translation units between each comma, so that the translating editors don't use localized commas which will confuse the software.

Beispiele für Wiki-Markup
Below are listed some alternatives and suggested ways to handle different kinds of wiki markup.

{| class=wikitable Übersetzung durch angehängen eines Sprach-Suffixes: Category:Cars/fi (empfohlen)
 * Kategorien
 * width=40% | Categories can be added in two ways: in the translation page template or in one of the translation units. If you have the categories in the translation page template, all translations will end up in the same category. If you have categories inside translation units, you should teach the users a naming scheme. On the right we show two possible schemes which are independent of the technical means to adopt them.

[...] &lt;/translate>


 * Kategorie-Seitenname nicht übersetzt (genau wie die Seitennamen).
 * Eine Kategorie für jede Sprache.
 * Page translation could be used for the category itself: the categories would be linked together and the headers would be translated (but not the name of the category in links and such).

Keine Übersetzung: Category:Cars

Falsch: == Culture ==
 * Alle Übersetzungen in derselben Kategorie (gut bei nur wenigen Sprachen, schlecht bei vielen).
 * Category name not translated (can be put as is in the translation template).
 * Überschriften und Kopfzeilen
 * Headers can in principle be tied to the following paragraph, but it is better to have them separated with an empty line. This way someone can quickly translate the table of contents before going into the contents. When tagging headers, it is important to include the header markup inside the tags and insert a newline between the opening translate tag and the header markup, or MediaWiki will no longer identify them properly. For example, section editing only works with the recommended mark-up given in the example. The markup also immediately gives translators a context: they are translating a header.
 * Headers can in principle be tied to the following paragraph, but it is better to have them separated with an empty line. This way someone can quickly translate the table of contents before going into the contents. When tagging headers, it is important to include the header markup inside the tags and insert a newline between the opening translate tag and the header markup, or MediaWiki will no longer identify them properly. For example, section editing only works with the recommended mark-up given in the example. The markup also immediately gives translators a context: they are translating a header.

Falsch: == Culture ==

Empfohlene Aufteilung: &lt;translate>

Kultur
Lorem ipsum dolor. &lt;/translate>

&lt;translate> &lt;/translate>
 * Bilder
 * Images that do contain language specific content like text should include the full image syntax in an unit. Other images can only tag the description with optional hint in message documentation of the page after it has been marked.
 * Images that do contain language specific content like text should include the full image syntax in an unit. Other images can only tag the description with optional hint in message documentation of the page after it has been marked.


 * Verknüpfungen (Links)
 * Links can be included in the paragraph they are inside. This allows changing the link label, but also changing the link target to a localized version if one exists.
 * Links can be included in the paragraph they are inside. This allows changing the link label, but also changing the link target to a localized version if one exists.

If the target page is (or should be) also translatable, you should link to it by prepending  to its title. Only the link label will need to be translated, because this automatically redirects users to the translation page in their own interface language, as selected for instance via the UniversalLanguageSelector. However, to achieve a constant behavior the syntax must be used for all links.

Because headers are translated, you cannot rely on the automatically generated id's for headers. You can add your own anchors. To have them outside of the translation template you need to break up the page into multiple tag pairs around each header you want to have an anchor to. Interne Verknüpfungen: &lt;translate> Helsinki is capital of Finland. &lt;/translate>

Links zu übersetzbaren Seiten: &lt;translate> It has marvelous beaches with a lot of seagulls. &lt;/translate> Externe Links: &lt;translate> PHP (website) is a programming language. &lt;/translate> Verknüpfungen innerhalb einer Seite: &lt;translate>

Culture
Lorem ipsum dolor.

...

For more about food, see section about culture. &lt;/translate>

&lt;translate> &lt;/translate> &lt;translate> &lt;/translate>
 * Listen
 * Lists can get long, so might want to split them into multiple parts with for example five items or less in each as follows. Do so only if the items are sufficiently independent to be translate separately in all languages, don't create "lego messages": for instance, you must avoid to split a single sentence in multiple units, or to separate logically dependent parts which may affect each other (with regard to punctuation or style of the list, for instance). To split a list, use -tags. Do not insert new lines as this will break the HTML output.
 * Lists can get long, so might want to split them into multiple parts with for example five items or less in each as follows. Do so only if the items are sufficiently independent to be translate separately in all languages, don't create "lego messages": for instance, you must avoid to split a single sentence in multiple units, or to separate logically dependent parts which may affect each other (with regard to punctuation or style of the list, for instance). To split a list, use -tags. Do not insert new lines as this will break the HTML output.
 * General principles
 * Headings
 * Images
 * Tables
 * Categories
 * Links
 * Templates


 * Zahlen
 * With numbers and other non-linguistic elements you may want to pull the actual number out of translation and make it a variable. This has multiple benefits:
 * With numbers and other non-linguistic elements you may want to pull the actual number out of translation and make it a variable. This has multiple benefits:

&lt;translate> Income this month  EUR &lt;/translate> Note that this prevents the translators from localising the number by doing currency conversion. The  call makes sure the number is formatted correctly in the target language.
 * Du kannst die Zahlen ohne die Übersetzungen ungültig zu machen aktualisieren.
 * Der Übersetzungsspeicher funktioniert besser, wenn sich ändernde Zahlen ignoriert werden.


 * Vorlagen
 * Templates have varying functions and purposes, so the best solution depends on what the template is for. If the template is not a part of longer paragraph, it should be left out, unless it has parameters that need to be translated. If the template has no linguistic content itself, you don't need to do anything for the template itself.
 * For an example of templates translated with page translation, see Template:Extension-Translate. To use this template, you need to have another template similar to Translatable navigation template, because you cannot include the template by  anymore. This is not yet provided by the Translate extension itself, but that is in the plans.
 * For an example of templates translated with page translation, see Template:Extension-Translate. To use this template, you need to have another template similar to Translatable navigation template, because you cannot include the template by  anymore. This is not yet provided by the Translate extension itself, but that is in the plans.

Another way is to use the unstructured element translation to translate the template, but then the language of the template will follow the user's interface language, not the language of the page they are viewing.
 * }

Quelltext ändern
Grundprinzipien:


 * Vermeide Änderungen
 * Nimm die Änderungen so abgegrenzt wie möglich vor
 * Füge Markierungen für Übersetzungseinheiten nicht manuell hinzu

Elementmarkierungen. Wenn eine Seite für die Übersetzung markiert wird, aktualisiert das System den Quellcode und fügt eindeutige Elementmarkierungen für jede einzelne Übersetzungseinheit hinzu. Siehe Beispiel unten. Diese Markierungen sind äußerst wichtig für das System, das mittels dieser Markierungen Änderungen and den Übersetzungseinheiten verfolgt. Du solltest niemals Elementmarkierungen selbst hinzufügen. Die Markierungen stehen immer eine Zeile vor der Einheit, bei Überschriften stehen sie in derselben Zeile der Überschrift. Die andersartige Platzierung der Markierung bei Überschriften ist notwendig, damit das Bearbeiten von Abschnitten erwartungsgemäß funktioniert.

&lt;translate>

Birds
&lt;!--T:1--> Birds are animals which....

&lt;!--T:2--> Birds can fly and... &lt;/translate> Changing unit text. Changing is the most common operation for translation units. You can fix spelling mistakes, correct grammar or do other changes to the unit. When re-marking the page for translation, you will see the difference in the unit text. The same difference is also shown to translators when they update their translations. For simple spelling fixes and other cases where you don't want the existing translations to be highlighted on the translated pages, you can avoid invalidating them: translators will still see the difference if they ever update the translation for any reason.

Adding new text. You can freely add new text inside tags. Make sure that there is one empty line between adjacent units, so that the system will see it as a new unit. You can also add tags around the new text, if it is not inside existing  tags. Again, do not add unit markers yourself, the system will do it.

Deleting text. You can delete whole units. If you do so, also remove the unit marker.

Splitting units. You can split existing units by adding an empty line in the middle of a unit, or by placing tags so that they split the unit. You can either keep the unit marker with the first unit or remove it altogether. In the first case, translators see the old text when updating the old translation. If you removed the unit marker, both units will behave as if no translation ever existed, after the page is re-marked for translation.

Merging units. If you merge units, you have to remove at least all but one unit marker.

Moving units. You can move units around without invalidating translations: just move the unit marker together with the rest of the unit.

Before marking the new version of the page for translation, ensure that the best practices are followed, especially that translators get a new translation unit if the content has changed. Also make sure that there are no unnecessary changes to prevent wasting translators time. If the source page is getting many changes, it may be worthwhile to wait for it to stabilize, and push the work for translators only after that.

Unused unit translations are not deleted automatically, but that should not cause trouble.

Zum Seitenübersetzungs-Feature übergehen
If you have been translating pages before using the page translation system, you might want to migrate the pages to the new system, at least the ones you expect to have new translations and want statistics for. You will probably have existing templates for language switching and maybe different page naming conventions.

You can start migration by cleaning up, tagging and marking the source page. You can keep the existing language-switching templates while you migrate the old translations. If your pages follow the language code subpages naming convention, they will be replaced with the source text after marking the source page for translation, but you'll still be able to access translations from history.

This manual task has been partly automated by Special:PageMigration, which shows the source and target units besides each other and allows the user to adjust the units by providing a set of features mentioned later in this page.

How to use?
500px|Screenshot showing an example use of Special:PageMigration for "Help:Special pages" as page name and "fr" as language code.
 * 1) Go to Special:PageMigration
 * 2) Enter the title of the page and the language code. For example, "Help:Special pages" & "fr"
 * 3) The source text which was divided into units by Translate and the imported translations will be shown besides each other with some initial alignment.
 * 4) Use the actions available for each unit to manually do the remaining alignment
 * 5) As translated units are editable, do required manual improvements (for add translation variables, fix links and markup, etc.)
 * 6) Click on the "" button. This will create pages under the Translations namespace of the form  . The old translations have been imported into Translate.
 * 7) Else, if you wish to abort the importing, click on the 'Cancel' button.

Verfügbare Aktionen
Each row consisting of source and target unit has a set of action icons. They are used as follows:
 * 1) Add: Clicking on this action icon adds a new empty unit below the current one. Use this feature if you want to split the current unit and need a unit below.
 * 2) Swap: Clicking on this action icon swaps the content of the current unit with the unit below it. You can use this feature when the units get aligned improperly due to different ordering of sections. Or when you need to drag a unit below or above. In either case, remember it swaps with the unit below and does not create any additional units.
 * 3) Delete: Clicking on this action icon completely removes the corresponding target unit from the page and shifts the remaining target units up by one unit. Use this to remove unwanted content like code or imported translations which are present completely in the source language. Note: this irrevocable action (in the current session).

Fehlerbehebung

 * 1) If you mark a page for translation and immediately go to the special page and try to import translations, you may get an error message like "". This is because FuzzyBot didn't fuzzy the messages on the old page yet: the tool won't find an edit by FuzzyBot on the translation page. In this case, simply wait for FuzzyBot to do its job. Once an edit is seen, you can proceed with the imports.
 * 2) Please wait for some time after pressing the "" button. While the button background remains gray, there is an ongoing process of importing non-empty units. Once the button becomes colored again, the import is completed.

Tipps

 * 1) Migration will be easier if you first (before the mark to translation) check whether existing translations are similar to the original English text, and manually edit the structure of pages: break paragraphs and lists, add the missing headers (even if empty).
 * 2) Will be useful to check the result in the core translation interface - some of the units may be immediately marked as obsolete because of errors markup or if not all of the translation variables was added.
 * 3) Translation of the page title will have to be added manually. If you do not know very well the language of the imported page, you can try to find the translation of the page title among the "links here" or sometimes in redirects. Note: Please don't translate the namespace, keep it untranslated.