Writing a paper in LaTeX: resources
jacow.cls
Most important thing of all: use the latest jacow.cls file.
It may be that your LaTeX distribution includes it already but in an older version. If in doubt, download it from the JACoW github repository and install it in your distribution's TEXMFHOME
directory.
How to use lowercase letters in title and section headings
The jacow.cls
class file defines commands like \title
and \section
which go into
structuring your document. These commands force their text to be UPPERCASE. If you need include lowercase letters (e.g. for special acronyms or units) please use the \NoCaseChange
command.
Examples
\title{The 3 \NoCaseChange{GeV} Taiwan Light Source}
renders: THE 3 GeV TAIWAN LIGHT SOURCE
\section{RF Shielding at \NoCaseChange{SPring-8}}
renders: RF SHIELDING AT SPring-8
Typesetting units
Numbers and units are typeset with the thin space between them, this should preferably an non-breaking space to insure that number and unit are not split over line breaks or column/page breaks. A thin space is entered in LATEX using \,
. The alternative is to use the siunitx
package (preloaded in jacow.cls
) with \SI{<number>}{<unit>}
.
The numerical value always precedes the unit, and a space is always used to separate the unit from the number, e. g. 10.2 m
(not 10.2m
).
The same should be done with temperature degrees: 30.2 °C
(not 30.2°C
or 30.2° C
).
The only exceptions to this rule are for the unit symbols for degree, minute, and second for plane angle (°
, '
, and "
, respectively), for which no space is left between the numerical value and the unit symbol.
Examples
-
\qty[]{10}{\um}
or\qty[]{10}{\micro\meter}
- required way to get an upright unit -
\qty[]{10}{m}
will give optimised spacing (thin space) between digit and unit -
10\,m
(rather than10 m
) alternative way tosiunitx
-
Exceptions:
10\,$^{\circ}$C
renders10 °C
-
\usepackage{gensymb}
→\degree
-
\usepackage{textcomp}
→\textdegree
-
References
Example of correct use of references in LaTeX:
\begin{thebibliography}{9} %% use {99} for 10+ references!
\bibitem{Author:IJC99-MONA2}
A.N. Author \emph{et al.},
``Title of the paper’’,
in \emph{Proc. IJC’99}, Nowhere, XY, May 2099, pp. 199--201.\\
\url{doi:10.18429/JACoW-IJC2099-MONA2}
\end{thebibliography}
Renders:
[1] A.N. Author et al., ``Title of the paper’’, in Proc. IJC’99, Nowhere, XY, May 2099, pp. 199--201.
doi:10.18429/JACoW-IJC2099-MONA2
Note: referenced titles should be in Sentence case, not Title Case.
BibLaTeX
BibLaTeX can be use with BibTeX or Biber. As the automatically formatted output of BibLaTeX + Biber is superior to all other ways of generating a bibliography, this is recommended. If the requested formatting cannot be achieved, using BibTeX and pasting the final outcome into the source is a possibility.
The following magic comments are understood by most TeX-editors (e.g. TeXStudio, TeXnicCenter, TeXWorks). They are placed before the opening \documentclass[]{}
command and overwrite settings in the TeX-editor:
% !BIB TS-program = biber/bibtex
% !BIB program = biber/bibtex
% !TeX spellcheck = en_GB/en_US
% !TeX program = pdflatex/lualatex/xetex
% !TEX TS-program = pdflatex/lualatex/xetex
% !TeX encoding = utf8/IsoLatin/IsoLatin
% !TEX root = <main file name>
TextMate, SublimeText, Atom, vimtex, and Overleaf understand some of the magic comments.
References to a published JACoW paper
Please note the peculiar use of venue
and year
for a correct rendering:
@inproceedings{xiang:ipac2022-thpopt022,
author = {R. Xiang and A. Arnold and S. Ma and P. Michel and P. Murcek and A.A. Ryzhov and J. Schaber and J. Teichert and P.Z. Zwartek},
title = {{Study on QE evolution of Cs₂Te photocathodes in ELBE SRF Gun-II}},
booktitle = {Proc. IPAC'22},
%booktitle = {Proc. 13th International Particle Accelerator Conference (IPAC'22)},
pages = {2617--2619},
%eid = {THPOPT022},
language = {english},
keywords = {cathode, gun, SRF, operation, vacuum},
venue = {Bangkok, Thailand, May 2022},
series = {International Particle Accelerator Conference},
number = {13},
publisher = {JACoW Publishing, Geneva, Switzerland},
month = {05},
%year = {2022},
issn = {2673-5490},
isbn = {978-3-95450-227-1},
doi = {10.18429/JACoW-IPAC2022-THPOPT022},
url = {https://jacow.org/ipac2022/papers/thpopt022.pdf},
abstract = {{...}},
}
In fact, the "standard way" with:
venue = {Bangkok, Thailand},
year = {2022}
month={05}
eid ={THPOPT022}
would render:
[14] R. Xiang et al., “Study on QE evolution of Cs2Te photocathodes in ELBE SRF Gun-II,”
in Proc. IPAC’22, Bangkok, Thailand, 2022, paper THPOPT022, pp. 2617–2619.
doi:10.18429/JACoW-IPAC2022-THPOPT022
By fine-tuning our .bib
file:
venue = {Bangkok, Thailand, May 2022},
%year = {2022}
%eid ={THPOPT022}
we get the correct format:
[14] R. Xiang et al., “Study on QE evolution of Cs2Te photocathodes in ELBE SRF Gun-II,”
in Proc. IPAC’22, Bangkok, Thailand, May 2022, pp. 2617–2619.
doi:10.18429/JACoW-IPAC2022-THPOPT022
References to papers presented at the current conference in BibLaTeX
The following Bib-entries should be used for BibLaTeX to correctly reference papers presented at the current conference:
@article{bib-key,
title = "{Title of the paper presented at...}",
author = {Author, A. N. and Somebody, E.L.S.E.},
journal = {\normalfont{presented at the 99th International JACoW
Conference (IJC'99), Nowhere, XY}},
year = {May 2099, paper MONA2, this conference},
}
In abbreviated form:
@article{bib-key,
title = "{Title of the paper presented at...}",
author = {Author, A. N. and Somebody, E.L.S.E.},
journal = {\normalfont{presented at IJC'99, Nowhere, XY}},
year = {May 2099, paper MONA2, this conference},
BibLaTeX in current JACoW class
The current BibLaTeX style has implemented the usage of eventdate
field where eventyear
has a higher priority than year
(publication date). The above reference can be written as
@inproceedings{xiang:ipac2022-thpopt022,
author = {R. Xiang and A. Arnold and S. Ma and P. Michel and P. Murcek and A.A. Ryzhov and J. Schaber and J. Teichert and P.Z. Zwartek},
title = {{Study on QE evolution of Cs₂Te photocathodes in ELBE SRF Gun-II}},
booktitle = {Proc. IPAC'22},
%booktitle = {Proc. 13th International Particle Accelerator Conference (IPAC'22)},
pages = {2617--2619},
eid = {THPOPT022},
language = {english},
keywords = {cathode, gun, SRF, operation, vacuum},
venue = {Bangkok, Thailand},
eventdate = {2022-06-12/2022-06-17},
series = {International Particle Accelerator Conference},
number = {13},
publisher = {JACoW Publishing, Geneva, Switzerland},
month = {05},
year = {2022},
issn = {2673-5490},
isbn = {978-3-95450-227-1},
doi = {10.18429/JACoW-IPAC2022-THPOPT022},
url = {https://jacow.org/ipac2022/papers/thpopt022.pdf},
abstract = {{...}},
}
where the eventdate
can be as minimal as 2022-06
to have the same effect in JACoW style.
The unpublished contribution should use the eventtitle
field:
@unpublished{lin:ipac2022-moiygd2,
author = {C. Lin},
title = {{Recent Progress of Compact LAser Plasma Accelerator at Peking University}},
eventtitle = {IPAC'22},
venue = {Bangkok, Thailand},
eventdate = {2022-06-12/2022-06-17},
abstract = {{...}},
}
The ones presented at the current event need the type
field:
@unpublished{...,
... ,
type = {this conference},
}
JACoW also prefers the usage of ISO-4 form for Journals. A standard way is to put the abbreviated journal titles into the shortjournal
field so that it can be compatible with other publishers. The ISO-4 abbreviations can be obtained at https://marcinwrochna.github.io/abbrevIso/. There's also an official TeXstudio macro that can do it automatically.
TeXstudio tricks
TeXstudio is a cross-platform open-source TeX Editor. It has a built-in macro system that uses the QuickJS
language. There're some interesting macros in the official repository that can be installed by opening the Menu Macros
⇒ Edit Macros...
⇒ Browse
. The scripts under jacow
folder are specifically created for our events. Pull them and assign a shortcut to it.
Format thebibliography
(Format thebibliography.txsMacro
)
This script automatically sorts thebibliography
environment with regard to the citation order. A dummy entry will be created when a cited label does not exist in the environment. Those not cited in text will be ignored. The original environment will be put at the end of the document (after \end{document}
) for comparison.
To SI (SI formatter.txsMacro
)
This script separates the number part and converts the selected text to a unit block. For example
$2\times10^{2}\mu\mathrm{m}$
⇒\SI{2e2}{μm}
$^{\circ}C$
⇒\si{°C}
Enable regular expression in Search
and look for numbers with -?±?\d+\.?[\^\d]*
and all potential units will be highlighted. Then select the quantity with unit and run the macro to reduce the tedious input.
ISO-4 (ISO-4 formatter.txsMacro
)
This script converts the selected text to its ISO-4 abbreviation form. cURL
needs to be installed can be callable in order to make an HTTP GET request. If you’re working with .bib
database, I recommand to duplicate the journal
/journaltitle
line, run the macro on one of the Journal titles and change the field to shortjournal
.
Other tricks
-
When using
\usepackage{authblk}
you probably see a spacing between author and affiliation block. This can be suppressed using\setlength{\affilsep}{0pt}
If there is a, and
before the last author’s name, this can be suppressed using\renewcommand\Authsep{, }
-
Equation formatting: the JACoW template requires the equation numbers to be put inside parenthesis. This can easily achieved using
\eqref{label} instead of (\ref{label})