Quelltext der Seite Hilfe:Eine Übersetzung bereitstellen und freigeben

{{Bildwegweiser | Titel = [[:{{ns:category}}:Hilfe|Hilfe]] | Größe =  35px | Hilfe}}
Das Wiki ''{{SITENAME}}'' bietet durch die [https://www.mediawiki.org/wiki/Extension:Translate/de Wiki-Erweiterung Übersetzen] die Möglichkeit Textübersetzungen von Seiten vornehmen zu lassen. Dazu bedarf es gewisser Schritte, um eine Seite als übersetzbar freizugeben. Die allgemeine Verfahrensweise findet man auf [https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_administration/de „MediaWiki (Hilfe:Übersetzung von Seiten verwalten)“] im Detail erklärt. Hier folgen die wichtigsten Schritte.


__INHALTSVERZEICHNIS__

== Übersetzung vorbereiten ==
Eine Seite als Übersetzungs-Administrator übersetzbar freizuschalten ist erst dann sinnvoll, falls der Seiteninhalt als „fertig“ erachtet werden kann oder klar ist, dass die vorhandenen Textabschnitte grundlegend so bleiben. Je nach Struktur der Seite kann man zwei Verfahrensweisen anwenden:

{| class="booktable vertical-align-top"
|-
! style="width:40%" | Einfache Seitenstruktur
! style="width:60%" | Komplizierte Seitenstruktur
|-
| Zum Beispiel, wenn sich fast nur Text auf der Seite befindet und keine komplizierte Wiki-Syntax aus diversen Vorlagen, Links und Bildern usw.:
# auf [[Spezial:Seitenvorbereitung]] die „Seite zur Übersetzung vorbereiten“
# Seite eingeben und den Anweisungen folgen. Der Assistent wird die Seite analysieren und die nötigen Übersetzungs-Markierungen ''&lt;languages/&gt;'' und  ''&lt;translate&gt;''…''&lt;/translate&gt;'' unabänderlich vorgeben.
| Zum Beispiel wenn sich Bilder, Tabellen oder Vorlagen auf der Seite befinden<br/>oder nur gewisse Teile übersetzt werden sollen und andere Teile aber konstant bleiben<br/>oder wenn man den Übersetzern reines Text-Übersetzten ermöglichen möchte, ohne sich in komplexer Wiki-Syntax auskennen zu müssen:
# am Seitenanfang ''&lt;languages/&gt;'' platzieren
# alle zu übersetzenden Texte mit ''&lt;translate&gt;''Übersetzungstext''&lt;/translate&gt;'' kennzeichnen (Details siehe auf [https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_administration/de MediaWiki&nbsp;– Hilfe:Übersetzung von Seiten verwalten)])
# Seite abspeichern
Am Seitenanfang findet sich nun der Link „<span style="color:rgb(6, 69, 173);">{{int:translate-tag-markthis}}</span>“, um die Übersetzung via [[Spezial:Übersetzung von Seiten]] freizuschalten.
|}

Generell werden also die Textfragmente identifiziert, …
 &lt;translate&gt;Übersetzungstext&lt;/translate&gt;
… die übersetzbar sein sollen und Identifikatoren (im Beispiel <code>&lt;!-- T:17 --&gt;</code>) werden wie folgt eingefügt:
 &lt;translate&gt;&lt;!-- T:17 --&gt;
 Übersetzungstext
 &lt;/translate&gt;
Diese Struktur ''sollte nicht verändert'' werden. Wenn man später auf der Originalseite dennoch Text abändern muss, dann muss man die Seite ''erneut als Übersetzung'' freigeben, oder neue Textabschnitte, die außerhalb von schon existierenden Übersetzungs-Textfragmenten hinzugefügt werden mittels &lt;translate&gt;Übersetzungstext&lt;/translate&gt; kennzeichnen und das Prozedere des Freischaltens durchführen. Dazu nach dem Speichern der Seite den Link oben auf der Seite beachten:
 {{int: translate-tag-markthisagain}}
… und erneut auf ''<span style="color:rgb(6, 69, 173);">zur Übersetzung freigegeben</span>'' klicken, um die Änderungen in die Seitenübersetzung wieder einzupflegen. Andernfalls bleiben die Übersetzungen blockiert.

=== Übersetzungen sinnvoll strukturieren ===
Im folgenden einige Beispiele Übersetzungstexte sinnvoll zu strukturieren, damit Elemente wie Verlinkungen oder Bild-Beschriftungen funktionieren.

<div class="definition-inline">
; Verlinkungen&#58; : können mit der Vorlage „{{Tlx|localized link|…}}“ oder kurz <code><nowiki>{{ll|…}}</nowiki></code> eingebunden werden
</div>
 <nowiki>{{ll | Seitenlink | Seitenlink-Text übersetzt}}</nowiki>
<div class="definition-inline">
; Bild-Beschriftungen&#58;: entweder als explizite Übersetzung mit &lt;translate&gt;Beschriftungstext&lt;/translate&gt; kennzeichnen oder konstant beabsichtigt Elemente in einer Übersetzungs-Variable verpacken
</div>
 <nowiki>[[Datei:Blatt.jpg|</nowiki>&lt;translate&gt;Beschriftung&lt;/translate&gt;<nowiki>]]</nowiki>
… oder die Übersetzungs-Variable anwenden …
 <nowiki><tvar|</nowiki>''vorlage_xy''<nowiki>>{{Tlx|Vorlagenname}}</></nowiki>
 <nowiki>[[<tvar|</nowiki>''Blatt_Bildlink''<nowiki>>Datei:Blatt.jpg</>|Beschriftung]]</nowiki>
… diese kann dann im Übersetzungssystem mit <code><nowiki>$vorlage_xy</nowiki></code> oder <code><nowiki>[[$Blatt_Bildlink|übersetzte Beschriftung]]</nowiki></code> verendet werden.

== Verwalten von Übersetzungen ==

Via [[Spezial:Übersetzung von Seiten]] lassen sich Übersetzungen verwalten. Die Struktur der Seiten wird auf Unterseiten aufgeteilt und sieht folgt aus:
         ┌─ <span style="color:rgb(6, 69, 173);">Seite</span> ───┐
         │ Original- │              Seitencode editierbar
         │  seite    │              via „Bearbeiten“
         └───────────┘
       ↙       ↓       ↘
  <span style="color:rgb(6, 69, 173);">Seite/en</span>   <span style="color:rgb(6, 69, 173);">Seite/fr</span>   <span style="color:rgb(6, 69, 173);">Seite/it</span>    Seiten-URL
 ┌────────┐ ┌────────┐ ┌────────┐
 │ Page in│ │ Page en│ │ Pagina │   nicht im Seitencode editierbar,
 │ English│ │français│ │ in ita-│   nur Textfragmente via „Übersetzen“
 └────────┘ └────────┘ └ liano ─┘

Wird die Originalseite nach der Übersetzungsfreigabe abgeändert, stimmen die Entsprechungen der z.T. neuen Textfragmente im Originaltext und der schon angelegten Übersetzungstexte u.U. nicht mehr völlig überein. Dann muss man wieder das Prozedere <span style="color:rgb(6, 69, 173);">zur Übersetzung freigegeben</span> durchführen, um die neuen Textfragmente in das Übersetzungssystem einzupflegen. 

'''Wichtig zu beachten:'''
* bei abgeänderten Original-Textfragmenten wird auf der Übersetzungsseite ''nicht'' das schon vorhandene alte Übersetzungs-Textfragment angezeigt, sondern wieder ''der unübersetzte Originaltext''(!). Man muss also die betreffenden Textfragmente durcharbeiten, damit wieder die korrekte&nbsp;– nun aktualisierte Übersetzung&nbsp;– zur Anzeige kommt. Dies stellt sicher, dass wirklich nur tatsächlich aktuelle Übersetzungen angezeigt werden.

[[Kategorie: Hilfe]]
[[Kategorie: Übersetzen]]