  Deutsches Linux HOWTO Projekt (DLHP)
  von Marco Budde (Budde@tu-harburg.de)
  v1.3.9, 12. April 1998

  Dieses Dokument enthlt Informationen ber die deutschen Linux HOWTOs
  und das Deutsche Linux HOWTO Projekt.

  1.  Was sind Linux HOWTOs?

  Linux HOWTOs sind Dokumente, die im Detail bestimmte Aspekte der
  Konfiguration oder Anwendung von Linux beschreiben. So gibt es zum
  Beispiel eine Installation HOWTO, die die einzelnen Schritte der Linux
  Installation beschreibt.

  HOWTOs sind meistens recht knapp gehalten. Sie hneln den FAQs, aber
  sie sind nicht im Frage und Antwort Format aufgebaut.  Allerdings
  enthalten viele HOWTOs am Ende einen FAQ Abschnitt.

  Die HOWTOs liegen in mehreren Formaten vor: ASCII, Postscript, DVI,
  HTML und Acrobat (PDF).

  2.  Bezugsquellen fr Linux HOWTOs

  2.1.  Deutsche HOWTOs

  Die HOWTOs knnen per FTP von den folgenden Servern bezogen werden:

    ftp.heise.de:/pub/ix/Linux/docs/HOWTO

    ftp.uni-stuttgart.de:/pub/systems/linux/local/doc

    sunsite.unc.edu:/pub/Linux/docs/howto/translations/de

  Auerdem knnen die HOWTOs unter

       http://www.tu-harburg.de/~semb2204/dlhp/

  im World Wide Web betrachtet werden.

  Fido Nodes oder Points knnen die HOWTOs bei

       2:2426/2120 (analog)
       2:2426/2121 (ISDN)

  requesten. Bei einem Request mu der komplette Pfad und der Dateiname
  der entsprechenden Datei angegeben werden. Um also z.B. die deutsche
  Linux Installation HOWTO im PDF Format zu erhalten, requestet man
  /pub/os/linux/local/docs/DE-HOWTO/DE-Installation-HOWTO.pdf.gz.  Bei
  Problemen knnt Ihr Euch an Andreas Braukmann@2:2426/2125 wenden.

  2.2.  Englische HOWTOs

  Die englischen Linux HOWTOs, auf denen die meisten deutschen HOWTOs
  basieren, knnen per FTP von folgenden Servern bezogen werden:

    sunsite.unc.edu:/pub/Linux/docs/howto

    tsx-11.mit.edu:/pub/linux/docs/HOWTO

  Auch die englischen HOWTOs knnen direkt im WWW gelesen werden und
  zwar unter der Adresse http://sunsite.unc.edu/mdw/HOWTO/

  2.3.  Andere Sprachen

  Einige weitere Teams haben es sich zur Aufgabe gemacht, die HOWTOs in
  weitere Sprachen zu bersetzen.

     Franzsische bersetzungen

       ftp.ibp.fr:/pub/linux/french/docs/HOWTO/

     Japanische bersetzungen

       http://jf.gee.kyoto-u.ac.jp/JF/index.html

       ftp.kuis.kyoto-u.ac.jp:/Linux/JF/

     Italienische bersetzungen

       http://www.psico.unipd.it/ildp/docs/HOWTO/INDEX.html

       ftp.unipd.it:/pub/Linux/pluto/docs/HOWTO

     Spanische bersetzungen

       http://lml.ls.fi.upm.es/~jjamor/

       luna.gui.uva.es:/pub/docs-esp/

  3.  HOWTO Index

  3.1.  Fertige HOWTOs

  Folgende HOWTOs sind zur Zeit verfgbar:

    BootPrompt HOWTO von Paul Gortmaker (Paul.Gortmaker@anu.edu.au) und
     Antje Faber (af@caldera.de). Eine Zusammenstellung aller mglichen
     Bootparameter, die whrend des Bootens an das Linux Kernel
     bergeben werden knnen. 15. November 1997

    DOS nach Linux HOWTO von Guido Gonzato (guido@ibogfs.df.unibo.it)
     und Tilo Wenzel.  Dieses HOWTO soll DOS-Usern eine Einfhrung in
     Linux bieten. Unter dem Gesichtpunkt bereits vorhandener DOS-
     Kenntnisse sollen diese einen Einstieg in das frei erhltliche
     Unix-Clone fr +386-Computer erleichtern.  20. November 1997

    Linux Distribution HOWTO von Marco Budde (Budde@tu-harburg.de).
     Beschreibt die wichtigsten Linux Distributionen und deren
     Bezugsquellen.  5. April 1998

    Linux Drucker HOWTO von Grant Taylor (gtaylor@picante.com) und Jens
     Vonderheide (Jens_Vonderheide@wharfrat.fido.de).  Eine
     Zusammenfassung von Informationen, wie man unter Linux Dokumente
     generiert, ansieht, druckt oder faxt. 25. September 1996

    Linux FidoPoint HOWTO von Roland Rosenfeld
     (roland@spinnaker.rhein.de).  Beschreibt die Installation eines
     Fido Points unter Linux, wobei ifcico als Mailer und FidoGate als
     Gatesoftware verwendet werden. 17. Dezember 1996

    Linux Firewall HOWTO von Mark Grennan (markg@netplus.net) und
     Jrgen Steiner (js@barbar.augusta.de). Dieses Dokument wurde
     entwickelt, um die Grundlagen von Firewall-Systemen zu vermitteln
     und bietet einige Details zur Konfiguration von Filter- und Proxy-
     Firewalls auf einem Linux System. 18. Mrz 1997

    Linux Kernel HOWTO von Brian Ward (bri@blah.math.tu-graz.ac.at) und
     Peter Stterlin (pit@uni-sw.gwdg.de). Dieser Text gibt eine
     detaillierte Anleitung zur Konfiguration und Kompilation des Linux-
     Kernels sowie zu Upgrades des Kernels. September 1996

    Linux Installation HOWTO von Matt Welsh (mdw@sunsite.unc.edu) und
     Marco Budde (Budde@tu-harburg.de).  Nennt Bezugsquellen fr Linux
     und beschreibt dessen Installation.  20. Februar 1997

    Linux ISP-Verbindung HOWTO von Egil Kvaleberg (egilk@sn.no) und
     Christoph Seibert (seibert@cs.uni-bonn.de). Dieses Dokument
     beschreibt, wie man unter Linux ber ein Modem Verbindung mit einem
     Internet Service Provider aufnimmt. 7. Mai 1997

    Linux NET-3 HOWTO von Terry Dawson
     (terry@perf.no.itg.telecom.com.au) und Peter Stterlin (pit@uni-
     sw.gwdg.de).  Beschreibt den Bezug, die Installation und
     Konfiguration der Netzwerksoftware. Dezember 1997

    Linux News HOWTO von Vince Skahan (vince@halcyon.com) und Jrg
     Stpel (j.stoepel@marketingsystems.de).  Dieses Dokument beschreibt
     das Setup und die Pflege von USENET News unter Linux. 30. November
     1996

    Linux Offline       HOWTO von Christoph Kania (kania@uni-
     duesseldorf.de). In diesem Dokument wird eine Lsung zur offline-
     Nutzung der Dienste Mail und News mit temporrem Internetanschlu
     ber ein Modem dargestellt.  24. Februar 1998

    Linux PCMCIA HOWTO von David Hinds (dhinds@hyper.stanford.edu) und
     Dirk Geschke (geschke@physik.uni-kassel.de).  Dieses Dokument
     beschreibt die Installation und den Gebrauch des PCMCIA Card
     Service Pakets fr Linux. 5. September 1997

    Linux PPP HOWTO von Robert Hart (hartr@hedland.edu.au) und Marco
     Budde (Budde@tu-harburg.de). Dieses Dokument beschreibt, wie man
     einen Linux PC mit einem PPP Server verbindet.  3. Januar 1997

    Linux RPM HOWTO von Donnie Barnes (djb@redhat.com) und Tilo Wenzel.
     In diesem HOWTO wird beschrieben, wie man den Red Hat
     Packagemanager rpm anwendet und eigene Pakete erstellt. 25.
     September 1997

    Linux Samba HOWTO von David Wood (dwood@plugged.net.au) und Klaus-
     Dieter Schumacher (Klaus-Dieter.Schumacher@fernuni-hagen.de).
     Beschreibt die Einbindung von Linux in Windows fr Workgroups
     Netzwerke mittels Samba. 20. April 1997

    SCSI Programmierung HOWTO von > Heiko Eifeldt
     (heiko@colossus.escape.de). Behandelt die Installation und
     Programmierung von Linuxs generischem SCSI Interface.  17. Mrz
     1997

    Linux Sound HOWTO von Jeff Tranter (jeff_tranter@pobox.com) und
     Jens Vonderheide (Jens_Vonderheide@wharfrat.fido.de).  Beschreibt
     die Sound Untersttzung von Linux. 8. September 1996

    Linux XFree86 HOWTO von Matt Welsh (mdw@sunsite.unc.edu) und Dirk
     Knabe (knabe@fh-dortmund.de).  Beschreibt den Bezug, die
     Installation und die Konfiguration von XFree86. 13. Dezember 1996

    Linux ZIP Drive HOWTO von Grant Guenther (grant@torque.net) und
     Collin Mulliner (collin@deadend.rhein-main.de). Beschreibt die
     Installation und Benutzung des IOMEGA ZIP Laufwerkes unter Linux.
     August 1997

  3.2.  Fertige mini-HOWTOs

  Bisher sind folgende HOWTOs erschienen:

    Linux Bridge mini-HOWTO von Ralph Wetzel

    Linux Mehrere Ethernetkarten mini-HOWTO von Philipp JW Grau

    Linux mit Soundblaster & WSS kompatiblen Soundkarten mini-HOWTO von
     Frank Bhm

    Linux Soundblaster AWE64 mini-HOWTO von Frank Bhm

    Linux StarOffice mini-HOWTO von  Matthew Borowski und Werner Klaus

  3.3.  HOWTOs, die sich gerade in der Entwicklung befinden

  Folgende HOWTOs befinden sich gerade in der Entwicklung:

    3Dfx HOWTO, Tilo Wenzel (t.wenzel@mathematik.tu-chemnitz.de)

    AWK HOWTO, Stephan Heffner (Stephan.Heffner@munich.netsurf.de)

    AX-25 HOWTO

    DOSEMU HOWTO, Jens Vonderheide (Fido: 2:2433/395.24)

    ELF HOWTO, Philipp Thomas (Fido: 2:2437/221)

    Ethernet HOWTO, (hero@parsival.rhein-neckar.de)

    GCC HOWTO, Gerhard Poul (gerhard@ccc.at)

    HAM HOWTO, Michael Taeschner (Michael.Taeschner@dlr.de)

    Info Sheet, Antje Faber (@lst.de)

    IP Masquerade HOWTO, (J.Steiner@t-online.de)

    IPX HOWTO, (tepperis@uni-oldenburg.de)

    Java CGI HOWTO, (dahler@ndr.de)

    Module HOWTO, (pit@uni-sw.gwdg.de)

    Nameserver HOWTO, Thomas Balu Walter (balu@studst.fh-muenster.de)

    Pilot HOWTO

    PPP-NT HOWTO

    Serial HOWTO, Markus Thielmann (Fido: 2:2435/708.11)

    Sound Playing HOWTO (?)

    UUCP HOWTO, (glt@felten.co.at)

    vim HOWTO, Sven Guckes (guckes@math.fu-berlin.de)

    WWW HOWTO, (tepperis@uni-oldenburg.de)

  Folgende mini-HOWTOs werden gerade geschrieben:

    LILO HOWTO, Horst Knobloch (hknobloch@odn.de)

    Linux+Win95 HOWTO, Rainer (trusr000@trudi.zdv.uni-mainz.de)

    Win95+Win+Linux HOWTO, Michael Greis (Casado@t-online.de)

  4.  Deutsches HOWTO Projekt

  4.1.  Koordination

  Falls Sie selber gerne eine deutsche HOWTO schreiben oder eine
  englische HOWTO ins Deutsche bersetzen mchten oder eine Frage zu den
  HOWTOs haben  erreichen Sie mich unter folgenden e-mail Adressen:

       Internet: Budde@tu-harburg.de
       Fido: Marco Budde 2:240/5202.15

  oder per Post unter:

       Marco Budde
       Vaenser Weg 73
       21244 Buchholz i.d.N.
       Deutschland

  4.2.  Mailingliste

  Das Deutsche Linux HOWTO Projekt verfgt ber eine eigene
  Mailingliste. Diese Mailingliste ist jedoch nicht ffentlich
  zugnglich. Wer sich in irgendeiner Form an dem DLHP beteiligen
  mchte, schreibt zur Aufnahme auf die Mailingliste ein kleines Mail an
  der Koordinator des Projektes.

  4.3.  Allgemeine Richtlinien

  Wenn Sie selber eine deutsches Linux HOWTO Dokument schreiben mchten,
  gibt es einige Richtlinien, die Sie befolgen sollten.

    Fragen Sie bitte immer, bevor Sie sich Arbeit machen, bei mir nach,
     ob sich nicht bereits eine HOWTO zu diesem Thema in Arbeit
     befindet.

    Versuchen Sie, den Text mglichst gut zu strukturieren.  Verwenden
     Sie mglichst wenig Kapitel und benutzen Sie stattdessen
     Unterkapitel.

    Die Formatierung der Originale ist gem dieser Beschreibung und
     den bestehenden deutschen HOWTOs anzupassen.

    Wenn Sie eine HOWTO schreiben, mssen Sie das sgml-tools Software
     Paket benutzen, das von http://www.tu-
     harburg.de/~semb2204/dlhp/dlhp-1.3.tgz bezogen werden kann. Dieses
     Programm erlaubt es, mit einem einem SGML Quelltext die Formate
     LaTeX (fr DVI und Postscript), ASCII und HTML zu erzeugen.
     Auerdem erhalten die HOWTOs durch die Verwendung dieses Programmes
     ein einheitliches Aussehen.

    Man sollte immer dafr sorgen, da die dargestellten Informationen
     richtig sind. Dieses kann garnicht genug betont werden. Falls Sie
     sich nicht sicher sind, dann weisen Sie bitte darauf hin, das es
     sich nur um eine Annahme handelt.

    Am Ende der HOWTO kann ruhig ein FAQ Abschnitt eingefgt werden.
     Dieses ist oftmals ntig, um Informationen darzustellen, die man im
     normalen Text nur schwer darstellen kann.

    Fr die Erstellung einer HOWTO mit dem linuxdoc-sgml kann man gut
     die bereits vorhandenen HOWTOs als Modell heranziehen.  Der SGML
     Source der englischen HOWTOs kann unter
     sunsite.unc.edu:/pub/Linux/docs/howto/other-format/sgml bezogen
     werden.

    Wenn Sie die Postscript Version selber erzeugen mchten, achten Sie
     bitte auf eine korrekte Trennung. LaTeX arbeitet leider nicht immer
     fehlerfrei. Auerdem sollte immer das 'times' Paket von LaTeX
     verwendet werden. Hierfr ist es notwendig, da Sie von linuxdoc-
     sgml ein LaTeX Quelltext erzeugen lassen und diesen dann editieren.

    In der <tscreen> <verb> Umgebung drfen keine Umlaute verwendet
     werden. Diese werden fr LaTeX nicht richtig umgesetzt.

    Einige Zeichen wie die Tilde knnen nicht direkt eingegeben werden
     (siehe sgml-tools Anleitung), da sie ansonsten in der LaTeX Version
     nicht erscheinen!

    FTP, HTML oder e-mail Adressen sollten, wenn dieses sinnvoll ist,
     mit dem linuxdoc-sgml Befehl <htmlurl> formatiert werden, so da
     sie in der HTML Version als Hyperlink anklickbar sind. Eine FTP
     Adresse sieht im SGML Source also so aus (<tt><htmlurl
     url="ftp://server.de/verzeichnis"
     name="server.de:/verzeichnis"></tt>). Eine http Adresse wird
     hingegen so formatiert: (<tt><htmlurl
     url="http://server.de/verzeichnis/
     name="http://server.de/verzeichnis/"></tt>).

    Namen von Bchern oder HOWTOs sollten mit <em> formatiert werden.

    Dateinamen sollten mit <tt> formatiert werden. Auch Programmnamen
     sollten so formatiert werden, wenn das Programm mit demselben Namen
     gestartet wird.

    Bei Textteilen, die nicht automatisch umgebrochen werden, wie das
     z.B. bei Listings der Fall ist, mu auf die richtige Lnge geachtet
     werden, so da in der Text Version der HOWTO die 79 Zeichen pro
     Zeile nicht berschritten werden. Bei der LaTeX Version sollte der
     Rand nicht berschritten werden.

    Links auf DLHP HOWTOs sind grundstzlich mit relativen Pfad zu
     setzen. Also z.B. einfach auf DE-PPP-HOWTO.html.  Links auf die
     englischen HOWTOs sollte immer auf die WWW Version auf der
     sunsite.unc.edu zeigen. Dieses ist beides notwendig, um die Links
     auch fr Benutzer ohne Netzzugang benutzbar zu machen.

    Anstatt des <CODE> Befehls, sollte <TSCREEN><VERB> verwendet
     werden.

    Links, die lnger als 40 Zeichen sind, werden mit <TSCREEN>
     anstelle von <tt> formatiert.

  Nachdem Sie die HOWTO vollendet haben, schicken Sie mir diese bitte an
  obige Adresse zu, aber bitte nur im uudecode und nicht im MIME Format.
  Dabei knnen Sie whlen, ob Sie mir nur den SGML Quelltext zuschicken
  oder ob Sie alle Formate selber erzeugen. Ich werde dann fuer eine
  Verbreitung der HOWTOs sorgen.

  4.4.  Vorschlge zur bersetzung

    Bei einer bersetzung sollte man, wenn immer dieses mglich ist,
     Wrter wie 'you' unpersnlich mit 'man' bersetzen.

    Auch sollte man mglichst auf Klammern verzichten und stattdessen
     die Stze ausformulieren.

    Auch die Kommentare in Listings bzw. Konfigurationsdateien sollten
     bersetzt werden.

    Eventuell ist es sinnvoll, statt Anfhrungszeichen <em> zu
     verwenden.

  5.  Copyright

  Die meisten Linux HOWTOs drfen gem der GNU General Public License
  verbreitet werden.  Insbesondere bedeutet dieses, da die HOWTOs
  sowohl ber elektronische wie auch physikalische Medien ohne die
  Zahlung von Lizenzgebhren verbreitet werden drfen, solange dieser
  Copyright Hinweis nicht entfernt wird. Eine kommerzielle Verbreitung
  ist erlaubt und ausdrcklich erwnscht. Bei einer Publikation in
  Papierform ist das Deutsche Linux HOWTO Projekt hierber zu zu
  informieren.

