2. Grundlagen

2.1 Wie kann ich mich am DLHP beteiligen?

Wenn Sie selbst eine HOWTO übersetzen oder eine eigene schreiben möchten, erreichen Sie den Herausgeber des DLHP unter:

Internet: Budde@tu-harburg.de

Um sicherzustellen, daß nicht eine HOWTO von mehreren Leuten bearbeitet wird, müssen Sie dem Herausgeber unbedingt zuerst mitteilen, welche HOWTO Sie bearbeiten wollen, bevor Sie anfangen.

Wenn Sie eine englische HOWTO übersetzen möchten, können Sie sich selbst eine aussuchen, die Sie bearbeiten möchten. Gehen Sie dabei folgendermaßen vor:

1. Suchen Sie sich eine interessante HOWTO von folgendem Server aus:

   http://www.linuxdoc.org/docs.html#howto

2. Schauen Sie in DE-HOWTO nach, ob diese HOWTO nicht bereits übersetzt wurde oder sich gerade in Arbeit befindet.
3. Teilen Sie dem Herausgeber die ausgesuchte HOWTO mit.

Nach einiger Zeit sollte Ihre HOWTO dann auch in DE-HOWTO auftauchen. Falls dieses nicht der Fall ist, der Herausgeber kann ja auch mal was vergessen :), weisen Sie den Herausgeber bitte unbedingt darauf hin.

2.2 Qualitätsanspruch des DLHPs

Das Deutsche Linux HOWTO Projekt hat es sich zum Ziel gesetzt, deutschsprachige Linux Dokumentation mit einer hohen Qualität zu veröffentlichen. Das bedeutet für die Autoren:

• Die HOWTOs sollten möglichst fehlerfrei sein und nicht nur aus Rechtschreibfehlern und Tippfehlern bestehen. Das bedeutet nicht, daß jeder Autor studierter Germanist sein sollte, aber eine gewissen Qualität ist notwendig.
• Die Texte sollten leicht verständlich und lesbar sein. Dieses ist insbesondere bei Übersetzungen immer ein Problem, da wörtliche Übersetzungen häufig schwierig zu verstehen sind.
• Die HOWTOs sollten inhaltlich korrekt sein. Insbesondere bei Übersetzungen von LDP HOWTOs sollte unbedingt vorher überprüft werden, ob die HOWTO es überhaupt wert ist, übersetzt zu werden. Leider gibt es beim LDP anscheinend keine Qualitätskontrolle, so daß viele LDP HOWTOs teilweise bis völlig falsch sind.
• Es wird viel Wert auf die Einhaltung der Formatierungsrichtlinien dieser HOWTO gelegt. Durch eine vernünftige und vor allem einheitliche Formatierung sind die HOWTOs für die Anwender wesentlich besser lesbar.

Der Herausgeber erhält leider sehr häufig »fertige« HOWTOs von Übersetzern und Autoren, die sich in einem völlig unausgereiften Zustand befinden. Um diese HOWTOs für die Veröffentlichung auf der DLHP-Homepage fertig zu machen, muß der Herausgeber teilweise vermutlich mehr Zeit investieren wie der Übersetzer bzw. Autor. Hierzu fehlt es dem Herausgeber an Zeit und vor allem Lust.

Es werden auf der Homepage des DLHPs grundsätzlich nur HOWTOs veröffentlicht, die diesen Qualitätsansprüchen entsprechen.

2.3 Was tun nach der Übersetzung?

Fertige HOWTOs schicken Sie dem Herausgeber bitte per E-Mail an seine E-Mail-Adresse. Schicken Sie bitte nur den SGML-Source, den sie vorher mit gzip oder bzip2 komprimiert haben, im MIME base64 Format. Bitte achten Sie unbedingt auf die Komprimierung.

Bedenken Sie bitte, daß auch die Zeit des Herausgebers begrenzt ist und er nicht die Zeit hat, bei jeder HOWTO Formatierungs- und SGML-Fehler zu beseitigen. Lesen Sie am besten, bevor Sie den Source abschicken, noch einmal diese HOWTO vollständig durch und überprüfen Sie, ob Sie nichts vergessen haben.

Testen Sie also unbedingt vorher, ob sich Ihr Source in alle verwendeten Formate ohne Fehler übersetzen läßt und ob die Formatierung der hier beschriebenen entspricht. Zum Test können Sie folgenden Makefile benutzen:

http://www.tu-harburg.de/dlhp/FTP/tools/Makefile

Denken Sie bitte an die Klärung des Copyrights; siehe Copyright der HOWTOs.

Nachdem Sie Ihre HOWTO abgeschickt habe, schreiben Sie bitte zuerst keine weiteren Updates. Der DLHP-Herausgeber wird die eingehenden Versionen überprüfen und eventuelle Fehler beseitigen. Dieser Prozeß kann - gerade bei der ersten Version - einige Zeit dauern. Sie können diesen Prozeß dadurch beschleunigen, daß Sie sich von Anfang an möglichst genau an die Ratschläge in dieser HOWTO halten.

Nachdem die HOWTO vom DLHP-Herausgeber bearbeitet worden ist, wird sie auf unserer Homepage veröffentlicht. Benutzen Sie dann bitte den auf der Homepage gespeicherten SGML-Source Ihrer HOWTO für spätere Updates. Und schauen Sie sich mal mit

diff -u <ihre version.sgml> <fertige version.sgml>

die Änderungen an, die der DLHP-Herausgeber an Ihrem Text vorgenommen hat. Dieses kann hilfreich sein, um die gleichen Fehler bei späteren Updates nicht wieder einzubauen.

2.4 sgml-tools

Zur Formatierung der HOWTOs wird das Programmpaket sgml-tools verwendet. Dieses Paket erlaubt es, mittels einer SGML-Quelldatei die Formate HTML, ASCII, LaTeX (DVI), PostScript und Adobe Acrobat (PDF) zu erzeugen.

Die Verwendung der sgml-tools bietet sich an, da man so leicht verschiedene Formate erzeugen kann und alle HOWTOs dadurch ähnlich aussehen.

Die verwendete Version 1.0.9 der sgml-tools liegt den meisten Linux Distributionen als Paket bei. Ansonsten ist das Programm hier zu bekommen:

http://www.sgmltools.org

Die offizielle Version 1.0.9 läßt sich mit aktuellen Compilern nicht mehr übersetzen. Auf der DLHP-Homepage ist deswegen ein veränderter Source zu finden, bei dem der verwendete SGML-Parser durch eine aktuellere Version ausgetauscht wurde:

http://www.tu-harburg.de/dlhp/FTP/tools/sgml-tools_1.0.9.tar.bz2

Auf keinen Fall kann die Version 2.x benutzt werden, da diese völlig inkompatibel zur alten ist und noch nicht ausgereift ist. Außerdem wurde die Entwicklung der 2.x Version anscheinend eingestellt.

Speziell für das DLHP gibt es einen Patch für die sgml-tools, der hier zu finden ist:

http://www.tu-harburg.de/dlhp/FTP/tools/

Diese Version enthält einige Bugfixes, ein verbessertes Aussehen der formatierten Dokumente und PDF-Support. Damit der PDF-Support fehlerfrei funktioniert, muß Ghostscript in mindestens Version 4.x und teTeX in mindestens der Version 0.9 auf dem Rechner installiert sein.

2.5 Vorlagen

Für die Übersetzung einer HOWTO empfiehlt es sich, den SGML Source der entsprechenden HOWTO von

http://www.ibiblio.org/pub/Linux/docs/HOWTO/other-formats/

Hierbei sollte man jedoch unbedingt beachten, daß die LDP HOWTOs auf einer anderen Formatierungsrichtlinie beruhen. Man kann also nicht einfach die bestehende Formatierung übernehmen, sondern muß diese eventuell an die in diesem Dokument beschriebene anpassen.

2.6 Copyright der HOWTOs

Wenn Sie eine englische HOWTO übersetzen, überprüfen Sie bitte das Copyright der englischen HOWTO. Die HOWTOs des DLHP sollen möglichst alle der GNU General Public License unterliegen.

Falls das beim Original nicht der Fall sein sollte, fragen Sie bitte beim Autor nach, ob wir die deutsche Version unter der GPL verbreiten können. Und fragen Sie den Autor wirklich und ändern Sie nicht einfach nur die Lizenz. Bei Urheberrechtsverstössen haftet der Übersetzer und nicht das DLHP! Leiten Sie bitte eine Kopie der Erlaubnis an der Herausgeber weiter.

Die HOWTO sollte irgendwo in der Einleitung - meistens das erste Kapitel - einen Copyright Hinweis wie den folgenden enthalten:

<sect1>Copyright
<p>

Dieses Dokument ist urheberrechtlich geschützt. Das Copyright für 
die englische <em/AX25 HOWTO/, auf der dieses Dokument basiert, 
liegt bei Terry Dawson. Das Copyright für die deutsche Version 
liegt bei Gerd Röthig und Marco Budde.

Das Dokument darf gemäß der GNU <em><htmlurl url="DE-GPL.html"
name="General Public License"></em> verbreitet werden. 
Insbesondere bedeutet dieses, daß der Text sowohl über
elektronische wie auch physikalische Medien ohne die Zahlung von 
Lizenzgebühren verbreitet werden darf, solange dieser 
Copyright-Hinweis nicht entfernt wird. Eine kommerzielle Verbreitung 
ist erlaubt und ausdrücklich erwünscht. Bei einer Publikation in 
Papierform ist das Deutsche Linux HOWTO Projekt hierüber zu 
informieren.

Hierbei sollten alle Leute, die mehr als einen Satz zu dem Dokument beigetragen haben, erwähnt werden.

Sollten Sie keine HOWTO übersetzen, sondern eine eigene schreiben, so verwenden Sie bitte auch die GNU GPL. Denn zu einem freien Betriebssystem gehört auch eine freie Dokumentation.

2.7 SGML Header

Jedes SGML Dokument beginnt mit einem Header wie dem folgendem:

<!--
  Dieser SGML Source kann mit dem Programmpaket sgml-tools 1.0.x in
  die Formate TXT, HTML, DVI, Postscript und PDF umgewandelt werden.
  Bei allen Konvertern muß die Option "-c latin -l de" 
  verwendet werden.

  Deutsches Linux HOWTO Projekt
     http://www.tu-harburg.de/dlhp/
-->

<!doctype linuxdoc system>

<article>

<title>Linux foo HOWTO
<author>Name1 (<tt>name1@foo.org</tt>) und
        Name2 (<tt>name2@foo.org</tt>)
<date>v1.0, 1. April 1998
<abstract>
kurze Inhaltsangabe, hoechstens drei Zeilen
</abstract>

<toc>

[ ... ]

</article>

Als Autor sollte der Autor der englischen HOWTO (Name1) und der Übersetzer (Name2) angegeben werden. Unter <date> wird die Versionsnummer gefolgt vom Datum angegeben. Falls es sich um eine reine Übersetzung handelt, kann die Versionsnummer des Originals verwendet werden. Als Datum wird nicht das Datum des Originals verwendet, sondern das der Erstellung der Übersetzung.

2.8 Umlaute

Die Umlaute sollen in den formatierten Dokumenten in der Form »ü« und nicht in der Form »ue« erscheinen. Die sgml-tools bieten zwei Möglichkeiten, die Umlaute einzugeben:

• Latin-1 Zeichensatz (8 Bit): ü
• HTML Form (7 Bit): ü

Wenn möglich, sollte die erste Möglichkeit gewählt werden, da man so den Source mit jedem Editor gut lesen kann.

2.9 Du oder Sie?

Bei Übersetzungen stellt sich immer die Frage, wie man am besten »you« übersetzt. Da Linux schon lange nicht mehr nur von einer kleinen Gruppe von Insidern benutzt wird, ist es sicherlich sinnvoll, den Benutzer mit »Sie« anzureden, da ansonsten eventuell schnell der falsche Eindruck entstehen könnte, daß sich die HOWTOs nur an einen kleinen Kreis von Programmierern und Administratoren richten.

Da die Frage schon mehrfach aufgetaucht ist: das »Sie« bezieht sich natürlich nur auf die Texte selbst. Die Autoren selbst duzen sich in der Regel =:).

2.10 SGML-Sourcen

Achten Sie bitte darauf, daß Ihr SGML-Source vernünftig lesbar ist.

Dazu gehört es z.B., daß die Zeilen nach spätestens 80 Zeichen umgebrochen werden. Bei langen URLs oder ähnlichen Dinge kann natürlich eine Ausnahme gemacht werden. Fließtext wird nicht akzeptiert, da sich dieser nicht vernünftig lesen und bearbeiten läßt.

Fügen Sie zwischen den einzelnen Abschnitten ruhig ein paar Leerzeilen ein. Auch ansonsten schaden Leerzeilen der Lesbarkeit nicht.

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 17:56:56