Quelltext der Seite Hilfe:Eine Übersetzung bereitstellen und freigeben

{{Bildwegweiser Hilfe}}
Diese Seite beschreibt wie man Seiten-Übersetzungen verwaltet. Das Wiki ''{{SITENAME}}'' bietet durch die [https://www.mediawiki.org/wiki/Extension:Translate/de Wiki-Erweiterung Übersetzen] die Möglichkeit Textübersetzungen von Seiten vorzunehmen. Das Übersetzen selbst, erfolgt mit dem Übersetzungsassistenten, und ist in der [https://www.mediawiki.org/wiki/Help:Extension:Translate/Translation_example/de MediaWiki Hilfe:Erweiterung:Übersetzen/Übersetzungsbeispiel] beschrieben. Beim Seitenübersetzen wird davon ausgegangen, dass alle übersetzten Seiten miteinander konsistent und inhaltsgleich, also 1 zu 1, bleiben, nur eben übersetzt in eine andere Sprache; es sind also absolut ''inhaltsgleiche Seiten'' gemeint. Will man hingegen ''inhaltsähnliche'' Sprachen-Seiten anlegen, dann bitte in der [[Hilfe: Übersetzen]] den Abschnitt »Ungleiche Inhalte bei Original- und „Übersetzungsseite“ sich zu Gemüte führen.

Will man hingegen nur kleinere Textfragmente übersetzen, kann die Vorlage {{Tlx|Multilingual switch}} verwendet werden, z.B. auch innerhalb der [[Hilfe:Vorlagenprogrammierung|Vorlagenprogrammierung]].

__INHALTSVERZEICHNIS__

== Übersetzung vorbereiten ==

Um eine Seite als übersetzbar freizugeben, dazu bedarf es gewisser Schritte. 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. Ist eine Übersetzung einmal bereitgestellt, wird man dann mit dem Übersetzungsassistenten arbeiten und eigentlich nicht mehr im WikiEditor. Hier folgen die wichtigsten Schritte, wie man eine Übersetzung bereitstellt.

Eine Seite als übersetzbar freizuschalten ist erst dann sinnvoll,&nbsp;…
* wenn der Seiteninhalt als mehr oder weniger „fertig“ erachtet werden kann, oder
* wenn klar ist, dass die vorhandenen Textabschnitte grundlegend so bleiben und
* wenn die Seiten''inhalts''sprache (im Seitenmenü unter <span class="pseudolink">{{int:pageinfo-toolboxlink}}</span>) auf die richtige Inhaltssprache gestellt ist, damit das sinnvolle Übersetzungsmöglichkeiten erkennt
{{Prozentstatus der Aufgabe|Benutzerrechte für Übersetzung anlegen überprüfen|0%}}

=== Schritte zum Bereitstellen ===
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.:
# richtige Seitensprache einstellen falls nicht Deutsch ({{int:pageinfo-toolboxlink}} im Seitenmenü)
# 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:
# richtige Seitensprache einstellen falls nicht Deutsch (im seitlichen Randmenü: {{int:toolbox}}&nbsp;&gt; {{int:pageinfo-toolboxlink}})
# 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.

{{links|{{Logo|Tip}}}} '''Tipp zur Bearbeitungshilfe:''' in den eigenen [[Special:{{int:mypreferences}} | {{int:mypreferences}}]] kann man das Helferlein zur „Vorlagenprogrammierung“ einschalten. Dies erweitert den Wiki-Editor zusätzich um das Menü „Programmierung“, in dem ein Abschnitt „Übersetzen“ enthalten ist; so kann man per Klick leichter Text-Code-Auszeichnungen einfügen, wie &lt;translate&gt;Übersetzungstext&lt;/translate&gt; usw..
|}

=== Seitenstrukturen einer übersetzbaren Seite ===

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">
; Kategorielinks&#58; : mittels <code><nowiki>[[Category:Name der Kategorie{{#translation:}}]]</nowiki></code><br />oder <code><nowiki>[[Category:Name der Kategorie{{#translation:}}|&lt;translate>abweichende Sortierung&lt;/translate>]]</nowiki></code>
</div>
<div class="definition-inline">
; Verlinkungen&#58; : können mit der Vorlage „{{Tlx|localized link|…}}“ oder kurz <code><nowiki>{{ll|…}}</nowiki></code> automatisch eingebunden werden. Verlinkungen auf Kategorien sind so möglich, nicht jedoch die Kategorisierung selber.
</div>
 <nowiki>{{ll |Seite Originalsprache | 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 ==

Schnellzugriff:
* [[Spezial:Übersetzung von Seiten]] (Seitenliste aller Übersetzungsseiten)


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{{#translation:}}]]
[[Kategorie: Übersetzen{{#translation:}}]]
[[Kategorie:Übersetzungen verwalten]]