Handbücher

Revision 13 as of 2008-02-07 11:04:09

Clear message

Diese Seite dient zum Abgleich der verwendeten Übersetzungen in den Handbüchern und will eine Hilfestellung beim Umgang mit dem docbook-Format geben.

Die Dokumentation von Ubuntu ist im [https://wiki.ubuntu.com/DocBook docbook]-Format verfasst. Docbook ist ein auf XML-basierendes Dateiformat, bei dem Tags zur Angabe der Formatierung verwendet werden. Ein weiteres Format, das Tags verwendet, ist zum Beispiel HTML.

Docbooks können in Rosetta übersetzt werden. Mit Hilfe des Programms xml2po können alle zu übersetzenden Elemente aus der Datei extrahiert und letztendlich in Rosetta importiert. Dies geschieht automatisch. Vor ein paar Jahren musste zur Übersetzung noch das ganze docbook von Hand bearbeitet werden und jeder original String durch die Übersetzung ersetzt werden.

1. Docbook-Tags

Die Tags selbst, wie <application>, <ulink> oder <filename>, dürfen nicht übersetzt werden. Der von ihnen umschlossenen Text aber schon:

Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Programming</guisubmenu> <guimenuitem>Devhelp</guimenuitem></menuchoice>.

Wählen Sie <menuchoice><guimenu>Anwendungen</guimenu><guisubmenu>Entwicklung</guisubmenu> <guimenuitem>Devhelp</guimenuitem></menuchoice>.

%blabla; ist eine Variable, die beim Erstellen der Dokumentation durch einen Texbaustein ersetzt wird. Sie muss unverändert übernommen werden.

%amp; steht für das kaufmännische Und (&)

<xref linkend="add-applications"/> ist ein Verweis innerhalb des Dokuments. Die Eigenschaften von Tags, wie hier linkend, dürfen ebenfalls nicht übersetzt werden.

2. Sätze und Phrasen

... see <ulink url="https://help.ubuntu.com/community/Java">Ubuntu Help Online</ulink>.

Das deutschsprachige Wiki von ubuntuusers.de ist eines der umfangreichsten die es für Ubuntu gibt und auch von guter bis sehr hoher Qualität. Daher beitet es sich an dieses ergänzend anzubieten http://forum.ubuntuusers.de/topic/33991/?highlight=glatzor

Mehr zum Thema XXX finden Sie in der englischsprachigen <ulink url="https://help.ubuntu.com/community/Java">Online-Hilfe zu Ubuntu</ulink> oder im deutschsprachigen <ulink url="http://wiki.ubuntuusers.de/Java">Ubuntu-Wiki</ulink>.

Install the <application>gparted</application> package (see <xref linkend="add-applications"/>).

Installieren Sie das Paket <application>gparted</application> (siehe <xref linkend="add-applications"/>).

3. Einzelne Ausdücke

Wie auch bei Anwendungen selbst sollten, die Standardübersetzungen der jeweiligen Desktop-Umgebung beachtet werden. Die normale Ubuntu-Dokumentation ist für den GNOME-Desktop. Die Kubuntu-Dokumentation sollte sich an den KDE-Richtlinien orientieren.

Englisch

Deutsche Übersetzung

Canonical webiste

Canonical-Webseite

Ubuntu Help Online

Online-Hilfe zu Ubuntu

Ubuntu Documentation Team

Ubuntu-Dokumentationsteam

4. Merkregeln

Zusammengesetze Ausdrücke, von denen mindestens einer ein Fremdwort ist, werden durch einen Bindestrich getrennt, bzw. verbunden. Beispiele hierfür sind Internet-Angebot, Ubuntu-Dokumentationsteam.

Die englische Ubuntu-Dokumentation neigt zu länglichen Sätzen und komplizierten Satzkonstruktionen, die bei der Übersetzung aufgelöst werden sollten. Die deutsche Übersetzung soll nicht die sprachlichen Fähigkeiten des englischen Autors im Deutschen wiedergeben, sondern leicht lesbar und verständlich sein.