xerif

h1. Title Pages

Should be included in @tpMeta@ environment before  @\begin{document}@.

<pre>\begin{tpMeta}

  ...

\end{tpMeta}</pre> 

The actual title pages are generated with @\tpMaketitle@ _after_ @\begin{document}@.

h2. Persons

h3. General Markup

All names are placed in their respective environment. 

|_. Environment |_. Description |

| @tpAuthor@ | Author (monographies) |

| @tpEditor@ | Editor (collections) |

| @tpSeriesEditor@ | Series editor |

The person metadata is encoded with the following instructions:

|_. Command |_. Description |

| @\tpFullName{}@ | used for the full names, overrides the other name commands below  |

| @\tpSurName{}@ | surname |

| @\tpFirstName{}@ | first name |

| @\tpMidName{}@ | middle name |

| @\tpAffilID{}@ | affiliation identifier |

| @\tpMail{}@ | email address |

| @\tpBio{}@ | person biography |

Z.B.<pre>\begin{tpAuthor}[corresp]

  \tpFirstName{Jane}

  \tpSurName{Doe}

  \tpMail{jane.doe@example.org}

  \tpAffil{1}

\end{tpAuthor}</pre>

h3. Overrides

h4. Individual Names

Separately tagged parts of the name are combined (depending on the client configuration) and encoded with the @\tpFullName@ instruction. This can also be assigned directly and thus also serves as an override for the output of _individual_ names. 

h4. Name lists

Based upon the individual names, name lists are generated in the title pages. They can be overwritten within the @tpMeta@-environment:

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

This generates the text _Ursula Renner and Maxi Musterfrau (Eds.)_ which can be changed to _Renner & Musterfrau (Eds.)_ with the instruction below:

<pre>\tpEditorNameList{Renner \& Musterfrau}</pre>

The editor suffix _(Eds.)_ is generated by the publisher's style and is appended to both the generated name list and editor and series editor. If this behavior has to be changed individually, the complete information can be overwritten with the following instruction:

<pre>\tpEditorString{}

\tpSeriesEditorString{}

</pre>

h2. Affiliations 

TBD

h2. Generic Meta Blocks

For generic titlepage meta data there is a generic environment @tpGenericMeta@ that may occur multiple times within the tpMeta block: 

<pre>\begin{tpMeta}

…

  \begin{tpGenericMeta}

    \tpHeading{<title>}

    \tpContent{<Content>}

  \end{tpGenericMeta}

…

\end{tpMeta}</pre>

|_. Command |_. Description |

| @\tpHeading{}@ | title of the generic meta block (optional) |

| @\tpContent{}@ | contents of the generic meta block (mandatory) |

Generic meta blocks are all rendered in the same way and printed in the same order as the environment occurs within the @tpMeta@ block. 

h2. Funding Statement

Individual sponsors are combined into separate @tpFunding@ environments within the @tpMeta@ environment. The funding information is tagged individually: 

|_. Command |_. Description |

| @\tpFundName{}@ | complete name of the institution |

| @\tpFundLogo{}@ | path to the logo of the funding institution |

Additionally there are two funder-related instructions which need to be placed below @tpMeta@:

|_. Command |_. Description |

| @\tpFundingPreText{}@ | text before the funding statement |

| @\tpFundingPostText{}@ | text below the funding statement|

Example:

<pre>\begin{tpMeta}

  ...

  \tpFundingPreText{This book was sponsored by:}

  \tpFundingPostText{Further information about the project can be found at http://www.example.org}

  \begin{tpFunding}

    \tpFundName{Anytown Author Fund}

    \tpFundLogo{anytown-logo.png}

  \end{tpFunding}

  \begin{tpFunding}

    \tpFundName{Jane Doe Research Fund}

    \tpFundLogo{janedoe-logo.png}

  \end{tpFunding}

  ...

\end{tpMeta}</pre>

h2. General Metadata

|_. Command |_. Description |

|_\2. Titles|

| @\tpSubtitle{}@ | Subtitle |

| @\tpTitle{}@ | Regular book title |

| @\tpShortTitle{}@ | Short book title, used for running headers |

|_\2. Cover|

| @\tpCover{}@ | Path to cover image |

|_\2. Series|

| @\tpNumber{}@ | Series number |

| @\tpSeries{}@ | Series title |

| @\tpSubSeries{}@ | Series subtitle |

| @\tpVolume{}@ | Volume |

|_\2. Publisher|

| @\tpPublisher{}@ | Publisher name |

| @\tpPubDivision{}@ | Publisher imprint name |

| @\tpPubDivInfo{}@ | Publisher imprint information |

| @\tpPubLogo{}@ | Path to publisher logo |

| @\tpPubNote{}@ | Additional information about publisher |

| @\tpPubPlace{}@ | Publisher location |

| @\tpPubWeb{}@ | Publisher homepage |

|_\2. Publication Meta|

| @\tpDOI{}@ | DOI |

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

| @\tpEISBN{}@ | Ebook-ISBN|

| @\tpEpubISBN{}@ | EPUB-ISBN |

| @\tpEpubPreText{}@ | Text between ISBN and eISBN|

| @\tpISSN{}@ | ISSN|

| @\tpDedication{}@ | Dedication |

| @\tpAcknowledgements{}@ | note of thanks |

| @\tpEditorial{}@ | Editorial |

| @\tpEdition{}@ | Edition (e.g. "3rd revised edition") |

| @\tpEditionNote{}@ | Edition note (e.g. "Anniversary edition") |

| @\tpYear{}@ | Year of publication |

| @\tpStatement{}@ |  Publication statement |

| @\tpBiblio{}@ | Bibliographical information |

| @\tpPrintNote{}@ | Print note |

| @\tpEnvDisclaimer{}@ | Environmental note |

|_\2. Contributor Meta|

| @\tpLectorate{}@ | Lector |

| @\tpTranslator{}@ | Translater |

| @\tpQA{}@ | Correctorate, Copy-Editing |

| @\tpCoverDesign{}@ | Cover Art Name or Creator |

| @\tpCoverImage{}@ | Path to cover image |

| @\tpUsedFont{}@ | Main book font(s) |

| @\tpTypesetter{}@ | Typesetter |

| @\tpPrint{}@ | Printer |

| @\tpConversion{}@ | Converter |

|_\2. Licencing|

| @\tpCopyrightDisclaimer{}@ | Copyright-Disclaimer |

| @\tpCopyright{}@ | Copyright Text |

| @\tpLicenceLogo{}@ | License logo |

| @\tpLicenceText{}@ | License description |

| @\tpLicenceLink{}@ | License URL |

| @\tpLicenceName{}@ | License name, e.g. "CC BY 3.0 DE" |

|_\2. Overrides |

| @\tpAuthorNameList{}@ | Override for generated author name list |

| @\tpEditorNameList{}@ | Override for generated editor name list |

| @\tpEditorString{}@ | Override for editor suffix  |

| @\tpSeriesEditorNameList{}@ | Override for generated series editor list |

| @\tpSeriesEditorString{}@ | Override for series editor suffix   |

h2. Example

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>