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 |

*Beispiel*

<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. PDF-Metadaten |

| @\tpPDFCreator{…}@ | Ersteller der PDF-Metadaten (Standardwert: @\tpPublisher@ und, sofern vorhanden, mit Komma angeschlossenes @\tpPubPlace@) |

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

|_\2. Veröffentlichungsmetadaten |

| @\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. Lizenzierung |

| @\tpLicenceText{…}@ | Lizenzbeschreibung |

| @\tpLicenceLogo{…}@ | Lizenzlogo |

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

| @\tpLicenceName{…}@ | Lizenzname, z. B. »CC BY 3.0 DE« |

| @\tpCopyright{…}@ | Urheberrechtshinweis, z. B. »Copyright © 2022. Alle Rechte bei Verlag XY« |

| @\tpCopyrightDisclaimer{…}@ | Urheberrechtserklärung, z. B. »Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Jede Verwertung …« |

|_\2. Überschreibungen |

| @\tpAuthorNameList{…}@ | aus @tpAuthor@-Blöcken generierte Namensliste für Autoren bzw. Überschreibung dieser Liste mit dem übergebenen Inhalt |

| @\tpEditorNameList{…}@ | aus @tpEditor@-Blöcken generierte Namensliste für Herausgeber bzw. Überschreibung dieser Liste mit dem übergebenen Inhalt |

| @\tpSeriesEditorNameList{…}@ | aus @tpSeriesEditor@-Blöcken generierte Namensliste für Reihenherausgeber bzw. Überschreibung dieser Liste mit dem übergebenen Inhalt |

|_\2. zeitschriftenspezifisch |

| @\tpJournalName{}@ | voller Name der Zeitschrift |

| @\tpJournalAbbrev{}@ | Kurzname der Zeitschrift |

| @\tpIssue{}@ | Ausgabe |

| @\tpPubCycle{…}@ | Veröffentlichungszyklus |

| @\tpPrices{…}@ | Preise pro Exemplar und/oder Abonnementpreise/-modelle |

| @\tpMemberList{…}@ | Mitgliederliste bei Veröffentlichungen durch Organisationen |

|_\2. Einzelartikel |

| @\tpStartPage{…}@ | erste Artikelseite |

| @\tpEndPage{…}@ | letzte Artikelseite |

| @\tpCiteAs{…}@ | Zeichenketter, mit welcher bei Literaturangaben auf jenen Artikel verwiesen werden soll |

| @\tpSubmitted{…}@ | Vorlagedatum des Artikels |

| @\tpReceived{…}@ | Eingangsdatum des Artikels |

| @\tpRevised{…}@ | Überarbeitungsdatum des Artikels |

| @\tpReviewed{…}@ | Begutachtungs-/Prüfdatum des Artikels |

| @\tp{Accepted}{…}@ | Annahmedatum des Artikels |

| @\tpPublished{…}@ | Veröffentlichungsdatum des Artikels |

| @\tpCOIStatement{…}@ | Erklärung von (nicht vorhandenen) Interessenkonflikten |

|_\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

…

\end{document}

</pre>