% macropackage=lplaing
%
% LAYOUT.TEX - Kurzbeschreibung von PA 88-10-04 (LaTeX)

\documentstyle[11pt,twoside,ifthen,german,refman]{article}
% ifthen wird vom Bild von N.Beebe gebraucht!

\def\bs{\char'134 } % backslash in \tt font.

\title{Layout-"Anderungen mit \LaTeX}
\author{EDV-Zentrum der TU Wien, Abt.~Digitalrechenanlage \\
Hubert Partl \\
1988-10-04   \\
H27.0 --- Version 0}

\pagestyle{myfootings}
\markboth{Layout-"Anderungen mit \LaTeX}%
         {Layout-"Anderungen mit \LaTeX}
\setcounter{tocdepth}{2}

\begin{document}

\maketitle \makeauthor

Dieses Heft ist als Erg"anzung zu Kapitel~5 (``Designing It Yourself'')
des \LaTeX-Manuals von Leslie Lamport gedacht.

\tableofcontents


\newpage

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\section{Einleitung}

\subsection{Autor, Layout-Designer und Setzer}

Jedes Schrift"-st"uck
-- von einer kurzen handgeschriebenen Notiz bis zu einem gedruckten Buch --
besteht aus zwei Komponenten: {\bf Inhalt} und {\bf Form.}
In den meisten F"allen ist die Form nicht Selbstzweck sondern dient nur
dazu, den Inhalt f"ur den Leser verst"and"-lich darzustellen.

\marginlabel{Autor:}
Der {\bf Inhalt} wird vom jeweiligen Autor geliefert.
Bei Druckwerken wird der Autor meist durch den Lektor des Verlages
oder den Herausgeber der Zeitschrift unterst"utzt.

Bei der Verwendung des Textsatzsystems \LaTeX\ wird der Inhalt
im Hauptteil des \LaTeX-""Eingabefiles
angegeben --
also zwischen  \verb|\begin{document}|
und \verb|\end{document}| --
erg"anzt durch \LaTeX-Befehle, die
angeben, welche Bedeutung die einzelnen Text-Teile haben.

\marginlabel{Designer:}
Die {\bf Form} eines Druckwerks wird "ublicherweise vom Verleger festgelegt,
der das Layout von den im Verlag angestellten Designern
entwerfen l"a"st.

Die mit \LaTeX\ mitgelieferten sogenannten "`Document Styles"'
wurden von professionellen amerikanischen Layout-Designern f"ur die
von Leslie Lamport vorgesehenen Arten von Schrift"-st"ucken entworfen,
also f"ur wissenschaftliche Zeitschriften, Berichte und B"ucher
-- auf der Grundlage der in den USA "ublichen Konventionen.
Diese Layouts sind in den sogenannten "`Style-Files"' festgelegt.
Am Beginn des \LaTeX-""Eingabefiles
-- vor dem Befehl \verb|\begin{document}| --
wird angegeben, in welcher Form
der Inhalt des Schrift"-st"ucks gesetzt und ausgedruckt werden soll.

\marginlabel{Setzer:}
Der Setzer in der Druckerei
bringt den vom Autor bzw.\ Lektor gelieferten Inhalt
in die vom Layout-Designer festgelegte Form, in der das Schrift"-st"uck
dann schlie"slich ausgedruckt wird.

Bei der Verwendung von \LaTeX\ erfolgt das Setzen durch das Computer-""Programm
\TeX\ und das Ausdrucken durch ein weiteres Computer-""Programm,
den sogenannten Device-Driver.

\subsection{Layout-"Anderungen}

Wenn das Schrift"-st"uck nicht in einem der vorgefertigten \LaTeX-Layouts
gesetzt werden soll, sind die folgenden zwei Voraussetzungen notwendig:
\begin{enumerate}

\item Das Layout mu"s entworfen werden.
Dies sollte im allgemeinen von einem professionellen Designer gemacht werden.
Falls kein solcher zur Verf"ugung steht,
mu"s sich der Autor oder der Herausgeber als "`Amateur-Designer"'
versuchen -- am besten durch Anlehnung an professionell gestaltete
Vorbilder.

\seealso{\ref{design}}
Ausf"uhrlichere Hinweise dazu werden in Kapitel~\ref{design} angegeben.

\item Das Layout mu"s in Form eines \LaTeX-Style-Files formuliert
werden -- am besten in Form eines sogenannten "`Style-Option-Files"',
das nur die "Anderungen gegen"-"uber dem originalen Style-File enth"alt.
Die Angabe dieses "`Style"' bzw.\ dieser "`Style-Option"' am Beginn des
\LaTeX-""Eingabefiles bewirkt dann, da"s der Inhalt des Schrift"-st"ucks
in dieser neuen Form gesetzt und gedruckt wird.

\seealso{\ref{layout}}
Ausf"uhrlichere Hinweise dazu werden in Kapitel~\ref{layout} angegeben.

\end{enumerate}

\section{Die Kunst des Layout-Design}
\label{design}

\subsection{Allgemeine Regeln}

Es gibt fast keine allgemeing"ultigen Regeln,
sondern man mu"s f"ur jedes Schrift"-st"uck
oder jede Reihe von Schrift"-st"ucken
ein eigenes Layout entwerfen.

Dieses Layout mu"s sich vor allem daran orientieren,
{\it wer\/} das Schrft"-st"uck {\it wie\/} lesen wird.

Ein wichtiges Kriterium ist z.B., ob der Leser es
eher von A bis~Z durchgehend lesen will
wie einen Kriminalroman oder ein "`Tutorial"',
oder ob er eher bestimmte Stellen rasch auf"|finden will
wie in einem Telefonbuch oder in einem "`Reference Manual"'.

Au"serdem mu"s das Layout die bestehenden Konventionen ber"ucksichtigen,
vor allem die Gewohnheiten des Lesers,
aber auch den sogenannten "`House Style"', durch den sich
verschiedenartige Schrift"-st"ucke und die Produkte
verschiedener Hersteller oder Institutionen voneinander
unterscheiden sollen.\footnote{Man vergleiche z.B.\ das jeweils typische Layout
   verschiedener Fachzeitschriften oder Tageszeitungen.}

\attention
Der Hauptzweck des Layouts ist stets,
da"s der Leser die gesuchten Informationen gut findet und sie
gut lesen kann, und da"s er den Inhalt und den logischen Aufbau des
Schrift"-st"ucks richtig versteht.
Wichtig sind also "Ubersichtlichkeit, Lesbarkeit, Konsistenz und dergleichen.
Die Sch"on"-heit ("Asthetik) steht demgegen"-"uber
im allgemeinen nur an zweiter Stelle.\footnote{Dies gilt nat"urlich
nicht f"ur Werbeprospekte, Bild"-b"ande u.dgl.}

Im folgenden werden ein paar einfache "`Faustregeln"'
f"ur den Seitenaufbau angef"uhrt,
die f"ur die meisten Anwendungen G"ultigkeit haben.
\begin{description}

\item[Zeilenabst"ande]
Die Zeilenabst"ande m"ussen gr"o"ser als die Wortabst"ande sein,
damit die Augen des Lesers richtig entlang der Zeilen gef"uhrt
werden.

\item[Zeilenl"ange]
Die Zeilenl"ange
-- bzw.\ bei mehrspaltigem Druck die Spaltenbreite --
soll m"oglichst bei etwa 60~Zeichen pro Zeile liegen.
Zu lange Zeilen sind schlecht lesbar, weil sie anstrengende
Augenbewegungen erfordern und gleichzeitig die Wahrscheinlichkeit erh"ohen,
beim Zeilenwechsel in die falsche Zeile zu geraten.
Zu kurze Zeilen machen Probleme beim Randausgleich (Blocksatz)
und beim Abteilen (Silbentrennung).
Wenn l"angere Zeilen notwendig sind, dann m"ussen die Zeilenabst"ande
vergr"o"sert werden.

\item[Seitenaufbau]
Die normalen Textseiten sollen einen m"oglichst einheitlichen Aufbau haben.
Abbildungen, Tabellen und spezielle Seiten wie Inhaltsverzeichnis,
Index usw. sollen aber {\it nicht\/} in dasselbe Schema gepre"st werden,
sondern stets so viel Platz einnehmen, wie f"ur die jeweilige Tabelle etc.
am g"unstigsten ist (also durchaus k"urzer oder l"anger als die
normale Zeilenl"ange, evtl.~mit einem Rahmen darum herum).
Wenn m"oglich sollten bei der Seitenaufteilung auch "asthetische
Grundregeln wie z.B.\ der "`Goldene Schnitt"' ($ 13 : 8 \approx 8 : 5 $)
angewendet werden.

\item[Randnoten]
"`Randnoten"' sind f"ur viele Zwecke besser geeignet als Fu"s"-noten,
weil sie direkt neben dem Text erscheinen, auf den sie sich beziehen.
Dazu z"ahlen auch Symbole wie z.B. "`Achtung-Zeichen"', die
wichtige Text-Teile markieren bzw.\ den Leser auf sie hinweisen.

\item[Kopf- und Fu"szeilen]
Der Inhalt von Kopf- und Fu"s-Zeilen soll die Orientierung innerhalb
des Schrift"-st"ucks erleichtern. Falls zu erwarten ist, da"s manche Leser
einzelne Seiten aus dem Schrift"-st"uck herauskopieren (z.B.\ einen Artikel
aus einer Zeitschrift), sollte in der Kopf- oder Fu"szeile auch die
Information zu finden sein, aus welchem Schrift"-st"uck die Seiten stammen.
Falls h"aufig neue Versionen eines Schrift"-st"ucks erstellt werden
(z.B.\ bei Software-Manuals), sollte auch das Datum oder die Versionsnummer
in der Kopf- oder Fu"szeile aufscheinen.

\end{description}

\subsection{Spezielle Hinweise f"ur technische Beschreibungen}

Wir wollen kurz die Eignung von drei verschiedenen Layouts
f"ur den an unserer Universit"at h"aufigen Spezialfall
von technischen Beschreibungen,
Users' Guides, Reference Manuals, Mitteilungs"-bl"attern und "ahnlichen
technischen Druckwerken
vergleichen:\footnote{Diese Hinweise stammen von Paul Stiff,
der Layout-Design an der University of Reading unterrichtet.}

\begin{description}

\item[Plain \TeX]
Das Standardformat von Plain \TeX\
hat vor allem den gro"sen Nachteil,
da"s die Zeilen viel zu lang sind,
was sich schlecht auf die Lesbarkeit und "Ubersichtlichkeit auswirkt.
Dieses von Schreibmaschinenschrift gewohnte Schriftbild eignet sich
nicht f"ur die von \TeX\ unterst"utzte "`Druck"'-Schrift.
Die an der TU~Wien vor der Einf"uhrung von \LaTeX\ entwickelten
Macros {\tt EASY.TEX} und \hbox{\tt ARTii.TEX} bzw.\ \hbox{\tt REPii.TEX}
haben au"serdem einige weitere Design-M"angel, z.B.\ sind
die Abst"ande zwischen den Kapitel-"""Uberschriften zu gro"s.

\item[Standard-\LaTeX]
Auch das Standardformat von \LaTeX\ ist f"ur diese Zwecke nicht ideal.
Die Zeilenl"ange ist zwar richtig gew"ahlt, aber die Seiten enthalten
einen zu gro"sen ungen"utzten Rand, insbesondere oben und unten.
Au"serdem werden f"ur die Kapitel-"""Uberschriften etwas zu gro"se Schriften
verwendet.

\item[Reference-Manual-Style]
Ein f"ur solche Zwecke g"unstigeres Seiten-Layout findet man
bei einigen in den letzten Jahren neu erschienenen
Reference Manuals:\footnote{Ein h"aufig zitiertes
 -- allerdings in den konkreten Details auch nicht ganz ideales --
Beispiel ist das "`PostScript Reference Manual"'.}
\begin{itemize}
\item
Der fortlaufenden Text steht mit einer relativ kurzen, gut lesbaren
Zeilenl"ange im rechten Teil der Seite.
Dieser Teil dient also zum
fortlaufenden Lesen einzelner Abschnitte.
\item
Im breiten linken Rand jeder Seite stehen die "Uberschriften
sowie Stichworte und andere "`Randnoten"'.
Dieser Teil dient also
zum raschen Auffinden von bestimmten Informationen innerhalb des
gesamten Schrift"-st"ucks.
\item
Abbildungen und Tabellen stehen je nach ihrem Platzbedarf in der einen
oder anderen Spalte oder gehen "uber die gesamte Seitenbreite.
\end{itemize}
\seealso{\ref{refmanex}}
Eine Anleitung, wie man ein solches Layout mit \LaTeX\ realisieren kann, wird
in Abschnitt~\ref{refmanex} angegeben.

\end{description}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\section{Wie kann man das \LaTeX-Layout "andern?}
\label{layout}

\subsection{Vor und Nachteile des Textsatzsystems \LaTeX}

\marginlabel{Vorteile:}
Der gro"se Vorteil von \LaTeX\ besteht darin,
da"s es ein "`generisches"' oder "`logisches"' Design unterst"utzt.
Darunter versteht man, da"s der Autor nur mit einigen wenigen Befehlen
angeben mu"s, welche {\it Bedeutung\/} die einzelnen Text-Teile haben:
"Uberschriften, Zitate, mathematische Gleichungen, Listen, Aufz"ahlungen,
Literaturangaben usw.
Diese logischen Begriffe werden dann vom System automatisch in der
richtigen Art und Weise gesetzt und ausgedruckt.
Was "`richtig"' ist,
mu"s dem System vorher in geeigneter Weise mitgeteilt werden,
bei \LaTeX\ durch die Angabe des "`Document Style"' und eventuell
weiterer "`Style-Options"'.

Im Gegensatz dazu steht das von "alteren Textverarbeitungsprogrammen
und auch von Plain~\TeX\ unterst"utzte "`visuelle"' Design,
bei dem der Autor die sichtbaren Eigenschaften wie
Schriftart, Schriftgr"o"se, vertikale Abst"ande, horizontale Einr"uckungen
usw. angeben mu"s.

Das Prinzip des logischen Design macht einerseits die Anwendung durch den
Autor wesentlich einfacher und "ubersichtlicher
und stellt andererseits die logische Konsistenz des Schrift"-st"ucks
sicher (z.B.\ einheitliche Schriftart f"ur alle "Uberschriften des
gleichen Levels, einheitliche Numerierung von Kapiteln und von Gleichungen,
einheitliche Darstellung von Listen und Aufz"ahlungen, usw.).

\marginlabel{Nachteile:}
Als Nachteil von \LaTeX\ wird immer wieder angef"uhrt,
da"s es den Autor zu sehr einschr"ankt und da"s man das Layout zu wenig
"andern kann.
Dies ist nur teilweise richtig, n"amlich nur dann, wenn man sich auf die
vier mit \LaTeX\ mitgelieferten Standard-Layouts beschr"ankt,
die sich selbstverst"andlich nicht f"ur alle Anwendungen eignen
und die au"serdem sehr stark an amerikanische Konventionen angepa"st sind.

\LaTeX\ ist aber wesentlich m"achtiger und flexibler:
Man kann praktisch beliebige "Anderungen am Layout dadurch erreichen,
da"s man die in den Style-Files enthaltenen Definitionen "andert,
die ge"-"an"-derten Definitionen in privaten Style-Option-Files speichert
und diese dann als zus"atzliche Style-Options aufruft.
Der Aufwand daf"ur ist keineswegs gr"o"ser als bei der Verwendung
von Plain \TeX, in manchen F"allen sogar wesentlich geringer.

\subsection{Eingabe-Files und Style-Files}

In Einklang mit dem Prinzip des logischen Design und der Trennung von
Inhalt und Form verwendet \LaTeX\ grund"-s"atz"-lich zwei Arten von
Files:
\begin{itemize}
\item
Der Inhalt einschlie"slich der logischen Struktur des Schrift"-st"ucks
wird in den \LaTeX-""Eingabefiles festgelegt.
\item
Die Form (das Layout) wird in sogenannten Style-Files und eventuell
auch Style-Option-Files festgelegt.
\end{itemize}
Welche Style- und Style-Option-Files ein Schrift"-st"uck verwendet
-- d.h.\ in welchem Layout es gesetzt werden soll --
wird am Beginn des Eingabefiles mit dem Befehl \verb|\documentstyle| angegeben.

F"ur die Erzeugung eines Schriftst"ucks mit \LaTeX\ sind also zumindest
zwei Files notwendig: ein Eingabefile und ein Style-File.

Diese Trennung entspricht den in der Einleitung erl"auterten
unterschiedlichen Funktionen von Autor und Layout-Designer.
Sie hat aber auch f"ur den Fall, da"s der Autor selbst das Layout festlegt,
wesentliche  Vorteile:
\begin{itemize}
\item
Einerseits wird damit sichergestellt, da"s zusammengeh"orige Schrift"-st"ucke
automatisch im selben Layout gesetzt werden, auch wenn dieses Layout
nach dem Erstellen des Textes noch ge"-"an"-dert wurde.
Dies w"are nur schwer zu erreichen,
wenn die Layout-""Definitionen direkt in jedem einzelnen Eingabefile
enthalten w"aren.
\item
Andererseits ist es auf diese Weise ohne gro"sen Aufwand m"oglich,
denselben Inhalt in verschiedenen Layouts auszudrucken,
z.B.\ als Artikel f"ur die eine oder andere wissenschaftliche Zeitschrift
oder als Kapitel einer Dissertation und eines Forschungsberichts.
\end{itemize}

\subsection{Style-Files und Style-Option-Files}

\LaTeX\ unterst"utzt innerhalb der Layout-Definition die folgende
Hierarchie von "`Style"' und "`Option"', die sich in den verschiedenen
Parametern des Befehls \verb|\documentstyle| widerspiegelt:
\begin{itemize}
\item
Als erstes wird der Inhalt desjenigen "`Style-Files"' verarbeitet, dessen Name
im \verb|\documentstyle|-Befehl zwischen den geschwungenen Klammern
angegeben wurde.
Dies gibt die grunds"atzliche Art des Schriftst"ucks an.
\item
Dann werden der Reihe nach diejenigen "`Style-Option-Files"' verarbeitet,
deren Namen zwischen den eckigen Klammern angegeben wurden.
Damit kann man verschiedene Layout-Varianten ausw"ahlen.
\end{itemize}
Diese mehrstufige Verarbeitung macht es m"oglich,
die Layout-""Definition in mehrere kleinere Einheiten zu zerlegen,
wobei in einem Style-Option-File
sowohl Layout-Definitionen der urspr"unglichen Style-Files abge"-"andert
als auch weitere Definitionen hinzuge"-f"ugt werden k"onnen.

Style-Files und Style-Option-Files unterscheiden sich von "`normalen"'
Eingabefiles im wesentlichen durch die folgenden Punkte:
\begin{itemize}
\item
Sie d"urfen nur Definitionen enthalten,
aber keine Text-Ausgaben bewirken.
\item
Das Sonderzeichen "`Klammeraffe"' ({\tt @})
hat in ihnen die Bedeutung eines Buchstabens
("`letter"'), d.h.\ es ist innerhalb von Befehlsnamen erlaubt.
Die meisten von \LaTeX\ intern verwendeten Befehle enthalten Klammeraffen
in ihren Namen, damit Kollisionen mit den vom Benutzer verwendeten Befehlen
ausgeschlossen werden.
\item
Die Filenamen haben die "`Extension"' {\tt STY} (nicht {\tt TEX}).
\end{itemize}

\subsection{Vorgangsweise bei Layout-"Anderungen}

\subsubsection{Festlegen der "Anderungen gegen"uber dem Original-Layout}

Im allgemeinen ist es g"unstiger, die Style-Files f"ur das neue Layout
nicht von Null an neu zu erstellen,
sondern die bereits bestehenden \LaTeX-Style-Files als Vorbilder zu
verwenden und so viel wie m"oglich von den darin enthaltenen Definitionen
zu "ubernehmen.

In den meisten F"allen gen"ugt es sogar,
ein mehr oder weniger kurzes Style-Option-File zu erstellen,
das nur die Unterschiede des neuen Layouts gegen"uber einem der
originalen \LaTeX-Layouts enth"alt,
und diese "`Option"' dann
in Verbindung mit dem originalen "`Style"' zu verwenden.

Im ersten Schritt legt man daher fest,
in welchen Bereichen sich das neue Layout vom originalen \LaTeX-Layout
unterscheidet und worin diese Unterschiede im einzelnen bestehen.
Man geht dabei am besten so vor, da"s man sich f"ur alle
als \LaTeX-Befehle oder -Environments definierten
logischen Einheiten "uberlegt,
in welchem Layout sie gesetzt werden sollen.
Neue zus"atzliche \LaTeX-Befehle sollte man nach M"oglichket {\em nicht\/}
erfinden -- und wenn, dann nur im Einklang mit dem Prinzip des logischen
Design und mit der Struktur der anderen \LaTeX-Befehle
(z.B.\ neue Environments f"ur spezielle Tabellen, oder eigene Befehle f"ur
spezielle Hervorhebungen).

\subsubsection{Finden der Original-Definitionen}

Im zweiten Schritt mu"s man finden, wo und wie alle die
Layout-""Eigenschaften, die man "andern will, im Original definiert sind.
Dazu soll man die folgenden Quellen in der folgenden Reihenfolge
durchsuchen:\footnote{Diese Hinweise stammen von Sue Brooks,
   die im Rahmen der \TeX-""Konferenz 1988 in Exeter
   ein Work"-shop f"ur "`\LaTeX-Hacker"' leitete.}
\begin{enumerate}
\item das \LaTeX-Manual von Leslie Lamport,
\item die Style-Files {\tt ARTICLE.DOC}, {\tt ART10.DOC} etc.
oder {\tt ARTICLE.STY} etc.,
\item das File {\tt LATEX.TEX},
\item das \TeX book von Donald E.~Knuth.
\end{enumerate}
Die beiden B"ucher sind im Buchhandel erh"altlich (Verlag Addison Wesley).
Ob und wo die Files an Ihrem Computer angelegt sind,
ist im "`\LaTeX\ Local Guide"' Ihrer Installation angegeben.
Die Files sind sehr gut kommentiert,
soda"s man sich im allgemeinen auch dann gut in ihnen zurechtfindet,
wenn man nicht alle Details der darin enthaltenen Befehle versteht.

\subsubsection{Schreiben eines neuen Style-Option-Files}

Im dritten Schritt erzeugt man das neue Style-Option-File.
Man w"ahlt einen Namen f"ur die neue Option (z.B.~{\tt refman})
und bildet den Filenamen aus diesem Namen und der Extension {\tt STY}
(z.B.\ {\tt REFMAN.STY}).

Dieses File mu"s nur diejenigen Definitionen (\verb|\def|-Befehle,
Wertzuweisungen und dergleichen) enthalten,
die sich gegen"uber der Originalversion unterscheiden,
und/oder diejenigen, die man zus"atzlich definieren will.

Bei den "Anderungen geht man am besten so vor,
da"s man die betreffenden \verb|\def|-Befehle, Wertzuweisungen usw.\
aus den originalen Files in das neue File kopiert und dann dort
entsprechend modifizert.

Auch bei neuen Definitionen lehnt man sich am besten an Vorbilder
in den originalen Files an.

Au"serdem mu"s man den Zweck des Files, seine Verwendung, den Autor
und das letzte "Anderungsdatum sowie alle im File enthaltenen Definitionen
auf Kommentarzeilen innerhalb des Files dokumentieren.
Bei sehr umfangreichen Style-Files kann man dazu zwei Versionen des Files
anlegen:
eines mit der Extension {\tt DOC}, das die komplette Information enth"alt
und das von Menschen gelesen werden soll,
und eines mit der Extension {\tt STY}, das au"ser Zweck, Autor und Datum
keine Kommentare enth"alt und das vom \TeX-""Programm gelesen wird.
In den meisten F"allen gen"ugt es aber,
nur ein {\tt STY}-File mit allen Kommentaren anzulegen.

\subsubsection{Verwendung der neuen Style-Option}

Durch die Angabe des neuen Option-Namens zwischen den eckigen Klammern
im Befehl \verb|\documentstyle|
-- eventuell als letzte Option --
werden die "Anderungen f"ur das betreffende Schrift"-st"uck wirksam,
d.h.~dieses wird im neuen Layout gesetzt.
Beispiel:
\begin{verse}
\verb|\documentstyle[11pt,twoside,german,refman]{article}|
\end{verse}
Davon abgesehen sollten keine "Anderungen im Eingabefile notwendig sein
-- es sei denn,
das Schrift"-st"uck ent"-h"alt spezielle logische Text-""Elemente,
die im neuen Layout vorgesehen sind, aber in Original-\LaTeX\ nicht
unter"-st"utzt werden.

Wenn man das Eingabefile an einen anderen Computer "ubertragen will,
mu"s man das darin verwendete Style-Option-File mit"-"ubertragen,
damit es auch dort verarbeitet werden kann.

%%%%%%     %%%%%%%%%%      %%%%%%%%%%        %%%%%%%%%%        %%%%%%%%%

\subsection{Ein einfaches Beispiel (Gleichungsnummern)}

Angenommen, Sie wollen,
da"s in einem "`Article"' die Gleichungen innerhalb jeder
"`Section"' separat numeriert werden.

Im \LaTeX-Manual finden Sie den Hinweis, da"s der "`Report"'-Style etwas
"Ahnliches pro "`Chapter"' macht.

Sie schauen das File {\tt REPORT.DOC} an und finden darin die folgenden
zwei Befehle, die sich -- wie in den Kommentarzeilen angegeben ist --
auf die Gleichungsnummern beziehen:\nopagebreak
\begin{verse}
\verb|\@addtoreset{equation}{chapter}|       \\*
\verb|\def\theequation{\thechapter .\arabic{equation}}|
\end{verse}
Es ist nicht notwendig, da"s sie diese beiden Befehle in allen Details
verstehen, es gen"ugt, wenn Sie erkennen, da"s sich {\tt chapter}
in beiden F"allen auf die Numerierung pro Kapitel bezieht.

Sie legen ein File mit dem Namen {\tt EQPERSEC.STY} an,\footnote
       {Je nach dem Computer, an dem Sie arbeiten, kann der Filname
        eine andere Syntax haben,
        z.B.\ {\tt EQPERSEC\_STY} an einer CYBER unter NOS/VE.}
kopieren die Befehle in dieses File,
ersetzen darin konsequent {\tt chapter} durch {\tt section}
und erhalten also die neuen Definitionen\nopagebreak
\begin{verse}
\verb|\@addtoreset{equation}{section}|        \\*
\verb|\def\theequation{\thesection .\arabic{equation}}|
\end{verse}
Nat"urlich f"ugen Sie auch noch Kommentarzeilen hinzu,
die den Zweck des Files erkl"aren
und Ihren Namen als den Autor dieses neuen Style-Option-Files sowie
das "Anderungsdatum angeben.

Wann immer Sie nun
in Ihrem \LaTeX-""Eingabefile die Style-Option {\tt eqpersec} angeben,
z.B.~mit\nopagebreak
\begin{verse}
\verb|\documentstyle[11pt,eqpersec]{article}|
\end{verse}
dann werden die Gleichungen in Ihrem Artikel
nach dieser neuen Konvention numeriert.


%%%%%%%%%% %%%%%%%%%%%%%% %%%%%%%%%%%% %%%%%%%%%%%% %%%%%%%% %%%%%%%%%%%%

\subsection{Ein etwas komlexeres Beispiel (Reference Manual)}
\label{refmanex}

Wir wollen ein "ahnliches Seiten-Layout wie beim PostScript Reference Manual
erreichen:
mit einem breiten linken Rand, der f"ur "Uberschriften und
Randnoten ben"utzt wird,
und mit nur einem eher knappen freien Rand oben, rechts und unten.

Dies scheint eine sehr grundlegene "Anderung zu sein.
Durch die gute Modularit"at von \LaTeX\ sind aber auch f"ur eine solche
Aufgabe nur relativ wenige "Anderungen notwendig, die im folgenden
komplett beschrieben werden.


\subsubsection{Seitenaufteilung}

Die neue Seitenaufteilung wird im wesentlichen mit den im \LaTeX-Manual
beschriebenen Parametern festgelegt.
In diesem Beispiel verwenden wir dazu die Plain-\TeX-Befehle
\verb|\newdimen|,
Wertzuweisung und
\verb|\advance|,
wir k"onnten aber genausogut auch die entsprechenden \LaTeX-Befehle
\verb|\newlength|,
\verb|\setlength| und
\verb|\addtolength| verwenden.

\pagebreak[2]

\marginlabel{Horizontal:}
Zun"achst definieren wir zwei neue Bezeichungen f"ur Gr"o"sen,
die im folgenden "ofter verwendet werden:

\verb|\fullwidth| gibt die komplette Breite (Textbreite + gen"utzter
linker Rand) an und erh"alt denselben
Wert wie in Plain~\TeX, n"amlich 6.5~Inch, soda"s am Papier rechts und links
noch jeweils 1~Inch freier Rand bleiben.

\verb|\leftmarginwidth| gibt die Breite des Randes an, der
links von der normalen Textbreite f"ur "Uberschriften und Randnoten
verwendet wird:
\begin{displaymath}
\mbox{\tt leftmarginwidth} = \mbox{\tt fullwidth} - \mbox{\tt textwidth}
\end{displaymath}

Die Zeilenl"ange des normalen Textes ist in \LaTeX\ bereits
mit \verb|\textwidth| definiert.
Diese Breite und alle davon abgeleiteten Gr"o"sen bleiben unver"andert
wie im Original.
Der Wert von \verb|\textwidth|
variiert in Abh"angigkeit von der Font"-gr"o"se und liegt
zwischen 5 und 5.5~Inch,
soda"s sich f"ur \verb|\leftmarginwidth|
ein Wert zwischen 1 und 1.5~Inch ergibt.

F"ur diese Festlegungen dienen die folgenden Befehle:\nopagebreak
\begin{verbatim}
\newdimen\leftmarginwidth
\newdimen\fullwidth
\fullwidth=6.5in
\leftmarginwidth=\fullwidth
   \advance\leftmarginwidth by -\textwidth
\end{verbatim}

Die beiden Gr"o"sen, die die Breite des linken Randes f"ur gerade und
ungerade Seiten angeben, werden auf \verb|\leftmarginwidth| gesetzt,
und die Breite der Randnoten auf diese Randbreite vermindert um den
Abstand \verb|\marginparsep|:\nopagebreak
\begin{verbatim}
\oddsidemargin=\leftmarginwidth
\evensidemargin=\leftmarginwidth
\marginparwidth=\leftmarginwidth
   \advance\marginparwidth by -\marginparsep
\end{verbatim}

\marginlabel{Vertikal:}
Um auch oben und unten nur einen freien Rand von etwa 1~Inch zu erhalten,
verkleinern wir den oberen Rand (\verb|\topmargin|) um 5~Zeilen
und vergr"o"sern den Textbereich (\verb|\textheigt|) um 10~Zeilen.
Dadurch verkleinert sich der untere Rand ebenfalls um 5~Zeilen.
Dabei befolgen wir die Regel, da"s \verb|\textheight|
gegen"-"uber dem Original immer nur um Vielfache von \verb|\baselineskip|
ver"-"andert werden darf.\nopagebreak
\begin{verbatim}
\advance\topmargin by -5\baselineskip
\advance\textheight by 10\baselineskip
\end{verbatim}


\vspace{0pt plus 1cm}

\subsubsection{Kapitel-"Uberschriften}

Die "Uberschriften von Sections, Sub- und Subsubsections
sollen so abge"-"an"-dert werden, da"s sie in den linken Rand
hinausragen.

Im File {\tt ART10.DOC} finden wir, da"s diese "Uberschriften
durch Aufrufe des Befehls \verb|\@startsection| definiert sind,
dessen Funktion auf den Kommentarzeilen beschrieben ist.
F"ur uns relevant sind nur folgende Parameter:
Der Absolutbetrag des vierten und des f"unften Parameters gibt
den Abstand vor bzw.\ nach der "Uberschrift an.
Der sechste Parameter gibt an, wie der Text der "Uberschrift gesetzt
werden soll.
Der Befehl f"ur Sections ist z.B.\ im Original so definiert:\nopagebreak
\begin{verbatim}
\def\section{\@startsection
             {section}{1}{\z@}%
             {-3.5ex plus -1ex minus -.2ex}%
             {2.3ex plus .2ex}%
             {\Large\bf}}
\end{verbatim}
und analog die Befehle f"ur Sub- und Subsubsections.
Die Angabe der Abst"ande ist in {\tt ART10}, {\tt ART11} und {\tt ART12}
jeweils identisch,
die Anpassung an die jeweilige Schrift"-gr"o"se erfolgt automatisch durch
die Verwendung der relativen Einheit {\tt ex}.

Wir definieren zun"achst eine Abk"urzung \verb|\secshape|
f"ur das neue Layout aller dieser "Uberschriften.
Die wesentliche "Anderung besteht darin, da"s die "Uberschriften
um die Breite des linken Randes weiter links als der normale
Text beginnen sollen.
Zu diesem Zweck setzen wir den linken Rand auf die entsprechende negative
Gr"o"se.
Au"serdem wollen wir, da"s die W"orter in der "Uberschrift
nicht abgeteilt werden und da"s deshalb rechts kein Randausgleich
gemacht wird.
Dies erreichen wir mit den folgenden Befehlen, die
im \TeX book beschrieben sind:\nopagebreak
\begin{verbatim}
\def\secshape{\leftskip=-\leftmarginwidth
              \rightskip=0pt plus 1fil
              \hyphenpenalty=2000}
\end{verbatim}
Ein Aufruf dieses Befehls soll nun jeweils in den sechsten
Parameter von \verb|\@startsection| eingef"ugt werden.

Da die "Uberschriften durch das Hinausragen in den linken Rand
deutlich genug vom normalen Text abgesetzt sind,
m"ussen sie nicht durch so gro"se Schrift und Abst"ande wie im Original
hervorgehoben werden.
Wir verkleinern daher auch noch die entsprechenden Angaben
im vierten, f"unften und sechsten Parameter
und erhalten schlie"slich die neue Definition\nopagebreak
\begin{verbatim}
\def\section{\@startsection
             {section}{1}{\z@}%
             {-2ex plus -1ex minus -.2ex}%
             {0.5ex plus .2ex}%
             {\secshape\large\bf}}
\end{verbatim}
und analoge neue Definitionen f"ur Sub- und Subsubsections.

\vspace{0pt plus 1cm}

\subsubsection{Positionierung der Randnoten}

Die Positionierung der Randnoten mu"s so abge"andet werden,
da"s {\em alle\/} Randnoten in den linken Rand gesetzt werden
-- unabh"angig davon, ob es sich um eine rechte oder linke Seite
und um eine normale oder verkehrte Randnote
handelt.

Im File {\tt LATEX.TEX} finden wir die viele Zeilen lange Definition
des Befehls \verb|\@addmarginpar|, der das Setzen der
Randnoten durchf"uhrt.
Wir brauchen uns nicht um alle Details dieses komplizierten Befehls
zu k"ummern, wir m"ussen nur eines herausfinden:
Im ersten Teil des Befehls wird eine interne Gr"o"se \verb|\@tempcnta|
entweder auf \verb|\@ne| oder auf \verb|\m@ne| gesetzt,
je nachdem, ob die Randnote rechts oder links vom Text
gesetzt werden soll.
Dazu dienen die folgenden Zeilen:\nopagebreak
\begin{verbatim}
    \@tempcnta\@ne
    \if@twocolumn
        \if@firstcolumn \@tempcnta\m@ne \fi
    \else
      \if@mparswitch
         \ifodd\c@page \else\@tempcnta\m@ne \fi
      \fi
      \if@reversemargin \@tempcnta -\@tempcnta \fi
    \fi
\end{verbatim}

Diese Zeilen ersetzen wir also einfach durch die Zuweisung
\begin{verbatim}
    \@tempcnta\m@ne
\end{verbatim}

Die restlichen Zeilen,
die das eigentliche Setzen der Randnote je nach dem Wert
von \verb|\@tempcnta| an die richtige Stelle der Seite bewirken,
lassen wir unver"andert.

\subsubsection{Erweiterungen}

Die hier angef"uhrten Definitionen gen"ugen durchaus f"ur einfache
Anwendungen.
In der Praxis k"onnen allerdings noch einige
Erweiterungen n"utzlich sein.
\seealso{\ref{refman}}
Ein Beispiel f"ur eine solche "`komplette"' Style-Option
ist in Anhang~\ref{refman} beschrieben.


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\input layout2

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\end{document}
