xerif

Wiki »

Überschriften » Historie » Revision 9

Revision 8 (Patrick Schulz, 01.07.2021 11:43) → Revision 9/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 autmatisiert gezählt werden. Ist @\tpNumber@ gesetzt, wird die interne Zählung überschrieben und das automatische 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.