Debian Codegraph @

texmf-dist/source/latex/hep-bibliography/hep-bibliography-implementation.dtx

raw
1 % \iffalse meta-comment
2 %
3 % Copyright (C) 2019-2025 by Jan Hajer
4 % -----------------------------------
5 %
6 % This file may be distributed and/or modified under the
7 % conditions of the LaTeX Project Public License, either version 1.3c
8 % of this license or (at your option) any later version.
9 % The latest version of this license is in:
10 %
11 % http://www.latex-project.org/lppl.txt
12 %
13 % and version 1.3c or later is part of all distributions of LaTeX
14 % version 2005/12/01 or later.
15 %
16 % \fi
17 %
18 % \iffalse
19
20 %<package>\NeedsTeXFormat{LaTeX2e}[2005/12/01]
21 %<package>\ProvidesPackage{hep-bibliography}[2025/09/01 v1.4 HEP-Bibliography]
22 %<datamodel>\ProvidesFile{hep-bibliography.dbx}[2025/09/01 v1.4 HEP-Bibliography biblatex data model]
23 %<documentation>\ProvidesFile{hep-bibliography-documentation.tex}[2025/09/01 v1.4 HEP-Bibliography documentation]
24 %
25 %<*documentation>
26 \RequirePackage[l2tabu, orthodox]{nag}
27 \documentclass{ltxdoc}
28
29 \renewcommand*\theCodelineNo{\rmfamily\tstyle\footnotesize\arabic{CodelineNo}}
30 \AtBeginEnvironment{macrocode}{\renewcommand*{\ttdefault}{clmt}}
31 \renewcommand*{\MacroFont}{\codestyle}
32 \AtBeginDocument{\DeleteShortVerb{\|}}
33 \AtBeginDocument{\MakeShortVerb{\"}}
34 \EnableCrossrefs
35 \CodelineIndex
36 \RecordChanges
37
38 \usepackage{hologo}
39
40 \usepackage[parskip,oldstyle,font=10pt]{hep-paper}
41 \bibliography{bibliography}
42 \acronym{URL}{uniform resource locator}
43 %</documentation>
44
45 %<*driver>
46 \expandafter\newif\csname ifshort\endcsname
47 \shortfalse
48 \begin{document}
49 \DocInput{hep-bibliography-implementation.dtx}
50 \end{document}
51 %</driver>
52 %
53 % \fi
54 %
55 % \CheckSum{354}
56 %
57 % \CharacterTable
58 % {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
59 % 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
60 % Digits \0\1\2\3\4\5\6\7\8\9
61 % Exclamation \! Double quote \" Hash (number) \#
62 % Dollar \$ Percent \% Ampersand \&
63 % Acute accent \' Left paren \( Right paren \)
64 % Asterisk \* Plus \+ Comma \,
65 % Minus \- Point \. Solidus \/
66 % Colon \: Semicolon \; Less than \<
67 % Equals \= Greater than \> Question mark \?
68 % Commercial at \@ Left bracket \[ Backslash \\
69 % Right bracket \] Circumflex \^ Underscore \_
70 % Grave accent \` Left brace \{ Vertical bar \|
71 % Right brace \} Tilde \~}
72 %
73 % \changes{v1.0}{2021/09/01}{Initial version of the style file.}
74 % \changes{v1.1}{2022/11/01}{Bug fixes.}
75 % \changes{v1.2}{2023/07/01}{Bug fixes.}
76 % \changes{v1.3}{2024/11/01}{Bug fixes.}
77 % \changes{v1.4}{2025/09/01}{Bug fixes.}
78 %
79 % \ifshort
80 %<*documentation>
81 % \fi
82 %
83 \GetFileInfo{hep-bibliography.sty}
84
85 \title{The \software{hep-bibliography} package\thanks{This document corresponds to \software{hep-bibliography}~\fileversion.}}
86 \subtitle{Bibliographies for high energy physics}
87 \author{Jan Hajer \email{[email protected]}}
88 \date{\filedate}
89
90 % \ifshort
91 \begin{document}
92 % \fi
93
94 \newgeometry{vscale=.8, vmarginratio=3:4, includeheadfoot, left=11em, marginparwidth=4.6cm, marginparsep=3mm, right=7em}
95
96 \maketitle
97
98 \begin{abstract}
99 The \software{hep-bibliography} package extends the \software{biblatex} package with some functionality mostly useful for high energy physics.
100 In particular it makes full use of all "bibtex" fields provided by "inspirehep.net".
101 \end{abstract}
102
103 The package can be loaded via "\usepackage{hep-bibliography}".
104
105 \DescribeMacro{\bibliography}
106 \DescribeMacro{\printbibliography}
107 The \software{biblatex} package \cite{biblatex} is loaded for bibliography management.
108 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.
109 The bibliography is generated by \software{Biber} \cite{biber}.
110 "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.
111 Additionally, \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.
112 \DescribeMacro{erratum}
113 Errata can be included using the "related" feature.
114 \begin{verbatim}
115 \article{key1,
116 ...,
117 relatedtype="erratum",
118 related="key2",
119 }
120 \article{key2,
121 ...,
122 }
123 \end{verbatim}
124
125 % \ifshort
126 \printbibliography
127
128 \end{document}
129 %
130 %</documentation>
131 % \fi
132 %
133 % \StopEventually{
134 % \printbibliography
135 % \PrintChanges
136 % }
137 %
138 % \appendix
139 %
140 % \section{Implementation}
141 %
142 %<*package>
143
144 % Load the \software{kvoptions} package \cite{kvoptions} and define a "hepbib" namespace.
145 % \begin{macrocode}
146 \RequirePackage{kvoptions}
147 \SetupKeyvalOptions{
148 family=hepbib,
149 prefix=hepbib@
150 }
151 % \end{macrocode}
152 %
153 % \begin{macro}{bibliography}
154 % Provide the "style" option for passing a "style" string to the \software{biblatex} package \cite{biblatex} or disabling the automatic loading of "biblatex".
155 % \begin{macrocode}
156 \DeclareStringOption[numeric-comp]{style}
157 % \end{macrocode}
158 % \end{macro}
159 %
160 % \begin{macrocode}
161 \ProcessKeyvalOptions*
162 % \end{macrocode}
163 %
164 % \begin{macro}{\online}
165 % \begin{macro}{\email}
166 % Define the "\online"\marg{text}\marg{url} macro combining the features of the "\href" and the "\url" macros.
167 % Define a macro for typesetting emails.
168 % \begin{macrocode}
169 \providecommand*{\online}[2]{\texttt{#2}}%
170 \providecommand*{\hep@email}[1]{\online{mailto:#1}{#1}}
171 \providecommand*\email{\hep@email}
172 \AtBeginDocument{\@ifpackageloaded{hyperref}{%
173 \renewcommand*{\online}[2]{\href{#1}{\nolinkurl{#2}}}%
174 }{}
175 }
176 % \end{macrocode}
177 % \end{macro}
178 % \end{macro}
179 %
180 % \begin{environment}{commalist}
181 % Define a commalist environment using the "xparse" package \cite{xparse}.
182 % \begin{macrocode}
183 \RequirePackage{xparse}
184 \ExplSyntaxOn
185 \NewDocumentEnvironment{commalist}{O{\space}+b}{
186 \hep@comma@list:n{#2}
187 }{#1}
188 \seq_new:N \hep@items@sequence
189 \cs_new_protected:Npn \hep@comma@list:n #1{
190 \seq_set_split:Nnn \hep@items@sequence{\item}{#1}
191 \seq_pop_left:NN \hep@items@sequence \l_tmpa_tl
192 \seq_use:Nnnn \hep@items@sequence{~and~}{,~}{,~and~}
193 }
194 \ExplSyntaxOff
195 % \end{macrocode}
196 % \end{environment}
197 %
198 %
199 % \begin{macro}{\bibliography}
200 % Load the \software{biblatex} package \cite{biblatex} with the datamodel defined in \cref{sec:data model}.
201 % \begin{macrocode}
202 \PassOptionsToPackage{
203 style=\hepbib@style,
204 datamodel=hep-bibliography
205 }{biblatex}
206 \RequirePackage{biblatex}
207 % \end{macrocode}
208 % \end{macro}
209 %
210 % \begin{macro}{hep-bibliography}
211 % Provide the "\DeclareSortingTemplate" macro for older "biblatex" installations.
212 % 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.
213 % \begin{macrocode}
214 \providecommand*{\DeclareSortingTemplate}{\DeclareSortingScheme}
215 \DeclareSortingTemplate{hep-bibliography}{
216 \sort{\citeorder}
217 \sort[final]{\field{sortkey}}
218 \sort{\field{sortyear} \field{year} \literal{9999}}
219 \sort{\field{month}}
220 \sort{\field{eprint} \field{doi}}
221 \sort{\field{sorttitle} \field{title}}
222 \sort{\field{subtitle} \field{volume}}
223 }
224 % \end{macrocode}
225 % \end{macro}
226 %
227 % Use the new sorting scheme and abbreviat all first names.
228 % \begin{macrocode}
229 \ExecuteBibliographyOptions{
230 sorting=hep-bibliography,
231 safeinputenc,
232 giveninits=true,
233 maxbibnames=7,
234 }
235 % \end{macrocode}
236 %
237 %
238 % Redefine the "pages" filed such that leading zeros are stripped from the page numbers.
239 % \begin{macrocode}
240 \newcommand*\hep@strip@zero[1]{\expandafter\hep@strip@zero@helper#1}
241 \newcommand*\hep@strip@zero@helper[1]{%
242 \ifx0#1\expandafter\hep@strip@zero@helper\else#1\fi%
243 }
244 \DeclareFieldFormat{pages}{%
245 \mkpageprefix[bookpagination][{\mknormrange[][\hep@strip@zero]}]{#1}%
246 }
247 % \end{macrocode}
248 %
249 % Define an internal bibhypertarget.
250 % \begin{macrocode}
251 \DeclareFieldFormat{bibhypertarget}{%
252 \bibhypertarget{\thefield{entrykey}:\the\value{instcount}}{#1}%
253 }
254 % \end{macrocode}
255 % Redefine the citation command to set the bibhypertarget and call the cite:save macro.
256 % \begin{macrocode}
257 \renewbibmacro*{cite:comp}{%
258 \printtext[bibhypertarget]{%
259 \stepcounter{cbx@tempcntb}%
260 \iffieldundef{shorthand}{%
261 \ifbool{bbx:subentry}{%
262 \iffieldundef{entrysetcount}{%
263 \usebibmacro{cite:comp:comp}}{\usebibmacro{cite:comp:inset}%
264 }%
265 }{\usebibmacro{cite:comp:comp}}%
266 }{\usebibmacro{cite:comp:shand}}%
267 }%
268 \usebibmacro{cite:save}%
269 }
270 % \end{macrocode}
271 % Define the cite:safe macro
272 % \begin{macrocode}
273 \newbibmacro*{cite:save}{%
274 \ifcsundef{cbx@\thefield{entrykey}}{%
275 \csxdef{cbx@\thefield{entrykey}}{\the\value{instcount}}%
276 }{}%
277 }
278 % \end{macrocode}
279 % Link from the bibliography to the first cite.
280 % \begin{macrocode}
281 \newbibmacro{cbx:linktofirstcite}[1]{%
282 \ifcsdef{cbx@\thefield{entrykey}}{%
283 \bibhyperlink{%
284 \thefield{entrykey}:\csuse{cbx@\thefield{entrykey}}%
285 }{#1}%
286 }{#1}%
287 }
288 % \end{macrocode}
289 % Ensure table style numbers in the bibliography labels.
290 % \begin{macrocode}
291 \providecommand*{\tstyle}{}
292 \DeclareFieldFormat{labelnumberwidth}{%
293 \usebibmacro{cbx:linktofirstcite}{\mkbibbrackets{\tstyle#1}}%
294 }
295 % \end{macrocode}
296 % Deactivate counting during caption measurement.
297 % \begin{macrocode}
298 \AtBeginDocument{\@ifpackageloaded{caption}{%
299 \g@addto@macro\caption@prepareslc{\let\blx@citeprint\relax}}{}%
300 }
301 % \end{macrocode}
302 %
303 % Shrink the biblography in two column mode.
304 % \begin{macrocode}
305 \if@twocolumn
306 \AtBeginBibliography{\small}
307 \setlength\biblabelsep{\labelsep}
308 \fi
309 % \end{macrocode}
310 %
311 % \begin{macro}{translationof}
312 % Redefine the "translationof" string to fit better to documents without a original title.
313 % \begin{macrocode}
314 \DefineBibliographyStrings{english}{translationof={Original}}
315 % \end{macrocode}
316 % \end{macro}
317 %
318 % \begin{macro}{erratum}
319 % Add new bibliography string \enquote{Erratum} for the use in the "relatedtype" field.
320 % \begin{macrocode}
321 \NewBibliographyString{erratum,erratums}
322 \DefineBibliographyStrings{english}{erratum={Erratum},erratums={Errata}}
323 \providecommand*{\relateddelimerratum}{\addsemicolon\space}
324 % \end{macrocode}
325 % \end{macro}
326 %
327 % Activate the Oxford comma when using "british" and separate title and subtitle with a colon.
328 % \begin{macrocode}
329 \DefineBibliographyExtras{british}{\def\finalandcomma{\addcomma}}
330 \renewcommand*{\subtitlepunct}{\addcolon\addspace}
331 % \end{macrocode}
332 %
333 % \begin{macro}{\printbibliography}
334 % Allow the bibliography to be printed sloppy
335 % \begin{macrocode}
336 % \let\hep@printbibliography\printbibliography
337 % \renewcommand*{\printbibliography}{{\sloppy\hep@printbibliography}}
338 % \end{macrocode}
339 % \end{macro}
340
341 % \subsection{Sourcemap}
342 %
343 % \begin{macro}{\hep@reg@exp@one}
344 % \begin{macro}{\hep@reg@exp@two}
345 % \begin{macro}{\hep@reg@exp@url}
346 % \begin{macro}{\hep@reg@exp@pmc}
347 % Define regular expressions in order to deal with inconsistent journal title and volume naming as well as \URL protocols and the PMCID.
348 % \begin{macrocode}
349 \newcommand*{\hep@reg@exp@one}{\regexp{\A(\p{L}+)?\d+(\p{L}+)?\Z}}
350 \newcommand*{\hep@reg@exp@two}{\regexp{\A(\p{L}+)?(\d+)(\p{L}+)?\Z}}
351 \newcommand*{\hep@reg@exp@url}{\regexp{\A(ht|f)tp(s)?:\/\/}}
352 \newcommand*{\hep@reg@exp@pmc}{\regexp{\A(PMC)?}}
353 % \end{macrocode}
354 % \end{macro}
355 % \end{macro}
356 % \end{macro}
357 % \end{macro}
358 %
359 % \begin{macro}{\DeclareSourcemap}
360 % Use the "\DeclareSourcemap" feature.
361 % \begin{macrocode}
362 \DeclareSourcemap{%
363 \maps[datatype=bibtex, overwrite=true]{%
364 % \end{macrocode}
365 % \begin{macro}{collaboration}
366 % Read the collaboration information if present.
367 % \begin{macrocode}
368 \map{%
369 \step[fieldsource=Collaboration, final=true]%
370 \step[fieldset=collaboration, origfieldval, final=true]
371 }%
372 % \end{macrocode}
373 % \end{macro}
374 % \begin{macro}{reportnumber}
375 % Read the pre-print information if present.
376 % \begin{macrocode}
377 \map{%
378 \step[fieldsource=reportNumber, final=true]%
379 \step[fieldset=reportnumber, origfieldval, final=true]
380 }%
381 % \end{macrocode}
382 % \end{macro}
383 % \begin{macro}{journal}
384 % Move letters from the volume field to the journal field.
385 % \begin{macrocode}
386 \map[overwrite]{
387 \pertype{article}
388 \step[fieldsource=volume, match=\hep@reg@exp@one, final]
389 \step[fieldsource=volume, match=\hep@reg@exp@two, replace={$2}]
390 \step[fieldsource=journal, fieldtarget=journaltitle]
391 \step[fieldset=journaltitle, fieldvalue={\space$1$2}, append=true]
392 }
393 % \end{macrocode}
394 % \end{macro}
395 % \begin{macro}{url}
396 % Remove the protocol from \URL.
397 % \begin{macrocode}
398 \map{
399 \step[fieldsource=url, final=true]
400 \step[fieldset=protocollessurl, origfieldval, final=true]
401 \step[fieldsource=protocollessurl,
402 match=\hep@reg@exp@url, replace={}]
403 }
404 % \end{macrocode}
405 % \end{macro}
406 % \begin{macro}{pmc}
407 % Remove the PMC from the PMCID.
408 % \begin{macrocode}
409 \map{
410 \step[fieldsource=pmcid, final=true]
411 \step[fieldset=pmc, origfieldval, final=true]
412 \step[fieldsource=pmc, match=\hep@reg@exp@pmc, replace={}]
413 }
414 }%
415 }
416 % \end{macrocode}
417 % \end{macro}
418 % \end{macro}
419 %
420 % \begin{macro}{\letbibmacro}
421 % Provide the "\letbibmacro" macro for old "biblatex" installations.
422 % \begin{macrocode}
423 \providecommand*{\letbibmacro}[2]{\csletcs{abx@macro@#1}{abx@macro@#2}}
424 % \end{macrocode}
425 % \end{macro}
426 %
427 % \begin{macro}{collaboration}
428 % Execute the author macro even if only the collaboration information if present and override the author information with collaboration information if present.
429 % \begin{macrocode}
430 \renewbibmacro*{author/translator+others}{%
431 \ifboolexpr{
432 test \ifuseauthor and (
433 not test {\ifnameundef{author}} or
434 not test {\iffieldundef{collaboration}}
435 )
436 }
437 {\usebibmacro{author}}
438 {\usebibmacro{translator+others}}
439 }
440 \letbibmacro{hep@bib@author}{author}
441 \renewbibmacro*{author}{%
442 \iffieldundef{collaboration}{%
443 \usebibmacro{hep@bib@author}}{\textit{\printfield{collaboration}}%
444 }%
445 }
446 % \end{macrocode}
447 % \end{macro}
448 %
449 % \begin{macro}{In:}
450 % Remove spurious \enquote{In:} if no journal is present.
451 % \begin{macrocode}
452 \renewbibmacro*{in:}{%
453 \iffieldundef{journaltitle}{}{\printtext{\bibstring{in}\intitlepunct}}%
454 }
455 % \end{macrocode}
456 % \end{macro}
457 %
458 % \begin{macro}{reportnumber}
459 % Print the "reportnumber" as commalist using the \software{relsize} package \cite{relsize}.
460 % \begin{macrocode}
461 \RequirePackage{relsize}
462 \DeclareFieldFormat{reportnumber}{%
463 \edef\commalistbody{\forcsvfield{%
464 \egroup\noexpand\item\unexpanded{\bgroup\smaller[.5]\textsc}
465 }{reportnumber}}%
466 \expandafter\commalist\commalistbody\egroup\endcommalist%
467 }
468 % \end{macrocode}
469 % \end{macro}
470 %
471 % \begin{macro}{url}
472 % Show \URLs without the protocol.
473 % \begin{macrocode}
474 \DeclareFieldFormat{url}{%
475 \mkbibacro{URL}\addcolon\space\online{#1}{\thefield{protocollessurl}}%
476 }
477 % \end{macrocode}
478 % \end{macro}
479 %
480 % \begin{macro}{\hep@bib@online}
481 % Private "\hep@bib@online" macro
482 % \begin{macrocode}
483 \newcommand*{\hep@bib@online}[2]{%
484 \ifhyperref{\online{#1}{#2}}{\nolinkurl{#2}}%
485 }
486 % \end{macrocode}
487 % \end{macro}
488 %
489 % \begin{macro}{pmid}
490 % \begin{macro}{pmcid}
491 % Present PubMed IDs.
492 % \begin{macrocode}
493 \DeclareFieldFormat{pmid}{%
494 \mkbibacro{PM}\addcolon\space%
495 \hep@bib@online{https://www.ncbi.nlm.nih.gov/pubmed/#1}{#1}%
496 }
497 \DeclareFieldFormat{pmc}{%
498 \mkbibacro{PMC}\addcolon\space%
499 \hep@bib@online{https://www.ncbi.nlm.nih.gov/pmc/articles/PMC#1}{#1}%
500 }
501 % \end{macrocode}
502 % \end{macro}
503 % \end{macro}
504 %
505 % \begin{macro}{pmcid}
506 % \begin{macro}{pmid}
507 % \begin{macro}{reportnumber}
508 % Add the pre-print and PubMed information if present.
509 % \begin{macrocode}
510 \letbibmacro{hep-doi+eprint+url}{doi+eprint+url}
511 \renewbibmacro*{doi+eprint+url}{%
512 \usebibmacro{hep-doi+eprint+url}
513 \iffieldundef{pmc}{%
514 \iffieldundef{pmid}{}{\printfield{pmid}\newunit}%
515 }{\printfield{pmc}\newunit}
516 \iffieldundef{reportnumber}{}{%
517 \newunitpunct\textnumero\intitlepunct%
518 \printfield{reportnumber}\newunit%
519 }%
520 }
521 % \end{macrocode}
522 % \end{macro}
523 % \end{macro}
524 % \end{macro}
525
526 % \subsection{Eprints}
527 %
528 % \begin{macro}{\hep@eprint}
529 % Private "\hep@eprint" macro
530 % \begin{macrocode}
531 \NewDocumentCommand{\hep@eprint}{smm}{
532 \DeclareFieldFormat{eprint:#2}{%
533 \newcommand*{\@path}{\IfBooleanT{#1}{\thefield{eprintclass}/}##1}%
534 #2\addcolon\space\hep@bib@online{#3/\@path}{\@path}%
535 }%
536 }
537 % \end{macrocode}
538 % \end{macro}
539 %
540 % \begin{macro}{CDS}
541 % Add CERN Document server as a eprint option
542 % \begin{macrocode}
543 \hep@eprint{CDS}{https://cds.cern.ch/record}
544 \DeclareFieldAlias{eprint:cds}{eprint:CDS}
545 % \end{macrocode}
546 % \end{macro}
547 %
548 % \begin{macro}{HEPData}
549 % Add the repository for publication-related High-Energy Physics data as a eprint option
550 % \begin{macrocode}
551 \hep@eprint{HEPData}{https://www.hepdata.net/record}
552 \DeclareFieldAlias{eprint:hepdata}{eprint:HEPData}
553 % \end{macrocode}
554 % \end{macro}
555 %
556 % \begin{macro}{CTAN}
557 % Add CTAN as a eprint option
558 % \begin{macrocode}
559 \hep@eprint{CTAN}{https://ctan.org/pkg}
560 \DeclareFieldAlias{eprint:ctan}{eprint:CTAN}
561 % \end{macrocode}
562 % \end{macro}
563 %
564 % \begin{macro}{GitHub}
565 % Add GitHub as a eprint option
566 % \begin{macrocode}
567 \hep@eprint*{GitHub}{https://github.com}
568 \DeclareFieldAlias{eprint:github}{eprint:GitHub}
569 % \end{macrocode}
570 % \end{macro}
571 %
572 % \begin{macro}{GitLab}
573 % Add GitLab as a eprint option
574 % \begin{macrocode}
575 \hep@eprint*{GitLab}{https://gitlab.com}
576 \DeclareFieldAlias{eprint:gitlab}{eprint:GitLab}
577 % \end{macrocode}
578 % \end{macro}
579 %
580 % \begin{macro}{Bitbucket}
581 % Add Bitbucket as a eprint option
582 % \begin{macrocode}
583 \hep@eprint*{Bitbucket}{https://bitbucket.org}
584 \DeclareFieldAlias{eprint:bitbucket}{eprint:Bitbucket}
585 % \end{macrocode}
586 % \end{macro}
587 %
588 % \begin{macro}{Launchpad}
589 % Add Launchpad as a eprint option
590 % \begin{macrocode}
591 \hep@eprint{Launchpad}{https://launchpad.net}
592 \DeclareFieldAlias{eprint:launchpad}{eprint:Launchpad}
593 % \end{macrocode}
594 % \end{macro}
595 %
596 % \begin{macro}{SourceForge}
597 % Add SourceForge as a eprint option
598 % \begin{macrocode}
599 \hep@eprint{SourceForge}{https://sourceforge.net/projects}
600 \DeclareFieldAlias{eprint:sourceforge}{eprint:SourceForge}
601 % \end{macrocode}
602 % \end{macro}
603 %
604 % \begin{macro}{HEPForge}
605 % Add HEPForge as a eprint option
606 % \begin{macrocode}
607 \DeclareFieldFormat{eprint:hepforge}{%
608 HEPForge\addcolon\space\hep@bib@online{https://#1/hepforge.org}{#1}%
609 }
610 \DeclareFieldAlias{eprint:HEPForge}{eprint:hepforge}
611 % \end{macrocode}
612 % \end{macro}
613 %
614 % Define bibstrings for reference names.
615 % \begin{macrocode}
616 \NewBibliographyString{refname}
617 \NewBibliographyString{refsname}
618 \DefineBibliographyStrings{english}{%
619 refname = {reference},
620 refsname = {references}
621 }
622 % \end{macrocode}
623 % \begin{macro}{\ccite}
624 % \begin{macro}{\Ccite}
625 % Define \emph{clever} citation macros.
626 % \begin{macrocode}
627 \DeclareCiteCommand{\ccite}{%
628 \ifnum\thecitetotal=1
629 \bibstring{refname}%
630 \else%
631 \bibstring{refsname}%
632 \fi%
633 \addnbspace\bibopenbracket%
634 \usebibmacro{cite:init}\usebibmacro{prenote}%
635 }{\usebibmacro{citeindex}\usebibmacro{cite:comp}}{}{%
636 \usebibmacro{cite:dump}\usebibmacro{postnote}%
637 \bibclosebracket%
638 }
639
640 \newrobustcmd*{\Ccite}{\bibsentence\ccite}
641 % \end{macrocode}
642 % \end{macro}
643 % \end{macro}
644 %</package>
645 %
646 % \section{Biblatex datamodel file} \label{sec:data model}
647 %
648 %<*datamodel>
649 %
650 % \begin{macro}{collaboration}
651 % \begin{macro}{pmid}
652 % \begin{macro}{pmcid}
653 % \begin{macro}{pmc}
654 % \begin{macro}{reportnumber}
655 % \begin{macro}{protocollessurl}
656 % Define the "dbx" file containing the "hep-bibliography" datamodel.
657 % \begin{macrocode}
658 \DeclareDatamodelFields[type=field, datatype=literal]{
659 collaboration, pmid, pmcid, pmc,
660 }
661 \DeclareDatamodelFields[type=field, format=xsv, datatype=literal]{
662 reportnumber,
663 }
664 \DeclareDatamodelFields[type=field, datatype=uri]{protocollessurl}
665 \DeclareDatamodelEntryfields{
666 collaboration, pmid, pmcid, pmc, reportnumber, protocollessurl,
667 }
668 % \end{macrocode}
669 % \end{macro}
670 % \end{macro}
671 % \end{macro}
672 % \end{macro}
673 % \end{macro}
674 % \end{macro}
675 %
676 %</datamodel>
677 %
678 % \section{Test}
679 %
680 %<*test>
681 % \begin{macrocode}
682 \documentclass[twocolumn,a4paper]{article}
683
684 \usepackage{hep-bibliography}
685
686 \begin{filecontents}{\jobname.bib}
687 @article{Ade:2015xua,
688 author = "Ade, P. A. R. and others",
689 collaboration = "Planck",
690 title = "{Planck 2015 results. XIII. Cosmological parameters}",
691 eprint = "1502.01589",
692 archivePrefix = "arXiv",
693 primaryClass = "astro-ph.CO",
694 doi = "10.1051/0004-6361/201525830",
695 journal = "Astron. Astrophys.",
696 volume = "594",
697 pages = "A13",
698 year = "2016"
699 }
700
701 @article{Agashe:2014kda,
702 author = "Olive, K. A. and others",
703 collaboration = "Particle Data Group",
704 title = "{Review of Particle Physics}",
705 doi = "10.1088/1674-1137/38/9/090001",
706 journal = "Chin. Phys. C",
707 volume = "38",
708 pages = "090001",
709 year = "2014"
710 }
711
712 @article{Ade:2013zuv,
713 author = "Ade, P. A. R. and others",
714 collaboration = "Planck",
715 title = "{Planck 2013 results. XVI. Cosmological parameters}",
716 eprint = "1303.5076",
717 archivePrefix = "arXiv",
718 primaryClass = "astro-ph.CO",
719 reportNumber = "CERN-PH-TH-2013-129",
720 doi = "10.1051/0004-6361/201321591",
721 journal = "Astron. Astrophys.",
722 volume = "571",
723 pages = "A16",
724 year = "2014"
725 }
726
727 @article{Aad:2012tfa,
728 author = "Aad, Georges and others",
729 collaboration = "ATLAS",
730 title = "{Observation of a new particle in the search for
731 the Standard Model Higgs boson with the ATLAS detector at the LHC}",
732 eprint = "1207.7214",
733 archivePrefix = "arXiv",
734 primaryClass = "hep-ex",
735 reportNumber = "CERN-PH-EP-2012-218",
736 doi = "10.1016/j.physletb.2012.08.020",
737 journal = "Phys. Lett. B",
738 volume = "716",
739 pages = "1--29",
740 year = "2012"
741 }
742
743 @article{Chatrchyan:2012ufa,
744 author = "Chatrchyan, Serguei and others",
745 collaboration = "CMS",
746 title = "{Observation of a New Boson at a Mass of 125 GeV with the
747 CMS Experiment at the LHC}",
748 eprint = "1207.7235",
749 archivePrefix = "arXiv",
750 primaryClass = "hep-ex",
751 reportNumber = "CMS-HIG-12-028, CERN-PH-EP-2012-220",
752 doi = "10.1016/j.physletb.2012.08.021",
753 journal = "Phys. Lett. B",
754 volume = "716",
755 pages = "30--61",
756 year = "2012"
757 }
758
759 @article{Beringer:1900zz,
760 author = "Beringer, J. and others",
761 collaboration = "Particle Data Group",
762 title = "{Review of Particle Physics (RPP)}",
763 reportNumber = "SLAC-REPRINT-2014-001",
764 doi = "10.1103/PhysRevD.86.010001",
765 journal = "Phys. Rev. D",
766 volume = "86",
767 pages = "010001",
768 year = "2012"
769 }
770
771 @article{Chatrchyan:2008aa,
772 author = "Chatrchyan, S. and others",
773 collaboration = "CMS",
774 title = "{The CMS Experiment at the CERN LHC}",
775 doi = "10.1088/1748-0221/3/08/S08004",
776 journal = "JINST",
777 volume = "3",
778 pages = "S08004",
779 year = "2008"
780 }
781
782 @article{Cacciari:2008gp,
783 author = "Cacciari, Matteo and Salam, Gavin P. and Soyez, Gregory",
784 title = "{The anti-$k_t$ jet clustering algorithm}",
785 eprint = "0802.1189",
786 archivePrefix = "arXiv",
787 primaryClass = "hep-ph",
788 reportNumber = "LPTHE-07-03",
789 doi = "10.1088/1126-6708/2008/04/063",
790 journal = "JHEP",
791 volume = "04",
792 pages = "063",
793 year = "2008"
794 }
795
796 @article{Aad:2008zzm,
797 author = "Aad, G. and others",
798 collaboration = "ATLAS",
799 title = "{The ATLAS Experiment at the CERN Large Hadron Collider}",
800 doi = "10.1088/1748-0221/3/08/S08003",
801 journal = "JINST",
802 volume = "3",
803 pages = "S08003",
804 year = "2008"
805 }
806
807 @article{Sjostrand:2006za,
808 author = "Sjostrand, Torbjorn and Mrenna, Stephen
809 and Skands, Peter Z.",
810 title = "{PYTHIA 6.4 Physics and Manual}",
811 eprint = "hep-ph/0603175",
812 archivePrefix = "arXiv",
813 reportNumber = "FERMILAB-PUB-06-052-CD-T, LU-TP-06-13",
814 doi = "10.1088/1126-6708/2006/05/026",
815 journal = "JHEP",
816 volume = "05",
817 pages = "026",
818 year = "2006"
819 }
820
821 @article{Spergel:2003cb,
822 author = "Spergel, D. N. and others",
823 collaboration = "WMAP",
824 title = "{First year Wilkinson Microwave Anisotropy Probe (WMAP)
825 observations: Determination of cosmological parameters}",
826 eprint = "astro-ph/0302209",
827 archivePrefix = "arXiv",
828 doi = "10.1086/377226",
829 journal = "Astrophys. J. Suppl.",
830 volume = "148",
831 pages = "175--194",
832 year = "2003"
833 }
834
835 @article{Agostinelli:2002hh,
836 author = "Agostinelli, S. and others",
837 collaboration = "GEANT4",
838 title = "{GEANT4--a simulation toolkit}",
839 reportNumber = "SLAC-PUB-9350, FERMILAB-PUB-03-339,
840 CERN-IT-2002-003",
841 doi = "10.1016/S0168-9002(03)01368-8",
842 journal = "Nucl. Instrum. Meth. A",
843 volume = "506",
844 pages = "250--303",
845 year = "2003"
846 }
847
848 @article{Randall:1999ee,
849 author = "Randall, Lisa and Sundrum, Raman",
850 title = "{A Large mass hierarchy from a small extra dimension}",
851 eprint = "hep-ph/9905221",
852 archivePrefix = "arXiv",
853 reportNumber = "MIT-CTP-2860, PUPT-1860, BUHEP-99-9",
854 doi = "10.1103/PhysRevLett.83.3370",
855 journal = "Phys. Rev. Lett.",
856 volume = "83",
857 pages = "3370--3373",
858 year = "1999"
859 }
860
861 @article{Perlmutter:1998np,
862 author = "Perlmutter, S. and others",
863 collaboration = "Supernova Cosmology Project",
864 title = "{Measurements of $\Omega$ and $\Lambda$ from 42 high
865 redshift supernovae}",
866 eprint = "astro-ph/9812133",
867 archivePrefix = "arXiv",
868 reportNumber = "LBNL-41801, LBL-41801",
869 doi = "10.1086/307221",
870 journal = "Astrophys. J.",
871 volume = "517",
872 pages = "565--586",
873 year = "1999"
874 }
875
876 @article{Riess:1998cb,
877 author = "Riess, Adam G. and others",
878 collaboration = "Supernova Search Team",
879 title = "{Observational evidence from supernovae for an accelerating
880 universe and a cosmological constant}",
881 eprint = "astro-ph/9805201",
882 archivePrefix = "arXiv",
883 doi = "10.1086/300499",
884 journal = "Astron. J.",
885 volume = "116",
886 pages = "1009--1038",
887 year = "1998"
888 }
889
890 @article{Witten:1998qj,
891 author = "Witten, Edward",
892 title = "{Anti-de Sitter space and holography}",
893 eprint = "hep-th/9802150",
894 archivePrefix = "arXiv",
895 reportNumber = "IASSNS-HEP-98-15",
896 doi = "10.4310/ATMP.1998.v2.n2.a2",
897 journal = "Adv. Theor. Math. Phys.",
898 volume = "2",
899 pages = "253--291",
900 year = "1998"
901 }
902
903 @article{Gubser:1998bc,
904 author = "Gubser, S. S. and Klebanov, Igor R.
905 and Polyakov, Alexander M.",
906 title = "{Gauge theory correlators from noncritical string theory}",
907 eprint = "hep-th/9802109",
908 archivePrefix = "arXiv",
909 reportNumber = "PUPT-1767",
910 doi = "10.1016/S0370-2693(98)00377-3",
911 journal = "Phys. Lett. B",
912 volume = "428",
913 pages = "105--114",
914 year = "1998"
915 }
916
917 @article{Maldacena:1997re,
918 author = "Maldacena, Juan Martin",
919 title = "{The Large N limit of superconformal field
920 theories and supergravity}",
921 eprint = "hep-th/9711200",
922 archivePrefix = "arXiv",
923 reportNumber = "HUTP-97-A097, HUTP-98-A097",
924 doi = "10.1023/A:1026654312961",
925 journal = "Adv. Theor. Math. Phys.",
926 volume = "2",
927 pages = "231--252",
928 year = "1998"
929 }
930
931 @article{Schlegel:1997yv,
932 author = "Schlegel, David J. and Finkbeiner, Douglas P.
933 and Davis, Marc",
934 title = "{Maps of dust IR emission for use in estimation
935 of reddening and CMBR foregrounds}",
936 eprint = "astro-ph/9710327",
937 archivePrefix = "arXiv",
938 doi = "10.1086/305772",
939 journal = "Astrophys. J.",
940 volume = "500",
941 pages = "525",
942 year = "1998"
943 }
944
945 @article{Guth:1980zm,
946 author = "Guth, Alan H.",
947 editor = "Fang, Li-Zhi and Ruffini, R.",
948 title = "{The Inflationary Universe: A Possible Solution
949 to the Horizon and Flatness Problems}",
950 reportNumber = "SLAC-PUB-2576",
951 doi = "10.1103/PhysRevD.23.347",
952 journal = "Phys. Rev. D",
953 volume = "23",
954 pages = "347--356",
955 year = "1981"
956 }
957
958 @article{Altarelli:1977zs,
959 author = "Altarelli, Guido and Parisi, G.",
960 title = "{Asymptotic Freedom in Parton Language}",
961 reportNumber = "LPTENS-77-6",
962 doi = "10.1016/0550-3213(77)90384-4",
963 journal = "Nucl. Phys. B",
964 volume = "126",
965 pages = "298--318",
966 year = "1977"
967 }
968
969 @article{Hawking:1974sw,
970 author = "Hawking, S. W.",
971 editor = "Gibbons, G. W. and Hawking, S. W.",
972 title = "{Particle Creation by Black Holes}",
973 doi = "10.1007/BF02345020",
974 journal = "Commun. Math. Phys.",
975 volume = "43",
976 pages = "199--220",
977 year = "1975",
978 related = "Hawking:1974sw-1",
979 relatedtype = "erratum"
980 }
981
982 @article{Kobayashi:1973fv,
983 author = "Kobayashi, Makoto and Maskawa, Toshihide",
984 title = "{CP Violation in the Renormalizable Theory of
985 Weak Interaction}",
986 reportNumber = "KUNS-242",
987 doi = "10.1143/PTP.49.652",
988 journal = "Prog. Theor. Phys.",
989 volume = "49",
990 pages = "652--657",
991 year = "1973"
992 }
993
994 @article{Weinberg:1967tq,
995 author = "Weinberg, Steven",
996 title = "{A Model of Leptons}",
997 doi = "10.1103/PhysRevLett.19.1264",
998 journal = "Phys. Rev. Lett.",
999 volume = "19",
1000 pages = "1264--1266",
1001 year = "1967"
1002 }
1003
1004 @article{Glashow:1961tr,
1005 author = "Glashow, S. L.",
1006 title = "{Partial Symmetries of Weak Interactions}",
1007 doi = "10.1016/0029-5582(61)90469-2",
1008 journal = "Nucl. Phys.",
1009 volume = "22",
1010 pages = "579--588",
1011 year = "1961"
1012 }
1013
1014 @article{Hawking:1974sw-1,
1015 author = "Hawking, S. W.",
1016 journal = "Commun. Math. Phys.",
1017 volume = "46",
1018 pages = "206",
1019 year = "1976",
1020 options = {skipbib=true}
1021 }
1022
1023 @article{test,
1024 author = "author",
1025 title = "title",
1026 journaltitle = "journal title",
1027 year = "2000",
1028 translator = "translator",
1029 annotator = "annotator",
1030 commentator = "commentator",
1031 subtitle = "subtitle",
1032 titleaddon = "titleaddon",
1033 editor = "editor",
1034 editora = "editora",
1035 editorb = "editorb",
1036 editorc = "editorc",
1037 journalsubtitle = "journalsubtitle",
1038 journaltitleaddon = "journaltitleaddon",
1039 issuetitle = "issuetitle",
1040 issuesubtitle = "issuesubtitle",
1041 issuetitleaddon = "issuetitleaddon",
1042 language = "language",
1043 origlanguage = "origlanguage",
1044 series = "series",
1045 volume = "volume",
1046 number = "number",
1047 eid = "eid",
1048 issue = "issue",
1049 month = "1",
1050 pages = "100",
1051 version = "1",
1052 note = "note",
1053 issn = "issn",
1054 addendum = "addendum",
1055 pubstate = "pubstate",
1056 doi = "doi",
1057 eprint = "eprint",
1058 eprintclass = "eprintclass",
1059 eprinttype = "eprinttype",
1060 url = "url",
1061 urldate = "2000",
1062 }
1063 \end{filecontents}
1064 \bibliography{\jobname}
1065 \nocite{*}
1066 \usepackage{hyperref}
1067
1068 \begin{document}
1069 \printbibliography
1070 \end{document}
1071 % \end{macrocode}
1072 %</test>
1073 %
1074 % \section{Readme}
1075 %
1076 %<*readme>
1077 %
1078 % \begin{macrocode}
1079 # The `hep-bibliography` package
1080
1081 Bibliographies for high energy physics
1082
1083 ## Introduction
1084
1085 The `hep-bibliography` package extends the `biblatex` package with some
1086 functionality mostly useful for high energy physics. In particular it
1087 makes full use of all `bibtex` fields provided by `inspirehep.net`.
1088
1089 The package can be loaded via `\usepackage{hep-bibliography}`.
1090
1091 ## Author
1092
1093 Jan Hajer
1094
1095 ## License
1096
1097 This file may be distributed and/or modified under the conditions of the
1098 `LaTeX` Project Public License, either version 1.3c of this license or
1099 (at your option) any later version. The latest version of this license is
1100 in `http://www.latex-project.org/lppl.txt` and version 1.3c or later is
1101 part of all distributions of LaTeX version 2005/12/01 or later.
1102 % \end{macrocode}
1103 %
1104 %</readme>
1105 %
1106 % \Finale
1107
1108 \endinput
1109
1110 % \PrintIndex
1111 % makeindex -s gglo.ist -o hep-bibliography-implementation.gls hep-bibliography-implementation.glo
1112 % makeindex -s gglo.ist -o hep-bibliography-implementation.ind hep-bibliography-implementation.idx