diff options
author | Norbert Preining <norbert@preining.info> | 2022-12-12 03:03:41 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2022-12-12 03:03:41 +0000 |
commit | d9c472147310b678beb9f80f0e90fc82f8825ec5 (patch) | |
tree | 70534e066d5d0d30ac8c0b9939e574a2696e8d83 /macros/latex/contrib/quantumarticle | |
parent | 6e749f2b4d0cbb91f8d2c872981d7ebba3a0fb52 (diff) |
CTAN sync 202212120303
Diffstat (limited to 'macros/latex/contrib/quantumarticle')
-rw-r--r-- | macros/latex/contrib/quantumarticle/README.md | 8 | ||||
-rw-r--r-- | macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.bib | 2 | ||||
-rw-r--r-- | macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.pdf | bin | 261448 -> 265403 bytes | |||
-rw-r--r-- | macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.tex | 11 | ||||
-rw-r--r-- | macros/latex/contrib/quantumarticle/quantum-template.pdf | bin | 435047 -> 438812 bytes | |||
-rw-r--r-- | macros/latex/contrib/quantumarticle/quantum-template.tex | 2 | ||||
-rw-r--r-- | macros/latex/contrib/quantumarticle/quantum.bst | 28 | ||||
-rw-r--r-- | macros/latex/contrib/quantumarticle/quantumarticle.cls | 42 | ||||
-rw-r--r-- | macros/latex/contrib/quantumarticle/quantumarticle.pdf | bin | 291173 -> 261220 bytes | |||
-rw-r--r-- | macros/latex/contrib/quantumarticle/quantumarticle.tex | 142 |
10 files changed, 134 insertions, 101 deletions
diff --git a/macros/latex/contrib/quantumarticle/README.md b/macros/latex/contrib/quantumarticle/README.md index 1661c55bae..fdfd0f4eff 100644 --- a/macros/latex/contrib/quantumarticle/README.md +++ b/macros/latex/contrib/quantumarticle/README.md @@ -2,7 +2,7 @@ # LaTeX document class for Quantum -This is version 6.0 of `quantumarticle`, the document class for typesetting articles in Quantum - the open journal for quantum science. +This is version 6.1 of `quantumarticle`, the document class for typesetting articles in Quantum - the open journal for quantum science. [Click here](https://raw.githubusercontent.com/quantum-journal/quantum-journal/master/quantumarticle.cls) to download the latest stable version. @@ -58,6 +58,12 @@ In addition, this document class comes bundled with two new extras (currently in ## Changelog +### New in v6.1 + +* Fix for long urls in bibliography items not breaking correctly when using the Quantum bibliography style. +* Added explanation of the difference between regular and [shortDOIs](https://shortdoi.org/) and why the latter cannot be used in bibliographies +* Further increased hyphen penalty of title + ### New in v6.0 * introduced the Quantum bibstyle `quantum.bst` together with the demo file `quantum-bibliographystyle-demo` diff --git a/macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.bib b/macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.bib index 142854b4f9..c18bcb85ee 100644 --- a/macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.bib +++ b/macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.bib @@ -1,5 +1,6 @@ preamble{"\DoNotMakeWarningsErrors"} preamble{"\MakeDoiLinksExplicit"} +@preamble{"\PageBackRef"} @article{andreas_test_case, title = {Toolbox for Reconstructing Quantum Theory from Rules on Information Acquisition}, @@ -530,4 +531,3 @@ article{article_missing_comma, url = {xkcd.com}, publisher = {The name of the publisher} } - diff --git a/macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.pdf b/macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.pdf Binary files differindex ce57ea2cd9..a27f199c6e 100644 --- a/macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.pdf +++ b/macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.pdf diff --git a/macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.tex b/macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.tex index 62cd5d9ffa..46675601cd 100644 --- a/macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.tex +++ b/macros/latex/contrib/quantumarticle/quantum-bibliographystyle-demo.tex @@ -240,7 +240,7 @@ If you want to turn off these errors raised from bibtex warnings, include the en \end{verbatim*} anywhere in the \emph{bibliography} (i.e. the \texttt{.bib} file) like one would include a reference. -\emph{Note:} Commenting the above \texttt{@preamble} entry out via \texttt{\%} will \emph{not} deactivate it as bibtex does not attribute commenting functionality to \texttt{\%}. Instead, you can simply remove the leading \texttt{@}, as is currently done in the \texttt{.bib} file accompanying this document (\texttt{quantum\_bst\_demo.bib}). +\emph{Note:} Commenting the above \texttt{@preamble} entry out via \texttt{\%} will \emph{not} deactivate it as bibtex does not attribute commenting functionality to \texttt{\%}. Instead, you can simply remove the leading \texttt{@}, as is currently done in the \texttt{.bib} file accompanying this document (\texttt{quantum-bibliographystyle-demo.bib}). \paragraph{Explicit DOI links} By default, and if the entry \texttt{doi} is provided for a \texttt{bibitem}, the quantum bibstyle will link to the DOI via the \texttt{journal/volume/issue} part of the citation for articles and via the a) \texttt{volume/chapter/pages} or b) \texttt{number/series} or c) \texttt{publisher} part for books, with a) taking precedence if provided over b) taking precedence if provided over c). @@ -250,6 +250,15 @@ This behaviour can be changed to output explicit DOI links instead. To do so, in \end{verbatim*} anywhere in the \emph{bibliography} (i.e. the \texttt{.bib} file) like one would include a reference. +\paragraph{Indicator for page backreferences} +The \texttt{hyperref} package, for example, allows for the option \texttt{pagebackref}, which adds links to each bibliography entry that point from the entry to its citations throughout the document. +When this is used, it may be nice to have a word towards the end of the entry that indicates what the -- otherwise bare -- numbers added to the entry mean. +The word ``Appearances'' can be added automatically by including the entry +\begin{verbatim*} +@preamble{"\PageBackRef"} +\end{verbatim*} +anywhere in the \emph{bibliography} (i.e. the \texttt{.bib} file) like one would include a reference. + \paragraph{Compression} By default, the quantum bibstyle prints the numbers for all references separately and does not compress a range of citations, like so: [1, 6, 7, 8, 11, 12, 13, 14]. diff --git a/macros/latex/contrib/quantumarticle/quantum-template.pdf b/macros/latex/contrib/quantumarticle/quantum-template.pdf Binary files differindex 7c571036dd..208d6b0721 100644 --- a/macros/latex/contrib/quantumarticle/quantum-template.pdf +++ b/macros/latex/contrib/quantumarticle/quantum-template.pdf diff --git a/macros/latex/contrib/quantumarticle/quantum-template.tex b/macros/latex/contrib/quantumarticle/quantum-template.tex index 6f6eda81dc..3094088515 100644 --- a/macros/latex/contrib/quantumarticle/quantum-template.tex +++ b/macros/latex/contrib/quantumarticle/quantum-template.tex @@ -101,7 +101,7 @@ Please do not mix them with your references. Citations to other works should appear in the References section at the end of the work. \begin{theorem}[DOI links are required] - Important: As Quantum is a member of Crossref, all references to works that have a DOI must be hyperlinked according to the DOI. Those links must start with \texttt{https://doi.org/} (preferred), or \texttt{http://dx.doi.org/}. Direct links to the website of the publisher are not sufficient. + Important: As Quantum is a member of Crossref, all references to works that have a DOI must be hyperlinked according to the DOI. Those links must start with \texttt{https://doi.org/} (preferred), or \texttt{http://dx.doi.org/}. Direct links to the website of the publisher are not sufficient. Also so-called \href{https://shortdoi.org/}{shortDOIs} are unfortunately not accepted by Crossref (despite shortDOI being their own service). Thus all authors must use regular full DOIs that usually start with \mbox{``10.''} as in \url{https://doi.org/10.1103/PhysRevLett.120.103201} instead of the associated shortDOI starting with \mbox{``10/''} as in \url{https://dx.doi.org/10/gc5sj2}. \end{theorem} This can be achieved in several ways, depending on how you are formatting your bibliography. diff --git a/macros/latex/contrib/quantumarticle/quantum.bst b/macros/latex/contrib/quantumarticle/quantum.bst index 8a39e901cd..96ed099499 100644 --- a/macros/latex/contrib/quantumarticle/quantum.bst +++ b/macros/latex/contrib/quantumarticle/quantum.bst @@ -80,6 +80,9 @@ INTEGERS explicit.doi.links % - whether to raise compilation errors from (many) BibTeX warnings warnings.are.errors + % - whether to append the word "Appearances" to entries, for hyperref's + % pagebackref option + pagebackref % pointers nameptr @@ -366,6 +369,10 @@ FUNCTION {fin.entry} % Args: str - Current string to write to the bbl file % Returns: add.period$ + pagebackref + { " Appearances:~" * } + 'skip$ + if$ write$ newline$ } @@ -600,11 +607,11 @@ FUNCTION { format.arxiv.hyperlink } % Args: str - The string to extract the handle from % Returns: str - The extracted arXiv handle % If the string starts with "arxiv:" or "arxiv" (or any capitalized version of these), - % the length-9 handle is extracted, otherwise the original string is returned. + % the length-10 handle is extracted, otherwise the original string is returned. duplicate$ #1 #6 substring$ "l" change.case$ "arxiv:" = - { #7 #9 substring$ } + { #7 #10 substring$ } { duplicate$ #1 #5 substring$ "l" change.case$ "arxiv" = - { #6 #9 substring$ } + { #6 #10 substring$ } 'skip$ if$ } @@ -1135,7 +1142,11 @@ FUNCTION {format.code} % including a link to the repository code empty$ { "" } - { " code:~\href{" code * "}{" * extract.repo * format.version * format.commit * "}" * } + { code "l" change.case$ "github" contains.substring + { " code:~\href{" code * "}{" * extract.repo * format.version * format.commit * "}" * } + { " code:~\href{" code * "}{" * code * "}" * } + if$ + } if$ } @@ -1147,7 +1158,7 @@ FUNCTION {format.url} shorturl empty$ { url empty$ { "" } - { " url:~\href{" url * "}{" * "https://" #8 url chop.word * "}" * } + { " url:~\url{" url * "}" * } if$ } { " url:~\href{" url * "}{" * "https://" #8 shorturl chop.word * "}" * } @@ -1740,6 +1751,7 @@ FUNCTION {begin.bib} % "Booleans" for the global config of DOI link printing and handling of warnings. #0 'explicit.doi.links := #1 'warnings.are.errors := + #0 'pagebackref := preamble$ empty$ 'skip$ { preamble$ "MakeDoiLinksExplicit" contains.substring @@ -1754,6 +1766,12 @@ FUNCTION {begin.bib} } { #1 'warnings.are.errors := } if$ + preamble$ "PageBackRef" contains.substring + { #1 'pagebackref := + "\newcommand{\PageBackRef}{}" write$ newline$ + } + { #0 'pagebackref := } + if$ preamble$ write$ newline$ } if$ diff --git a/macros/latex/contrib/quantumarticle/quantumarticle.cls b/macros/latex/contrib/quantumarticle/quantumarticle.cls index c5ae1a8ccd..a276133fca 100644 --- a/macros/latex/contrib/quantumarticle/quantumarticle.cls +++ b/macros/latex/contrib/quantumarticle/quantumarticle.cls @@ -6,7 +6,7 @@ %% Copyright 2016,2017,2018,2019,2020,2021,2022 %% Verein zur Förderung des Open Access Publizierens in den Quantenwissenschaften %% (https://quantum-journal.org/about/) -%% +%% %% It is derived from `article.cls' available from %% https://www.ctan.org/pkg/article %% @@ -17,11 +17,11 @@ %% 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. -%% +%% \NeedsTeXFormat{LaTeX2e}[1995/12/01] -\def\quantumarticleversion{6.0} +\def\quantumarticleversion{6.1} \ProvidesClass{quantumarticle} -[2021/12/07 v\quantumarticleversion +[2022/11/08 v\quantumarticleversion class for Quantum - the open journal for quantum science (https://quantum-journal.org)] \RequirePackage{xkeyval} \RequirePackage{etoolbox} @@ -91,7 +91,7 @@ class for Quantum - the open journal for quantum science (https://quantum-journa \DeclareOptionX{titlepage}{\toggletrue{@titlepage}} \DeclareOptionX{notitlepage}{\togglefalse{@titlepage}} -\DeclareOptionX{onecolumn}{\boolfalse{@twocolumn}} +\DeclareOptionX{onecolumn}{\boolfalse{@twocolumn}} \DeclareOptionX{twocolumn}{\booltrue{@twocolumn}} \DeclareOptionX{leqno}{\input{leqno.clo}} @@ -232,7 +232,7 @@ class for Quantum - the open journal for quantum science (https://quantum-journa \ExecuteOptionsX{10pt,oneside,twocolumn,notitlepage,final} \ProcessOptionsX % Throw an error if no paper size was manually specified -% Simply defaulting to a4paper gives inconsistent behaviour when submitting to the arXiv as the arXiv seems to sometimes set a4paper and sometimes letterpaper, maybe depending on the geographic region of the submitter? +% Simply defaulting to a4paper gives inconsistent behaviour when submitting to the arXiv as the arXiv seems to sometimes set a4paper and sometimes letterpaper, maybe depending on the geographic region of the submitter? \iftoggle{@papersizespecified} { } @@ -270,7 +270,7 @@ class for Quantum - the open journal for quantum science (https://quantum-journa {% \@pdfoutputerror% } - } + } \ifinlist{#2}{\@packageblacklist}{ \ifcsdef{@packageblacklisterrormessage#2}{ \ClassError{quantumarticle}{\csname @packageblacklisterrormessage#2\endcsname}{}}{} @@ -293,7 +293,7 @@ class for Quantum - the open journal for quantum science (https://quantum-journa \@highpenalty 301 \AfterEndPreamble{ - % avoid use of today + % avoid use of today \ifcsdef{today} { \iftoggle{@allowtoday} @@ -354,9 +354,9 @@ class for Quantum - the open journal for quantum science (https://quantum-journa \ltx@ifpackageloaded{ltxgrid}{ \@ifpackagelater{ltxgrid}{2020/10/03} - {}% on 2020/10/03 ltxgrid 4.2e (or 4.2d?) was released, which not only fixes the bug we try to work around here but also the fix below causes an error from this version on. + {}% on 2020/10/03 ltxgrid 4.2e (or 4.2d?) was released, which not only fixes the bug we try to work around here but also the fix below causes an error from this version on. { - %repair what ltxutils has destroyed (see https://tex.stackexchange.com/questions/343856/biblatex-produces-incomplete-bcf-with-biber-backend) + %repair what ltxutils has destroyed (see https://tex.stackexchange.com/questions/343856/biblatex-produces-incomplete-bcf-with-biber-backend) \patchcmd\enddocument {\deadcycles} {\let\AfterEndDocument\@firstofone @@ -481,7 +481,7 @@ class for Quantum - the open journal for quantum science (https://quantum-journa \noindent% \begin{minipage}{\textwidth}% \iftoggle{@titlepage}{\centering}{}% - \noindent{\huge\hyphenpenalty=5000 \@printtitle\par}% + \noindent{\huge\hyphenpenalty=50000 \@printtitle\par}% \end{minipage}% \vskip 1.5em% \iftoggle{@titlepage}{}{\begin{flushleft}}% @@ -762,7 +762,7 @@ class for Quantum - the open journal for quantum science (https://quantum-journa \@starttoc{toc}% } -\newcommand*\l@part[2]{% +\newcommand*\l@part[2]{% \ifnumgreater{\c@tocdepth}{-2}{\relax \addpenalty\@secpenalty \addvspace{2.25em \@plus\p@}% @@ -960,8 +960,8 @@ class for Quantum - the open journal for quantum science (https://quantum-journa \pagenumbering{arabic} \ifbool{@twoside}{}{\raggedbottom} \ifbool{@twocolumn}{ - \twocolumn - \sloppy + \twocolumn + \sloppy \flushbottom }{ \onecolumn @@ -1185,7 +1185,7 @@ class for Quantum - the open journal for quantum science (https://quantum-journa % email, homepage, and thanks handling % be careful - this section is highly sensitive to the positioning of the % marks \def\@printauthorextrainfo#1{ - \csname @authorname#1\endcsname: + \csname @authorname#1\endcsname: \ifcsdef{author#1emails} {% \forlistcsloop{\@@spaceafter}{author#1emails}% @@ -1302,7 +1302,7 @@ class for Quantum - the open journal for quantum science (https://quantum-journa % \fill[xshift=.95\@eQ] (0,0.5) node (eastend) {} -- ++(-\@sl,0.5) -- ++(-\@xt,0) -- ++(\@sl,-0.5) -- ++(-\@sl,-0.5) -- ++(\@xt,0) -- cycle; % \begin{scope} % \clip[xshift=.95\@eQ,overlay] (0.5\@xt,0.5) -- ++(-\@sl,-0.5) -- (0,0) -- (0.5\@xt,0.5) ++(-2\@xt,0) -- ++(-\@sl,-0.5) -- ($(-2*\@sl,0)$) -- ++(\@sl,0.5) --cycle; - % \fill[xshift=.95\@eQ] (0,0) -- ++(-\@sl,0.5) -- ++(-\@xt,0) -- ++(\@sl,-0.5) -- cycle; + % \fill[xshift=.95\@eQ] (0,0) -- ++(-\@sl,0.5) -- ++(-\@xt,0) -- ++(\@sl,-0.5) -- cycle; % \end{scope} \node[overlay,anchor=base west,opacity=0] {Q}; % <> leg in front @@ -1321,7 +1321,7 @@ class for Quantum - the open journal for quantum science (https://quantum-journa \fill[shift={($(current bounding box.south east)+(0.110\@eQ,0)$)}] (\@cw,0) -- ++($(0,\@ch)-(0,\@rl)$) to[out=90,in=0,looseness=1.22] ++($(-1.22\@rl,\@rl)$) -- ($(\@w,\@ch)$) -- ++(0,-\@w) -- ($(1.22\@rl,\@ch-\@w)$) to[out=0,in=90,looseness=1.3,rounded corners=0] ($(\@cw,\@ch)-(\@w,\@rl)$) -- ($(\@cw,0)-(\@w,-\@w)$) -- ($(\@rl,\@w)$) to[out=180,in=-100,looseness=0.95,rounded corners=0] ($(1.05\@w,0.33\@ch)$) to[out=80,in=176,looseness=1.0] ($(\@cw-\@w,0.47\@ch)$) to[rounded corners=0] ++(0,-\@cr) to[rounded corners=0] ++($(0,\@cr+\@w)$) to[out=176,in=0] ($(1.2\@rl,0.48\@ch)+(0,\@w)$) to[out=180,in=90,rounded corners=0] ($(0.05\@w,0.33\@ch)$) to[out=-90,in=180,looseness=1.1,rounded corners=0] ($(\@rl,0)$) -- cycle; \node[overlay,anchor=base east,opacity=0] at (current bounding box.south east) {a}; - % \fill[shift={($(current bounding box.south east)+(0.110\@eQ,0)$)}] (\@cw,0) -- ++($(0,\@ch)-(0,\@rl)$) to[out=90,in=0,looseness=1.22] ++($(-1.22\@rl,\@rl)$) -- ($(\@w,\@ch-0.1\@w)$) -- ++(0.1\@w,-\@w) -- ($(1.22\@rl,\@ch-\@w)$) to[out=0,in=90,looseness=1.3,rounded corners=0] ($(\@cw,\@ch)-(\@w,\@rl)$) -- ($(\@cw,0)-(\@w,-\@w)$) -- + % \fill[shift={($(current bounding box.south east)+(0.110\@eQ,0)$)}] (\@cw,0) -- ++($(0,\@ch)-(0,\@rl)$) to[out=90,in=0,looseness=1.22] ++($(-1.22\@rl,\@rl)$) -- ($(\@w,\@ch-0.1\@w)$) -- ++(0.1\@w,-\@w) -- ($(1.22\@rl,\@ch-\@w)$) to[out=0,in=90,looseness=1.3,rounded corners=0] ($(\@cw,\@ch)-(\@w,\@rl)$) -- ($(\@cw,0)-(\@w,-\@w)$) -- % ($(\@rl,\@w)$) to[out=180,in=-100,looseness=0.95,rounded corners=0] ($(1.05\@w,0.33\@ch)$) to[out=80,in=176,looseness=1.0] ($(\@cw-\@w,0.47\@ch)$) to[rounded corners=0] ++(0,-\@cr) to[rounded corners=0] ++($(0,\@cr+\@w)$) to[out=176,in=0] ($(1.2\@rl,0.48\@ch)+(0,\@w)$) to[out=180,in=90,rounded corners=0] ($(0.05\@w,0.33\@ch)$) to[out=-90,in=180,looseness=1.1,rounded corners=0] ($(\@rl,0)$) -- cycle; % \node[overlay,anchor=base east,opacity=0] at (current bounding box.south east) {a}; %n @@ -1362,7 +1362,7 @@ class for Quantum - the open journal for quantum science (https://quantum-journa } } \AtEndPreamble{ - \providecommand{\@elsearticlecommandsnotsupportederror}{\ClassError{quantumarticle}{The elsearticle style \string\cortext{}, \string\corref{}, \string\fntext{}, \string\fnref{}, \string\tnotetext{}, and \string\tnoteref{} commands are not supported by quantumarticle. Please refrain from using footnotes in the title part of your document and use the \string\tahnks{} command for author footnotes instead.}{}} + \providecommand{\@elsearticlecommandsnotsupportederror}{\ClassError{quantumarticle}{The elsearticle style \string\cortext{}, \string\corref{}, \string\fntext{}, \string\fnref{}, \string\tnotetext{}, and \string\tnoteref{} commands are not supported by quantumarticle. Please refrain from using footnotes in the title part of your document and use the \string\thanks{} command for author footnotes instead.}{}} \providecommand{\cortext}[2][]{\@elsearticlecommandsnotsupportederror} %corresponding author information \providecommand{\corref}[1]{\@elsearticlecommandsnotsupportederror} %corresponding author information reference \providecommand{\fntext}[2][]{\@elsearticlecommandsnotsupportederror} %author footnote @@ -1379,7 +1379,7 @@ class for Quantum - the open journal for quantum science (https://quantum-journa {\PassOptionsToPackage{allcolors=quantumviolet}{hyperref}} \ifcsdef{pdfoutput} -{ +{ \ifnumequal{\pdfoutput}{0} {} {\PassOptionsToPackage{breaklinks=true}{hyperref}}%setting this option produces a warning if \pdfoutput=0 @@ -1391,7 +1391,7 @@ class for Quantum - the open journal for quantum science (https://quantum-journa \AtBeginDocument{% - \RequirePackage{hyperref}% + \RequirePackage{hyperref}% \@ifpackageloaded{natbib}{% \setlength{\bibsep}{0pt plus 0.3ex} @@ -1427,7 +1427,7 @@ class for Quantum - the open journal for quantum science (https://quantum-journa { \PassOptionsToPackage{numbers}{natbib} \PassOptionsToPackage{sort&compress}{natbib} - + \providecommand{\ao}{Appl.\ Opt.} \providecommand{\ap}{Appl.\ Phys.} \providecommand{\apl}{Appl.\ Phys.\ Lett.} diff --git a/macros/latex/contrib/quantumarticle/quantumarticle.pdf b/macros/latex/contrib/quantumarticle/quantumarticle.pdf Binary files differindex 29a9700f32..732ea4850e 100644 --- a/macros/latex/contrib/quantumarticle/quantumarticle.pdf +++ b/macros/latex/contrib/quantumarticle/quantumarticle.pdf diff --git a/macros/latex/contrib/quantumarticle/quantumarticle.tex b/macros/latex/contrib/quantumarticle/quantumarticle.tex index 1d83b743bd..5b8ed5a2b5 100644 --- a/macros/latex/contrib/quantumarticle/quantumarticle.tex +++ b/macros/latex/contrib/quantumarticle/quantumarticle.tex @@ -60,18 +60,18 @@ \begin{document} \title{Documentation of quantumarticle.cls v\quantumarticleversion} \maketitle - + \tableofcontents - + \clearpage - + \section{Introduction} - The quantumarticle document class is the preferred document class for papers that will be submitted to \href{https://quantum-journal.org/}{Quantum -- the open journal of quantum science}. It is based on the widely used \texttt{article} document class and designed to allow a seamless transition from documents typeset with \texttt{article}, \texttt{revtex4-1} and the \texttt{elsarticle} document classes. - + The quantumarticle document class is the preferred document class for papers that will be submitted to \href{https://quantum-journal.org/}{Quantum -- the open journal of quantum science}. It is based on the widely used \texttt{article} document class and designed to allow a seamless transition from documents typeset with \texttt{article}, \texttt{revtex4-1} and the \texttt{elsarticle} document classes. + As Quantum is an arXiv overlay journal, all papers have to be submitted to the arXiv. To make this submission process as user-friendly as possible, the quantumarticle document class implements a number of arXiv-specific checks, which however can be deactivated via the option \texttt{noarxiv}. An example for this is a check that is meant to make sure that the arXiv produces a PDF file and that hyperlinks are correctly broken across multiple lines. - To ensure this, the arXiv \href{https://arxiv.org/help/submit_tex}{recommends} putting + To ensure this, the arXiv \href{https://arxiv.org/help/submit_tex}{recommends} putting \begin{verbatim} \pdfoutput=1 \end{verbatim} @@ -80,24 +80,24 @@ Giving the \texttt{noarxiv} option also disables a number of other features of quantum article and removes any Quantum related branding from the document. Authors who would like to keep the checks active but still use this document class for manuscripts not intended for submission to Quantum and therefore without Quantum branding can use the \texttt{unpublished} option. One feature deactivated by both \texttt{unpublished} and \texttt{noarxiv} for example, is the ``title click feature'' of quantumarticle. As this document class can be used for arbitrary documents, Quantum implements a feature where readers can, by clicking on the title of a manuscript, verify whether this manuscript was actually published by Quantum. Obviously this is an unwanted feature in any manuscript not accepted in Quantum and it can thus be deactivated with the \texttt{unpublished} option. - + \section{Typesetting documents} The following are guidelines for the usage of the quantumarticle document class for manuscripts to be submitted to or accepted in Quantum. A detailed description of the functionality and options of the document class follow in Section~\ref{sec:options}. - - \subsection{Recommendations on structure} + + \subsection{Recommendations on structure} In the \texttt{twocolumn} layout and without the \texttt{titlepage} option a paragraph without a previous section title may directly follow the abstract. In \texttt{onecolumn} format or with a dedicated \texttt{titlepage}, this should be avoided. - + Longer articles should include a section that, early on, explains the main results, their limitations, and assumptions. This section can be used to, for example, present the main theorem, or provide a summary of the results for a wider audience. - + \subsection{Title information} The title of the document is given via the common \texttt{title} command. Note that clicking the title performs a search for that title on \href{http://quantum-journal.org}{quantum-journal.org}. - In this way readers can easily verify whether a work using the \texttt{quantumarticle} class was actually published in Quantum. By giving the \texttt{accepted=YYYY-MM-DD} option, with \texttt{YYYY-MM-DD} the acceptance date, the note ``Accepted in Quantum YYYY-MM-DD, click title to verify'' can be added to the bottom of each page to clearly mark works that have been accepted in Quantum. - + In this way readers can easily verify whether a work using the \texttt{quantumarticle} class was actually published in Quantum. By giving the \texttt{accepted=YYYY-MM-DD} option, with \texttt{YYYY-MM-DD} the acceptance date, the note ``Accepted in Quantum YYYY-MM-DD, click title to verify'' can be added to the bottom of each page to clearly mark works that have been accepted in Quantum. + You should call \texttt{\textbackslash{}maketitle} before your running text starts. - + \subsubsection{Authors and affiliations} You can provide information on authors and affiliations in the common format also used by \texttt{revtex}: \begin{verbatim} @@ -122,27 +122,27 @@ \affil[2]{Affiliation 1} \affil[3]{Affiliation 1} \end{verbatim} - + \subsubsection{Other author related information} The quantumarticle document class supports further commands that are author specific: \begin{commands} \command{email}{% E-Mail address of the author, displayed in the bottom of the page. } - + \command{homepage}{% Homepage of the author, displayed in the bottom of the page. } - + \command{thanks}{% Additional text that is displayed in the bottom of the page. } - + \command{orcid}{% If the ORCiD of the author is given, his name will become a link to his ORCiD profile. } \end{commands} - + \subsection{Abstract} The abstract is typeset using the common \texttt{abstract} environment. In the standard, \texttt{twocolumn}, layout the abstract is typeset as a bold face first paragraph. In \texttt{onecolumn} layout the abstract is placed above the text. @@ -150,44 +150,44 @@ This format can be more suitable for long articles. The \texttt{abstract} environment can appear both before and after the \texttt{\textbackslash{}maketitle} command and calling \texttt{\textbackslash{}maketitle} is optional, as long as there is an \texttt{abstract}. Both \texttt{abstract} and \texttt{\textbackslash{}maketitle} however must be placed after all other \texttt{\textbackslash{}author}, \texttt{\textbackslash{}affiliation}, etc.\ commands. - + \subsection{Sectioning} Sections, subsections, subsubsections, and paragraphs should be typeset with the standard LaTeX commands. The paragraph is the smallest unit of sectioning. Feel free to end the paragraph title with a full stop if you find this appropriate. - - \subsection{Equations} + + \subsection{Equations} You can use the standard commands for equations. For multi-line equations \texttt{align} is preferable over \texttt{eqnarray}, please refrain from using the latter. For complex equations you may want to consider using the \texttt{IEEEeqnarray} environment from the \texttt{IEEEtrantools} package. - + How you refer to equations is up to you, but please be consistent and use the \texttt{\textbackslash{}eqref\{\dots\}} command instead of writing \texttt{(\textbackslash{}ref\{\dots\})}. - + As a courtesy for your readers and referees, please suppress equation numbers only if there is a specific reason to do so, to not make it unnecessarily difficult to refer to individual results and steps in derivations. - + Very wide equations can be shown expanding over both columns using the \texttt{widetext} environment. In \texttt{onecolumn} mode, the \texttt{widetext} environment has no effect. To enable this feature in \texttt{twocolumn} mode, \texttt{quantumarticle} relies on the package \texttt{ltxgrid}. Unfortunately this package has a bug that leads to a sub-optimal placement of extremely long footnotes. - - \subsection{Floats} + + \subsection{Floats} Every floating element must have an informative caption and a number. The caption can be placed above, below, or to the side of the figure, as you see fit. - + Feel free to place them at the top or bottom of the page, or in the middle of a paragraph as you see fit. Try to place them on the same page as the text referring to them. A figure on the first page can help readers remember and recognize your work more easily. - + \subsubsection{Figures} - Figures are typeset using the standard \texttt{figure} environment for single-column figures and \texttt{figure*} for multi-column figures. - + Figures are typeset using the standard \texttt{figure} environment for single-column figures and \texttt{figure*} for multi-column figures. + \subsubsection{Tables} - Tables are typeset using the standard \texttt{table} environment for single-column tables and \texttt{table*} for multi-column tables. - + Tables are typeset using the standard \texttt{table} environment for single-column tables and \texttt{table*} for multi-column tables. + \subsection{Plots} Quantum provides a Jupyter notebook to create plots that integrate seamlessly with \texttt{quantumarticle}. - + \subsection{Footnotes} Footnotes are typeset using the \texttt{footnote} command. They will appear in the bottom of the page. Please do only use footnotes when appropriate and do not mix footnotes with references. - - \subsection{References} + + \subsection{References} Citations to other works should appear in the References section at the end of the work. - + \paragraph{Important:} As Quantum is a member of Crossref, all references to works that have a DOI \emph{must} be hyperlinked according to the DOI. Those links must start with \texttt{https://doi.org/} (preferred), or \texttt{http://dx.doi.org/}. Direct links to the website of the publisher are not sufficient. This can be achieved in several ways, depending on how you are formatting your bibliography. - + \subsubsection{Manual bibliography} Suppose the DOI of an article that you want to cite is \texttt{10.22331/idonotexist}. If you are formatting your bibliography manually, you can cite this work using the following in your \texttt{thebibliography} environment: \begin{verbatim} @@ -197,10 +197,10 @@ idonotexist}{Quantum \textbf{123}, 123456 (1916).} \end{verbatim} - + \paragraph{Important:} If you are formatting your bibliography manually, please do not group multiple citations into one \texttt{\textbackslash{}bibitem}. Having to search through multiple references to find the cited result makes your work less accessible for authors and grouping references can screw up our automatic extraction of citations. - + \subsubsection{BibTeX bibliography} We encourage the use of BibTeX to generate your bibliography from the BibTeX meta-data provided by publishers. For DOI linking to work, the BibTeX file must contain the \texttt{doi} field as for example in: @@ -218,7 +218,7 @@ Several authors had problems because of Unicode characters in their BibTeX files. Be advised that \href{http://wiki.lyx.org/BibTeX/Tips}{BibTeX does not support Unicode characters}. All special characters must be input via their respective LaTeX commands. - + \paragraph{natbib} If you are using BibTeX, you can load the \texttt{natbib} package by putting \begin{verbatim} @@ -231,7 +231,7 @@ \end{verbatim} The quantumarticle class automatically detects that the \texttt{natbib} package was loaded and redefines the \texttt{\textbackslash{}doi} command to create hyperlinks. This is likely the easiest option if you are converting from another document class. - + \paragraph{BibLaTeX} If you want to use BibLaTeX, you can instead add \begin{verbatim} @@ -245,20 +245,20 @@ where appropriate. You then have to upload the .bbl file along with the other source files when submitting to the arXiv. Due to incompatibilities between different BibLaTeX versions we unfortunately cannot recommend this option. - + The quantumarticle class automatically detects that the \texttt{biblatex} package was loaded, sets the default option \texttt{doi=true} to include the DOI in the bibliography, and declares a suitable field format to make it a hyperlink. Due to issues with \texttt{biber} we recommend to use the \texttt{bibtex} backend of \texttt{biblatex}. - + Feel free to change the appearance of citations in any way you like by using a different \texttt{bibliographystyle} or via the advanced mechanisms provided by BibLaTeX. The only two requirements are that citations must uniquely identify the cited work and that they must contain a DOI hyperlink whenever possible. - + \subsection{Appendix} Quantum allows the usage of appendices. Ideally, the command \texttt{\textbackslash{}appendix} should be put before the appendices to get appropriate section numbering. The appendices are then numbered alphabetically, with numeric (sub)subsection numbering. Equations continue to be numbered sequentially. You are free to change this in case it is more appropriate for your article, but a consistent and unambiguous numbering of sections and equations must be ensured. - - If you want your appendices to appear in \texttt{onecolumn} mode but the rest of the document in \texttt{twocolumn} mode, you can insert the command \texttt{\textbackslash{}onecolumn\textbackslash{}newpage} before \texttt{\textbackslash{}appendix}. - + + If you want your appendices to appear in \texttt{onecolumn} mode but the rest of the document in \texttt{twocolumn} mode, you can insert the command \texttt{\textbackslash{}onecolumn\textbackslash{}newpage} before \texttt{\textbackslash{}appendix}. + \subsection{Recommended packages} Quantum encourages you to load the following extra packages: \begin{verbatim} @@ -270,16 +270,16 @@ \end{verbatim} If you do not load the \texttt{hyperref} package, quantumarticle automatically loads it for you. Packages that change font settings, such as \texttt{times} or \texttt{helvet} should be avoided. - + \section{Package options} \label{sec:options} The quantumarticle document class provides a multitude of package options that change the appearance of the final document to the liking of the user. Default options that need not be given are marked with \texttt{(default)}. Options that are only provided for compatibility reasons and that will not alter the typesetting of the document are marked with \texttt{(C)}. - + \subsection{Document setup} - + \subsubsection{Document format} - The document class does not specify a default paper size and an error is raised if none is specified. The reason for this is that different LaTeX compilers and localizations can cause paper sizes to vary between setups and this can lead to unexpected results when multiple authors collaborate on a document and the final typesetting is performed by a third party, such as the arXiv. - + The document class does not specify a default paper size and an error is raised if none is specified. The reason for this is that different LaTeX compilers and localizations can cause paper sizes to vary between setups and this can lead to unexpected results when multiple authors collaborate on a document and the final typesetting is performed by a third party, such as the arXiv. + \begin{options} \option{a4paper}{% Sets the paper size to ISO A4. @@ -302,8 +302,8 @@ \end{options} \subsubsection{Orientation} - By default, the orientation is portrait. - + By default, the orientation is portrait. + \begin{options} \option{landscape}{% Sets the orientation of the document to landscape. @@ -312,7 +312,7 @@ \subsubsection{Fontsize} By default, the fontsize is 10pt. - + \begin{options} \defaultoption{10pt}{% Sets the normal fontsize to 10pt. @@ -327,7 +327,7 @@ \subsubsection{Sides} By default, the setting is oneside. - + \begin{options} \defaultoption{oneside}{% Prepares the document onesided. @@ -339,7 +339,7 @@ \subsubsection{Titlepage} By default, the document class is typeset with no extra titlepage. - + \begin{options} \option{titlepage}{% Displays the title on a separate titlepage. @@ -351,7 +351,7 @@ \subsubsection{Draft} By default, the document class is typeset as final. - + \begin{options} \option{draft}{% Marks the document as a draft. @@ -362,10 +362,10 @@ \end{options} \subsection{Style options} - + \subsubsection{Equations} By default, equations are typeset centered, with equation numbers on the right. - + \begin{options} \option{fleqn}{% Display equations left aligned. @@ -376,7 +376,7 @@ \end{options} \subsubsection{Bibliography} - + \begin{options} \option{openbib}{% Display elements of bibliography entries on separate lines, \href{https://tex.stackexchange.com/questions/56628/custom-references-page-with-additional-line-breaks}{see here}. @@ -385,7 +385,7 @@ \subsection{Pre-loaded packages} The document class only loads packages necessary for its operation, such as \texttt{geometry} or \texttt{hyperref}. For compatibility reasons, there are commands that load certain widely used packages for the user. - + \begin{options} \option{amsfonts}{% Load the package \texttt{amsfonts}. @@ -411,8 +411,8 @@ \end{options} \subsection{Publication} - By default, all documents that are created with the \texttt{quantumarticle} document class are treated as possible submissions to Quantum. - + By default, all documents that are created with the \texttt{quantumarticle} document class are treated as possible submissions to Quantum. + \begin{options} \option{accepted=YYYY-MM-DD}{% Adds the note 'Accepted in Quantum YYYY-MM-DD' to the document. @@ -427,7 +427,7 @@ \subsection{Compatibility} The \texttt{quantumarticle} class aims to be maximally compatible with documents that were previously typeset with other document classes. For this reason, a number of options are present for the sole purpose of compatibility but do not have any effect on how your document will be typeset These include: - + \begin{options} \compatibilityoption{checkin}{No effect.} \compatibilityoption{preprint}{\ditto} @@ -497,16 +497,16 @@ \compatibilityoption{prx}{\ditto} \compatibilityoption{aip}{\ditto} \end{options} - + \section{Contributing} In case you encounter problems using the article class please consider opening a bug report in our \href{https://github.com/quantum-journal/quantum-journal/issues}{bug-tracker on GitHub}. You can also contact us via email under \texttt{latex@quantum-journal.org}, but it may take significantly longer to get a response. In any case we need the full source of a document that produces the problem and the log file showing the error to help you. - + Improvements submitted as pull requests against the \href{https://github.com/quantum-journal/quantum-journal/tree/develop}{develop} branch are very much appreciated! - + \section{Copyright} Copyright 2019 Verein zur Förderung des Open Access Publizierens in den Quantenwissenschaften (\url{http://quantum-journal.org/about/}). - + The document class \texttt{quantumarticle} is derived from \texttt{article} available from \url{https://www.ctan.org/pkg/article}. - + It 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 \url{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{document} |