Michael Puff - Latex

Warum Latex?

Ja, warum Latex? "Das ist doch umständlich, schwer zu lernen und man sieht nicht, was man schreibt." Das mögen so manche Vorurteile sein, die so mancher gegen Latex hegt. Ich habe auch erst relativ spät zu Latex gefunden. Und zwar musste ich eine Ausarbeitung für die Berufsschule schreiben und ich hatte einige andere Ausarbeitungen gesehen, hauptsächlich Diplomarbeiten und ähnliches. Diese hatten immer so schöne, schlichte, sachliche Deckblätter, das wollte ich auch haben. Man kann diese zwar relativ einfach mit herkömmlichen Textverarbeitungsprogrammen nachbauen, aber irgendwie war ich bei der nächsten Ausarbeitung wieder am basteln und dann sah das wieder anders aus, es war nicht einheitlich. Dann habe ich mir gedacht, dass die das bestimmt mit Latex machen. Das hat man ja schon gehört, dass man keine Bücher oder Diplomarbeiten mit Microsoft Word schreiben können soll. Nun ja, mit OpenOffice habe ich zumindest meine "Win32-API Tutorials" geschrieben und die haben auch 280 Seiten. Wenn man mit Unterdokumenten arbeitet geht es, aber die Formatierung war trotzdem ein Krampf und wenn es nur geht, versuche ich es zu vermeiden sie anzufassen, man könnte ja was kaputt machen. Desweiteren ist man fast mehr mit dem Layout beschäftigt, als mit dem Text. Hinzukam, dass ich gemerkt habe, dass in einem Programmiererforum anscheinend auch mehrere Leute mit Latex arbeiten. Also habe ich mir gedacht, dass solltest du dir auch mal angucken.

Nach dem ich mir die MiKTeX-Distribution installiert und mir mal so ein paar tex-Dateien angeguckt hatte, war ich erst mal etwas verwirrt, ob der ganzen Befehle und zwischen dem eigentlichen Text. Als ich mich dann aber etwas damit beschäftigt, etwas mit den Vorlagen rumgespielt und etwas im Internet gelesen hatte, kam ich dann doch ganz gut mit den Vorlagen zurecht. Nach dem ich dann die Ausarbeitung für die Schule von OpenOffice nach Latex übertragen hatte, lernte ich die Vorteile von Latex zu schätzen. Man will ein doppelseitiges Layout? Kein Problem eine Option in der Dokumentenklasse geändert und Latex macht den Rest: Seitenzahlen aussen, Kapitel im Seitenkopf aussen und alles was dazu gehört. Mit OpenOffice war das immer recht mühsam, wenn man das nicht regelmäßig macht. Dann fängt man wieder in den Menüs an zu suchen, wo man das einstellen muss und probiert mehr oder weniger die Optionen durch, bis man die passende gefunden hat. Und beim nächsten Dokument geht es wieder von vorne los. Dies nur mal ein Beispiel. Aber bei Tabellen, Aufzählungen usw. verhält es sich ähnlich. Gut, Tabellen sind etwas komplizierter, aber wenn man da mal den Code erstellt hat, dann geht es mit copy and paste eigentlich recht unproblematisch.

Um mit Latex PDFs zu erzeugen braucht man eigentlich keinen extra Editor. Im Grunde genommen reicht Notepad oder jeder beliebige andere Texteditor aus. Allerdings machen speziell für Latex vorgesehene Editoren das Erstellen etwas einfacher, da man dann das PDF nicht über einen Kommandozeilenaufruf des Latex Compilers "von Hand" erzeugen muss. Es gibt sehr viele Latex-Editoren. Darunter gibt es kostenpflichtige aber auch freie Editoren. Man muss einfach ausprobieren mit welchem Editor man selbst am besten klar kommt. Ich habe bisher nur zwei Editoren ausprobiert und das wären TeXnicCenter und LEd. Bei beiden Editoren handelt es sich um Freeware.

Da ich Programmierer bin und ich in meinen Tutorials auch häufig Code einfüge, war das bisher immer etwas umständlich, wenn man Syntaxhervorhebung haben wollte. Man brauchte ein Zusatztool für die IDE, das einem den Code mit Syntaxhervorhebung in das RTF-Format exportiert, um es dann in das Dokument einfügen zu können. Für Latex gibt es schon entsprechende Pakete, die das automatisch können. Man stellt einfach nur die gewünschte Sprache ein und kopiert den Quelltext direkt aus der IDE in das Latex-Dokument - fertig. Ähnlich verhält es sich mit der Kapitelnummerierung. Entweder fehlt sie mal oder aus einem unerfindlichen Grund fängt das Textverabeitungsprogramm mit der Nummerierung wieder von vorne an. Mit Latex zeichnet man die Kapitel \chapter{} und Unterkapiten \section{} einfach aus, Latex macht den Rest. An eines muss man sich allerdings erst gewöhnen, die Positionierung von Grafiken und Tabellen. Mit Textverabeitungsprogrammen schubst man sie so lange hin und her bis sie irgendwann mal da sind, wo man sie haben will. Latex ist ein Textsatzprogramm, welches ein professionelles Seitenbild /-layout nach allen Regeln der Buchdruckkunst erzeugt. Tabellen und Grafiken werden so positioniert, dass sich möglichst immer ein ausgewogenes Seitenbild ergibt, was wiederum heißt, dass man nur eine eingeschränkte Kontrolle darüber hat, wo die Grafik, dann nachher im Text erscheint. Dafür hat man dann aber auch ein sehr schönes, gut lesbares und sauber wirkendes Seitenlayout.

Letztendlich habe ich fest gestellt, dass ich Latex nicht mehr missen will. Größere Dokumente kann man damit sehr effektiv und effizient verfassen, da man sich so gut wie gar nicht mehr um das Layout kümmern muss, wenn man es einmal festgelegt hat. Individuelle Layouts sind zwar am Anfang mit etwas mehr Arbeit verbunden, aber wenn man keine zu extravaganten Vorstellungen realisieren will, kommt man mit Latex doch recht schnell zu einem befriedigenden Ergebnis.

Jonathan Nowak - Warum Latex?

Nützliche Links

Vorlagen

Bei diesen Vorlagen handelt es sich um Vorlagen, die ich auf Internetseiten zur freien Verfügung gefunden habe. Ich habe sie meinen Wünschen und Erfordernissen entsprechend noch etwas angepasst. Um sie kompilieren zu können unter MiKTeX müssen teilweise noch ein paar Pakete nachinstalliert werden. Besteht eine Internetverbindung ist dies kein großes Problem, da MiKTeX automatisch versucht fehlende Pakete runterzuladen und zu installieren. Eine Außnahme bildet allerdings das Zusatzpaket für die Rechnungsvorlage. Dieses muss von Hand installiert werden.

Quellcode Beispiele

Preamble

Dokumentenklasse

scrreprt: Report, Bericht
scrartcl: Artikel
scrlttr2: Brief

\documentclass[pdftex, a4paper]{scrreprt}

halfparskip,	% Absatz mit halber Zeile Abstand
titlepage, 		% Erzeugen einer Titelseite
abstracton, 	% Erzeugen einer Zusammenfassung
openright, 		% neue Kapitel fangen immer auf der echten Seite an
twoside, 		% beidseitiges Dokument
headsepline, 	% Trennline Kopfzeile
footsepline, 	% Trennlinie Fußzeile
bibtotoc]		% Literaturverzeichnis bekommt Eintrag in Inhaltsverzeichnis
        

Packages und deren Konfiguration

% Seitenformat
\usepackage{a4wide}
\topmargin=-10mm
\headsep=5mm

%Oder:
\usepackage{geometry}
\geometry{a4paper,left=30mm, right=30mm, top=25mm, bottom=30mm}

% Schrift
\usepackage[T1]{fontenc}
% Schriftpaket für 'Times New Roman'
\usepackage{times}
% Sans Serif Schrift
\renewcommand{\familydefault}{\sfdefault}
\usepackage{helvet}

% Farben
\usepackage{color}

% Quellcode
\usepackage{courier}
\usepackage{listings}

% Listings formatieren
\definecolor{codegray}{gray}{.95}
\definecolor{darkblue}{rgb}{0,0,.6}
\definecolor{darkred}{rgb}{.6,0,0}
\definecolor{darkgreen}{rgb}{0,.6,0}
\definecolor{red}{rgb}{.98,0,0}
\lstset{basicstyle=\small\ttfamily, frame=single, backgroundcolor=\color{codegray}, breaklines, showstringspaces=false,
  commentstyle=\itshape\color{darkgreen}, keywordstyle=\bfseries\color{darkblue}, stringstyle=\color{darkred},
  xleftmargin=0.5cm}

% Grafiken
\usepackage{graphicx}
\usepackage{floatflt}

% Kopf- und Fußzeilen
\usepackage{scrpage2}
\pagestyle{scrheadings}
\automark[chapter]{chapter}
\renewcommand*{\chapterpagestyle}{scrheadings}
\clearscrheadfoot
% Kopf aussen
\ohead[\headmark]{\headmark}	
% Kopf innen
\ihead[Kopfzeile innen]{Kopfzeile innen}	
% Fuß aussen
\ofoot[\pagemark]{\pagemark}	
% Fuß innen
\ifoot[Fußzeile innen]{Fußzeile innen}	

% Kompakte Listen, Aufzählungen
\usepackage{paralist}

% Tabellen
\usepackage{tabularx}
% gedrehte Tabelle
\usepackage{rotating}

% PDF einbinden
\usepackage{pdfpages}

% Mathe
\usepackage{amsmath}

% Stichwortverzeichnis
\usepackage{makeidx}

% Darstellung des Glossars einstellen
\usepackage[style=super,header=none,border=none,number=none,cols=2,toc=true]{glossary}
% Sprachspezifische Einstellungen
\usepackage{ngerman}
\usepackage[ngerman,iso]{isodate}
\usepackage[latin1]{inputenc}

% Links
\usepackage{hyperref}
\hypersetup{plainpages=false, linktocpage=true, colorlinks=true, breaklinks=true, linkcolor=black, menucolor=black,
  urlcolor=black, citecolor=black}
\urlstyle{same}

% Zeichnet einen grauen Kasten mit rotem Rahmen
\definecolor{mygray}{gray}{0.95}
\usepackage{framed}
\newenvironment{wichtigbox}{%
  \def\FrameCommand{\fboxrule 0.5mm \fcolorbox{red}{mygray}}%
  \MakeFramed {\advance\hsize-\width \FrameRestore}}%
 {\endMakeFramed}

% Stichwortverzeichniseintrag mit Untereintrag
\index{eos!dora}
\index{aemet@ämet}

% Glossar erstellen
\makeglossary
% Stichwortverzeichnis erstellen
\makeindex

Dokument

Titelseite

\title{Titel}
\subject{Thema}
\author{Autor}
\publishers{Publisher}
%\dedication{Widmung}
\maketitle

% Zusammenfassung
\begin{abstract}
	At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
\end{abstract}

Eigene Titelseite:

\begin{titlepage}
	\fontfamily{cmss}
	\begin{center}
		\huge{Dokumentation der betrieblichen Projektarbeit}\\
		\vspace{2cm}
		\Huge{\textbf{Projektname}}\\
		\vspace{4cm}
		\LARGE{Abschlussprüfung Frühjahr 2009}\\
		\vspace{1cm}
		\LARGE{von}\\
		\vspace{1cm}
		\LARGE{\textbf{Michael Puff}\\Straße\\Ort}\\
		\vspace{3cm}
		\Large{Projektverantwortlicher: }
	\end{center}
\end{titlepage}

Verzeichnisse

\tableofcontents % Inhaltsverzeichnis
\listoffigures          % Abbildungsverzeichnis
\listoftables           % Tabellenverzeichnis

\renewcommand{\glossaryname}{Glossar}
\printglossary

% Literaturverzeichnis
\begin{thebibliography}{------}
  \bibitem[Verweistext]{cite_link}
    Autor: \emph{Titel}. Verlag, Auflage, Datum, ISBN
  \bibitem[1]{wp_cc}
    Wikipedia: \emph{Centralized computing}. \url{http://en.wikipedia.org/wiki/Centralized_computing}, Stand: 2008-01-08
\end{thebibliography}

% Stichwortverzeichnisüberschrift ändern
\renewcommand{\indexname}{Stichwortverzeichnis}
% Stichwortverzeichnis soll im Inhaltsverzeichnis auftauchen
\addcontentsline{toc}{chapter}{Stichwortverzeichnis}
% Stichwortverzeichnis endgueltig anzeigen
\printindex

Beschriftung von Tabellen und Abbildungen ändern

\renewcommand{\tablename}{Tab.}
\renewcommand{\figurename}{Abb.}

Kapitel- und Sektionsüberschriften mit Bemerkung

%Kapitel mit Bemerkung
\newcommand{\remarkchapter}[2]{%
    \chapter[#1]{#1\newline\normalfont\small\textit{#2}}
}
 
%Sektionstitel mit Bemerkung
\newcommand{\remarksection}[2]{%
    \section[#1]{#1\newline\normalfont\small\textit{#2}}
}

Code-Beispiele

% Kapitelüberschrift mit Bemerkung
\remarkchapter{Dies ist die Überschrift}{Und dies ist der Kommentar}

% Aufzählungen
\begin{compactenum}
  \item ...
\end{compactenum}

\begin{compactitem}
  \item ...
\end{compactitem}

% Grafiken
\begin{figure}[htb]
  \centering
  \includegraphics[width=10cm]{Pfad/Dateiname}
  \caption{Beschriftung}
  \label{fig:Verweis}
\end{figure}

% mehrere Grafiken nebeneinander
\begin{figure}[ht]
  \centering
  \begin{minipage}[c] {5cm}
  	\includegraphics[width=5cm]{chapters/images/utp.png}
  \end{minipage}
  \begin{minipage}[c] {5cm}
  	\includegraphics[width=5cm]{chapters/images/stp.png}
  \end{minipage}
  \begin{minipage}[c] {5cm}
  	\includegraphics[width=5cm]{chapters/images/sutp.png}
  \end{minipage}
  \caption{UTP-, STP- und SUTP-Kabel}
  \label{fig:kabel}
\end{figure}

% Tabellen
\begin{table}
   \centering
   \begin{tabularx}{0.90\linewidth}{lX}
     \textbf{Überschrift Spalte 1} & \textbf{Überschrift Spalte 2}\\
     \hline
 	  Inhalt Spalte 1 Zeile 1	& Inhalt Spalte 2 Zeile 1\\
     \hline
   \end{tabularx}
   \caption{Beschriftung}
   \label{tab:Verweis}
\end{table}

% Verweise
\ref{Label}
\pageref{Label}

% Quellcode
\lstset{language=...}
\begin{lstlisting}
 ...
\end{lstlisting}

% Zitat
\begin{quote]...\end{quote}
\cite{label}

% Beschreibungen
\begin{description}
   \item[Schlagwort] Erklärung des Schlagwortes.
\end{description}

% Glossareintrag
\glossary{
name={jskdabvnajskdbvn},
description={Lieblingsspeise eines jeden Hundes. Besonderer Beliebtheit erfreuen sich Rinderknochen.}
}

% Mathematische Gleichungen
\begin{align}
	\text{Frequenz} &= \frac{\text{Lichtgeschwindigkeit}}{\text{Wellenlänge}} \label{mat:frequenz}\\	
	f [\frac{1}{s}] &= \frac{c [\frac{m}{s}]}{\lambda [m]}\\
	\text{Lichtgeschwindigkeit} &= 3 \times 10^8 \frac{m}{s}
\end{align}

% mehrere Spalten
\begin{multicols}{2}

\end{multicols}

Minimales Dokument

%
% Dokument	: Leeres Dokument
% Kapitel	: -
% Sektionen	: -
% Autor		: Michael Puff
% Datum		: 2009-05-06
% Kontakt	; http://www.michael-puff.de
%

\documentclass[pdftex, a4paper]{scrreprt}

% Seitenformat
\usepackage{a4wide}
\topmargin=-10mm
\headsep=5mm

\begin{document}

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore
magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd
gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing
elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos
et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore
et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita
kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.

Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu
feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit
augue duis dolore te feugait nulla facilisi. Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam
nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.

\end{document}

HTML Dateien erstellen

Es kann vorkommenn, dass man sein PDF auch online auf seiner Homepage veröffentlichen will. Nun haben aber PDFs den Nachteil, dass man sie sich erst runterladen muss, was etwas ärgerlich ist, wenn es eine große Datei ist und dann doch nicht das gewünschte drin steht des Weiteren haben PDFs den Nachteil, dass sie nicht von Suchmaschinen indiziert werden. Es gibt aber eine einfache Möglichkeit mit Latex aus den tex-Dateien anstatt des PDFs HTMl-Dateien zu erzeugen:

Dazu legt man ein neues Ausgabeprofil an und gibt bei Pfad des (La)Text-Compilers folgendes an: C:\Programme\MiKTeX 2.8\miktex\bin\htlatex.exe. Bei den Argumenten, die an den Compiler übergeben werden sollen: "%tm" "html,3". das war es schon. Die "3" bei den Argumenten beeinflusts die Aufteilung des Dokumentes in die zugehörigen HTML-Dateien.