Deutsche FreeBSD-Dokumentation

1. Wie kann ich helfen?

Zunächst solltest du die Mailingliste de-bsd-translators abonnieren. Auf der Mailingliste wird über die deutsche Dokumentation diskutiert; zudem werden die Commit-Meldungen zu Änderungen der Dokumentation ebenfalls an die Liste geschickt. An diese Liste solltest du auch übersetzte Dokumentationen oder Korrekturen zu bestehender Dokumentation senden.

Statt der Korrektur der bestehenden Dokumentation kannst du auch neue Dokumente übersetzen. Der Abschnitt Stand der deutschen Dokumentation zählt noch zu übersetzende Dokumente auf. Häufig wird der Arbeitsaufwand für das Übersetzen unterschätzt. Neue Übersetzer sollten daher zuerst mit kleineren Dokumenten, wie einzelnen Artikeln oder kleinen Seiten des Webauftritts, anfangen.

Um Doppelarbeit zu vermeiden, kündige bitte auf der Mailingliste <de-bsd-translators@de.FreeBSD.org> an, welches Dokument du übersetzen willst. Wenn sich dort kein Widerspruch regt, kannst du das Dokument übersetzen. Dokumente, die zurzeit übersetzt werden, sind im Abschnitt Belegte Dokumente aufgeführt.

2. Werkzeuge

Die Arbeit an der Dokumentation erfordert die aktuellen Dokumente aus dem deutschen CVS-Repository. Da die Dokumentation ständig weiterentwickelt wird, sind die Dokumente auf FreeBSD-CDs oft veraltet. Der Abschnitt Das deutsche CVS-Repository beschreibt den Zugriff auf das deutsche CVS-Repository und den Bau der Dokumentation.

Der Abschnitt Wortliste führt Übersetzungen für häufig vorkommende oder oft falsch übersetzte Wörter auf. Daneben sind die schon übersetzten Teile der FreeBSD-Dokumentation und die übersetzte Dokumentation der anderen BSD-Projekte, wie der NetBSD Shortguide oder die OpenBSD FAQ hilfreich.

Weitere Hilfsmittel sind:

• Das deutsch-englische Wörterbuch von LEO.

• Die Fibel des Documentation-Projects (das englische Original) beschreibt die notwendigen Werkzeuge zum Bau der Dokumentation.

• Die Archive der Mailingliste de-bsd-translators.

• Das Werkzeug did.pl ermittelt Differenzen zwischen dem deutschen Repository und dem offiziellen Repository.

• Das Buch Technisches Schreiben von Peter Rechenberg.

3. Stand der deutschen Dokumentation

Die FAQ und einige Artikel sind vollständig übersetzt, dem Handbuch und der Fibel fehlen einige Kapitel. Eine Übersicht der erhältlichen Dokumentation befindet sich unter der URL http://www.FreeBSD.org/de/docs.html. Für viele FreeBSD-Releases liegen deutsche Release-Notes vor. Die deutschen Release-Notes sind auf der Seite http://www.FreeBSD.org/de/releases/index.html erhältlich. An der Übersetzung des Webauftritts wird ebenfalls gearbeitet.

4. Das deutsche CVS-Repository

Die übersetzte Dokumentation wird in einem seperaten Repository auf srv1.cosmo-project.de gepflegt, das von Bernd Walter verwaltet wird.

Die Vorteile eines separaten Repositorys gegenüber dem offiziellen Repository sind:

• Änderungen können erst mal gesammelt werden, um sie dann mit einem Commit in das offizielle Repository einzubringen.

• Die Commit-Meldungen sind deutsch.

• Auch unerfahrene Übersetzer können Änderungen einbringen, ohne Gefahr zu laufen, den offiziellen Bau zu gefährden.

Durch das separate Repository befinden sich im offiziellen Repository ab und an veraltete Inhalte. Für die Übersetzung ist daher das deutsche Repository maßgebend.

% cd de-repo/doc
% ln -s ~/texte/doc/share
% cd de_DE.ISO8859-1
% make

% cd de-repo/www
% ln -s ~/texte/www/share
% ln -s ~/texte/www/tools
% ln -s ~/texte/www/en
% ln -s ~/texte/www/Makefile
% ln -s ~/texte/www/Makefile.inc
% cd de
% make

5. Wortliste

Die folgende Liste enthält Übersetzungen für häufig verwendete Wörter innerhalb der FreeBSD-Dokumentation.

6. Stilblüten

Übersetzen macht auch Spaß, wie die folgende Sammlung zeigt. Die angegebene Revision ist die letzte Revision, in der die Stilblüte enthalten ist.