In der Mailliste tauchen die folgenden -meist ähnlichen- Fragen des öfteren auf. Dies ist eine Zusammenfassung der häufigsten Fragen. Wer Anmerkungen zur FAQ hat, kann mir gerne eine Mail senden.

Ja, jede Hilfe wird gebraucht. Je mehr Leute mithelfen, umso schneller haben wir das Handbuch in deutsch vorliegen. Man muß kein Dolmetscher sein.

Sie finden das Archiv mit den alten Nachrichten aus dieser und anderen deutschen Maillisten unter http://www.de.FreeBSD.org/de/archive/.

Die englische Dokumentation kann man sich mit CVSup herunterladen. Leider bekommt man auf diesem Weg nur den kompletten doc-tree. Abhilfe siehe unter: CVSup-FAQ: Refused Files.

    *default host=cvsup.de.FreeBSD.org
    *default base=/usr
    *default prefix=/usr
    *default release=cvs tag=.
    *default delete use-rel-suffix
    *default compress
    doc-all

Man kann auch durch den CVS-Tree der Doc im WWW browsen. Los geht es bei http://www.FreeBSD.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/ oder auf dem deutschen Mirror http://www.de.FreeBSD.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/.

Wir haben einige Teile auf ftp://ftp.cs.tu-berlin.de/pub/bsd/incoming/handbook.de zu liegen. Du kannst Dir dort auch bereits übersetzte Teil als Muster besorgen. Sende dein(e) Teil(e) dort auch erstmal hin.

Außerdem: Alexander Langer <alex@FreeBSD.org> und Udo Erdelhoff <ue@nathan.ruhr.de> sind Committer. Ihr könnt an sie per E-Mail fertige Teile senden.

Sende eine kurze Nachricht an Frank Gründer <elwood@mc5sys.in-berlin.de>, in der Du schreibst, welchen Teil Du übersetzen wirst. Er wird in die Liste der übersetzten Teile (Anhang in dieser FAQ) einen Hinweis auf Dich eintragen.

Außerdem schick bitte eine Nachfrage in die Mailliste <de-bsd-translators@de.FreeBSD.org>, um ganz sicher zu gehen, daß nicht schon jemand mit der Übersetzung deines Parts beschäftigt ist. Selbstverständlich sollten die Übersetzer in der Mailliste eingetragen sein. Hier kann man sich eintragen lassen.

Englisch und Deutsch

Texte/Dokumente in SGML verfassen

ACHTUNG! SGML ist nicht so schlimm wie es aussieht. Große Teile können 1:1 aus dem englischen Original übernommen werden.

Infos über SGML (ISO 8879:1986) findet man unter: http://www.oasis-open.org/cover/sgml-xml.html (englisch).

Auszug aus einer Nachricht von Udo Erdelhoff <ue@nathan.ruhr.de> am 03 Januar 2001 in de-bsd-translators@DE.FreeBSD.ORG

Es gibt den docproj "Meta-Port", der einfach nur alle anderen Ports der diversen Stylesheets und Tools installiert. Er ist im Verzeichnis /usr/ports/textproc/docproj zu finden. Mit make install werden alle nötigen Programme installiert.

Zweitens brauchst Du natürlich das Framework des FreeBSD Documentation Projekt. Das bezieht man am besten via cvsup. cvsup ist selbst ein Port, also mußt Du den (/usr/ports/net/cvsup-bin) auch installieren. Danach kannst Du mit cvsup und der passenden Konfig (siehe das Beispiel /usr/share/examples/cvsup/doc-supfile) das Framework holen. Als Host kannst Du irgendeinen der deutschen cvsup-Server nehmen.

Umlaute:

Beispiel: Fuss  -> Fu&szlig;
kuessen -> k&uuml;ssen
      

Sonderzeichen:

Auszug aus einer Nachricht von Wolfram Schneider <wosch@FreeBSD.org> am 25 Juni 2000 in de-bsd-translators@DE.FreeBSD.ORG

FreeBSD ist ein non-profit Projekt. Das Projekt lebt von der Arbeit von Freiwilligen und durch Sponsoren, die Material spendieren oder ihre Mitarbeiter fuer das Projekt abstellen.

Geld zum Ausgeben haben wir praktisch keines.

Letztlich zahlt es sich doch irgendwie fuer alle Beteiligten aus - die Sponsoren erhalten ein besseres Betriebssystem und viele von uns finden spaeter einen attraktiven Job oder haben einfach nur Spass.

Dies gilt auch fuer die Dokumentation bzw. Uebersetzung. Die Mitarbeit an so einem Projekt zaehlt fuer die meisten Arbeitgeber/Auftraggeber mehr als irgendein Diplom. Man sieht das Ergebnis und kann es nachpruefen.

[...]

Bei der Uebersetzung geben wir immer an, wer welches Kapitel uebersetzt hat. Fuer kommerzielle Firmen heisst dies auch, dass sie einen Link auf ihre Homepage setzen koennen (dieses Kapitel wurde uebersetzt von Firma XYZ).

Wenn Du willst, kannst Du ein Kapitel des FreeBSD Handbuchs (auf eigene Rechnung) uebersetzten und so Werbung in eigener Sache machen. Dies rentiert sich sicherlich nicht sofort, sondern erst in der Zukunft (6-12 Monate). Ausserdem lernst Du DocBook SGML kennen ;-)

FreeBSD ist ein sehr erfolgreiches Projekt, es gibt ueber eine Milllion installierte Systeme.

Ja, zur Zeit folgende:

Es gelten die üblichen Majordomo-Kommandos:

Hilfe mit:

    % echo help | mail majordomo@de.FreeBSD.org
     

Eintragen mit:

    % echo subscribe <Listenname> | mail majordomo@de.FreeBSD.org
     

Siehe Anhang.

Bei der Anrede des Handbuchnutzers hat sich die Mehrheit der Maillisten-Benutzer für die dritte Person Plural ("Sie") entschieden.

Die übersetzten Teile des Handbuches sind mittlerweile im offiziellen CVS-Tree von FreeBSD und können mit CVSup heruntergeladen und aktualisiert werden. Allgemeine Informationen zu CVSup gibt es unter http://www.freebsd.org/handbook/cvsup.html.

Die Konfig-Datei für CVSup sieht so aus:

    *default host=cvsup.de.FreeBSD.org
    *default base=/usr
    *default prefix=/usr
    *default release=cvs tag=.
    *default delete use-rel-suffix
    *default compress
    doc-all

Ja, die Richtlinien zum Erstellen von FreeBSD-Dokumenten ist unter http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer abrufbar. Unter Translations stehen die Informationen zur Übersetzung von Dokumenten. Vielleicht gibt es hier auch mal eine deutsche Übersetzung.