Überschriften » Historie » Revision 10
Revision 9 (Patrick Schulz, 21.07.2021 14:00) → Revision 10/25 (Patrick Schulz, 21.07.2021 14:00)
h1. Überschriften
h2. Überschriften im *transpect-tex Common Framework* ("transpect-headings.dtx":https://gitlab.le-tex.de/transpect-tex/transpect-tex/-/blob/master/src/transpect-headings.dtx)
<pre><code class="text">
\begin{heading}[<opt>]{<level>}
%% Eigentliche ÜS:
\tpTitle{…}
\tpAuthor{…}
\tpSubtitle{…}
\tpNumber{…}
\tpQuote{…}
\tpQuoteSource{…}
%% Overrides für ToC-Entries:
\tpTocTitle{…}
\tpTocAuthor{…}
\tpTocSubtitle{…}
\tpTocNumber{…}
%% Overrides für Kolumnentitel:
\tpTRunTitle{…}
\tpRunAuthor{…}
\tpRunSubtitle{…}
\tpRunNumber{…}
\end{heading}
</code></pre>
* @<level>@ ist der Name der ÜS-Ebene, z.B. chapter, section, subsubsection…
* @<opt>@ optionale Parameter für einzelne ÜSen. Wenn es keine gibt, eckige Klammern weglassen!
** @notoc@: ÜS erzeugt keinen Eintrag im IHV
* Notwendig ist nur @\tpTitle{}@; der Rest optional
* @\tpAuthor{}@ ist der Abschnitts-/Kapitelautor
* @\tpSubtitle{}@ ist der Untertitel
* @\tpNumber{}@ ist der ÜS-Zähler samt Präfix (z.B. "Kapitel 2", "2.1.2.3", "Anhang A", etc.)
* @\tpQuote{}@ ist ein Zitat
* @\tpQuoteSource{}@ die Quelle dazu
* Mit v0.100 können ÜSen auch automatisiert autmatisiert gezählt werden. Ist @\tpNumber@ gesetzt, wird die interne Zählung überschrieben und das automatische Weiterzählen für diese ÜS Weiteruählen ausgesetzt.
In jedem Makro kann @\TitleBreak@ verwendet werden, was einen Zeilenumbruch an der Stelle erzeugt.
h2. Overrides für Inhaltsverzeichnisse und Kolumnentitel
*Zu den Makros @\tp<Makro>@ mit @<Makro> := (Author|Number|Subtitle|Title)@ gibt es je zwei Overrides: @\tpRun<Makro>@ und @\tpToc<Makro>@.
** Fehlt das Override, wird der Inhalt von @\tp<Makro>@ für Kolumnentitel bzw. IHV-Eintrag verwendet.
** Ist @\tp(Run|Toc)<Makro>{<Text>}@ gesetzt, wird @<text>@ statt der Inhalt von @\tp<Makro>@ verwendet.
** Ist @\tp(Run|Toc)<Makro>{}@ gesetzt (also mit leerem Argument!), wird die Ausgabe des <Makro> in Kolumnentitel/IHV unterdrückt.
Beispiel:
<pre>
\begin{heading}{chapter}
\tpTitle{Ein Text}
\tpAuthor{Max Musterfrau}
\tpTocAuthor{Max Mustertransfrau}
\tpRunTitle{Ein Alternativtext}
\tpRunAuthor{}
\end{heading}
</pre>würde als ÜS<pre>Max Musterfrau: Ein Text</pre> erzeugen. Als Toc-Eintrag würde<pre>Max Mustertransfrau: Ein Text</pre>ausgegeben, it dem Override für den Autorennamen. Als Kolumnentitel würde dann<pre>Ein Alternativtext</pre> ausgegeben. Der Autorenname wird im Kol-Titel unterdrückt, weil das Argument von @\tpRunAuthor@ in dem Fall leer ist.