%% README fuer "`trd2', Version 2.1a vom 03.03.03"

Das trd2-System dient der Erstellung reproduktionsreifer Druckvorlagen
fuer die Formate 17x24 und TSB (Teubner Studienbuecher) des Verlags
B. G. Teubner, Wiesbaden (bis Maerz 2000 Stuttgart).

Die aktuelle Version ist auf
  ftp://ftp.informatik.uni-stuttgart.de/pub/TeX/teubner 
zu finden. Dort gibt es
  README         Diese Datei (im .tgz bzw. .zip File enthalten).
  trd-2.1a.tgz   Die aktuelle Distribution mit GNU tar und gzip gepackt.
  trd-2_1a.zip   Die aktuelle Distribution als Zip-Archiv.
  trd2doc.ps.gz  Mit GNU gzip gepackte Postcriptdatei der Benutzeranleitung.
  trd2doc_ps.zip Mit Info-ZIP Zip 2.3 gepackte Postcriptdatei der
                 Benutzeranleitung. (trd2doc.ps ist ebenfalls im .tgz bzw. .zip
                 File enthalten) 

  In den Zip-Archiven ist ausserdem in allen Textdateien das Unix Zeilenende "LF"
  durch die MSDOS Konvention "CR LF" ersetzt worden.

Entwickelt wurde das Paket unter
   - RedHat Linux 6.x bzw. 7.x
   - TeX (Web2c 7.3.1) 3.14159
   - LaTeX2e <1999/12/01>
   - Utility: `docstrip' 2.5b <1998/04/28>
   - Paket: `hyperref' 6.69d <2000/03/02>

Es sollte aber auch unter anderen Betriebssytemen ohne groessere Probleme
einsetzbar sein, solange die jeweilige TeX-Distribution "passt" (fuer
Unix-Plattformen z.B. tetex).

Weitere Informationen zu TeX bietet http://www.dante.de/, tetex und andere
TeX-Distributionen sind auf allen CTAN Servern zu finden (Comprehensive TeX
Archive Network. ftp://ftp.dante.de/tex-archive/ ist der de-Knoten dieses
Netzwerks. Unter http://www.dante.de/cgi-bin/ctan-index/ gibt es eine
Suchmaschine fuer diesen FTP-Server.) und die aktuelle Version von trd in
ftp://ftp.informatik.uni-stuttgart.de/pub/TeX/teubner/.



Die Distribution (trd-2.1a.tgz bzw. trd-2_1a.zip) umfasst:

Dokumentation:
	README			Kurzanleitung; diese Datei
	NEWS			Kurzbeschreibung von Aenderungen/Neuerungen
	manifest.txt		Liste der Dateien dieser Distribution.
	legal.txt		Copyright Notiz; Gewaehrleistung; Distribution
	bugs.txt		Wohin mit Fehlerberichten.
	trd2doc.tex		Benutzeranleitung
	trd2doc.bib		    Bibdatei dazu
	trd2doc.bbl		    fertige Bibliographie (von BibTeX erzeugt)
	trd2doc.ind		    ein fertiger Index (von makeindex erzeugt)
	trd2doc1.pic		    die in trd2doc.tex
	trd2doc2.pic		    verwendeten Bilder
	trd2doc.ps		komplette Benutzeranleitung in Postscript *)
	trd2doc.pdf		komplette Benutzeranleitung in PDF *)
	trd2skel.tex		Gerippe fuer ein `trd2book'

Klassen:
	trd2cls.dtx		`docstrip'-Archiv mit trd2book.cls, trd2bk10.clo,
				trdfleqn.clo
	trd2cmfn.fdd		`docstrip'-Archiv mit trd2otmr.fd, trd2ottt.fd

Installationsskripte:
	trd2cls.ins		`docstrip' Installationsskript zu trd2cls.dtx
	trd2cmfn.ins		`docstrip' Installationsskript zu trd2cmfn.fdd
	install.sh              Shell-Skript zur Installation von trd2

Support:
	trd2alpha.bst		BibTeX Stildatei (deutsche Version)
	trd2alphaen.bst		BibTeX Stildatei (englische Version)
	trd2num.bst		alternative BibTeX Stildatei (deutsche Version)
	trd2numen.bst		alternative BibTeX Stildatei (englische Version)
	trd2thp.sty		theorem Stildatei, Stil `trdplain'
	trd2.ist		makeindex Stildatei

---------
*) Damit Sie die Benutzeranleitung schon vor der Installation des trd2-Systems
drucken koennen, haben wir neben den LaTeX-Sourcen auch diese Postscript- und
PDF-Datei beigefuegt.



Installation:
-------------

Voraussetzung: Eine aktuelle TeX-Distribution, also unter Linux z.B. tetex-1.x.
               Falls Sie fuer eine elektronische Version Ihres Buches das Paket
               hyperref verwenden, so ist mindestens Version 6.69d von
               2000-03-02 erforderlich (s.a. Hinweis unten).


A) unter Unix

1) Auspacken der Distribution (mit GNU gzip komprimiert und mit GNU tar gepackt)

	# tar xzvf trd-2.1a.tgz
   oder (falls bei Ihnen GNU-tar unter einem anderen Namen z.B. als `gtar'
	 installiert ist)
	# gtar xzvf trd-2.1a.tgz
   oder (falls Ihr tar die Option `z' nicht kennt)
        # gunzip -c trd-2.1a.tgz | tar xvf -

   Erzeugt ein Verzeichnis trd-2.1a mit obigen Dateien.
	# cd trd-2.1a

   Nun koennen Sie entweder von Hand fortfahren wie unter 2) und 3) beschrieben
   oder sie rufen das Installationsskript auf:
	# ./install.sh
   Das Skript fragt nach dem Basisverzeichnis fuer die Installation, und
   installiert trd2 entweder darin "flach" oder darunter in verschiedene
   Verzeichnisse nach TDS-Standard (TDS ist die `TeX Directory Structure', s.a.
   http://www.dante.de/faq/de-tex-faq/html/uebersicht.html und
   http://www.dante.de/CTAN/tds/draft-standard/tds/).
   Dies macht nur Sinn, wenn das Basisverzeichnis ein TeX-Baum Ihrer
   TeX-Installation ist, d.h. wenn es der "standard texmf tree" ist oder im
   texmf.cnf als lokaler TeX-Baum (TEXMFLOCAL) eingetragen ist. Denn nur so
   werden die installierten Files von latex, bibtex, makeindex, etc gefunden.
   Vorausgesetzt Sie haben nach der Installation das ls-R File aktualisiert
   (z.B. mit "mktexlsr"; nicht noetig bei Installation unter ~/TeX, denn
   dort sucht TeX i.a. ohne Hilfe eines ls-R Files).

2) Docstrip-Archive auspacken

	# tex trd2cls.ins
	# tex trd2cmfn.ins

3) Legen Sie die erzeugten Dateien trd2book.cls, trd2bk10.clo, trdfleqn.clo,
   trd2otrm.fd und trd2ottt.fd sowie das mitgelieferte trd2thp.sty in ein
   Verzeichnis, in dem TeX nach Macrodateien sucht, die BibTeX Stildateien
   (trd2alpha.bst, trd2alphaen.bst, trd2num.bst und trd2numen.bst) in ein
   Verzeichnis, in dem TeX nach Bibstyles sucht und schliesslich trd2.ist
   in ein Verzeichnis, in dem makeindex nach Stildateien sucht.

   In der Regel suchen TeX makeindex immer auch im lokalen Verzeichnis.
   Sie koennen also all diese Dateien in den Ordner kopieren, in dem Sie Ihre
   trd2book-Dokumente ablegen. Wenn Sie die Macro- und Stildateien richtig in
   Ihre persoenlichen TeX-Umgebung (also unter ~/TeX/) oder sogar in die 
   TeX-Installation Ihres Instituts, Ihrer Abteilung etc. integrieren wollen,
   wenden Sie sich bitte an Ihren lokalen TeX-Admin/Guru (s.a. Bemerkungen zum
   install.sh Skript unter 1) oben).

B) unter Windows

1) Auspacken der Distribution (mit zip gepackt)

   Packen Sie trd-2_1a.zip mit Ihrem jeweiligen "Unzipper" in ein Verzeichnis
   "trd" aus. Ihr "Unzipper" sollte dabei die langen Dateinamen
   (zB trd2alphaen.bst) erhalten. Wechseln Sie in das erzeugte Verzeichnis.

2) siehe A) 2)

3) siehe A) 3)


Benutzeranleitung und erstes Beispiel:
--------------------------------------
Eine Benutzeranleitung zur Nutzung von trd2book.cls finden Sie in trd2doc.tex.
Diese Benutzeranleitung dient gleichzeitig als erstes Anwendungsbeispiel und
wurde daher als trd2book-Dokument geschrieben. Damit Sie die Benutzeranleitung
schon vor der Installation des trd2-Systems drucken koennen, haben wir neben den
LaTeX-Sourcen die Anleitung als Postscriptdatei trd2doc.ps und als PDF-Datei
trd2doc.pdf mitgegeben.

Nach erfolgreicher Installation sollten Sie jedoch als ersten Test die
LaTeX-Sourcen der Benutzeranleitung neu uebersetzen:

	# latex trd2doc.tex

Anmerkung: Das Macro \makefigure{<Label>}{<Bild>}{<Bildunterschrift>} zum
Setzen von Bildern verwendet zur Bestimmung der Seitenart (rechte oder linke
Seite) die unter dem Label in der .aux-Datei stehende Seitenzahl. Ist das Label
in der .aux-Datei noch nicht definiert, wird 0 angenommen.
Beim ersten LaTeX-Lauf wird die Referenz in die .aux-Datei geschrieben und ist
erst beim naechsten Lauf mit dem Einlesen der .aux-Datei definiert. Beim ersten
Uebersetzen von trd2doc.tex nach dem Auspacken der Distribution gibt es
natuerlich noch kein trd2doc.aux und die Bilder sind daher erst nach dem
zweiten Lauf richtig positioniert.
Wird das Paket "hyperref" verwendet, so ist mindestens Version 6.69d von
2000-03-02 erforderlich; bei aelteren Versionen von hyperref gibt es die
Fehlermeldung "! Missing number, treated as zero" und \makefigure plaziert
alle Bilder links.


Happy texing.

=====================================================================
Horst Prote                 email: prote@informatik.uni-stuttgart.de
