Hilfe:Eine Übersetzung bereitstellen und freigeben: Unterschied zwischen den Versionen
(+Tipp: Helferlein Vorlagen-Programmierung) |
|||
(9 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
{{Bildwegweiser Hilfe}} | {{Bildwegweiser Hilfe}} | ||
− | Diese Seite beschreibt wie man Übersetzungen verwaltet | + | 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__ | __INHALTSVERZEICHNIS__ | ||
Zeile 6: | Zeile 8: | ||
== Übersetzung vorbereiten == | == Ü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 | + | Eine Seite als übersetzbar freizuschalten ist erst dann sinnvoll, … |
* wenn der Seiteninhalt als mehr oder weniger „fertig“ erachtet werden kann, oder | * wenn der Seiteninhalt als mehr oder weniger „fertig“ erachtet werden kann, oder | ||
* wenn klar ist, dass die vorhandenen Textabschnitte grundlegend so bleiben und | * wenn klar ist, dass die vorhandenen Textabschnitte grundlegend so bleiben und | ||
Zeile 14: | Zeile 16: | ||
{{Prozentstatus der Aufgabe|Benutzerrechte für Übersetzung anlegen überprüfen|0%}} | {{Prozentstatus der Aufgabe|Benutzerrechte für Übersetzung anlegen überprüfen|0%}} | ||
+ | === Schritte zum Bereitstellen === | ||
Je nach Struktur der Seite kann man zwei Verfahrensweisen anwenden: | Je nach Struktur der Seite kann man zwei Verfahrensweisen anwenden: | ||
Zeile 22: | Zeile 25: | ||
|- | |- | ||
| Zum Beispiel, wenn sich fast nur Text auf der Seite befindet und keine komplizierte Wiki-Syntax aus diversen Vorlagen, Links und Bildern usw.: | | 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“ | # 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 ''<languages/>'' und ''<translate>''…''</translate>'' unabänderlich vorgeben. | # Seite eingeben und den Anweisungen folgen. Der Assistent wird die Seite analysieren und die nötigen Übersetzungs-Markierungen ''<languages/>'' und ''<translate>''…''</translate>'' 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: | | 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}} > {{int:pageinfo-toolboxlink}}) | ||
# am Seitenanfang ''<languages/>'' platzieren | # am Seitenanfang ''<languages/>'' platzieren | ||
# alle zu übersetzenden Texte mit ''<translate>''Übersetzungstext''</translate>'' kennzeichnen (Details siehe auf [https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_administration/de MediaWiki – Hilfe:Übersetzung von Seiten verwalten]) | # alle zu übersetzenden Texte mit ''<translate>''Übersetzungstext''</translate>'' kennzeichnen (Details siehe auf [https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_administration/de MediaWiki – Hilfe:Übersetzung von Seiten verwalten]) | ||
# Seite abspeichern | # 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. | 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 <translate>Übersetzungstext</translate> usw.. | ||
|} | |} | ||
+ | |||
+ | === Seitenstrukturen einer übersetzbaren Seite === | ||
Generell werden also die Textfragmente identifiziert, … | Generell werden also die Textfragmente identifiziert, … | ||
Zeile 50: | Zeile 59: | ||
; Verlinkungen: : 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. | ; Verlinkungen: : 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> | </div> | ||
− | <nowiki>{{ll | | + | <nowiki>{{ll |Seite Originalsprache | Seitenlink-Text übersetzt}}</nowiki> |
+ | |||
<div class="definition-inline"> | <div class="definition-inline"> | ||
; Bild-Beschriftungen:: entweder als explizite Übersetzung mit <translate>Beschriftungstext</translate> kennzeichnen oder konstant beabsichtigt Elemente in einer Übersetzungs-Variable verpacken | ; Bild-Beschriftungen:: entweder als explizite Übersetzung mit <translate>Beschriftungstext</translate> kennzeichnen oder konstant beabsichtigt Elemente in einer Übersetzungs-Variable verpacken | ||
Zeile 63: | Zeile 73: | ||
Schnellzugriff: | Schnellzugriff: | ||
− | * [[Spezial: | + | * [[Spezial:Übersetzung von Seiten]] (Seitenliste aller Übersetzungsseiten) |
Zeile 83: | Zeile 93: | ||
* 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 – nun aktualisierte Übersetzung – zur Anzeige kommt. Dies stellt sicher, dass wirklich nur tatsächlich aktuelle Übersetzungen angezeigt werden. | * 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 – nun aktualisierte Übersetzung – zur Anzeige kommt. Dies stellt sicher, dass wirklich nur tatsächlich aktuelle Übersetzungen angezeigt werden. | ||
− | [[Kategorie: Hilfe]] | + | [[Kategorie: Hilfe{{#translation:}}]] |
− | [[Kategorie: Übersetzen]] | + | [[Kategorie: Übersetzen{{#translation:}}]] |
+ | [[Kategorie:Übersetzungen verwalten]] |
Aktuelle Version vom 1. März 2020, 14:14 Uhr
Diese Seite beschreibt wie man Seiten-Übersetzungen verwaltet. Das Wiki Open Source Ecology - Germany bietet durch die Wiki-Erweiterung Übersetzen die Möglichkeit Textübersetzungen von Seiten vorzunehmen. Das Übersetzen selbst, erfolgt mit dem Übersetzungsassistenten, und ist in der 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 {{Multilingual switch}} verwendet werden, z.B. auch innerhalb der Vorlagenprogrammierung.
Übersetzung vorbereiten
Um eine Seite als übersetzbar freizugeben, dazu bedarf es gewisser Schritte. Die allgemeine Verfahrensweise findet man auf „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, …
- 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 Seiteninhaltssprache (im Seitenmenü unter Seiteninformationen) auf die richtige Inhaltssprache gestellt ist, damit das sinnvolle Übersetzungsmöglichkeiten erkennt
Zu tun – Benutzerrechte für Übersetzung anlegen überprüfen ()
Schritte zum Bereitstellen
Je nach Struktur der Seite kann man zwei Verfahrensweisen anwenden:
Einfache Seitenstruktur | 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.:
|
Zum Beispiel wenn sich Bilder, Tabellen oder Vorlagen auf der Seite befinden oder nur gewisse Teile übersetzt werden sollen und andere Teile aber konstant bleiben oder wenn man den Übersetzern reines Text-Übersetzten ermöglichen möchte, ohne sich in komplexer Wiki-Syntax auskennen zu müssen:
Am Seitenanfang findet sich nun der Link „Diese Seite zur Übersetzung freigeben“, um die Übersetzung via Spezial:Übersetzung von Seiten freizuschalten. Tipp zur Bearbeitungshilfe: in den eigenen Einstellungen 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 <translate>Übersetzungstext</translate> usw.. |
Seitenstrukturen einer übersetzbaren Seite
Generell werden also die Textfragmente identifiziert, …
<translate>Übersetzungstext</translate>
… die übersetzbar sein sollen und Identifikatoren (im Beispiel <!-- T:17 -->
) werden wie folgt eingefügt:
<translate><!-- T:17 --> Übersetzungstext </translate>
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 <translate>Übersetzungstext</translate> kennzeichnen und das Prozedere des Freischaltens durchführen. Dazu nach dem Speichern der Seite den Link oben auf der Seite beachten:
Diese Seite wurde [$1 bearbeitet], nach dem Bereitstellen zum Übersetzen. Diese Seite muss daher [$2 erneut zur Übersetzung freigegeben] werden.
… und erneut auf zur Übersetzung freigegeben 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.
- Kategorielinks:
- mittels
[[Category:Name der Kategorie{{#translation:}}]]
oder[[Category:Name der Kategorie{{#translation:}}|<translate>abweichende Sortierung</translate>]]
- Verlinkungen:
- können mit der Vorlage „{{localized link|…}}“ oder kurz
{{ll|…}}
automatisch eingebunden werden. Verlinkungen auf Kategorien sind so möglich, nicht jedoch die Kategorisierung selber.
{{ll |Seite Originalsprache | Seitenlink-Text übersetzt}}
- Bild-Beschriftungen:
- entweder als explizite Übersetzung mit <translate>Beschriftungstext</translate> kennzeichnen oder konstant beabsichtigt Elemente in einer Übersetzungs-Variable verpacken
[[Datei:Blatt.jpg|<translate>Beschriftung</translate>]]
… oder die Übersetzungs-Variable anwenden …
<tvar|vorlage_xy>{{Tlx|Vorlagenname}}</> [[<tvar|Blatt_Bildlink>Datei:Blatt.jpg</>|Beschriftung]]
… diese kann dann im Übersetzungssystem mit $vorlage_xy
oder [[$Blatt_Bildlink|übersetzte Beschriftung]]
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:
┌─ Seite ───┐ │ Original- │ Seitencode editierbar │ seite │ via „Bearbeiten“ └───────────┘ ↙ ↓ ↘ Seite/en Seite/fr Seite/it 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 zur Übersetzung freigegeben 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 – nun aktualisierte Übersetzung – zur Anzeige kommt. Dies stellt sicher, dass wirklich nur tatsächlich aktuelle Übersetzungen angezeigt werden.