From 81f24542c377c836618974cee06163a6ad28da67 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Sat, 29 Oct 2022 03:01:16 +0000 Subject: CTAN sync 202210290301 --- macros/latex/contrib/hep-reference/README.md | 24 + .../latex/contrib/hep-reference/bibliography.bib | 1214 ++++++++++++++++++++ .../hep-reference/hep-reference-documentation.pdf | Bin 0 -> 254739 bytes .../hep-reference/hep-reference-implementation.dtx | 402 +++++++ .../hep-reference/hep-reference-implementation.pdf | Bin 0 -> 338175 bytes .../latex/contrib/hep-reference/hep-reference.ins | 49 + macros/latex/contrib/hep-reference/license.md | 416 +++++++ 7 files changed, 2105 insertions(+) create mode 100644 macros/latex/contrib/hep-reference/README.md create mode 100644 macros/latex/contrib/hep-reference/bibliography.bib create mode 100644 macros/latex/contrib/hep-reference/hep-reference-documentation.pdf create mode 100644 macros/latex/contrib/hep-reference/hep-reference-implementation.dtx create mode 100644 macros/latex/contrib/hep-reference/hep-reference-implementation.pdf create mode 100644 macros/latex/contrib/hep-reference/hep-reference.ins create mode 100644 macros/latex/contrib/hep-reference/license.md (limited to 'macros/latex') diff --git a/macros/latex/contrib/hep-reference/README.md b/macros/latex/contrib/hep-reference/README.md new file mode 100644 index 0000000000..c25d4dc002 --- /dev/null +++ b/macros/latex/contrib/hep-reference/README.md @@ -0,0 +1,24 @@ + +# The `hep-reference` package + +A `LaTeX` package for publications in High Energy Physics. + +## Introduction + +The `hep-reference` package aims to provide a single style file containing most configurations and macros necessary to write appealing publications in High Energy Physics. +Instead of reinventing the wheel by introducing newly created macros `hep-reference` preferably loads third party packages as long as they are lightweight enough. + +For usual publications it is enough to load additionally to the `article` class without optional arguments only the `hep-reference` package. + + \documentclass{article} + \usepackage{hep-reference} + +## 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-reference/bibliography.bib b/macros/latex/contrib/hep-reference/bibliography.bib new file mode 100644 index 0000000000..5b217a2aad --- /dev/null +++ b/macros/latex/contrib/hep-reference/bibliography.bib @@ -0,0 +1,1214 @@ +@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-acronym", +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{hep-reference, +title = "The |hep-reference| package", +subtitle = "Selection of reference improvements", +author = "Jan Hajer", +year = "2021", +eprinttype = "ctan", +eprint = "hep-reference", +related = "hep-paper-1", +} + +@article{hep-cv, +title = "The |hep-cv| package", +subtitle = "Appealing curricula vitarum", +author = "Jan Hajer", +year = "2020", +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", +} + +@article{moderncv, +title = "The |moderncv| package", +subtitle = "A modern curriculum vitae class", +author = "Xavier Danaux", +year = "2006", +eprinttype = "ctan", +eprint = "moderncv", +related = "moderncv-1", +} + +@article{anyfontsize, +title = "The |anyfontsize| package", +subtitle = "Select any font size in \hologo{LaTeX}", +author = "Péter Szabó", +date = "2007", +eprinttype = "ctan", +eprint = "anyfontsize", +} + +@article{array, +title = "A new implementation of \hologo{LaTeX}’s |tabular| and |array| environment", +subtitle = "Extending the |array| and |tabular| environments", +author = "Frank Mittelbach, David Carlisle", +collaboration= "\hologo{LaTeX} Team", +year = "1993", +eprinttype = "ctan", +eprint = "array", +} + +@article{dashrule, +title = "The |dashrule| package", +subtitle = "Draw dashed rules", +author = "Scott Pakin", +date = "2008", +eprinttype = "ctan", +eprint = "dashrule", +} + +@article{fancyhdr, +title = "The |fancyhdr| and |extramarks| packages", +subtitle = "Extensive control of page headers and footers in \hologo{LaTeX2e}", +author = "Piet van Oostrum", +date = "1994", +eprinttype = "ctan", +eprint = "fancyhdr", +} + +@article{lastpage, +title = "The |lastpage| package", +subtitle = "Reference last page for Page $N$ of $M$ type footers", +author = "Hans-Martin Münch and Jeffrey Goldberg", +date = "1994", +eprinttype = "ctan", +eprint = "lastpage", +} + +@article{textpos, +title = "|Textpos|: absolute positioning of text on the page", +subtitle = "Place boxes at arbitrary positions on the \hologo{LaTeX} page", +author = "Norman Gray", +date = "1999", +eprinttype = "ctan", +eprint = "textpos", +related = "textpos-1", +} + +@manual{textpos-1, +eprinttype = "bitbucket", +eprintclass = "nxg", +eprint = "textpos", +} + +@article{subfiles, +title = "The |subfiles| package: A Document Class and a Package for Handling Multi-File Projects", +subtitle = "Individual typesetting of subfiles of a \enquote{main} document", +author = "Federico Garcia and Gernot Salzer", +date = "2002", +eprinttype = "ctan", +eprint = "subfiles", +related = "subfiles-1", +} + +@manual{subfiles-1, +eprinttype = "github", +eprintclass = "gsalzer", +eprint = "subfiles", +} + +@article{titlesec, +title = "The |titlesec|, |titleps| and |titletoc| packages", +subtitle = "Select alternative section titles", +author = "Javier Bezos", +year = "1998", +eprinttype = "ctan", +eprint = "titlesec", +related = "titlesec-1", +} + +@manual{titlesec-1, +eprinttype = "github", +eprintclass = "jbezos", +eprint = "titlesec", +} + +@article{calc, +title = "The |calc| package", +subtitle = "Simple arithmetic in \hologo{LaTeX} commands", +author = "Kresten Krab Thorup and Frank Jensen", +collaboration = "\hologo{LaTeX3} Project", +year = "1992", +eprinttype = "ctan", +eprint = "calc", +} + +@article{tabulary, +title = "The |tabulary| package", +subtitle = "Tabular with variable width columns balanced", +author = "David Carlisle", +year = "1995", +eprinttype = "ctan", +eprint = "tabulary", +} + +@article{xcolor, +title = "The |xcolor| package", +subtitle = "Driver-independent color extensions for \hologo{LaTeX} and \hologo{pdfLaTeX}", +author = "Uwe Kern", +collaboration = "\hologo{LaTeX} Project", +year = "2003", +eprinttype = "ctan", +eprint = "xcolor", +} + +@article{overlays, +title = "The |overlays| package", +subtitle = "Incremental slides", +author = "Andreas Nolda", +year = "2016", +eprinttype = "ctan", +eprint = "overlays", +} diff --git a/macros/latex/contrib/hep-reference/hep-reference-documentation.pdf b/macros/latex/contrib/hep-reference/hep-reference-documentation.pdf new file mode 100644 index 0000000000..bacea46800 Binary files /dev/null and b/macros/latex/contrib/hep-reference/hep-reference-documentation.pdf differ diff --git a/macros/latex/contrib/hep-reference/hep-reference-implementation.dtx b/macros/latex/contrib/hep-reference/hep-reference-implementation.dtx new file mode 100644 index 0000000000..03722624cb --- /dev/null +++ b/macros/latex/contrib/hep-reference/hep-reference-implementation.dtx @@ -0,0 +1,402 @@ +% \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 +% +%\NeedsTeXFormat{LaTeX2e}[2005/12/01] +%\ProvidesPackage{hep-reference}[2022/11/01 v1.1 Publications in High Energy Physics] +%\ProvidesFile{hep-reference-documentation.tex}[2022/11/01 v1.1 HEP-Paper documentation] +% +%<*documentation> +% +\RequirePackage[l2tabu, orthodox]{nag} +\documentclass{ltxdoc} +\AtBeginDocument{\DeleteShortVerb{\|}} +\AtBeginDocument{\MakeShortVerb{\"}} + +\EnableCrossrefs +\CodelineIndex +\RecordChanges + +\usepackage[parskip]{hep-paper} + +\bibliography{bibliography} + +\shortacronym{PDF}{portable document format} + +\usepackage{hologo} + +\MacroIndent=1.5em +\AtBeginEnvironment{macrocode}{\renewcommand{\ttdefault}{clmt}} +% + +%<*driver> +\expandafter\newif\csname ifshort\endcsname +\shortfalse +\begin{document} +\DocInput{hep-reference-implementation.dtx} +\end{document} +% +% +% \fi +% +% \CheckSum{179} +% +% \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}{2011/08/01}{Initial version of the style file.} +% \changes{v1.1}{2022/11/01}{Bug fixes.} +% +% \ifshort +%<*documentation> +% \fi +% +\GetFileInfo{hep-reference.sty} + +\title{The \software{hep-reference} package\thanks{This document corresponds to \software{hep-reference}~\fileversion.}} +\subtitle{Adjustments of standard references, footnote, and citations} +\author{Jan Hajer \email{jan.hajer@tecnico.ulisboa.pt}} +\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-reference} package applies some light convenience modifications to the reference, citation and footnote macros after loading standard classes improving on the default \hologo{LaTeX} behaviour. +\end{abstract} + +\section{Introduction} + +The \software{hyperref} package is loaded and the links are hidden. + +\DescribeMacro{\cref} +References are extended with the \software{cleveref} package \cite{cleveref}, which allows to \eg just type "\cref"\marg{key} in order to write \enquote{figure 1}. +Furthermore, the \software{cleveref} package allows to reference multiple objects within one "\cref"\marg{key1,key2}. + +\DescribeMacro{\cite} +Citations are adjusted to not start on a new line in order to avoid the repeated use of "~\cite"\marg{key}. + +\DescribeMacro{\ref} +\DescribeMacro{\eqref} +\DescribeMacro{\subref} +References are also adjusted to not start on a new line. + +\DescribeMacro{\footnote} +Footnotes are adjusted to swallow white space before the footnote mark and at the beginning of the footnote text. +Additionally the reference back to the text where they are called from. + +% \ifshort +\printbibliography + +\end{document} +% +% +% \fi +% +% \StopEventually{ +% \printbibliography +% \PrintChanges +% } +% +% \appendix +% +%<*package> +% +% \section{Implementation} +% +% Load the \software{hyperref} package \cite{hyperref} enable Unicode encoding and hide links. +% \begin{macrocode} +\RequirePackage{hyperref} +\hypersetup{ + pdfencoding=auto, psdextra, + linktoc=all, hidelinks, breaklinks=true, + pdfcreator={}, pdfproducer={} +} +\AtBeginDocument{\@ifpackageloaded{doc}{\hypersetup{hidelinks}}{}} +% \end{macrocode} +% Set the \PDF meta data according to the paper information and ensure that unnecessary information is suppressed. +% +% \begin{macrocode} +\pdfstringdefDisableCommands{\def\varepsilon{\textepsilon}} +\pdfstringdefDisableCommands{\def\to{\textrightarrow}} +\AtBeginDocument{ + \pdfstringdefDisableCommands{\let\ensuremath\@gobble} + \pdfstringdefDisableCommands{\let\mathsurround\@gobble} + \pdfstringdefDisableCommands{\let\unskip\@gobble} + \pdfstringdefDisableCommands{\let\thanks\@gobble} + \pdfstringdefDisableCommands{\let\footnote\@gobble} + \pdfstringdefDisableCommands{\let\\\@gobble} +} +\AtBeginDocument{\hypersetup{pdftitle={\@title}}} +\AtBeginDocument{\hypersetup{pdfauthor={\@author}}} +\AtBeginDocument{\@ifundefined{hep@key@words}{}{% + \hypersetup{pdfkeywords={\hep@key@words}}% +}} +% \end{macrocode} + +% \subsection{Footnotes} +% +% Place a hyperlink from the footnote back to its referencing label using the \software{footnotebackref} package \cite{footnotebackref}. +% \begin{macrocode} +\def\BackrefFootnoteTag{} +\RequirePackage{footnotebackref} +% \end{macrocode} +% +% \begin{macro}{\footnote} +% Ensure that no spaces appear before the footmark or at the beginning of the footnote. +% \begin{macrocode} +\let\@foot@note\footnote +\renewcommand{\footnote}[1]{\unskip\@foot@note{\ignorespaces#1}} +% \end{macrocode} +% \end{macro} + +% \subsection{References} +% +% \begin{macro}{\ref} +% Adjust "\ref"\marg{key} in order to prevent preceding line breaks. +% \begin{macrocode} +\AtBeginDocument{ + \let\hep@ref\ref + \renewcommand\ref{\no@break@before\hep@ref} +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\eqref} +% Adjust "\eqref"\marg{key} from the \software{amsmath} package in order to prevent preceding line breaks. +% \begin{macrocode} +\AtBeginDocument{\@ifpackageloaded{amsmath}{% + \renewcommand\eqref{\no@break@before\labelcref}% +}{}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\usecommand} +% Define the "\usecommand" macro providing an anonymous function. +% \begin{macrocode} +\providecommand\use@command{} +\newcommand\usecommand[2][1]{% + \renewcommand\use@command[#1]{#2}\use@command% +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\textlabel} +% Define the "\textlabel" macro allowing to link to a piece of text. +% \begin{macrocode} +\NewDocumentCommand\textlabel{O{}mO{}m}{% + \protected@write\@auxout{}{% + \string\newlabel{#2}{% + {\hspace{-4pt}\protecting{#1{#4}}}{\thepage}{#4}{#2}{}% + }% + }% + \hypertarget{#2}{}% + {#3{#4}}% +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\cref} +% Improve reference using the \software{cleveref} package \cite{cleveref}. +% \begin{macrocode} +\PassOptionsToPackage{noabbrev, nameinlink}{cleveref} +\RequirePackage{cleveref} +\newcommand{\creflastconjunction}{, and\nobreakspace} +\crefname{enumi}{point}{points} +\crefname{inlinelisti}{point}{points} +% \end{macrocode} +% \end{macro} +% +%\begin{macro}{\no@break@before} +% Define a macro able to prevent line breaks. +% \begin{macrocode} +\newcommand\no@break@before{% + \relax\ifvmode\else% + \ifhmode% + \ifdim\lastskip > 0pt% + \relax\unskip\nobreakspace% + \fi% + \fi% + \fi% +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\subref} +% Adjust "\subref"\marg{key} from the \software{subcaption} package in order to prevent preceding line breaks. +% \begin{macrocode} +\AtBeginDocument{\@ifpackageloaded{subcaption}{% + \let\hep@subref\subref + \renewcommand\subref{\no@break@before\hep@subref} + \renewcommand*\subcaption@ref[2]{\begingroup% + \caption@setoptions{sub}% + \subcaption@reffmt\p@subref{\hep@ref#1{sub@#2}}% + \endgroup} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\subcref} +% Provide the "\subcref" macro. +% \begin{macrocode} + \newcommand{\subcref}[1]{\cref{sub@#1}} +}{}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\eqcrefname} +% Define the "\eqcrefname" macro for named equation types. +% \begin{macrocode} +\NewDocumentCommand{\eqcrefname}{mmo}{ + \crefname{#1}{#2}{\IfValueTF{#3}{#3}{#2s}} + \creflabelformat{#1}{(##2##1##3)} +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\labelcrefrange} +% Define the missing "\labelcrefrange"\marg{key1}\marg{key2} macro. +% \begin{macrocode} +\DeclareRobustCommand{\labelcrefrange}[2]{% + \@crefrangenostar{labelcref}{#1}{#2}% +} +% \end{macrocode} +% \end{macro} +% +% Adjust the title page +% \begin{macrocode} +\AtBeginDocument{\@ifpackageloaded{hep-title}{% + \labelcrefmultiformat{affiliation}{#2#1#3}{% + \textsuperscript,#2#1#3}{\textsuperscript,#2#1#3% + }{% + \textsuperscript,#2#1#3% + } + \labelcrefrangeformat{affiliation}{#3#1#4\textsuperscript{--}#5#2#6} +}{}} +% \end{macrocode} + +% \subsection{Citations} +% +% \begin{macro}{\cite} +% Adjust "\cite"\marg{key} in order to prevent preceding line breaks. +% \begin{macrocode} +\let\hep@cite\cite +\renewcommand\cite{\no@break@before\hep@cite} +% \end{macrocode} +% \end{macro} +% +% +% +% \section{Tests} +% +%<*test> +% +% \begin{macrocode} +\documentclass{article} + +\usepackage{amsmath} +\usepackage{hep-reference} +\usepackage{parskip} +\providecommand{\cref}{section \ref} + +\begin{document} + +\section{Section} \label{sec:Section} + +Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Etiam lobortis section \ref{sec:Section} + +Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Etiam lobortis \cref{sec:Section} + +Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Etiam loborti equation \eqref{eq:Equation} + +Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Etiam loborti reference \cite{cite} + +Lorem ipsum dolor sit amet, consectetuer adipiscing elit. +\footnote{ + Lorem ipsum dolor sit amet, consectetuer adipiscing elit. +} + +\begin{equation} \label{eq:Equation} +E=mc^2 +\end{equation} + + +\begin{thebibliography}{1} +\bibitem{cite} reference +\end{thebibliography} + +\end{document} +% \end{macrocode} +% +% +% +% \section{Readme} +% +%<*readme> +% +% \begin{macrocode} +# The `hep-reference` package + +A `LaTeX` package for publications in High Energy Physics. + +## Introduction + +The `hep-reference` package aims to provide a single style file containing most configurations and macros necessary to write appealing publications in High Energy Physics. +Instead of reinventing the wheel by introducing newly created macros `hep-reference` preferably loads third party packages as long as they are lightweight enough. + +For usual publications it is enough to load additionally to the `article` class without optional arguments only the `hep-reference` package. + + \documentclass{article} + \usepackage{hep-reference} + +## 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} +% +% +% +% \Finale + +\endinput + +% \PrintIndex +% makeindex -s gglo.ist -o hep-reference-implementation.gls hep-reference-implementation.glo +% makeindex -s gglo.ist -o hep-reference-implementation.ind hep-reference-implementation.idx diff --git a/macros/latex/contrib/hep-reference/hep-reference-implementation.pdf b/macros/latex/contrib/hep-reference/hep-reference-implementation.pdf new file mode 100644 index 0000000000..b25dd57e2d Binary files /dev/null and b/macros/latex/contrib/hep-reference/hep-reference-implementation.pdf differ diff --git a/macros/latex/contrib/hep-reference/hep-reference.ins b/macros/latex/contrib/hep-reference/hep-reference.ins new file mode 100644 index 0000000000..c2ed685ccf --- /dev/null +++ b/macros/latex/contrib/hep-reference/hep-reference.ins @@ -0,0 +1,49 @@ +%% 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-reference} + +\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-reference-documentation.tex}{\from{hep-reference-implementation.dtx}{documentation}} + \file{hep-reference.sty}{\from{hep-reference-implementation.dtx}{package}} + \file{hep-reference-test.tex}{\from{hep-reference-implementation.dtx}{test}} + \nopreamble\nopostamble\file{README-hep-reference.md}{\from{hep-reference-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-reference.sty} +\Msg{*} +\Msg{* To produce the documentation run the file} +\Msg{* hep-reference-documentation.dtx through LaTeX.} +\Msg{*} +\Msg{* Happy TeXing!} +\Msg{*********************************************************} + +\endbatchfile diff --git a/macros/latex/contrib/hep-reference/license.md b/macros/latex/contrib/hep-reference/license.md new file mode 100644 index 0000000000..494f58131f --- /dev/null +++ b/macros/latex/contrib/hep-reference/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. + -- cgit v1.2.3