%% NB: Dieses Dokument baut so 3-10 Minuten je nach Dateisystem-Performance…
%%     (Sehr viele Beispiele die jeweils komplette eigenständige Dokumente sind.)
\documentclass[ngerman,10pt]{scrreprt}
\KOMAoptions{BCOR=1cm,DIV=10,open=any}
\usepackage{calc,tikz,minted,fontspec,luacode,babel,csquotes,hyperref}
\hypersetup{colorlinks,urlcolor={magenta!75!black},linkcolor={green!50!black}}
\linespread{1.05}
% font definition (same as cccbform.cls)
%% FIXME: RawFeature +case x microtype fixes
%% see https://github.com/schlcht/microtype/issues/33 for fix notes
%% see https://fontdrop.info/?darkmode=true for character lookup
\setmainfont[
	Renderer=HarfBuzz,
	ItalicFont=Recursive,
	BoldFont=Recursive,
	BoldItalicFont=Recursive,
	UprightFeatures={
		RawFeature={+ss01,+ss02,+ss08},
		RawFeature={+axis={MONO=0.0,CASL=0.2,slnt=0,CRSV=0,wght=400}}
	},
	BoldFeatures={RawFeature={+axis={MONO=0.0,CASL=0.2,slnt=0,CRSV=0,wght=700}}},
	BoldItalicFeatures={RawFeature={+axis={MONO=0.0,CASL=0.2,slnt=-15,CRSV=1,wght=700}}},
	ItalicFeatures={RawFeature={+axis={MONO=0.0,CASL=0.2,slnt=-15,CRSV=1,wght=400}}}
	]{Recursive}
\setmonofont[
	Renderer=HarfBuzz,
	ItalicFont=Recursive,
	BoldFont=Recursive,
	BoldItalicFont=Recursive,
	UprightFeatures={
		RawFeature={+ss01,+ss02,+ss08},
		RawFeature={+axis={MONO=1.0,CASL=0.2,slnt=0,CRSV=0,wght=400}}
	},
	BoldFeatures={RawFeature={+axis={MONO=1.0,CASL=0.2,slnt=0,CRSV=0,wght=700}}},
	BoldItalicFeatures={RawFeature={+axis={MONO=1.0,CASL=0.2,slnt=-15,CRSV=1,wght=700}}},
	ItalicFeatures={RawFeature={+axis={MONO=1.0,CASL=0.2,slnt=-15,CRSV=1,wght=400}}}
	]{Recursive}
\renewfontfamily\titlefont[
	Renderer=HarfBuzz,
	ItalicFont=Recursive,
	BoldFont=Recursive,
	BoldItalicFont=Recursive,
	UprightFeatures={
		RawFeature={+ss01,+ss02,+ss08},
		RawFeature={+axis={MONO=0.0,CASL=0.4,slnt=0,CRSV=1,wght=500}}
	},
	BoldFeatures={RawFeature={+axis={MONO=0.0,CASL=0.4,slnt=0,CRSV=1,wght=800}}},
	BoldItalicFeatures={RawFeature={+axis={MONO=0.0,CASL=0.4,slnt=-15,CRSV=1,wght=800}}},
	ItalicFeatures={RawFeature={+axis={MONO=0.0,CASL=0.4,slnt=-15,CRSV=1,wght=500}}}
	]{Recursive}
\usepackage{microtype}

% set up example build directory
\directlua{ os.execute "mkdir -p cccbform-examples" }
\directlua{ os.execute "cp cccbform.cls cccbform-examples/" }
\directlua{ os.execute "cp logo.pdf cccbform-examples/" }
% stuff to add before/after examples to form a full document
\begin{luacode*}
HEADER1 = [[
\documentclass[shortexample]{cccbform}
]]
HEADER2 = [[
\begin{document}
]]
FOOTER = [[
\end{document}
]]
\end{luacode*}

\begin{luacode*}
	function makeVerb( envname )
		local buf
		local function bufread( chunk )
			if chunk:find( "\\end{"..envname.."}" ) then  return nil  end
			buf[#buf+1] = chunk
			return ""
		end
		local function luaverbstart( )
			buf = { }
			luatexbase.add_to_callback( "process_input_buffer", bufread, "bufread" )
		end
		local function luaverbend( )
			luatexbase.remove_from_callback( "process_input_buffer", "bufread" )
			buf[#buf+1] = ""
			buf = table.concat( buf, "\n" )
			return buf
		end
		return luaverbstart, luaverbend
	end
\end{luacode*}

\begin{luacode*}
	function CMD(name)  return "\\"..name  end
	LF = "\n"

	function EndExample( EndFun, x1, x2 )
		CONTENT = EndFun( )
		if x1 ~= "" then
			EXTRALINES, EXTRASTUFF = 1, "\\geometry{paperheight="..x1.."}\n"
		else
			EXTRALINES, EXTRASTUFF = 0, ""
		end
		local f = io.open( "cccbform-examples/"..x2..".tex", "w" )
		f:write( HEADER1, EXTRASTUFF, HEADER2, CONTENT, FOOTER )
		f:close( )
		os.execute( "cd cccbform-examples ; latexmk -pdflua "..x2..".tex" )
		local n, f = 0, io.open( "cccbform-examples/"..x2..".tex" )
		for l in f:lines( ) do  n = n + 1  end
		tex.print( "\\def\\lc{"..(n - 1).."}" )
		tex.print( "\\def\\ls{"..(3 + EXTRALINES).."}" )
	end
\end{luacode*}

\directlua{ ShortExampleStart, ShortExampleEnd = makeVerb "ShortExample" }

\NewDocumentEnvironment{ShortExample}{O{} m m}{
	\addvspace{1em}
	\directlua{ShortExampleStart()}
}{
	\directlua{ EndExample( ShortExampleEnd, "#1", "#2" ) }
	\par\noindent
	\null\hspace*{-2cm}
	\rlap{
		\begin{minipage}[t]{\textwidth + 4cm}
			\noindent
			\begin{tikzpicture}
				\node[anchor=north east] (code) at (-0.5ex,0) {
					\begin{minipage}[t]{0.5\textwidth - 3ex}
						\vspace{-2ex}
						\inputminted[firstline=\ls,lastline=\lc]{tex}{cccbform-examples/#2.tex}
					\end{minipage}
				};
				\node[anchor=north west, draw=black!50] (output) at (0.5ex,0) {
					\begin{minipage}[t]{0.5\textwidth - 2ex}
						\includegraphics[width=\linewidth]{cccbform-examples/#2.pdf}
					\end{minipage}
				};
			\end{tikzpicture}
			\par
			\vspace{-2ex}
			{\null\hfill\bfseries #3 \hfill\null}
		\end{minipage}
	}
	\par
	\addvspace{4ex}
}

\NewDocumentEnvironment{StandaloneExample}{m}{
	\VerbatimEnvironment%
	\begin{VerbatimOut}{cccbform-examples/#1.tex}}%
	{\end{VerbatimOut}%
	\directlua{ os.execute "cd cccbform-examples ; latexmk -pdflua #1.tex" }
	\directlua{
		local n, f = 0, io.open( "cccbform-examples/#1.tex" )
		for l in f:lines( ) do  n = n + 1  end
		tex.print( CMD"def"..CMD"lc".."{" .. (n-1) .. "}" )
	}
	\begin{tikzpicture}
		\node[anchor=north west, inner sep=1ex, draw] (code) {
			\begin{minipage}[t]{0.45\textwidth}
				\inputminted[firstline=3,lastline=\lc]{tex}{cccbform-examples/#1.tex}
			\end{minipage}
		};
		\node[anchor=north west, right=2mm of code, draw] (output) {
			\begin{minipage}[t]{0.45\textwidth}
				\includegraphics[width=\linewidth]{cccbform-examples/#1.pdf}
			\end{minipage}
		};
	\end{tikzpicture}
}

\setminted{autogobble,bgcolor=black!10,frame=lines,framesep=1ex,tabsize=4,fontsize=\small}
\setmintedinline{frame=none,framesep=0pt,fontsize=\small}
\newmintinline[texcode]{tex}{}

\sloppy
\raggedbottom

\MakeOuterQuote{"}
\title{\texttt{cccbform} – Formulare für den CCCB}
\author{Frank Nord}
\begin{document}
\maketitle
\tableofcontents

\chapter{TODO}

\begin{itemize}
\item Inline-Textfeld
\item Grundsätze des aktuellen Designs
\item Bug: Höhe Multiline-Textfeld in example
\item \TeX-Intro zum Ende, +build info
\end{itemize}

\chapter{Übersicht}

Die Grundstruktur für Formulare ist folgende:

\begin{center}
	\begin{minipage}{0.5\textwidth}
		\begin{minted}{tex}
			\documentclass{cccbform}
			\begin{document}
			% Inhalt hier
			\end{document}
		\end{minted}
	\end{minipage}
\end{center}

\texttt{cccbform} kümmert sich um die Details und definiert Hilfsbefehle zur
rein semantischen Erstellung von PDF-Formularen.  Mit einer Reihe
von Befehlen kann dann recht bequem ein Formular definiert werden.
Dieses Dokument gibt eine Übersicht über alles, was hilfreich sein könnte.
Allein schon existierende Formulare anzusehen oder zu kopieren und anzupassen
sollte jedoch für die meisten Zwecke ausreichen.

\subsection{Für \TeX-Neulinge}

Das meiste sollte auch ohne \TeX-Kenntnisse gehen, es gibt jedoch eine Reihe
von Sonderzeichen, die besondere Bedeutung haben.  Als eines der wichtigeren
beginnt \texcode|%| einen Zeilenkommentar.  Bei den meisten Symbolen
reicht es, einen Backslash (\texttt{\textbackslash}) davorzusetzen, aber der
Backslash selbst wird z.~B. durch \texcode{\textbackslash} und nicht
\texcode{\\} erzeugt.  Bei Unsicherheit hilft auch
\url{http://detexify.kirelabs.org/classify.html}.  (Dort kann man
Symbole malen und bekommt eine Liste möglicher Übereinstimmungen und wie man
diese jeweils erzeugt. Das Symbol sollte generell ohne
\texttt{\textbackslash usepackage} auskommen und im \texttt{textmode}
funktionieren -- diese Infos stehen ggf.  über/unter dem Zeichen.)

Zu Leerzeichen und Zeilenumbrüchen noch folgendes: Einfache Zeilenumbrüche
werden von \TeX{} generell ignoriert bzw. wie ein Leerzeichen zwischen Worten
behandelt.  Eine leere Zeile (also (mindestens) zwei aufeinanderfolgende
Zeilenumbrüche) beginnt einen neuen Absatz. (Das geht auch mit
\mintinline{tex}{\par}.)  \mintinline{tex}{\\} ist ein "einfacher"
Zeilenumbruch in der Ausgabe (ohne den Absatz zu beenden), der hier aber
möglichst vermieden werden sollte.  Ein oder mehrere Leerzeichen werden wie ein
einzelnes Leerzeichen gelesen, erlauben aber generell Zeilenumbrüche wenn die
Zeile voll ist.  \mintinline{tex}{~} erzeugt geschützte Leerzeichen, die nicht
umbrechen dürfen (und z.~B. bei Abkürzungen (\mintinline{tex}{z.~B.}) oder
Zahlen mit Einheiten verwendet werden sollten.)  Nach Befehlen
(\mintinline{tex}{\foo}) werden (beliebig viele) Leerzeichen generell als
Token-Trenner ignoriert und entfernt (\mintinline{tex}{\TeX test} = \TeX test),
ein Verdoppeln des Leerzeichen bringt ebenfalls nichts.  Stattdessen kann man
entweder leere Argumente angeben (\mintinline{tex}{\TeX{} test} = \TeX{} test)
oder das Leerzeichen ebenfalls mit einem Backslash schützen
(\mintinline{tex}{\TeX\ test} = \TeX\ test.)

\section{Klassen-Optionen}

PDF-Formulare haben eine ganze Reihe von Problemen.  Das wichtigste ist, dass
viele Viewer PDF-Formulare nicht mitdrucken.  Die Elemente wie sie hier erzeugt
werden sind also in Wirklichkeit ein Bild, was wie ein Formularfeld aussieht und
dann ein "echtes" Feld direkt darüber platziert. \emph{Manche} Viewer hingegen
drucken die Elemente mit, was dann wiederum anders komisch aussehen kann\dots

\subsection{\texttt{noform}}

Wird das Dokument also stattdessen mit
\mintinline{tex}|\documentclass[noform]{cccbform}| begonnen, werden keine
PDF-Formular-Felder erzeugt sondern nur die "falschen" als Bilder erzeugt. Das
stellt sicher, dass reine Druckvorlagen (die eh nicht ausgefüllt werden sollen)
mit allen Viewern fehlerfrei gedruckt werden können.

\chapter{Befehle}

Bereitgestellte Befehle fallen grob in 4 Kategorien -- Titel, Inhalt, Struktur, Hervorhebung.

\section{Titel}

Aktuell gibt es zwei Arten von Titeln.  In jedem Fall sollte genau einer und
unmittelbar in der Zeile hinter dem \texcode{\begin{document}} verwendet
werden.

Bei langen Titeln ist ein manueller Zeilenumbruch (\texcode{\\}) im Titel ggf.
sinnvoll, da der Text sonst über das Logo bis zum Seitenrand laufen kann.  (Das
Logo und ggf. die Adresse werden nachträglich platziert, \TeX\ "sieht" diese
also nicht beim verarbeiten des restlichen Inhalts.)

\subsection{\texcode{\LogoTitle{Titel}}}

\begin{ShortExample}[4.953cm]{logotitle}{Die einfache Variante -- Titel links, Logo rechts.}
\LogoTitle{Beispieltitel}
\Text{(...und hier geht's weiter.)}
\end{ShortExample}

\subsection{\texcode{\AddressTitle{Titel}}}

\begin{ShortExample}[8.865cm]{addresstitle}{Titel und Adresse}
\AddressTitle{Beispieltitel}
\Text{(...und hier geht's weiter.)}
\end{ShortExample}

Es gibt auch die Variante mit \texttt{*}, welche zusätzlich das Logo einbettet.

\begin{ShortExample}[8.865cm]{addresstitlestar}{Titel, Adresse und Logo}
\AddressTitle*{Beispieltitel}
\Text{(...und hier geht's weiter.)}
\end{ShortExample}

\section{Inhalt}

Hier gibt es größtenteils Befehle für Formularfelder. Anders als in normalen
\TeX-Dokumenten ist es hier jedoch wichtig, für korrekte Abstände \emph{allen}
"losen" Text explizit als \texcode{\Text} auszuzeichnen.  Der Befehl kümmert
sich um korrekte Abstände, ohne diesen liegen Dinge zu eng beieinander.
Vergleiche:

\begin{ShortExample}{textgood}{Text mit korrekten Abständen}
\Text{Dieser Satz kein Verb.}
\TextField{Lachhubel}
\Text{Die blöden Ösen!}
\end{ShortExample}

\begin{ShortExample}{textbad}{lose Worte -- nicht gut!}
Dieser Satz kein Verb.
\TextField{Lachhubel}
Die blöden Ösen!
\end{ShortExample}

Auch lange Texte mit mehreren Absätzen können in \texcode{\Text} verwendet
werden.

\begin{ShortExample}{textlong}{langer Text ist kein Problem}
\Text{
	Lorem ipsum dolor sit amet,
	consectetuer adipiscing elit.
	Aenean commodo ligula eget dolor.
}
\TextField{Aenean massa.}
\Text{
	Cum sociis natoque penatibus et
	magnis dis parturient montes,
	nascetur ridiculus mus.

	Donec quam felis, ultricies nec,
	pellentesque eu, pretium quis, sem.
	Nulla consequat massa quis enim.
}
\end{ShortExample}

\subsection{Textfelder}

Die vermutlich wichtigste Komponente, entsprechend viele Varianten gibt es.

\paragraph{\texcode{\TextField}} Im Zweifel ist die einfachste Variante die
richtige.  Ein einzeiliges Freitextfeld mit Label und einer für die meisten
Zwecke angemessenen Breite (welche auch z.~B. in mehrspaltigen Bereichen von
allein angepasst wird).

\begin{ShortExample}{textfield}{normales Textfeld}
\TextField{Bezeichnung}
\end{ShortExample}

Wird die volle Breite benötigt gibt es auch die Variante mit Stern:

\begin{ShortExample}{textfieldstar}{maximale Breite}
\TextField*{Bezeichnung}
\end{ShortExample}

\paragraph{\texcode{\ShortTextField}} Wirkt die Breite hingegen zu hoch (z.~B.
für eine einzelne Zahl), so gibt es auch ein explizit kurzes Textfeld.

\begin{ShortExample}{shorttextfield}{kurzes Textfeld}
\ShortTextField{Stromverbrauch (TWh)}
\end{ShortExample}

Optional kann die Länge auch explizit als Faktor relativ zur Textbreite
angegeben werden.  Das Formular sieht aber einheitlicher aus, wenn das
\emph{nicht} gemacht wird, also bitte zweimal überlegen, ob es das
\emph{wirklich} braucht.

\begin{ShortExample}{shorttextfieldopt}{besonders kurzes Textfeld}
\ShortTextField[0.15]{Verbrauch (TWh)}
\end{ShortExample}

\paragraph{\texcode{\MultilineTextField}} Für mehr Text gibt es auch
mehrzeilige Textfelder.  Auch wenn die Höhe technisch gesehen optional ist,
sollte sie immer angegeben werden -- ansonsten hat das Feld die Standard-Höhe
von normalen Textfeldern.

\begin{ShortExample}{multilinetextfield}{mehrzeiliges Textfeld}
%%% FIXME bug in preview (works in doc)
\Text{}
\MultilineTextField[2cm]{Kringel}
\Text{}
\end{ShortExample}

\begin{ShortExample}{multilinetextfieldbad}{einzeiliges mehrzeiliges Textfeld}
%%% FIXME bug in preview (works in doc)
\Text{}
\MultilineTextField{Kringel}
\Text{}
\end{ShortExample}

Auch hier gibt es wieder die Variante mit Stern für volle Breite:

\begin{ShortExample}{multilinetextfieldstar}{breites mehrzeiliges Textfeld}
%%% FIXME bug in preview (works in doc)
\Text{}
\MultilineTextField*[2cm]{Kringel}
\Text{}
\end{ShortExample}

\paragraph{Spezialfälle}  Unterschriften sollen üblicherweise händisch gesetzt
werden, hierfür gibt es daher ein Feld was nur ein "falsches" Formularfeld ist
und nicht digital ausgefüllt werden kann.

(NB: Die Breite ist -- wie bei allem -- relativ zur Papierbreite definiert.  Da
diese bei diesen Beispielen deutlich schmaler als A4 ist, sieht das Feld hier
sehr schmal aus; im "richtigen" Formular wird es aber eine angemessene Größe
haben.)

\begin{ShortExample}{signature}{Feld für Unterschriften}
\Signature
\end{ShortExample}

Das Label kann optional geändert werden.

\begin{ShortExample}{signatureopt}{Unterschrift mit anderem Label}
\Signature[Unterschrift]
\end{ShortExample}

Ebenfalls gibt es ein etwas größeres Feld für Notizen oder Vermerke.

\begin{ShortExample}{notes}{großes Feld}
%%% FIXME bug in preview (works in doc)
\Notes
\Text{}
\end{ShortExample}

Auch hier kann optional das Label geändert werden.

\begin{ShortExample}{notesopt}{großes Feld}
%%% FIXME bug in preview (works in doc)
\Notes[Stirnabdruck]
\Text{}
\end{ShortExample}

\subsection{Checkboxen}

\paragraph{Normale Verwendung}  Gibt es eigentlich nicht viel dazu zu sagen --
\texcode{\Checkbox{Label}} für eine Checkbox (und das Label kann auch ein
kompletter Absatz sein.)

\begin{ShortExample}{checkbox}{Checkboxen}
\Checkbox{Ich habe die AGB,
	Datenschmutzerklärung,
	Beitragsordnung, Satzung, Hausordnung
	(inklusive Durchführungsverordnung
	zur Pflanzenpflege im Treppenhaus),
	Geheimhaltungsvereinbarung, die
	Datenschutzgrundsätze in leichter
	Sprache (PDF, 451 Seiten), das
	Hygienekonzept, sowie die Anleitung
	zum Lesen von Anleitungen gelesen.}
\end{ShortExample}

Für Freitextfelder als "Sonstige:" gibt es
\texcode{\CheckboxOther[Breite]{Label}}, wieder mit optionaler Breitenangabe
(relativ zur Textbreite) für das Freitextfeld.

\begin{ShortExample}{othercheckbox}{"Sonstiges"}
\Text{Meine Lieblingstaste ist:}
\begin{Indented}
	\Checkbox{Escape}
	\Checkbox{Enter}
	\CheckboxOther[0.1]{Buchstabe}
	\CheckboxOther[0.1]{F\hspace{-1em}}
	\CheckboxOther{}
\end{Indented}
\end{ShortExample}

Auch hier gilt: umso weniger verschiedene Breiten verwendet werden, umso
einheitlicher sieht das Formular am Ende aus.  Bei dem Beispiel würde ein
einzelner Buchstabe auch in ein 0.05-er Feld passen, das wären dann aber 3
statt 2 verschiedener Breiten.

\paragraph{Spezielle Zwecke}

In Sondersituationen könnten z.~B. in Aufzählungen innerhalb einer Zeile auch
Checkboxen benötigt sein.  Dafür gibt es die -- nur in Ausnahmefällen zu
verwendende -- Inline-Variante, welche sich (fast) gar nicht um die
Formatierung kümmert und nur die Box zur Verfügung stellt.  (Das Einzige: ein
Leerzeichen auf der rechten Seite wird sichergestellt, für gleichmäßige
Abstände sollte also genau \emph{nicht} \texcode{{}} oder \texcode{\ }
angehängt werden.)

\begin{ShortExample}{inlinecheckbox}{Sonderfall -- Inline}
\Text{Ich bin \InlineCheckbox groß,
	\InlineCheckbox grau, und/oder
	\InlineCheckbox unwichtig.
}
\begin{Indented}
	\Text{(Bearbeitungsvermerk: Bei
	Anwahl von zwei oder mehr ist der/die
	Ausfüllende möglicherweise ein
	Irrelefant und vor Aufnahme
	\ul{zwingend} eine
	Löschdiskussionsrecherche
	durchzuführen.)}
\end{Indented}
\end{ShortExample}

\section{Struktur}

Drei Kategorien -- formularspezifisch, "klassische" Abschnitte, und mehrere Spalten.

\subsection{formularspezifisch angepasste Formen}

\paragraph{\texttt{Indented}}  Visuelle Gruppierung durch Einrücken von
zusammenhängenden bzw. untergeordneten Abschnitten ist eine sehr gute Option,
da ohne zusätzliche Tinte trotzdem klar die Struktur vermittelt wird.  (Das
wurde auch schon bei den Checkboxen unmittelbar hier drüber verwendet.)
Optional kann ein Faktor (nicht zwingend ganzzahlig) für die Einrückungstiefe
angegeben werden.

\begin{ShortExample}{indentation}{Einrückung, auch über mehrere Ebenen}
\Text{abc}
\begin{Indented}
	\Text{def}
	\begin{Indented}
		\Text{ghi}
	\end{Indented}
	\Text{jkl}
\end{Indented}
\Text{mno}
\begin{Indented}[2]
	\Text{pqr}
\end{Indented}
\end{ShortExample}

\paragraph{\texcode{\RuleSection}}  Dient zur Trennung von Formularabschnitten,
die durch verschiedene Personengruppen ausgefüllt werden.  Die Linie geht immer
über die komplette Formularbreite und kann z.~B. nicht innerhalb von
mehrspaltigen Bereichen verwendet werden.

\begin{ShortExample}{rulesection}{Mehrere klar getrennte Abschnitte}
\TextField{Name}
\TextField*{Anliegen}
\RuleSection{Bearbeiter}
\Checkbox{Antrag angenommen}
\CheckboxOther[0.5]{Abgelehnt, weil:}
\end{ShortExample}

\paragraph{\texcode{\Rule}}  Eine einfache Trennlinie, die an verschiedenen
Stellen zur grafischen Trennung eingesetzt werden kann.

\begin{ShortExample}{rule}{Mehr Trennlinien}
\RuleSection{Bearbeiter}
\CheckboxOther{Antrag eingegangen am:}
\Rule
\Checkbox{Antrag angenommen}
\begin{Indented}
\CheckboxOther{Bearbeitet am:}
\CheckboxOther{Antragsteller informiert:}
\end{Indented}
\Rule
\CheckboxOther[0.5]{Abgelehnt, weil:}
\end{ShortExample}

\clearpage

\subsection{"klassische" Struktur}

In \TeX\ üblich sind \texcode{\section}, \texcode{\subsection}, etc.; in
Analogie dazu gibt es für ggf.  längere Formulare \texcode{\Section} und
\texcode{\Subsection}.  Für die meisten Formulare ist das jedoch vermutlich
nicht nötig, insbesondere da ggf. per Einrückung via
\texcode|\begin{Indented} ... \end{Indented}| visuell schneller lesbare
Struktur geschaffen werden kann.

\begin{ShortExample}{sectioning}{Abschnittsunterteilung}
\Section{Allgemeines}
\TextField{Name}
\Section{Antragsinhalt}
\TextField*{Anliegen}
\Subsection{Details}
\Notes[]
\Section{Abschließendes}
\Checkbox{Die AGB werden akzeptiert.}
\Signature
\end{ShortExample}

\clearpage

\subsection{mehrspaltige Bereiche}

Es gibt Unterstützung für 2, 3, und 5 Spalten (ggf. können diese auch
ineinander geschachtelt werden.)  Die Befehle heißen -- vermutlich wenig
überraschend -- \texcode{\TwoColumns}, \texcode{\ThreeColumns}, und
\texcode{\FiveColumns} und es sollten entsprechend viele \texcode{{}}-Gruppen
folgen.

\begin{ShortExample}{multicolumn}{Mehrspaltigkeit}
\TwoColumns{
	\TwoColumns{
		\Checkbox{Ja}
	}{
		\Checkbox{Nein}
	}
	\Rule
	\ThreeColumns{
		\Checkbox{A}
	}{
		\Checkbox{B}
	}{
		\Checkbox{C D E F G}
	}
	\Rule
	\ThreeColumns{
		\Checkbox{Foo}
	}{
		\Checkbox{Bar}
	}{
		\Checkbox{Baz}
	}
}{
\Notes
}
\end{ShortExample}

Bei zu vielen Spalten werden die Abstände unlesbar -- siehe hier die
Foo/Bar/Baz-Gruppierung. Auf A4 geht diese Schachtelung aber üblicherweise noch
problemlos.

\section{Hervorhebung}

Es gibt verschiedene in \TeX\ eingebaute Befehle, die ebenfalls verwendet
werden können\dots\ aber "weniger ist mehr" trifft insbesondere auch hier zu.
Die meisten sollten also nur bei ernsthaftem Bedarf verwendet werden.

Eine akzeptable Formatierungsmethode ist das Hervorheben von Text mit
\texcode{\emph}.  Üblicherweise typografisch eher verpönt, aber schon irgendwie
zum aktuellen Design passend, können mit \texcode{\ul} auch \emph{einzelne
Worte oder sehr kurze Passagen} unterstrichen werden, dabei ist jedoch zu
beachten, dass innerhalb unterstrichener Bereiche keine Zeilenumbrüche mehr
möglich sind. (Der Bereich wird als eine logische Box verpackt und kann nur
noch als Ganzes verschoben werden.)

Es gibt zwar eigentlich viele verschiedene Schriftgrößen, es ist jedoch keine
gute Idee, alle quer durcheinander zu verwenden.  Die Dokumentenklasse kümmert
sich ums meiste, als einzige Akzeptable gibt es \texcode{\details} (als
semantischen Namen), welche für untergeordnete Bemerkungen zur Verfügung steht.

\begin{ShortExample}{formatting}{Formatierungsbeispiele}
\Text{Die Formulare sind \ul{sofort}
nach Eingang zu kopieren und in
\emph{dreifacher} Ausfertigung
abzuheften!}
\Text{\details{Bei Ausfall des Kopierers
ist umgehend der Techniker zu informieren
und ersatzweise die Faxgeräte mit der -02
und der -05 \ul{(nicht die -07 bis -09
oder -12!)} zum Kopieren per Fax zu
verwenden.}}
% und nochmal umbrechbarer:
\Text{\details{Bei Ausfall des Kopierers
ist umgehend der Techniker zu informieren
und ersatzweise die Faxgeräte mit der -02
und der -05 (\ul{nicht} die -07 bis -09
oder -12!) zum Kopieren per Fax zu
verwenden.}}
\end{ShortExample}

\end{document}

