Projekt

Allgemein

Profil

Template Styles » Historie » Revision 7

Revision 6 (Martin Kraetke, 21.12.2021 19:37) → Revision 7/19 (Martin Kraetke, 22.12.2021 12:35)

h1. Template Styles 

 {{toc}} 

 h2. Prefix 

 All style names contain a prefix that represents the publisher and is separated by an underscore. The table below shows only the style name without the prefix. The prefix is part of the customer-specific configuration. 

 Example: 
 * Prefix for publisher (1-3 characters): e.g. @ts@ for _transcript publishers_ 
 * Full style name for @heading_1@: @ts_heading_1@ 

 h2. Style Names 

 h3. Headings 

 The numbering of the headings is taken from the Word file, since authors sometimes use very heterogeneous numbering schemes. Therefore, one must watch out for numbering errors in the manuscript. The standard styles for headings from Word are also evaluated, whereby @Heading 1@ corresponds to the style @heading_part@, @Heading 2@ corresponds to @heading_1@ etc. 

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | book title | @book_title@ | Book title|    @\title{...}@ | 
 |\4=.                                               | 
 | part | @heading_part@ | Teil | \begin{heading}{part} | 
 |\4=.                                               | 
 | chapter | @heading_1@ | chapter, Überschrift 1. Ordnung    | \begin{heading}{chapter}... | 
 | chapter subheading | @subheading_1@ | subheading für chapter/Überschrift 2. Ordnung     | @\tpSubTitle{...}@ | 
 | chapter author | @author@ | chapter author | @\tpAuthor{...}@ | 
 | chapter author biography | @author_description@ | author biography included in a chapter | @\tpBio@ | 
 | chapter epigraph | @epigraph@, @epigraph@ | epigraph at chapter start | @\tpQuote{...}@ | 
 | chapter epigraph source | @epigraph_source@, @epigraph_source@ | source or author of epigraph |     | 
 |\4=.                                               | 
 | section 1. level | @heading_2@ | | @\begin{heading}{section}...@ | 
 | section 1. level subheading | @subheading_2@ | subheading | | 
 | section epigraph | @epigraph@ | section epigraph |    @\tpQuote{...}@ | 
 |\4=.                                               | 
 | section 2. level | @heading_3@ |    @\\begin{heading}{subsection}{...}@ | 
 | section 2. level subheading    | @subheading_3@ | subheading | | 
 |\4=.                                               | 
 | section 3. level | @heading_4@ | | @\begin{heading}{subsubsection}...@ | 
 | section 3. level subheading    | @subheading_4@ | subheading |    | 
 |\4=.                                               | 
 | section 4. level | @heading_5@ | | @\begin{heading}{paragraph}...@ | 
 | section 4. level subheading    | @subheading_5@ | subheading |    | 
 |\4=.                                               | 
 | bridgehead | @headword@ | bridgehead, not included in ToC | @\subparagraph{...}@ | 

 h3. Running Headers 

 Running headers are automatically generated depending on the layout and the customer-specific configuration. If individual or shortened running headers are required, the following style can be used after the part, chapter or section heading.  

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | running header short | @headline_short@ | override for automatically generated running header. | @\chaptermark{}@ | 

 h3. Figures 

 Figures must be placed in a separate paragraph with a specific paragraph style. There must not be text in the paragraph. For each additional image, a separate paragraph must be used. Figure captions and caption source must be set below the image in separate paragraphs. 

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | Figure | @figure@ | Figure | @\begin{tpFigure}[<options>] 
   \tpCaption{<caption>} 
   \tpSource{<Quelle>} 
   \tpLegend{<Legende>} 
   \tpNumber{<Nummer>} 
   \tpFig{\includegraphics[<optionen>]{<pfad>}} 
 \end{tpFigure}@ | 
 |_\4=. multiple figures with specific layouts | 
 | figure (layout A) | @figure_A${Zahl}@ | image with ${number} 1 to 3 images side by side column width | @\begin{tpFigure}[class=a]@    | 
 | figure (layout B) | @figure_B${Zahl}@ | image with ${number} 1 to 3 images side by side with margin | @\begin{tpFigure}[class=b]@ | 
 | figure (layout C) | @figure_C${Zahl}@ | image with ${number} 1 to 3 images side by side with more margin     | @\begin{tpFigure}[class=c]@ | 
 |\4=.                                               | 
 | caption | @figure_caption@ | caption or description of the image |     @\tpCaption{...}@ | 
 | caption source | @figure_source@ | information about creator, copyright or other content which is different from the caption |    @\tpSource{...}@ | 

 h3. Tables 

 Tables are created with the Word default function. Table cell borders and background colors, row and column spans are kept for the output. For rotated tables, you need to apply a specific style. Tables can either be rotated or continued over several pages.  

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | Caption | @table_caption@ | Title or caption of the table |    |  
 | Source | @table_source@ | Additional information that is placed below the table |    |   
 | rotated table | @table_rotated@ | style needs to be applied on the paragraph before the table |    |   
 | continued table | @table_pagewrap@ | style needs to be applied on the paragraph before the table |    |   

 h3. Lists 

 Simple and numbered lists are heuristically detected by list marker and indent. Description lists like lists of abbreviations have a specific style. Description lists require that a single tab is placed between definition term and description. 

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | description list | @abbreviations@ | list of abbreviations |    @\begin{description} \item[begriff] ... \end{description}@    | 

 h3. Long Quotations 

 Several consecutive citation paragraphs are combined automatically in a long citation environment.  

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | citation | @quotation@ | citation wrapper |    @\begin{quotation}...\end{quotation}@    | 

 h3. Dialogues 

 Several consecutive paragraphs that contain the dialog style are combined in a dialog wrapper. The speaker is automatically identified using a tactical symbol, usually a colon. The paragraph must begin with the speaker name.  

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | dialog | @dialogue@ | Dialog-Absatz |     @\begin{dialogue}...\end{dialogue}@    | 
 | speaker | colon: after speaker | speaker |    @\item[speaker] ...@    | 

 h3. Boxes 

 The beginning and the end of a box are each marked with specific paragraph styles for start end. No other text should appear in this paragraph, since they are removed in the process. 

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | box with border start | @box_border_start@ | start marker of box with border | @\begin{kastenlinie}...@    | 
 | box with border end | @box_border_end@ | end marker of box with border | @...\end{kastenlinie}@    | 
 | box grey start | @box_grey_start@ | start marker of box with grey background | @\begin{kastengrau}...@    | 
 | box grey end | @box_grey_end@ | end marker of box with grey background    | @...\end{kastengrau}@    | 

 h3. Equations 

 Equations are automatically detected and converted to the proper markup. If you want to markup a simple text paragraph that may contain an equation as  

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | Equation paragraph | @formula@ | paragraph that contains equation | @\begin{equation}...\end{equation}@    | 

 h3. Dedication 

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | Dedication | @dedication@ | Dedication |    @\dedication@    | 

 h3. Letter 

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | Letter paragraph | @letter@ | paragraph of a letter | @\begin{letter}...\end{letter}@    | 
 | Letter paragraph with margin before | @letter_spacing@ | letter paragraph with margin before | @\item@    | 

 *Example:* before @\item@ and at the end there should be no @\\@ 

 |_. HUB-XML |<pre> 
 <div role="letter"> 
   <para role="letter">Dear John Doe</para> 
   <para role="letter_spacing">Here I am writing to you today</para> 
   <para role="letter">and hope this and that.</para> 
   <para role="letter">Give Jane my best regards.</para> 
 </div></pre> | 
 |_. TeX | <pre>\begin{letter} 
   Dear John Doe, 
 \item Here I am writing to you today \\ 
   and hope this and that.\\ 
   Give Jane my best regards. 
 \end{letter} 
 </pre> | 
 |_. PDF| <pre> 
   Dear John Doe, 

   Here I am writing to you today 
   and hope this and that. 
   Give Jane my best regards.</pre> | 

 h3. Bibliography Bibliografie 

 A bibliography consists of consecutive paragraphs with references to literature. The paragraphs must be marked with the same style. If there is a regular heading above, this is automatically set as the heading of the bibliography.  

 Eine Bibliografie besteht aus direkt aufeinanderfolgenden Absätzen mit Literaturreferenzen. Die Absätze müssen mit derselben Formatvorlage ausgezeichnet sein. Wenn darüber eine reguläre Überschrift steht, wird diese automatisch als Überschrift der Bibliografie gesetzt. 

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | literature Literatur | @literature@ | bibliographical reference Literaturreferenz    | @\bibitem@    | 

 

 h3. Index und Indexkodierung 

 Register können über folgende vier Wege erstellt werden, die auch kombiniert werden können. 

 h4. (1) Word-Indexfunktion 

 Im Word-Ribbon @Referenzen@ können für markierte Wörter Indexeinträge festgelegt werden. Dafür markiert man ein Word und klickt auf die Schaltfläche @Index markieren@. 

 h4. (2) Auszeichnung der Indexeinträge via Zeichenformat 

 Indexeinträge können festgelegt werden, indem Wörter oder Wortgruppen mit dem Format @index_mark@ ausgezeichnet werden. Indexeinträge die bereits mit der Word-Indexfunktion kodiert wurden, werden ignoriert. 

 h4. (3) Einfügen einer Konkordanzliste von Indexeinträgen 

 Indexeinträge können anhand einer Konkordanzliste automatisch kodiert werden. Dafür muss eine Liste von Indexeinträgen am Ende des Dokuments eingefügt werden. Überall wo im restlichen Dokument Wörter oder Wortgruppen aus dieser Liste gefunden werden, wird automatisch ein Index entry kodiert. Dafür muss ein Index entry mit dem Absatzformat @index_list@ verwendet werden. Jeder Eintrag muss in einem separaten Absatz stehen. Indexeinträge die bereits mit der Word-Indexfunktion oder via Zeichenformat @index@ kodiert wurden, werden ignoriert. 

 h4. (4) Einfügen eines statischen Index 

 Sollen nicht automatisch im Text Fundstellen für Einträge im Index gesucht werden, kann man auch einen statischen Index einfügen. Dafür zeichnet man einfach eine Liste mit Indexeinträgen mit dem Format @index_static@ aus. Seitenzahlen in der Form @Eintrag 144, 156, 192@ werden dann nur mit der Seite verknüpft, d.h. hier muss man selbst dafür Sorge tragen, dass die Seitenreferenz auch richtig ist! 

 h4. Formatvorlagen 

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | Registerüberschrift | @index_heading@ | Überschrift des Registers     | | 
 | Index entry, siehe (2) | @index_mark@ | Zeichenformat zur Kodierung von Indexeinträgen |    |  
 | Index entry, siehe (3) | @index_list@ | Absatzformat, ein Absatz repräsentiert einen Index entry aus der Konkordanzliste |    |  
 | Index entry Suchbegriff | @index_name@ | Zeichenformat, muss innerhalb von @index_list@ verwendet werden um den Index-Suchbegriff separat auszuzeichnen, z.B. kann bei _Max Mustermann_ das _Mustermann_ ausgezeichnet werden, damit auch bei _Herr Mustermann_ Index entry erstellt wird |    |  
 | Index entry, siehe (4) | @index_static@ | Statischer Index entry. Seitenzahlen im Eintrag werden mit der Seitenzahl verlinkt. |    | 

 h3. Verzeichnisse 

 Es muss nur die Überschrift gesetzt werden. An dieser Stelle wird der Inhalt des Verzeichnisses automatisch ausgegeben. 

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | Abbildungsverzeichnis | @list_of_figures@ | Überschrift des Abbildungsverzeichnis    | @\listoffigures@    | 
 | Tabellenverzeichnis | @list_of_figures@ | Überschrift des Tabellenverzeichnis | @\listoftables@    | 
 | Endnotenverzeichnis | @list_of_endnotes@ | Überschrift des Endnotenverzeichnis    | @\printnotes@    | 

 h3. Zeilenumbrüche 

 Leere Absätze werden automatisch entfernt. Für die Steuerung der Anzahl der Zeilenumbrüche sollte man daher leere Absätze mit dem Format @lineskip@ auszeichnen, wobei man die Anzahl der gewünschten Umbrüche am Ende des Formatnamens angibt, z.B. @lineskip3@ für 3 Umbrüche. Ein normaler Umbruch (Shift+Enter) wird zu einem @\newline@. 

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 | Zeilenumbruch | @lineskip@ |    |    @\vskip 1\baselineskip@    | 

 h3. Zeichenformate 

 |_. Common Name |_. Style Name |_. Description |_. TeX | 
 |    | @nonlatin@ | Text der keine lateinischen Zeichen enthält |     @\unichar@    | 
 | Regular | @regular@ | Steilgestellter Text |      | 
 | Halbfett | @bold@ | Halbfetter Text |     @\textbf@ | 
 | Kursiv | @italic@ | Kursiver Text |     @\textit@    | 
 | Kapitälchen | @smallcaps@ | Kapitälchen |     @\textsc@    | 
 | Nicht umbrechender Leerraum | @space_nonbreaking@ |    |       | 
 | Schmales Leerzeichen | @space_thin@ |    |       | 
 | Gesperrt | @spaced@ | gesperrter Text |     @\so@    | 
 | Unterstrichen | @underline@ | unterstrichener Text |      @\ul@ | 
 | Durchgestrichen | @strike_trough@ | durchgestrichener Text    |     @\st@    | 
 | Hochgestellt | @superscript@ | wird via Mathmode automatisch erstellt |      @\textsuperscript@ | 
 | Tiefgestellt | @subscript@ | wird via Mathmode automatisch erstellt |     @\textsubscript@ |