<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">%% This is file `DEMO-TUDaPub-de.tex' version 3.41 (2024-07-02),
%% it is part of
%% TUDa-CI -- Corporate Design for TU Darmstadt
%% ----------------------------------------------------------------------------
%%
%%  Copyright (C) 2018--2024 by Marei Peischl &lt;marei@peitex.de&gt;
%%
%% ============================================================================
%% This work may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either version 1.3c
%% of this license or (at your option) any later version.
%% The latest version of this license is in
%% http://www.latex-project.org/lppl.txt
%% and version 1.3c or later is part of all distributions of LaTeX
%% version 2008/05/04 or later.
%%
%% This work has the LPPL maintenance status `maintained'.
%%
%% The Current Maintainers of this work are
%%   Marei Peischl &lt;tuda-ci@peitex.de&gt;
%%
%% The development respository can be found at
%% https://github.com/tudace/tuda_latex_templates
%% Please use the issue tracker for feedback!
%%
%% If you need a compiled version of this document, have a look at
%% http://mirror.ctan.org/macros/latex/contrib/tuda-ci/doc
%% or at the documentation directory of this package (if installed)
%% &lt;path to your LaTeX distribution&gt;/doc/latex/tuda-ci
%% ============================================================================
%%
% !TeX program = lualatex
%%
% PDF/A Ã¼ber pdfmanagement und nicht Ã¼ber pdfx
\DocumentMetadata{
	pdfstandard=a-2b,
	lang=de,
	pdfversion=1.7,% 2.0 geht auch, aber die meisten Validierungsprogramme unterstÃ¼tzen das  noch nicht.
}

\documentclass[
	german,
	accentcolor=9c,% Farbe fÃ¼r Hervorhebungen auf Basis der Deklarationen in den Corporate Design Richtlinien
%	logofile=example-image, %Falls die Logo Dateien nicht vorliegen
	]{tudapub}

\usepackage[english, main=german]{babel}
\usepackage[autostyle]{csquotes}

\usepackage{biblatex}
\bibliography{DEMO-TUDaBibliography}

%Formatierungen fÃ¼r Beispiele in diesem Dokument. Im Allgemeinen nicht notwendig!
\let\file\texttt
\let\code\texttt
\let\pck\textsf
\let\cls\textsf
\biburlsetup

\usepackage{hologo}

\begin{document}

%ZusÃ¤tzliche Metadaten fÃ¼r PDF/A. In diesem Fall notwendig, weil Titel ein Makro enthÃ¤lt.
\Metadata{
	author=Marei Peischl (peiTeX),
	title=TUDaPub - LaTeX-Paper im Corporate Design der TU Darmstadt,
	subject=Basisdokumentation und Template zur Nutzung der tudapub-Dokumentenkasse,
	date=2019-04-29,
	keywords=TU Darmstadt\sep Corporate Design\sep LaTeX
}

\title{TUDaPub -- \LaTeX-Paper im Corporate Design der TU Darmstadt}
\subtitle{Die Dokumentenklasse tudapub}
\author{Marei Peischl\thanks{pei\TeX{} \TeX{}nical Solutions}\and der \TeX-LÃ¶we}

\titlegraphic{
%	%Folgende Box kann selbstverstÃ¤ndlich durch ein mit \includegraphics geladenes Bild ersetzt werden.
	\color{black!30}\rule{\width}{\height}
}


%Varianten der Infoboxen
\addTitleBox{Institutsbezeichnung bzw. Logo in 2/3 GrÃ¶ÃŸe, vgl. \code{addTitleBoxLogo}}
%\addTitleBoxLogo{example-image}
%\addTitleBoxLogo*{\includegraphics[width=.3\linewidth]{example-image}}



\maketitle

\begin{abstract}
	Dieses Dokument stellt ein Template und gleichzeitig die Verwendungsdokumentation zur Dokumentenklasse tudapub, einem Teil des TUDa-CI-Paketes dar.

	Noch befindet sich das Projekt in der Testphase. Sollten Sie Fragen, WÃ¼nsche und Anregungen haben, bitten wir um eine entsprechende Mitteilung.
\end{abstract}

\begin{abstract}[english]
	Example for an additional abstract in English.
\end{abstract}



\tableofcontents

\section{Ãœber diese Datei}
Die Datei \file{DEMO-TUDaPub.tex} beziehungsweise ihre Ausgabe \file{DEMO-TUDaPub.pdf} ist die Dokumentation der Dokumentenklasse \file{tudapub.sty}.

Sie ist Teil des TUDa-CI-Bundles und basiert in Teilen auf dem tuddesign-Paket von C.~v.~Loewenich und J.~Werner.

In diesem Dokument werden die speziellen Optionen und EinstellungsmÃ¶glichkeiten erlÃ¤utert.

\section{Verwendung}
Die Klasse wird wie gewohnt geladen:
\begin{verbatim}
\documentclass[&lt;Optionen&gt;]{tudapub}
\end{verbatim}
Im folgenden werden die mÃ¶glichen Optionen beschrieben.

\subsection{Klassenoptionen}

\begin{description}
	\item[class=&lt;article|report|book&gt;] Diese Option legt die Basisdokumentenklasse fest. Die Werte laden die entsprechende KOMA-Script-Klasse \cite{scrguide}. Der Wert \code{article} lÃ¤dt somit die Klasse \code{scrartcl}.

	KOMA-Script ist eine Sammlung von Klassen und Paketen fÃ¼r \LaTeX, die neben den typografischen Anpassungen an den EuropÃ¤ischen Raum auch die KonfigurationsmÃ¶glichkeiten stark erweitert.
	\item[color=&lt;Farbe&gt;] WÃ¤hlt die Schmuckfarbe fÃ¼r die Nutzung in der IdentitÃ¤tsleiste aus. Die Farbcodes finden sich in der FarbÃ¼bersicht in den Corporate Design Richtlinien. Neben diesen Farben kann prinzipiell jede beliebige Farbe Ã¼bergeben werden. Die Optionen \code{accentcolor}, \code{textaccentcolor} und \code{identbarcolor} werden anlog direkt an \pck{tudacolors} Ã¼bergeben. Auf diesem Weg kÃ¶nnen die Farben unabhÃ¤ngig voneinander gesetzt werden.
	\item[marginpar] Schaltet die Randnotizspalte um. Voreingestellt ist \code{auto}. Dies bedeutet, dass die Randnotizspalte wie im Corporate Design Handbuch \cite{TUDaGuideline} Ã¼ber die fÃ¼nfte Spalte lÃ¤uft.  \marginpar{Beispiel fÃ¼r eine Randnotiz}.
	DarÃ¼ber werden auch die Werte \code{true} und \code{false} akzeptiert. \code{false} setzt die Breite der Randnotizspalte auf 0. Der Mechanismus selbst wird nicht deaktiviert.

	Randnotizen werden Ã¼ber den komafont-Mechanismus \cite[vgl.][]{scrguide} im Element \code{marginpar} gesetzt. Seine Voreinstellung entspricht
	\begin{verbatim}
	\setkomafont{marginpar}{\accentfont}
	\end{verbatim}
	Um zusÃ¤tzlich farbige Randnotizen zu setzen, kÃ¶nnte dies geÃ¤ndert werden, Ã¼ber
	\begin{verbatim}
	\addtokomafont{marginpar}{\color{textaccentcolor}}
	\end{verbatim}
	\marginline{
		\includegraphics[width=\marginparwidth]{example-image}\\
		Flattersatz in der marginnline aus \KOMAScript
	}
	\item[twocolumn] Aktiviert den zweispaltigen Modus global. In diesem Fall werden jedoch aufgrund ihrer Natur zwei Randnotizspalten erzeugt. Eine Nutzung in Kombination mit \code{marginpar=auto} ist daher in den meisten FÃ¤llen fragwÃ¼rdig. Falls der zweispaltige Modus lediglich lokal aktiviert wird, entfÃ¤llt dieses Verhalten, allerdings werden dann Randnotizen deaktiviert.
	\item[ruledheaders] WÃ¤hlt den Stil der Ãœberschriften aus. \code{ruledheaders=all} wÃ¤hlt den mit Linien eingerahmten Stil fÃ¼r alle bis zur \verb+\subsubsection+. Bei \code{chapter} beziehungsweise \code{section} ist dieser Stil entsprechend beschrÃ¤nkt. False lÃ¤dt den Standardstil aus \KOMAScript.
	\item[title=default/small/large] Die relativ groÃŸe SchriftgrÃ¶ÃŸe des Titels kann â€“ insbesondere bei langen Titel fÃ¼r Abschlussarbeiten â€“ zu Platzproblemen fÃ¼hren. Die Option \code{title} verhindert dies, indem die fÃ¼r das jeweils kleinere Papierformat eingestellten SchriftgrÃ¶ÃŸen geladen werden. Die Voreinstellung ist \code{default} und entspricht dem Wert \code{large}.
  \item[type] Als Typ stehen im Moment \code{publication} und \code{thesis} zur VerfÃ¼gung. Die besonderen MÃ¶glichkeiten im Typ thesis sind in der Datei DEMO-TUDaThesis.tex/.pdf geschildert. Voreingestellt ist \code{publication}.
	ZusÃ¤tzlich existiert ab Version 1.2 noch der Modus \code{intern}. Dieser wÃ¤hlt die Optionen \code{titlepage=false} fÃ¼r einen Titelkopf statt Titelseiten, sowie die TUDaPub-Optionen \code{pdfa=""false} und \code{IMRAD=false}. Dieser Modus ist fÃ¼r kurze, interne Berichte gedacht.
	\item[headline] Die Kopfzeile verfÃ¼gt Ã¼ber die im Corporate Design beschriebenen LayoutmÃ¶glichkeiten Ã¼ber den Wert \code{automark}. Da diese LÃ¶sung typografisch nicht sonderlich sinnvoll ist, ist es auch mÃ¶glich, diese abzuschalten. Voreingestellt ist ein Stil ohne Kolumnentitel.
	\item[logo] Option fÃ¼r die Titelseite, siehe \ref{sec:title}
	\item[colorback] Option fÃ¼r die Titelseite, siehe \ref{sec:title}
	\item[IMRAD=true/false] Deaktiviert die PrÃ¼fung auf IMRAD-Labels, siehe Abschnitt \ref{sec:IMRAD}.
	\item[logofile=&lt;Dateipfad&gt;] Erlaubt es ein alternatives Logo zu Ã¼bergeben. Diese Option existiert, um die Templates auch ohne das TUDa-Logo nutzen zu kÃ¶nnen. Die Logos sind der internen Verwendung vorbehalten und dÃ¼rfen daher nicht mit diesem Template verÃ¶ffentlicht werden.
\end{description}

\noindent Der Rest der Dokumentenklasse entspricht dem Standard von \KOMAScript, vgl. Abschnitt \ref{sec:KOMA}.

\subsection{Die Titelseite}
\label{sec:title}

Die Titelseite wird von tudapub automatisch generiert. Die Verwendung hierfÃ¼r entspricht grÃ¶ÃŸtenteils der klassischen Methode unter Verwendung von \code{maketitle}.

Die \KOMAScript-Option \code{titlepage} erlaubt es Ã¼blicherweise, zwischen Titelseiten und Titelkopf umzuschalten. Bis Version 1.2 war diese Option deaktiviert. Mittlerweile existiert ein Modus fÃ¼r einen Titelkopf, dieser entspricht jedoch nicht den offiziellen Vorgaben und ist fÃ¼r interne Verwendung gedacht. Aufgrund der Implementierung wird \code{titlepage=true} identisch zu \code{titlepage=firstiscover} behandelt.

Die Makros wie \code{author}, \code{title}, \code{subtitle} und \code{date} entsprechen der normalen Verwendung. FÃ¼r die Institutszuweisung kann ebenfalls wie gewohnt \code{thanks} verwendet werden.

ZusÃ¤tzlich stehen die Makros \code{titlegraphic} und \code{addTitleBox} zur VerfÃ¼gung um weitere Daten zu Ã¼bergeben.

\minisec{titlegraphic}
Das Makro \code{titlegraphic} akzeptiert beliebigen Inhalt. Dieser wird bÃ¼ndig mit der oberen Ecke im Hauptteil der Titelseite platziert.
Ãœblicherweise wird dieses Makro zur Platzierung einer Grafik genutzt:

\begin{verbatim}
\titlegraphic{\includegraphics[width=\width]{example-image}}
\end{verbatim}

Um die GrÃ¶ÃŸe des Bildes passend zu wÃ¤hlen kÃ¶nnen die Makros \code{width}/\code{height} verwendet werden. DarÃ¼ber hinaus existiert ab Version 3.19 auch die Variante \code{titlegraphic*} mit der die Skalierung und ein ggf. notwendiger Beschnitt fÃ¼r das FÃ¼llen des reservierten Bereichs automatisch geschieht.

ZusÃ¤tzliche Logos und Informationen kÃ¶nnen Ã¼ber Boxen ergÃ¤nzt werden.

\begin{verbatim}
\addTitleBox{Institut 1}
\end{verbatim}
Die Institutsboxen werden mit vorgegebenem Abstand unter dem Logo platziert. Hier kann Text erscheinen oder auch ein Institutslogo. Der Hintergrund ist weiÃŸ.

Um die Institutsboxen fÃ¼r Logos zu verwenden, liefert \cls{tudapub} das Makro \code{addTitleBoxLogo}. Als Argument akzeptiert es einen Bilddateipfad.

\begin{verbatim}
\addTitleBoxLogo{example-image}
\addTitleBoxLogo*{\includegraphics[width=\linewidth]{example-image}}
\end{verbatim}

\subsubsection{Sponsorenlogos}
Ab Version 3.0 steht in TUDaPub auch der Sponsorenmechanismus der TUDaLeaflet-Klasse zur VerfÃ¼gung. Damit ist es MÃ¶glich Sponsorenlogos unterhalb des Titelbildes zu platzieren.

Sponsorenlogos werden Ã¼blicherweise Ã¼ber
\begin{verbatim}
	\AddSponsor{&lt;logo1&gt;}
	\AddSponsor{&lt;log2&gt;}
\end{verbatim}
Ã¼bergeben. Innerhalb des Arguments ist \verb+\height+ so gesetzt. Somit werden im Beispiel alle Logos auf die gleiche HÃ¶he gesetzt. Der Abstand dazwischen wird entsprechend aufgefÃ¼llt, sodass der gesamte Block immer links und rechts mit dem Text abschlieÃŸt.

Die zweite Variante ermÃ¶glicht die Platzierung mit manueller vertikaler Ausrichtung, wie es bei Logos mit unterschiedlicher HÃ¶he notwendig sein kÃ¶nnte. Hierbei werden lediglich die AbstÃ¤nde und Trennlinien um die Logos ergÃ¤nzt:

\begin{verbatim}
	\sponsors{
		&lt;logo1&gt;&lt;logo2&gt;
	}
\end{verbatim}


\subsubsection{Optionen fÃ¼r die Titelseite}
Die Position des Logos ist umschaltbar. Dies geschieht Ã¼ber die Dokumentenklassenoption \code{logo=head/""body}.
\begin{description}
	\item[logo=head] Das Logo wird im Kopf direkt neben dem Titel platziert. Der Titel wird in der Breite reduziert. Der Hintergrund des Titels wird in der Farbe der IdentitÃ¤tsleiste eingefÃ¤rbt. ZusÃ¤tzliche Infoboxen (s.u.) werden ebenfalls im Kopf platziert.
	\item[logo=body] Das Logo samt der Infoboxen wird im KÃ¶rper der Titelseite platziert.
\end{description}

DarÃ¼ber hinaus lÃ¤sst sich die Farbgebung umschalten.
Die Option \code{colorback} schaltet zwischen dem farbigen Block auf der Titelseite und weiÃŸem Hintergrund um. Sie ist in der Voreinstellung aktiviert, sodass ein Farbiger Block erzeugt wird.

Mit Version 3.08 werden zusÃ¤tzlich zu den \code{true}/\code{false} Werten auch die Werte \code{title}, \code{head} und \code{body} fÃ¼r die Option colorback ergÃ¤nzt.
Mit diesen ist es mÃ¶glich nach der Auswahl der Logoposition eine Korrektur an der Farbgebung durchzufÃ¼hren. Alle drei neuen Werte aktivieren die Hintergrundfarbe und schalten deren Position um:
\begin{description}
	\item[colorback=true/false] Aktiviert/Deaktiviert die FarbflÃ¤che auf der Titelseite. Dieser Schalter ist unabhÃ¤ngig von der aktuelle Position der farbigen FlÃ¤che. Die Ã¼brigen Optionen aktivieren zusÃ¤tzlich auch die Ausgabe der FarbflÃ¤che, falls diese zuvor deaktiviert war.
	\item[colorback=title] Der Titel (ohne Untertitel) wird hinterlegt.
	\item[colorback=head] Der komplette Titelblock, inklusive Titelblock wird hinterlegt.
	\item[colorback=body] Es wird nur der Bildbereich eingefÃ¤rbt.
\end{description}

\subsection{Strukturierungselemente}
\minisec{Die abstract-Umgebung}
Die \code{abstract}-Umgebung wird fÃ¼r \cls{tudapub} um eine Option fÃ¼r die Sprache erweitert. Somit ist es mÃ¶glich, mehrere Zusammenfassungen in einem Dokument zu nutzen.

\begin{verbatim}
\begin{abstract}
	Zusammenfassung entsprechend der Dokumentensprache. In diesem Fall Deutsch.
\end{abstract}

\begin{abstract}[english]
	ZusÃ¤tzliche Zusammenfassung in englischer Sprache
\end{abstract}
\end{verbatim}

FÃ¼r die Verwendung ist wichtig, dass alle im Dokument genutzten Sprachen geladen werden. Im Falle des Beispiels muss also sowohl \code{german} als auch \code{english} an das \pck{babel}-Paket Ã¼bergeben werden.


\subsection{PDF/A KonformitÃ¤t}
Die Klasse TUDaPub unterstÃ¼tzt den Standard PDF/A 2b. Der PDF/A-Modus ist automatisch aktiviert. die zugehÃ¶rige Option kann jedoch Ã¼ber \code{pdfa=false} ausgeschaltet werden.
Nun wird zusÃ¤tzlich eine \code{\textbackslash.xmpdata}-Datei generiert. Ãœblicherweise werden die Titeldaten direkt Ã¼bernommen.

Dies kann jedoch bei der Verwendung einiger Makros innerhalb der Felder zu Problemen fÃ¼hren. Beispielsweise enthÃ¤lt der Titel fÃ¼r dieses Dokument das Makro \code{\LaTeX}. Es kÃ¶nnen daher nur Textelemente Ã¼bernommen werden. Ã„hnlich den Linkbezeichnungen Ã¼ber PDF-Lesezeichen.

Um dieses Problem zu umgehen stellt \cls{tudapub} hierfÃ¼r das Makro \code{\textbackslash{}Metadata\{\}} zur VerfÃ¼gung. Hier kÃ¶nnen sÃ¤mtliche von \pck{pdfx} verarbeitbaren Variablen nach SchlÃ¼ssel$=$Wert-Struktur gesetzt werden. Es ist zu beachten, dass dieses Makro nur dann funktioniert, wenn die \code{pdfa}-Ausgabe aktiviert ist. Ist dies nicht der Fall, so gibt \cls{tudapub} eine entsprechende Fehlermeldung zu diesem Widerspruch aus.
Zum Beispiel:
\begin{verbatim}
\Metadata{
	author=Marei Peischl (peiTeX),
	title=LaTeX im Corporate Design der TU Darmstadt,
}
\end{verbatim}
Das Feld \code{publisher} ist mit \enquote{TU Darmstadt} vorbelegt, kann aber Ã¼berschrieben werden.

Um mehrere EintrÃ¤ge zu trennen, wird das Makro \code{\textbackslash{}sep} genutzt.
\begin{verbatim}
keywords={TU Darmstadt \sep Corporate Design \sep LaTeX}
\end{verbatim}
Wenn der Eintrag selbst Kommata enthalten kÃ¶nnte, dann ist eine Gruppierung um den Eintrag notwendig. Sonst wird der Text nach dem Komma als nÃ¤chstes Keyword interpretiert.

\minisec{MÃ¶gliche Probleme mit Ã¤lteren Systemen:}

Bei Ã¤lteren \TeX-Distributionen kann es vorkommen, dass die Farbprofile nicht vorinstalliert sind. In diesem Fall wird eine Fehlermeldung im folgenden Sinn erzeugt:
\begin{verbatim}
No color profile found to use for RGB screen colors
\end{verbatim}
Um diesen Fehler zu beheben, kÃ¶nnen die notwendigen *.icc-Dateien unter \url{http://mirror.ctan.org/support/colorprofiles} heruntergeladen und entweder installiert oder im Projektordner mit abgelegt werden. Die einfachste LÃ¶sung bleibt jedoch, das eigene \TeX-System zu aktualisieren.

DarÃ¼ber hinaus werden bei \hologo{XeLaTeX} einige Features nicht unterstÃ¼tzt. In diesem Fall erzeugt \code{pdfa=""false} ein kompilierbares Dokument, allerdings sollte fÃ¼r validierbare PDF/A-Dateien auf \hologo{LuaLaTeX} einer mÃ¶glichst aktuellen Version umgestiegen werden.

\subsection{ZusÃ¤tzliche Metadaten nach Wunsch der UniversitÃ¤tsbibliothek}
\label{sec:IMRAD}
Es existiert ein Mechanismus um das Strukturierungsmodell IMRaD \cite{imrad} zu kennzeichnen.
Im Stil der einzelnen Teilbereiche kÃ¶nnen so, Ã¼ber Aufruf von

\begin{verbatim}
\IMRADlabel{introduction}
\IMRADlabel{methods}
\IMRADlabel{results}
\IMRADlabel{discussion}
\end{verbatim}
entsprechende Labels generiert werden. Sie haben den Namen \code{IMRAD:&lt;SchlÃ¼ssel&gt;}.

Der PrÃ¼fmechanismus ist auf Wunsch der Bibliothek standardmÃ¤ÃŸig aktiviert, kann jedoch durch die Option \code{IMRAD=false} deaktiviert werden.

\subsection{Farbdarstellung}
\label{sec:pdfa-color}
Der PDF/A-Modus konvertiert automatisch eingegebene CMYK-Farben in RGB. Da es keine eindeutige Umwandlung gibt, sollten daher im Modus \code{pdfa=true} keine CMYK-Elemente verwendet werden.

FÃ¼r die Druckausgabe ist dieser Modus ungeeignet. Ab Version 3.12 gibt \cls{tudapub} eine entsprechende Infomeldung aus, um Ã¼ber diese Umwandlung zu informieren.

\section{Erweiterte KonfigurationsmÃ¶glichkeiten}

\subsection{Auswahl des Dokumentenfarbmodus}
Farben unterliegen je nachdem auf welchem Medium sie ausgegeben werden einer anderen Farbmischung. FÃ¼r die Verwendung bei der Dokumentenerzeugung ist daher wichtig welches Ausgabemedium primÃ¤r genutzt werden soll.

Technisch zeigt sich dieser Unterschied in Farbmodellen. TUDa-CI unterstÃ¼tzt entsprechend der Richtlinien sowohl ein Farbmodell fÃ¼r die Druckausgabe (cmyk) und fÃ¼r die Bildschirmdarstellung (RGB). Die Umsetzung geschieht Ã¼ber das Paket \pck{xcolor} wobei die entsprechenden Farbwerte fÃ¼r beide Modelle Ã¼ber \pck{tudacolors} hinterlegt sind.

Normalerweise wÃ¤hlt TUDa-CI automatisch ein passendes Modell. Allerdings sorgt die Voreinstellung von \code{pdfa-true} fÃ¼r eine Konvertierung zu RGB (vgl.~\ref{sec:pdfa-color}).

Soll abseits dieser automatischen Abweichung ein bestimmter Farbmodus erzeugt werden, kÃ¶nnen die \pck{xcolor}-Optionen \code{cmyk} oder \code{RGB} direkt an \cls{tudapub} Ã¼bergeben werden. Sie werden entsprechend an das Paket weitergereicht und entsprechend der \pck{xcolor}-Dokumentation verarbeitet.

\subsection{Anpassungen, die von den Corporate Design Richtlinien abweichen}

\subsubsection{SchriftgrÃ¶ÃŸe}
\cls{tudapub} kann entgegen der Corporate Design Richtlinien auch andere SchriftgrÃ¶ÃŸen verarbeiten. HierfÃ¼r wird die \code{fontsize}-Option aus \KOMAScript{} genutzt (z.\,B. \code{fontsize=11pt}). Sofern keine spezielle SchriftgrÃ¶ÃŸendatei fÃ¼r TUDa-CI vorliegt, wird die mit \KOMAScript{} ausgelieferte Datei gewÃ¤hlt.

Beispiele fÃ¼r Abweichungen aus typografischen GrÃ¼nden sind Beispielsweise auch in den Demo-Dateien fÃ¼r Abschlussarbeiten gezeigt.

\subsubsection{SeitenrÃ¤nder}
Die ZeilenlÃ¤ngen sind laut Corporate Design aus typografischer Sicht zu lang.
Daher existiert die Klassenoption \code{custommargins}. Sie verfÃ¼gt Ã¼ber die Werte \code{true}, \code{false} und \code{geometry} mit folgender Bedeutung:

\begin{description}
\item[custommargins=false] Standardeinstellung von \cls{tudapub}. Die RÃ¤nder entsprechen den Vorgaben des Corporate Design Guidelines. Die Einstellung wird durch \pck{geometry} durchgefÃ¼hrt. Eigene Anpassungen werden durch das AusfÃ¼hren von \code{\textbackslash{}maketitle} Ã¼berschrieben.
\item[custommargins=true] Die Einstellungen des Corporate Design Guidelines werden nicht aktiviert. \pck{geometry} wird nicht geladen. Dieser Modus entspricht der Standardeinstellung von \KOMAScript{}. Dadurch werden die RÃ¤nder nicht fest definiert, sondern auf Basis des \pck{typearea}-Paketes berechnet \cite[vgl.][]{scrguide}.
\item[custommargins=geometry]  Diese Variante wurde auf Wunsch zur VerfÃ¼gung gestellt, allerdings wird darauf hingewiesen, dass manuelle Randeinstellungen oft nicht zu einem harmonischen Satzspiegel fÃ¼hrt.
\pck{geometry} wird, wie bei \code{false} geladen und vorkonfiguriert. Es ist allerdings mÃ¶glich kleinere Anpassung durch die Verwendung des Makros \code{\textbackslash{}geometry} zu setzen. Die Einstellungen, die zu Beginn des Dokuments gelten werden gespeichert und nach der Titelseite wiederhergestellt.

Hierbei ist zu beachten, dass die Einstellungen als Ausgangspunkt den Voreingestellten Satzspiegel nutzen (je nach Option mit Randnotizspalte oder ohne). Es ist mÃ¶glich diese Optionen vor den eigenen mit zurÃ¼ckzusetzen:
\begin{verbatim}
	\geometry{
	   reset,
	   &lt;Eigene Anpassungen&gt;
	}
\end{verbatim}
Die gilt insbesondere fÃ¼r die Optionen \code{includehead}, \code{includefoot} und \code{includemp}.
\end{description}

\minisec{Hinweis zu den Kopf-/FuÃŸzeilen}
Wenn die Option \code{marginpar=true} gesetzt bleibt, ragen die Kopf- und FuÃŸzeile Ã¼ber die Marginalspalte hinaus. Aus Ã¤sthetischen GrÃ¼nden wird daher empfohlen in diesem Fall die Kopf- und FuÃŸzeile  mit \code{marginpar=false}  auf den Textbereich zu beschrÃ¤nken.

Auch ist das Standard-Layout der Kolumnentitel wenig vorteilhaft, da die Kolumnentitel damit lokal grÃ¶ÃŸer sein kÃ¶nnen als die eigentliche Ãœberschrift. (\code{headline=automark})
Deswegen kann Ã¼ber
\begin{verbatim}
	\pagestyle{TUDa.headings}
\end{verbatim}
ein einfacherer Seitenstil ausgewÃ¤hlt werden, der die Nutzung mit lebenden Kolumnentitel erheblich vereinfacht. Dieser Stil ist Ã¼ber \pck{scrlayer-scrpage} realisiert und kann entsprechend der \KOMAScript{}-Dokumentation angepasst werden.

\minisec{Hinweis zur Bindekorrektur}
Bei Verwendung einer Bindekorrektur (\code{BCOR=&lt;LÃ¤nge&gt;}) wird diese nicht automatisch auch auf der Titelseite eingefÃ¼gt. FÃ¼r diesen Fall wurde mit Version 3.0 zusÃ¤tzlich die Option \code{BCORtitlepage} hinzugefÃ¼gt. Falls diese aktiviert wird, nimmt die Titelseite den Wert der Typearea Option \code{BCOR} auf der ersten Seite als Zusatz zum linken Rand hinzu.


\subsection{Frontmatter/Mainmatter/Backmatter}
Ãœblicherweise existieren die Makros \verb+\frontmatter+, \verb+\mainmatter+ und \verb+\backmatter+ lediglich bei der Basisklasse \cls{scrbook}.
Auf Wunsch wurden diese Makros auch bei \cls{scrartcl} und \cls{scrreprt} als Basis bereitgestellt.

Somit ist es mÃ¶glich, fÃ¼r den Vorspann auf rÃ¶mische Ziffern zu wechseln. Ab \verb+\mainmatter+ werden dann arabische Ziffern verwendet.


\subsection{Mathematikschriften}
Da es keine Compiler-unanbhÃ¤ngige, universelle Mathematikschrift gibt und die Corporate Design Richtlinien auch keinerlei Empfehlung berÃ¼cksichtigen, wurden hierfÃ¼r einige mÃ¶gliche Varianten diskutiert. Die Voreinstallung entspricht immer dem Standard der Installation. Es werden keine spezifischen Einstellungen geladen.

Die Diskussion hierzu findet sich unter:\\
\url{https://github.com/tudace/tuda_latex_templates/issues/19}

Im Folgenden werden ein paar Beispielkonfigurationen gezeigt. GrundsÃ¤tzlich ist die Mathematikschriftart jedoch -- abgesehen durch EinschrÃ¤nkungen des Compilers -- frei wÃ¤hlbar.

Bei Auswahl und Verwendung ist hÃ¤ufig der \enquote{\TeX{} Font Catalogue hilfreich}: \url{https://tug.org/FontCatalogue/mathfonts.html}

\subsection{\hologo{pdfLaTeX}}
Hier existiert eine Variante, die die Buchstaben der Basisschriftart \enquote{Charter} mit Mathematiksymbolen aus unterschiedlichen ZeichensÃ¤tzen mÃ¶glichst passend kombiniert.

\begin{verbatim}
\usepackage[charter,expert]{mathdesign}
\end{verbatim}

Es gibt Ã¤hnliche AnsÃ¤tze fÃ¼r ein paar weitere Kombinationen. Einige Beispiele finden sich in der XCharter Dokumentation. \url{http://mirrors.ctan.org/fonts/xcharter/doc/xcharter-doc.pdf}


\section{Fachbereichsspezifische Anpassungen}
Einige Fachbereiche haben spezielle Anforderungen. Dieser Abschnitt betrachtet die speziellen Anpassungen. Bisher (Juli 2020) existieren diese Modifikationen lediglich fÃ¼r den Fachbereich Maschinenbau, der Mechanismus ist jedoch erweiterungsfÃ¤hig.


\subsection{Fachbereich Maschinenbau}
Der entsprechende Modus wird Ã¼ber die Option \code{department=mecheng} oder kurz \code{mecheng} aktiviert. Die Farbgebung passt sich dann automatisch an und die Trennlinie der FuÃŸzeile erhÃ¤lt die geforderte Form des Zeitstrahles. 

DarÃ¼ber hinaus erfordern manche Stellen dieses Fachbereichs die Ãœbergabe einer ID zu Kennzeichnung des Dokuments. HierfÃ¼r wurde der Mechanismus
\begin{verbatim}
\SetPaperID{&lt;Buchstabe&gt;}{&lt;tiefgestelle Nummer&gt;}}
\end{verbatim}
eingefÃ¼hrt.
Dieser funktioniert auch ohne die Aktivierung des \code{mecheng}-Modus, allerdings ergÃ¤nzt die Option einige zusÃ¤tzliche Parameter fÃ¼r angepasste AbstÃ¤nde.

DarÃ¼ber hinaus aktiviert der Modus die Optionen:
\code{colorback=false}, \code{ruledheaders=section}.

\minisec{Logo}
Das Fachbereichslogo wird Ã¼ber die Option \verb+departmentlogofile=tuda_maschinenbau_logo+ Ã¼bergeben. Ãœber diese Option kann auch eine abweichende Datei genutzt werden. Falls der Wert leer bleibt, wird kein Bild eingefÃ¼gt.

\minisec{Farbanpassungen}
Der Fachbereich untergliedert die im Corporate Design Handbuch beschriebenen Farben zusÃ¤tzlich. Daher existieren, wenn \code{mecheng} aktiviert wurde zusÃ¤tzlich die folgenden Farbnamen:

\begin{verbatim}
\colorlet{TUDa-Primary1}{TUDa-6b}
\colorlet{TUDa-Primary2}{TUDa-2d}
\colorlet{TUDa-Secondary1}{TUDa-9a}
\colorlet{TUDa-Secondary2}{TUDa-8a}
\colorlet{TUDa-Secondary3}{TUDa-6a}
\colorlet{TUDa-Secondary4}{TUDa-3a}
\colorlet{TUDa-Secondary5}{TUDa-4a}
\colorlet{TUDa-Secondary6}{TUDa-5a}
\colorlet{TUDa-Arrow}{TUDa-Primary2}
\end{verbatim}

\minisec{Zeitstrahl}
Des Design-Element des Zeitstrahls kann Ã¼ber das Makro \verb+\MechEngArrow{&lt;LÃ¤nge&gt;}+ erzeugt werden. Die Farbe entspricht dabei der Farbe \code{TUDaArrow}, die mit der zweiten PrimÃ¤rfarbe (blau) vorbelegt ist.

\section{Weitere KonfigurationsmÃ¶glichkeiten: Standard-KOMA-Script}
\label{sec:KOMA}
Da die Klasse bis auf ein paar erzwungene Einstellungen, die das Layout betreffen, vollstÃ¤ndig \KOMAScript"=kompatibel ist, ist fÃ¼r sÃ¤mtliche Modifikationen ein Blick in die \KOMAScript-Dokumentation hilfreich. FÃ¼r einen GroÃŸteil bietet \KOMAScript{} eine eigene LÃ¶sung, wodurch ErgÃ¤nzungspakete oft hinfÃ¤llig sind.

Beispiele fÃ¼r typische Modifikationen, die auch im Rahmen des Corporate Design zulÃ¤ssig sind:
\begin{itemize}
	\item Umstellung der Absatzkennzeichnungsmethode von Einzug auf Abstand (Klassenoption \verb+parskip+)
	\item Elementnummerierung mit oder ohne Endpunkt (Klassenoption \verb+numbers=enddot/noenddot+)
	\item Positionierung, Ausrichtung und AbstÃ¤nde bei captions (Die Makros \verb+\captionsabove+, \verb+\captionbelow+, \verb+\captionof+ und die Option \verb+captions+)
\end{itemize}



\section{Bekannte Probleme}

\subsection{\texorpdfstring{\hologo{XeLaTeX}}{XeLaTeX} und PDF/A}
Das Paket \pck{pdfx}, Ã¼ber welches die PDF/A KompatibilitÃ¤t erzeugt wird, hat nur einen begrenzten Support fÃ¼r \hologo{XeLaTeX}.
Es wird eine entsprechende Warnung erzeugt, allerdings kann es bei Ã¤lteren \hologo{XeLaTeX}-Versionen passieren, dass \pck{pdfx} bereits Fehlermeldungen erzeugt. Abhilfe wird in diesem Fall durch eine Compiler-Wechsel auf \hologo{LuaLaTeX} (welcher ohnehin empfohlen wird) oder durch Abschalten des PDF/A-Modus (\code{pdfa=false})  geschaffen.

\subsection{DVI-Ausgabe}
Aufgrund der Voreinstellung zur Erzeugung einer PDF/A-Datei ist es nicht mÃ¶glich TUDa-CI in Standardeinstellungen zur Erzeugung einer DVI-Datei zu nutzen. Ein GroÃŸteil der FunktionalitÃ¤t kann jedoch durch Deaktivierung der \code{pdfa}-Option genutzt werden.


\subsection{Geschachtelte Akzente (InkompatibilitÃ¤t zwischen pdfx und amsmath)}
Es ist nach aktuellem Paketstatus (v3.04) nicht mÃ¶glich beide Pakete in Kombination ohne weitere Anpassungen so zu verwenden, dass eine Schachtelung von Akzenten mÃ¶glich ist. Das folgende Beispiel wirft Fehler, sobald \pck{amsmath} direkt oder indirekt geladen wird.
\begin{verbatim}
$\dot{\hat{x}}$
\end{verbatim}

\noindent Die zugehÃ¶rige Diskussion findet sich im tuda-ci Repository (\url{https://github.com/tudace/tuda_latex_templates/issues/78}). Da sich diese Problematik nicht direkt aus tuda-ci sondern aus der Konstruktion der beiden Pakete untereinander ergibt, ist es leider nicht mÃ¶glich pauschal eine Anpassung in tuda-ci zu implementieren. Unter dem angegebenen Link findet sich jedoch ein mÃ¶glicher Workaround, sobald beide Varianten benÃ¶tigt werden.

\subsection{MÃ¶glicher Option Clash mit microtype}
Das Paket \pck{microtype} wird im Falle der Nutzung von \hologo{pdfLaTeX} oder einer erzwungenen Nutzung von Type1 Schriftarten automatisch geladen, da in der verwendeten Schriftart die Ligaturen fÃ¼r KapitÃ¤lchen deaktiviert werden mÃ¼ssen, um Probleme zu vermeiden (vgl. \url{https://github.com/tudace/tuda_latex_templates/issues/144}).

Falls es zwingend Notwendig ist die Type 1 Schriftart zu verwenden, ist es mÃ¶glich weitere Optionen vor dem Laden der Dokumentenklasse an \pck{microtype} zu Ã¼bergeben.

\begin{verbatim}
	\PassOptionsToPackage{&lt;microtype Optionen&gt;}{microtype}
	\documentclass{â€¦}
\end{verbatim}
\appendix
\printbibliography

\end{document}
</pre></body></html>