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
122
123
124
125
126
127
128
129
130
131
132
133
|
%%
%% 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-2023 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}[2023/07/01 v1.2 hep-title documentation]
\RequirePackage[l2tabu, orthodox]{nag}
\documentclass{ltxdoc}
\renewcommand\theCodelineNo{\rmfamily\tstyle\footnotesize\arabic{CodelineNo}}
\AtBeginEnvironment{macrocode}{\renewcommand{\ttdefault}{clmt}}
\renewcommand{\MacroFont}{\codestyle}
\AtBeginDocument{\DeleteShortVerb{\|}}
\AtBeginDocument{\MakeShortVerb{\"}}
\EnableCrossrefs
\CodelineIndex
\RecordChanges
\usepackage{hologo}
\usepackage[parskip,oldstyle,font=10pt]{hep-paper}
\bibliography{bibliography}
\acronym{PDF}{portable document format}
\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@tecnico.ulisboa.pt}}
\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}
If the \software{hyperref} package is loaded the \PDF meta information is set according to the "\title"\marg{text} and "\author"\marg{text} information.
\subsection{Title}
\DescribeMacro{\series}
\DescribeMacro{\title}
\DescribeMacro{\subtitle}
\DescribeMacro{\seriesfont}
\DescribeMacro{\titlefont}
\DescribeMacro{\subtitlefont}
The "\series"\marg{series} places a series title above the usual title generated via "\title"\marg{title}.
The "\subtitle"\marg{subtitle} macro places a subtitle below the usual title.
The fonts and their size can be adjusted using the "\seriesfont"\marg{font}, "\titlefont"\marg{font}, and "\subtitlefont"\marg{font} macros.
\subsection{Authors}
\DescribeMacro{\author}
\DescribeMacro{\authorfont}
\DescribeMacro{\email}
\DescribeMacro{\affiliation}
\DescribeMacro{\affiliationfont}
In order to facilitate multiple authors with different affiliations the \software{authblk} package \cite{authblk} is extended.
The author macro is extended to take a affiliation label "\author"\oarg{label}\marg{name}.
The affiliation macro takes the corresponding label "\affiliation"\oarg{label}\marg{institution}.
Additionally, the "\email{email}" macro places a link containing the email in typewrite font into a footnote.
The fonts can be adjusted using the "\authorfont"\marg{font} and "\affiliationfont"\marg{font} macros.
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}
\DescribeMacro{\editor}
\DescribeMacro{\endorser}
\DescribeMacro{\editorfont}
\DescribeMacro{\endorserfont}
Additionally the "\editor"\oarg{label}\marg{name} and "\endorser"\oarg{label}\marg{name} macros are provided that act similar to the "\author"\oarg{label}\marg{name} macros but place their content in a dedicated line.
Their font can be adjusted by the "\editorfont"\marg{font} and "\endorserfont"\marg{font}.
\DescribeMacro{\editortitle}
\DescribeMacro{\endorsertitle}
\DescribeMacro{\editortitlefont}
\DescribeMacro{\endorsertitlefont}
The titles of these lines can be adjusted using the "\editortitle"\marg{singluar}\marg{plural} and "\endorsertitle"\marg{singluar}\marg{plural} macros.
Their font can be adjust with the "\editortitlefont"\marg{font} and "\endorsertitlefont"\allowbreak\marg{font}.
\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'.
|