xerif

h1. Titelei

Titeleiinformationen werden innerhalb von <pre>\begin{tpMeta}

  …

\end{tpMeta}</pre>angegeben, und zwar _vor_ @\begin{document}@. Deren Ausgabe ist optional und erfolgt mittels<pre>\tpMaketitle</pre>_nach_ @\begin{document}@. 

Auch ohne ausgegebene Titelei ist die @tpMeta@-Umgebung so weit möglich zu füllen, damit die Metadaten des Werkes ins PDF geschrieben werden können.

* Die folgenden Makros dürfen nur einmalig verwendet werden, sonst wird nur das letzte ausgewertet. Ausnahmen bilden die Umgebungen für die Autoren, Herausgeber, Reihenherausgeber und \tpFunding. 

* Zeilenumbrüche bitte mit @\tpBreak@ realisieren.

h2. Personen

h3. Generelle Auszeichnung

Jede am Werk beteiligte Person bekommt eine eigene Umgebung, abhängig von ihrer Art der Beteiligung:

|_. Umgebung |_. Bedeutung |

| @tpAuthor@ | Autor/-in (Monographien) |

| @tpEditor@ | Herausgeber/-in (Anthologien) |

| @tpSeriesEditor@ | Reihenherausgeber/-in |

Darin werden die (verfügbaren) Autoreninformationen kodiert:

|_. Makro |_. Bedeutung |

| @\tpFullName{…}@ | kompletter Name als einfache Zeichenkette _(gleichzeitig Override)_ |

| @\tpCiteName{…}@| beim Zitieren verwendeter Name |

| @\tpShortCiteName{…}@ | beim Zitieren verwendeter Kurzname |

| @\tpPDFInfoName{…}@ | in den PDF-Metadaten angegebener Name |

| @\tpInitial{…}@ | Initialen |

| @\tpLastName{…}@ | Nachname |

| @\tpFirstName{…}@ | Vorname |

| @\tpMidName{…}@ | Mittelname(n) |

| @\tpHonorific{…}@| Titel (Dr., Prof. etc.) |

| @\tpLineage{…}@| Abstammungsvermerk (Sr., Jr.) |

| @\tpORCID{…}@| Open Researcher and Contributor ID |

| @\tpAffilRef{…}@| Referenznummer des separaten @tpAffil@-Blocks |

| @\tpAffiliation{…}@| Direktnennung der Institutionszugehörigkeit; Alternative zur @\tpAffilRef{…}@-Verwendung |

| @\tpEmail{…}@| E-Mail-Adresse |

| @\tpCorrespondenceAs{…}@| Korrespondenzadresse |

Z. B.<pre>\begin{tpAuthor}

  \tpFirstName{Maxi}

  \tpLastName{Musterfrau}

  \tpEmail{maxi.musterfrau@example.org}

  \tpAffilRef{1}

\end{tpAuthor}

\begin{tpAffil}

  \tpAffilID{1}

  \tpAffiliation{Universität Musterstadt}

\end{tpAffil}</pre>

h3. Overrides

h4. Einzelne Namen

Separat ausgezeichnete Namensbestandteile werden (je nach Verlag unterschiedlich) zusammengesetzt und in der Komponente @\tpFullName@ gespeichert. Diese kann auch direkt belegt werden und dient damit als Override für die Ausgabe _einzelner_ Namen.

h4. Namenslisten

Aus den jeweiligen Einzelnamen werden Namenslisten generiert, die in der Titelei ausgegeben werden. Diese können bei Bedarf in der @tpMeta@-Umgebung überdefiniert werden:<pre>\tpAuthorNameList{<Override>}

\tpEditorNameList{<Override>}

\tpSeriesEditorNameList{<Override>}

</pre>z.B. würde<pre>\begin{tpEditor}

  \tpFullName{Ursula Renner}

\end{tpEditor}

\begin{tpEditor}

  \tpFullName{Maxi Musterfrau}

\end{tpEditor}</pre>die Ausgabe _Ursula Renner and Maxi Musterfrau (Eds.)_ erzeugen, was sich mittels<pre>\tpEditorNameList{Renner \& Musterfrau}</pre>zu _Renner & Musterfrau (Eds.)_ abändern lässt. 

Die Herausgeberergänzung _(Ed./Eds.)_ wird ggf. verlagsstyleseitig erzeugt und bei Herausgebern an die generierte oder manuell gesetzte @\tpEditorNameList@ gehängt. Um dieses Verhalten temporär zu ändern, können die Properties @editor-suffix-sgl@ (Singular) und @editor-suffix-pl@ (Plural) lokal überdefiniert werden:<pre>\tpSetProperty{editor-suffix-sgl}{…}</pre>

h2. Institutionszugehörigkeiten (Affiliations) 

Wie im Abschnitt "Generelle Auszeichnung":https://redmine.le-tex.de/projects/transpect-typesetter/wiki/Titelei/edit#Generelle-Auszeichnung angerissen, können Institutionszugehörigkeiten entweder als Direktzuordnungen (1) über ein Makro innerhalb von @tpAuthor@, @tpEditor@ oder @tpSeriesEditor@ oder aber durch Referenz auf einen @tpAffil@-Block (2) erfolgen.

# <pre>\begin{tpAuthor}

  \tpFirstName{Maxi}

  \tpLastName{Musterfrau}

  \tpEmail{maxi.musterfrau@example.org}

  \tpAffiliation{Universität Musterstadt}

\end{tpAuthor}</pre>

# <pre>\begin{tpAuthor}

  \tpFirstName{Maxi}

  \tpLastName{Musterfrau}

  \tpEmail{maxi.musterfrau@example.org}

  \tpAffilRef{1}

\end{tpAuthor}

\begin{tpAffil}

  \tpAffilID{1}

  \tpAffiliation{Universität Musterstadt}

\end{tpAffil}</pre>

h2. Förderungen, Stipendien, Sponsoring

Sponsoren werden innerhalb der @tpMeta@-Umgebung in separate @tpFundingBlock@-Umgebungen gepackt. Darin wiederum werden die Informationen zu den Förderungen einzeln ausgezeichnet:

|_. Makro |_. Bedeutung |

| @\tpFundName{}@ | Kompletter Name als einfache Zeichenkette |

| @\tpFundLogo{}@ | Pfad zum Fördererlogo |

| @\tpFundID{}@ | ID der Förderung |

Darüber hinaus gibt es noch zwei sponsorenbezogene Makros, die direkt in @tpMeta@ stehen müssen:

|_. Makro |_. Bedeutung |

| @\tpFundingPreText{}@ | Text, der _über_ dem Funding-Block ausgegeben wird |

| @\tpFundingPostText{}@ | Text, der _unter_ dem Funding-Block ausgegeben wird |

Beispiel:<pre>\begin{tpMeta}

  …

  \tpFundingPreText{Dieses Buch wurde ermöglicht durch:}

  \tpFundingPostText{Tolle Leute!}

  \begin{tpFunding}

    \tpFundName{DfG Projekt xyz}

    \tpFundLogo{dfg.png}

  \end{tpFunding}

  \begin{tpFunding}

    \tpFundName{Stiftung 2}

    \tpFundLogo{grant2.png}

  \end{tpFunding}

  …

\end{tpMeta}</pre>

h2. einfache Metadaten

|_. Makro |_. Bedeutung |

|_\2. Titelbild |

| @\tpCover{}@ | Pfad zum Titelbild |

|_\2. Titelinformationen |

| @\tpTitle{…}@ | Buchtitel |

| @\tpShortTitle{…}@ | Gekürzter Buchtitel (z. B. für Kolumnentitel) |

| @\tpSubtitle{…}@ | Untertitel |

| @\tpRunTitle{…}@ | Kolumnentitel |

| @\AltTitle{…}@   | Alternativtitel (z. B. für Schmutztitel) |

| @\RunNames{…}@   | Kurznamensliste (z. B. für Kolumnentitel; für Autoren und Herausgeber nutzbar) |

| @\tpAltNames{…}@ | Alternativnamensliste (z. B. für Schmutztitel) |

|_\2. Reiheninformationen |

| @\tpSeries{…}@ | Reihentitel |

| @\tpSubSeries{…}@ | Reihenuntertitel |

| @\tpSeriesNote{…}@ | Reihenzusatzinformationen |

| @\tpVolume{…}@ | Band |

| @\tpNumber{…}@ | Reihennummer |

| @\tpEditorNameList{…}@ | Override für die Herausgebernamensliste |

| @\tpSeriesEditorNameList{…}@ | Override für die Reihenherausgebernamensliste |

|_\2. Verlagsinformationen |

| @\tpPublisher{…}@ | Verlagsname |

| @\tpPubDivision{…}@ | Verlagseinheit |

| @\tpPubDivInfo{…}@ | Info zur Verlagseinheit |

| @\tpPubLogo{…}@ | Pfad zum Verlagslogo |

| @\tpPubNote{…}@ | zusätzliche Verlagsangabe |

| @\tpPubPlace{…}@ | Verlagsort(e) |

| @\tpPubWeb{…}@ | Verlagshomepage |

|_\2. Veröffentlichungsmetadaten |

| @\tpPDFCreator{…}@ | Ersteller der PDF-Metadaten |

| @\tpPDFProducer{…}@ | Override für den PDF-Metadaten-Erzeuger (Fallbackzeichenkette: le-tex xerif) |

| @\tpDedication{…}@ | Widmung |

| @\tpAcknowledgements{…}@ | Danksagungen |

| @\tpStatement{…}@ | Erklärungen, z. B. Eigenständigkeitserklärung bei Masterarbeiten |

| @\tpEditionNote{…}@ | Auflagenhinweise |

| @\tpEditorial{…}@ | redaktioneller Beitrag |

| @\tpEdition{…}@ | Auflage |

| @\tpYear{…}@ | Veröffentlichungsjahr |

| @\tpISBNPreText{…}@ | dem ISBN-Block vorangestellter Text |

| @\tpDOI{…}@ | DOI |

| @\tpISBN{…}@ | Print-ISBN |

| @\tpEISBN{…}@ | E-Book-ISBN|

| @\tpEpubISBN{…}@ | Epub-ISBN |

| @\tpEpubPreText{…}@ | Text zwischen ISBN und eISBN |

| @\tpISSN{…}@ | ISSN|

| @\tpEISSN{…}@ | Ebook-ISSN|

| @\tpElibPDF{…}@ |  |

| @\tpBiblISSN{…}@ | Bibl-ISSN |

| @\tpBibleISSN{…}@ | Bibl-E-ISSN |

|_\2. Förderung |

| @\tpFundingPreText{…}@ | Text vor der Liste der Förderer |

| @\tpFundingPostText{…}@ | Text nach der Liste der Förderer | 

|_\2. Impressum |

| @\tpAdvertise{…}@ | Werbung |

| @\tpBiblio{…}@ | bibliographische Informationen |

| @\tpBiblioTitle{…}@ | Überschrift für die bibliographischen Informationen |

| @\tpPrint{…}@ | Druck |

| @\tpPrintNote{…}@ | Druckhinweis, z. B. »auf Papier XY gedruckt« |

| @\tpLectorate{…}@ | Lektorat |

| @\tpTranslator{…}@ | Übersetzer |

| @\tpCoverConcept{…}@ | Titelbildkonzept |

| @\tpCoverDesign{…}@ | Titelbildgestaltung |

| @\tpCoverImage{…}@ | Titelbildillustrator/-photograph |

| @\tpTypesetter{…}@ | Satz |

| @\tpQA{…}@ | Qualitätssicherung |

| @\tpUsedFont{…}@ | verwendete Schriften |

| @\tpEnvDisclaimer{…}@ | Umweltschutzerklärungen |

|_\2. Contributor Meta|

| @\tpLectorate{}@ | Lektorat |

| @\tpTranslator{}@ | Übersetzerin |

| @\tpQA{}@ | Korrektorat, Copy-Editing, Qualitätssicherung |

| @\tpCoverConcept{}@ | Umschlagkonzept |

| @\tpCoverDesign{}@ | Umschlaggestaltung |

| @\tpCoverImage{}@ | Umschlagbild |

| @\tpUsedFont{}@ | Verwendete Schrift(-en), z.B. "Gesetzt mit Garamond" |

| @\tpTypesetter{}@ | Satz |

| @\tpPrint{}@ | Druckerei |

| @\tpConversion{}@ | Konverter, z.B. xerif |

|_\2. Licencing|

| @\tpCopyrightDisclaimer{}@ | Copyright-Disclaimer. Z.B.: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Jede Verwertung… |

| @\tpCopyright{}@ | Copyright Beschreibung. Z.B.: Copyright © 2022. Alle Rechte bei XY Verlag |

| @\tpLicenceLogo{}@ | Lizenzlogo |

| @\tpLicenceText{}@ | Lizenzbeschreibung |

| @\tpLicenceLink{}@ | URL zur Lizenz |

| @\tpLicenceName{}@ | Lizenz-Name, z.B. "CC BY 3.0 DE" |

|_\2. PDF-Metadaten |

| @\tpPDFProducer{}@ | PDF-Creator (Wenn leer wird das aus @\tpPublisher@ und, wenn vorhanden, @\tpPubPlace@ zusammengesetzt)|

| @\tpPDFCreator{}@ |  PDF-Producer (Default-Wert: "@le-tex transpect@") |

|_\2. Overrides |

| @\tpAuthorNameList{}@ | Generierte Namensliste bzw. Override für Autorinnen |

| @\tpEditorNameList{}@ | Generierte Namensliste bzw. Override für Herausgeberinnen |

| @\tpSeriesEditorNameList{}@ | Generierte Namensliste bzw. Override für Reihenherausgeberinnen |

| @\tpRunTitle{}@ | Bei Bedarf, Kolumnentitel-Override für den gekürzten Buchtitel (@\tpShortTitle@!)  |

| @\tpRunNames{}@ | Bei Bedarf, Kolumnentitel-Override für Namen  |

|_\2. Journal-spezifisch |

| @\tpJournalName{}@ | Voller Name des Journals |

| @\tpJournalAbbrev{}@ | Kurzname des Journals |

| @\tpIssue{}@ | Ausgabe |

|_\2. Sonstiges |

| @\tpAddNoteI{}@ | Zusatzinformationen beliebigen Inhalts für Titeleiseite I |

| @\tpAddNoteII{}@ | Zusatzinformationen beliebigen Inhalts für Titeleiseite II |

| @\tpAddNoteIII{}@ | Zusatzinformationen beliebigen Inhalts für Titeleiseite III |

| @\tpAddNoteIV{}@ | Zusatzinformationen beliebigen Inhalts für Titeleiseite IV |

h2. Beispiel

WBG

<pre>\usepackage[<options>]{wbg}

...

\begin{tpMeta}

  \tpTitle{Die anderen Gurlitts}

  \tpSubtitle{Unterwegs zu einer Familiengeschichte}

  \begin{tpEditor}

    \tpFullName{Ursula Renner}

  \end{tpEditor}

  \tpISBN{ISBN 9783534404650}

  \tpEISBN{eBook (PDF): 9783534404674}

  \tpEpubPreText{Elektronisch sind folgende Ausgaben erhältlich:}

  \tpPublisher{wbg (Wissenschaftliche Buchgesellschaft)}

  \tpPubDivision{wbg Academic}

  \tpPubDivInfo{wbg Academic ist ein imprint der wbg}

  \tpPubNote{Die Herausgabe des Werkes wurde durch die\\

    Vereinsmitglieder der wbg ermöglicht.}

  \tpPubWeb{Besuchen Sie uns im Internet: www.wbg-wissenverbindet.de}

  \tpPubPlace{Darmstadt}

  \tpPrintNote{Printed in Germany}

  \tpYear{2021}

  \tpEnvDisclaimer{Gedruckt auf säurefreiem und\\alterungsbeständigem Papier.}

  \tpBiblio{Die Deutsche Nationalbibliothek verzeichnet diese Publikation\\

    in der Deutschen Nationalbibliografie; detaillierte bibliografische\\

    Daten sind im Internet über \url{http://dnb.d-nb.de} abrufbar.}

\end{tpMeta}

...

\begin{document}

\tpMaketitle

\tableofcontents

...

</pre>