summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/hep-title/hep-title-documentation.tex
blob: 0405ab5537980449b9258a356828943652539e25 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
%%
%% This is file `hep-title-documentation.tex',
%% generated with the docstrip utility.
%%
%% The original source files were:
%%
%% hep-title-implementation.dtx  (with options: `documentation')
%% This is a generated file.
%% Copyright (C) 2019-2020 by Jan Hajer
%% This file may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either
%% version 1.3c of this license or (at your option) any later
%% version. The latest version of this license is in:
%% http://www.latex-project.org/lppl.txt
%% and version 1.3c or later is part of all distributions of
%% LaTeX version 2005/12/01 or later.

\ProvidesFile{hep-title-documentation.tex}[2021/09/01 v1.0 hep-title documentation]

\RequirePackage[l2tabu, orthodox]{nag}

\documentclass{ltxdoc}
\AtBeginDocument{\DeleteShortVerb{\|}}
\AtBeginDocument{\MakeShortVerb{\"}}

\EnableCrossrefs
\CodelineIndex
\RecordChanges

\usepackage[parskip]{hep-paper}

\bibliography{bibliography}

\acronym{PDF}{portable document format}

\usepackage{hologo}

\MacroIndent=1.5em
\AtBeginEnvironment{macrocode}{\renewcommand{\ttdefault}{clmt}}


\GetFileInfo{hep-title.sty}

\title{The \software{hep-title} package\thanks{This document corresponds to \software{hep-title}~\fileversion.}}
\subtitle{Extensions for the title page}
\author{Jan Hajer \email{jan.hajer@unibas.ch}}
\date{\filedate}

\begin{document}

\newgeometry{vscale=.8, vmarginratio=3:4, includeheadfoot, left=11em, marginparwidth=4.6cm, marginparsep=3mm, right=7em}

\maketitle

\begin{abstract}
The \software{hep-title} package extends the title macros of the standard classes with macros for a preprint, affiliation, editors, and endorsers.
\end{abstract}

To use the \software{hep-title} package include it with "\usepackage{hep-title}".

Most macros are intended for the use in the preamble.
They are implemented using the \software{titling} \cite{titling} and \software{authblk} \cite{authblk} packages.

\section{Macros}

\subsection{Title}

\DescribeMacro{\series}
\DescribeMacro{\title}
\DescribeMacro{\subtitle}
\DescribeMacro{\seriesfont}
\DescribeMacro{\titlefont}
\DescribeMacro{\subtitlefont}
The PDF meta information is set according to the "\title"\marg{text} and "\author"\marg{text} information.
The "\series"\marg{series} places a series title above the usual title.
The "\subtitle"\marg{subtitle} macro places a subtitle below the usual title.
The fonts and their size can be adjusted using the "\seriesfont", "\titlefont", and "\subtitlefont" macros.

\subsection{Authors}

\DescribeMacro{\author}
\DescribeMacro{\affiliation}
\DescribeMacro{\editor}
\DescribeMacro{\endorser}
\DescribeMacro{\email}
\DescribeMacro{\authorfont}
\DescribeMacro{\editorfont}
\DescribeMacro{\endorserfont}
\DescribeMacro{\affiliationfont}
In order to facilitate multiple authors with different affiliations the \software{authblk} package \cite{authblk} is extended.
The following lines add \eg two authors with different affiliations
\begin{verbatim}
\author[affil1]{Author one \email{email one}}
\affiliation[affil1]{Affiliation one}
\author[affil2]{Author two \email{email two}}
\affiliation[affil1,affil2]{Affiliation two}
\end{verbatim}
Additionally the "\editor" and "\endorser" macros are provided.

\subsection{Abstract}

\DescribeEnv{abstract}
\DescribeEnv{abstract*}
The "abstract" environment is adjusted to not start with an indentation.
The "abstract*" environment takes care of placing the title as well.
This is used in "twocolumn" documents if the abstract should span both columns.

\subsection{Preprint}

\DescribeMacro{\preprint}
\DescribeMacro{\preprintfont}
The "\preprint"\marg{numer} macro places a pre-print number in the upper right corner of the title page.
The "\preprintfont" macro can be used to change the font of the preprint.

\printbibliography

\end{document}

\endinput
%%
%% End of file `hep-title-documentation.tex'.