diff options
author | Norbert Preining <norbert@preining.info> | 2021-11-27 03:00:50 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2021-11-27 03:00:50 +0000 |
commit | 96c2fb76825a51e1a74de35b2af34d4027342780 (patch) | |
tree | 7c42c75da88a65f7dbb9b095e95c39ec5912a020 /macros/latex/contrib | |
parent | fcabaaa4d96d05af090f9a0eaa43bf5f0a8c1be2 (diff) |
CTAN sync 202111270300
Diffstat (limited to 'macros/latex/contrib')
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 Binary files differnew file mode 100644 index 0000000000..475d7a148b --- /dev/null +++ b/macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography-documentation.pdf 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 Binary files differnew file mode 100644 index 0000000000..50a4805ac1 --- /dev/null +++ b/macros/latex/contrib/biblatex-contrib/hep-bibliography/hep-bibliography-implementation.pdf 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 Binary files differnew file mode 100644 index 0000000000..51d02bb90a --- /dev/null +++ b/macros/latex/contrib/hep-acronym/hep-acronym-documentation.pdf 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 Binary files differnew file mode 100644 index 0000000000..47eb0547f8 --- /dev/null +++ b/macros/latex/contrib/hep-acronym/hep-acronym-implementation.pdf 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 Binary files differnew file mode 100644 index 0000000000..4c8f7922d4 --- /dev/null +++ b/macros/latex/contrib/hep-title/hep-title-documentation.pdf 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 Binary files differnew file mode 100644 index 0000000000..7dafac24a9 --- /dev/null +++ b/macros/latex/contrib/hep-title/hep-title-implementation.pdf 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. + |