Hinweise zur deutschen Übersetzung

für die Liste aller Seiten

Die Summary-Zeile muss weiter unten noch einmal wiederholt werden, wo der Seitenaufbau beschrieben wird, weil sonst die Zusammenfassung dort in Seitenlisten etc. erscheint.

Vorgehensweise

Allgemeines

Es gibt (zumindest derzeit, März 2008) niemanden, der die Übersetzung koordiniert. Das bedeutet, dass jeder, der etwas beitragen will, sich selbst Seiten zum Übersetzen bzw. Aktualisieren heraussuchen kann (und muss). Die auf dieser Seite und unter Stand der Übersetzung zusammengetragenen Informationen bilden hoffentlich eine einigermaßen geeignete Basis für die weitere Arbeit an der deutschsprachigen Dokumentation. Soweit möglich sollte eine einheitliche Strukturierung der Seiten (s. u.) und eine einheitliche Terminologie verwendet werden.

In Fällen, in denen die englische Dokumentation unklar erscheint, sollte nicht einfach eine "verbesserte" deutsche Fassung geschrieben, sondern stattdessen die Unklarheiten in der englischen Version beseitigt und das Ergebnis dann übersetzt werden. Wem das zu schwierig ist, der kann ja notfalls einen deutschsprachigen Verbesserungsvorschlag an die Mailinglisten senden -- vielleicht findet sich jemand, der diesen ins Englische übersetzt und die englischsprachige Dokumentation entsprechend verbessert. Oder aber man könnte gezielt auf [pmwiki-users] oder auf pmwiki.org auf das jeweilige Problem mit der englischsprachigen Dokumentation hinweisen. Es ist wichtig, dass die deutsche Dokumentation eine Übersetzung der englischen Dokumentation ist. Ansonsten wird es sehr schwierig diese aktuell zu halten.

Von Interesse könnte auch die Seite Localization sein, auf der Infos zur Übersetzung auf Englisch zusammengetragen sind.

Prioritätensetzung

Natürlich kann jeder sich den Seiten zuwenden, die er für die Wichtigsten hält. Ganz allgemein wäre es aber vermutlich hilfreich, wenn vordringlich die im Dokumentations-Index aufgeführten Seiten auf einen aktuellen Stand gebracht werden. Letztlich geht es darum, dass auch Autoren und Administratoren, die vor einer englischsprachigen Dokumentation zurückschrecken, mit Hilfe der übersetzten Doku-Seiten PmWiki nutzen können. Meiner (Bartolins?) persönlichen Meinung nach ist es wichtiger, die Grundlagen möglichst komplett und verständlich auf Deutsch verfügbar zu haben, als alle Details zu komplexen Dingen wie 'Conditional Markup' oder dergleichen anzubieten. Ein deutlicher Hinweis, wo sich weiterführende Informationen auf Englisch finden, dürfte besser sein, als eine scheinbar vollständige, dafür aber veraltete Doku-Seite.

Die erste Tabelle auf der Seite StandDerUebersetzung bietet zusammen mit dem Dokumentations-Index Informationen, an welchen Seiten vordringlich gearbeitet werden sollte. Kriterien sind hierfür die Vollständigkeit der Übersetzung ("Status" in der Tabelle) sowie die Aktualität der Übersetzung ("Stand der Übersetzung" in der Tabelle).

Tatsächliches Übersetzen

Es wäre hilfreich, wenn jeder, der eine Seite länger bearbeitet, vorübergehend einen entsprechenden Hinweis auf der Seite hinterlässt – z. B.

%rframe red%Seite wird gerade bearbeitet - [[~st]] 12.03.2008 10:08 Uhr%%

Ganz wichtig ist es, dass der Stand der Übersetzung dokumentiert wird - wir machen das mittels Seitentext-Variablen am Beginn der Seite (vgl. unten). Auch wenn jemand nicht selbst übersetzen mag, kann sie oder er gerne Hinweise mit Meta-Angaben geben -- (:Translation_Status: Was gibt es zu tun?:). Dann können die anderen schneller sehen, wo es etwas zu tun gibt. Mit einem Hinweis im Text (%comment%Was gibt es zu tun?%%) kann direkt auf eine Arbeit hingewiesen werden. Auch können Seiten mittels %comment%[[!TranslateMeToGerman]]%% zu der Kategorie TranslateMeToGerman? hinzugefügt werden. Über die Kategorien-Seite können Baustellen schnell gefunden werden und auch im Quelltext der Seite lässt sich schnell erkennen, wo es etwas zu tun gibt.

Terminologie

Die Diskussion zur Übersetzung zeigt oft ganz unterschiedliche Einstellungen über den Gebrauch bestimmter Wörter, englischer sowie deutscher als auch eingedeutschter. Eine Übersicht zu vorteilhaften Ausdrücken finden sich auf der Seite Terminologie. Weiter ist es wichtig, dass man bedenkt, dass es lokale Einstellungen gibt die z. B. eine andere SiteGruppe definiert haben. Man verwendet also besser [[{$SiteGroup}]] und nicht [[Site/Site]].

Seitennamen und Aufbau

Es wurde vereinbart, dass die englischen Orginalseitennamen aus der Gruppe PmWiki beibehalten werden, jedoch ein deutscher Titel gesetzt wird. Auf jeder übersetzten Seite sollten ganz oben folgende (Meta-)Angaben gemacht werden:

Der Beginn einer Musterseite sähe dann folgendermaßen aus:

 
(:title Titel der Seite:)
(:Summary: Kurz-Zusammenfassung der Seite:)
(:Original_Page: PmWiki.{$Name}:)
(:Translation_Date: 2008-03-10:)
(:Translation_Status: %green%fertig%%:)
(:Audience: Autoren (Fortgeschrittene):)

Inhalt der Seite

%trail% <<|[[DocumentationIndex | +]]|>> 

Hier wird die Summary-Zeile von oben wiederholt, um den Text 'Kurz-Zusammenfassung der Seite' zu überlagern

In der Seite PmWikiDe.GroupFooter sind Zeilen eingefügt, die die Zeile %trail% <<|[[DocumentationIndex | +]]|>> automatisch auf jeder Seite einfügt, wenn sie im Dokumentationsindex vorkommt. Die letzte Zeile in dem obigen Muster wird also nur nötig, wenn der Footer mit (:nogroupfooter:) ausgeschaltet wurde.

Weitere Zeilen geben die Originalseite und deren letztes Änderungsdatum sowie das Änderungsdatum der aktuellen Seite an. Die Definitionen der Stile dazu stehen in PmWikiDe.GroupHeader.

Paket "i18n"

Diskussion

Wie kommen eigentlich die Seiten ins Archiv i18n? Muss man das Pm melden? Da müsste man dann auch noch aufräumen... st? 11.03.2008 07:59 Uhr

Eine übersetzte Main.HomePage und Site.SideBar müsste man doch auch noch machen. st? 17.03.2008 14:24 Uhr

Das momentane Archiv beinhaltet auch Dateien mit Sonderzeichen in den Dateinamen. Die sind wohl iso-8859-1 kodiert, dass macht aber unter einem UTF-8-System (Linux) einige Probleme. Bitte in Zukunft auf diese Dateinamen mit Sonderzeichen verzichten. Ich würde mich auch freuen, wenn der Dateiinhalt ebenfalls UTF-8 kodiert wäre, weil mein Home-System und mein Webspace unter UTF-8 laufen. Vielen Dank vom Linuxer! 26.03.2008 15:18 Uhr

für die Liste aller Seiten