lyx_mirror/lib/doc/de_Intro.lyx

1775 lines
40 KiB
Plaintext
Raw Normal View History

#LyX 1.3 created this file. For more info see http://www.lyx.org/
\lyxformat 221
\textclass book
\language german
\inputencoding latin1
\fontscheme default
\graphics none
\paperfontsize default
\spacing single
\papersize Default
\paperpackage a4
\use_geometry 1
\use_amsmath 0
\use_natbib 0
\use_numerical_citations 0
\paperorientation portrait
\leftmargin 2cm
\topmargin 1cm
\rightmargin 2cm
\bottommargin 1cm
\secnumdepth 3
\tocdepth 3
\paragraph_separation skip
\defskip medskip
\quotes_language german
\quotes_times 2
\papercolumns 1
\papersides 1
\paperpagestyle default
\layout Title
Einf<EFBFBD>hrung in LyX
\newline
oder
\newline
Das Einmaleins der LyX-Dokumentation
\layout Author
vom LyX Team
\begin_inset Foot
collapsed false
\layout Standard
Deutsche <20>bersetzung:
\noun on
Peter S<>tterlin
\noun default
und
\noun on
Hartmut
\noun default
\noun on
Haase
\noun default
.
\end_inset
\layout Date
13.\SpecialChar ~
September 2003
\layout Standard
\begin_inset LatexCommand \tableofcontents{}
\end_inset
\layout Chapter
Die Philosophie von LyX
\layout Standard
\align center
\begin_inset Minipage
position 1
inner_position 0
height "0pt"
width "80text%"
collapsed false
\layout Standard
\begin_inset Quotes gld
\end_inset
Onkel Cosmo, warum nennt man das Ding Textverarbeitung?
\begin_inset Quotes grd
\end_inset
\layout Standard
\begin_inset Quotes gld
\end_inset
Ganz einfach Skyler: Du hast doch gesehen was die Lebensmittelverarbeitung
mit dem Essen anstellt, oder?
\begin_inset Quotes grd
\end_inset
\layout Standard
\hfill
-- Jeff MacNelly in "Shoe"
\end_inset
\layout Section
Was ist LyX
\layout Standard
LyX ist ein komplettes System zur Erstellung von Dokumenten.
Es ist un<75>bertroffen beim Schreiben von komplexen wissenschaftlichen und
technischen Artikeln mit mathematischen Formeln, Querverweisen, Literaturlisten
, Indexlisten usw.
Es kann sehr gut mit Texten jeglicher Gr<47><72>e umgehen, bei denen die <20>blichen
Anforderungen gestellt werden: Automatische Seiten- und Kapitelnumerierung,
Rechtschreibpr<70>fung usw.
Nat<61>rlich kann man LyX auch verwenden um einen Brief an die Mutter zu schreiben
, obwohl es daf<61>r sicherlich einfachere Programme gibt.
Es ist sicherlich nicht das geeignetste Werkzeug um damit Werbezettel,
Flugbl<62>tter oder <20>hnliches zu erstellen (warum werden wir etwas sp<73>ter
erl<72>utern), obwohl auch das mit einigem Aufwand sehr wohl m<>glich ist.
Hier einige Beispiele wozu LyX im allgemeinen verwendet wird: Memos, Briefe,
Dissertationen und Diplomarbeiten, B<>cher (<28>ber PostgreSQL, Fernabtastung,
Kryptologie, Novellen, Poesie und sogar ein oder zwei Kinderb<72>cher), Artikel
in referierten wissenschaftlichen Zeitschriften, Skripte f<>r Theaterst<73>cke
und Filme, wirtschaftliche Proposals\SpecialChar \ldots{}
\layout Standard
LyX ist ein Programm das einen sehr modernen Ansatz zum computerunterst<73>tzten
Schreiben von Texten bietet.
Durch die Verwendung einer
\begin_inset Quotes gld
\end_inset
Markup
\begin_inset Quotes grd
\end_inset
-Sprache weicht dieser Ansatz vom obsoleten Schreibmaschinen-Konzept ab.
Er wendet sich an Autoren die schnell und mit minimalem Aufwand professionell
aussehende Ergebnisse erzielen wollen, ohne daf<61>r Spezialisten im Schriftsatz
werden zu m<>ssen.
Mit LyX wird diese Aufgabe praktisch vollst<73>ndig vom Computer <20>bernommen,
der Autor kann sich auf den Inhalt des Textes konzentrieren.
\layout Standard
Ein Teil der anf<6E>nglichen Herausforderung bei der Nutzung von LyX liegt
in der <20>nderung der Denkweise, die Sie, der Leser, schaffen m<>ssen.
Fr<46>her gab es nur Schreibmaschinen, um Texte zu erstellen, und so lernten
wir alle viele Tricks, um deren Unzul<75>nglichkeiten zu umgehen.
Das Unterstreichen zum Beispiel, das eigentlich mehr ein <20>bermalen mit
einem
\begin_inset Quotes gld
\end_inset
_
\begin_inset Quotes erd
\end_inset
ist, wurde ein Standardweg, um Text hervorzuheben.
Beim Anlegen einer Tabelle mu<6D>te man sich im voraus <20>berlegen, wie gro<72>
jede Spalte sein mu<6D>, und setzte die entsprechenden Tabulatoren.
Das gleiche gilt f<>r Briefe oder anderen rechtsb<73>ndigen Text.
Wort\SpecialChar \textcompwordmark{}
trennungen am Zeilenende verlangten ein scharfes Auge und viel Vorausdenken.
\layout Standard
In anderen Worten, wir haben gelernt und ge<67>bt, uns darum zu k<>mmern, welcher
Buchstabe wo gesetzt wird.
Als direkte Folge davon haben die meisten Textverarbeitungen diese Mentalit<69>t
<20>bernommen.
Man verwendet weiterhin Tabulatoren, um dynamischen Leerraum zu erzeugen,
und mu<6D> sich immer noch darum k<>mmern, wo genau auf der Seite etwas erscheinen
wird.
Um eine Textstelle hervorzuheben, wird der Zeichensatz ge<67>ndert, gleichsam
wie das Auswechseln des Typenrades einer Schreibmaschine.
Dies ist die Philosophie, die einer sogenannten WYSIWYG-Textverarbeitung
zugrunde liegt: What you see is what you get --- Was Du siehst ist (genau
das) was Du siehst.
Leider f<>hrt das aber meist nur zu einem 'Was Du siehst ist alles was Du
bekommst'.
\layout Standard
In genau diesem Punkt unterscheidet sich LyX von einer herk<72>mmlichen Textverarbe
itung.
Sie k<>mmern sich nicht selber darum, wie der Satz genau durchgef<65>hrt wird.
Sie sagen LyX,
\emph on
was Sie machen wollen
\emph default
, und LyX k<>mmert sich um den Rest.
Dabei folgt es einem festen Regelwerk, das man als
\emph on
Stil
\emph default
bezeichnet.
\begin_inset Foot
collapsed false
\layout Standard
Fairerweise mu<6D> man sagen, da<64> die meisten aktuellen Textverarbeitungsprogramme
mittlerweile auch so etwas wie Stilvorlagen unterst<73>tzen, die ein <20>hnliches
Konzept darstellen.
Leider werden Sie, so unsere Erfahrung, in der Realit<69>t kaum genutzt.
\end_inset
Sehen wir uns ein kleines Beispiel an:
\layout Standard
Nehmen wir an, Sie schreiben einen Bericht.
Zu Beginn wollen Sie einen Abschnitt
\begin_inset Quotes gld
\end_inset
Einleitung
\begin_inset Quotes grd
\end_inset
.
Sie gehen also in das entsprechende Men<65> Ihrer Textverarbeitung und suchen
eine neue Zeichensatzgr<67><72>e aus, schalten Fettdruck ein.
Dann schreiben Sie
\begin_inset Quotes eld
\end_inset
1.\SpecialChar ~
\SpecialChar ~
Einleitung
\begin_inset Quotes erd
\end_inset
.
Wenn Sie nat<61>rlich zu einem sp<73>teren Zeitpunkt beschlie<69>en, da<64> dieses
Kapitel an einer anderen Stelle im Dokument erscheinen soll, oder wenn
Sie ein weiteres Kapitel davor einf<6E>gen wollen, dann m<>ssen Sie die Numerierung
f<>r dieses und alle folgenden Kapitel sowie die Eintr<74>ge im Inhaltsverzeichnis
<20>ndern.
\layout Standard
In LyX <20>ffnen Sie das Auswahl-Men<65> auf der linken Seite der Werkzeugleiste
und w<>hlen als Typ
\family sans
Abschnitt
\family default
und schreiben
\begin_inset Quotes gld
\end_inset
Einleitung
\begin_inset Quotes grd
\end_inset
.
\layout Standard
Ja, das ist wirklich alles.
Wenn Sie diesen Abschnitt sp<73>ter an eine andere Stelle verschieben, wird
die Numerierung automatisch angepa<70>t --- egal wohin Sie ihn verschieben.
Wenn Sie in ihrem Text Querverweise auf diesen Abschnitt haben und diese
korrekt <20>ber das LyX-eigene System getan haben, werden auch all diese Verweise
(Kapitel- und Seitennummern) automatisch aktualisiert.
Sie werden nie wieder explizite Kapitelnummern verwenden.
\layout Standard
Und dann ist da noch das Problem mit der Konsistenz.
F<>nf Tage sp<73>ter laden Sie den Bericht wieder und schreiben ein Kapitel
4.
Sie erinnern sich nicht mehr, da<64> Sie in den ersten Kapiteln eine 18-Punkt
Schrift f<>r die <20>berschriften verwendet hatten, und w<>hlen eine 16-Punkt
Schrift aus.
Dieses Problem existiert in LyX nicht, denn der Computer k<>mmert sich um
solche Dinge.
Daf<61>r ist er schlie<69>lich gedacht.
\layout Standard
Oder stellen Sie sich vor, Sie erstellen eine Liste.
In anderen Textverarbeitungen besteht eine solche Liste meist aus einer
Menge gesetzter Tabulatoren und Zeilenvorsch<63>ben.
Sie m<>ssen daf<61>r Sorge tragen, da<64> die Spalten<65>berschriften an der richtigen
Stelle sitzen, m<>ssen ausrechnen oder probieren, wie viele Leerzeichen
einzuf<75>gen sind usw.
Mit LyX haben Sie nur zwei Dinge, um die Sie sich k<>mmern m<>ssen: Was f<>r
eine Art von Liste Sie wollen, und was darinstehen soll.
Das ist alles.
\layout Standard
Die Grundidee von LyX ist also: Sagen Sie,
\emph on
was
\emph default
Sie wollen, nicht
\emph on
wie
\emph default
man es macht.
An die Stelle des
\begin_inset Quotes gld
\end_inset
WYSIWYG
\begin_inset Quotes grd
\end_inset
tritt bei LyX das
\begin_inset Quotes gld
\end_inset
WYSIWYM
\begin_inset Quotes grd
\end_inset
: What you see is what you
\emph on
mean
\emph default
, was man sieht ist was man
\emph on
meint
\emph default
.
Dies ist ein sehr m<>chtiges Konzept da<64> das Schreiben von Texten stark
vereinfacht.
Und es ist auch der Grund, warum LyX weniger f<>r das Erstellen von Flugbl<62>ttern
oder Werbezetteln geeignet ist: Denn dort
\emph on
wollen
\emph default
Sie genau angeben, wo welches Textelement erscheint, denn es gibt keine
funktionellen Elemente wie Abs<62>tze, Abschnitte usw.
Das bedeutet nicht, da<64> in LyX irgendwelche tollen Funktionen fehlen -
es ist einfach nicht das richtige Programm f<>r diesen Zweck --- Sie verwenden
ja auch keinen Schraubendreher, um damit N<>gel einzuschlagen (au<61>er vielleicht
ihr Schraubendreher hat eine lebensl<73>ngliche Garantie).
\layout Section
Unterschiede zwischen LyX und Textverarbeitungen
\begin_inset Foot
collapsed false
\layout Standard
Nein, dies ist nicht der Versuch, einen heiligen Krieg der Textverarbeitungen
anzufangen (oder zu gewinnen).
Es ist jedoch wichtig, die Vorteile von LyX zu beschreiben.
Und einer dieser vielen Vorteile, das WYSIWYM-Prinzip, unterscheidet sich
grundlegend von der Vorstellung, die 99% der Nutzer von einer Textverarbeitung
haben.
\end_inset
\layout Standard
Hier ist eine kleine Aufz<66>hlung von Dingen, die Sie bei LyX nicht finden
werden:
\layout Itemize
Das Lineal
\layout Itemize
Tabulatoren
\layout Itemize
zus<EFBFBD>tzliche Leerzeichen oder -zeilen (also mehrmals hintereinander
\family sans
Enter
\family default
oder die Leertaste bet<65>tigen)
\layout Standard
Tabulatoren, zusammen mit dem Lineal, welches Ihnen die Position von Eintr<74>gen
auf der Seite anzeigen, sind in LyX sinnlos.
Das Programm k<>mmert sich darum, wo auf der Seite etwas erscheint, nicht
Sie.
Dasselbe gilt f<>r zus<75>tzliche Leerzeilen.
Wenn sie vom Kontext her n<>tig sind, f<>gt LyX sie automatisch ein.
Anfangs mag es f<>r Sie etwas ungewohnt oder sogar st<73>rend sein, keine zwei
Leerzeilen nacheinander einf<6E>gen zu k<>nnen.
Aber wenn Sie sich erst an das WYSIWYM-Prinzip gew<65>hnt haben, wird es Ihnen
als der nat<61>rlichere Weg erscheinen.
\layout Standard
Hier nun ein paar Dinge, die es zwar in LyX gibt, jedoch anders verwendet
werden, als man sich das vielleicht vorstellt:
\layout Itemize
Kontrolle des Einzuges
\layout Itemize
Seitenumbr<EFBFBD>che
\layout Itemize
Zeilenabst<EFBFBD>nde (d.
\begin_inset ERT
status Collapsed
\layout Standard
\backslash
,
\end_inset
h.\SpecialChar ~
einzeilig, zweizeilig usw.)
\layout Itemize
Zwischenr<EFBFBD>ume ohne Text, horizontal wie vertikal
\layout Itemize
Zeichens<EFBFBD>tze und -gr<67><72>en
\layout Itemize
Schriftarten (fett, schr<68>g, unterstrichen usw.)
\layout Standard
Obwohl es all dies in LyX gibt, ben<65>tigt man es im Normalfall nicht.
LyX nimmt notwendige Einstellungen kontextbezogen vor.
Unterschiedliche Teile des Textes werden automatisch in verschiedenen Schriftar
ten und -gr<67><72>en gesetzt.
Der Einzug zu Beginn eines Absatzes ist ebenfalls vom Zusammenhang bestimmt,
verschiedene Abs<62>tze werden unterschiedlich behandelt.
Auch die Seitenumbr<62>che werden automatisch eingef<65>gt.
Generell sind alle Abst<73>nde zwischen Worten, Zeilen und Abs<62>tzen variabel
und werden von LyX bestimmt.
\begin_inset Foot
collapsed false
\layout Standard
Selbstverst<EFBFBD>ndlich gibt es die M<>glichkeit, alle diese Abst<73>nde entweder
lokal oder global f<>r das gesamte Dokument zu ver<65>ndern.
Nur in wenigen F<>llen ist dabei Wissen <20>ber LaTeX notwendig.
N<>heres finden Sie im
\emph on
Benutzerhandbuch
\emph default
und den
\emph on
Profi-Tipps
\emph default
.
\end_inset
\layout Standard
Schlie<EFBFBD>lich gibt es auch einige Gebiete, in denen LyX (und LaTeX) unserer
Meinung nach herk<72>mmlichen Textverarbeitungen weit <20>berlegen sind:
\layout Itemize
Silbentrennung
\layout Itemize
Aufz<EFBFBD>hlungen aller Art
\layout Itemize
Mathematiksatz
\layout Itemize
Tabellen
\layout Itemize
Querverweise im Text
\layout Standard
Zugegeben, viele moderne Textverarbeitungen k<>nnen mit mathematischen Symbolen
umgehen, und einige beginnen bereits mit der Einf<6E>hrung von Stildefinitionen
und einer Art WYSIWYM-Prinzip.
Dies ist jedoch noch nicht sehr lange so.
Im Gegensatz dazu basiert LyX auf dem Textsatzsystem LaTeX, welches bereits
seit <20>ber 10 Jahren existiert und
\emph on
funktioniert
\emph default
.
All die kleinen Fehler, die ein neues Programm immer hat, sind bei LaTeX
schon lange gefunden und beseitigt.
\begin_inset Foot
collapsed false
\layout Standard
Nat<EFBFBD>rlich ist nichts perfekt, aber LaTeX ist so nahe an einem fehlerfreien
Computerprogramm, wie dies nur m<>glich ist.
\end_inset
\layout Section
Was
\emph on
ist
\emph default
denn nun LaTeX (und mu<6D> ich das wissen)?
\layout Standard
LaTeX ist ein System zur Erstellung von Texten, das 1985 von
\noun on
Leslie Lamport
\noun default
entworfen wurde.
\begin_inset Foot
collapsed false
\layout Standard
Die Information in diesem Abschnitt basiert auf den Angaben in dem Buch
\emph on
\begin_inset Quotes eld
\end_inset
A Guide to LaTeX2e
\begin_inset Quotes erd
\end_inset
\emph default
von
\noun on
Helmut Kopka
\noun default
und
\noun on
Patrick Daly
\noun default
.
Die genaue Quellenangabe finden Sie im Literaturverzeichnis des
\emph on
Benutzerhandbuches
\emph default
.
\end_inset
Es basiert auf der Textsatz-Sprache TeX, die von
\noun on
Donald Knuth
\noun default
1984 entwickelt wurde.
\begin_inset Quotes gld
\end_inset
TeX
\begin_inset Quotes grd
\end_inset
spricht man aus wie
\begin_inset Quotes gld
\end_inset
Blech
\begin_inset Quotes grd
\end_inset
, und manche halten es auch f<>r etwas blechern.
Das liegt aber daran, da<64> die wenigsten verstehen, was TeX eigentlich ist.
TeX liest aus einer ASCII-Datei eine Reihe von Textsatzbefehlen und f<>hrt
sie aus.
Das ist etwas komplizierter als eine Schreibmaschine, aber bei weitem nicht
so schwierig wie eine echte Schriftsatz-Maschine in einer Druckerei.
Aber viele der
\begin_inset Quotes gld
\end_inset
Tricks
\begin_inset Quotes grd
\end_inset
der Schriftsetzer wurden von Knuth als Computer-Algorithmus formuliert
und in TeX integriert, daher sehen seine Druckergebnisse so hervorragend
aus.
TeX erzeugt als Ausgabe eine Datei, die man als ger<65>teunabh<62>ngig (
\begin_inset Quotes gld
\end_inset
device independent
\begin_inset Quotes grd
\end_inset
,
\family typewriter
dvi
\family default
) bezeichnet.
Eine solche
\family typewriter
dvi
\family default
-Datei kann von vielen Programmen, die dieses Format verstehen, gelesen
werden und in andere Formate wie z.
\begin_inset ERT
status Collapsed
\layout Standard
\backslash
,
\end_inset
B.
PostScript<70> oder PDF umgewandelt werden.
\layout Standard
W<EFBFBD>re das bereits alles, TeX w<>re nichts anderes als ein primitiver Textsetzer.
Aber in TeX ist es m<>glich, eigene Befehlssequenzen, sogenannte Makros,
zu definieren.
Und dadurch sind die M<>glichkeiten von TeX schier unbegrenzt.
\layout Standard
Die meisten Leute, die TeX verwenden, benutzen tats<74>chlich ein Makropaket,
das
\noun on
Knuth
\noun default
zusammengestellt hat, um den Gro<72>teil der Details beim Zeichensatz vor
dem Anwender zu verstecken.
Dieses Makropaket ist meist gemeint, wenn man von TeX spricht.
Das eigentliche TeX mit seinen expliziten Satzbefehlen benutzt kaum ein
normaler Anwender, das machen nur diejenigen Leute, die selber Makropakete
entwickeln.
Und hier kommt
\noun on
Leslie Lamport
\noun default
ins Spiel.
Er wollte ein Makropaket, da<64> sich n<>her am Benutzer orientiert, und nicht
an den Feinheiten beim Textsatz.
Ein Paket, mit dem sich einfach Dinge wie Abschnitte, Tabellen oder mathematisc
he Formeln schreiben lassen, ohne zu verwirrend zu sein.
So wurde LaTeX geboren.
\layout Standard
Parallel zur Weiterentwicklung von LaTeX entstanden andere, spezielle Pakete
f<>r TeX: Eines, um Folien zu schreiben oder eines, um Artikel f<>r mathematische
Zeitschriften zu erstellen, und so fort.
Einige der Autoren verwendeten dazu TeX, andere begannen, LaTeX abzu<7A>ndern.
Um dieses Wirrwarr zu vereinfachen, begann eine Gruppe von LaTeX-Experten
(zu denen nat<61>rlich auch
\noun on
Lamport
\noun default
selbst geh<65>rte) in den sp<73>ten 80-er Jahren, LaTeX2e zu entwickeln, die
heutige Version von LaTeX.
Diese neue Version stellt auch Befehle zur Verf<72>gung, um einfach neue Makros
zu erstellen, andere Zeichens<6E>tze zu definieren und so weiter.
Alles in allem ist LaTeX dadurch selber eine ziemlich umfangreiche
\begin_inset Quotes gld
\end_inset
Sprache
\begin_inset Quotes grd
\end_inset
geworden.
<20>berall auf der Welt haben Benutzer ihre eigenen Erweiterungen f<>r LaTeX
geschrieben.
\layout Standard
Es existieren zwei unterschiedliche Wege, wie man LaTeX erweitern kann:
Klassen und Stile.
Eine
\emph on
Klasse
\emph default
besteht aus einer Reihe von LaTeX- (und TeX-) Makros, die eine neue Art
von Dokument beschreiben, wie etwa ein Buch oder einen Artikel.
Es gibt z.
\begin_inset ERT
status Collapsed
\layout Standard
\backslash
,
\end_inset
B.
Klassen f<>r Folien, f<>r Artikel in mathematischen oder physikalischen Zeitschri
ften\SpecialChar \ldots{}
viele Universit<69>ten haben sogar eine eigene Klasse f<>r ihre Dissertationen
zusammengestellt! Im Gegensatz dazu definiert ein
\emph on
Stil
\emph default
keine neue Art von Dokument, sondern eine anderes
\emph on
Verhalten
\emph default
, das ein Dokument nutzen kann.
So nutzt LyX zwei unterschiedliche Stil-Dateien, um die R<>nder und Zeilenabst<73>n
de in den Dokumenten festzulegen.
Es existieren Stil-Dateien f<>r fast jeden denkbaren Zweck: Um Etiketten
und Umschl<68>ge zu beschriften, den Texteinzug zu ver<65>ndern, um Grafikdateien
handhaben zu k<>nnen, spezielle Kopf- und Fu<46>zeilen zu erstellen, Literaturliste
n den eigenen W<>nschen anzupassen, Erscheinungsbild und Position von Fu<46>noten,
Tabellen und Abbildungen zu ver<65>ndern und so weiter und so fort.
\layout Standard
Hier eine kurze Zusammenfassung:
\layout List
\labelwidthstring 00.00.0000
TeX: Makrof<6F>hige Programmiersprache f<>r Schriftsatz.
\layout List
\labelwidthstring 00.00.0000
LaTeX: Makropaket auf der Basis von TeX.
\layout List
\labelwidthstring 00.00.0000
Klassen: Beschreibung eines Dokumententyps, verwendet LaTeX.
\layout List
\labelwidthstring 00.00.0000
Stile: Ver<65>ndern die Standardeinstellungen von LaTeX.
\layout List
\labelwidthstring 00.00.0000
LyX: Visuelle WYSIWYM-Textverarbeitung, die LaTeX mit all seinen F<>higkeiten
zum Ausdruck verwendet.
\layout Standard
Der Zweck dieses Abschnittes war es, ihnen zu zeigen,
\emph on
warum
\emph default
LyX etwas anders arbeitet als andere Textverarbeitungen.
Dieser Grund ist einfach: LyX verwendet LaTeX als Formatierprogramm f<>r
den Ausdruck.
Wie auch LaTeX konzentriert sich LyX auf den Inhalt Ihres Textes --- also
\emph on
was
\emph default
Sie schreiben.
Der Rechner k<>mmert sich dann darum, da<64> es gut aussieht.
\layout Standard
Ach ja --- eine letzte Bemerkung.
LaTeX spricht man aus wie TeX, das sich auf das Wort Blech reimt.
Laut Lamport kann man LaTeX auch
\begin_inset Quotes gld
\end_inset
L<EFBFBD>itech
\begin_inset Quotes grd
\end_inset
aussprechen.
Wer es so ausspricht wie das Material, aus dem Kondome hergestellt werden,
spricht es falsch.
LyX dagegen spricht man
\begin_inset Quotes gld
\end_inset
L<EFBFBD>cks
\begin_inset Quotes grd
\end_inset
.
Oder
\begin_inset Quotes gld
\end_inset
Licks
\begin_inset Quotes grd
\end_inset
--- je nachdem, aus welchem Land man stammt\SpecialChar \ldots{}
aber <20>ber die Aussprache wurden
auf der Mailing Liste schon endlose Diskussionen gef<65>hrt, also sprechen
Sie es einfach so aus, wie es Ihnen gef<65>llt --- nur nicht
\begin_inset Quotes gld
\end_inset
word
\begin_inset Quotes grd
\end_inset
.
\family typewriter
:-)
\layout Chapter
Der Weg durch die Dokumentation
\layout Standard
Die LyX-Dokumentation wurde in mehrere Dateien aufgeteilt, um es einfacher
zu machen, all Ihre Fragen zu beantworten und alle M<>glichkeiten und Vorz<72>ge
von LyX zu beschreiben.
Jedes dieser Dokumente verfolgt seinen eigenen Zweck, der weiter unten
beschrieben wird.
Bevor Sie sich jedoch diesen Dateien widmen, lesen Sie bitte sorgf<67>ltig
die vorliegende
\emph on
Einf<EFBFBD>hrung
\emph default
, denn sie enth<74>lt eine Menge wichtiger und hilfreicher Informationen und
Hinweise, die Ihnen einige Zeit ersparen k<>nnen.
\layout Standard
Obwohl LyX mittlerweile eine Versionsnummer 1.0 weit <20>berschritten hat, kann
die Dokumentation immer noch teilweise unvollst<73>ndig sein oder sich noch
auf eine <20>ltere Version beziehen.
Wie auch das Programm LyX selber wird die Dokumentation von einer Gruppe
von Freiwilligen geschrieben, die
\begin_inset Quotes gld
\end_inset
nebenher
\begin_inset Quotes grd
\end_inset
auch noch einem richtigen Beruf nachgehen, Familien haben, ihren M<>ll wegbringe
n m<>ssen usw.
Wir sind st<73>ndig bem<65>ht, die Texte so vollst<73>ndig und korrekt wie m<>glich
zu halten, doch das gelingt manchmal nicht da die Entwickler immer dabei
sind, neue Details einzubauen, w<>hrend wir die alten noch dokumentieren.
Wenn Sie an dieser Situation etwas <20>ndern wollen gibt Ihnen Abschnitt\SpecialChar ~
\begin_inset LatexCommand \vref{sec:Helfen}
\end_inset
einige Hinweise, wie auch Sie Ihren Teil zu LyX beitragen k<>nnen.
\layout Standard
Und noch eine Bitte: Wenn Ihnen in dieser Dokumentation irgendetwas unklar
oder falsch erscheint, z<>gern Sie nicht, uns dies mitzuteilen! Sie erreichen
das LyX-Entwickler-Team <20>ber die Mailing-Liste
\begin_inset LatexCommand \url{lyx-docs@lists.lyx.org}
\end_inset
.
Falls Sie dringende Fragen haben, die in der Dokumentation offensichtlich
nicht beantwortet werden, gibt es eine sehr aktive Mailing Liste die Sie
unter
\family typewriter
lyx-users@lists.lyx.org
\family default
erreichen k<>nnen.
\layout Section
Das Format der Handb<64>cher
\layout Standard
Einige von Ihnen haben vielleicht die gesamte Dokumentation ausgedruckt.
Andere lesen sie
\begin_inset Quotes gld
\end_inset
online
\begin_inset Quotes grd
\end_inset
, also als Datei in LyX.
F<>r diejenigen, die online lesen, gibt es einige Unterschiede zur gedruckten
Version.
Zun<75>chst ist der Titel einfach am Anfang des Dokuments, und nicht sch<63>n
zentriert auf einer eigenen Seite.
Es sind zun<75>chst auch weder Inhaltsverzeichnis noch Fu<46>noten sichtbar.
Eine Fu<46>note sieht so
\begin_inset Foot
collapsed false
\layout Standard
Hallo! Zum Schlie<69>en dieser Fu<46>note klicken Sie bitte auf das grau unterlegte
Feld mit dem Wort
\begin_inset Quotes gld
\end_inset
Fu<EFBFBD>note
\begin_inset Quotes grd
\end_inset
.
\end_inset
aus.
Um sie zu <20>ffnen, klicken Sie mit dem linken Mausknopf darauf.
Um das Inhaltsverzeichnis zu betrachten klicken Sie entweder auf den entspreche
nden grauen Kasten oder w<>hlen Sie das Men<65>
\family sans
\bar under
N
\bar default
avigieren
\family default
, dort wird der Inhalt ebenfalls automatisch angezeigt -- Versuchen Sie
es einmal!
\layout Standard
In der gedruckten Version dieser Hilfetexte erscheinen die Querverweise
mit ihren tats<74>chlichen Kapitel- und Seitennummern.
Wenn Sie den Text jedoch von LyX aus lesen, sehen Sie lediglich grau unterlegte
Felder wie das folgende:
\begin_inset LatexCommand \vref{sec:Helfen}
\end_inset
(in der gedruckten Version steht hier eine Zahl).
Wenn Sie mit der Maus auf diesen grauen Kasten klicken, <20>ffnet sich automatisch
ein Fenster mit allen Querverweisen des Dokumentes.
In diesem Dokument finden Sie nur den Eintrag
\begin_inset Quotes gld
\end_inset
sec:Helfen
\begin_inset Quotes grd
\end_inset
.
Sie gelangen an die entsprechende Stelle, wenn Sie die Schaltfl<66>che
\begin_inset Quotes gld
\end_inset
\family sans
Gehe zu Referenz
\family default
\begin_inset Quotes grd
\end_inset
anklicken.
Zur<75>ck an die Ausgangsposition zu gelangen ist genauso einfach.
Mit
\family sans
Strg+<
\family default
kommen Sie wieder zur<75>ck an die urspr<70>ngliche Stelle.
(Was
\begin_inset Quotes gld
\end_inset
\family sans
Strg+<
\family default
\begin_inset Quotes grd
\end_inset
bedeutet, wird gleich erkl<6B>rt.)
\layout Standard
Nachdem nun die wichtigsten Unterschiede zwischen der gedruckten und der
Online-Dokumenta\SpecialChar \-
tion gekl<6B>rt sind, k<>nnen wir uns mit dem Format der Handb<64>cher
befassen.
Sie werden immer wieder Begriffe finden, die in unterschiedlichen Zeichens<6E>tzen
gesetzt sind:
\layout Itemize
\emph on
Hervorgehoben
\emph default
wird generell benutzt, um Dinge zu betonen, Buchtitel zum Beispiel, oder
Namen von Abschnitten in anderen Handb<64>chern oder Hinweise der Autoren.
\layout Itemize
\family typewriter
Schreibmaschine
\family default
kennzeichnet Programmtext und Dateinamen, LaTeX- und/oder LyX-Code und
Funktionen.
\layout Itemize
\family sans
Serifenfrei
\family default
bezeichnet Namen von Men<65>s, Kn<4B>pfen, Popups und Tasten der Tastatur.
\layout Itemize
\noun on
Kapit<EFBFBD>lchen
\noun default
werden f<>r Eigennamen verwendet.
\layout Standard
Tasten und Tastaturbelegungen werden im Abschnitt
\emph on
Grundlegende Tastaturfunktionen
\emph default
des
\emph on
Benutzerhandbuches
\emph default
behandelt.
Wenn Tasten bezeichnet werden sollen, gelten folgende Regeln:
\layout Itemize
\family sans
\begin_inset Quotes gld
\end_inset
Strg+
\begin_inset Quotes grd
\end_inset
\family default
wird in den Men<65>s mit
\family sans
C-
\family default
bezeichnet.
\layout Itemize
\family sans
\begin_inset Quotes gld
\end_inset
Umschalt+
\family default
\begin_inset Quotes grd
\end_inset
wird in den Men<65>s mit
\family sans
S-
\family default
(
\begin_inset Formula $\Uparrow$
\end_inset
) bezeichnet.
\layout Itemize
\family sans
\begin_inset Quotes gld
\end_inset
Alt+
\family default
\begin_inset Quotes grd
\end_inset
wird in den Men<65>s mit
\family sans
M-
\family default
bezeichnet.
Wenn Ihre Tastatur eine
\family sans
Meta
\family default
-Taste hat, ist diese gemeint.
\layout Itemize
\family sans
\begin_inset Quotes gld
\end_inset
F1
\family default
\begin_inset Quotes grd
\end_inset
\SpecialChar \ldots{}
\family sans
\begin_inset Quotes gld
\end_inset
F12
\family default
\begin_inset Quotes grd
\end_inset
sind die Funktionstasten.
\layout Itemize
\begin_inset Quotes eld
\end_inset
\family sans
Esc
\family default
\begin_inset Quotes erd
\end_inset
ist die Escape-Taste.
\layout Itemize
\family sans
\begin_inset Quotes gld
\end_inset
L
\family default
inks
\begin_inset Quotes grd
\end_inset
\family sans
\begin_inset Quotes gld
\end_inset
R
\family default
echts
\begin_inset Quotes grd
\end_inset
\family sans
\begin_inset Quotes gld
\end_inset
Auf
\family default
\begin_inset Quotes grd
\end_inset
\family sans
\begin_inset Quotes gld
\end_inset
Ab
\family default
\begin_inset Quotes grd
\end_inset
: die Cursor-Tasten.
\layout Itemize
\family sans
\begin_inset Quotes gld
\end_inset
Einfg
\family default
\begin_inset Quotes grd
\end_inset
\family sans
\begin_inset Quotes gld
\end_inset
Entf
\family default
\begin_inset Quotes grd
\end_inset
\family sans
\begin_inset Quotes gld
\end_inset
Pos\SpecialChar ~
1
\family default
\begin_inset Quotes grd
\end_inset
\family sans
\begin_inset Quotes gld
\end_inset
Ende
\family default
\begin_inset Quotes grd
\end_inset
\family sans
\begin_inset Quotes gld
\end_inset
Bild
\begin_inset Formula $\uparrow$
\end_inset
\family default
\begin_inset Quotes grd
\end_inset
\family sans
\begin_inset Quotes gld
\end_inset
Bild
\begin_inset Formula $\downarrow$
\end_inset
\family default
\begin_inset Quotes grd
\end_inset
: Das sind die 6 Tasten <20>ber den Cursor-Tasten.
\layout Itemize
\family sans
Return
\family default
und
\family sans
Enter
\family default
bezeichnen dieselbe Taste.
Manche Tastaturen haben diese beiden Tasten, manche bezeichnen sie auch
nur mit einem abgeknickten Pfeil.
F<>r LyX sind beide Tasten gleichwertig, deshalb mu<6D> keine Unterscheidung
gemacht werden.
\layout Standard
Ab und zu werden Sie auch Hinweise sehen wie
\begin_inset Quotes gld
\end_inset
(siehe
\emph on
Tutorium
\emph default
)
\begin_inset Quotes grd
\end_inset
.
Dort sind f<>r jede Funktion auch alle m<>glichen Tastaturbelegungen aufgez<65>hlt,
Sie k<>nnen also auch dort nachschlagen.
Beachten Sie dabei bitte auch, da<64> unter den LyX Benutzern zwei unterschiedlich
e Tastaturbelegungen verbreitet sind: Der standardm<64><6D>ig voreingestellte
\begin_inset Quotes gld
\end_inset
CUA
\begin_inset Quotes grd
\end_inset
-Stil (Nutzern aus der PC-Welt vertraut) und der
\begin_inset Quotes gld
\end_inset
Emacs
\begin_inset Quotes grd
\end_inset
-Stil, der mehr von denen verwendet wird, die im Unix-Umfeld gro<72> geworden
sind und dort diesen Editor verwenden.
Falls nicht anders angegeben beziehen sich alle Tastaturbelegungen auf
die Standardeinstellung CUA.
Falls Sie Emacs verwenden sind Sie sicher auch clever genug die Dokumentation
zu lesen und die entsprechenden Tastaturk<72>rzel selbst herauszusuchen.
\layout Section
Die Handb<64>cher
\layout Standard
Die folgende Liste beschreibt den Inhalt aller Dateien der LyX-Dokumentation:
\layout Description
\emph on
Einf<EFBFBD>hrung
\emph default
\SpecialChar ~
\newline
Diese Datei.
\layout Description
\emph on
Tutorium
\emph default
\SpecialChar ~
\newline
Wenn Sie neu bei LyX sind und zuvor niemals LaTeX verwendet haben, sollten
Sie hier mit dem Lesen beginnen.
Wenn Sie der Meinung sind, LaTeX sei das Material, aus dem Kondome hergestellt
werden, sollten Sie es auf jeden Fall lesen.
Danach werden Sie vielleicht immer noch denken, LaTeX sei ein elastisches
Material, aber immerhin wissen Sie dann, wie Sie mit LyX umgehen\SpecialChar \ldots{}
\begin_deeper
\layout Standard
Wenn Sie bereits mit LaTeX gearbeitet haben, sollten Sie das
\emph on
Tutorium
\emph default
dennoch lesen und gleich mit dem Kapitel
\begin_inset Quotes gld
\end_inset
LyX f<>r LaTeX-Benutzer
\begin_inset Quotes grd
\end_inset
beginnen.
Ein <20>berfliegen der restlichen Kapitel schadet aber sicherlich nicht.
\layout Standard
Wenn Sie zu irgendeinem Zeitpunkt mit LyX nicht richtig klarkommen, lesen
Sie das Tutorium (nochmals) sorgf<67>ltig durch; es stellt ein sehr gutes
Sprungbrett f<>r die weitere Suche in den anderen Handb<64>chern dar.
\end_deeper
\layout Description
\emph on
Benutzerhandbuch
\emph default
\SpecialChar ~
\newline
Der Hauptteil der Dokumentation.
Hier werden (m<>glichst) alle grundlegenden Funktionen und F<>higkeiten von
LyX beschrieben.
Der Text setzt voraus, da<64> Sie das
\emph on
Tutorium
\emph default
gelesen haben.
\layout Description
\emph on
Profi-Tipps
\emph default
\SpecialChar ~
\newline
Erweiterung des
\emph on
Benutzerhandbuches
\emph default
.
Es erl<72>utert die Verwendung von LaTeX-Kommandos, zus<75>tzliche Layouts und
erweiterte Bearbeitungsm<73>glichkeiten, inklusive einiger Tricks der LaTeX-Profis.
\layout Description
\emph on
Anpassung
\emph default
\SpecialChar ~
\newline
Eine Beschreibung der Konfigurationsm<73>glichkeiten f<>r Fortgeschrittene.
Hier wird auch beschrieben, wie LyX konfiguriert wird.
Das umfa<66>t Tastaturbelegung, Internationalisierung und Konfigurationsdateien.
Denken Sie besser nicht daran, es zu lesen, ohne vorher das
\emph on
Tutorium
\emph default
durchgearbeitet zu haben.
\layout Description
\emph on
LaTeX\SpecialChar ~
Konfiguration
\emph default
\SpecialChar ~
\newline
Bei der Installation untersucht LyX Ihr System.
Diese Datei enth<74>lt die dabei gefundenen Informationen.
Sehen Sie sich diese Datei ruhig einmal an und entscheiden, welche eventuell
fehlenden LaTeX-Pakete Sie noch installieren wollen.
\layout Standard
Die einzelnen Dokumente verweisen teilweise aufeinander.
So enth<74>lt das
\emph on
Benutzerhandbuch
\emph default
auch einige Informationen zur Installation und Anpassung, verweist den
Leser aber f<>r weitere Infos an das Handbuch
\emph on
Anpassung
\emph default
.
\layout Standard
Bevor es jetzt richtig losgeht, noch einmal der Hinweis:
\layout Standard
\added_space_top 0.51cm \added_space_bottom 0.51cm \align center
Wenn Sie LyX das erste Mal verwenden, sollten Sie
\series bold
jetzt
\series default
das
\emph on
Tutorium
\emph default
lesen!
\layout Standard
Sie ersparen sich dadurch sicherlich einiges an Frustration und werden die
Vorz<72>ge von LyX sicher schnell zu sch<63>tzen wissen.
Denn LyX kann alles, was Sie von anderen Textverarbeitungen her kennen,
wenn es auch einen anderen Ansatz verwendet.
\layout Chapter
\begin_inset LatexCommand \label{sec:Helfen}
\end_inset
Wie helfe ich beim LyX Projekt?
\layout Section
Mithilfe bei LyX
\layout Standard
LyX ist haupts<74>chlich in C++ geschrieben (Der LaTeX-Import ist in Perl geschrieb
en).
Es ist ein sehr gro<72>es Projekt, und dadurch sicher nicht ohne Fehler oder
den Bedarf, den vorhandenen Code zu verbessern.
\layout Subsection
Fehler melden
\layout Standard
Es mag sein da<64> Sie beim Benutzen von LyX auf Dinge sto<74>en, die Sie als
Fehler ansehen.
Auch Abst<73>rze k<>nnen vorkommen, sie sind jedoch sehr selten.
Probleme mit der Benutzerschnittstelle haben bei den Entwicklern eine sehr
hohe Priorit<69>t: Hinweise auf Stellen, die Ihnen unklar oder verwirrend
erscheinen sind besonders hilfreich.
\layout Standard
LyX hat ein Web-basiertes Fehlermeldesystem, den
\begin_inset LatexCommand \htmlurl[LyX Bug Tracker]{http://bugzilla.lyx.org}
\end_inset
.
Sie sollten dort nachsehen bevor Sie einen Fehler melden, denn vielleicht
hat da<64> ja schon jemand getan.
Wenn Sie einen Kommentar zu einem bestehenden Fehler abgeben wollen, oder
einen neuen Fehler melden wollen, k<>nnen Sie das <20>ber den Bug Tracker tun,
oder Sie senden eine Email an die Entwickler-Liste,
\family typewriter
lyx-devel@lists.lyx.org
\family default
.
Archive der Liste erreichen Sie <20>ber die
\begin_inset LatexCommand \htmlurl[LyX Homepage]{http://www.lyx.org/}
\end_inset
.
\layout Standard
Eine gute (hilfreiche) Fehlerbeschreibung umfa<66>t mindestens auch die verwendete
Version von LyX.
Genaue und detaillierte Beschreibungen der Umst<73>nde, unter denen der Fehler
auftritt, werden bevorzugt.
Denn je mehr Zeit die Entwickler aufwenden m<>ssen, das Problem zu lokalisieren,
desto weniger Zeit finden sie, Verbesserungen einzubauen.
Geben Sie auch an auf welchem System Sie LyX verwenden, und welche Version
es ist.
Geben Sie an, welche Version der Systembibliotheken installiert ist, oder,
wenn es sich um ein Problem im Zusammenhang mit externen Programmen handelt,
die Versionsnummern dieser externen Programme.
Wenn es sich um ein Problem beim selbst compilieren handelt schicken Sie
die Datei
\family typewriter
config.log
\family default
mit und geben Sie an, welchen Compiler sie verwenden.
\layout Standard
Wenn Sie einen reproduzierbaren Absturz hervorrufen k<>nnen w<>re es extrem
hilfreich wenn Sie sich die Zeit nehmen k<>nnten, einen Backtrace mit einem
nicht-gestripten Binary durchzuf<75>hren (das installierte binary ist meist
gestrippt, im Gegensatz zu dem im Quellverzeichnis).
Starten Sie LyX von
\family typewriter
gdb
\family default
aus, also z.
\begin_inset ERT
status Collapsed
\layout Standard
\backslash
,
\end_inset
B.
\begin_inset Quotes gld
\end_inset
\family typewriter
gdb /usr/src/lyx-1.2/src/lyx
\family default
\begin_inset Quotes grd
\end_inset
und dann
\begin_inset Quotes gld
\end_inset
\family typewriter
run
\family default
\begin_inset Quotes grd
\end_inset
.
Verursachen Sie den Absturz, Sie landen dann wieder an der Eingabeaufforderung
von
\family typewriter
gdb
\family default
.
Erzeugen sie mit dem Befehl
\begin_inset Quotes gld
\end_inset
\family typewriter
bt
\family default
\begin_inset Quotes grd
\end_inset
einen Backtrace und schicken diesen zusammen mit dem Fehlerbericht ein
\begin_inset Foot
collapsed false
\layout Standard
Wenn Sie besonders gr<67>ndlich sein wollen benutzen Sie die Befehle
\begin_inset Quotes gld
\end_inset
\family typewriter
info locals
\family default
\begin_inset Quotes grd
\end_inset
und
\begin_inset Quotes gld
\end_inset
\family typewriter
up
\family default
\begin_inset Quotes grd
\end_inset
um die Werte der lokalen Variablen in einigen <20>bergeordneten Stack-Levels
auszugeben.
\end_inset
.
Im Zweifelsfall ist es aber wichtiger, einen reproduzierbaren Weg anzugeben,
wie der Absturz verursacht werden kann, da die Entwickler dann die M<>glichkeit
haben, selbst einen solchen Backtrace zu erstellen.
Ist der Absturz aber nicht so ohne weiteres reproduzierbar ist ein solcher
Backtrace essentiell, denn er ist dann die einzige M<>glichkeit, den Fehler
einzukreisen.
\layout Subsection
Fixes und neue F<>higkeiten beisteuern
\layout Standard
Wenn Sie <20>nderungen an den LyX Quellen vorgenommen haben von denen Sie meinen
da<64> sie fester Bestandteil von LyX werden sollten, schicken die diese <20>nderunge
n als vereinheitlichte Differenz-Datei (
\family typewriter
diff -u
\family default
) an die oben angegebene Entwickler-Liste.
Vergessen Sie nicht ein <20>nderungsprotokoll und eine Beschreibung, was der
Patch macht.
\layout Section
Hilfe bei der Dokumentation
\layout Standard
Die Dokumentation von LyX ist sehr ausf<73>hrlich und umfangreich.
Jedoch befindet sich LyX in stetiger Weiterentwicklung, und mit jeder Version
kommen neue Merkmale hinzu.
Eventuell finden Sie einen Teil in der Dokumentation, der der Verbesserung
bedarf.
Dieser Abschnitt beschreibt, was Sie tun sollten wenn Sie einen Fehler
finden oder einfach nur Vorschl<68>ge haben, wie man sie verbessern kann.
\layout Subsection
Fehler in den Handb<64>chern
\layout Standard
Wenn Sie eine Unstimmigkeit in der Dokumentation entdecken, schicken Sie
bitte eine Mail an die Mailing Liste
\family typewriter
lyxdoc@lists.lyx.org
\family default
.
Das Dokumentationsteam wird sich darum k<>mmern, da<64> sie beseitigt wird.
\layout Subsection
Dem Dokumentationsteam beitreten
\layout Standard
Wie alle anderen Bereiche von LyX kann auch das Dokumentations-Team Hilfe
immer gut gebrauchen.
Wenn Sie daran interessiert sind, bei der Dokumentation mitzumachen, m<>ssen
Sie zun<75>chst folgende Dinge sicherstellen:
\layout Enumerate
Besorgen Sie sich die neueste Version der LyX-Quellen.
Packen Sie das Archiv aus
\begin_inset Foot
collapsed false
\layout Standard
Sie k<>nnen sich die aktuellste Version auch aus dem LyX CVS Archiv besorgen
- sie befindet sich im Modul
\family typewriter
lyxdoc
\family default
.
\end_inset
.
Im Hauptverzeichnis finden sie das Unterverzeichnis
\family typewriter
lib/doc
\family default
.
Darin befindet sich die Datei
\family typewriter
DocStyle.lyx
\family default
.
Lesen Sie sie, sie ist ein Stil-Leitfaden f<>r die Dokumentation.
\layout Enumerate
G<EFBFBD>nnen Sie sich ein oder zwei Tage Pause und lesen Sie
\family typewriter
DocStyle.lyx
\family default
nochmal.
\layout Enumerate
Als n<>chstes lesen Sie
\emph on
Benutzerhandbuch
\emph default
und
\emph on
Tutorium
\emph default
.
\begin_deeper
\layout Standard
Dieser Schritt dient dazu Ideen zu liefern.
Das
\emph on
Tutorium
\emph default
und das
\emph on
Benutzerhandbuch
\emph default
sind die vollst<73>ndigsten und aktuellsten Dokumente der Serie.
Es sollte Ihnen ein paar Hinweise geben, wie wir uns die Dokumentation
vorstellen.
\end_deeper
\layout Enumerate
Setzen Sie sich mit dem Team in Verbindung:
\begin_deeper
\layout Standard
\family typewriter
lyx-docs@lists.lyx.org
\layout Standard
Dort k<>nnen Sie ihre Ideen diskutieren und bekommen Feedback.
\end_deeper
\layout Standard
Dabei ist alles an <20>nderungen m<>glich, angefangen von Verbesserungen der
Verst<73>ndlichkeit bis hin zu einer kompletten Umstrukturierung --- alles
was die Dokumentation verbessert ist herzlich willkommen.
\the_end