\documentclass[oneside,%
	       idxtotoc,%
	       a4paper,%
	       11pt]%
	       {scrartcl}

\usepackage{eisfair}
\makeindex
\usepackage{palatino}

\usepackage{listings}

\begin{document}

\title{Dokumentation f"ur eisfair schreiben}
\author{J"org Hoh \and Torsten Georg}

\maketitle

%%%%%%%%%%%%%%%% Start %%%%%%%%%%%%%%%%%%%%%%

\section*{Einf"uhrung}

eisfair als Projekt soll sich dadurch auszeichnen, dass wir sehr gute Dokumentation bereitstellen wollen, die es auch Personen, die sich weniger gut mit den einzelnen Programmen auskennen, erlaubt, sie in ihrem Sinne zu konfigurieren.

Dieses Dokument soll als Anleitung daf"ur dienen, wie man mit \LaTeX Dokumente schreibt und formatiert; zuerst werden die grundlegenden Mechanismen von \LaTeX erkl"art, um dann sp"ater auf die speziellen Befehle einzugehen, die in Datei eisfair.sty bereitgestellt werden. Wer sich daher bereits mit \LaTeX auskennt, der kann gerne bei den \jump{MACROS}{eisfair-Befehlen} weitermachen.

Wer seine \LaTeX-Kenntnisse auf eine breitere Basis stellen will, dem kann ich das Buch

\LaTeX -- das Praxisbuch \\
Elke \& Michael Niedermaier \\
Franzis Verlag\\

empfehlen. Dieses Buch behandelt die Grundlagen und geht dann relativ schnell auf Erweiterungspakete ein, die man im t"aglichen Umgang mit \LaTeX sehr gut brauchen kann, angefangen von Tabellen, Bildern, (nat"urlich) mathematischen Formeln bis hin zu fortgeschrittenen Tricks wie dem Erstellen von eigenen Bildern mit \LaTeX.

Wer erstmal kein Geld ausgeben m"ochte, der findet im Internet eine ganze Menge an Informationen. Der erste Anlaufpunkt ist die deutsche Anwendervereinigung \TeX DANTE e.V. (\url{http://www.dante.de}).

Ein \LaTeX-Tutorium haben Torsten Bronger, Christian Faulhammer und Mark Trettin verfa"st (\url{http://latex-tutorium.sourceforge.net}) und von Manuela J"urgens von der Fernuniversit"at Hagen gibt es das Ganze noch etwas ausf"uhrlicher:
\begin{itemize}
	\item \LaTeX - eine Einf"uhrung und ein bisschen mehr..., FernUniversit"at Hagen, 2000, \href{ftp://ftp.fernuni-hagen.de/pub/pdf/urz-broschueren/broschueren/a0260003.pdf}{Online} (PDF)
	\item \LaTeX - Fortgeschrittene Anwendungen (oder: Neues von den Hobbits)..., FernUniversit"at Hagen, 2000, \href{ftp://ftp.fernuni-hagen.de/pub/pdf/urz-broschueren/broschueren/a027.pdf}{Online} (PDF)
\end{itemize}
\section*{Grundlagen}

\LaTeX wird in einem normalen Texteditor geschrieben und dann von einer Art Compiler in das entsprechende Zielformat (Postscript,PDF,dvi, HTML,...) umgesetzt. Als Editor kann man jeden beliebigen Editor seiner Wahl benutzen (zur Not auch den Windows-Editor), aber es empfiehlt sich, einen Editor zu benutzen, der auch Syntaxhighlighting f"ur \LaTeX beherrscht. Unter Unix/Linux beherrscht das eigentlich jeder Editor. 

Unter Windows sei hier zum Beispiel UltraEdit genannt. Dies ist ein m"achtiger Editor, der die M"oglichkeit bietet, eine eigene Syntaxhighlighting zu definieren. Auf der Homepage (\url{http://www.ultraedit.com}) findet man "`Wordfiles"' zu jedem Zweck ("`Wordfiles"' definieren f"ur UltraEdit das Syntaxhighlighting). Zur \LaTeX -- Installation unter Windows hat Joachim Schlosser eine Anleitung verfasst. Diese findet man auf seiner Homepage (\url{http://schlosser.info/latexsystem}).

Weiterhin ben"otigt man den \glqq{}\LaTeX-Compiler\grqq{}. Diesen gibt es in verschiedenen Paketen, die oftmals unterschiedliche Erweiterungspakete enthalten. Im Moment mit am meisten verbreitet ist \glqq{}tetex\grqq{}, das sowohl unter Windows als auch Unix (und noch ein paar Plattformen mehr) erh"altlich ist.

Ein Erweiterungspaket, dass in den Paketen nicht immer enthalten ist, aber im deutschen Sprach- und Schriftraum sehr zu empfehlen ist, ist Koma-Script.

F"ur KDE gibt es ein sehr geschicktes Werkzeug namens \glqq{}Kile\grqq{}, welches eine Art von Entwicklungsumgebung f"ur \LaTeX darstellt. Es beinhaltet einen Editor, eine Vorschaufunktion und M"oglichkeiten, direkt daraus verschiedene Zielformate zu erzeugen.

\subsection*{"ubersetzen von \LaTeX-Dokumenten}

Im Normalfall benennt man die Dokumente mit \textit{dokument.tex}; dann kann man mit 
\begin{verbatim}
pdflatex dokument.tex
\end{verbatim}

oder

\begin{verbatim}
latex dokument.tex
\end{verbatim}

eine pdf-Datei oder eine dvi-Datei erzeugen. Aus letzterer kann mittels \textit{dvi2ps} Postscript-Dateien erzeugen. Dieser "ubersetzungslauf ist im Allgemeinen sehr geschw"atzig und spuckt jede Menge Informationen "uber Worttrennungen und Zeilen-und Seitenumbr"uche aus. Wenn Fehler auftreten (Tippfehler), dann wird dieser recht detailliert gemeldet, mit Dateinamen und Zeilennummer, so dass man ihn im Allgemeinen recht schnell beseitigen kann.

\subsection*{Aufbau eines Dokuments}

\renewcommand{\jump}[2]{\ref{#1} (Seite \pageref{#1})}


Jedes \LaTeX-Dokument besteht aus einem Header und dem eigentlichen Text. Im Header werden Erweiterungspakete geladen, dokumentweite Einstellungen getroffen und Befehle definiert. Eine einfaches Dokument kann wie in Abbildung \ref{fig:simpledoc} (Seite \pageref{fig:simpledoc}) aussehen.

\begin{figure}
\caption{Ein einfaches \LaTeX-Dokument}
\label{fig:simpledoc}
  \begin{lstlisting}[frame=single]
\documentclass{scrartcl}
\usepackage{eisfair}

\begin{document}

\title{Titel}
\author{Name des Autors}
\maketitle

\section{Einleitung}

Und hier kommt dann die Einleitung ...

\end{document}
  \end{lstlisting}
\end{figure}


\subsection*{Abs"atze und Formatierung}

Zuerst ein paar Worte zum grunds"atzlichen Handling von Texten. \LaTeX organisiert die W"orter in Abs"atzen. Innerhalb dieser Abs"atze behandelt es dabei selbstst"andig den Zeilenumbruch und die Silbentrennung. Eingreifen in diese Mechanismen ist zwar m"oglich, aber vor allem zu Anfang noch nicht anzuraten.



\subsection*{Struktur eines Dokuments}

Grunds"atzlich werden Dokumente hierarchisch aufgeteilt, also Kapitel, Abschnitt, Unterabschnitt. Je nach Dokumentart sind dabei mehrere Mechanismen m"oglich.

\subsection*{Makros}
\label{MACROS}
ToBeDone
\end{document}

