xerif

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>}

  \title{…}

  \author{…}

  \subtitle{…}

  \number{…}

  \toctitle{…}

  \tocauthor{…}

  \runtitle{…}

  \quote{…}

  \quotesource{…}

\end{heading}

</code></pre>

* @<level>@ ist die Ü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

** @notocnumber@: Unterdrückt Ausgabe der ÜS-Nummerierung im IHV

* Notwendig ist nur @\title{}@; der Rest optional

* @\author{}@ ist der Abschnitts-/Kapitelautor

* @\subtitle{}@ ist der Untertitel

* @\number{}@ ist der ÜS-Zähler samt Präfix (z.B. "Kapitel 2", "2.1.2.3", "Anhang A", etc.)

* @\runtitle{}@ Ausgabe der ÜS im Kolumnentitel.

** Achtung: *Ob* die ÜS im Kolumnentitel erscheint, wird nach Verlagsvorgaben *styleseitig* festgelegt! Mit diesem Parameter lässt sich nur die Ausgabe überschreiben *falls* die ÜS in den Kolumnentitel geschrieben wird. 

** Fehlt die Angabe und die ÜS-Ebene erscheint im Koltitel, wird sie, je nach Style-Vorgaben, aus \title, \number und Autor zusammen gesetzt. 

** Wenn @\runtitle@ verwendet wird, wird der Kolumentitel genau so ausgegeben, wie er im Argument steht; es wird nichts automatisch ergänzt! 

** Wenn @\runtitle@ eine ÜS-Nummerierung enthält, so muss diese mittels @\protect\numberline{}@ ausgezeichnet werden.

** Nach @\numberline{}@ niemals ein Whitespace! Abstände zwischen Zähler und Titel kommen aus dem Style.

* @\toctitle{}@ ist der Eintrag im IHV. fehlt dieser, wird, je nach style-Vorgaben, der IHV-Eintrag aus \title, \number, \author, etc. zusammen gesetzt.

** Wie bei @\runtitle@ wird auch hier nichts generiert; 

** ÜS-Zähler müssen bei Bedarf konverterseitig via @\protect\numberline{}@ gesetzt werden.

* @\tocauthor{}@ Wenn laut style der Autorenname im IHV ausgegeben wird, kann dieser hiermit überschrieben werden

* @\quote{}@ Zitat unter ÜS

* @\quotesource{}@ Quelle des Zitats. Wird nur ausgewertet, wenn @\quote{}@ nicht leer ist / nicht fehlt.

* die heading-Umgebung beinhaltet nur die Überschrift und das, was unmittelbar dazughegört. Alles, was Text ist (also bspw. der Inhalt einer section), muss hinter die Umgebung

In jedem Makro kann @\TitleBreak@ verwendet werden, was einen Zeilenumbruch an der Stelle erzeugt.