summaryrefslogtreecommitdiff
path: root/macros/latex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex')
-rw-r--r--macros/latex/contrib/biblatex-contrib/hep-bibliography/README.md22
-rw-r--r--macros/latex/contrib/biblatex-contrib/hep-bibliography/bibliography.bib1055
-rw-r--r--macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography-documentation.pdfbin0 -> 244803 bytes
-rw-r--r--macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography-implementation.dtx990
-rw-r--r--macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography-implementation.pdfbin0 -> 330472 bytes
-rw-r--r--macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography.ins50
-rw-r--r--macros/latex/contrib/biblatex-contrib/hep-bibliography/license.md416
-rw-r--r--macros/latex/contrib/hep-acronym/README.md19
-rw-r--r--macros/latex/contrib/hep-acronym/bibliography.bib1055
-rw-r--r--macros/latex/contrib/hep-acronym/hep-acronym-documentation.pdfbin0 -> 258360 bytes
-rw-r--r--macros/latex/contrib/hep-acronym/hep-acronym-implementation.dtx524
-rw-r--r--macros/latex/contrib/hep-acronym/hep-acronym-implementation.pdfbin0 -> 316577 bytes
-rw-r--r--macros/latex/contrib/hep-acronym/hep-acronym.ins49
-rw-r--r--macros/latex/contrib/hep-acronym/license.md416
-rw-r--r--macros/latex/contrib/hep-title/README.md21
-rw-r--r--macros/latex/contrib/hep-title/bibliography.bib1055
-rw-r--r--macros/latex/contrib/hep-title/hep-title-documentation.pdfbin0 -> 249815 bytes
-rw-r--r--macros/latex/contrib/hep-title/hep-title-implementation.dtx912
-rw-r--r--macros/latex/contrib/hep-title/hep-title-implementation.pdfbin0 -> 319774 bytes
-rw-r--r--macros/latex/contrib/hep-title/hep-title.ins50
-rw-r--r--macros/latex/contrib/hep-title/license.md416
21 files changed, 7050 insertions, 0 deletions
diff --git a/macros/latex/contrib/biblatex-contrib/hep-bibliography/README.md b/macros/latex/contrib/biblatex-contrib/hep-bibliography/README.md
new file mode 100644
index 0000000000..d2532e357c
--- /dev/null
+++ b/macros/latex/contrib/biblatex-contrib/hep-bibliography/README.md
@@ -0,0 +1,22 @@
+
+
+# The `hep-bibliography` package
+
+Bibliographies for high energy physics
+
+## Introduction
+
+The `hep-bibliography` package extends the `biblatex` package with some functionality mostly useful for high energy physics.
+In particular it makes full use of all `bibtex` fields provided by `inspirehep.net`.
+
+The package can be loaded via `\usepackage{hep-bibliography}`.
+
+## Author
+
+Jan Hajer
+
+## License
+
+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.
+
diff --git a/macros/latex/contrib/biblatex-contrib/hep-bibliography/bibliography.bib b/macros/latex/contrib/biblatex-contrib/hep-bibliography/bibliography.bib
new file mode 100644
index 0000000000..e5117be3d5
--- /dev/null
+++ b/macros/latex/contrib/biblatex-contrib/hep-bibliography/bibliography.bib
@@ -0,0 +1,1055 @@
+@article{hep-paper,
+title = "The |hep-paper| package",
+subtitle = "Publications in high energy physics",
+author = "Jan Hajer",
+year = "2019",
+eprinttype = "ctan",
+eprint = "hep-paper",
+related = "hep-paper-1",
+}
+
+@manual{hep-paper-1,
+doi = "10.5281/zenodo.3606436",
+eprinttype = "github",
+eprintclass = "janhajer",
+eprint = "hep-paper",
+}
+
+@article{hep-acronym,
+title = "The |hep-acronym| package",
+subtitle = "An acronym extension for glossaries",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-acronyms",
+related = "hep-paper-1",
+}
+
+@article{hep-bibliography,
+title = "The |hep-bibliography| package",
+subtitle = "Bibliographies for high energy physics",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-bibliography",
+related = "hep-paper-1",
+}
+
+@article{hep-float,
+title = "The |hep-float| package",
+subtitle = "Convenience package for float placement",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-float",
+related = "hep-paper-1",
+}
+
+@article{hep-font,
+title = "The |hep-font| package",
+subtitle = "Latin modern extended by computer modern",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-font",
+related = "hep-paper-1",
+}
+
+@article{hep-math-font,
+title = "The |hep-math-font| package",
+subtitle = "Extended Greek and sans serif math",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-math-font",
+related = "hep-paper-1",
+}
+
+@article{hep-math,
+title = "The |hep-math| package",
+subtitle = "Extended math macros",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-math",
+related = "hep-paper-1",
+}
+
+@article{hep-text,
+title = "The |hep-text| package",
+subtitle = "List and text extensions",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-text",
+related = "hep-paper-1",
+}
+
+@article{hep-title,
+title = "The |hep-title| package",
+subtitle = "Extensions for the title page",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-title",
+related = "hep-paper-1",
+}
+
+@article{kvoptions,
+title = "The |kvoptions| package",
+subtitle = "Key value format for package options",
+author = "Heiko Oberdiek",
+year = "2004",
+eprinttype = "ctan",
+eprint = "kvoptions",
+related = "kvoptions-1",
+}
+
+@manual{kvoptions-1,
+eprinttype = "github",
+eprintclass = "ho-tex",
+eprint = "kvoptions",
+}
+
+@article{cleveref,
+title = "The |cleveref| package",
+subtitle = "Intelligent cross-referencing",
+author = "Toby Cubitt",
+date = "2006",
+url = "http://dr-qubit.org/cleveref",
+eprinttype = "ctan",
+eprint = "cleveref",
+}
+
+@article{foreign,
+title = "The |foreign| package for \hologo{LaTeX2e}",
+subtitle = "Systematic treatment of \enquote{foreign} words in documents",
+author = "Philip G. Ratcliffe",
+date = "2012",
+eprinttype = "ctan",
+eprint = "foreign",
+}
+
+@article{geometry,
+title = "The |geometry| package",
+subtitle = "Flexible and complete interface to document dimensions",
+author = "David Carlisle and Hideo Umeki",
+date = "1996",
+eprinttype = "ctan",
+eprint = "geometry",
+related = "geometry-1",
+}
+
+@manual{geometry-1,
+eprinttype = "github",
+eprintclass = "davidcarlisle",
+eprint = "geometry",
+}
+
+@article{a4wide,
+title = "The |a4wide| package",
+subtitle = "\enquote{Wide} a4 layout",
+author = "Alexander Holt and Jean-François Lamy",
+date = "1986",
+eprinttype = "ctan",
+eprint = "a4wide",
+note = "depreciated and not used",
+}
+
+@article{microtype,
+title = "The |microtype| package",
+subtitle = "Subliminal refinements towards typographical perfection",
+author = "Robert Schlicht",
+date = "2004",
+eprinttype = "ctan",
+eprint = "microtype",
+}
+
+@article{authblk,
+title = "A \hologo{LaTeX} Package to Prepare Author and Affiliation Blocks",
+subtitle = "Support for footnote style author/affiliation",
+author = "Patrick W. Daly",
+date = "2001",
+eprinttype = "ctan",
+eprint = "authblk",
+}
+
+@article{bm,
+title = "The |bm| package",
+subtitle = "Access bold symbols in maths mode",
+author = "David Carlisle and Frank Mittelbach",
+collaboration = "\hologo{LaTeX} Team",
+date = "1993",
+eprinttype = "ctan",
+eprint = "bm",
+}
+
+@article{empheq,
+title = "The |empheq| package",
+author = "Lars Madsen and Morten Høgholm and Will Robertson and Joseph Wright",
+eprinttype = "ctan",
+eprint = "empheq",
+}
+
+@article{mathtools,
+title = "The |mathtools| package",
+subtitle = "Mathematical tools to use with |amsmath|",
+author = "Lars Madsen and Morten Høgholm and Will Robertson and Joseph Wright",
+date = "2004",
+eprinttype = "ctan",
+eprint = "mathtools",
+}
+
+@article{amsmath,
+title = "The |amsmath| package",
+subtitle = "AMS mathematical facilities for \hologo{LaTeX}",
+collaboration = "\hologo{LaTeX} Team",
+date = "1994",
+url = "https://ams.org/tex/amslatex",
+eprinttype = "ctan",
+eprint = "amsmath",
+}
+
+@article{amstext,
+title = "The |amstext| package",
+subtitle = "Typeset text fragments in mathematics",
+collaboration = "\hologo{LaTeX} Team",
+date = "1995",
+url = "https://ams.org/tex/amslatex",
+eprinttype = "ctan",
+eprint = "amstext",
+}
+
+@article{amsfonts,
+title = "The |amsfonts| package",
+subtitle = "\hologo{TeX} fonts from the American Mathematical Society",
+author = "Michael Downes and David M. Jones and Frank Mittelbach and Rainer Schöpf",
+collaboration = "American Mathematical Society",
+date = "1995",
+url = "https://ams.org/tex/amsfonts",
+eprinttype = "ctan",
+eprint = "amsfonts",
+}
+
+@article{amssymb,
+title = "The |amssymb| package",
+author = "Michael Downes and David M. Jones and Frank Mittelbach and Rainer Schöpf",
+collaboration = "American Mathematical Society",
+date = "1995",
+eprinttype = "ctan",
+eprint = "amsfonts",
+}
+
+@article{slashed,
+title = "The |slashed| package",
+subtitle = "Put a slash through characters",
+author = "David Carlisle",
+date = "1987",
+eprinttype = "ctan",
+eprint = "slashed",
+}
+
+@article{physics,
+title = "The |physics| package",
+subtitle = "Macros supporting the Mathematics of Physics",
+author = "Sergio C. de la Barrera",
+date = "2012",
+eprinttype = "ctan",
+eprint = "physics",
+}
+
+@article{units,
+title = "The |units| and |nicefrac| packages",
+subtitle = "Typeset units",
+author = "Axel Reichert",
+date = "1998",
+eprinttype = "ctan",
+eprint = "units",
+}
+
+@article{subcaption,
+title = "The |subcaption| package",
+subtitle = "Support for sub-captions",
+author = "Axel Sommerfeldt",
+date = "2007",
+eprinttype = "ctan",
+eprint = "subcaption",
+related = "caption-1",
+}
+
+@article{caption,
+title = "The |caption| package",
+subtitle = "Customising captions in floating environments",
+author = "Axel Sommerfeldt",
+date = "1994",
+eprinttype = "ctan",
+eprint = "caption",
+related = "caption-1",
+}
+
+@manual{caption-1,
+eprinttype = "gitlab",
+eprintclass = "axelsommerfeldt",
+eprint = "caption",
+}
+
+
+@article{biblatex,
+title = "The |biblatex| Package",
+subtitle = "Sophisticated Bibliographies in \hologo{LaTeX}",
+author = "Philipp Lehman and Joseph Wright and Audrey Boruvka and Philip Kime",
+date = "2006",
+eprinttype = "ctan",
+eprint = "biblatex",
+related = "biblatex-1",
+}
+
+@manual{biblatex-1,
+eprinttype = "github",
+eprintclass = "plk",
+eprint = "biblatex",
+}
+
+@article{hyperref,
+title = "Hypertext marks in \hologo{LaTeX}: a manual for |hyperref|",
+subtitle = "Extensive support for hypertext in \hologo{LaTeX}",
+author = "Sebastian Rahtz and Heiko Oberdiek",
+collaboration = "\hologo{LaTeX3} Project",
+date = "1995",
+eprinttype = "ctan",
+eprint = "hyperref",
+related = "hyperref-1",
+}
+
+@manual{hyperref-1,
+eprinttype = "github",
+eprintclass = "latex3",
+eprint = "hyperref",
+}
+
+@article{graphicx,
+title = "Packages in the \enquote{graphics} bundle",
+subtitle = "Enhanced support for graphics",
+author = "David Carlisle and Sebastian Rahtz",
+date = "1994",
+eprinttype = "ctan",
+eprint = "graphicx",
+}
+
+@article{booktabs,
+title = "The |booktabs| package",
+subtitle = "Publication quality tables in \hologo{LaTeX}",
+author = "Danie Els and Simon Fear",
+date = "1995",
+eprinttype = "ctan",
+eprint = "booktabs",
+}
+
+@article{multirow,
+title = "The |multirow|, |bigstrut| and |bigdelim| packages",
+subtitle = "Create tabular cells spanning multiple rows",
+author = "Piet van Oostrum and Jerry Leichter",
+date = "1994",
+eprinttype = "ctan",
+eprint = "multirow",
+}
+
+@article{fixmath,
+title = "The |fixmath| package for \hologo{LaTeX2e}",
+subtitle = "Make maths comply with ISO 31-0:1992 to ISO 31-13:1992",
+author = "Walter Schmidt",
+date = "2000",
+eprinttype = "ctan",
+eprint = "fixmath",
+}
+
+@article{alphabeta,
+title = "The |alphabeta| package",
+subtitle = "LICR macros and encoding definition files for Greek",
+author = "Günter Milde",
+date = "2013",
+eprinttype = "ctan",
+eprint = "greek-fontenc",
+}
+
+@article{textalpha,
+title = "The |textalpha| package",
+subtitle = "LICR macros and encoding definition files for Greek",
+author = "Günter Milde",
+date = "2010",
+eprinttype = "ctan",
+eprint = "greek-fontenc",
+}
+
+@article{arxiv-collector,
+title = "|arxiv-collector|",
+subtitle = "A little Python script to collect \hologo{LaTeX} sources for upload to the arXiv",
+author = "Dougal Sutherland",
+date = "2018",
+eprinttype = "github",
+eprintclass = "dougalsutherland",
+eprint = "arxiv-collector",
+}
+
+@article{biber,
+title = "\hologo{biber}",
+subtitle = "Backend processor for Bib\hologo{LaTeX}",
+author = "François Charette and Philip Kime",
+date = "2009",
+eprinttype = "github",
+eprintclass = "plk",
+eprint = "biber",
+related = "biber-1",
+}
+
+@manual{biber-1,
+eprinttype = "sourceforge",
+eprint = "biblatex-biber",
+}
+
+@article{lmodern,
+title = "Latin Modern Family of Fonts",
+subtitle = "Latin modern fonts in outline formats",
+date = "2003",
+author = "B. Jackowski and J.M. Nowacki",
+url = "http://gust.org.pl/projects/e-foundry/latin-modern",
+eprinttype = "ctan",
+eprint = "lm",
+}
+
+@article{ifluatex,
+title = "The |ifluatex| package",
+subtitle = "Provides the |\textbackslash ifluatex| switch",
+author = "Heiko Oberdiek",
+collaboration = "\hologo{LaTeX} Team",
+date = "2007",
+eprinttype = "ctan",
+eprint = "ifluatex",
+}
+
+@article{ifxetex,
+title = "The |iftex| package",
+subtitle = "Am I running under \hologo{XeTeX}?",
+collaboration = "\hologo{LaTeX} Team",
+author = "Will Robertson",
+date = "2006",
+eprinttype = "ctan",
+eprint = "ifxetex",
+related = "ifxetex-1",
+}
+
+@manual{ifxetex-1,
+eprinttype = "github",
+eprintclass = "latex3",
+eprint = "iftex",
+}
+
+@article{fontspec,
+title = "The |fontspec| package",
+subtitle = "Advanced font selection in \hologo{XeLaTeX} and \hologo{LuaLaTeX}",
+author = "Will Robertson and Khaled Hosny",
+date = "2004",
+eprinttype = "ctan",
+eprint = "fontspec",
+}
+
+@article{fontenc,
+title = "The |fontenc| package",
+subtitle = "Standard package for selecting font encodings",
+collaboration = "\hologo{LaTeX} Team",
+author = "Frank Mittelbach and Robin Fairbairns and Werner Lemberg",
+date = "1995",
+eprinttype = "ctan",
+eprint = "fontenc",
+}
+
+@article{inputenc,
+title = "The |inputenc| package",
+subtitle = "Accept different input encodings",
+collaboration = "\hologo{LaTeX} Team",
+author = "Frank Mittelbach and Alan Jeffrey",
+date = "1989",
+eprinttype = "ctan",
+eprint = "inputenc",
+}
+
+@article{textcomp,
+title = "The |textcomp| package",
+subtitle = "\hologo{LaTeX} support for the Text Companion fonts",
+collaboration = "\hologo{LaTeX} Team",
+author = "Sebastian Rahtz",
+date = "1995",
+eprinttype = "ctan",
+eprint = "textcomp",
+}
+
+@article{enumitem,
+title = "Customizing lists with the |enumitem| package",
+subtitle = "Control layout of itemize, enumerate, description",
+author = "Javier Bezos",
+date = "2003",
+url = "https://texnia.com/enumitem.html",
+eprinttype = "ctan",
+eprint = "enumitem",
+related = "enumitem-1",
+}
+
+@manual{enumitem-1,
+eprinttype = "github",
+eprintclass = "jbezos",
+eprint = "enumitem",
+}
+
+@article{atbegshi,
+title = "The |atbegshi| package",
+subtitle = "Execute stuff at |shipout| time",
+author = "Heiko Oberdiek",
+date = "2007",
+eprinttype = "ctan",
+eprint = "atbegshi",
+related = "atbegshi-1",
+}
+
+@manual{atbegshi-1,
+eprinttype = "github",
+eprintclass = "ho-tex",
+eprint = "atbegshi",
+}
+
+@article{picture,
+title = "The |picture| package",
+subtitle = "Dimens for picture macros",
+author = "Heiko Oberdiek",
+date = "2006",
+eprinttype = "ctan",
+eprint = "picture",
+related = "picture-1",
+}
+
+@manual{picture-1,
+eprinttype = "github",
+eprintclass = "ho-tex",
+eprint = "picture",
+}
+
+@article{varwidth,
+title = "The |varwidth| package",
+subtitle = "A variable-width minipage",
+author = "Donald Arseneau",
+date = "2003",
+eprinttype = "ctan",
+eprint = "varwidth",
+}
+
+@article{csquotes,
+title = "The |csquotes| Package",
+subtitle = "Context sensitive quotation facilities",
+author = "Philipp Lehman and Joseph Wright",
+date = "2003",
+eprinttype = "ctan",
+eprint = "csquotes",
+}
+
+@article{babel,
+title = "|Babel| Localization and internationalization",
+subtitle = "Multilingual support for Plain \hologo{TeX} or \hologo{LaTeX}",
+author = "Johannes Braams and Javier Bezos and at al.",
+date = "1989",
+eprinttype = "ctan",
+eprint = "babel",
+related = "babel-1",
+}
+
+@manual{babel-1,
+eprinttype = "github",
+eprintclass = "latex3",
+eprint = "babel",
+}
+
+@article{polyglossia,
+title = "The |polyglossia| package",
+author = "Arthur Reutenauer and François Charette and Elie Roux and Bastien Roucariès and Jürgen Spitzmüller",
+eprinttype = "ctan",
+eprint = "polyglossia",
+}
+
+@article{parskip,
+title = "The |parskip| package",
+subtitle = "Layout with zero |\textbackslash parindent|, non-zero |\textbackslash parskip|",
+author = "Robin Fairbairns and Frank Mittelbach and H. Partl",
+date = "1989",
+eprinttype = "ctan",
+eprint = "parskip",
+related = "parskip-1",
+}
+
+@manual{parskip-1,
+eprinttype = "github",
+eprintclass = "FrankMittelbach",
+eprint = "fmitex",
+}
+
+
+@article{fntguide,
+title = "\hologo{LaTeX2e}\ font selection",
+subtitle = "Docmentation of \hologo{LaTeX} font commands",
+collaboration = "\hologo{LaTeX} Team",
+date = "1995",
+eprinttype = "ctan",
+eprint = "fntguide",
+}
+
+@article{euenc,
+title = "The Experimental Unicode `EUx’ Encodings",
+author = "Will Robertson and Elie Roux and Khaled Hosny",
+eprinttype = "ctan",
+eprint = "euenc",
+}
+
+@article{soul,
+title = "The |soul| package",
+subtitle = "Hyphenation for letterspacing, underlining, and more",
+author = "Melchior Franz",
+date = "1998",
+eprinttype = "ctan",
+eprint = "soul",
+}
+
+@article{ulem,
+title = "The |ulem| package",
+subtitle = "Package for underlining",
+author = "Donald Arseneau",
+date = "1989",
+eprinttype = "ctan",
+eprint = "ulem",
+}
+
+@article{glossaries,
+title = "The |glossaries| package",
+subtitle = "Create glossaries and lists of acronyms",
+author = "Nicola Talbot",
+date = "2007",
+eprinttype = "ctan",
+eprint = "glossaries",
+}
+
+@article{glossaries-extra,
+title = "The |glossaries-extra| package",
+subtitle = "An extension to the |glossaries| package",
+author = "Dickimaw Books, Nicola Talbot",
+date = "2015",
+eprinttype = "ctan",
+eprint = "glossaries-extra",
+}
+
+@article{xparse,
+title = "The |xparse| package",
+subtitle = "A generic document command parser",
+author = "Frank Mittelbach and Chris Rowley and David Carlisle",
+collaboration = "\hologo{LaTeX3} Project",
+date = "1999",
+eprinttype = "ctan",
+eprint = "xparse",
+}
+
+@article{pdftexcmds,
+title = "The |pdftexcmds| package",
+subtitle = "\hologo{LuaTeX} support for \hologo{pdfTeX} utility functions",
+author = "Heiko Oberdiek",
+date = "2007",
+eprinttype = "ctan",
+eprint = "pdftexcmds",
+}
+
+@article{fix-cm,
+title = "The |fix-cm| package",
+subtitle = "Permit Computer Modern fonts at arbitrary sizes",
+author = "Frank Mittelbach and David Carlisle and Chris Rowley and Walter Schmidt",
+date = "1993",
+eprinttype = "ctan",
+eprint = "fix-cm",
+}
+
+@article{revtex,
+title = "The REV\hologo{TeX} class",
+subtitle = "Styles for various Physics Journals",
+author = "Mark Doyle and Arthur Ogawa",
+collaboration = "American Physical Society",
+date = "1999",
+url = "https://journals.aps.org/revtex",
+eprinttype = "ctan",
+eprint = "revtex",
+}
+
+@article{encguide,
+title = "\hologo{LaTeX} font encodings",
+subtitle = "Documentation of \hologo{LaTeX} font encodings",
+author = "Frank Mittelbach and Robin Fairbairns and Werner Lemberg",
+collaboration = "\hologo{LaTeX3} Project Team",
+date = "1995",
+eprinttype = "ctan",
+eprint = "encguide",
+}
+
+@article{sfmath,
+title = "The |sfmath| package",
+subtitle = "Sans-serif mathematics",
+author = "Olaf Dietrich",
+date = "2005",
+url = "https://dtrx.de/od/tex/sfmath",
+eprinttype = "ctan",
+eprint = "sfmath",
+}
+
+@article{relsize,
+title = "The |relsize| package",
+subtitle = "Set the font size relative to the current font size",
+author = "Donald Arseneau and Matt Swift",
+date = "2011",
+eprinttype = "ctan",
+eprint = "relsize",
+}
+
+@article{everyhook,
+title = "The |everyhook| package",
+subtitle = "Hooks for standard \hologo{TeX} token lists",
+author = "Stephen Checkoway",
+date = "2010",
+eprinttype = "ctan",
+eprint = "everyhook",
+}
+
+
+@article{sansmathfonts,
+title = "The |sansmathfonts| package",
+subtitle = "Correct placement of accents in sans-serif maths",
+author = "Ariel Barton",
+date = "2013",
+eprinttype = "ctan",
+eprint = "sansmathfonts",
+}
+
+@article{xspace,
+title = "The |xspace| package",
+subtitle = "Define commands that appear not to eat spaces",
+author = "David Carlisle and Morten Høgholm",
+collaboration = "\hologo{LaTeX} Team",
+date = "1993",
+eprinttype = "ctan",
+eprint = "xspace",
+}
+
+@article{ragged2e,
+title = "The |ragged2e|-package",
+subtitle = "Alternative versions of \enquote{ragged}-type commands",
+author = "Martin Schröder",
+date = "1996",
+eprinttype = "ctan",
+eprint = "ragged2e",
+related = "ragged2e-1",
+}
+
+@manual{ragged2e-1,
+eprinttype = "gitlab",
+eprintclass = "hagenbuch",
+eprint = "ragged2e",
+}
+
+@article{url,
+title = "The |url| package",
+subtitle = "Verbatim with URL-sensitive line breaks",
+author = "Donald Arseneau",
+date = "1996",
+eprinttype = "ctan",
+eprint = "url",
+}
+
+@article{jhep,
+title = "The |JHEP| package",
+collaboration = "SISSA Medialab",
+date = "1997",
+url = "https://jhep.sissa.it/jhep/help/JHEP_TeXclass.jsp",
+}
+
+@article{jcap,
+title = "The |JCAP| package",
+collaboration = "SISSA Medialab",
+date = "2002",
+url = "https://jcap.sissa.it/jcap/help/JCAP_TeXclass.jsp",
+}
+
+@article{bbm-macros,
+title = "A package for using the |bbm| fonts in math environment",
+author = "Torsten Hilbrich",
+date = "1994",
+eprinttype = "ctan",
+eprint = "bbm-macros",
+related = "bbm"
+}
+
+@article{bbm,
+title = "|bbm|",
+subtitle = "\enquote{Blackboard-style} cm fonts",
+author = "Gilles Robert",
+date = "1993",
+eprinttype = "ctan",
+eprint = "bbm",
+}
+
+@article{arxiv,
+title = "arXiv",
+subtitle = "free distribution service and an open archive for scholarly articles",
+url = "https://arxiv.org",
+author = "Paul Ginsparg",
+collaboration = "arXiv Team",
+year = "1991",
+organization = "Cornell University",
+}
+
+@article{dsfont,
+title = "The |doublestroke| font",
+subtitle = "Typeset mathematical double stroke symbols",
+author = "Olaf Kummer",
+date = "1995",
+eprinttype = "ctan",
+eprint = "doublestroke",
+}
+
+@article{mleftright,
+title = "The |mleftright| package",
+subtitle = "Variants of delimiters that act as maths open/close",
+author = "Heiko Oberdiek",
+date = "2010",
+eprinttype = "ctan",
+eprint = "mleftright",
+}
+
+@article{urwchancal,
+title = "A virtual font for URW Chancery Math",
+subtitle = "Use URW's clone of Zapf Chancery as a maths alphabet",
+author = "Michael Sharpe",
+date = "2011",
+eprinttype = "ctan",
+eprint = "urwchancal",
+}
+
+@article{footnotebackref,
+title = "The |footnotebackref| package",
+subtitle = "Back-references from footnotes",
+author = "Holger Lange",
+date = "2012",
+eprinttype = "ctan",
+eprint = "footnotebackref",
+}
+
+@article{cancel,
+title = "The |cancel| package",
+subtitle = "Place lines through maths formulae",
+author = "Donald Arseneau",
+date = "2013",
+eprinttype = "ctan",
+eprint = "cancel",
+}
+
+@article{beamer,
+title = "The |beamer| class",
+subtitle = "A \hologo{LaTeX} class for producing presentations and slides",
+author = "Till Tantau and Joseph Wright and Vedran Miletić",
+date = "2003",
+eprinttype = "ctan",
+eprint = "beamer",
+related = "beamer-1",
+}
+
+@manual{beamer-1,
+eprinttype = "github",
+eprintclass = "josephwright",
+eprint = "beamer",
+}
+
+@article{exscale,
+title = "The |exscale| package",
+subtitle = "Implements scaling of the \enquote{cmex} fonts",
+author = "Frank Mittelbach and Rainer Schöpf",
+date = "1993",
+eprinttype = "ctan",
+eprint = "exscale",
+}
+
+@article{mathrsfs,
+title = "The |mathrsfs| package",
+subtitle = "Support for using RSFS fonts in maths",
+author = "Jörg Knappen",
+date = "1995",
+eprinttype = "ctan",
+eprint = "mathrsfs",
+}
+
+@article{esint,
+title = "The |esint| package",
+subtitle = "Extended set of integrals for Computer Modern",
+author = "Eddie Saudrais",
+date = "2005",
+eprinttype = "ctan",
+eprint = "esint",
+}
+
+@article{cmbright,
+title = "The |cmbright| package",
+subtitle = "Using the CM Bright typeface with \hologo{LaTeX}",
+author = "Walter A. Schmidt",
+date = "1996",
+eprinttype = "ctan",
+eprint = "cmbright",
+}
+
+@article{titling,
+title = "The |titling| package",
+subtitle = "Control over the typesetting of the |\textbackslash maketitle| command",
+author = "Peter R. Wilson",
+date = "2000",
+eprinttype = "ctan",
+eprint = "titling",
+}
+
+@article{MnSymbol,
+title = "The |MnSymbol| package",
+subtitle = "Mathematical symbol font for Adobe MinionPro",
+author = "Achim Blumensath",
+date = "2005",
+eprinttype = "ctan",
+eprint = "MnSymbol",
+}
+
+@article{environ,
+title = "The |environ| package",
+subtitle = "A new interface for environments in \hologo{LaTeX}",
+author = "Will Robertson",
+date = "2007",
+eprinttype = "ctan",
+eprint = "environ",
+}
+
+@article{abstract,
+title = "The |abstract| package",
+subtitle = "Control the typesetting of the abstract environment",
+author = "Peter R. Wilson",
+date = "2000",
+eprinttype = "ctan",
+eprint = "abstract",
+}
+
+@article{cfr-lm,
+title = "The |cfr-lm| package",
+subtitle = "Enhanced support for the Latin Modern fonts",
+author = "Clea F. Rees",
+date = "2008",
+eprinttype = "ctan",
+eprint = "cfr-lm",
+}
+
+@article{etoolbox,
+title = "The |etoolbox| package",
+subtitle = "e-\hologo{TeX} tools for \hologo{LaTeX}",
+author = "Philipp Lehman and Joseph Wright",
+date = "2007",
+eprinttype = "ctan",
+eprint = "etoolbox",
+}
+
+@article{substitutefont,
+title = "The |substitutefont| package",
+subtitle = "Easy font substitution",
+author = "Günter Milde",
+date = "2010",
+eprinttype = "ctan",
+eprint = "substitutefont",
+}
+
+@article{svjour,
+title = "The |svjour| package",
+subtitle = "Macros for Springer journals",
+collaboration = "Springer Verlag",
+date = "1997",
+eprinttype = "ctan",
+eprint = "springer",
+}
+
+@article{cm,
+title = "Computer Modern fonts",
+author = "Donald E. Knuth",
+date = "1986",
+eprinttype = "ctan",
+eprint = "cm",
+}
+
+@article{subdepth,
+title = "The |subdepth| package",
+subtitle = "Unify maths subscript height",
+author = "Will Robertson",
+date = "2007",
+eprinttype = "ctan",
+eprint = "subdepth",
+}
+
+@article{xpatch,
+title = "The |xpatch| package",
+subtitle = "Extending etoolbox patching commands",
+author = "Enrico Gregorio",
+date = "2012",
+eprinttype = "ctan",
+eprint = "xpatch",
+}
+
+@article{hfoldsty,
+title = "The |hfoldsty| package",
+subtitle = "Old style numerals with EC fonts",
+author = "Harald Harders",
+date = "2004",
+eprinttype = "ctan",
+eprint = "hfoldsty",
+}
+
+@article{slantsc,
+title = "The |slantsc| package",
+subtitle = "Access different-shaped small-caps fonts",
+author = "Harald Harders",
+date = "2003",
+eprinttype = "ctan",
+eprint = "slantsc",
+}
+
+@article{nfssext-cfr,
+title = "The |nfssext-cfr| package",
+subtitle = "Extensions to the \hologo{LaTeX} NFSS",
+author = "Clea F. Rees and Philipp Lehman",
+date = "2003",
+eprinttype = "ctan",
+eprint = "nfssext-cfr",
+}
+
+@article{xstring,
+title = "The |xstring| package",
+subtitle = "String manipulation for \hologo{LaTeX}",
+author = "Christian Tellechea",
+date = "2008",
+eprinttype = "ctan",
+eprint = "xstring",
+}
+
+@article{gregorio:2020,
+title = "\hologo{TeX}, \hologo{LaTeX} and math",
+author = "Enrico Gregorio",
+date = "2020",
+url = "https://latex-project.org/publications/2020-egreg-TUB-tb127gregorio-math.pdf",
+}
+
+@article{soulutf8,
+title = "The |soulutf8| package",
+subtitle = "Permit use of UTF-8 characters in |soul|",
+author = "Heiko Oberdiek",
+date = "2007",
+eprinttype = "ctan",
+eprint = "soulutf8",
+}
+
diff --git a/macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography-documentation.pdf b/macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography-documentation.pdf
new file mode 100644
index 0000000000..475d7a148b
--- /dev/null
+++ b/macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography-documentation.pdf
Binary files differ
diff --git a/macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography-implementation.dtx b/macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography-implementation.dtx
new file mode 100644
index 0000000000..1288b49146
--- /dev/null
+++ b/macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography-implementation.dtx
@@ -0,0 +1,990 @@
+% \iffalse meta-comment
+%
+% Copyright (C) 2019 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.
+%
+% \fi
+%
+% \iffalse
+
+%<package>\NeedsTeXFormat{LaTeX2e}[2005/12/01]
+%<package>\ProvidesPackage{hep-bibliography}[2021/09/01 v1.0 HEP-Bibliography]
+%<datamodel>\ProvidesFile{hep-bibliography.dbx}[2021/08/01 v1.8 HEP-Bibliography biblatex data model]
+%<documentation>\ProvidesFile{hep-bibliography-documentation.tex}[2021/08/01 v1.8 HEP-Bibliography documentation]
+%
+%<*documentation>
+
+\RequirePackage[l2tabu, orthodox]{nag}
+\documentclass{ltxdoc}
+\AtBeginDocument{\DeleteShortVerb{\|}}
+\AtBeginDocument{\MakeShortVerb{\"}}
+
+\EnableCrossrefs
+\CodelineIndex
+\RecordChanges
+
+\usepackage[parskip]{hep-paper}
+
+\bibliography{bibliography}
+
+\acronym{URL}{uniform resource locator}
+
+\usepackage{hologo}
+
+\MacroIndent=1.5em
+\AtBeginEnvironment{macrocode}{\renewcommand{\ttdefault}{clmt}}
+%</documentation>
+
+%<*driver>
+\expandafter\newif\csname ifshort\endcsname
+\shortfalse
+\begin{document}
+\DocInput{hep-bibliography-implementation.dtx}
+\end{document}
+%</driver>
+%
+% \fi
+%
+% \CheckSum{315}
+%
+% \CharacterTable
+% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+% Digits \0\1\2\3\4\5\6\7\8\9
+% Exclamation \! Double quote \" Hash (number) \#
+% Dollar \$ Percent \% Ampersand \&
+% Acute accent \' Left paren \( Right paren \)
+% Asterisk \* Plus \+ Comma \,
+% Minus \- Point \. Solidus \/
+% Colon \: Semicolon \; Less than \<
+% Equals \= Greater than \> Question mark \?
+% Commercial at \@ Left bracket \[ Backslash \\
+% Right bracket \] Circumflex \^ Underscore \_
+% Grave accent \` Left brace \{ Vertical bar \|
+% Right brace \} Tilde \~}
+%
+% \changes{v1.0}{2021/09/01}{Initial version of the style file.}
+%
+% \ifshort
+%<*documentation>
+% \fi
+%
+\GetFileInfo{hep-bibliography.sty}
+
+\title{The \software{hep-bibliography} package\thanks{This document corresponds to \software{hep-bibliography}~\fileversion.}}
+\subtitle{Bibliographies for high energy physics}
+\author{Jan Hajer \email{jan.hajer@unibas.ch}}
+\date{\filedate}
+
+% \ifshort
+\begin{document}
+% \fi
+
+\newgeometry{vscale=.8, vmarginratio=3:4, includeheadfoot, left=11em, marginparwidth=4.6cm, marginparsep=3mm, right=7em}
+
+\maketitle
+
+\begin{abstract}
+The \software{hep-bibliography} package extends the \software{biblatex} package with some functionality mostly useful for high energy physics.
+In particular it makes full use of all "bibtex" fields provided by "inspirehep.net".
+\end{abstract}
+
+The package can be loaded via "\usepackage{hep-bibliography}".
+
+\DescribeMacro{\bibliography}
+\DescribeMacro{\printbibliography}
+The \software{biblatex} package \cite{biblatex} is loaded for bibliography management.
+The user has to add the line "\bibliography"\marg{my.bib} to the preamble of the document and "\printbibliography" at the end of the document.
+The bibliography is generated by \software{Biber} \cite{biber}.
+"biblatex" is extended to be able to cope with the "collaboration" and "reportNumber" fields provided by \online{https://inspirehep.net}{inspirehep.net} and a bug in the volume number is fixed.
+Additionally, the PubMed IDs are recognized and \online{https://ctan.org}{ctan.org}, \online{https://github.com}{github.com}, \online{https://gitlab.com}{gitlab.com}, \online{https://bitbucket.org}{bitbucket.org}, \online{https://www.launchpad.net}{launchpad.net}, \online{https://sourceforge.net}{sourceforge.net}, and \online{https://hepforge.org}{hepforge.org} are valid "eprinttype"s.
+\DescribeMacro{erratum}
+Errata can be included using the "related" feature.
+\begin{verbatim}
+\article{key1,
+ ...,
+ relatedtype="erratum",
+ related="key2",
+}
+\article{key2,
+ ...,
+}
+\end{verbatim}
+
+% \ifshort
+\printbibliography
+
+\end{document}
+%
+%</documentation>
+% \fi
+%
+% \StopEventually{
+% \printbibliography
+% \PrintChanges
+% }
+%
+% \appendix
+%
+% \section{Implementation}
+%
+%<*package>
+
+% Load the \software{kvoptions} package \cite{kvoptions} and define a "hepbib" namespace.
+% \begin{macrocode}
+\RequirePackage{kvoptions}
+\SetupKeyvalOptions{
+ family=hepbib,
+ prefix=hepbib@
+}
+% \end{macrocode}
+%
+% \begin{macro}{bibliography}
+% Provide the "style" option for passing a "style" string to the \software{biblatex} package \cite{biblatex} or disabling the automatic loading of "biblatex".
+% \begin{macrocode}
+\DeclareStringOption[numeric-comp]{style}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macrocode}
+\ProcessKeyvalOptions*
+% \end{macrocode}
+%
+% \begin{macro}{\online}
+% \begin{macro}{\email}
+% Define the "\online"\marg{text}\marg{url} macro combining the features of the "\href" and the "\url" macros.
+% Define a macro for typesetting emails.
+% \begin{macrocode}
+\providecommand{\online}[2]{\texttt{#2}}%
+\providecommand{\hep@email}[1]{\online{mailto:#1}{#1}}
+\providecommand\email{\hep@email}
+\AtBeginDocument{\@ifpackageloaded{hyperref}{%
+ \renewcommand{\online}[2]{\href{#1}{\nolinkurl{#2}}}%
+ }{}
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{environment}{commalist}
+% Define a commalist environment using the "xparse" package \cite{xparse}.
+% \begin{macrocode}
+\RequirePackage{xparse}
+\ExplSyntaxOn
+\NewDocumentEnvironment{commalist}{O{\space}+b}{
+ \hep@comma@list:n{#2}
+}{#1}
+\seq_new:N \hep@items@sequence
+\cs_new_protected:Npn \hep@comma@list:n #1{
+ \seq_set_split:Nnn \hep@items@sequence{\item}{#1}
+ \seq_pop_left:NN \hep@items@sequence \l_tmpa_tl
+ \seq_use:Nnnn \hep@items@sequence{~and~}{,~}{,~and~}
+}
+\ExplSyntaxOff
+% \end{macrocode}
+% \end{environment}
+%
+%
+% \begin{macro}{\bibliography}
+% Load the \software{biblatex} package \cite{biblatex} with the datamodel defined in \cref{sec:data model}.
+% \begin{macrocode}
+\RequirePackage[style=\hepbib@style, datamodel=hep-bibliography]{biblatex}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{hep-bibliography}
+% Provide the "\DeclareSortingTemplate" macro for older "biblatex" installations.
+% Define a new sorting template that sorts only multi key "\cite" entries according to their date and leaves the rest of the bibliography entries in the order they appear in the text.
+% \begin{macrocode}
+\providecommand{\DeclareSortingTemplate}{\DeclareSortingScheme}
+\DeclareSortingTemplate{hep-bibliography}{
+ \sort{\citeorder}
+ \sort[final]{\field{sortkey}}
+ \sort{\field{sortyear} \field{year} \literal{9999}}
+ \sort{\field{month}}
+ \sort{\field{eprint} \field{doi}}
+ \sort{\field{sorttitle} \field{title}}
+ \sort{\field{subtitle} \field{volume}}
+}
+% \end{macrocode}
+% \end{macro}
+%
+% Use the new sorting scheme and abbreviat all first names.
+% \begin{macrocode}
+\ExecuteBibliographyOptions{
+ sorting=hep-bibliography,
+ safeinputenc,
+ giveninits=true,
+ maxbibnames=7,
+ backref=true
+}
+% \end{macrocode}
+%
+% Hide the backrefs but use the information to link the index to the page of first citation.
+% \begin{macrocode}
+\renewbibmacro*{pageref}{}%
+\def\blxjk@grabfirslisttitem#1#2\@nil{#1}
+\DeclareFieldFormat{labelnumberwidth}{%
+ \iflistundef{pageref}{%
+ \mkbibbrackets{#1}%
+ }{%
+ \edef\blxjk@firstpage{%
+ \expandafter\blxjk@grabfirslisttitem\abx@list@pageref{}\@nil%
+ }%
+ \ifhyperref{%
+ \hyperlink{page.\blxjk@firstpage}{\mkbibbrackets{#1}}%
+ }{%
+ \mkbibbrackets{#1}%
+ }%
+ }%
+}
+% \end{macrocode}
+%
+% Shrink the biblography in two column mode.
+% \begin{macrocode}
+% \newif\ifhep@journal\hep@journalfalse
+% \ifhep@journal\else
+ \if@twocolumn
+ \AtBeginBibliography{\small}
+ \setlength\biblabelsep{\labelsep}
+ \fi
+% \fi
+% \end{macrocode}
+%
+% \begin{macro}{translationof}
+% Redefine the "translationof" string to fit better to documents without a original title.
+% \begin{macrocode}
+\DefineBibliographyStrings{english}{translationof={Original}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{erratum}
+% Add new bibliography string \enquote{Erratum} for the use in the "relatedtype" field.
+% \begin{macrocode}
+\NewBibliographyString{erratum,erratums}
+\DefineBibliographyStrings{english}{erratum={Erratum},erratums={Errata}}
+\providecommand{\relateddelimerratum}{\addsemicolon\space}
+% \end{macrocode}
+% \end{macro}
+%
+% Activate the Oxford comma when using "british" and separate title and subtitle with a colon.
+% \begin{macrocode}
+\DefineBibliographyExtras{british}{\def\finalandcomma{\addcomma}}
+\renewcommand{\subtitlepunct}{\addcolon\addspace}
+% \end{macrocode}
+%
+% \begin{macro}{\printbibliography}
+% Allow the bibliography to be printed sloppy
+% \begin{macrocode}
+\let\hep@printbibliography\printbibliography
+\renewcommand{\printbibliography}{\sloppy\hep@printbibliography}
+% \end{macrocode}
+% \end{macro}
+
+% \subsection{Sourcemap}
+%
+% \begin{macro}{\reg@exp@one}
+% \begin{macro}{\reg@exp@two}
+% \begin{macro}{\reg@exp@url}
+% \begin{macro}{\reg@exp@pmc}
+% Define regular expressions in order to deal with inconsistent journal title and volume naming as well as \URL protocols and the PMCID.
+% \begin{macrocode}
+\newcommand{\reg@exp@one}{\regexp{\A(\p{L}+)?\d+(\p{L}+)?\Z}}
+\newcommand{\reg@exp@two}{\regexp{\A(\p{L}+)?(\d+)(\p{L}+)?\Z}}
+\newcommand{\reg@exp@url}{\regexp{\A(ht|f)tp(s)?:\/\/}}
+\newcommand{\reg@exp@pmc}{\regexp{\A(PMC)?}}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\DeclareSourcemap}
+% Use the "\DeclareSourcemap" feature.
+% \begin{macrocode}
+\DeclareSourcemap{%
+ \maps[datatype=bibtex, overwrite=true]{%
+% \end{macrocode}
+% \begin{macro}{collaboration}
+% Read the collaboration information if present.
+% \begin{macrocode}
+ \map{%
+ \step[fieldsource=Collaboration, final=true]%
+ \step[fieldset=collaboration, origfieldval, final=true]
+ }%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{reportnumber}
+% Read the pre-print information if present.
+% \begin{macrocode}
+ \map{%
+ \step[fieldsource=reportNumber, final=true]%
+ \step[fieldset=reportnumber, origfieldval, final=true]
+ }%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{journal}
+% Move letters from the volume field to the journal field.
+% \begin{macrocode}
+ \map[overwrite]{
+ \pertype{article}
+ \step[fieldsource=volume, match=\reg@exp@one, final]
+ \step[fieldsource=volume, match=\reg@exp@two, replace={$2}]
+ \step[fieldsource=journal, fieldtarget=journaltitle]
+ \step[fieldset=journaltitle, fieldvalue={\space$1$2}, append=true]
+ }
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{url}
+% Remove the protocol from \URL.
+% \begin{macrocode}
+ \map{
+ \step[fieldsource=url, final=true]
+ \step[fieldset=protocollessurl, origfieldval, final=true]
+ \step[fieldsource=protocollessurl, match=\reg@exp@url, replace={}]
+ }
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{pmc}
+% Remove the PMC from the PMCID.
+% \begin{macrocode}
+ \map{
+ \step[fieldsource=pmcid, final=true]
+ \step[fieldset=pmc, origfieldval, final=true]
+ \step[fieldsource=pmc, match=\reg@exp@pmc, replace={}]
+ }
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\letbibmacro}
+% Provide the "\letbibmacro" macro for old "biblatex" installations.
+% \begin{macrocode}
+\providecommand{\letbibmacro}[2]{\csletcs{abx@macro@#1}{abx@macro@#2}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{collaboration}
+% Execute the author macro even if only the collaboration information if present and override the author information with collaboration information if present.
+% \begin{macrocode}
+\renewbibmacro*{author/translator+others}{%
+ \ifboolexpr{
+ test \ifuseauthor and (
+ not test {\ifnameundef{author}} or
+ not test {\iffieldundef{collaboration}}
+ )
+ }
+ {\usebibmacro{author}}
+ {\usebibmacro{translator+others}}
+}
+\letbibmacro{hep@bib@author}{author}
+\renewbibmacro*{author}{%
+ \iffieldundef{collaboration}{%
+ \usebibmacro{hep@bib@author}}{\textit{\printfield{collaboration}}%
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{In:}
+% Remove spurious \enquote{In:} if no journal is present.
+% \begin{macrocode}
+\renewbibmacro*{in:}{%
+ \iffieldundef{journaltitle}{}{\printtext{\bibstring{in}\intitlepunct}}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{reportnumber}
+% Print the "reportnumber" as commalist using the \software{relsize} package \cite{relsize}.
+% \begin{macrocode}
+\RequirePackage{relsize}
+\DeclareFieldFormat{reportnumber}{%
+ \edef\commalistbody{\forcsvfield{%
+ \egroup\noexpand\item\unexpanded{\bgroup\smaller[.5]\textsc}
+ }{reportnumber}}%
+ \expandafter\commalist\commalistbody\egroup\endcommalist%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{url}
+% Show \URLs without the protocol.
+% \begin{macrocode}
+\DeclareFieldFormat{url}{%
+ \mkbibacro{URL}\addcolon\space\online{#1}{\thefield{protocollessurl}}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\bib@online}
+% Private "\bib@online" macro
+% \begin{macrocode}
+\newcommand{\bib@online}[2]{%
+ \ifhyperref{\online{#1}{#2}}{\nolinkurl{#2}}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{pmid}
+% \begin{macro}{pmcid}
+% Present PubMed IDs.
+% \begin{macrocode}
+\DeclareFieldFormat{pmid}{%
+ \mkbibacro{PM}\addcolon\space%
+ \bib@online{https://www.ncbi.nlm.nih.gov/pubmed/#1}{#1}%
+}
+\DeclareFieldFormat{pmc}{%
+ \mkbibacro{PMC}\addcolon\space%
+ \bib@online{https://www.ncbi.nlm.nih.gov/pmc/articles/PMC#1}{#1}%
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{pmcid}
+% \begin{macro}{pmid}
+% \begin{macro}{reportnumber}
+% Add the pre-print and PubMed information if present.
+% \begin{macrocode}
+\letbibmacro{hep-doi+eprint+url}{doi+eprint+url}
+\renewbibmacro*{doi+eprint+url}{%
+ \usebibmacro{hep-doi+eprint+url}
+ \iffieldundef{pmc}{%
+ \iffieldundef{pmid}{}{\printfield{pmid}\newunit}%
+ }{\printfield{pmc}\newunit}
+ \iffieldundef{reportnumber}{}{%
+ \newunitpunct\textnumero\intitlepunct%
+ \printfield{reportnumber}\newunit%
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+
+% \subsection{Eprints}
+%
+% \begin{macro}{\new@eprint}
+% Private "\new@eprint" macro
+% \begin{macrocode}
+\NewDocumentCommand{\new@eprint}{smm}{
+ \DeclareFieldFormat{eprint:#2}{%
+ \newcommand{\@path}{\IfBooleanT{#1}{\thefield{eprintclass}/}##1}%
+ #2\addcolon\space\bib@online{#3/\@path}{\@path}%
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{CTAN}
+% Add CTAN as a eprint option
+% \begin{macrocode}
+\new@eprint{CTAN}{https://ctan.org/pkg}
+\DeclareFieldAlias{eprint:ctan}{eprint:CTAN}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{GitHub}
+% Add GitHub as a eprint option
+% \begin{macrocode}
+\new@eprint*{GitHub}{https://github.com}
+\DeclareFieldAlias{eprint:github}{eprint:GitHub}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{GitLab}
+% Add GitLab as a eprint option
+% \begin{macrocode}
+\new@eprint*{GitLab}{https://gitlab.com}
+\DeclareFieldAlias{eprint:gitlab}{eprint:GitLab}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{Bitbucket}
+% Add Bitbucket as a eprint option
+% \begin{macrocode}
+\new@eprint*{Bitbucket}{https://bitbucket.org}
+\DeclareFieldAlias{eprint:bitbucket}{eprint:Bitbucket}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{Launchpad}
+% Add Launchpad as a eprint option
+% \begin{macrocode}
+\new@eprint{Launchpad}{https://launchpad.net}
+\DeclareFieldAlias{eprint:launchpad}{eprint:Launchpad}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{SourceForge}
+% Add SourceForge as a eprint option
+% \begin{macrocode}
+\new@eprint{SourceForge}{https://sourceforge.net/projects}
+\DeclareFieldAlias{eprint:launchpad}{eprint:SourceForge}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{HEPForge}
+% Add HEPForge as a eprint option
+% \begin{macrocode}
+\DeclareFieldFormat{eprint:hepforge}{%
+ HEPForge\addcolon\space\bib@online{https://#1/hepforge.org}{#1}%
+}
+\DeclareFieldAlias{eprint:HEPForge}{eprint:hepforge}
+% \end{macrocode}
+% \end{macro}
+%
+% Define bibstrings for reference names.
+% \begin{macrocode}
+\NewBibliographyString{refname}
+\NewBibliographyString{refsname}
+\DefineBibliographyStrings{english}{%
+ refname = {reference},
+ refsname = {references}
+}
+% \end{macrocode}
+% \begin{macro}{\ccite}
+% \begin{macro}{\Ccite}
+% Define \emph{clever} citation macros.
+% \begin{macrocode}
+\DeclareCiteCommand{\ccite}{%
+ \ifnum\thecitetotal=1
+ \bibstring{refname}%
+ \else%
+ \bibstring{refsname}%
+ \fi%
+ \addnbspace\bibopenbracket%
+ \usebibmacro{cite:init}\usebibmacro{prenote}%
+}{\usebibmacro{citeindex}\usebibmacro{cite:comp}}{}{%
+ \usebibmacro{cite:dump}\usebibmacro{postnote}%
+ \bibclosebracket%
+}
+
+\newrobustcmd*{\Ccite}{\bibsentence\ccite}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%</package>
+%
+% \section{Biblatex datamodel file} \label{sec:data model}
+%
+%<*datamodel>
+%
+% \begin{macro}{collaboration}
+% \begin{macro}{pmid}
+% \begin{macro}{pmcid}
+% \begin{macro}{pmc}
+% \begin{macro}{reportnumber}
+% \begin{macro}{protocollessurl}
+% Define the "dbx" file containing the "hep-bibliography" datamodel.
+% \begin{macrocode}
+\DeclareDatamodelFields[type=field, datatype=literal]{
+ collaboration, pmid, pmcid, pmc,
+}
+\DeclareDatamodelFields[type=field, format=xsv, datatype=literal]{
+ reportnumber,
+}
+\DeclareDatamodelFields[type=field, datatype=uri]{protocollessurl}
+\DeclareDatamodelEntryfields{
+ collaboration, pmid, pmcid, pmc, reportnumber, protocollessurl,
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+%</datamodel>
+%
+% \section{Test}
+%
+%<*test>
+% \begin{macrocode}
+\documentclass[twocolumn,a4paper]{article}
+
+\usepackage{hep-bibliography}
+
+\begin{filecontents}{\jobname.bib}
+@article{Ade:2015xua,
+ author = "Ade, P. A. R. and others",
+ collaboration = "Planck",
+ title = "{Planck 2015 results. XIII. Cosmological parameters}",
+ eprint = "1502.01589",
+ archivePrefix = "arXiv",
+ primaryClass = "astro-ph.CO",
+ doi = "10.1051/0004-6361/201525830",
+ journal = "Astron. Astrophys.",
+ volume = "594",
+ pages = "A13",
+ year = "2016"
+}
+
+@article{Agashe:2014kda,
+ author = "Olive, K. A. and others",
+ collaboration = "Particle Data Group",
+ title = "{Review of Particle Physics}",
+ doi = "10.1088/1674-1137/38/9/090001",
+ journal = "Chin. Phys. C",
+ volume = "38",
+ pages = "090001",
+ year = "2014"
+}
+
+@article{Ade:2013zuv,
+ author = "Ade, P. A. R. and others",
+ collaboration = "Planck",
+ title = "{Planck 2013 results. XVI. Cosmological parameters}",
+ eprint = "1303.5076",
+ archivePrefix = "arXiv",
+ primaryClass = "astro-ph.CO",
+ reportNumber = "CERN-PH-TH-2013-129",
+ doi = "10.1051/0004-6361/201321591",
+ journal = "Astron. Astrophys.",
+ volume = "571",
+ pages = "A16",
+ year = "2014"
+}
+
+@article{Aad:2012tfa,
+ author = "Aad, Georges and others",
+ collaboration = "ATLAS",
+ title = "{Observation of a new particle in the search for the Standard Model Higgs boson with the ATLAS detector at the LHC}",
+ eprint = "1207.7214",
+ archivePrefix = "arXiv",
+ primaryClass = "hep-ex",
+ reportNumber = "CERN-PH-EP-2012-218",
+ doi = "10.1016/j.physletb.2012.08.020",
+ journal = "Phys. Lett. B",
+ volume = "716",
+ pages = "1--29",
+ year = "2012"
+}
+
+@article{Chatrchyan:2012ufa,
+ author = "Chatrchyan, Serguei and others",
+ collaboration = "CMS",
+ title = "{Observation of a New Boson at a Mass of 125 GeV with the CMS Experiment at the LHC}",
+ eprint = "1207.7235",
+ archivePrefix = "arXiv",
+ primaryClass = "hep-ex",
+ reportNumber = "CMS-HIG-12-028, CERN-PH-EP-2012-220",
+ doi = "10.1016/j.physletb.2012.08.021",
+ journal = "Phys. Lett. B",
+ volume = "716",
+ pages = "30--61",
+ year = "2012"
+}
+
+@article{Beringer:1900zz,
+ author = "Beringer, J. and others",
+ collaboration = "Particle Data Group",
+ title = "{Review of Particle Physics (RPP)}",
+ reportNumber = "SLAC-REPRINT-2014-001",
+ doi = "10.1103/PhysRevD.86.010001",
+ journal = "Phys. Rev. D",
+ volume = "86",
+ pages = "010001",
+ year = "2012"
+}
+
+@article{Chatrchyan:2008aa,
+ author = "Chatrchyan, S. and others",
+ collaboration = "CMS",
+ title = "{The CMS Experiment at the CERN LHC}",
+ doi = "10.1088/1748-0221/3/08/S08004",
+ journal = "JINST",
+ volume = "3",
+ pages = "S08004",
+ year = "2008"
+}
+
+@article{Cacciari:2008gp,
+ author = "Cacciari, Matteo and Salam, Gavin P. and Soyez, Gregory",
+ title = "{The anti-$k_t$ jet clustering algorithm}",
+ eprint = "0802.1189",
+ archivePrefix = "arXiv",
+ primaryClass = "hep-ph",
+ reportNumber = "LPTHE-07-03",
+ doi = "10.1088/1126-6708/2008/04/063",
+ journal = "JHEP",
+ volume = "04",
+ pages = "063",
+ year = "2008"
+}
+
+@article{Aad:2008zzm,
+ author = "Aad, G. and others",
+ collaboration = "ATLAS",
+ title = "{The ATLAS Experiment at the CERN Large Hadron Collider}",
+ doi = "10.1088/1748-0221/3/08/S08003",
+ journal = "JINST",
+ volume = "3",
+ pages = "S08003",
+ year = "2008"
+}
+
+@article{Sjostrand:2006za,
+ author = "Sjostrand, Torbjorn and Mrenna, Stephen and Skands, Peter Z.",
+ title = "{PYTHIA 6.4 Physics and Manual}",
+ eprint = "hep-ph/0603175",
+ archivePrefix = "arXiv",
+ reportNumber = "FERMILAB-PUB-06-052-CD-T, LU-TP-06-13",
+ doi = "10.1088/1126-6708/2006/05/026",
+ journal = "JHEP",
+ volume = "05",
+ pages = "026",
+ year = "2006"
+}
+
+@article{Spergel:2003cb,
+ author = "Spergel, D. N. and others",
+ collaboration = "WMAP",
+ title = "{First year Wilkinson Microwave Anisotropy Probe (WMAP) observations: Determination of cosmological parameters}",
+ eprint = "astro-ph/0302209",
+ archivePrefix = "arXiv",
+ doi = "10.1086/377226",
+ journal = "Astrophys. J. Suppl.",
+ volume = "148",
+ pages = "175--194",
+ year = "2003"
+}
+
+@article{Agostinelli:2002hh,
+ author = "Agostinelli, S. and others",
+ collaboration = "GEANT4",
+ title = "{GEANT4--a simulation toolkit}",
+ reportNumber = "SLAC-PUB-9350, FERMILAB-PUB-03-339, CERN-IT-2002-003",
+ doi = "10.1016/S0168-9002(03)01368-8",
+ journal = "Nucl. Instrum. Meth. A",
+ volume = "506",
+ pages = "250--303",
+ year = "2003"
+}
+
+@article{Randall:1999ee,
+ author = "Randall, Lisa and Sundrum, Raman",
+ title = "{A Large mass hierarchy from a small extra dimension}",
+ eprint = "hep-ph/9905221",
+ archivePrefix = "arXiv",
+ reportNumber = "MIT-CTP-2860, PUPT-1860, BUHEP-99-9",
+ doi = "10.1103/PhysRevLett.83.3370",
+ journal = "Phys. Rev. Lett.",
+ volume = "83",
+ pages = "3370--3373",
+ year = "1999"
+}
+
+@article{Perlmutter:1998np,
+ author = "Perlmutter, S. and others",
+ collaboration = "Supernova Cosmology Project",
+ title = "{Measurements of $\Omega$ and $\Lambda$ from 42 high redshift supernovae}",
+ eprint = "astro-ph/9812133",
+ archivePrefix = "arXiv",
+ reportNumber = "LBNL-41801, LBL-41801",
+ doi = "10.1086/307221",
+ journal = "Astrophys. J.",
+ volume = "517",
+ pages = "565--586",
+ year = "1999"
+}
+
+@article{Riess:1998cb,
+ author = "Riess, Adam G. and others",
+ collaboration = "Supernova Search Team",
+ title = "{Observational evidence from supernovae for an accelerating universe and a cosmological constant}",
+ eprint = "astro-ph/9805201",
+ archivePrefix = "arXiv",
+ doi = "10.1086/300499",
+ journal = "Astron. J.",
+ volume = "116",
+ pages = "1009--1038",
+ year = "1998"
+}
+
+@article{Witten:1998qj,
+ author = "Witten, Edward",
+ title = "{Anti-de Sitter space and holography}",
+ eprint = "hep-th/9802150",
+ archivePrefix = "arXiv",
+ reportNumber = "IASSNS-HEP-98-15",
+ doi = "10.4310/ATMP.1998.v2.n2.a2",
+ journal = "Adv. Theor. Math. Phys.",
+ volume = "2",
+ pages = "253--291",
+ year = "1998"
+}
+
+@article{Gubser:1998bc,
+ author = "Gubser, S. S. and Klebanov, Igor R. and Polyakov, Alexander M.",
+ title = "{Gauge theory correlators from noncritical string theory}",
+ eprint = "hep-th/9802109",
+ archivePrefix = "arXiv",
+ reportNumber = "PUPT-1767",
+ doi = "10.1016/S0370-2693(98)00377-3",
+ journal = "Phys. Lett. B",
+ volume = "428",
+ pages = "105--114",
+ year = "1998"
+}
+
+@article{Maldacena:1997re,
+ author = "Maldacena, Juan Martin",
+ title = "{The Large N limit of superconformal field theories and supergravity}",
+ eprint = "hep-th/9711200",
+ archivePrefix = "arXiv",
+ reportNumber = "HUTP-97-A097, HUTP-98-A097",
+ doi = "10.1023/A:1026654312961",
+ journal = "Adv. Theor. Math. Phys.",
+ volume = "2",
+ pages = "231--252",
+ year = "1998"
+}
+
+@article{Schlegel:1997yv,
+ author = "Schlegel, David J. and Finkbeiner, Douglas P. and Davis, Marc",
+ title = "{Maps of dust IR emission for use in estimation of reddening and CMBR foregrounds}",
+ eprint = "astro-ph/9710327",
+ archivePrefix = "arXiv",
+ doi = "10.1086/305772",
+ journal = "Astrophys. J.",
+ volume = "500",
+ pages = "525",
+ year = "1998"
+}
+
+@article{Guth:1980zm,
+ author = "Guth, Alan H.",
+ editor = "Fang, Li-Zhi and Ruffini, R.",
+ title = "{The Inflationary Universe: A Possible Solution to the Horizon and Flatness Problems}",
+ reportNumber = "SLAC-PUB-2576",
+ doi = "10.1103/PhysRevD.23.347",
+ journal = "Phys. Rev. D",
+ volume = "23",
+ pages = "347--356",
+ year = "1981"
+}
+
+@article{Altarelli:1977zs,
+ author = "Altarelli, Guido and Parisi, G.",
+ title = "{Asymptotic Freedom in Parton Language}",
+ reportNumber = "LPTENS-77-6",
+ doi = "10.1016/0550-3213(77)90384-4",
+ journal = "Nucl. Phys. B",
+ volume = "126",
+ pages = "298--318",
+ year = "1977"
+}
+
+@article{Hawking:1974sw,
+ author = "Hawking, S. W.",
+ editor = "Gibbons, G. W. and Hawking, S. W.",
+ title = "{Particle Creation by Black Holes}",
+ doi = "10.1007/BF02345020",
+ journal = "Commun. Math. Phys.",
+ volume = "43",
+ pages = "199--220",
+ year = "1975",
+ related = "Hawking:1974sw-1",
+ relatedtype = "erratum"
+}
+
+@article{Kobayashi:1973fv,
+ author = "Kobayashi, Makoto and Maskawa, Toshihide",
+ title = "{CP Violation in the Renormalizable Theory of Weak Interaction}",
+ reportNumber = "KUNS-242",
+ doi = "10.1143/PTP.49.652",
+ journal = "Prog. Theor. Phys.",
+ volume = "49",
+ pages = "652--657",
+ year = "1973"
+}
+
+@article{Weinberg:1967tq,
+ author = "Weinberg, Steven",
+ title = "{A Model of Leptons}",
+ doi = "10.1103/PhysRevLett.19.1264",
+ journal = "Phys. Rev. Lett.",
+ volume = "19",
+ pages = "1264--1266",
+ year = "1967"
+}
+
+@article{Glashow:1961tr,
+ author = "Glashow, S. L.",
+ title = "{Partial Symmetries of Weak Interactions}",
+ doi = "10.1016/0029-5582(61)90469-2",
+ journal = "Nucl. Phys.",
+ volume = "22",
+ pages = "579--588",
+ year = "1961"
+}
+
+@article{Hawking:1974sw-1,
+ author = "Hawking, S. W.",
+ journal = "Commun. Math. Phys.",
+ volume = "46",
+ pages = "206",
+ year = "1976",
+ options = {skipbib=true}
+}
+\end{filecontents}
+\bibliography{\jobname}
+\nocite{*}
+\usepackage{hyperref}
+
+\begin{document}
+\printbibliography
+\end{document}
+% \end{macrocode}
+%</test>
+%
+% \section{Readme}
+%
+%<*readme>
+%
+% \begin{macrocode}
+# The `hep-bibliography` package
+
+Bibliographies for high energy physics
+
+## Introduction
+
+The `hep-bibliography` package extends the `biblatex` package with some functionality mostly useful for high energy physics.
+In particular it makes full use of all `bibtex` fields provided by `inspirehep.net`.
+
+The package can be loaded via `\usepackage{hep-bibliography}`.
+
+## Author
+
+Jan Hajer
+
+## License
+
+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.
+% \end{macrocode}
+%
+%</readme>
+%
+% \Finale
+
+\endinput
+
+% \PrintIndex
+% makeindex -s gglo.ist -o hep-bibliography-implementation.gls hep-bibliography-implementation.glo
+% makeindex -s gglo.ist -o hep-bibliography-implementation.ind hep-bibliography-implementation.idx
diff --git a/macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography-implementation.pdf b/macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography-implementation.pdf
new file mode 100644
index 0000000000..50a4805ac1
--- /dev/null
+++ b/macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography-implementation.pdf
Binary files differ
diff --git a/macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography.ins b/macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography.ins
new file mode 100644
index 0000000000..06c54faa88
--- /dev/null
+++ b/macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography.ins
@@ -0,0 +1,50 @@
+%% 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.
+
+\input docstrip.tex
+\keepsilent
+\usedir{tex/latex/hep-bibliography}
+
+\preamble
+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.
+\endpreamble
+
+\generate{
+ \file{hep-bibliography-documentation.tex}{\from{hep-bibliography-implementation.dtx}{documentation}}
+ \file{hep-bibliography.sty}{\from{hep-bibliography-implementation.dtx}{package}}
+ \file{hep-bibliography.dbx}{\from{hep-bibliography-implementation.dtx}{datamodel}}
+ \file{hep-bibliography-test.tex}{\from{hep-bibliography-implementation.dtx}{test}}
+ \nopreamble\nopostamble\file{README-hep-bibliography.md}{\from{hep-bibliography-implementation.dtx}{readme}}
+}
+
+\Msg{*********************************************************}
+\Msg{*}
+\Msg{* To finish the installation you have to move the}
+\Msg{* following file into a directory searched by TeX:}
+\Msg{*}
+\Msg{* \space\space hep-bibliography.sty}
+\Msg{*}
+\Msg{* To produce the documentation run the file}
+\Msg{* hep-bibliography-documentation.dtx through LaTeX.}
+\Msg{*}
+\Msg{* Happy TeXing!}
+\Msg{*********************************************************}
+
+\endbatchfile
diff --git a/macros/latex/contrib/biblatex-contrib/hep-bibliography/license.md b/macros/latex/contrib/biblatex-contrib/hep-bibliography/license.md
new file mode 100644
index 0000000000..494f58131f
--- /dev/null
+++ b/macros/latex/contrib/biblatex-contrib/hep-bibliography/license.md
@@ -0,0 +1,416 @@
+The LaTeX Project Public License
+=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
+
+LPPL Version 1.3c 2008-05-04
+
+Copyright 1999 2002-2008 LaTeX3 Project
+ Everyone is allowed to distribute verbatim copies of this
+ license document, but modification of it is not allowed.
+
+
+PREAMBLE
+========
+
+The LaTeX Project Public License (LPPL) is the primary license under
+which the LaTeX kernel and the base LaTeX packages are distributed.
+
+You may use this license for any work of which you hold the copyright
+and which you wish to distribute. This license may be particularly
+suitable if your work is TeX-related (such as a LaTeX package), but
+it is written in such a way that you can use it even if your work is
+unrelated to TeX.
+
+The section `WHETHER AND HOW TO DISTRIBUTE WORKS UNDER THIS LICENSE',
+below, gives instructions, examples, and recommendations for authors
+who are considering distributing their works under this license.
+
+This license gives conditions under which a work may be distributed
+and modified, as well as conditions under which modified versions of
+that work may be distributed.
+
+We, the LaTeX3 Project, believe that the conditions below give you
+the freedom to make and distribute modified versions of your work
+that conform with whatever technical specifications you wish while
+maintaining the availability, integrity, and reliability of
+that work. If you do not see how to achieve your goal while
+meeting these conditions, then read the document `cfgguide.tex'
+and `modguide.tex' in the base LaTeX distribution for suggestions.
+
+
+DEFINITIONS
+===========
+
+In this license document the following terms are used:
+
+ `Work'
+ Any work being distributed under this License.
+
+ `Derived Work'
+ Any work that under any applicable law is derived from the Work.
+
+ `Modification'
+ Any procedure that produces a Derived Work under any applicable
+ law -- for example, the production of a file containing an
+ original file associated with the Work or a significant portion of
+ such a file, either verbatim or with modifications and/or
+ translated into another language.
+
+ `Modify'
+ To apply any procedure that produces a Derived Work under any
+ applicable law.
+
+ `Distribution'
+ Making copies of the Work available from one person to another, in
+ whole or in part. Distribution includes (but is not limited to)
+ making any electronic components of the Work accessible by
+ file transfer protocols such as FTP or HTTP or by shared file
+ systems such as Sun's Network File System (NFS).
+
+ `Compiled Work'
+ A version of the Work that has been processed into a form where it
+ is directly usable on a computer system. This processing may
+ include using installation facilities provided by the Work,
+ transformations of the Work, copying of components of the Work, or
+ other activities. Note that modification of any installation
+ facilities provided by the Work constitutes modification of the Work.
+
+ `Current Maintainer'
+ A person or persons nominated as such within the Work. If there is
+ no such explicit nomination then it is the `Copyright Holder' under
+ any applicable law.
+
+ `Base Interpreter'
+ A program or process that is normally needed for running or
+ interpreting a part or the whole of the Work.
+
+ A Base Interpreter may depend on external components but these
+ are not considered part of the Base Interpreter provided that each
+ external component clearly identifies itself whenever it is used
+ interactively. Unless explicitly specified when applying the
+ license to the Work, the only applicable Base Interpreter is a
+ `LaTeX-Format' or in the case of files belonging to the
+ `LaTeX-format' a program implementing the `TeX language'.
+
+
+
+CONDITIONS ON DISTRIBUTION AND MODIFICATION
+===========================================
+
+1. Activities other than distribution and/or modification of the Work
+are not covered by this license; they are outside its scope. In
+particular, the act of running the Work is not restricted and no
+requirements are made concerning any offers of support for the Work.
+
+2. You may distribute a complete, unmodified copy of the Work as you
+received it. Distribution of only part of the Work is considered
+modification of the Work, and no right to distribute such a Derived
+Work may be assumed under the terms of this clause.
+
+3. You may distribute a Compiled Work that has been generated from a
+complete, unmodified copy of the Work as distributed under Clause 2
+above, as long as that Compiled Work is distributed in such a way that
+the recipients may install the Compiled Work on their system exactly
+as it would have been installed if they generated a Compiled Work
+directly from the Work.
+
+4. If you are the Current Maintainer of the Work, you may, without
+restriction, modify the Work, thus creating a Derived Work. You may
+also distribute the Derived Work without restriction, including
+Compiled Works generated from the Derived Work. Derived Works
+distributed in this manner by the Current Maintainer are considered to
+be updated versions of the Work.
+
+5. If you are not the Current Maintainer of the Work, you may modify
+your copy of the Work, thus creating a Derived Work based on the Work,
+and compile this Derived Work, thus creating a Compiled Work based on
+the Derived Work.
+
+6. If you are not the Current Maintainer of the Work, you may
+distribute a Derived Work provided the following conditions are met
+for every component of the Work unless that component clearly states
+in the copyright notice that it is exempt from that condition. Only
+the Current Maintainer is allowed to add such statements of exemption
+to a component of the Work.
+
+ a. If a component of this Derived Work can be a direct replacement
+ for a component of the Work when that component is used with the
+ Base Interpreter, then, wherever this component of the Work
+ identifies itself to the user when used interactively with that
+ Base Interpreter, the replacement component of this Derived Work
+ clearly and unambiguously identifies itself as a modified version
+ of this component to the user when used interactively with that
+ Base Interpreter.
+
+ b. Every component of the Derived Work contains prominent notices
+ detailing the nature of the changes to that component, or a
+ prominent reference to another file that is distributed as part
+ of the Derived Work and that contains a complete and accurate log
+ of the changes.
+
+ c. No information in the Derived Work implies that any persons,
+ including (but not limited to) the authors of the original version
+ of the Work, provide any support, including (but not limited to)
+ the reporting and handling of errors, to recipients of the
+ Derived Work unless those persons have stated explicitly that
+ they do provide such support for the Derived Work.
+
+ d. You distribute at least one of the following with the Derived Work:
+
+ 1. A complete, unmodified copy of the Work;
+ if your distribution of a modified component is made by
+ offering access to copy the modified component from a
+ designated place, then offering equivalent access to copy
+ the Work from the same or some similar place meets this
+ condition, even though third parties are not compelled to
+ copy the Work along with the modified component;
+
+ 2. Information that is sufficient to obtain a complete,
+ unmodified copy of the Work.
+
+7. If you are not the Current Maintainer of the Work, you may
+distribute a Compiled Work generated from a Derived Work, as long as
+the Derived Work is distributed to all recipients of the Compiled
+Work, and as long as the conditions of Clause 6, above, are met with
+regard to the Derived Work.
+
+8. The conditions above are not intended to prohibit, and hence do not
+apply to, the modification, by any method, of any component so that it
+becomes identical to an updated version of that component of the Work as
+it is distributed by the Current Maintainer under Clause 4, above.
+
+9. Distribution of the Work or any Derived Work in an alternative
+format, where the Work or that Derived Work (in whole or in part) is
+then produced by applying some process to that format, does not relax or
+nullify any sections of this license as they pertain to the results of
+applying that process.
+
+10. a. A Derived Work may be distributed under a different license
+ provided that license itself honors the conditions listed in
+ Clause 6 above, in regard to the Work, though it does not have
+ to honor the rest of the conditions in this license.
+
+ b. If a Derived Work is distributed under a different license, that
+ Derived Work must provide sufficient documentation as part of
+ itself to allow each recipient of that Derived Work to honor the
+ restrictions in Clause 6 above, concerning changes from the Work.
+
+11. This license places no restrictions on works that are unrelated to
+the Work, nor does this license place any restrictions on aggregating
+such works with the Work by any means.
+
+12. Nothing in this license is intended to, or may be used to, prevent
+complete compliance by all parties with all applicable laws.
+
+
+NO WARRANTY
+===========
+
+There is no warranty for the Work. Except when otherwise stated in
+writing, the Copyright Holder provides the Work `as is', without
+warranty of any kind, either expressed or implied, including, but not
+limited to, the implied warranties of merchantability and fitness for a
+particular purpose. The entire risk as to the quality and performance
+of the Work is with you. Should the Work prove defective, you assume
+the cost of all necessary servicing, repair, or correction.
+
+In no event unless required by applicable law or agreed to in writing
+will The Copyright Holder, or any author named in the components of the
+Work, or any other party who may distribute and/or modify the Work as
+permitted above, be liable to you for damages, including any general,
+special, incidental or consequential damages arising out of any use of
+the Work or out of inability to use the Work (including, but not limited
+to, loss of data, data being rendered inaccurate, or losses sustained by
+anyone as a result of any failure of the Work to operate with any other
+programs), even if the Copyright Holder or said author or said other
+party has been advised of the possibility of such damages.
+
+
+MAINTENANCE OF THE WORK
+=======================
+
+The Work has the status `author-maintained' if the Copyright Holder
+explicitly and prominently states near the primary copyright notice in
+the Work that the Work can only be maintained by the Copyright Holder
+or simply that it is `author-maintained'.
+
+The Work has the status `maintained' if there is a Current Maintainer
+who has indicated in the Work that they are willing to receive error
+reports for the Work (for example, by supplying a valid e-mail
+address). It is not required for the Current Maintainer to acknowledge
+or act upon these error reports.
+
+The Work changes from status `maintained' to `unmaintained' if there
+is no Current Maintainer, or the person stated to be Current
+Maintainer of the work cannot be reached through the indicated means
+of communication for a period of six months, and there are no other
+significant signs of active maintenance.
+
+You can become the Current Maintainer of the Work by agreement with
+any existing Current Maintainer to take over this role.
+
+If the Work is unmaintained, you can become the Current Maintainer of
+the Work through the following steps:
+
+ 1. Make a reasonable attempt to trace the Current Maintainer (and
+ the Copyright Holder, if the two differ) through the means of
+ an Internet or similar search.
+
+ 2. If this search is successful, then enquire whether the Work
+ is still maintained.
+
+ a. If it is being maintained, then ask the Current Maintainer
+ to update their communication data within one month.
+
+ b. If the search is unsuccessful or no action to resume active
+ maintenance is taken by the Current Maintainer, then announce
+ within the pertinent community your intention to take over
+ maintenance. (If the Work is a LaTeX work, this could be
+ done, for example, by posting to comp.text.tex.)
+
+ 3a. If the Current Maintainer is reachable and agrees to pass
+ maintenance of the Work to you, then this takes effect
+ immediately upon announcement.
+
+ b. If the Current Maintainer is not reachable and the Copyright
+ Holder agrees that maintenance of the Work be passed to you,
+ then this takes effect immediately upon announcement.
+
+ 4. If you make an `intention announcement' as described in 2b. above
+ and after three months your intention is challenged neither by
+ the Current Maintainer nor by the Copyright Holder nor by other
+ people, then you may arrange for the Work to be changed so as
+ to name you as the (new) Current Maintainer.
+
+ 5. If the previously unreachable Current Maintainer becomes
+ reachable once more within three months of a change completed
+ under the terms of 3b) or 4), then that Current Maintainer must
+ become or remain the Current Maintainer upon request provided
+ they then update their communication data within one month.
+
+A change in the Current Maintainer does not, of itself, alter the fact
+that the Work is distributed under the LPPL license.
+
+If you become the Current Maintainer of the Work, you should
+immediately provide, within the Work, a prominent and unambiguous
+statement of your status as Current Maintainer. You should also
+announce your new status to the same pertinent community as
+in 2b) above.
+
+
+WHETHER AND HOW TO DISTRIBUTE WORKS UNDER THIS LICENSE
+======================================================
+
+This section contains important instructions, examples, and
+recommendations for authors who are considering distributing their
+works under this license. These authors are addressed as `you' in
+this section.
+
+Choosing This License or Another License
+----------------------------------------
+
+If for any part of your work you want or need to use *distribution*
+conditions that differ significantly from those in this license, then
+do not refer to this license anywhere in your work but, instead,
+distribute your work under a different license. You may use the text
+of this license as a model for your own license, but your license
+should not refer to the LPPL or otherwise give the impression that
+your work is distributed under the LPPL.
+
+The document `modguide.tex' in the base LaTeX distribution explains
+the motivation behind the conditions of this license. It explains,
+for example, why distributing LaTeX under the GNU General Public
+License (GPL) was considered inappropriate. Even if your work is
+unrelated to LaTeX, the discussion in `modguide.tex' may still be
+relevant, and authors intending to distribute their works under any
+license are encouraged to read it.
+
+A Recommendation on Modification Without Distribution
+-----------------------------------------------------
+
+It is wise never to modify a component of the Work, even for your own
+personal use, without also meeting the above conditions for
+distributing the modified component. While you might intend that such
+modifications will never be distributed, often this will happen by
+accident -- you may forget that you have modified that component; or
+it may not occur to you when allowing others to access the modified
+version that you are thus distributing it and violating the conditions
+of this license in ways that could have legal implications and, worse,
+cause problems for the community. It is therefore usually in your
+best interest to keep your copy of the Work identical with the public
+one. Many works provide ways to control the behavior of that work
+without altering any of its licensed components.
+
+How to Use This License
+-----------------------
+
+To use this license, place in each of the components of your work both
+an explicit copyright notice including your name and the year the work
+was authored and/or last substantially modified. Include also a
+statement that the distribution and/or modification of that
+component is constrained by the conditions in this license.
+
+Here is an example of such a notice and statement:
+
+ %% pig.dtx
+ %% Copyright 2005 M. Y. Name
+ %
+ % This work may be distributed and/or modified under the
+ % conditions of the LaTeX Project Public License, either version 1.3
+ % 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.3 or later is part of all distributions of LaTeX
+ % version 2005/12/01 or later.
+ %
+ % This work has the LPPL maintenance status `maintained'.
+ %
+ % The Current Maintainer of this work is M. Y. Name.
+ %
+ % This work consists of the files pig.dtx and pig.ins
+ % and the derived file pig.sty.
+
+Given such a notice and statement in a file, the conditions
+given in this license document would apply, with the `Work' referring
+to the three files `pig.dtx', `pig.ins', and `pig.sty' (the last being
+generated from `pig.dtx' using `pig.ins'), the `Base Interpreter'
+referring to any `LaTeX-Format', and both `Copyright Holder' and
+`Current Maintainer' referring to the person `M. Y. Name'.
+
+If you do not want the Maintenance section of LPPL to apply to your
+Work, change `maintained' above into `author-maintained'.
+However, we recommend that you use `maintained', as the Maintenance
+section was added in order to ensure that your Work remains useful to
+the community even when you can no longer maintain and support it
+yourself.
+
+Derived Works That Are Not Replacements
+---------------------------------------
+
+Several clauses of the LPPL specify means to provide reliability and
+stability for the user community. They therefore concern themselves
+with the case that a Derived Work is intended to be used as a
+(compatible or incompatible) replacement of the original Work. If
+this is not the case (e.g., if a few lines of code are reused for a
+completely different task), then clauses 6b and 6d shall not apply.
+
+
+Important Recommendations
+-------------------------
+
+ Defining What Constitutes the Work
+
+ The LPPL requires that distributions of the Work contain all the
+ files of the Work. It is therefore important that you provide a
+ way for the licensee to determine which files constitute the Work.
+ This could, for example, be achieved by explicitly listing all the
+ files of the Work near the copyright notice of each file or by
+ using a line such as:
+
+ % This work consists of all files listed in manifest.txt.
+
+ in that place. In the absence of an unequivocal list it might be
+ impossible for the licensee to determine what is considered by you
+ to comprise the Work and, in such a case, the licensee would be
+ entitled to make reasonable conjectures as to which files comprise
+ the Work.
+
diff --git a/macros/latex/contrib/hep-acronym/README.md b/macros/latex/contrib/hep-acronym/README.md
new file mode 100644
index 0000000000..f7958ab064
--- /dev/null
+++ b/macros/latex/contrib/hep-acronym/README.md
@@ -0,0 +1,19 @@
+
+# The `hep-acronym` package
+
+An acronym extension for glossaries
+
+## Introduction
+
+The `hep-acronym` package provides an acronym macro based on the `glossaries` package.
+It can be loaded using `\usepackage{hep-acronym}`.
+
+## Author
+
+Jan Hajer
+
+## License
+
+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.
+
diff --git a/macros/latex/contrib/hep-acronym/bibliography.bib b/macros/latex/contrib/hep-acronym/bibliography.bib
new file mode 100644
index 0000000000..e5117be3d5
--- /dev/null
+++ b/macros/latex/contrib/hep-acronym/bibliography.bib
@@ -0,0 +1,1055 @@
+@article{hep-paper,
+title = "The |hep-paper| package",
+subtitle = "Publications in high energy physics",
+author = "Jan Hajer",
+year = "2019",
+eprinttype = "ctan",
+eprint = "hep-paper",
+related = "hep-paper-1",
+}
+
+@manual{hep-paper-1,
+doi = "10.5281/zenodo.3606436",
+eprinttype = "github",
+eprintclass = "janhajer",
+eprint = "hep-paper",
+}
+
+@article{hep-acronym,
+title = "The |hep-acronym| package",
+subtitle = "An acronym extension for glossaries",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-acronyms",
+related = "hep-paper-1",
+}
+
+@article{hep-bibliography,
+title = "The |hep-bibliography| package",
+subtitle = "Bibliographies for high energy physics",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-bibliography",
+related = "hep-paper-1",
+}
+
+@article{hep-float,
+title = "The |hep-float| package",
+subtitle = "Convenience package for float placement",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-float",
+related = "hep-paper-1",
+}
+
+@article{hep-font,
+title = "The |hep-font| package",
+subtitle = "Latin modern extended by computer modern",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-font",
+related = "hep-paper-1",
+}
+
+@article{hep-math-font,
+title = "The |hep-math-font| package",
+subtitle = "Extended Greek and sans serif math",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-math-font",
+related = "hep-paper-1",
+}
+
+@article{hep-math,
+title = "The |hep-math| package",
+subtitle = "Extended math macros",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-math",
+related = "hep-paper-1",
+}
+
+@article{hep-text,
+title = "The |hep-text| package",
+subtitle = "List and text extensions",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-text",
+related = "hep-paper-1",
+}
+
+@article{hep-title,
+title = "The |hep-title| package",
+subtitle = "Extensions for the title page",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-title",
+related = "hep-paper-1",
+}
+
+@article{kvoptions,
+title = "The |kvoptions| package",
+subtitle = "Key value format for package options",
+author = "Heiko Oberdiek",
+year = "2004",
+eprinttype = "ctan",
+eprint = "kvoptions",
+related = "kvoptions-1",
+}
+
+@manual{kvoptions-1,
+eprinttype = "github",
+eprintclass = "ho-tex",
+eprint = "kvoptions",
+}
+
+@article{cleveref,
+title = "The |cleveref| package",
+subtitle = "Intelligent cross-referencing",
+author = "Toby Cubitt",
+date = "2006",
+url = "http://dr-qubit.org/cleveref",
+eprinttype = "ctan",
+eprint = "cleveref",
+}
+
+@article{foreign,
+title = "The |foreign| package for \hologo{LaTeX2e}",
+subtitle = "Systematic treatment of \enquote{foreign} words in documents",
+author = "Philip G. Ratcliffe",
+date = "2012",
+eprinttype = "ctan",
+eprint = "foreign",
+}
+
+@article{geometry,
+title = "The |geometry| package",
+subtitle = "Flexible and complete interface to document dimensions",
+author = "David Carlisle and Hideo Umeki",
+date = "1996",
+eprinttype = "ctan",
+eprint = "geometry",
+related = "geometry-1",
+}
+
+@manual{geometry-1,
+eprinttype = "github",
+eprintclass = "davidcarlisle",
+eprint = "geometry",
+}
+
+@article{a4wide,
+title = "The |a4wide| package",
+subtitle = "\enquote{Wide} a4 layout",
+author = "Alexander Holt and Jean-François Lamy",
+date = "1986",
+eprinttype = "ctan",
+eprint = "a4wide",
+note = "depreciated and not used",
+}
+
+@article{microtype,
+title = "The |microtype| package",
+subtitle = "Subliminal refinements towards typographical perfection",
+author = "Robert Schlicht",
+date = "2004",
+eprinttype = "ctan",
+eprint = "microtype",
+}
+
+@article{authblk,
+title = "A \hologo{LaTeX} Package to Prepare Author and Affiliation Blocks",
+subtitle = "Support for footnote style author/affiliation",
+author = "Patrick W. Daly",
+date = "2001",
+eprinttype = "ctan",
+eprint = "authblk",
+}
+
+@article{bm,
+title = "The |bm| package",
+subtitle = "Access bold symbols in maths mode",
+author = "David Carlisle and Frank Mittelbach",
+collaboration = "\hologo{LaTeX} Team",
+date = "1993",
+eprinttype = "ctan",
+eprint = "bm",
+}
+
+@article{empheq,
+title = "The |empheq| package",
+author = "Lars Madsen and Morten Høgholm and Will Robertson and Joseph Wright",
+eprinttype = "ctan",
+eprint = "empheq",
+}
+
+@article{mathtools,
+title = "The |mathtools| package",
+subtitle = "Mathematical tools to use with |amsmath|",
+author = "Lars Madsen and Morten Høgholm and Will Robertson and Joseph Wright",
+date = "2004",
+eprinttype = "ctan",
+eprint = "mathtools",
+}
+
+@article{amsmath,
+title = "The |amsmath| package",
+subtitle = "AMS mathematical facilities for \hologo{LaTeX}",
+collaboration = "\hologo{LaTeX} Team",
+date = "1994",
+url = "https://ams.org/tex/amslatex",
+eprinttype = "ctan",
+eprint = "amsmath",
+}
+
+@article{amstext,
+title = "The |amstext| package",
+subtitle = "Typeset text fragments in mathematics",
+collaboration = "\hologo{LaTeX} Team",
+date = "1995",
+url = "https://ams.org/tex/amslatex",
+eprinttype = "ctan",
+eprint = "amstext",
+}
+
+@article{amsfonts,
+title = "The |amsfonts| package",
+subtitle = "\hologo{TeX} fonts from the American Mathematical Society",
+author = "Michael Downes and David M. Jones and Frank Mittelbach and Rainer Schöpf",
+collaboration = "American Mathematical Society",
+date = "1995",
+url = "https://ams.org/tex/amsfonts",
+eprinttype = "ctan",
+eprint = "amsfonts",
+}
+
+@article{amssymb,
+title = "The |amssymb| package",
+author = "Michael Downes and David M. Jones and Frank Mittelbach and Rainer Schöpf",
+collaboration = "American Mathematical Society",
+date = "1995",
+eprinttype = "ctan",
+eprint = "amsfonts",
+}
+
+@article{slashed,
+title = "The |slashed| package",
+subtitle = "Put a slash through characters",
+author = "David Carlisle",
+date = "1987",
+eprinttype = "ctan",
+eprint = "slashed",
+}
+
+@article{physics,
+title = "The |physics| package",
+subtitle = "Macros supporting the Mathematics of Physics",
+author = "Sergio C. de la Barrera",
+date = "2012",
+eprinttype = "ctan",
+eprint = "physics",
+}
+
+@article{units,
+title = "The |units| and |nicefrac| packages",
+subtitle = "Typeset units",
+author = "Axel Reichert",
+date = "1998",
+eprinttype = "ctan",
+eprint = "units",
+}
+
+@article{subcaption,
+title = "The |subcaption| package",
+subtitle = "Support for sub-captions",
+author = "Axel Sommerfeldt",
+date = "2007",
+eprinttype = "ctan",
+eprint = "subcaption",
+related = "caption-1",
+}
+
+@article{caption,
+title = "The |caption| package",
+subtitle = "Customising captions in floating environments",
+author = "Axel Sommerfeldt",
+date = "1994",
+eprinttype = "ctan",
+eprint = "caption",
+related = "caption-1",
+}
+
+@manual{caption-1,
+eprinttype = "gitlab",
+eprintclass = "axelsommerfeldt",
+eprint = "caption",
+}
+
+
+@article{biblatex,
+title = "The |biblatex| Package",
+subtitle = "Sophisticated Bibliographies in \hologo{LaTeX}",
+author = "Philipp Lehman and Joseph Wright and Audrey Boruvka and Philip Kime",
+date = "2006",
+eprinttype = "ctan",
+eprint = "biblatex",
+related = "biblatex-1",
+}
+
+@manual{biblatex-1,
+eprinttype = "github",
+eprintclass = "plk",
+eprint = "biblatex",
+}
+
+@article{hyperref,
+title = "Hypertext marks in \hologo{LaTeX}: a manual for |hyperref|",
+subtitle = "Extensive support for hypertext in \hologo{LaTeX}",
+author = "Sebastian Rahtz and Heiko Oberdiek",
+collaboration = "\hologo{LaTeX3} Project",
+date = "1995",
+eprinttype = "ctan",
+eprint = "hyperref",
+related = "hyperref-1",
+}
+
+@manual{hyperref-1,
+eprinttype = "github",
+eprintclass = "latex3",
+eprint = "hyperref",
+}
+
+@article{graphicx,
+title = "Packages in the \enquote{graphics} bundle",
+subtitle = "Enhanced support for graphics",
+author = "David Carlisle and Sebastian Rahtz",
+date = "1994",
+eprinttype = "ctan",
+eprint = "graphicx",
+}
+
+@article{booktabs,
+title = "The |booktabs| package",
+subtitle = "Publication quality tables in \hologo{LaTeX}",
+author = "Danie Els and Simon Fear",
+date = "1995",
+eprinttype = "ctan",
+eprint = "booktabs",
+}
+
+@article{multirow,
+title = "The |multirow|, |bigstrut| and |bigdelim| packages",
+subtitle = "Create tabular cells spanning multiple rows",
+author = "Piet van Oostrum and Jerry Leichter",
+date = "1994",
+eprinttype = "ctan",
+eprint = "multirow",
+}
+
+@article{fixmath,
+title = "The |fixmath| package for \hologo{LaTeX2e}",
+subtitle = "Make maths comply with ISO 31-0:1992 to ISO 31-13:1992",
+author = "Walter Schmidt",
+date = "2000",
+eprinttype = "ctan",
+eprint = "fixmath",
+}
+
+@article{alphabeta,
+title = "The |alphabeta| package",
+subtitle = "LICR macros and encoding definition files for Greek",
+author = "Günter Milde",
+date = "2013",
+eprinttype = "ctan",
+eprint = "greek-fontenc",
+}
+
+@article{textalpha,
+title = "The |textalpha| package",
+subtitle = "LICR macros and encoding definition files for Greek",
+author = "Günter Milde",
+date = "2010",
+eprinttype = "ctan",
+eprint = "greek-fontenc",
+}
+
+@article{arxiv-collector,
+title = "|arxiv-collector|",
+subtitle = "A little Python script to collect \hologo{LaTeX} sources for upload to the arXiv",
+author = "Dougal Sutherland",
+date = "2018",
+eprinttype = "github",
+eprintclass = "dougalsutherland",
+eprint = "arxiv-collector",
+}
+
+@article{biber,
+title = "\hologo{biber}",
+subtitle = "Backend processor for Bib\hologo{LaTeX}",
+author = "François Charette and Philip Kime",
+date = "2009",
+eprinttype = "github",
+eprintclass = "plk",
+eprint = "biber",
+related = "biber-1",
+}
+
+@manual{biber-1,
+eprinttype = "sourceforge",
+eprint = "biblatex-biber",
+}
+
+@article{lmodern,
+title = "Latin Modern Family of Fonts",
+subtitle = "Latin modern fonts in outline formats",
+date = "2003",
+author = "B. Jackowski and J.M. Nowacki",
+url = "http://gust.org.pl/projects/e-foundry/latin-modern",
+eprinttype = "ctan",
+eprint = "lm",
+}
+
+@article{ifluatex,
+title = "The |ifluatex| package",
+subtitle = "Provides the |\textbackslash ifluatex| switch",
+author = "Heiko Oberdiek",
+collaboration = "\hologo{LaTeX} Team",
+date = "2007",
+eprinttype = "ctan",
+eprint = "ifluatex",
+}
+
+@article{ifxetex,
+title = "The |iftex| package",
+subtitle = "Am I running under \hologo{XeTeX}?",
+collaboration = "\hologo{LaTeX} Team",
+author = "Will Robertson",
+date = "2006",
+eprinttype = "ctan",
+eprint = "ifxetex",
+related = "ifxetex-1",
+}
+
+@manual{ifxetex-1,
+eprinttype = "github",
+eprintclass = "latex3",
+eprint = "iftex",
+}
+
+@article{fontspec,
+title = "The |fontspec| package",
+subtitle = "Advanced font selection in \hologo{XeLaTeX} and \hologo{LuaLaTeX}",
+author = "Will Robertson and Khaled Hosny",
+date = "2004",
+eprinttype = "ctan",
+eprint = "fontspec",
+}
+
+@article{fontenc,
+title = "The |fontenc| package",
+subtitle = "Standard package for selecting font encodings",
+collaboration = "\hologo{LaTeX} Team",
+author = "Frank Mittelbach and Robin Fairbairns and Werner Lemberg",
+date = "1995",
+eprinttype = "ctan",
+eprint = "fontenc",
+}
+
+@article{inputenc,
+title = "The |inputenc| package",
+subtitle = "Accept different input encodings",
+collaboration = "\hologo{LaTeX} Team",
+author = "Frank Mittelbach and Alan Jeffrey",
+date = "1989",
+eprinttype = "ctan",
+eprint = "inputenc",
+}
+
+@article{textcomp,
+title = "The |textcomp| package",
+subtitle = "\hologo{LaTeX} support for the Text Companion fonts",
+collaboration = "\hologo{LaTeX} Team",
+author = "Sebastian Rahtz",
+date = "1995",
+eprinttype = "ctan",
+eprint = "textcomp",
+}
+
+@article{enumitem,
+title = "Customizing lists with the |enumitem| package",
+subtitle = "Control layout of itemize, enumerate, description",
+author = "Javier Bezos",
+date = "2003",
+url = "https://texnia.com/enumitem.html",
+eprinttype = "ctan",
+eprint = "enumitem",
+related = "enumitem-1",
+}
+
+@manual{enumitem-1,
+eprinttype = "github",
+eprintclass = "jbezos",
+eprint = "enumitem",
+}
+
+@article{atbegshi,
+title = "The |atbegshi| package",
+subtitle = "Execute stuff at |shipout| time",
+author = "Heiko Oberdiek",
+date = "2007",
+eprinttype = "ctan",
+eprint = "atbegshi",
+related = "atbegshi-1",
+}
+
+@manual{atbegshi-1,
+eprinttype = "github",
+eprintclass = "ho-tex",
+eprint = "atbegshi",
+}
+
+@article{picture,
+title = "The |picture| package",
+subtitle = "Dimens for picture macros",
+author = "Heiko Oberdiek",
+date = "2006",
+eprinttype = "ctan",
+eprint = "picture",
+related = "picture-1",
+}
+
+@manual{picture-1,
+eprinttype = "github",
+eprintclass = "ho-tex",
+eprint = "picture",
+}
+
+@article{varwidth,
+title = "The |varwidth| package",
+subtitle = "A variable-width minipage",
+author = "Donald Arseneau",
+date = "2003",
+eprinttype = "ctan",
+eprint = "varwidth",
+}
+
+@article{csquotes,
+title = "The |csquotes| Package",
+subtitle = "Context sensitive quotation facilities",
+author = "Philipp Lehman and Joseph Wright",
+date = "2003",
+eprinttype = "ctan",
+eprint = "csquotes",
+}
+
+@article{babel,
+title = "|Babel| Localization and internationalization",
+subtitle = "Multilingual support for Plain \hologo{TeX} or \hologo{LaTeX}",
+author = "Johannes Braams and Javier Bezos and at al.",
+date = "1989",
+eprinttype = "ctan",
+eprint = "babel",
+related = "babel-1",
+}
+
+@manual{babel-1,
+eprinttype = "github",
+eprintclass = "latex3",
+eprint = "babel",
+}
+
+@article{polyglossia,
+title = "The |polyglossia| package",
+author = "Arthur Reutenauer and François Charette and Elie Roux and Bastien Roucariès and Jürgen Spitzmüller",
+eprinttype = "ctan",
+eprint = "polyglossia",
+}
+
+@article{parskip,
+title = "The |parskip| package",
+subtitle = "Layout with zero |\textbackslash parindent|, non-zero |\textbackslash parskip|",
+author = "Robin Fairbairns and Frank Mittelbach and H. Partl",
+date = "1989",
+eprinttype = "ctan",
+eprint = "parskip",
+related = "parskip-1",
+}
+
+@manual{parskip-1,
+eprinttype = "github",
+eprintclass = "FrankMittelbach",
+eprint = "fmitex",
+}
+
+
+@article{fntguide,
+title = "\hologo{LaTeX2e}\ font selection",
+subtitle = "Docmentation of \hologo{LaTeX} font commands",
+collaboration = "\hologo{LaTeX} Team",
+date = "1995",
+eprinttype = "ctan",
+eprint = "fntguide",
+}
+
+@article{euenc,
+title = "The Experimental Unicode `EUx’ Encodings",
+author = "Will Robertson and Elie Roux and Khaled Hosny",
+eprinttype = "ctan",
+eprint = "euenc",
+}
+
+@article{soul,
+title = "The |soul| package",
+subtitle = "Hyphenation for letterspacing, underlining, and more",
+author = "Melchior Franz",
+date = "1998",
+eprinttype = "ctan",
+eprint = "soul",
+}
+
+@article{ulem,
+title = "The |ulem| package",
+subtitle = "Package for underlining",
+author = "Donald Arseneau",
+date = "1989",
+eprinttype = "ctan",
+eprint = "ulem",
+}
+
+@article{glossaries,
+title = "The |glossaries| package",
+subtitle = "Create glossaries and lists of acronyms",
+author = "Nicola Talbot",
+date = "2007",
+eprinttype = "ctan",
+eprint = "glossaries",
+}
+
+@article{glossaries-extra,
+title = "The |glossaries-extra| package",
+subtitle = "An extension to the |glossaries| package",
+author = "Dickimaw Books, Nicola Talbot",
+date = "2015",
+eprinttype = "ctan",
+eprint = "glossaries-extra",
+}
+
+@article{xparse,
+title = "The |xparse| package",
+subtitle = "A generic document command parser",
+author = "Frank Mittelbach and Chris Rowley and David Carlisle",
+collaboration = "\hologo{LaTeX3} Project",
+date = "1999",
+eprinttype = "ctan",
+eprint = "xparse",
+}
+
+@article{pdftexcmds,
+title = "The |pdftexcmds| package",
+subtitle = "\hologo{LuaTeX} support for \hologo{pdfTeX} utility functions",
+author = "Heiko Oberdiek",
+date = "2007",
+eprinttype = "ctan",
+eprint = "pdftexcmds",
+}
+
+@article{fix-cm,
+title = "The |fix-cm| package",
+subtitle = "Permit Computer Modern fonts at arbitrary sizes",
+author = "Frank Mittelbach and David Carlisle and Chris Rowley and Walter Schmidt",
+date = "1993",
+eprinttype = "ctan",
+eprint = "fix-cm",
+}
+
+@article{revtex,
+title = "The REV\hologo{TeX} class",
+subtitle = "Styles for various Physics Journals",
+author = "Mark Doyle and Arthur Ogawa",
+collaboration = "American Physical Society",
+date = "1999",
+url = "https://journals.aps.org/revtex",
+eprinttype = "ctan",
+eprint = "revtex",
+}
+
+@article{encguide,
+title = "\hologo{LaTeX} font encodings",
+subtitle = "Documentation of \hologo{LaTeX} font encodings",
+author = "Frank Mittelbach and Robin Fairbairns and Werner Lemberg",
+collaboration = "\hologo{LaTeX3} Project Team",
+date = "1995",
+eprinttype = "ctan",
+eprint = "encguide",
+}
+
+@article{sfmath,
+title = "The |sfmath| package",
+subtitle = "Sans-serif mathematics",
+author = "Olaf Dietrich",
+date = "2005",
+url = "https://dtrx.de/od/tex/sfmath",
+eprinttype = "ctan",
+eprint = "sfmath",
+}
+
+@article{relsize,
+title = "The |relsize| package",
+subtitle = "Set the font size relative to the current font size",
+author = "Donald Arseneau and Matt Swift",
+date = "2011",
+eprinttype = "ctan",
+eprint = "relsize",
+}
+
+@article{everyhook,
+title = "The |everyhook| package",
+subtitle = "Hooks for standard \hologo{TeX} token lists",
+author = "Stephen Checkoway",
+date = "2010",
+eprinttype = "ctan",
+eprint = "everyhook",
+}
+
+
+@article{sansmathfonts,
+title = "The |sansmathfonts| package",
+subtitle = "Correct placement of accents in sans-serif maths",
+author = "Ariel Barton",
+date = "2013",
+eprinttype = "ctan",
+eprint = "sansmathfonts",
+}
+
+@article{xspace,
+title = "The |xspace| package",
+subtitle = "Define commands that appear not to eat spaces",
+author = "David Carlisle and Morten Høgholm",
+collaboration = "\hologo{LaTeX} Team",
+date = "1993",
+eprinttype = "ctan",
+eprint = "xspace",
+}
+
+@article{ragged2e,
+title = "The |ragged2e|-package",
+subtitle = "Alternative versions of \enquote{ragged}-type commands",
+author = "Martin Schröder",
+date = "1996",
+eprinttype = "ctan",
+eprint = "ragged2e",
+related = "ragged2e-1",
+}
+
+@manual{ragged2e-1,
+eprinttype = "gitlab",
+eprintclass = "hagenbuch",
+eprint = "ragged2e",
+}
+
+@article{url,
+title = "The |url| package",
+subtitle = "Verbatim with URL-sensitive line breaks",
+author = "Donald Arseneau",
+date = "1996",
+eprinttype = "ctan",
+eprint = "url",
+}
+
+@article{jhep,
+title = "The |JHEP| package",
+collaboration = "SISSA Medialab",
+date = "1997",
+url = "https://jhep.sissa.it/jhep/help/JHEP_TeXclass.jsp",
+}
+
+@article{jcap,
+title = "The |JCAP| package",
+collaboration = "SISSA Medialab",
+date = "2002",
+url = "https://jcap.sissa.it/jcap/help/JCAP_TeXclass.jsp",
+}
+
+@article{bbm-macros,
+title = "A package for using the |bbm| fonts in math environment",
+author = "Torsten Hilbrich",
+date = "1994",
+eprinttype = "ctan",
+eprint = "bbm-macros",
+related = "bbm"
+}
+
+@article{bbm,
+title = "|bbm|",
+subtitle = "\enquote{Blackboard-style} cm fonts",
+author = "Gilles Robert",
+date = "1993",
+eprinttype = "ctan",
+eprint = "bbm",
+}
+
+@article{arxiv,
+title = "arXiv",
+subtitle = "free distribution service and an open archive for scholarly articles",
+url = "https://arxiv.org",
+author = "Paul Ginsparg",
+collaboration = "arXiv Team",
+year = "1991",
+organization = "Cornell University",
+}
+
+@article{dsfont,
+title = "The |doublestroke| font",
+subtitle = "Typeset mathematical double stroke symbols",
+author = "Olaf Kummer",
+date = "1995",
+eprinttype = "ctan",
+eprint = "doublestroke",
+}
+
+@article{mleftright,
+title = "The |mleftright| package",
+subtitle = "Variants of delimiters that act as maths open/close",
+author = "Heiko Oberdiek",
+date = "2010",
+eprinttype = "ctan",
+eprint = "mleftright",
+}
+
+@article{urwchancal,
+title = "A virtual font for URW Chancery Math",
+subtitle = "Use URW's clone of Zapf Chancery as a maths alphabet",
+author = "Michael Sharpe",
+date = "2011",
+eprinttype = "ctan",
+eprint = "urwchancal",
+}
+
+@article{footnotebackref,
+title = "The |footnotebackref| package",
+subtitle = "Back-references from footnotes",
+author = "Holger Lange",
+date = "2012",
+eprinttype = "ctan",
+eprint = "footnotebackref",
+}
+
+@article{cancel,
+title = "The |cancel| package",
+subtitle = "Place lines through maths formulae",
+author = "Donald Arseneau",
+date = "2013",
+eprinttype = "ctan",
+eprint = "cancel",
+}
+
+@article{beamer,
+title = "The |beamer| class",
+subtitle = "A \hologo{LaTeX} class for producing presentations and slides",
+author = "Till Tantau and Joseph Wright and Vedran Miletić",
+date = "2003",
+eprinttype = "ctan",
+eprint = "beamer",
+related = "beamer-1",
+}
+
+@manual{beamer-1,
+eprinttype = "github",
+eprintclass = "josephwright",
+eprint = "beamer",
+}
+
+@article{exscale,
+title = "The |exscale| package",
+subtitle = "Implements scaling of the \enquote{cmex} fonts",
+author = "Frank Mittelbach and Rainer Schöpf",
+date = "1993",
+eprinttype = "ctan",
+eprint = "exscale",
+}
+
+@article{mathrsfs,
+title = "The |mathrsfs| package",
+subtitle = "Support for using RSFS fonts in maths",
+author = "Jörg Knappen",
+date = "1995",
+eprinttype = "ctan",
+eprint = "mathrsfs",
+}
+
+@article{esint,
+title = "The |esint| package",
+subtitle = "Extended set of integrals for Computer Modern",
+author = "Eddie Saudrais",
+date = "2005",
+eprinttype = "ctan",
+eprint = "esint",
+}
+
+@article{cmbright,
+title = "The |cmbright| package",
+subtitle = "Using the CM Bright typeface with \hologo{LaTeX}",
+author = "Walter A. Schmidt",
+date = "1996",
+eprinttype = "ctan",
+eprint = "cmbright",
+}
+
+@article{titling,
+title = "The |titling| package",
+subtitle = "Control over the typesetting of the |\textbackslash maketitle| command",
+author = "Peter R. Wilson",
+date = "2000",
+eprinttype = "ctan",
+eprint = "titling",
+}
+
+@article{MnSymbol,
+title = "The |MnSymbol| package",
+subtitle = "Mathematical symbol font for Adobe MinionPro",
+author = "Achim Blumensath",
+date = "2005",
+eprinttype = "ctan",
+eprint = "MnSymbol",
+}
+
+@article{environ,
+title = "The |environ| package",
+subtitle = "A new interface for environments in \hologo{LaTeX}",
+author = "Will Robertson",
+date = "2007",
+eprinttype = "ctan",
+eprint = "environ",
+}
+
+@article{abstract,
+title = "The |abstract| package",
+subtitle = "Control the typesetting of the abstract environment",
+author = "Peter R. Wilson",
+date = "2000",
+eprinttype = "ctan",
+eprint = "abstract",
+}
+
+@article{cfr-lm,
+title = "The |cfr-lm| package",
+subtitle = "Enhanced support for the Latin Modern fonts",
+author = "Clea F. Rees",
+date = "2008",
+eprinttype = "ctan",
+eprint = "cfr-lm",
+}
+
+@article{etoolbox,
+title = "The |etoolbox| package",
+subtitle = "e-\hologo{TeX} tools for \hologo{LaTeX}",
+author = "Philipp Lehman and Joseph Wright",
+date = "2007",
+eprinttype = "ctan",
+eprint = "etoolbox",
+}
+
+@article{substitutefont,
+title = "The |substitutefont| package",
+subtitle = "Easy font substitution",
+author = "Günter Milde",
+date = "2010",
+eprinttype = "ctan",
+eprint = "substitutefont",
+}
+
+@article{svjour,
+title = "The |svjour| package",
+subtitle = "Macros for Springer journals",
+collaboration = "Springer Verlag",
+date = "1997",
+eprinttype = "ctan",
+eprint = "springer",
+}
+
+@article{cm,
+title = "Computer Modern fonts",
+author = "Donald E. Knuth",
+date = "1986",
+eprinttype = "ctan",
+eprint = "cm",
+}
+
+@article{subdepth,
+title = "The |subdepth| package",
+subtitle = "Unify maths subscript height",
+author = "Will Robertson",
+date = "2007",
+eprinttype = "ctan",
+eprint = "subdepth",
+}
+
+@article{xpatch,
+title = "The |xpatch| package",
+subtitle = "Extending etoolbox patching commands",
+author = "Enrico Gregorio",
+date = "2012",
+eprinttype = "ctan",
+eprint = "xpatch",
+}
+
+@article{hfoldsty,
+title = "The |hfoldsty| package",
+subtitle = "Old style numerals with EC fonts",
+author = "Harald Harders",
+date = "2004",
+eprinttype = "ctan",
+eprint = "hfoldsty",
+}
+
+@article{slantsc,
+title = "The |slantsc| package",
+subtitle = "Access different-shaped small-caps fonts",
+author = "Harald Harders",
+date = "2003",
+eprinttype = "ctan",
+eprint = "slantsc",
+}
+
+@article{nfssext-cfr,
+title = "The |nfssext-cfr| package",
+subtitle = "Extensions to the \hologo{LaTeX} NFSS",
+author = "Clea F. Rees and Philipp Lehman",
+date = "2003",
+eprinttype = "ctan",
+eprint = "nfssext-cfr",
+}
+
+@article{xstring,
+title = "The |xstring| package",
+subtitle = "String manipulation for \hologo{LaTeX}",
+author = "Christian Tellechea",
+date = "2008",
+eprinttype = "ctan",
+eprint = "xstring",
+}
+
+@article{gregorio:2020,
+title = "\hologo{TeX}, \hologo{LaTeX} and math",
+author = "Enrico Gregorio",
+date = "2020",
+url = "https://latex-project.org/publications/2020-egreg-TUB-tb127gregorio-math.pdf",
+}
+
+@article{soulutf8,
+title = "The |soulutf8| package",
+subtitle = "Permit use of UTF-8 characters in |soul|",
+author = "Heiko Oberdiek",
+date = "2007",
+eprinttype = "ctan",
+eprint = "soulutf8",
+}
+
diff --git a/macros/latex/contrib/hep-acronym/hep-acronym-documentation.pdf b/macros/latex/contrib/hep-acronym/hep-acronym-documentation.pdf
new file mode 100644
index 0000000000..51d02bb90a
--- /dev/null
+++ b/macros/latex/contrib/hep-acronym/hep-acronym-documentation.pdf
Binary files differ
diff --git a/macros/latex/contrib/hep-acronym/hep-acronym-implementation.dtx b/macros/latex/contrib/hep-acronym/hep-acronym-implementation.dtx
new file mode 100644
index 0000000000..c5e9c60cfa
--- /dev/null
+++ b/macros/latex/contrib/hep-acronym/hep-acronym-implementation.dtx
@@ -0,0 +1,524 @@
+% \iffalse meta-comment
+%
+% Copyright (C) 2019 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.
+%
+% \fi
+%
+% \iffalse
+%
+%<package>\NeedsTeXFormat{LaTeX2e}[2005/12/01]
+%<package>\ProvidesPackage{hep-acronym}[2021/08/01 v1.0 Acronyms using glossaries]
+%<documentation>\ProvidesFile{hep-acronym-documentation.tex}[2021/08/01 v1.0 hep-acronym documentation]
+%
+%<*documentation>
+
+\RequirePackage[l2tabu, orthodox]{nag}
+\documentclass{ltxdoc}
+\AtBeginDocument{\DeleteShortVerb{\|}}
+\AtBeginDocument{\MakeShortVerb{\"}}
+
+\EnableCrossrefs
+\CodelineIndex
+\RecordChanges
+
+\usepackage{hologo}
+\usepackage[parskip]{hep-paper}
+
+\bibliography{bibliography}
+
+\acronym{PDF}{portable document format}
+
+\MacroIndent=1.5em
+\AtBeginEnvironment{macrocode}{\renewcommand{\ttdefault}{clmt}}
+%</documentation>
+
+%<*driver>
+\expandafter\newif\csname ifshort\endcsname
+\shortfalse
+\begin{document}
+\DocInput{hep-acronym-implementation.dtx}
+\end{document}
+%</driver>
+%
+% \fi
+%
+% \CheckSum{354}
+%
+% \CharacterTable
+% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+% Digits \0\1\2\3\4\5\6\7\8\9
+% Exclamation \! Double quote \" Hash (number) \#
+% Dollar \$ Percent \% Ampersand \&
+% Acute accent \' Left paren \( Right paren \)
+% Asterisk \* Plus \+ Comma \,
+% Minus \- Point \. Solidus \/
+% Colon \: Semicolon \; Less than \<
+% Equals \= Greater than \> Question mark \?
+% Commercial at \@ Left bracket \[ Backslash \\
+% Right bracket \] Circumflex \^ Underscore \_
+% Grave accent \` Left brace \{ Vertical bar \|
+% Right brace \} Tilde \~}
+%
+% \changes{v1.0}{2021/09/01}{Initial version of the style file.}
+%
+% \ifshort
+%<*documentation>
+% \fi
+%
+\GetFileInfo{hep-acronym.sty}
+
+\title{The \software{hep-acronym} package\thanks{This document corresponds to \software{hep-acronym}~\fileversion.}}
+\subtitle{An acronym extension for glossaries}
+\author{Jan Hajer \email{jan.hajer@unibas.ch}}
+\date{\filedate}
+
+% \ifshort
+\begin{document}
+% \fi
+
+\newgeometry{vscale=.8, vmarginratio=3:4, includeheadfoot, left=11em, marginparwidth=4.6cm, marginparsep=3mm, right=7em}
+
+\maketitle
+
+\begin{abstract}
+The \software{hep-acronym} package provides an acronym macro based on the \software{glossaries} package.
+\end{abstract}
+
+Acronyms are implemented using the \software{glossaries-extra} package \cite{glossaries-extra} which is an extension of the \software{glossaries} package \cite{glossaries} and must be loaded after the \software{hyperref} package \cite{hyperref}.
+It can be loaded using "\usepackage{hep-acronym}".
+
+\DescribeMacro{\acronym}
+The "\acronym"\meta{*}\oarg{typeset abbreviation}\marg{abbreviation}\meta{*}\marg{definition}\oarg{plural\linebreak[4]definition} macro generates the singular "\"\meta{abbreviation} and plural "\"\meta{abbreviation}"s" macros.
+
+The first star prevents the addition of an \enquote{s} to the abbreviation plural.
+The second star restores the \hologo{TeX} default of swallowing subsequent white space.
+The long form is only shown at the first appearance of these macros, later appearances generate the abbreviation with a hyperlink to the long form.
+Capitalisation at the beginning of paragraphs and sentences is (mostly) ensured.
+The long form is never used in math mode which can be exploited to enforce the short form.
+In order to enforce the long form use "\glsdesc*"\marg{abbreviation}.
+As there can be no fixed rule whether to use the long form or the short form in section headers the user is left to their own devises \eg "\glsdesc"\marg{abbreviation}, "\Glsdesc"\marg{abbreviation}.
+
+\DescribeMacro{\shortacronym}
+\DescribeMacro{\longacronym}
+The "\shortacronym" and "\longacronym" macros are drop-in replacements of the "\acronym" macro showing only the short or long form of their acronym.
+
+\DescribeMacro{\resetacronym}
+\DescribeMacro{\dummyacronym}
+The first use form of the acronym can be enforced by resetting the acronym counter with "\resetacronym"\marg{key}.
+
+If the acronym counter equals one at the end of the document the short form of the acronym is not introduced.
+Placing a "\dummyacronym"\marg{key} at the end of the document ensures that the short form is introduced.
+
+In order to reduce the number of potentially conflicting packages the \software{glossaries} package is loaded without any glossary style.
+In the case that the glossary should be printed additional packages must be loaded via \eg "\usepackage{glossary-list}".
+
+% \ifshort
+\printbibliography
+
+\end{document}
+%
+%</documentation>
+% \fi
+%
+% \StopEventually{
+% \printbibliography
+% \PrintChanges
+% }
+%
+% \appendix
+%
+% \section{Implementation}
+%
+%<*package>
+%
+% Load the base package \cite{glossaries, glossaries-extra} and set the abbreviation style.
+% \begin{macrocode}
+\RequirePackage[nostyles]{glossaries-extra}
+\setabbreviationstyle{long-hyphen-short-hyphen}
+% \end{macrocode}
+% Use the entry count feature.
+% \begin{macrocode}
+\glsenableentrycount
+\glssetcategoryattribute{abbreviation}{entrycount}{1}
+% \end{macrocode}
+% Provide macros for older "glossaries-extra" installations.
+% \begin{macrocode}
+\AtBeginDocument{
+ \@ifpackageloaded{hyperref}{
+ \providecommand{\glsxtrusefield}[2]{\@gls@entry@field{#1}{#2}}
+ \providecommand{\glsxtrsetfieldifexists}[3]{\glsdoifexists{#1}{#3}}
+ \providecommand{\gGlsXtrSetField}[3]{%
+ \glsxtrsetfieldifexists{#1}{#2}{%
+ \csgdef{glo@\glsdetoklabel{#1}@#2}{#3}%
+ }%
+ }
+% \end{macrocode}
+% Set hyperlinks from the abbreviation to their definition in the text.
+% \begin{macrocode}
+ \glssetcategoryattribute{abbreviation}{nohyperfirst}{true}
+ \renewcommand*{\glsdonohyperlink}[2]{{%
+ \glsxtrprotectlinks\edef\fieldvalue{%
+ \glsxtrusefield{\glslabel}{hastarget}%
+ }%
+ \ifdefstring\fieldvalue{true}{#2}{%
+ \gGlsXtrSetField{\glslabel}{hastarget}{true}%
+ \glsdohypertarget{#1}{#2}%
+ }%
+ }}
+ }{\providecommand{\pdfstringdefDisableCommands}[1]{}}
+}
+% \end{macrocode}
+%
+% \begin{macro}{\begin@sentence}
+% Mark the beginning of a paragraph as if it would follow a full stop using the \software{everyhook} package \cite{everyhook}.
+% \begin{macrocode}
+\RequirePackage[excludeor]{everyhook}
+\newcommand{\begin@sentence}{1001}
+\PushPostHook{par}{{\spacefactor=\begin@sentence}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\frenchspacing}
+% Adjust the "\frenchspacing" macro to be compatibel with this idea.
+% \begin{macrocode}
+\def\frenchspacing{%
+ \sfcode`\.\begin@sentence \sfcode`\?\begin@sentence
+ \sfcode`\!\begin@sentence \sfcode`\:\begin@sentence
+ \sfcode`\;\@m \sfcode`\,\@m
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\if@begin@of@sentence}
+% Provide a macro checking for the beginning of a sentence by examining the length of the preceeding space.
+% \begin{macrocode}
+\newcommand{\if@begin@of@sentence}[2]{\leavevmode\protecting{%
+ \ifboolexpr{ test {\ifnumcomp{\spacefactor}{=}{3000}} or%
+ test {\ifnumcomp{\spacefactor}{=}{2000}} or%
+ test {\ifnumcomp{\spacefactor}{=}{\begin@sentence}}%
+ }{#1}{#2}%
+}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\mathdef}
+% Provide a macro that allows to extend a macro definition into math mode using the \software{xparse} package \cite{xparse}.
+% \begin{macrocode}
+\RequirePackage{xparse}
+\ProvideDocumentCommand{\mathdef}{mO{0}m}{%
+ \expandafter\let\csname hep@text\string#1\endcsname=#1
+ \expandafter\newcommand\csname hep@math\string#1\endcsname[#2]{#3}
+ \DeclareRobustCommand#1{%
+ \ifmmode
+ \expandafter\let\expandafter\next\csname%
+ hep@math\string#1\endcsname%
+ \else
+ \expandafter\let\expandafter\next\csname%
+ hep@text\string#1\endcsname%
+ \fi
+ \next
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\acronym}
+% Define the "\acronym"\meta{*}\oarg{typeset abbreviation}\marg{abbreviation}\meta{*}\marg{definition}\oarg{plural\linebreak[4] definition} macro using the \software{xspace} \cite{xspace} and \software{amstext} \cite{amstext} packages.
+% \begin{enumerate}[nosep, label=\#\arabic*]
+% \item star for omitting the \enquote{s} in the short plural
+% \item optional typeset abbreviation
+% \item mandatory abbreviation
+% \item star for restoring the \hologo{TeX} default for space after text macros
+% \item mandatory long form
+% \item optional plural long form
+% \end{enumerate}
+% \begin{macrocode}
+\RequirePackage{xspace}
+\RequirePackage{amstext}
+\NewDocumentCommand{\acronym}{somsmo}{
+ \newabbreviation[
+ type=\acronymtype,
+ sort=#3,
+ \glsshortpluralkey=\IfBooleanTF{#1}{#3}{\IfNoValueTF{#2}{#3s}{#2s}},
+ longplural=\IfNoValueTF{#6}{#5s}{#6}
+ ]{#3}{\IfNoValueTF{#2}{#3}{#2}}{#5}
+% \end{macrocode}
+% Provide the singular acronym macro.
+% \begin{macrocode}
+ \expandafter\newcommand\csname#3\endcsname[1][]{%
+ \if@begin@of@sentence{%
+ \ifglsused{#3}{\cgls{#3}[##1]}{\cGls{#3}[##1]}%
+ }{\cgls{#3}[##1]}%
+ \ifnum\glsentrycurrcount{#3}>1\relax
+ \IfBooleanTF{#4}{}{\@\xspace}%
+ \else\@\xspace\fi
+ }
+% \end{macrocode}
+% Expand the singular acronym macro in \PDF labels.
+% \begin{macrocode}
+ \pdfstringdefDisableCommands{\expandafter\def\csname#3\endcsname{%
+ \IfNoValueTF{#2}{#3}{#2} }%
+ }
+% \end{macrocode}
+% Provide the singular acronym macro in math mode.
+% \begin{macrocode}
+ \expandafter\mathdef\csname#3\endcsname{%
+ \text{\glsxtrshort{#3}}\@gls@increment@currcount{#3}%
+ }
+% \end{macrocode}
+% Provide the plural acronym macro.
+% \begin{macrocode}
+ \expandafter\newcommand\csname#3s\endcsname[1][]{%
+ \if@begin@of@sentence{\cGlspl{#3}[##1]}{\cglspl{#3}[##1]}%
+ \IfBooleanTF{#4}{}{\@\xspace}%
+ }
+% \end{macrocode}
+% Expand the plural acronym macro in \PDF labels.
+% \begin{macrocode}
+ \pdfstringdefDisableCommands{\expandafter\def\csname#3s\endcsname{%
+ \IfBooleanTF{#1}{#3}{\IfNoValueTF{#2}{#3s}{#2s}} }%
+ }
+% \end{macrocode}
+% Provide the plural acronym macro in math mode.
+% \begin{macrocode}
+ \expandafter\mathdef\csname#3s\endcsname{%
+ \text{\glsxtrshortpl{#3}}\@gls@increment@currcount{#3}%
+ }
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\shortacronym}
+% The "\shortacronym" never expands into the long form.
+% \begin{macrocode}
+\NewDocumentCommand{\shortacronym}{somsmo}{
+% \end{macrocode}
+% Provide the singular acronym macro.
+% \begin{macrocode}
+ \expandafter\newcommand\csname#3\endcsname[1][]{%
+ \IfNoValueTF{#2}{#3}{#2}\IfBooleanTF{#4}{}{\@\xspace}##1%
+ }
+% \end{macrocode}
+% Expand the singular acronym macro in \PDF labels.
+% \begin{macrocode}
+ \pdfstringdefDisableCommands{\expandafter\def\csname#3\endcsname{%
+ \IfNoValueTF{#2}{#3}{#2} }%
+ }
+% \end{macrocode}
+% Provide the singular acronym macro in math mode.
+% \begin{macrocode}
+ \expandafter\mathdef\csname#3\endcsname{%
+ \text{\IfNoValueTF{#2}{#3}{#2}}%
+ }
+% \end{macrocode}
+% Provide the plural acronym macro.
+% \begin{macrocode}
+ \expandafter\newcommand\csname#3s\endcsname[1][]{%
+ \IfBooleanTF{#1}{#3}{\IfNoValueTF{#2}{#3s}{#2s}}%
+ \IfBooleanTF{#4}{}{\@\xspace}##1%
+ }
+% \end{macrocode}
+% Expand the plural acronym macro in \PDF labels.
+% \begin{macrocode}
+ \pdfstringdefDisableCommands{\expandafter\def\csname#3s\endcsname{%
+ \IfBooleanTF{#1}{#3}{\IfNoValueTF{#2}{#3s}{#2s}} }%
+ }
+% \end{macrocode}
+% Provide the plural acronym macro in math mode.
+% \begin{macrocode}
+ \expandafter\mathdef\csname#3s\endcsname{%
+ \text{\IfBooleanTF{#1}{#3}{\IfNoValueTF{#2}{#3s}{#2s}}}%
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\longacronym}
+% The "\longacronym" never shows the abbreviated form.
+% \begin{macrocode}
+\NewDocumentCommand{\longacronym}{somsmo}{
+% \end{macrocode}
+% Provide the singular acronym macro.
+% \begin{macrocode}acronyms
+ \expandafter\newcommand\csname#3\endcsname[1][]{%
+ \if@begin@of@sentence{\MakeUppercase#5}{#5}%
+ \IfBooleanTF{#4}{}{\@\xspace}##1%
+ }
+% \end{macrocode}
+% Expand the singular acronym macro in \PDF labels.
+% \begin{macrocode}
+ \pdfstringdefDisableCommands{\expandafter\def\csname#3\endcsname{#5 }}
+% \end{macrocode}
+% Provide the plural acronym macro.
+% \begin{macrocode}
+ \expandafter\newcommand\csname#3s\endcsname[1][]{%
+ \if@begin@of@sentence{%
+ \IfNoValueTF{#6}{\MakeUppercase#5s}{\MakeUppercase#6}%
+ }{%
+ \IfNoValueTF{#6}{#5s}{#6}}\IfBooleanTF{#4}{}{\@\xspace}##1%
+ }
+% \end{macrocode}
+% Expand the plural acronym macro in \PDF labels.
+% \begin{macrocode}
+ \pdfstringdefDisableCommands{\expandafter\def\csname#3s\endcsname{%
+ \IfNoValueTF{#6}{#5s}{#6} }%
+ }
+}
+% \end{macrocode}
+% \end{macro}
+% Silence warning if no acronyms are defined.
+% \begin{macrocode}
+\renewcommand*{\@gls@write@entrycounts}{%
+ \immediate\write\@auxout{%
+ \string\providecommand*{\string\@gls@entry@count}[2]{}
+ }%
+ \count@=0\relax
+ \forallglsentries{\@glsentry}{%
+ \glshasattribute{\@glsentry}{entrycount}{%
+ \ifglsused{\@glsentry}{%
+ \immediate\write\@auxout{%
+ \string\@gls@entry@count{\@glsentry}{%
+ \glsentrycurrcount{\@glsentry}%
+ }
+ }%
+ }{}\advance\count@ by \@ne
+ }{}%
+ }%
+}
+% \end{macrocode}
+% \begin{macro}{\resetacronym}
+% \begin{macro}{\dummyacronym}
+% Add two macros for acronym management.
+% \begin{macrocode}
+\newcommand{\resetacronym}[1]{\protect\glsreset{#1}}
+\newcommand{\dummyacronym}[1]{\protect\glsunset{#1}}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{abstract}
+% Adjust the "abstract" environment to reset all acronym counters.
+% \begin{macrocode}
+\@ifundefined{endabstract}{}{%
+ \let\end@hep@abstract\endabstract%
+ \renewcommand\endabstract{\glsresetall\end@hep@abstract}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\tableofcontents}
+% \begin{macro}{\listoffigures}
+% \begin{macro}{\listoftables}
+% Adjust the "\tableofcontents" macro to never show the long form of acronyms.
+% \begin{macrocode}
+\let\hep@table@of@contents\tableofcontents
+\renewcommand\tableofcontents{%
+ \glsunsetall\hep@table@of@contents\glsresetall%
+}
+\let\hep@list@of@figures\listoffigures
+\renewcommand\listoffigures{%
+ \glsunsetall\hep@list@of@figures\glsresetall%
+}
+\let\hep@list@of@tables\listoftables
+\renewcommand\listoftables{%
+ \glsunsetall\hep@list@of@tables\glsresetall%
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\acronyms}
+% Add a possibility to have different groups of acronyms.
+% \begin{macrocode}
+\NewDocumentCommand{\acronyms}{om}{%
+ \IfNoValueTF{#1}{
+ \newglossary{#2}{#2.in}{#2.out}{#2}%
+ \renewcommand{\acronymtype}{#2}%
+ }{
+ \newglossary{#1}{#1.in}{#1.out}{#2}%
+ \renewcommand{\acronymtype}{#1}%
+ }
+}
+% \end{macrocode}
+% \end{macro}
+%
+%</package>
+%
+% \section{Test}
+%
+%<*test>
+% \begin{macrocode}
+\documentclass{article}
+
+% \usepackage{hep-paper}
+\usepackage{hyperref}
+\usepackage{hep-acronym}
+
+\acronym{PDF}{portable document format}
+\acronym{URL}{uniform resource locator}
+\acronym{CM}{computer modern}
+\acronym{LM}{latin modern}
+
+\begin{document}
+
+\PDF \emph{(Capitalised at beginning of paragraph)}
+\PDF \emph{(Second appearance is shortened)}.
+\URLs \emph{(Capitalised plural form at beginning of sentence)}
+$\URL$ \emph{(Second appearance is forced to be always short)}
+\LM \emph{(Not capitalised in middle of sentence)}
+\LM \emph{(Second appearance is shorted)}.
+$\CM$ \emph{(Enforce short form)}
+\CM \emph{(then extend second appearance)}
+\glsdesc*{CM} \emph{(enforce long form)}
+
+\end{document}
+% \end{macrocode}
+%
+%</test>
+%
+% \section{Readme}
+%
+%<*readme>
+%
+% \begin{macrocode}
+# The `hep-acronym` package
+
+An acronym extension for glossaries
+
+## Introduction
+
+The `hep-acronym` package provides an acronym macro based on the `glossaries` package.
+It can be loaded using `\usepackage{hep-acronym}`.
+
+## Author
+
+Jan Hajer
+
+## License
+
+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.
+% \end{macrocode}
+%
+%</readme>
+%
+% \Finale
+
+\endinput
+
+% \PrintIndex
+% makeindex -s gglo.ist -o hep-acronym-implementation.gls hep-acronym-implementation.glo
+% makeindex -s gglo.ist -o hep-acronym-implementation.ind hep-acronym-implementation.idx
diff --git a/macros/latex/contrib/hep-acronym/hep-acronym-implementation.pdf b/macros/latex/contrib/hep-acronym/hep-acronym-implementation.pdf
new file mode 100644
index 0000000000..47eb0547f8
--- /dev/null
+++ b/macros/latex/contrib/hep-acronym/hep-acronym-implementation.pdf
Binary files differ
diff --git a/macros/latex/contrib/hep-acronym/hep-acronym.ins b/macros/latex/contrib/hep-acronym/hep-acronym.ins
new file mode 100644
index 0000000000..ca6cb5b42a
--- /dev/null
+++ b/macros/latex/contrib/hep-acronym/hep-acronym.ins
@@ -0,0 +1,49 @@
+%% Copyright (C) 2019 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.
+
+\input docstrip.tex
+\keepsilent
+\usedir{tex/latex/hep-acronym}
+
+\preamble
+This is a generated file.
+Copyright (C) 2019 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.
+\endpreamble
+
+\generate{
+ \file{hep-acronym-documentation.tex}{\from{hep-acronym-implementation.dtx}{documentation}}
+ \file{hep-acronym.sty}{\from{hep-acronym-implementation.dtx}{package}}
+ \file{hep-acronym-test.tex}{\from{hep-acronym-implementation.dtx}{test}}
+ \nopreamble\nopostamble\file{README-hep-acronym.md}{\from{hep-acronym-implementation.dtx}{readme}}
+}
+
+\Msg{*********************************************************}
+\Msg{*}
+\Msg{* To finish the installation you have to move the}
+\Msg{* following file into a directory searched by TeX:}
+\Msg{*}
+\Msg{* \space\space hep-acronym.sty}
+\Msg{*}
+\Msg{* To produce the documentation run the file}
+\Msg{* hep-acronym-documentation.dtx through LaTeX.}
+\Msg{*}
+\Msg{* Happy TeXing!}
+\Msg{*********************************************************}
+
+\endbatchfile
diff --git a/macros/latex/contrib/hep-acronym/license.md b/macros/latex/contrib/hep-acronym/license.md
new file mode 100644
index 0000000000..494f58131f
--- /dev/null
+++ b/macros/latex/contrib/hep-acronym/license.md
@@ -0,0 +1,416 @@
+The LaTeX Project Public License
+=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
+
+LPPL Version 1.3c 2008-05-04
+
+Copyright 1999 2002-2008 LaTeX3 Project
+ Everyone is allowed to distribute verbatim copies of this
+ license document, but modification of it is not allowed.
+
+
+PREAMBLE
+========
+
+The LaTeX Project Public License (LPPL) is the primary license under
+which the LaTeX kernel and the base LaTeX packages are distributed.
+
+You may use this license for any work of which you hold the copyright
+and which you wish to distribute. This license may be particularly
+suitable if your work is TeX-related (such as a LaTeX package), but
+it is written in such a way that you can use it even if your work is
+unrelated to TeX.
+
+The section `WHETHER AND HOW TO DISTRIBUTE WORKS UNDER THIS LICENSE',
+below, gives instructions, examples, and recommendations for authors
+who are considering distributing their works under this license.
+
+This license gives conditions under which a work may be distributed
+and modified, as well as conditions under which modified versions of
+that work may be distributed.
+
+We, the LaTeX3 Project, believe that the conditions below give you
+the freedom to make and distribute modified versions of your work
+that conform with whatever technical specifications you wish while
+maintaining the availability, integrity, and reliability of
+that work. If you do not see how to achieve your goal while
+meeting these conditions, then read the document `cfgguide.tex'
+and `modguide.tex' in the base LaTeX distribution for suggestions.
+
+
+DEFINITIONS
+===========
+
+In this license document the following terms are used:
+
+ `Work'
+ Any work being distributed under this License.
+
+ `Derived Work'
+ Any work that under any applicable law is derived from the Work.
+
+ `Modification'
+ Any procedure that produces a Derived Work under any applicable
+ law -- for example, the production of a file containing an
+ original file associated with the Work or a significant portion of
+ such a file, either verbatim or with modifications and/or
+ translated into another language.
+
+ `Modify'
+ To apply any procedure that produces a Derived Work under any
+ applicable law.
+
+ `Distribution'
+ Making copies of the Work available from one person to another, in
+ whole or in part. Distribution includes (but is not limited to)
+ making any electronic components of the Work accessible by
+ file transfer protocols such as FTP or HTTP or by shared file
+ systems such as Sun's Network File System (NFS).
+
+ `Compiled Work'
+ A version of the Work that has been processed into a form where it
+ is directly usable on a computer system. This processing may
+ include using installation facilities provided by the Work,
+ transformations of the Work, copying of components of the Work, or
+ other activities. Note that modification of any installation
+ facilities provided by the Work constitutes modification of the Work.
+
+ `Current Maintainer'
+ A person or persons nominated as such within the Work. If there is
+ no such explicit nomination then it is the `Copyright Holder' under
+ any applicable law.
+
+ `Base Interpreter'
+ A program or process that is normally needed for running or
+ interpreting a part or the whole of the Work.
+
+ A Base Interpreter may depend on external components but these
+ are not considered part of the Base Interpreter provided that each
+ external component clearly identifies itself whenever it is used
+ interactively. Unless explicitly specified when applying the
+ license to the Work, the only applicable Base Interpreter is a
+ `LaTeX-Format' or in the case of files belonging to the
+ `LaTeX-format' a program implementing the `TeX language'.
+
+
+
+CONDITIONS ON DISTRIBUTION AND MODIFICATION
+===========================================
+
+1. Activities other than distribution and/or modification of the Work
+are not covered by this license; they are outside its scope. In
+particular, the act of running the Work is not restricted and no
+requirements are made concerning any offers of support for the Work.
+
+2. You may distribute a complete, unmodified copy of the Work as you
+received it. Distribution of only part of the Work is considered
+modification of the Work, and no right to distribute such a Derived
+Work may be assumed under the terms of this clause.
+
+3. You may distribute a Compiled Work that has been generated from a
+complete, unmodified copy of the Work as distributed under Clause 2
+above, as long as that Compiled Work is distributed in such a way that
+the recipients may install the Compiled Work on their system exactly
+as it would have been installed if they generated a Compiled Work
+directly from the Work.
+
+4. If you are the Current Maintainer of the Work, you may, without
+restriction, modify the Work, thus creating a Derived Work. You may
+also distribute the Derived Work without restriction, including
+Compiled Works generated from the Derived Work. Derived Works
+distributed in this manner by the Current Maintainer are considered to
+be updated versions of the Work.
+
+5. If you are not the Current Maintainer of the Work, you may modify
+your copy of the Work, thus creating a Derived Work based on the Work,
+and compile this Derived Work, thus creating a Compiled Work based on
+the Derived Work.
+
+6. If you are not the Current Maintainer of the Work, you may
+distribute a Derived Work provided the following conditions are met
+for every component of the Work unless that component clearly states
+in the copyright notice that it is exempt from that condition. Only
+the Current Maintainer is allowed to add such statements of exemption
+to a component of the Work.
+
+ a. If a component of this Derived Work can be a direct replacement
+ for a component of the Work when that component is used with the
+ Base Interpreter, then, wherever this component of the Work
+ identifies itself to the user when used interactively with that
+ Base Interpreter, the replacement component of this Derived Work
+ clearly and unambiguously identifies itself as a modified version
+ of this component to the user when used interactively with that
+ Base Interpreter.
+
+ b. Every component of the Derived Work contains prominent notices
+ detailing the nature of the changes to that component, or a
+ prominent reference to another file that is distributed as part
+ of the Derived Work and that contains a complete and accurate log
+ of the changes.
+
+ c. No information in the Derived Work implies that any persons,
+ including (but not limited to) the authors of the original version
+ of the Work, provide any support, including (but not limited to)
+ the reporting and handling of errors, to recipients of the
+ Derived Work unless those persons have stated explicitly that
+ they do provide such support for the Derived Work.
+
+ d. You distribute at least one of the following with the Derived Work:
+
+ 1. A complete, unmodified copy of the Work;
+ if your distribution of a modified component is made by
+ offering access to copy the modified component from a
+ designated place, then offering equivalent access to copy
+ the Work from the same or some similar place meets this
+ condition, even though third parties are not compelled to
+ copy the Work along with the modified component;
+
+ 2. Information that is sufficient to obtain a complete,
+ unmodified copy of the Work.
+
+7. If you are not the Current Maintainer of the Work, you may
+distribute a Compiled Work generated from a Derived Work, as long as
+the Derived Work is distributed to all recipients of the Compiled
+Work, and as long as the conditions of Clause 6, above, are met with
+regard to the Derived Work.
+
+8. The conditions above are not intended to prohibit, and hence do not
+apply to, the modification, by any method, of any component so that it
+becomes identical to an updated version of that component of the Work as
+it is distributed by the Current Maintainer under Clause 4, above.
+
+9. Distribution of the Work or any Derived Work in an alternative
+format, where the Work or that Derived Work (in whole or in part) is
+then produced by applying some process to that format, does not relax or
+nullify any sections of this license as they pertain to the results of
+applying that process.
+
+10. a. A Derived Work may be distributed under a different license
+ provided that license itself honors the conditions listed in
+ Clause 6 above, in regard to the Work, though it does not have
+ to honor the rest of the conditions in this license.
+
+ b. If a Derived Work is distributed under a different license, that
+ Derived Work must provide sufficient documentation as part of
+ itself to allow each recipient of that Derived Work to honor the
+ restrictions in Clause 6 above, concerning changes from the Work.
+
+11. This license places no restrictions on works that are unrelated to
+the Work, nor does this license place any restrictions on aggregating
+such works with the Work by any means.
+
+12. Nothing in this license is intended to, or may be used to, prevent
+complete compliance by all parties with all applicable laws.
+
+
+NO WARRANTY
+===========
+
+There is no warranty for the Work. Except when otherwise stated in
+writing, the Copyright Holder provides the Work `as is', without
+warranty of any kind, either expressed or implied, including, but not
+limited to, the implied warranties of merchantability and fitness for a
+particular purpose. The entire risk as to the quality and performance
+of the Work is with you. Should the Work prove defective, you assume
+the cost of all necessary servicing, repair, or correction.
+
+In no event unless required by applicable law or agreed to in writing
+will The Copyright Holder, or any author named in the components of the
+Work, or any other party who may distribute and/or modify the Work as
+permitted above, be liable to you for damages, including any general,
+special, incidental or consequential damages arising out of any use of
+the Work or out of inability to use the Work (including, but not limited
+to, loss of data, data being rendered inaccurate, or losses sustained by
+anyone as a result of any failure of the Work to operate with any other
+programs), even if the Copyright Holder or said author or said other
+party has been advised of the possibility of such damages.
+
+
+MAINTENANCE OF THE WORK
+=======================
+
+The Work has the status `author-maintained' if the Copyright Holder
+explicitly and prominently states near the primary copyright notice in
+the Work that the Work can only be maintained by the Copyright Holder
+or simply that it is `author-maintained'.
+
+The Work has the status `maintained' if there is a Current Maintainer
+who has indicated in the Work that they are willing to receive error
+reports for the Work (for example, by supplying a valid e-mail
+address). It is not required for the Current Maintainer to acknowledge
+or act upon these error reports.
+
+The Work changes from status `maintained' to `unmaintained' if there
+is no Current Maintainer, or the person stated to be Current
+Maintainer of the work cannot be reached through the indicated means
+of communication for a period of six months, and there are no other
+significant signs of active maintenance.
+
+You can become the Current Maintainer of the Work by agreement with
+any existing Current Maintainer to take over this role.
+
+If the Work is unmaintained, you can become the Current Maintainer of
+the Work through the following steps:
+
+ 1. Make a reasonable attempt to trace the Current Maintainer (and
+ the Copyright Holder, if the two differ) through the means of
+ an Internet or similar search.
+
+ 2. If this search is successful, then enquire whether the Work
+ is still maintained.
+
+ a. If it is being maintained, then ask the Current Maintainer
+ to update their communication data within one month.
+
+ b. If the search is unsuccessful or no action to resume active
+ maintenance is taken by the Current Maintainer, then announce
+ within the pertinent community your intention to take over
+ maintenance. (If the Work is a LaTeX work, this could be
+ done, for example, by posting to comp.text.tex.)
+
+ 3a. If the Current Maintainer is reachable and agrees to pass
+ maintenance of the Work to you, then this takes effect
+ immediately upon announcement.
+
+ b. If the Current Maintainer is not reachable and the Copyright
+ Holder agrees that maintenance of the Work be passed to you,
+ then this takes effect immediately upon announcement.
+
+ 4. If you make an `intention announcement' as described in 2b. above
+ and after three months your intention is challenged neither by
+ the Current Maintainer nor by the Copyright Holder nor by other
+ people, then you may arrange for the Work to be changed so as
+ to name you as the (new) Current Maintainer.
+
+ 5. If the previously unreachable Current Maintainer becomes
+ reachable once more within three months of a change completed
+ under the terms of 3b) or 4), then that Current Maintainer must
+ become or remain the Current Maintainer upon request provided
+ they then update their communication data within one month.
+
+A change in the Current Maintainer does not, of itself, alter the fact
+that the Work is distributed under the LPPL license.
+
+If you become the Current Maintainer of the Work, you should
+immediately provide, within the Work, a prominent and unambiguous
+statement of your status as Current Maintainer. You should also
+announce your new status to the same pertinent community as
+in 2b) above.
+
+
+WHETHER AND HOW TO DISTRIBUTE WORKS UNDER THIS LICENSE
+======================================================
+
+This section contains important instructions, examples, and
+recommendations for authors who are considering distributing their
+works under this license. These authors are addressed as `you' in
+this section.
+
+Choosing This License or Another License
+----------------------------------------
+
+If for any part of your work you want or need to use *distribution*
+conditions that differ significantly from those in this license, then
+do not refer to this license anywhere in your work but, instead,
+distribute your work under a different license. You may use the text
+of this license as a model for your own license, but your license
+should not refer to the LPPL or otherwise give the impression that
+your work is distributed under the LPPL.
+
+The document `modguide.tex' in the base LaTeX distribution explains
+the motivation behind the conditions of this license. It explains,
+for example, why distributing LaTeX under the GNU General Public
+License (GPL) was considered inappropriate. Even if your work is
+unrelated to LaTeX, the discussion in `modguide.tex' may still be
+relevant, and authors intending to distribute their works under any
+license are encouraged to read it.
+
+A Recommendation on Modification Without Distribution
+-----------------------------------------------------
+
+It is wise never to modify a component of the Work, even for your own
+personal use, without also meeting the above conditions for
+distributing the modified component. While you might intend that such
+modifications will never be distributed, often this will happen by
+accident -- you may forget that you have modified that component; or
+it may not occur to you when allowing others to access the modified
+version that you are thus distributing it and violating the conditions
+of this license in ways that could have legal implications and, worse,
+cause problems for the community. It is therefore usually in your
+best interest to keep your copy of the Work identical with the public
+one. Many works provide ways to control the behavior of that work
+without altering any of its licensed components.
+
+How to Use This License
+-----------------------
+
+To use this license, place in each of the components of your work both
+an explicit copyright notice including your name and the year the work
+was authored and/or last substantially modified. Include also a
+statement that the distribution and/or modification of that
+component is constrained by the conditions in this license.
+
+Here is an example of such a notice and statement:
+
+ %% pig.dtx
+ %% Copyright 2005 M. Y. Name
+ %
+ % This work may be distributed and/or modified under the
+ % conditions of the LaTeX Project Public License, either version 1.3
+ % 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.3 or later is part of all distributions of LaTeX
+ % version 2005/12/01 or later.
+ %
+ % This work has the LPPL maintenance status `maintained'.
+ %
+ % The Current Maintainer of this work is M. Y. Name.
+ %
+ % This work consists of the files pig.dtx and pig.ins
+ % and the derived file pig.sty.
+
+Given such a notice and statement in a file, the conditions
+given in this license document would apply, with the `Work' referring
+to the three files `pig.dtx', `pig.ins', and `pig.sty' (the last being
+generated from `pig.dtx' using `pig.ins'), the `Base Interpreter'
+referring to any `LaTeX-Format', and both `Copyright Holder' and
+`Current Maintainer' referring to the person `M. Y. Name'.
+
+If you do not want the Maintenance section of LPPL to apply to your
+Work, change `maintained' above into `author-maintained'.
+However, we recommend that you use `maintained', as the Maintenance
+section was added in order to ensure that your Work remains useful to
+the community even when you can no longer maintain and support it
+yourself.
+
+Derived Works That Are Not Replacements
+---------------------------------------
+
+Several clauses of the LPPL specify means to provide reliability and
+stability for the user community. They therefore concern themselves
+with the case that a Derived Work is intended to be used as a
+(compatible or incompatible) replacement of the original Work. If
+this is not the case (e.g., if a few lines of code are reused for a
+completely different task), then clauses 6b and 6d shall not apply.
+
+
+Important Recommendations
+-------------------------
+
+ Defining What Constitutes the Work
+
+ The LPPL requires that distributions of the Work contain all the
+ files of the Work. It is therefore important that you provide a
+ way for the licensee to determine which files constitute the Work.
+ This could, for example, be achieved by explicitly listing all the
+ files of the Work near the copyright notice of each file or by
+ using a line such as:
+
+ % This work consists of all files listed in manifest.txt.
+
+ in that place. In the absence of an unequivocal list it might be
+ impossible for the licensee to determine what is considered by you
+ to comprise the Work and, in such a case, the licensee would be
+ entitled to make reasonable conjectures as to which files comprise
+ the Work.
+
diff --git a/macros/latex/contrib/hep-title/README.md b/macros/latex/contrib/hep-title/README.md
new file mode 100644
index 0000000000..0c203a3a09
--- /dev/null
+++ b/macros/latex/contrib/hep-title/README.md
@@ -0,0 +1,21 @@
+
+
+# The `hep-title` package
+
+Extensions for the title page
+
+## Introduction
+
+The `hep-title` package extends the title macros of the standard classes with macros for a preprint, affiliation, editors, and endorsers.
+
+To use the `hep-title` package include it with `\usepackage{hep-title}`.
+
+## Author
+
+Jan Hajer
+
+## License
+
+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.
+
diff --git a/macros/latex/contrib/hep-title/bibliography.bib b/macros/latex/contrib/hep-title/bibliography.bib
new file mode 100644
index 0000000000..e5117be3d5
--- /dev/null
+++ b/macros/latex/contrib/hep-title/bibliography.bib
@@ -0,0 +1,1055 @@
+@article{hep-paper,
+title = "The |hep-paper| package",
+subtitle = "Publications in high energy physics",
+author = "Jan Hajer",
+year = "2019",
+eprinttype = "ctan",
+eprint = "hep-paper",
+related = "hep-paper-1",
+}
+
+@manual{hep-paper-1,
+doi = "10.5281/zenodo.3606436",
+eprinttype = "github",
+eprintclass = "janhajer",
+eprint = "hep-paper",
+}
+
+@article{hep-acronym,
+title = "The |hep-acronym| package",
+subtitle = "An acronym extension for glossaries",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-acronyms",
+related = "hep-paper-1",
+}
+
+@article{hep-bibliography,
+title = "The |hep-bibliography| package",
+subtitle = "Bibliographies for high energy physics",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-bibliography",
+related = "hep-paper-1",
+}
+
+@article{hep-float,
+title = "The |hep-float| package",
+subtitle = "Convenience package for float placement",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-float",
+related = "hep-paper-1",
+}
+
+@article{hep-font,
+title = "The |hep-font| package",
+subtitle = "Latin modern extended by computer modern",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-font",
+related = "hep-paper-1",
+}
+
+@article{hep-math-font,
+title = "The |hep-math-font| package",
+subtitle = "Extended Greek and sans serif math",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-math-font",
+related = "hep-paper-1",
+}
+
+@article{hep-math,
+title = "The |hep-math| package",
+subtitle = "Extended math macros",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-math",
+related = "hep-paper-1",
+}
+
+@article{hep-text,
+title = "The |hep-text| package",
+subtitle = "List and text extensions",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-text",
+related = "hep-paper-1",
+}
+
+@article{hep-title,
+title = "The |hep-title| package",
+subtitle = "Extensions for the title page",
+author = "Jan Hajer",
+year = "2021",
+eprinttype = "ctan",
+eprint = "hep-title",
+related = "hep-paper-1",
+}
+
+@article{kvoptions,
+title = "The |kvoptions| package",
+subtitle = "Key value format for package options",
+author = "Heiko Oberdiek",
+year = "2004",
+eprinttype = "ctan",
+eprint = "kvoptions",
+related = "kvoptions-1",
+}
+
+@manual{kvoptions-1,
+eprinttype = "github",
+eprintclass = "ho-tex",
+eprint = "kvoptions",
+}
+
+@article{cleveref,
+title = "The |cleveref| package",
+subtitle = "Intelligent cross-referencing",
+author = "Toby Cubitt",
+date = "2006",
+url = "http://dr-qubit.org/cleveref",
+eprinttype = "ctan",
+eprint = "cleveref",
+}
+
+@article{foreign,
+title = "The |foreign| package for \hologo{LaTeX2e}",
+subtitle = "Systematic treatment of \enquote{foreign} words in documents",
+author = "Philip G. Ratcliffe",
+date = "2012",
+eprinttype = "ctan",
+eprint = "foreign",
+}
+
+@article{geometry,
+title = "The |geometry| package",
+subtitle = "Flexible and complete interface to document dimensions",
+author = "David Carlisle and Hideo Umeki",
+date = "1996",
+eprinttype = "ctan",
+eprint = "geometry",
+related = "geometry-1",
+}
+
+@manual{geometry-1,
+eprinttype = "github",
+eprintclass = "davidcarlisle",
+eprint = "geometry",
+}
+
+@article{a4wide,
+title = "The |a4wide| package",
+subtitle = "\enquote{Wide} a4 layout",
+author = "Alexander Holt and Jean-François Lamy",
+date = "1986",
+eprinttype = "ctan",
+eprint = "a4wide",
+note = "depreciated and not used",
+}
+
+@article{microtype,
+title = "The |microtype| package",
+subtitle = "Subliminal refinements towards typographical perfection",
+author = "Robert Schlicht",
+date = "2004",
+eprinttype = "ctan",
+eprint = "microtype",
+}
+
+@article{authblk,
+title = "A \hologo{LaTeX} Package to Prepare Author and Affiliation Blocks",
+subtitle = "Support for footnote style author/affiliation",
+author = "Patrick W. Daly",
+date = "2001",
+eprinttype = "ctan",
+eprint = "authblk",
+}
+
+@article{bm,
+title = "The |bm| package",
+subtitle = "Access bold symbols in maths mode",
+author = "David Carlisle and Frank Mittelbach",
+collaboration = "\hologo{LaTeX} Team",
+date = "1993",
+eprinttype = "ctan",
+eprint = "bm",
+}
+
+@article{empheq,
+title = "The |empheq| package",
+author = "Lars Madsen and Morten Høgholm and Will Robertson and Joseph Wright",
+eprinttype = "ctan",
+eprint = "empheq",
+}
+
+@article{mathtools,
+title = "The |mathtools| package",
+subtitle = "Mathematical tools to use with |amsmath|",
+author = "Lars Madsen and Morten Høgholm and Will Robertson and Joseph Wright",
+date = "2004",
+eprinttype = "ctan",
+eprint = "mathtools",
+}
+
+@article{amsmath,
+title = "The |amsmath| package",
+subtitle = "AMS mathematical facilities for \hologo{LaTeX}",
+collaboration = "\hologo{LaTeX} Team",
+date = "1994",
+url = "https://ams.org/tex/amslatex",
+eprinttype = "ctan",
+eprint = "amsmath",
+}
+
+@article{amstext,
+title = "The |amstext| package",
+subtitle = "Typeset text fragments in mathematics",
+collaboration = "\hologo{LaTeX} Team",
+date = "1995",
+url = "https://ams.org/tex/amslatex",
+eprinttype = "ctan",
+eprint = "amstext",
+}
+
+@article{amsfonts,
+title = "The |amsfonts| package",
+subtitle = "\hologo{TeX} fonts from the American Mathematical Society",
+author = "Michael Downes and David M. Jones and Frank Mittelbach and Rainer Schöpf",
+collaboration = "American Mathematical Society",
+date = "1995",
+url = "https://ams.org/tex/amsfonts",
+eprinttype = "ctan",
+eprint = "amsfonts",
+}
+
+@article{amssymb,
+title = "The |amssymb| package",
+author = "Michael Downes and David M. Jones and Frank Mittelbach and Rainer Schöpf",
+collaboration = "American Mathematical Society",
+date = "1995",
+eprinttype = "ctan",
+eprint = "amsfonts",
+}
+
+@article{slashed,
+title = "The |slashed| package",
+subtitle = "Put a slash through characters",
+author = "David Carlisle",
+date = "1987",
+eprinttype = "ctan",
+eprint = "slashed",
+}
+
+@article{physics,
+title = "The |physics| package",
+subtitle = "Macros supporting the Mathematics of Physics",
+author = "Sergio C. de la Barrera",
+date = "2012",
+eprinttype = "ctan",
+eprint = "physics",
+}
+
+@article{units,
+title = "The |units| and |nicefrac| packages",
+subtitle = "Typeset units",
+author = "Axel Reichert",
+date = "1998",
+eprinttype = "ctan",
+eprint = "units",
+}
+
+@article{subcaption,
+title = "The |subcaption| package",
+subtitle = "Support for sub-captions",
+author = "Axel Sommerfeldt",
+date = "2007",
+eprinttype = "ctan",
+eprint = "subcaption",
+related = "caption-1",
+}
+
+@article{caption,
+title = "The |caption| package",
+subtitle = "Customising captions in floating environments",
+author = "Axel Sommerfeldt",
+date = "1994",
+eprinttype = "ctan",
+eprint = "caption",
+related = "caption-1",
+}
+
+@manual{caption-1,
+eprinttype = "gitlab",
+eprintclass = "axelsommerfeldt",
+eprint = "caption",
+}
+
+
+@article{biblatex,
+title = "The |biblatex| Package",
+subtitle = "Sophisticated Bibliographies in \hologo{LaTeX}",
+author = "Philipp Lehman and Joseph Wright and Audrey Boruvka and Philip Kime",
+date = "2006",
+eprinttype = "ctan",
+eprint = "biblatex",
+related = "biblatex-1",
+}
+
+@manual{biblatex-1,
+eprinttype = "github",
+eprintclass = "plk",
+eprint = "biblatex",
+}
+
+@article{hyperref,
+title = "Hypertext marks in \hologo{LaTeX}: a manual for |hyperref|",
+subtitle = "Extensive support for hypertext in \hologo{LaTeX}",
+author = "Sebastian Rahtz and Heiko Oberdiek",
+collaboration = "\hologo{LaTeX3} Project",
+date = "1995",
+eprinttype = "ctan",
+eprint = "hyperref",
+related = "hyperref-1",
+}
+
+@manual{hyperref-1,
+eprinttype = "github",
+eprintclass = "latex3",
+eprint = "hyperref",
+}
+
+@article{graphicx,
+title = "Packages in the \enquote{graphics} bundle",
+subtitle = "Enhanced support for graphics",
+author = "David Carlisle and Sebastian Rahtz",
+date = "1994",
+eprinttype = "ctan",
+eprint = "graphicx",
+}
+
+@article{booktabs,
+title = "The |booktabs| package",
+subtitle = "Publication quality tables in \hologo{LaTeX}",
+author = "Danie Els and Simon Fear",
+date = "1995",
+eprinttype = "ctan",
+eprint = "booktabs",
+}
+
+@article{multirow,
+title = "The |multirow|, |bigstrut| and |bigdelim| packages",
+subtitle = "Create tabular cells spanning multiple rows",
+author = "Piet van Oostrum and Jerry Leichter",
+date = "1994",
+eprinttype = "ctan",
+eprint = "multirow",
+}
+
+@article{fixmath,
+title = "The |fixmath| package for \hologo{LaTeX2e}",
+subtitle = "Make maths comply with ISO 31-0:1992 to ISO 31-13:1992",
+author = "Walter Schmidt",
+date = "2000",
+eprinttype = "ctan",
+eprint = "fixmath",
+}
+
+@article{alphabeta,
+title = "The |alphabeta| package",
+subtitle = "LICR macros and encoding definition files for Greek",
+author = "Günter Milde",
+date = "2013",
+eprinttype = "ctan",
+eprint = "greek-fontenc",
+}
+
+@article{textalpha,
+title = "The |textalpha| package",
+subtitle = "LICR macros and encoding definition files for Greek",
+author = "Günter Milde",
+date = "2010",
+eprinttype = "ctan",
+eprint = "greek-fontenc",
+}
+
+@article{arxiv-collector,
+title = "|arxiv-collector|",
+subtitle = "A little Python script to collect \hologo{LaTeX} sources for upload to the arXiv",
+author = "Dougal Sutherland",
+date = "2018",
+eprinttype = "github",
+eprintclass = "dougalsutherland",
+eprint = "arxiv-collector",
+}
+
+@article{biber,
+title = "\hologo{biber}",
+subtitle = "Backend processor for Bib\hologo{LaTeX}",
+author = "François Charette and Philip Kime",
+date = "2009",
+eprinttype = "github",
+eprintclass = "plk",
+eprint = "biber",
+related = "biber-1",
+}
+
+@manual{biber-1,
+eprinttype = "sourceforge",
+eprint = "biblatex-biber",
+}
+
+@article{lmodern,
+title = "Latin Modern Family of Fonts",
+subtitle = "Latin modern fonts in outline formats",
+date = "2003",
+author = "B. Jackowski and J.M. Nowacki",
+url = "http://gust.org.pl/projects/e-foundry/latin-modern",
+eprinttype = "ctan",
+eprint = "lm",
+}
+
+@article{ifluatex,
+title = "The |ifluatex| package",
+subtitle = "Provides the |\textbackslash ifluatex| switch",
+author = "Heiko Oberdiek",
+collaboration = "\hologo{LaTeX} Team",
+date = "2007",
+eprinttype = "ctan",
+eprint = "ifluatex",
+}
+
+@article{ifxetex,
+title = "The |iftex| package",
+subtitle = "Am I running under \hologo{XeTeX}?",
+collaboration = "\hologo{LaTeX} Team",
+author = "Will Robertson",
+date = "2006",
+eprinttype = "ctan",
+eprint = "ifxetex",
+related = "ifxetex-1",
+}
+
+@manual{ifxetex-1,
+eprinttype = "github",
+eprintclass = "latex3",
+eprint = "iftex",
+}
+
+@article{fontspec,
+title = "The |fontspec| package",
+subtitle = "Advanced font selection in \hologo{XeLaTeX} and \hologo{LuaLaTeX}",
+author = "Will Robertson and Khaled Hosny",
+date = "2004",
+eprinttype = "ctan",
+eprint = "fontspec",
+}
+
+@article{fontenc,
+title = "The |fontenc| package",
+subtitle = "Standard package for selecting font encodings",
+collaboration = "\hologo{LaTeX} Team",
+author = "Frank Mittelbach and Robin Fairbairns and Werner Lemberg",
+date = "1995",
+eprinttype = "ctan",
+eprint = "fontenc",
+}
+
+@article{inputenc,
+title = "The |inputenc| package",
+subtitle = "Accept different input encodings",
+collaboration = "\hologo{LaTeX} Team",
+author = "Frank Mittelbach and Alan Jeffrey",
+date = "1989",
+eprinttype = "ctan",
+eprint = "inputenc",
+}
+
+@article{textcomp,
+title = "The |textcomp| package",
+subtitle = "\hologo{LaTeX} support for the Text Companion fonts",
+collaboration = "\hologo{LaTeX} Team",
+author = "Sebastian Rahtz",
+date = "1995",
+eprinttype = "ctan",
+eprint = "textcomp",
+}
+
+@article{enumitem,
+title = "Customizing lists with the |enumitem| package",
+subtitle = "Control layout of itemize, enumerate, description",
+author = "Javier Bezos",
+date = "2003",
+url = "https://texnia.com/enumitem.html",
+eprinttype = "ctan",
+eprint = "enumitem",
+related = "enumitem-1",
+}
+
+@manual{enumitem-1,
+eprinttype = "github",
+eprintclass = "jbezos",
+eprint = "enumitem",
+}
+
+@article{atbegshi,
+title = "The |atbegshi| package",
+subtitle = "Execute stuff at |shipout| time",
+author = "Heiko Oberdiek",
+date = "2007",
+eprinttype = "ctan",
+eprint = "atbegshi",
+related = "atbegshi-1",
+}
+
+@manual{atbegshi-1,
+eprinttype = "github",
+eprintclass = "ho-tex",
+eprint = "atbegshi",
+}
+
+@article{picture,
+title = "The |picture| package",
+subtitle = "Dimens for picture macros",
+author = "Heiko Oberdiek",
+date = "2006",
+eprinttype = "ctan",
+eprint = "picture",
+related = "picture-1",
+}
+
+@manual{picture-1,
+eprinttype = "github",
+eprintclass = "ho-tex",
+eprint = "picture",
+}
+
+@article{varwidth,
+title = "The |varwidth| package",
+subtitle = "A variable-width minipage",
+author = "Donald Arseneau",
+date = "2003",
+eprinttype = "ctan",
+eprint = "varwidth",
+}
+
+@article{csquotes,
+title = "The |csquotes| Package",
+subtitle = "Context sensitive quotation facilities",
+author = "Philipp Lehman and Joseph Wright",
+date = "2003",
+eprinttype = "ctan",
+eprint = "csquotes",
+}
+
+@article{babel,
+title = "|Babel| Localization and internationalization",
+subtitle = "Multilingual support for Plain \hologo{TeX} or \hologo{LaTeX}",
+author = "Johannes Braams and Javier Bezos and at al.",
+date = "1989",
+eprinttype = "ctan",
+eprint = "babel",
+related = "babel-1",
+}
+
+@manual{babel-1,
+eprinttype = "github",
+eprintclass = "latex3",
+eprint = "babel",
+}
+
+@article{polyglossia,
+title = "The |polyglossia| package",
+author = "Arthur Reutenauer and François Charette and Elie Roux and Bastien Roucariès and Jürgen Spitzmüller",
+eprinttype = "ctan",
+eprint = "polyglossia",
+}
+
+@article{parskip,
+title = "The |parskip| package",
+subtitle = "Layout with zero |\textbackslash parindent|, non-zero |\textbackslash parskip|",
+author = "Robin Fairbairns and Frank Mittelbach and H. Partl",
+date = "1989",
+eprinttype = "ctan",
+eprint = "parskip",
+related = "parskip-1",
+}
+
+@manual{parskip-1,
+eprinttype = "github",
+eprintclass = "FrankMittelbach",
+eprint = "fmitex",
+}
+
+
+@article{fntguide,
+title = "\hologo{LaTeX2e}\ font selection",
+subtitle = "Docmentation of \hologo{LaTeX} font commands",
+collaboration = "\hologo{LaTeX} Team",
+date = "1995",
+eprinttype = "ctan",
+eprint = "fntguide",
+}
+
+@article{euenc,
+title = "The Experimental Unicode `EUx’ Encodings",
+author = "Will Robertson and Elie Roux and Khaled Hosny",
+eprinttype = "ctan",
+eprint = "euenc",
+}
+
+@article{soul,
+title = "The |soul| package",
+subtitle = "Hyphenation for letterspacing, underlining, and more",
+author = "Melchior Franz",
+date = "1998",
+eprinttype = "ctan",
+eprint = "soul",
+}
+
+@article{ulem,
+title = "The |ulem| package",
+subtitle = "Package for underlining",
+author = "Donald Arseneau",
+date = "1989",
+eprinttype = "ctan",
+eprint = "ulem",
+}
+
+@article{glossaries,
+title = "The |glossaries| package",
+subtitle = "Create glossaries and lists of acronyms",
+author = "Nicola Talbot",
+date = "2007",
+eprinttype = "ctan",
+eprint = "glossaries",
+}
+
+@article{glossaries-extra,
+title = "The |glossaries-extra| package",
+subtitle = "An extension to the |glossaries| package",
+author = "Dickimaw Books, Nicola Talbot",
+date = "2015",
+eprinttype = "ctan",
+eprint = "glossaries-extra",
+}
+
+@article{xparse,
+title = "The |xparse| package",
+subtitle = "A generic document command parser",
+author = "Frank Mittelbach and Chris Rowley and David Carlisle",
+collaboration = "\hologo{LaTeX3} Project",
+date = "1999",
+eprinttype = "ctan",
+eprint = "xparse",
+}
+
+@article{pdftexcmds,
+title = "The |pdftexcmds| package",
+subtitle = "\hologo{LuaTeX} support for \hologo{pdfTeX} utility functions",
+author = "Heiko Oberdiek",
+date = "2007",
+eprinttype = "ctan",
+eprint = "pdftexcmds",
+}
+
+@article{fix-cm,
+title = "The |fix-cm| package",
+subtitle = "Permit Computer Modern fonts at arbitrary sizes",
+author = "Frank Mittelbach and David Carlisle and Chris Rowley and Walter Schmidt",
+date = "1993",
+eprinttype = "ctan",
+eprint = "fix-cm",
+}
+
+@article{revtex,
+title = "The REV\hologo{TeX} class",
+subtitle = "Styles for various Physics Journals",
+author = "Mark Doyle and Arthur Ogawa",
+collaboration = "American Physical Society",
+date = "1999",
+url = "https://journals.aps.org/revtex",
+eprinttype = "ctan",
+eprint = "revtex",
+}
+
+@article{encguide,
+title = "\hologo{LaTeX} font encodings",
+subtitle = "Documentation of \hologo{LaTeX} font encodings",
+author = "Frank Mittelbach and Robin Fairbairns and Werner Lemberg",
+collaboration = "\hologo{LaTeX3} Project Team",
+date = "1995",
+eprinttype = "ctan",
+eprint = "encguide",
+}
+
+@article{sfmath,
+title = "The |sfmath| package",
+subtitle = "Sans-serif mathematics",
+author = "Olaf Dietrich",
+date = "2005",
+url = "https://dtrx.de/od/tex/sfmath",
+eprinttype = "ctan",
+eprint = "sfmath",
+}
+
+@article{relsize,
+title = "The |relsize| package",
+subtitle = "Set the font size relative to the current font size",
+author = "Donald Arseneau and Matt Swift",
+date = "2011",
+eprinttype = "ctan",
+eprint = "relsize",
+}
+
+@article{everyhook,
+title = "The |everyhook| package",
+subtitle = "Hooks for standard \hologo{TeX} token lists",
+author = "Stephen Checkoway",
+date = "2010",
+eprinttype = "ctan",
+eprint = "everyhook",
+}
+
+
+@article{sansmathfonts,
+title = "The |sansmathfonts| package",
+subtitle = "Correct placement of accents in sans-serif maths",
+author = "Ariel Barton",
+date = "2013",
+eprinttype = "ctan",
+eprint = "sansmathfonts",
+}
+
+@article{xspace,
+title = "The |xspace| package",
+subtitle = "Define commands that appear not to eat spaces",
+author = "David Carlisle and Morten Høgholm",
+collaboration = "\hologo{LaTeX} Team",
+date = "1993",
+eprinttype = "ctan",
+eprint = "xspace",
+}
+
+@article{ragged2e,
+title = "The |ragged2e|-package",
+subtitle = "Alternative versions of \enquote{ragged}-type commands",
+author = "Martin Schröder",
+date = "1996",
+eprinttype = "ctan",
+eprint = "ragged2e",
+related = "ragged2e-1",
+}
+
+@manual{ragged2e-1,
+eprinttype = "gitlab",
+eprintclass = "hagenbuch",
+eprint = "ragged2e",
+}
+
+@article{url,
+title = "The |url| package",
+subtitle = "Verbatim with URL-sensitive line breaks",
+author = "Donald Arseneau",
+date = "1996",
+eprinttype = "ctan",
+eprint = "url",
+}
+
+@article{jhep,
+title = "The |JHEP| package",
+collaboration = "SISSA Medialab",
+date = "1997",
+url = "https://jhep.sissa.it/jhep/help/JHEP_TeXclass.jsp",
+}
+
+@article{jcap,
+title = "The |JCAP| package",
+collaboration = "SISSA Medialab",
+date = "2002",
+url = "https://jcap.sissa.it/jcap/help/JCAP_TeXclass.jsp",
+}
+
+@article{bbm-macros,
+title = "A package for using the |bbm| fonts in math environment",
+author = "Torsten Hilbrich",
+date = "1994",
+eprinttype = "ctan",
+eprint = "bbm-macros",
+related = "bbm"
+}
+
+@article{bbm,
+title = "|bbm|",
+subtitle = "\enquote{Blackboard-style} cm fonts",
+author = "Gilles Robert",
+date = "1993",
+eprinttype = "ctan",
+eprint = "bbm",
+}
+
+@article{arxiv,
+title = "arXiv",
+subtitle = "free distribution service and an open archive for scholarly articles",
+url = "https://arxiv.org",
+author = "Paul Ginsparg",
+collaboration = "arXiv Team",
+year = "1991",
+organization = "Cornell University",
+}
+
+@article{dsfont,
+title = "The |doublestroke| font",
+subtitle = "Typeset mathematical double stroke symbols",
+author = "Olaf Kummer",
+date = "1995",
+eprinttype = "ctan",
+eprint = "doublestroke",
+}
+
+@article{mleftright,
+title = "The |mleftright| package",
+subtitle = "Variants of delimiters that act as maths open/close",
+author = "Heiko Oberdiek",
+date = "2010",
+eprinttype = "ctan",
+eprint = "mleftright",
+}
+
+@article{urwchancal,
+title = "A virtual font for URW Chancery Math",
+subtitle = "Use URW's clone of Zapf Chancery as a maths alphabet",
+author = "Michael Sharpe",
+date = "2011",
+eprinttype = "ctan",
+eprint = "urwchancal",
+}
+
+@article{footnotebackref,
+title = "The |footnotebackref| package",
+subtitle = "Back-references from footnotes",
+author = "Holger Lange",
+date = "2012",
+eprinttype = "ctan",
+eprint = "footnotebackref",
+}
+
+@article{cancel,
+title = "The |cancel| package",
+subtitle = "Place lines through maths formulae",
+author = "Donald Arseneau",
+date = "2013",
+eprinttype = "ctan",
+eprint = "cancel",
+}
+
+@article{beamer,
+title = "The |beamer| class",
+subtitle = "A \hologo{LaTeX} class for producing presentations and slides",
+author = "Till Tantau and Joseph Wright and Vedran Miletić",
+date = "2003",
+eprinttype = "ctan",
+eprint = "beamer",
+related = "beamer-1",
+}
+
+@manual{beamer-1,
+eprinttype = "github",
+eprintclass = "josephwright",
+eprint = "beamer",
+}
+
+@article{exscale,
+title = "The |exscale| package",
+subtitle = "Implements scaling of the \enquote{cmex} fonts",
+author = "Frank Mittelbach and Rainer Schöpf",
+date = "1993",
+eprinttype = "ctan",
+eprint = "exscale",
+}
+
+@article{mathrsfs,
+title = "The |mathrsfs| package",
+subtitle = "Support for using RSFS fonts in maths",
+author = "Jörg Knappen",
+date = "1995",
+eprinttype = "ctan",
+eprint = "mathrsfs",
+}
+
+@article{esint,
+title = "The |esint| package",
+subtitle = "Extended set of integrals for Computer Modern",
+author = "Eddie Saudrais",
+date = "2005",
+eprinttype = "ctan",
+eprint = "esint",
+}
+
+@article{cmbright,
+title = "The |cmbright| package",
+subtitle = "Using the CM Bright typeface with \hologo{LaTeX}",
+author = "Walter A. Schmidt",
+date = "1996",
+eprinttype = "ctan",
+eprint = "cmbright",
+}
+
+@article{titling,
+title = "The |titling| package",
+subtitle = "Control over the typesetting of the |\textbackslash maketitle| command",
+author = "Peter R. Wilson",
+date = "2000",
+eprinttype = "ctan",
+eprint = "titling",
+}
+
+@article{MnSymbol,
+title = "The |MnSymbol| package",
+subtitle = "Mathematical symbol font for Adobe MinionPro",
+author = "Achim Blumensath",
+date = "2005",
+eprinttype = "ctan",
+eprint = "MnSymbol",
+}
+
+@article{environ,
+title = "The |environ| package",
+subtitle = "A new interface for environments in \hologo{LaTeX}",
+author = "Will Robertson",
+date = "2007",
+eprinttype = "ctan",
+eprint = "environ",
+}
+
+@article{abstract,
+title = "The |abstract| package",
+subtitle = "Control the typesetting of the abstract environment",
+author = "Peter R. Wilson",
+date = "2000",
+eprinttype = "ctan",
+eprint = "abstract",
+}
+
+@article{cfr-lm,
+title = "The |cfr-lm| package",
+subtitle = "Enhanced support for the Latin Modern fonts",
+author = "Clea F. Rees",
+date = "2008",
+eprinttype = "ctan",
+eprint = "cfr-lm",
+}
+
+@article{etoolbox,
+title = "The |etoolbox| package",
+subtitle = "e-\hologo{TeX} tools for \hologo{LaTeX}",
+author = "Philipp Lehman and Joseph Wright",
+date = "2007",
+eprinttype = "ctan",
+eprint = "etoolbox",
+}
+
+@article{substitutefont,
+title = "The |substitutefont| package",
+subtitle = "Easy font substitution",
+author = "Günter Milde",
+date = "2010",
+eprinttype = "ctan",
+eprint = "substitutefont",
+}
+
+@article{svjour,
+title = "The |svjour| package",
+subtitle = "Macros for Springer journals",
+collaboration = "Springer Verlag",
+date = "1997",
+eprinttype = "ctan",
+eprint = "springer",
+}
+
+@article{cm,
+title = "Computer Modern fonts",
+author = "Donald E. Knuth",
+date = "1986",
+eprinttype = "ctan",
+eprint = "cm",
+}
+
+@article{subdepth,
+title = "The |subdepth| package",
+subtitle = "Unify maths subscript height",
+author = "Will Robertson",
+date = "2007",
+eprinttype = "ctan",
+eprint = "subdepth",
+}
+
+@article{xpatch,
+title = "The |xpatch| package",
+subtitle = "Extending etoolbox patching commands",
+author = "Enrico Gregorio",
+date = "2012",
+eprinttype = "ctan",
+eprint = "xpatch",
+}
+
+@article{hfoldsty,
+title = "The |hfoldsty| package",
+subtitle = "Old style numerals with EC fonts",
+author = "Harald Harders",
+date = "2004",
+eprinttype = "ctan",
+eprint = "hfoldsty",
+}
+
+@article{slantsc,
+title = "The |slantsc| package",
+subtitle = "Access different-shaped small-caps fonts",
+author = "Harald Harders",
+date = "2003",
+eprinttype = "ctan",
+eprint = "slantsc",
+}
+
+@article{nfssext-cfr,
+title = "The |nfssext-cfr| package",
+subtitle = "Extensions to the \hologo{LaTeX} NFSS",
+author = "Clea F. Rees and Philipp Lehman",
+date = "2003",
+eprinttype = "ctan",
+eprint = "nfssext-cfr",
+}
+
+@article{xstring,
+title = "The |xstring| package",
+subtitle = "String manipulation for \hologo{LaTeX}",
+author = "Christian Tellechea",
+date = "2008",
+eprinttype = "ctan",
+eprint = "xstring",
+}
+
+@article{gregorio:2020,
+title = "\hologo{TeX}, \hologo{LaTeX} and math",
+author = "Enrico Gregorio",
+date = "2020",
+url = "https://latex-project.org/publications/2020-egreg-TUB-tb127gregorio-math.pdf",
+}
+
+@article{soulutf8,
+title = "The |soulutf8| package",
+subtitle = "Permit use of UTF-8 characters in |soul|",
+author = "Heiko Oberdiek",
+date = "2007",
+eprinttype = "ctan",
+eprint = "soulutf8",
+}
+
diff --git a/macros/latex/contrib/hep-title/hep-title-documentation.pdf b/macros/latex/contrib/hep-title/hep-title-documentation.pdf
new file mode 100644
index 0000000000..4c8f7922d4
--- /dev/null
+++ b/macros/latex/contrib/hep-title/hep-title-documentation.pdf
Binary files differ
diff --git a/macros/latex/contrib/hep-title/hep-title-implementation.dtx b/macros/latex/contrib/hep-title/hep-title-implementation.dtx
new file mode 100644
index 0000000000..9a175e673a
--- /dev/null
+++ b/macros/latex/contrib/hep-title/hep-title-implementation.dtx
@@ -0,0 +1,912 @@
+% \iffalse meta-comment
+%
+% Copyright (C) 2019 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.
+%
+% \fi
+%
+% \iffalse
+
+%<package>\NeedsTeXFormat{LaTeX2e}[2005/12/01]
+%<package>\ProvidesPackage{hep-title}[2021/09/01 v1.0 Extend title page macros]
+%<documentation>\ProvidesFile{hep-title-documentation.tex}[2021/09/01 v1.0 hep-title documentation]
+%
+%<*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}}
+
+%</documentation>
+
+%<*driver>
+\expandafter\newif\csname ifshort\endcsname
+\shortfalse
+\begin{document}
+\DocInput{hep-title-implementation.dtx}
+\end{document}
+%</driver>
+%
+% \fi
+%
+% \CheckSum{922}
+%
+% \CharacterTable
+% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+% Digits \0\1\2\3\4\5\6\7\8\9
+% Exclamation \! Double quote \" Hash (number) \#
+% Dollar \$ Percent \% Ampersand \&
+% Acute accent \' Left paren \( Right paren \)
+% Asterisk \* Plus \+ Comma \,
+% Minus \- Point \. Solidus \/
+% Colon \: Semicolon \; Less than \<
+% Equals \= Greater than \> Question mark \?
+% Commercial at \@ Left bracket \[ Backslash \\
+% Right bracket \] Circumflex \^ Underscore \_
+% Grave accent \` Left brace \{ Vertical bar \|
+% Right brace \} Tilde \~}
+%
+% \changes{v1.0}{2021/09/01}{Initial version of the style file.}
+%
+% \ifshort
+%<*documentation>
+% \fi
+%
+\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}
+
+% \ifshort
+\begin{document}
+% \fi
+
+\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.
+
+% \ifshort
+\printbibliography
+
+\end{document}
+%
+%</documentation>
+% \fi
+%
+% \StopEventually{
+% \printbibliography
+% \PrintChanges
+% }
+%
+% \appendix
+%
+% \section{Implementation}
+%
+%<*package>
+%
+% \begin{macro}{\online}
+% \begin{macro}{\email}
+% Provide the "\online"\marg{text}\marg{url} macro combining the features of the "\href" and the "\url" macros.
+% Define a macro for typesetting emails.
+% \begin{macrocode}
+\providecommand{\online}[2]{\texttt{#2}}%
+\providecommand{\hep@email}[1]{\online{mailto:#1}{#1}}
+\providecommand\email{\hep@email}
+\AtBeginDocument{\@ifpackageloaded{hyperref}{%
+ \renewcommand{\online}[2]{\href{#1}{\nolinkurl{#2}}}%
+ }{}
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\hep@multi@ref}
+% Transform reference list to list of references.
+% \begin{macrocode}
+\newif\ifhep@first%
+\newcommand{\hep@multi@ref}[1]{%
+ \hep@firsttrue%
+ \forcsvlist{%
+ \ifhep@first\hep@firstfalse\else\textsuperscript,\fi\ref%
+ }{#1}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% Redefine the email macro for the title page.
+% \begin{macrocode}
+\renewcommand{\email}[2][]{\unskip\thanks[#1]{\hep@email{#2}}}%
+\AtBeginDocument{
+ \let\hep@maketitle\maketitle
+ \renewcommand\maketitle{\hep@maketitle\let\email\hep@email}
+}
+% \end{macrocode}
+%
+% \subsection{Preprint and title}
+%
+% \subsubsection{Preprint}
+%
+% \begin{macro}{\preprintfont}
+% Define the "\preprintfont" macro.
+% \begin{macrocode}
+\let\hep@preprint@font\relax
+\newcommand{\preprintfont}[1]{\def\hep@preprint@font{#1}}
+\preprintfont{\scshape\small}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\preprint}
+% Define the "\preprint" macro using the \software{varwidth} package \cite{varwidth}.
+% \begin{macrocode}
+\let\hep@preprint\relax
+\newcommand\preprint[1]{\def\hep@preprint{#1}}
+\RequirePackage{varwidth}
+\newcommand{\hep@preprint@box}{%
+ \begin{varwidth}{\textwidth}%
+ \hep@preprint@font\hep@preprint%
+ \end{varwidth}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\placepreprint}
+% Places a preprint number in the top right corner of the title page using the \software{atbegshi} \cite{atbegshi} and \software{picture} \cite{picture} packages.
+% \begin{macrocode}
+\RequirePackage{calc}
+\RequirePackage{atbegshi}
+\RequirePackage{picture}
+\newcommand{\placepreprint}{%
+ \AtBeginShipoutFirst{%
+ \put(
+ \textwidth+\oddsidemargin-\widthof{\hep@preprint@box},
+ -2pt-\topmargin-\heightof{\hep@preprint@box}
+ ){\normalfont\hep@preprint@box}
+ }
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{Series}
+%
+% \begin{macro}{\series}
+% Define a series title.
+% \begin{macrocode}
+\newcommand{\preseries}[1]{\def\hep@pre@series{#1}}
+\newcommand{\series}[1]{\def\hep@series{#1}}
+\newcommand{\postseries}[1]{\def\hep@post@series{#1}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\seriesfont}
+% Allow to change the fontface of the series title.
+% \begin{macrocode}
+\let\hep@series@font\relax
+\newcommand{\seriesfont}[1]{\def\hep@series@font{#1}}
+% \end{macrocode}
+% \end{macro}
+%
+% Set the default series title layout.
+% \begin{macrocode}
+\preseries{\begin{center}\Large\hep@series@font}
+\postseries{\par\end{center}}
+% \end{macrocode}
+%
+% \subsubsection{Title}
+%
+% Extend the title using the \software{titling} package \cite{titling}.
+% Fix the footnote indent.
+% \begin{macrocode}
+\RequirePackage{titling}
+\setlength{\thanksmarkwidth}{1.5em}
+% \end{macrocode}
+%
+% \begin{macro}{\maketitlehooka}
+% Place the preprint and the series title using "\maketitlehooka".
+% \begin{macrocode}
+\renewcommand{\maketitlehooka}{%
+ \placepreprint\vspace{-\bigskipamount}%
+ \@ifundefined{hep@series}{}{%
+ \hep@pre@series\hep@series\hep@post@series%
+ }%
+ \vspace{-\bigskipamount}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\titlefont}
+% Allow to change the fontface of the the title.
+% \begin{macrocode}
+\let\hep@title@font\relax
+\newcommand{\titlefont}[1]{\def\hep@title@font{#1}}
+% \end{macrocode}
+% \end{macro}
+% Set default title layout.
+% \begin{macrocode}
+\pretitle{\begin{center}\LARGE\hep@title@font}
+\posttitle{\par\end{center}}
+% \end{macrocode}
+
+% \subsubsection{Subtitle}
+%
+% \begin{macro}{\subtitle}
+% Define a subtitle.
+% \begin{macrocode}
+\newcommand{\presubtitle}[1]{\def\hep@pre@sub@title{#1}}
+\newcommand{\subtitle}[1]{\def\hep@sub@title{#1}}
+\newcommand{\postsubtitle}[1]{\def\hep@post@sub@title{#1}}
+% \end{macrocode}
+% \end{macro}
+
+% \begin{macro}{\subtitlefont}
+% Allow to change the fontface of the subtitle.
+% \begin{macrocode}
+\let\hep@subtitle@font\relax
+\newcommand{\subtitlefont}[1]{\def\hep@subtitle@font{#1}}
+% \end{macrocode}
+% \end{macro}
+%
+% Set default subtitle layout.
+% \begin{macrocode}
+\presubtitle{\begin{center}\Large\hep@subtitle@font}
+\postsubtitle{\par\end{center}}
+% \end{macrocode}
+%
+% \subsection{Authors and Editors}
+%
+% \subsubsection{Editors}
+%
+% Define editors, similar to authors using the \software{authblk} package.
+% Enable the handling of multiple authors with different affiliations using the \software{authblk} package \cite{authblk}.
+% \begin{macrocode}
+\RequirePackage{authblk}
+\newcounter{editors}
+\newcommand\hep@editorlist{}
+\newcommand\hep@editors{}
+\@namedef{hep@editor@sep1}{}
+\@namedef{hep@editor@sep2}{\Authand}
+% \end{macrocode}
+%
+% \begin{macro}{\editor}
+% Copy of the "authblk" author code adjusted for editors.
+% \begin{macrocode}
+\newcommand\editor[2][]{%
+ \ifnewaffil%
+ \addtocounter{affil}{1}%
+ \edef\AB@thenote{\arabic{affil}}%
+ \fi%
+ \if\relax#1\relax%
+ \def\AB@note{\AB@thenote}%
+ \else%
+ \def\AB@note{#1}\setcounter{Maxaffil}{0}%
+ \fi%
+ \ifnum\value{editors}>1\relax%
+ \@namedef{hep@editor@sep\number\c@editors}{\Authsep}%
+ \fi%
+ \addtocounter{editors}{1}%
+ \begingroup%
+ \let\protect\@unexpandable@protect \let\and\AB@pand%
+ \def\thanks{\protect\thanks}\def\footnote{\protect\footnote}%
+ \@temptokena=\expandafter{\hep@editors}{%
+ \def\\{%
+ \protect\\[\@affilsep]\protect\Affilfont\protect\AB@resetsep%
+ }%
+ \xdef\hep@editor{\AB@blk@and#2}%
+ \ifnewaffil%
+ \gdef\AB@las{}\gdef\AB@lasx{\protect\Authand}\gdef\AB@as{}%
+ \xdef\hep@editors{\the\@temptokena\AB@blk@and}%
+ \else%
+ \xdef\hep@editors{\the\@temptokena\AB@as\AB@au@str}%
+ \global\let\AB@las\AB@lasx\gdef\AB@lasx{\protect\Authands}%
+ \gdef\AB@as{\Authsep}%
+ \fi%
+ \gdef\AB@au@str{#2}%
+ }%
+ \@temptokena=\expandafter{\hep@editorlist}%
+ \let\\=\editorcr%
+ \xdef\hep@editorlist{%
+ \the\@temptokena%
+ \protect\@nameuse{hep@editor@sep\number\c@editors}%
+ \protect\Authfont#2%
+ \if\relax#1\relax\else%
+ \protect\hep@multi@ref{\AB@note}%
+ \fi%
+ }%
+ \endgroup%
+ \ifnum\value{editors}>2\relax%
+ \@namedef{hep@editor@sep\number\c@editors}{\Authands}%
+ \fi%
+ \newaffilfalse%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\editorfont}
+% Allow to change the fontface of the editors.
+% \begin{macrocode}
+\let\hep@editor@font\relax
+\newcommand{\editorfont}[1]{\def\hep@editor@font{#1}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\preditor}
+% \begin{macro}{\postditor}
+% Set editor style.
+% \begin{macrocode}
+\newcommand{\preeditor}[1]{\def\hep@pre@editor{#1}}
+\newcommand{\posteditor}[1]{\def\hep@post@editor{#1}}
+\newcommand{\editortitle}[2]{
+ \def\hep@editor@title{#1}
+ \def\hep@editor@title@pl{#2}
+}
+\newcommand{\editortitlefont}[1]{\def\hep@editor@title@font{#1}}
+\newcommand{\preeditortitle}[1]{\def\hep@pre@editor@title{#1}}
+\newcommand{\posteditortitle}[1]{\def\hep@post@editor@title{#1}}
+\editortitle{Editor}{Editors}
+\editortitlefont{\itshape}
+\preeditortitle{\hep@editor@title@font}
+\posteditortitle{: }
+\preeditor{%
+ \begin{center}%
+ \large\hep@editor@font\lineskip.5em%
+ \begin{tabular}[t]{c}{%
+ \hep@pre@editor@title%
+ \ifnum\value{editors}>1\relax%
+ \hep@editor@title@pl%
+ \else%
+ \hep@editor@title%
+ \fi%
+ \hep@post@editor@title%
+ }%
+}
+\posteditor{\end{tabular}\par\end{center}}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\maketitlehookb}
+% Show subtitle and editor.
+% \begin{macrocode}
+\renewcommand{\maketitlehookb}{%
+ \@ifundefined{hep@sub@title}{}{%
+ \hep@pre@sub@title\hep@sub@title\hep@post@sub@title%
+ }%
+ \smallskip%
+ \ifx\hep@editorlist\AB@empty\else%
+ \hep@pre@editor\hep@editorlist\hep@post@editor%
+ \fi
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{Authors}
+%
+% \begin{macro}{\author}
+% Allow absent author field.
+% \begin{macrocode}
+% \author{}
+% \end{macrocode}
+% \end{macro}
+%
+% Switch authblk to a label ref system for affiliations.
+% \begin{macrocode}
+\RequirePackage{xpatch}
+\xpatchcmd{\author}{%
+ \protect\Authfont#2\AB@authnote{\AB@note}%
+}{%
+ \protect\Authfont#2%
+ \if\relax#1\relax\else\unskip\protect\hep@multi@ref{\AB@note}\fi%
+}{}{}
+% \end{macrocode}
+%
+% \begin{macro}{\authorfont}
+% Allow to change the fontface of the individual parts of the title.
+% \begin{macrocode}
+\let\hep@author@font\relax
+\newcommand{\authorfont}[1]{\def\hep@author@font{#1}}
+\renewcommand\Authfont{\hep@author@font}
+% \end{macrocode}
+% \end{macro}
+%
+% Set default author fontface.
+% \begin{macrocode}
+\newcommand{\authortitle}[2]{
+ \def\hep@author@title{#1}
+ \def\hep@author@title@pl{#2}
+}
+\newcommand{\authortitlefont}[1]{\def\hep@author@title@font{#1}}
+\newcommand{\preauthortitle}[1]{\def\hep@pre@author@title{#1}}
+\newcommand{\postauthortitle}[1]{\def\hep@post@author@title{#1}}
+\authortitle{Author}{Authors}
+\authortitlefont{\itshape}
+\preauthortitle{\hep@author@title@font}
+\postauthortitle{: }
+\preauthor{%
+ \begin{center}%
+ \large\hep@author@font\lineskip.5em%
+ \begin{tabular}[t]{c}{%
+ \ifnum\value{editors}>0\relax%
+ \hep@pre@author@title%
+ \ifnum\value{authors}>1\relax%
+ \hep@author@title@pl\else\hep@author@title%
+ \fi\hep@post@author@title%
+ \fi%
+ }%
+}
+\postauthor{\end{tabular}\par\end{center}}
+% \end{macrocode}
+%
+% \subsubsection{Endorser}
+%
+% \begin{macrocode}
+\newcounter{endorsers}
+\newcommand\hep@endorserlist{}
+\newcommand\hep@endorsers{}
+\@namedef{hep@editor@sep1}{}
+\@namedef{hep@editor@sep2}{\Authand}
+% \end{macrocode}
+%
+% \begin{macro}{\endorser}
+% Copy of the "authblk" author code adjusted for endorsers.
+% \begin{macrocode}
+\DeclareRobustCommand\endorser{\@ifnextchar[{\hep@@endorser}{\hep@@@endorser}}
+\def\hep@@endorser[#1]#2{\hep@@@@endorser[#1]{#2}}
+\def\hep@@@endorser#1{\hep@@@@endorser{#1}}
+\newcommand\hep@@@@endorser[2][]{%
+ \ifnewaffil%
+ \addtocounter{affil}{1}%
+ \edef\AB@thenote{\arabic{affil}}%
+ \fi%
+ \if\relax#1\relax%
+ \def\AB@note{\AB@thenote}%
+ \else%
+ \def\AB@note{#1}\setcounter{Maxaffil}{0}%
+ \fi%
+ \ifnum\value{endorsers}>1\relax%
+ \@namedef{hep@endorser@sep\number\c@endorsers}{\Authsep}%
+ \fi%
+ \addtocounter{endorsers}{1}%
+ \begingroup%
+ \let\protect\@unexpandable@protect \let\and\AB@pand%
+ \def\thanks{\protect\thanks}\def\footnote{\protect\footnote}%
+ \@temptokena=\expandafter{\hep@endorsers}{%
+ \def\\{%
+ \protect\\[\@affilsep]\protect\Affilfont\protect\AB@resetsep%
+ }%
+ \xdef\hep@endorser{\AB@blk@and#2}%
+ \ifnewaffil%
+ \gdef\AB@las{}\gdef\AB@lasx{\protect\Authand}\gdef\AB@as{}%
+ \xdef\hep@endorsers{\the\@temptokena\AB@blk@and}%
+ \else%
+ \xdef\hep@endorsers{\the\@temptokena\AB@as\AB@au@str}%
+ \global\let\AB@las\AB@lasx\gdef\AB@lasx{\protect\Authands}%
+ \gdef\AB@as{\Authsep}%
+ \fi%
+ \gdef\AB@au@str{#2}%
+ }%
+ \@temptokena=\expandafter{\hep@endorserlist}%
+ \let\\=\endorsercr%
+ \xdef\hep@endorserlist{%
+ \the\@temptokena%
+ \protect\@nameuse{hep@endorser@sep\number\c@endorsers}%
+ \protect\Authfont#2%
+ \if\relax#1\relax\else%
+ \protect\hep@multi@ref{\AB@note}%
+ \fi%
+ }%
+ \endgroup%
+ \ifnum\value{endorsers}>2\relax%
+ \@namedef{hep@endorser@sep\number\c@endorsers}{\Authands}%
+ \fi%
+ \newaffilfalse%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\endorserfont}
+% \begin{macro}{\preendorser}
+% \begin{macro}{\postendorser}
+% \begin{macrocode}
+\let\hep@endorser@font\relax
+\def\endorserfont#1{\def\hep@endorser@font{#1}}
+\newcommand{\preendorser}[1]{\def\hep@pre@endorser{#1}}
+\newcommand{\postendorser}[1]{\def\hep@post@endorser{#1}}
+\def\endorsertitle#1#2{
+ \def\hep@endorser@title{#1}
+ \def\hep@endorser@title@pl{#2}
+}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\endorsertitlefont}
+% \begin{macro}{\preendorsertitle}
+% \begin{macro}{\postendorsertitle}
+% \begin{macrocode}
+\def\endorsertitlefont#1{\def\hep@endorser@title@font{#1}}
+\newcommand{\preendorsertitle}[1]{\def\hep@pre@endorser@title{#1}}
+\newcommand{\postendorsertitle}[1]{\def\hep@post@endorser@title{#1}}
+\endorsertitle{Endorser}{Endorsers}
+\endorsertitlefont{\itshape}
+\preendorsertitle{\hep@endorser@title@font}
+\postendorsertitle{: }
+\preendorser{%
+ \begin{center}%
+ \large\hep@endorser@font\lineskip.5em%
+ \begin{tabular}[t]{c}{%
+ \hep@pre@endorser@title%
+ \ifnum\value{endorsers}>1\relax%
+ \hep@endorser@title@pl%
+ \else%
+ \hep@endorser@title%
+ \fi%
+ \hep@post@endorser@title%
+ }%
+}
+\postendorser{\end{tabular}\par\end{center}}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \subsubsection{Affiliation}
+%
+% Patch the "\affiliation" macro to comply with the label ref system.
+% \begin{macrocode}
+\newcounter{affiliation}
+\renewcommand{\theaffiliation}{%
+ \textsuperscript{\normalfont\alph{affiliation}}%
+}
+\xpatchcmd{\affil}{%
+ \AB@affilnote{\AB@note}%
+}{%
+ \protect\refstepcounter{affiliation}\protect\label{\AB@note}%
+ \if\relax#1\relax\else\protect\ref{\AB@note}\fi%
+}{}{}
+% \end{macrocode}
+%
+% \begin{macro}{\affiliationfont}
+% Allow to change the fontface of affiliation.
+% \begin{macrocode}
+\let\hep@affiliation@font\relax
+\newcommand{\affiliationfont}[1]{\def\hep@affiliation@font{#1}}
+% \newif\ifhep@lining\hep@liningtrue
+% \ifhep@lining
+ \renewcommand{\Affilfont}{\small\hep@affiliation@font}
+% \else
+% \renewcommand{\Affilfont}{\small\ostyle\hep@affiliation@font}
+% \fi
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\affiliation}
+% Define the "\affiliation" macro, ensure that linebreaks happen after a comma.
+% \begin{macrocode}
+\newcommand\hep@penalty{\if@twocolumn85\else50\fi}
+\newcommand\hep@active@comma{,\penalty-\hep@penalty\relax}
+\newcommand\hep@cat@comma@active{\catcode`\,\active}
+{\hep@cat@comma@active\gdef,{\hep@active@comma}}
+\newcommand\hep@affil[1]{%
+ \endgroup\@flushglue=0pt plus .5\linewidth\affil{#1}%
+}
+\def\hep@affil@opt[#1]#2{%
+ \endgroup\@flushglue=0pt plus .5\linewidth\affil[#1]{#2}%
+}
+\DeclareRobustCommand\hep@affiliation{%
+ \@ifnextchar[{\hep@affil@opt}{\hep@affil}%
+}
+\newcommand{\affiliation}{%
+ \begingroup\hep@cat@comma@active\hep@affiliation%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% Place endorser and affiliation
+% \begin{macrocode}
+\renewcommand{\maketitlehookc}{%
+ \ifx\hep@endorserlist\AB@empty\else%
+ \hep@pre@endorser\hep@endorserlist\hep@post@endorser%
+ \fi
+% \\[\affilsep]
+ \ifx\AB@affillist\AB@empty\else%
+ \begin{center}\AB@affillist\end{center}%
+ \fi%
+}
+% \end{macrocode}
+%
+% \begin{macro}{\@author}
+% Ensure that affiliation is not set directly below author
+% \begin{macrocode}
+\def\@author{}
+\renewcommand\@author{%
+ \ifx\AB@affillist\AB@empty%
+ \AB@author%
+ \else%
+ \ifnum\value{affil}>\value{Maxaffil}
+ \def\rlap##1{##1}%
+ \AB@authlist%
+% \\[\affilsep]\AB@affillist%
+ \else%
+ \AB@authors%
+ \fi%
+ \fi%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsection{Date and Abstract}
+%
+% \subsubsection{Date}
+%
+% \begin{macro}{\date}
+% Allow absent date field.
+% \begin{macrocode}
+\date{\vspace{-4ex}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\datefont}
+% Allow to change the fontface of the individual parts of the title.
+% \begin{macrocode}
+\let\hep@date@font\relax
+\newcommand{\datefont}[1]{\def\hep@date@font{#1}}
+% \end{macrocode}
+% \end{macro}
+%
+% Set the default "date" fontface.
+% \begin{macrocode}
+\predate{\begin{center}\hep@date@font}
+\postdate{\par\end{center}}
+% \end{macrocode}
+%
+% \subsubsection{Abstract}
+%
+% \begin{environment}{abstract}
+% Adjust the "abstract" environment to not start with indentation.
+% \begin{macrocode}
+\@ifundefined{abstract}{}{%
+ \let\hep@abstract\abstract%
+ \renewcommand\abstract{\hep@abstract\noindent\ignorespaces}%
+% \end{macrocode}
+% \end{environment}
+% \begin{environment}{abstract*}
+% Add a "abstract*" environment for two column mode taking also care of placing the title using the \software{environ} \cite{environ} and \software{abstract} \cite{abstract} packages.
+% \begin{macrocode}
+ \if@twocolumn
+ \RequirePackage{environ}
+ \RequirePackage{abstract}
+ \renewcommand{\abstitleskip}{-3ex}
+ \NewEnviron{abstract*}{%
+ \twocolumn[\maketitle\vspace{-5ex}%
+ \begin{onecolabstract}\noindent\BODY\end{onecolabstract}%
+ \vspace{.5cm}]\saythanks%
+ }%
+ \else
+ \newenvironment{abstract*}{%
+ \maketitle\begin{abstract}%
+ }{%
+ \end{abstract}%
+ }
+ \fi
+}
+% \end{macrocode}
+% \end{environment}
+%
+% \subsection{Thanks}
+%
+% \begin{macro}{\thanks} Redefine thank to have a optional argument for a reference label.
+% \begin{macrocode}
+\let\hep@thanks\thanks
+\AtEndDocument{\let\thanks\hep@thanks}
+\DeclareRobustCommand\thanks[2][]{%
+ \AfterEndPreamble{%
+ \if\relax#1\relax%
+ \footnotemark%
+ \else%
+ \renewcommand\thefootnote{\textsuperscript{\@fnsymbol\c@footnote}}%
+ \protect\refstepcounter{footnote}\protect\label{#1}%
+ \renewcommand\thefootnote{\@arabic\c@footnote}%
+ \fi%
+ \protected@xdef\@thanks{%
+ \@thanks\protect\footnotetext[\the\c@footnote]{#2}%
+ }
+ \if@twocolumn
+ \protected@xdef\@bs@thanks{%
+ \@bs@thanks\protect\footnotetext[\the\c@footnote]{#2}%
+ }%
+ \fi%
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+%</package>
+%
+% \section{Test}
+%
+%<*testone|testtwo>
+%
+% \begin{macrocode}
+%<testone>\documentclass{article}
+%<testtwo>\documentclass[twocolumn]{article}
+
+%% \usepackage[lang=english]{hep-paper}
+\usepackage[math]{blindtext}
+\usepackage{hep-title}
+\usepackage{hyperref}
+\def\BackrefFootnoteTag{}\usepackage{footnotebackref}
+
+\preprint{Preprint}
+
+\series{Series}
+
+\title{Title}
+
+\subtitle{Subtitle}
+
+\editor[one]{First Editor}
+\editor[one,two,second]{Second Editor}
+\email[second]{second@mail.com}
+\editor[one,two,three]{Third Editor \email{third@mail.com}}
+
+\author[three,four]{First Author}
+\author[fourth, two,four,thanks]{Second Author}
+\email[fourth]{fifth@mail.com}
+\thanks[thanks]{Thanks}
+\author[two,three,four]{Third Author \email{sixth@mail.com}}
+\author{Fourth Author}
+
+\endorser[four]{First Endorser}
+\endorser[five]{Second Endorser}
+\endorser{Third Endorser}
+
+\affiliation[one]{First Affiliation}
+\affiliation[two]{Second Affiliation}
+\affiliation[three]{Third Affiliation}
+\affiliation[four]{Fourth Affiliation}
+\affiliation[five]{Fifth Affiliation}
+
+\date{Date}
+
+\begin{document}
+
+%<testone> \maketitle
+
+%<testone> \begin{abstract}
+%<testtwo> \begin{abstract*}
+\blindtext
+%<testone> \end{abstract}
+%<testtwo> \end{abstract*}
+
+First page footnote.\footnote{Footnote}
+
+\blinddocument
+
+\end{document}
+% \end{macrocode}
+%
+%</testone|testtwo>
+%
+% \section{Readme}
+%
+%<*readme>
+%
+% \begin{macrocode}
+# The `hep-title` package
+
+Extensions for the title page
+
+## Introduction
+
+The `hep-title` package extends the title macros of the standard classes with macros for a preprint, affiliation, editors, and endorsers.
+
+To use the `hep-title` package include it with `\usepackage{hep-title}`.
+
+## Author
+
+Jan Hajer
+
+## License
+
+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.
+% \end{macrocode}
+%
+%</readme>
+%
+% \Finale
+
+\endinput
+
+% \PrintIndex
+% makeindex -s gglo.ist -o hep-title-implementation.gls hep-title-implementation.glo
+% makeindex -s gglo.ist -o hep-title-implementation.ind hep-title-implementation.idx
diff --git a/macros/latex/contrib/hep-title/hep-title-implementation.pdf b/macros/latex/contrib/hep-title/hep-title-implementation.pdf
new file mode 100644
index 0000000000..7dafac24a9
--- /dev/null
+++ b/macros/latex/contrib/hep-title/hep-title-implementation.pdf
Binary files differ
diff --git a/macros/latex/contrib/hep-title/hep-title.ins b/macros/latex/contrib/hep-title/hep-title.ins
new file mode 100644
index 0000000000..7ad98b6490
--- /dev/null
+++ b/macros/latex/contrib/hep-title/hep-title.ins
@@ -0,0 +1,50 @@
+%% 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.
+
+\input docstrip.tex
+\keepsilent
+\usedir{tex/latex/hep-title}
+
+\preamble
+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.
+\endpreamble
+
+\generate{
+ \file{hep-title-documentation.tex}{\from{hep-title-implementation.dtx}{documentation}}
+ \file{hep-title.sty}{\from{hep-title-implementation.dtx}{package}}
+ \file{hep-title-test-one.tex}{\from{hep-title-implementation.dtx}{testone}}
+ \file{hep-title-test-two.tex}{\from{hep-title-implementation.dtx}{testtwo}}
+ \nopreamble\nopostamble\file{README-hep-title.md}{\from{hep-title-implementation.dtx}{readme}}
+}
+
+\Msg{*********************************************************}
+\Msg{*}
+\Msg{* To finish the installation you have to move the}
+\Msg{* following file into a directory searched by TeX:}
+\Msg{*}
+\Msg{* \space\space hep-title.sty}
+\Msg{*}
+\Msg{* To produce the documentation run the file}
+\Msg{* hep-title-documentation.dtx through LaTeX.}
+\Msg{*}
+\Msg{* Happy TeXing!}
+\Msg{*********************************************************}
+
+\endbatchfile
diff --git a/macros/latex/contrib/hep-title/license.md b/macros/latex/contrib/hep-title/license.md
new file mode 100644
index 0000000000..494f58131f
--- /dev/null
+++ b/macros/latex/contrib/hep-title/license.md
@@ -0,0 +1,416 @@
+The LaTeX Project Public License
+=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
+
+LPPL Version 1.3c 2008-05-04
+
+Copyright 1999 2002-2008 LaTeX3 Project
+ Everyone is allowed to distribute verbatim copies of this
+ license document, but modification of it is not allowed.
+
+
+PREAMBLE
+========
+
+The LaTeX Project Public License (LPPL) is the primary license under
+which the LaTeX kernel and the base LaTeX packages are distributed.
+
+You may use this license for any work of which you hold the copyright
+and which you wish to distribute. This license may be particularly
+suitable if your work is TeX-related (such as a LaTeX package), but
+it is written in such a way that you can use it even if your work is
+unrelated to TeX.
+
+The section `WHETHER AND HOW TO DISTRIBUTE WORKS UNDER THIS LICENSE',
+below, gives instructions, examples, and recommendations for authors
+who are considering distributing their works under this license.
+
+This license gives conditions under which a work may be distributed
+and modified, as well as conditions under which modified versions of
+that work may be distributed.
+
+We, the LaTeX3 Project, believe that the conditions below give you
+the freedom to make and distribute modified versions of your work
+that conform with whatever technical specifications you wish while
+maintaining the availability, integrity, and reliability of
+that work. If you do not see how to achieve your goal while
+meeting these conditions, then read the document `cfgguide.tex'
+and `modguide.tex' in the base LaTeX distribution for suggestions.
+
+
+DEFINITIONS
+===========
+
+In this license document the following terms are used:
+
+ `Work'
+ Any work being distributed under this License.
+
+ `Derived Work'
+ Any work that under any applicable law is derived from the Work.
+
+ `Modification'
+ Any procedure that produces a Derived Work under any applicable
+ law -- for example, the production of a file containing an
+ original file associated with the Work or a significant portion of
+ such a file, either verbatim or with modifications and/or
+ translated into another language.
+
+ `Modify'
+ To apply any procedure that produces a Derived Work under any
+ applicable law.
+
+ `Distribution'
+ Making copies of the Work available from one person to another, in
+ whole or in part. Distribution includes (but is not limited to)
+ making any electronic components of the Work accessible by
+ file transfer protocols such as FTP or HTTP or by shared file
+ systems such as Sun's Network File System (NFS).
+
+ `Compiled Work'
+ A version of the Work that has been processed into a form where it
+ is directly usable on a computer system. This processing may
+ include using installation facilities provided by the Work,
+ transformations of the Work, copying of components of the Work, or
+ other activities. Note that modification of any installation
+ facilities provided by the Work constitutes modification of the Work.
+
+ `Current Maintainer'
+ A person or persons nominated as such within the Work. If there is
+ no such explicit nomination then it is the `Copyright Holder' under
+ any applicable law.
+
+ `Base Interpreter'
+ A program or process that is normally needed for running or
+ interpreting a part or the whole of the Work.
+
+ A Base Interpreter may depend on external components but these
+ are not considered part of the Base Interpreter provided that each
+ external component clearly identifies itself whenever it is used
+ interactively. Unless explicitly specified when applying the
+ license to the Work, the only applicable Base Interpreter is a
+ `LaTeX-Format' or in the case of files belonging to the
+ `LaTeX-format' a program implementing the `TeX language'.
+
+
+
+CONDITIONS ON DISTRIBUTION AND MODIFICATION
+===========================================
+
+1. Activities other than distribution and/or modification of the Work
+are not covered by this license; they are outside its scope. In
+particular, the act of running the Work is not restricted and no
+requirements are made concerning any offers of support for the Work.
+
+2. You may distribute a complete, unmodified copy of the Work as you
+received it. Distribution of only part of the Work is considered
+modification of the Work, and no right to distribute such a Derived
+Work may be assumed under the terms of this clause.
+
+3. You may distribute a Compiled Work that has been generated from a
+complete, unmodified copy of the Work as distributed under Clause 2
+above, as long as that Compiled Work is distributed in such a way that
+the recipients may install the Compiled Work on their system exactly
+as it would have been installed if they generated a Compiled Work
+directly from the Work.
+
+4. If you are the Current Maintainer of the Work, you may, without
+restriction, modify the Work, thus creating a Derived Work. You may
+also distribute the Derived Work without restriction, including
+Compiled Works generated from the Derived Work. Derived Works
+distributed in this manner by the Current Maintainer are considered to
+be updated versions of the Work.
+
+5. If you are not the Current Maintainer of the Work, you may modify
+your copy of the Work, thus creating a Derived Work based on the Work,
+and compile this Derived Work, thus creating a Compiled Work based on
+the Derived Work.
+
+6. If you are not the Current Maintainer of the Work, you may
+distribute a Derived Work provided the following conditions are met
+for every component of the Work unless that component clearly states
+in the copyright notice that it is exempt from that condition. Only
+the Current Maintainer is allowed to add such statements of exemption
+to a component of the Work.
+
+ a. If a component of this Derived Work can be a direct replacement
+ for a component of the Work when that component is used with the
+ Base Interpreter, then, wherever this component of the Work
+ identifies itself to the user when used interactively with that
+ Base Interpreter, the replacement component of this Derived Work
+ clearly and unambiguously identifies itself as a modified version
+ of this component to the user when used interactively with that
+ Base Interpreter.
+
+ b. Every component of the Derived Work contains prominent notices
+ detailing the nature of the changes to that component, or a
+ prominent reference to another file that is distributed as part
+ of the Derived Work and that contains a complete and accurate log
+ of the changes.
+
+ c. No information in the Derived Work implies that any persons,
+ including (but not limited to) the authors of the original version
+ of the Work, provide any support, including (but not limited to)
+ the reporting and handling of errors, to recipients of the
+ Derived Work unless those persons have stated explicitly that
+ they do provide such support for the Derived Work.
+
+ d. You distribute at least one of the following with the Derived Work:
+
+ 1. A complete, unmodified copy of the Work;
+ if your distribution of a modified component is made by
+ offering access to copy the modified component from a
+ designated place, then offering equivalent access to copy
+ the Work from the same or some similar place meets this
+ condition, even though third parties are not compelled to
+ copy the Work along with the modified component;
+
+ 2. Information that is sufficient to obtain a complete,
+ unmodified copy of the Work.
+
+7. If you are not the Current Maintainer of the Work, you may
+distribute a Compiled Work generated from a Derived Work, as long as
+the Derived Work is distributed to all recipients of the Compiled
+Work, and as long as the conditions of Clause 6, above, are met with
+regard to the Derived Work.
+
+8. The conditions above are not intended to prohibit, and hence do not
+apply to, the modification, by any method, of any component so that it
+becomes identical to an updated version of that component of the Work as
+it is distributed by the Current Maintainer under Clause 4, above.
+
+9. Distribution of the Work or any Derived Work in an alternative
+format, where the Work or that Derived Work (in whole or in part) is
+then produced by applying some process to that format, does not relax or
+nullify any sections of this license as they pertain to the results of
+applying that process.
+
+10. a. A Derived Work may be distributed under a different license
+ provided that license itself honors the conditions listed in
+ Clause 6 above, in regard to the Work, though it does not have
+ to honor the rest of the conditions in this license.
+
+ b. If a Derived Work is distributed under a different license, that
+ Derived Work must provide sufficient documentation as part of
+ itself to allow each recipient of that Derived Work to honor the
+ restrictions in Clause 6 above, concerning changes from the Work.
+
+11. This license places no restrictions on works that are unrelated to
+the Work, nor does this license place any restrictions on aggregating
+such works with the Work by any means.
+
+12. Nothing in this license is intended to, or may be used to, prevent
+complete compliance by all parties with all applicable laws.
+
+
+NO WARRANTY
+===========
+
+There is no warranty for the Work. Except when otherwise stated in
+writing, the Copyright Holder provides the Work `as is', without
+warranty of any kind, either expressed or implied, including, but not
+limited to, the implied warranties of merchantability and fitness for a
+particular purpose. The entire risk as to the quality and performance
+of the Work is with you. Should the Work prove defective, you assume
+the cost of all necessary servicing, repair, or correction.
+
+In no event unless required by applicable law or agreed to in writing
+will The Copyright Holder, or any author named in the components of the
+Work, or any other party who may distribute and/or modify the Work as
+permitted above, be liable to you for damages, including any general,
+special, incidental or consequential damages arising out of any use of
+the Work or out of inability to use the Work (including, but not limited
+to, loss of data, data being rendered inaccurate, or losses sustained by
+anyone as a result of any failure of the Work to operate with any other
+programs), even if the Copyright Holder or said author or said other
+party has been advised of the possibility of such damages.
+
+
+MAINTENANCE OF THE WORK
+=======================
+
+The Work has the status `author-maintained' if the Copyright Holder
+explicitly and prominently states near the primary copyright notice in
+the Work that the Work can only be maintained by the Copyright Holder
+or simply that it is `author-maintained'.
+
+The Work has the status `maintained' if there is a Current Maintainer
+who has indicated in the Work that they are willing to receive error
+reports for the Work (for example, by supplying a valid e-mail
+address). It is not required for the Current Maintainer to acknowledge
+or act upon these error reports.
+
+The Work changes from status `maintained' to `unmaintained' if there
+is no Current Maintainer, or the person stated to be Current
+Maintainer of the work cannot be reached through the indicated means
+of communication for a period of six months, and there are no other
+significant signs of active maintenance.
+
+You can become the Current Maintainer of the Work by agreement with
+any existing Current Maintainer to take over this role.
+
+If the Work is unmaintained, you can become the Current Maintainer of
+the Work through the following steps:
+
+ 1. Make a reasonable attempt to trace the Current Maintainer (and
+ the Copyright Holder, if the two differ) through the means of
+ an Internet or similar search.
+
+ 2. If this search is successful, then enquire whether the Work
+ is still maintained.
+
+ a. If it is being maintained, then ask the Current Maintainer
+ to update their communication data within one month.
+
+ b. If the search is unsuccessful or no action to resume active
+ maintenance is taken by the Current Maintainer, then announce
+ within the pertinent community your intention to take over
+ maintenance. (If the Work is a LaTeX work, this could be
+ done, for example, by posting to comp.text.tex.)
+
+ 3a. If the Current Maintainer is reachable and agrees to pass
+ maintenance of the Work to you, then this takes effect
+ immediately upon announcement.
+
+ b. If the Current Maintainer is not reachable and the Copyright
+ Holder agrees that maintenance of the Work be passed to you,
+ then this takes effect immediately upon announcement.
+
+ 4. If you make an `intention announcement' as described in 2b. above
+ and after three months your intention is challenged neither by
+ the Current Maintainer nor by the Copyright Holder nor by other
+ people, then you may arrange for the Work to be changed so as
+ to name you as the (new) Current Maintainer.
+
+ 5. If the previously unreachable Current Maintainer becomes
+ reachable once more within three months of a change completed
+ under the terms of 3b) or 4), then that Current Maintainer must
+ become or remain the Current Maintainer upon request provided
+ they then update their communication data within one month.
+
+A change in the Current Maintainer does not, of itself, alter the fact
+that the Work is distributed under the LPPL license.
+
+If you become the Current Maintainer of the Work, you should
+immediately provide, within the Work, a prominent and unambiguous
+statement of your status as Current Maintainer. You should also
+announce your new status to the same pertinent community as
+in 2b) above.
+
+
+WHETHER AND HOW TO DISTRIBUTE WORKS UNDER THIS LICENSE
+======================================================
+
+This section contains important instructions, examples, and
+recommendations for authors who are considering distributing their
+works under this license. These authors are addressed as `you' in
+this section.
+
+Choosing This License or Another License
+----------------------------------------
+
+If for any part of your work you want or need to use *distribution*
+conditions that differ significantly from those in this license, then
+do not refer to this license anywhere in your work but, instead,
+distribute your work under a different license. You may use the text
+of this license as a model for your own license, but your license
+should not refer to the LPPL or otherwise give the impression that
+your work is distributed under the LPPL.
+
+The document `modguide.tex' in the base LaTeX distribution explains
+the motivation behind the conditions of this license. It explains,
+for example, why distributing LaTeX under the GNU General Public
+License (GPL) was considered inappropriate. Even if your work is
+unrelated to LaTeX, the discussion in `modguide.tex' may still be
+relevant, and authors intending to distribute their works under any
+license are encouraged to read it.
+
+A Recommendation on Modification Without Distribution
+-----------------------------------------------------
+
+It is wise never to modify a component of the Work, even for your own
+personal use, without also meeting the above conditions for
+distributing the modified component. While you might intend that such
+modifications will never be distributed, often this will happen by
+accident -- you may forget that you have modified that component; or
+it may not occur to you when allowing others to access the modified
+version that you are thus distributing it and violating the conditions
+of this license in ways that could have legal implications and, worse,
+cause problems for the community. It is therefore usually in your
+best interest to keep your copy of the Work identical with the public
+one. Many works provide ways to control the behavior of that work
+without altering any of its licensed components.
+
+How to Use This License
+-----------------------
+
+To use this license, place in each of the components of your work both
+an explicit copyright notice including your name and the year the work
+was authored and/or last substantially modified. Include also a
+statement that the distribution and/or modification of that
+component is constrained by the conditions in this license.
+
+Here is an example of such a notice and statement:
+
+ %% pig.dtx
+ %% Copyright 2005 M. Y. Name
+ %
+ % This work may be distributed and/or modified under the
+ % conditions of the LaTeX Project Public License, either version 1.3
+ % 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.3 or later is part of all distributions of LaTeX
+ % version 2005/12/01 or later.
+ %
+ % This work has the LPPL maintenance status `maintained'.
+ %
+ % The Current Maintainer of this work is M. Y. Name.
+ %
+ % This work consists of the files pig.dtx and pig.ins
+ % and the derived file pig.sty.
+
+Given such a notice and statement in a file, the conditions
+given in this license document would apply, with the `Work' referring
+to the three files `pig.dtx', `pig.ins', and `pig.sty' (the last being
+generated from `pig.dtx' using `pig.ins'), the `Base Interpreter'
+referring to any `LaTeX-Format', and both `Copyright Holder' and
+`Current Maintainer' referring to the person `M. Y. Name'.
+
+If you do not want the Maintenance section of LPPL to apply to your
+Work, change `maintained' above into `author-maintained'.
+However, we recommend that you use `maintained', as the Maintenance
+section was added in order to ensure that your Work remains useful to
+the community even when you can no longer maintain and support it
+yourself.
+
+Derived Works That Are Not Replacements
+---------------------------------------
+
+Several clauses of the LPPL specify means to provide reliability and
+stability for the user community. They therefore concern themselves
+with the case that a Derived Work is intended to be used as a
+(compatible or incompatible) replacement of the original Work. If
+this is not the case (e.g., if a few lines of code are reused for a
+completely different task), then clauses 6b and 6d shall not apply.
+
+
+Important Recommendations
+-------------------------
+
+ Defining What Constitutes the Work
+
+ The LPPL requires that distributions of the Work contain all the
+ files of the Work. It is therefore important that you provide a
+ way for the licensee to determine which files constitute the Work.
+ This could, for example, be achieved by explicitly listing all the
+ files of the Work near the copyright notice of each file or by
+ using a line such as:
+
+ % This work consists of all files listed in manifest.txt.
+
+ in that place. In the absence of an unequivocal list it might be
+ impossible for the licensee to determine what is considered by you
+ to comprise the Work and, in such a case, the licensee would be
+ entitled to make reasonable conjectures as to which files comprise
+ the Work.
+