From ae1595e70ec857979e8df0080450ac8d8627dc0c Mon Sep 17 00:00:00 2001
From: Karl Berry <karl@freefriends.org>
Date: Sun, 11 Oct 2020 21:36:29 +0000
Subject: tuda-ci

git-svn-id: svn://tug.org/texlive/trunk@56638 c570f23f-e606-0410-a88d-b1316a301751
---
 .../texmf-dist/doc/latex/tuda-ci/DEMO-TUDaPub.tex  | 74 +++++++++++++++++++---
 1 file changed, 65 insertions(+), 9 deletions(-)

(limited to 'Master/texmf-dist/doc/latex/tuda-ci/DEMO-TUDaPub.tex')

diff --git a/Master/texmf-dist/doc/latex/tuda-ci/DEMO-TUDaPub.tex b/Master/texmf-dist/doc/latex/tuda-ci/DEMO-TUDaPub.tex
index 9243152a37d..5d82cec48b3 100644
--- a/Master/texmf-dist/doc/latex/tuda-ci/DEMO-TUDaPub.tex
+++ b/Master/texmf-dist/doc/latex/tuda-ci/DEMO-TUDaPub.tex
@@ -1,4 +1,4 @@
-%% This is file `DEMO-TUDaPub.tex' version 3.03 (2020/09/19),
+%% This is file `DEMO-TUDaPub.tex' version 3.04 (2020/10/05),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -40,7 +40,7 @@
 	]{tudapub}
 
 \usepackage[english, main=ngerman]{babel}
-\usepackage[babel]{csquotes}
+\usepackage[autostyle]{csquotes}
 
 \usepackage{biblatex}
 \bibliography{DEMO-TUDaBibliography}
@@ -278,10 +278,47 @@ Der Prüfmechanismus ist auf Wunsch der Bibliothek standardmäßig aktiviert, ka
 
 
 \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}, die für dieses Dokument aktiviert wurde.
+
+Bei Verwendung einer Bindekorrektur 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.
+
+Die Option \code{custommargins} verfügt ab Version 1.10 auch über den Wert \code{geometry}. Damit können die Ränder auch durch einen Aufruf von \code{\textbackslash{}geometry} vor Beginn des Dokuments manuell angepasst werden.
+
+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,
+		<Eigene Anpassungen>
+	}
+\end{verbatim}
+Die gilt insbesondere für die Optionen \code{includehead}, \code{includefoot} und \code{includemp}.
+
+Diese Variante wird auf Wunsch zur Verfügung gestellt, allerdings wird darauf hingewiesen, dass manuelle Randeinstellungen oft nicht zu einem harmonischen Satzspiegel führen.
+
+Auch ist das Standard-Layout der Kolumnentitel wenig vorteilhaft, da die Kolumnentitel damit local größer sein können als die eigentliche Überschrift.
+
+
+Dadurch werden die Ränder nicht fest definiert, sondern auf Basis des typearea-Paketes optimiert.
+
+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.
+
+
+Darüber hinaus kann über
+\begin{verbatim}
+	\pagestyle{TUDa.headings}
+\end{verbatim}
+ein einfacherer Seitenstil ausgewählt werden, der die Nutzung mit lebenden Kolumnentitel erheblich vereinfacht.
+
+
+
 \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.
@@ -347,25 +384,44 @@ Der Fachbereich untergliedert die im Corporate Design Handbuch beschriebenen Far
 \minisec{Zeitstrahl}
 Des Design-Element des Zeitstrahls kann über das Makro \verb+\MechEngArrow{<Länge>}+ erzeugt werden. Die Farbe entspricht dabei der Farbe \code{TUDaArrow}, die mit der zweiten Primärfarbe (blau) vorbelegt ist.
 
-\section{Standard-KOMA-Script}
+\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 parskip)
-	\item Elementnummerierung mit oder ohne Endpunkt
-	\item Positionierung, Ausrichtung und Abstände bei captions.
+	\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}
 
-\printbibliography
 
 
-\section{Bekannte Inkompatibilitäten}
+\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. Diese werden vor der Überprüfung auf das Paketalter ausgegeben. Das Paket muss geladen worden sein, bevor die Überprüfung auf Alter möglich ist.
+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 Sbschalten des PDF/A-Modus (\code{pdfa=false})  geschaffen.
+
 
+\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 microtype wird im Falle der Nutzung von \hologo{pdfLaTeX} oder einer erzwungenden 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{<microtype Optionen>}{microtype}
+	\documentclass{…}
+\end{verbatim}
+\appendix
+\printbibliography
 
 \end{document}
-- 
cgit v1.2.3

