Hep-Paper-Implementation.Pdf
Total Page:16
File Type:pdf, Size:1020Kb
Preprint-Number The HEP–PAPER package∗ Publications in high energy physics Jan Hajer† Department of Physics, University of Basel, Klingelbergstraße :4, 6278 Basel, Switzerland 4243/2:/23 Abstract The hep-paper package aims to provide a single style file containing most configurations and macros necessary to write appealing publications in High Energy Physics. Instead of reinventing the wheel by introducing newly created macros hep-paper preferably loads third party packages as long as they are lightweight enough. Contents 3 Introduction 5 3.3 Options . 5 4 Macros and environments 6 4.3 Title page . 7 4.4 Text.......................................... 7 4.5 Math.......................................... 9 4.6 Floats . ; 4.7 Bibliography . 32 5 Conclusion 32 ∗This document corresponds to hep-paper v3.:. †[email protected] 3 A Math alphabet allocation 34 B Options 38 B.3 Deactivation . 39 B.4 Compatibility . 39 B.5 Reactivation . 3: B.6 Process options . 3: B.7 Set compatibility . 3: C Font 42 C.3 Math fonts . 45 C.4 Font size . 49 D Text 49 D.3 Lists . 4: E Geometry 4; F Math 52 F.3 Operators . 54 F.4 Units and fractions . 54 F.5 Paired delimiters . 57 G Floats 5: G.3 Sub-floats . 5; G.4 Tables . 63 G.5 Figures . 63 H Title page 63 H.3 Preprint and title . 64 H.4 Authors and Editors . 66 H.5 Date and Abstract . 6: H.6 Thanks . 6; I Bibliography 6; I.3 Sourcemap . 73 I.4 Eprints . 75 J Hyperlinks, Footnotes and References 77 J.3 Footnotes . 77 J.4 References . 78 J.5 Citations . 79 K Acronyms 7: L Biblatex datamodel file 85 4 3 Introduction For usual publications it is enough to load additionally to the article class without optional arguments only the hep-paper package [3]. \documentclass{article} \usepackage{hep-paper} The most notable changes after loading the hep-paper package is the change of some LATEX defaults. The paper and font sizes are set to A6 and pt, respectively. Additionally, the paper geometry is adjusted using the geometry package [4]. Fur- thermore, the font is changed to latin modern (LM) using the cfr-lm package [5] with microtype [6] optimizations. Finally, portable document format (PDF) hy- hep-title perlinks are implemented with the hyperref package [7]. If only subset of the functionality is needed one of the smaller style files hep-title, hep-acronyms, and hep-bibliography hep-bibliography containing only the macros relevant to sections 4.3, 4.4.4, and 4.7, hep-acronyms respectively. 3.3 Options paper The paper=hformati option loads the specified paper format. The possible hformatsi are: a2, a3, a4, a5, a6, a7, a8, b2, b3, b4, b5, b6, b7, b8, c2, c3, c4, c5, c6, c7, c8, ansia, ansib, ansic, ansid, ansie, letter, executive, legal. The default is a6. font The font=hsizei option loads the specified font size. The possible hsizesi are: :pt, ;pt, 32pt, 33pt, 34pt, 36pt, 39pt, 42pt. The default is pt. lang The lang=hnamei option switches the document language to one of the values provided by the babel package [8]. The default is british. sansserif The sansserif option switches the document including math to sans serif font shape. oldstyle The oldstyle option activates the use of oldstyle text- (345) in favour of lining- () figures in text mode. parskip The parskip option changes how paragraphs are separated from each other using the parskip package [9]. The LATEX default is separation via indentation the parskip option switches to separation via vertical space.3 symbols The symbols=hfamilyi set the family of the symbol fonts. symbols=ams loads the two AMS fonts [:] and the bm bold fonts. The default symbols=true replaces additionally the blackboard font with the dsfont [;]. symbols=minion switches the symbol fonts to the Adobe MinionPro companion font from the MnSymbol package [32]. symbols=false deactivates loading any additional symbol fonts. 3 Although the parskip option is used for this document, it is recommended only for very few document types such as technical manuals or answers to referees. 5 3.3.3 Deactivation The hep-paper package loads few bigger packages which have a large impact on the document. The deactivation options can prevent such and other adjustments. defaults The defaults option prevents the adjustment of the page geometry and the font size set by the document class. title The title=false option deactivates the title page adjustments. bibliography The bibliography=hkeyi option prevents the automatic loading of the biblatex pack- age [33] if hkeyi=false. Otherwise the hkeyi is passed as style string to the bibla- tex package. glossaries The glossaries=false option deactives acronyms and the use of the glossaries pack- age [34]. references The references=false option prevents the cleveref package [35] from being loaded and deactivates further redefinitions of reference macros. 3.3.4 Compatibility The compatibility options activate the compatibility mode for certain classes and packages used for publications in high energy physics. They are mostly suitable combinations of options described in the previous section. If hep-paper is able to detect the presence of such a class or package, i.e. if it is loaded before the hep-paper package, the compatibility mode is activated automatically. beamer The beamer option activates the beamer [36] compatibility mode. jhep The jhep option activates the JHEP [37] compatibility mode. jcap The jcap option activates the JCAP [38] compatibility mode. revtex The revtex option activates the REVTEX[39] compatibility mode. pos The pos option activates the PoS compatibility mode. springer The springer option activates the compatibility mode the svjour class [3:]. 3.3.5 Reactivation The hep-paper package deactivates unrecommended macros, which can be reactivated manually. manualplacement The manualplacement option reactivates manual float placement. eqnarray The eqnarray option reactivates the depreciated eqnarray environment. 4 Macros and environments twocolumn If the global twocolumn option is present the page geometry is changed to cover abstract* 6 almost the entire page. Additionally the abstract* environment is defined that generates a one column abstract and takes care of placing the title information. 4.3 Title page \series The \series{hseriesi} macro is defined using the titling package [3;]. \title The PDF meta information is set according to the \title{htexti} and \author{htexti} information. \subtitle The \subtitle{hsubtitlei} macro is defined. \editor In order to facilitate multiple authors with different affiliations the authblk pack- age [42] is loaded. The following lines add . two authors with different affiliations \author e g \affiliation \author[3]{Author one \email{email one}} \affiliation[3]{Affiliation one} \email \author[4]{Author two \email{email two}} \affiliation[3,4]{Affiliation two} \preprint The \preprint{hnumeri} macro places a pre-print number in the upper right corner of the title page. abstract The abstract environment is adjusted to not start with an indentation. \titlefont Various title font macros are defined, allowing to change the appearance of the output. \subtitlefont \maketitle \authorfont 4.4 Text \affiliationfont Hyphenation is provided by the babel package [8] and quotation commands are \preprintfont provided by the csquotes package [43]. The latter package provides the convenient \enquote macros \enquote{htexti} and \MakeOuterQuote{} allowing to leave the choice of quotation marks to LATEX and use . instead of the pair . and . , respectively. \MakeOuterQuote The foreign package [44] defines macros such as \eg, \ie, \cf, and \vs which are \eg typeset as e.g., i.e., cf., and vs. \vs The \no{hnumberi} macro is typeset as 345. \no The \software[hversioni]{hnamei} macro is typeset as HEP-Paper v3.:. \software The h i h i macro combines the features of the h i h i \online \online{ url }{ text } \href{ url }{ text } [7] and the \url{htexti} [45] macros, resulting in e.g. ctan.org/pkg/hep-paper. inlinelist The inlinelist and enumdescript environments are defined using the enumitem pack- age [46]. enumdescript 7 The three main points are i) one, ii) two, The three main points are and iii) three. \begin{inlinelist} \item one \item two \item three \end{inlinelist} \begin{enumdescript}[label=\Roman*)] I) First one \item{First} one II) Second two \item{Second} two III) Third three \item{Third} three \end{enumdescript} \textsc A bold versions Small Caps and a sans serif version of Small Caps based on the computer modern (CM) font [47] is provided, the latter using the sansmath- fonts package [48]. \underline The \underline macro is redefined to allow line-breaks using the ulem package [49]. The macro is extended to also overline text outside of math environments. \overline \overline \useparskip If the parskip option is activated the \useparindent macro switches to the usual parindent mode, while the \useparskip macro switches to the parskip mode. \useparindent 4.4.3 References and footnotes \cref References are extended with the cleveref package [35], which allows to e.g. just type \cref{hkeyi} in order to write ‘figure 3’. Furthermore, the cleveref package allows to reference multiple objects within one \cref{hkey3,key4i}. \cite Citations are adjusted to not start on a new line in order to avoid the repeated use of ~\cite{hkeyi}. \ref References are also adjusted to not start on a new line. \eqref Footnotes are adjusted to swallow white space before the footnote mark and at the \subref beginning of the footnote text. \footnote 4.4.4 Acronyms \acronym The \acronymh*i[htypeset abbreviationi]{habbreviationi}h*i{hdefinitioni}[hplural i macro generates the singular h i and plural h i \shortacronym definition ] \ abbreviation \ abbreviation s macros. The first star prevents the addition of an ‘s’ to the abbreviation plural. The \longacronym second star restores the TEX default of swallowing subsequent white space.