summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/jacow
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/jacow
Initial commit
Diffstat (limited to 'macros/latex/contrib/jacow')
-rw-r--r--macros/latex/contrib/jacow/JACoW_LaTeX_A4.pdfbin0 -> 920558 bytes
-rw-r--r--macros/latex/contrib/jacow/JACoW_LaTeX_A4.tex485
-rw-r--r--macros/latex/contrib/jacow/JACoW_LaTeX_Letter.pdfbin0 -> 1038775 bytes
-rw-r--r--macros/latex/contrib/jacow/JACoW_LaTeX_Letter.tex488
-rw-r--r--macros/latex/contrib/jacow/JACpic2.jpgbin0 -> 802614 bytes
-rw-r--r--macros/latex/contrib/jacow/JACpic_mc.pdfbin0 -> 20479 bytes
-rw-r--r--macros/latex/contrib/jacow/README65
-rw-r--r--macros/latex/contrib/jacow/annexes-A4.tex544
-rw-r--r--macros/latex/contrib/jacow/annexes-Letter.tex543
-rw-r--r--macros/latex/contrib/jacow/jacow-collaboration.pdfbin0 -> 26164 bytes
-rw-r--r--macros/latex/contrib/jacow/jacow-collaboration.tex98
-rw-r--r--macros/latex/contrib/jacow/jacow.cls503
12 files changed, 2726 insertions, 0 deletions
diff --git a/macros/latex/contrib/jacow/JACoW_LaTeX_A4.pdf b/macros/latex/contrib/jacow/JACoW_LaTeX_A4.pdf
new file mode 100644
index 0000000000..daf5300703
--- /dev/null
+++ b/macros/latex/contrib/jacow/JACoW_LaTeX_A4.pdf
Binary files differ
diff --git a/macros/latex/contrib/jacow/JACoW_LaTeX_A4.tex b/macros/latex/contrib/jacow/JACoW_LaTeX_A4.tex
new file mode 100644
index 0000000000..4dee33ef9d
--- /dev/null
+++ b/macros/latex/contrib/jacow/JACoW_LaTeX_A4.tex
@@ -0,0 +1,485 @@
+% !TeX spellcheck = en_GB
+% !TeX program = lualatex
+%
+% v 2.3 Feb 2019 Volker RW Schaa
+% # changes in the collaboration therefore updated file "jacow-collaboration.tex"
+% # all References with DOIs have their period/full stop before the DOI (after pp. or year)
+% # in the author/affiliation block all ZIP codes in square brackets removed as it was not % understood as optional parameter and ZIP codes had bin put in brackets
+% # References to the current IPAC are changed to "IPAC'19, Melbourne, Australia"
+% # font for ‘url’ style changed to ‘newtxtt’ as it is easier to distinguish "O" and "0"
+%
+\documentclass[a4paper,
+ %boxit, % check whether paper is inside correct margins
+ %titlepage, % separate title page
+ %refpage % separate references
+ %biblatex, % biblatex is used
+ keeplastbox, % flushend option: not to un-indent last line in References
+ %nospread, % flushend option: do not fill with whitespace to balance columns
+ %hyphens, % allow \url to hyphenate at "-" (hyphens)
+ %xetex, % use XeLaTeX to process the file
+ %luatex, % use LuaLaTeX to process the file
+ ]{jacow}
+%
+% ONLY FOR \footnote in table/tabular
+%
+\usepackage{pdfpages,multirow,ragged2e} %
+%
+% CHANGE SEQUENCE OF GRAPHICS EXTENSION TO BE EMBEDDED
+% ----------------------------------------------------
+% test for XeTeX where the sequence is by default eps-> pdf, jpg, png, pdf, ...
+% and the JACoW template provides JACpic2v3.eps and JACpic2v3.jpg which
+% might generates errors, therefore PNG and JPG first
+%
+\makeatletter%
+ \ifboolexpr{bool{xetex}}
+ {\renewcommand{\Gin@extensions}{.pdf,%
+ .png,.jpg,.bmp,.pict,.tif,.psd,.mac,.sga,.tga,.gif,%
+ .eps,.ps,%
+ }}{}
+\makeatother
+
+% CHECK FOR XeTeX/LuaTeX BEFORE DEFINING AN INPUT ENCODING
+% --------------------------------------------------------
+% utf8 is default for XeTeX/LuaTeX
+% utf8 in LaTeX only realises a small portion of codes
+%
+\ifboolexpr{bool{xetex} or bool{luatex}} % test for XeTeX/LuaTeX
+ {} % input encoding is utf8 by default
+ {\usepackage[utf8]{inputenc}} % switch to utf8
+
+\usepackage[USenglish]{babel}
+
+%
+% if BibLaTeX is used
+%
+\ifboolexpr{bool{jacowbiblatex}}%
+ {%
+ \addbibresource{jacow-test.bib}
+ \addbibresource{biblatex-examples.bib}
+ }{}
+\listfiles
+
+%%
+%% Lengths for the spaces in the title
+%% \setlength\titleblockstartskip{..} %before title, default 3pt
+%% \setlength\titleblockmiddleskip{..} %between title + author, default 1em
+%% \setlength\titleblockendskip{..} %afterauthor, default 1em
+
+\begin{document}
+
+\title{preparation OF papers for \NoCaseChange{JACoW} conferences\thanks{Work supported by ...}}
+
+\author{A. N. Author\thanks{email address}, H. Coauthor, Name of Institute or Affiliation, City, Country \\
+ P. Contributor\textsuperscript{1}, Name of Institute or Affiliation, City, Country \\
+ \textsuperscript{1}also at Name of Secondary Institute or Affiliation, City, Country}
+
+\maketitle
+
+%
+\begin{abstract}
+ Many conference series have adopted the same standards
+ for electronic publication and have joined the Joint
+ Accelerator Conferences Website (JACoW) collaboration
+ for the publication of their proceedings. This document
+ describes the common requirements for the submission of
+ papers to these conferences. Please consult individual
+ conference information for page limits, method of electronic
+ submission, etc. It is not intended that this should
+ be a tutorial in word processing; the aim is to explain the
+ particular requirements for electronic publication at
+ www.JACoW.org. The abstract itself is to act as a stand-alone
+ entity and, as such, should not include citations. Any acronyms
+ should be expanded on their first occurrence, both in the
+ abstract and in the rest of the paper.
+ The abstract itself is to act as a stand-alone entity and,
+ as such, should not include citations. Any acronyms should
+ be expanded on their first occurrence, both in the abstract
+ and in the rest of the paper.
+\end{abstract}
+
+
+\section{SUBMISSION OF PAPERS}
+Each author should submit the PDF file and all source
+files (text and figures) to enable the paper to be
+reconstructed if there are processing difficulties.
+
+\section{MANUSCRIPTS}
+Templates are provided for recommended software and
+authors are advised to use them. Please consult the
+individual conference help pages if questions arise.
+
+\subsection{General Layout}
+
+These instructions are a typical implementation of the
+requirements. Manuscripts should have:
+\begin{Itemize}
+ \item Either A4 (\SI{21.0}{cm}~$\times$~\SI{29.7}{cm}; \SI{8.27}{in}~$\times$~\SI{11.69}{in}) or US
+ letter size (\SI{21.6}{cm}~$\times$~\SI{27.9}{cm}; \SI{8.5}{in}~$\times$~\SI{11.0}{in}) paper.
+ \item Single-spaced text in two columns of \SI{82.5}{mm} (\SI{3.25}{in}) with \SI{5.3}{mm}
+ (\SI{0.2}{in}) separation. More recent versions of Microsoft Word have a default spacing of 1.5 lines;
+ authors must change this to 1 line.
+ \item The text located within the margins specified in Table~\ref{l2ea4-t1}.
+\end{Itemize}
+\begin{table}[!hbt]
+ \centering
+ \caption{Margin Specifications}
+ \begin{tabular}{lcc}
+ \toprule
+ \textbf{Margin} & \textbf{A4 Paper} & \textbf{US Letter Paper} \\
+ \midrule
+ Top & \SI{37}{mm} (\SI{1.46}{in}) & \SI{0.75}{in} (\SI{19}{mm}) \\ %[3pt]
+ Bottom & \SI{19}{mm} (\SI{0.75}{in}) & \SI{0.75}{in} (\SI{19}{mm}) \\ %[3pt]
+ Left & \SI{20}{mm} (\SI{0.79}{in}) & \SI{0.79}{in} (\SI{20}{mm}) \\ %[3pt]
+ Right & \SI{20}{mm} (\SI{0.79}{in}) & \SI{1.02}{in} (\SI{26}{mm}) \\
+ \bottomrule
+ \end{tabular}
+ \label{tab:margins}
+\end{table}
+
+\subsection{Fonts}
+
+In order to produce good Adobe Acrobat PDF files, authors
+using the `jacow' \LaTeX{} template are asked to use only the fonts
+defined in the ‘jacow’ class file (v2.3 of 2019/01/15) in standard,
+bold (i.\,e., \verb|\textbf|) or italic (i.\,e., \verb|\textit|) form and
+symbols from the standard set of fonts. In Word use only
+Symbol and, depending on your platform, Times or Times New Roman
+fonts in standard, bold or italic form.
+
+The layout of the text on the page is illustrated in
+Fig.~\ref{fig:paper_layout}. Note that the paper’s title and the author list should
+be the width of the full page. Tables and figures may span
+the whole \SI{170}{mm} page width, if desired (see Fig.~\ref{fig:jacow_team}), but
+if they span both columns, they should be placed at either
+the top or bottom of a page to ensure proper flow of the
+text (which should flow from top to bottom in each column).
+
+\begin{figure}[!htb]
+ \centering
+ \includegraphics*[width=.7\columnwidth]{JACpic_mc}
+ \caption{Layout of papers.}
+ \label{fig:paper_layout}
+\end{figure}
+
+\begin{figure*}[!tbh]
+ \centering
+ \includegraphics*[width=\textwidth]{JACpic2}
+
+ \caption{Example of a full-width figure showing the JACoW Team at their annual
+ meeting in December 2018. This figure has a multi-line caption that has to be
+ justified rather than centred.}
+ \label{fig:jacow_team}
+\end{figure*}
+
+\subsection{Title and Author List}
+
+The title should use \SI{14}{pt} bold uppercase letters and be centred on the page.
+Individual letters may be lowercased to avoid misinterpretation (e.\,g., mW, GeV,
+SPring-8, SwissFEL).
+To include a funding support statement, put an asterisk after the title and
+the support text at the bottom of the first column on page~1---in Word,
+use a text box; in \LaTeX, use $\backslash$\texttt{thanks}. See also the
+subsection on footnotes.
+
+The names of authors, their organizations/affiliations and
+postal addresses should be grouped by affiliation and
+listed in \SI{12}{pt} upper- and lowercase letters. The name of
+the submitting or primary author should be first, followed
+by the coauthors, alphabetically by affiliation. Where
+authors have multiple affiliations, the secondary affiliation
+may be indicated with a superscript, as shown in the
+author listing of this paper. See \textbf{ANNEX~A} for further examples.
+
+\subsection{Section Headings}
+
+Section headings should not be numbered. They should
+use \SI{12}{pt} bold uppercase letters and be centred in the
+column. All section headings should appear directly above
+the text---there should never be a column break between a heading and the
+following paragraph.
+
+\subsection{Subsection Headings}
+
+Subsection headings should not be numbered.
+They should use \SI{12}{pt} italic letters and be left aligned in the column.
+Subsection headings use Title Case (or Initial Caps)
+and should appear directly above the text---there should never be a column break
+between a subheading and the following paragraph.
+
+\subsubsection{Third-level Headings} These should use \SI{10}{pt} bold
+letters and be run into the paragraph text. In \LaTeX{} these headings are
+created with \LaTeX's \verb|\subsubsection| command.
+In the Word templates authors must bold the heading text themselves.
+This heading should be used sparingly. See Table~\ref{tab:styles}
+for its style details.
+
+\subsection{Paragraph Text}
+
+Paragraphs should use \SI{10}{pt} font and be justified (touch each side) in
+the column. The beginning of each paragraph should be indented
+approximately \SI{0.33}{cm} (\SI{0.13}{in}). The last line of a paragraph should not be
+printed by itself at the beginning of a column nor should the first line of
+a paragraph be printed by itself at the end of a column.
+
+\subsection{Figures, Tables and Equations}
+
+Place figures and tables as close to their place of mention as
+possible. Lettering in figures and tables should be large enough to
+reproduce clearly. Use of non-approved fonts in figures can lead to
+problems when the files are processed. \LaTeX{} users should be sure to use
+non-bitmapped versions of Computer Modern fonts in equations (Type\,1 PostScript
+or OpenType fonts are required. Their use is described in the help
+pages of the JACoW website\cite{jacow-help}).
+
+Each figure and table must be numbered in ascending
+order (1, 2, 3, etc.) throughout the paper.
+Figure captions are placed below figures, and table
+captions are placed above tables.
+
+Figure captions are formatted as shown in Figs.~\ref{fig:paper_layout} and \ref{fig:jacow_team},
+while table captions take the form of a heading,
+with initial letters of principle words, capitalized, and
+without a period at the end (see Tables~\ref{tab:margins} and~\ref{tab:styles}).
+Any reference to the contents of the table should be made from
+the body of the paper rather than from within the table
+caption itself.
+
+Single-line captions are centred in the column, while captions
+that span more than one line should be justified.
+The \LaTeX{} template uses the ‘booktabs’ package to
+format tables.
+
+When referring to a figure from within the text, the
+convention is to use the abbreviated form [e.\,g., Fig.~1]
+\emph{unless} the reference is at the start of the sentence, in
+which case “Figure” is written in full. Reference to a
+table, however, is never abbreviated [e.\,g., Table~1].
+
+
+If a displayed equation needs a number (i.\,e., it will be
+referenced), place it in parentheses, and flush with the
+right margin of the column. The equation itself should be
+indented and centred, as far as is possible:
+\begin{equation}\label{eq:label}
+ C_B=\frac{q^3}{3\epsilon_{0} mc}=\SI{3.54}{\micro eV/T}
+\end{equation}
+
+When referencing a numbered equation, use the word
+“Equation” at the start of a sentence, and the abbreviated
+form, “Eq.”, if in the text. The equation number is placed
+in parentheses [e.\,g., Eq.~\eqref{eq:label}], which can be
+achieved in \LaTeX{} using \verb|\eqref{eq:label}|.
+
+\subsection{Units}
+
+Units should be written using the standard, roman font,
+not the italic font, as shown in Eq.~\eqref{eq:label}.
+An unbreakable space should precede a unit (in \LaTeX{} use a “\verb|\,|”,
+the template uses the ‘siunitx’ package to format units).
+Some examples are: \SI{3}{keV},
+\SI{100}{kW}, \SI{7}{µm}. When a unit appears in a hyphenated,
+compound adjective that precedes a noun, it takes on the
+singular form, e.\,g., the 3.8-metre long undulator.
+
+\subsection{References}
+%
+% References examples given here are not formatted using \cite as there
+% are only reference numbers [1] and [2] in the template
+%
+All bibliographical and web references should be numbered and listed at the
+end of the paper in a section called \textbf{REFERENCES}. When citing a
+reference in the text, place the corresponding reference number in square
+brackets~[1]. The reference citations in the text should be numbered
+in ascending order. Multiple citations should appear in
+the same bracket~[3, 4] and
+with ranges where appropriate~[1--4, 10].
+
+A URL or DOI may be included as part of a reference, but its
+hyperlink should NOT be added. The usual practice is to
+use a monospaced font for the URL so as to help distinguish
+it from normal text. In \LaTeX{} the ‘url’ package is used with its
+default font now being switched to ``newtxtt'' which offers
+a better distinction between ``\texttt{O}'' and ``\texttt{0}''.
+
+For authors to properly cite the resources used when researching
+their papers is an obligation. In the interest of
+promoting uniformity and complete citations, the IEEE
+Editorial Style for Transactions and Journals, which itself
+adheres to the Chicago Manual of Style, has been adopted~\cite{IEEE}.
+When citing a periodical, the official abbreviation of the journal
+should be used\cite{journal-abbreviations}.
+Please consult the appended material, \textbf{ANNEX~B},
+for details. The onus is on authors to pay attention to
+the details of the said style to ensure complete, accurate
+and properly formatted references.
+
+ \begin{table}[h!b]
+ \setlength\tabcolsep{3.5pt}
+ \centering
+ \caption{Summary of Styles}
+ \label{tab:styles}
+ \begin{tabular}{llcc}
+ \toprule
+ \textbf{Style} & \textbf{Font} & \textbf{Space} & \textbf{Space} \\
+ & & \textbf{Before} & \textbf{After} \\
+ \midrule
+ \textbf{PAPER} & \SI{14}{pt} & \SI{0}{pt} & \SI{3}{pt} \\
+ \textbf{TITLE} & \textbf{UPPERCASE} & & \\
+ & \textbf{EXCEPT FOR} & & \\
+ & \textbf{REQUIRED lowercase} & & \\
+ & \textbf{letters} & & \\
+ & \textbf{Bold} & & \\[5pt]
+ %\midrule
+ Author list & \SI{12}{pt} & \SI{9}{pt} & \SI{12}{pt} \\
+ & UPPER- and lowercase & & \\[5pt]
+ %\midrule
+ \textit{Abstract} & \SI{12}{pt} & \SI{0}{pt} & \SI{3}{pt} \\
+ \textit{Title} & \textit{Initial Caps} & & \\
+ & \textit{Italic} & & \\[5pt]
+ %\midrule
+ \textbf{Section} & \SI{12}{pt} & \SI{9}{pt} & \SI{3}{pt} \\
+ \textbf{Heading} & \textbf{UPPERCASE} & & \\
+ & \textbf{bold} & & \\[5pt]
+ %\midrule
+ \textit{Subsection} & \SI{12}{pt} & \SI{6}{pt} & \SI{3}{pt} \\
+ \textit{Heading}
+ & \textit{Initial Caps} & & \\
+ & \textit{Italic} & & \\[5pt]
+ %\midrule
+ \textbf{Third-level} & \SI{10}{pt} & \SI{6}{pt} & \SI{0}{pt} \\
+ \textbf{Heading}
+ & \textbf{Initial Caps} & & \\
+ & \textbf{Bold} & & \\[5pt]
+ %\midrule
+ Figure & \SI{10}{pt} & \SI{3}{pt} & $\ge$\SI{3}{pt} \\
+ Captions & & & \\[5pt]
+ %\midrule
+ Table & \SI{10}{pt} & $\ge$\SI{3}{pt} & \SI{3}{pt} \\
+ Captions & & & \\[5pt]
+ %\midrule
+ Equations & \SI{10}{pt} base font & $\ge$\SI{6}{pt} & $\ge$\SI{6}{pt} \\[5pt]
+ %\midrule
+ References & \SI{9}{pt} & \SI{0}{pt} & \SI{3}{pt} \\
+ when $\le9$ & \verb|\bibliography{9}| & & \\[5pt]
+ Refs. $\ge10$ & \SI{9}{pt} & \SI{0}{pt} & \SI{3}{pt} \\
+ & \verb|\bibliography{99}| & & \\
+ \bottomrule %\SI{0.25}{in}
+ \end{tabular}
+\end{table}
+
+\subsection{Footnotes}
+
+Footnotes on the title and author lines may be used for acknowledgements
+and e-mail addresses. A non-numeric sequence of characters (*, \#,
+\dag, \ddag, \P) should be used to indicate the footnote.
+These “pseudo footnotes” should only
+appear at the bottom of the first column on the first page.
+
+Any other footnote in the body of the paper should
+use the normal numeric sequencing (i.\,e., 1, 2, 3)
+and appear at the bottom of the same column in which
+it is used. All footnotes are of 8pt font size.
+
+\subsection{Acronyms}
+
+Acronyms should be defined the first time they appear,
+both in the abstract and in the rest of the paper.
+
+\section{STYLES}
+
+Table~\ref{tab:styles} summarizes the fonts and spacing used in the styles of
+a JACoW template. In \LaTeX, these
+are implemented in the ‘jacow’ class file.
+
+\section{PAGE NUMBERS}
+
+\textbf{DO NOT include any page numbers}. They will be added
+when the final proceedings are produced.
+
+\section{TEMPLATES}
+
+Template documents for the recommended word processing
+software are available from the JACoW website~\cite{jacow-help}
+and exist for \LaTeX, Microsoft Word (Mac and PC)
+and LibreOffice/Apache OpenOffice for US letter and A4
+paper sizes. Use the correct template for your paper size and
+platform.
+
+Fonts are embedded by default with pdf\LaTeX. Using \LaTeX{} with `dvips',
+make sure that `ps2pdf' has the option \texttt{-dEmbedAllFonts=true}'.
+Fonts of included figure graphics in PDF or EPS are often not embedded.
+So make sure that this done when generating them or reprocess them
+in `Ghostscript' with the switch \texttt{-dEmbedAllFonts=true}' set.
+
+\flushcolsend
+
+\section{CHECKLIST FOR ELECTRONIC PUBLICATION}
+Authors are requested to go over the following checklist for electronic publication:
+\begin{Itemize}
+ \item Use only Times or Times New Roman (standard, bold or italic) and Symbol
+ fonts for text, \SI{10}{pt} except references, which should be \SI{9}{pt}.
+
+ \item Figures should use Times or Times New Roman (standard, bold or italic) and
+ Symbol fonts when possible---\SI{6}{pt} minimum, with fonts embedded.
+ \item Check that citations to references appear in sequential order and
+ that all references are cited.
+ \item Check that the PDF file prints correctly.
+ \item Check that there are no page numbers.
+ \item Check that the margins on the printed version are within \SI{\pm1}{mm}
+ of the specifications.
+ \item \LaTeX{} users can check their margins by invoking the
+ \texttt{boxit} option.
+\end{Itemize}
+
+Please also check the list of common oversights which can be found in \textbf{ANNEX C}.
+
+\section{CONCLUSION}
+
+Any conclusions should be in a separate section directly preceding
+the \textbf{ACKNOWLEDGEMENTS}, \textbf{APPENDIX}, or \textbf{REFERENCES} sections, in that
+order.
+
+\section{ACKNOWLEDGEMENTS}
+Any acknowledgement should be in a separate section directly preceding
+the \textbf{REFERENCES} or \textbf{APPENDIX} section.
+
+
+\section{APPENDIX}
+Any appendix should be in a separate section directly preceding
+the \textbf{REFERENCES} section. If there is no \textbf{REFERENCES} section,
+this should be the last section of the paper.
+
+%
+% only for "biblatex"
+%
+\ifboolexpr{bool{jacowbiblatex}}%
+ {\printbibliography}%
+ {%
+ % "biblatex" is not used, go the "manual" way
+
+ %\begin{thebibliography}{99} % Use for 10-99 references
+ \begin{thebibliography}{9} % Use for 1-9 references
+
+ \bibitem{jacow-help}
+ JACoW,
+ \url{http://www.jacow.org}
+
+ \bibitem{IEEE}
+ \textit{IEEE Editorial Style Manual},
+ IEEE Periodicals, Piscataway,
+ NJ, USA, Oct. 2014, pp. 34--52.
+
+ \bibitem{journal-abbreviations}
+ \url{https://woodward.library.ubc.ca/researchhelp/journal-abbreviations/}
+
+ \end{thebibliography}
+} % end \ifboolexpr
+%
+% for use as JACoW template the inclusion of the ANNEX parts have been commented out
+% to generate the complete documentation please remove the "%" of the next two commands
+%
+%%%\newpage
+
+%%%\include{annexes-A4}
+
+\end{document}
diff --git a/macros/latex/contrib/jacow/JACoW_LaTeX_Letter.pdf b/macros/latex/contrib/jacow/JACoW_LaTeX_Letter.pdf
new file mode 100644
index 0000000000..50dab6fe47
--- /dev/null
+++ b/macros/latex/contrib/jacow/JACoW_LaTeX_Letter.pdf
Binary files differ
diff --git a/macros/latex/contrib/jacow/JACoW_LaTeX_Letter.tex b/macros/latex/contrib/jacow/JACoW_LaTeX_Letter.tex
new file mode 100644
index 0000000000..1513cfabae
--- /dev/null
+++ b/macros/latex/contrib/jacow/JACoW_LaTeX_Letter.tex
@@ -0,0 +1,488 @@
+% !TeX spellcheck = en_US
+%
+%
+% v 2.3 Feb 2019 Volker RW Schaa
+% # changes in the collaboration therefore updated file "jacow-collaboration.tex"
+% # all References with DOIs have their period/full stop before the DOI (after pp. or year)
+% # in the author/affiliation block all ZIP codes in square brackets removed as it was not
+% understood as optional parameter and ZIP codes had bin put in brackets
+% # References to the current IPAC are changed to "IPAC'19, Melbourne, Australia"
+% # font for "url" style changed to "newtxtt" as it is easier to distinguish "O" and "0"
+%
+\documentclass[letter,
+ %boxit, % check whether paper is inside correct margins
+ %titlepage, % separate title page
+ %refpage % separate references
+ %biblatex, % biblatex is used
+ keeplastbox, % flushend option: not to un-indent last line in References
+ %nospread, % flushend option: do not fill with whitespace to balance columns
+ %hyphens, % allow \url to hyphenate at "-" (hyphens)
+ %xetex, % use XeLaTeX to process the file
+ %luatex, % use LuaLaTeX to process the file
+ ]{jacow}
+%
+% ONLY FOR \footnote in table/tabular
+%
+\usepackage{pdfpages,multirow,ragged2e} %
+%
+% CHANGE SEQUENCE OF GRAPHICS EXTENSION TO BE EMBEDDED
+% ----------------------------------------------------
+% test for XeTeX where the sequence is by default eps-> pdf, jpg, png, pdf, ...
+% and the JACoW template provides JACpic2v3.eps and JACpic2v3.jpg which
+% might generates errors, therefore PNG and JPG first
+%
+\makeatletter%
+ \ifboolexpr{bool{xetex}}
+ {\renewcommand{\Gin@extensions}{.pdf,%
+ .png,.jpg,.bmp,.pict,.tif,.psd,.mac,.sga,.tga,.gif,%
+ .eps,.ps,%
+ }}{}
+\makeatother
+
+% CHECK FOR XeTeX/LuaTeX BEFORE DEFINING AN INPUT ENCODING
+% --------------------------------------------------------
+% utf8 is default for XeTeX/LuaTeX
+% utf8 in LaTeX only realises a small portion of codes
+%
+\ifboolexpr{bool{xetex} or bool{luatex}} % test for XeTeX/LuaTeX
+ {} % input encoding is utf8 by default
+ {\usepackage[utf8]{inputenc}} % switch to utf8
+
+\usepackage[USenglish]{babel}
+
+
+%
+% if BibLaTeX is used
+%
+\ifboolexpr{bool{jacowbiblatex}}%
+ {%
+ \addbibresource{jacow-test.bib}
+ \addbibresource{biblatex-examples.bib}
+ }{}
+\listfiles
+
+%%
+%% Lengths for the spaces in the title
+%% \setlength\titleblockstartskip{..} %before title, default 3pt
+%% \setlength\titleblockmiddleskip{..} %between title + author, default 1em
+%% \setlength\titleblockendskip{..} %afterauthor, default 1em
+
+\begin{document}
+
+\title{preparation OF papers for \NoCaseChange{JACoW} conferences\thanks{Work supported by ...}}
+
+\author{A. N. Author\thanks{email address}, H. Coauthor, Name of Institute or Affiliation, City, Country \\
+ P. Contributor\textsuperscript{1}, Name of Institute or Affiliation, City, Country \\
+ \textsuperscript{1}also at Name of Secondary Institute or Affiliation, City, Country}
+
+\maketitle
+
+%
+\begin{abstract}
+ Many conference series have adopted the same standards
+ for electronic publication and have joined the Joint
+ Accelerator Conferences Website (JACoW) collaboration
+ for the publication of their proceedings. This document
+ describes the common requirements for the submission of
+ papers to these conferences. Please consult individual
+ conference information for page limits, method of electronic
+ submission, etc. It is not intended that this should
+ be a tutorial in word processing; the aim is to explain the
+ particular requirements for electronic publication at
+ www.JACoW.org. The abstract itself is to act as a stand-alone
+ entity and, as such, should not include citations. Any acronyms
+ should be expanded on their first occurrence, both in the
+ abstract and in the rest of the paper.
+ The abstract itself is to act as a stand-alone entity and,
+ as such, should not include citations. Any acronyms should
+ be expanded on their first occurrence, both in the abstract
+ and in the rest of the paper.
+\end{abstract}
+
+
+\section{SUBMISSION OF PAPERS}
+Each author should submit the PDF file and all source
+files (text and figures) to enable the paper to be
+reconstructed if there are processing difficulties.
+
+\section{MANUSCRIPTS}
+Templates are provided for recommended software and
+authors are advised to use them. Please consult the
+individual conference help pages if questions arise.
+
+\subsection{General Layout}
+
+These instructions are a typical implementation of the
+requirements. Manuscripts should have:
+\begin{Itemize}
+ \item Either A4 (\SI{21.0}{cm}~$\times$~\SI{29.7}{cm}; \SI{8.27}{in}~$\times$~\SI{11.69}{in}) or US
+ letter size (\SI{21.6}{cm}~$\times$~\SI{27.9}{cm}; \SI{8.5}{in}~$\times$~\SI{11.0}{in}) paper.
+ \item Single-spaced text in two columns of \SI{82.5}{mm} (\SI{3.25}{in}) with \SI{5.3}{mm}
+ (\SI{0.2}{in}) separation. More recent versions of Microsoft Word have a default spacing of 1.5 lines;
+ authors must change this to 1 line.
+ \item The text located within the margins specified in Table~\ref{tab:margins}.
+\end{Itemize}
+\begin{table}[!hbt]
+ \centering
+ \caption{Margin Specifications}
+ \begin{tabular}{lcc}
+ \toprule
+ \textbf{Margin} & \textbf{A4 Paper} & \textbf{US Letter Paper} \\
+ \midrule
+ Top & \SI{37}{mm} (\SI{1.46}{in}) & \SI{0.75}{in} (\SI{19}{mm}) \\ %[3pt]
+ Bottom & \SI{19}{mm} (\SI{0.75}{in}) & \SI{0.75}{in} (\SI{19}{mm}) \\ %[3pt]
+ Left & \SI{20}{mm} (\SI{0.79}{in}) & \SI{0.79}{in} (\SI{20}{mm}) \\ %[3pt]
+ Right & \SI{20}{mm} (\SI{0.79}{in}) & \SI{1.02}{in} (\SI{26}{mm}) \\
+ \bottomrule
+ \end{tabular}
+ \label{tab:margins}
+\end{table}
+
+\subsection{Fonts}
+
+In order to produce good Adobe Acrobat PDF files, authors
+using the `jacow' \LaTeX{} template are asked to use only the fonts
+defined in the `jacow' class file (v2.3 of 2019/01/15) in standard,
+bold (i.\,e., \verb|\textbf|) or italic (i.\,e., \verb|\textit|) form and
+symbols from the standard set of fonts. In Word use only
+Symbol and, depending on your platform, Times or Times New Roman
+fonts in standard, bold or italic form.
+
+The layout of the text on the page is illustrated in
+Fig.~\ref{fig:paper_layout}. Note that the paper's title and the author list should
+be the width of the full page. Tables and figures may span
+the whole \SI{170}{mm} page width, if desired (see Fig.~\ref{fig:jacow_team}), but
+if they span both columns, they should be placed at either
+the top or bottom of a page to ensure proper flow of the
+text (which should flow from top to bottom in each column).
+
+\begin{figure}[!htb]
+ \centering
+ \includegraphics*[width=.7\columnwidth]{JACpic_mc}
+ \caption{Layout of papers.}
+ \label{fig:paper_layout}
+\end{figure}
+
+\begin{figure*}[!tbh]
+ \centering
+ \includegraphics*[width=\textwidth]{JACpic2}
+
+ \caption{Example of a full-width figure showing the JACoW Team at their annual
+ meeting in December 2018. This figure has a multi-line caption that has to be
+ justified rather than centred.} %US
+ \label{fig:jacow_team}
+\end{figure*}
+
+\subsection{Title and Author List}
+
+The title should use \SI{14}{pt} bold uppercase letters and be centred on the page.
+Individual letters may be lowercased to avoid misinterpretation (e.\,g., mW, GeV,
+SPring-8, SwissFEL).
+To include a funding support statement, put an asterisk after the title and
+the support text at the bottom of the first column on page~1---in Word,
+use a text box; in \LaTeX, use $\backslash$\texttt{thanks}. See also the
+subsection on footnotes.
+
+The names of authors, their organizations/affiliations and
+postal addresses should be grouped by affiliation and
+listed in \SI{12}{pt} upper- and lowercase letters. The name of
+the submitting or primary author should be first, followed
+by the coauthors, alphabetically by affiliation. Where
+authors have multiple affiliations, the secondary affiliation
+may be indicated with a superscript, as shown in the
+author listing of this paper. See \textbf{ANNEX~A} for further examples.
+
+\subsection{Section Headings}
+
+Section headings should not be numbered. They should
+use \SI{12}{pt} bold uppercase letters and be centered in the
+column. All section headings should appear directly above
+the text---there should never be a column break between a heading and the
+following paragraph.
+
+\subsection{Subsection Headings}
+
+Subsection headings should not be numbered.
+They should use \SI{12}{pt} italic letters and be left aligned in the column.
+Subsection headings use Title Case (or Initial Caps)
+and should appear directly above the text---there should never be a column break
+between a subheading and the following paragraph.
+
+\subsubsection{Third-level Headings} These should use \SI{10}{pt} bold
+letters and be run into the paragraph text. In \LaTeX{} these headings are
+created with \LaTeX's \verb|\subsubsection| command.
+In the Word templates authors must bold the heading text themselves.
+This heading should be used sparingly. See Table~\ref{tab:styles}
+for its style details.
+
+\subsection{Paragraph Text}
+
+Paragraphs should use \SI{10}{pt} font and be justified (touch each side) in
+the column. The beginning of each paragraph should be indented
+approximately \SI{0.33}{cm} (\SI{0.13}{in}). The last line of a paragraph should not be
+printed by itself at the beginning of a column nor should the first line of
+a paragraph be printed by itself at the end of a column.
+
+\subsection{Figures, Tables, and Equations}
+
+Place figures and tables as close to their place of mention as
+possible. Lettering in figures and tables should be large enough to
+reproduce clearly. Use of non-approved fonts in figures can lead to
+problems when the files are processed. \LaTeX{} users should be sure to use
+non-bitmapped versions of Computer Modern fonts in equations (Type\,1 PostScript
+or OpenType fonts are required. Their use is described in the help
+pages of the JACoW website\cite{jacow-help}).
+
+Each figure and table must be numbered in ascending
+order (1, 2, 3, etc.) throughout the paper.
+Figure captions are placed below figures, and table
+captions are placed above tables.
+
+Figure captions are formatted as shown in Figs.~\ref{fig:paper_layout} and \ref{fig:jacow_team},
+while table captions take the form of a heading,
+with initial letters of principle words, capitalized, and
+without a period at the end (see Tables~\ref{tab:margins} and~\ref{tab:styles}).
+Any reference to the contents of the table should be made from
+the body of the paper rather than from within the table
+caption itself.
+
+Single-line captions are centered in the column, while captions
+that span more than one line should be justified.
+The \LaTeX{} template uses the “booktabs” package to
+format tables.
+
+When referring to a figure from within the text, the
+convention is to use the abbreviated form [e.\,g., Fig.~1]
+\emph{unless} the reference is at the start of the sentence, in
+which case “Figure” is written in full. Reference to a
+table, however, is never abbreviated [e.\,g., Table~1].
+
+
+If a displayed equation needs a number (i.\,e., it will be
+referenced), place it in parentheses, and flush with the
+right margin of the column. The equation itself should be
+indented and centered, as far as is possible:
+\begin{equation}\label{eq:label}
+ C_B=\frac{q^3}{3\epsilon_{0} mc}=\SI{3.54}{\micro eV/T}
+\end{equation}
+
+When referencing a numbered equation, use the word
+“Equation” at the start of a sentence, and the abbreviated
+form, “Eq.”, if in the text. The equation number is placed
+in parentheses [e.\,g., Eq.~\eqref{eq:label}], which can be
+achieved in \LaTeX{} using \verb|\eqref{eq:label}|.
+
+\subsection{Units}
+
+Units should be written using the standard, roman font,
+not the italic font, as shown in Eq.~\eqref{eq:label}.
+An unbreakable space should precede a unit (in \LaTeX{} use a “\verb|\,|”,
+the template uses the “siunitx” package to format units).
+Some examples are: \SI{3}{keV},
+\SI{100}{kW}, \SI{7}{µm}. When a unit appears in a hyphenated,
+compound adjective that precedes a noun, it takes on the
+singular form, e.\,g., the 3.8-meter long undulator.
+
+\subsection{References}
+%
+% References examples given here are not formatted using \cite as there
+% are only reference numbers [1] and [2] in the template
+%
+All bibliographical and web references should be numbered and listed at the
+end of the paper in a section called \textbf{REFERENCES}. When citing a
+reference in the text, place the corresponding reference number in square
+brackets~[1]. The reference citations in the text should be numbered
+in ascending order. Multiple citations should appear in
+the same bracket~[3, 4] and
+with ranges where appropriate~[1--4, 10].
+
+A URL or DOI may be included as part of a reference, but its
+hyperlink should NOT be added. The usual practice is to
+use a monospaced font for the URL so as to help distinguish
+it from normal text. In \LaTeX{} the “url” package is used with its
+default font now being switched to ``newtxtt'' which offers
+a better distinction between ``\texttt{O}'' and ``\texttt{0}''.
+
+For authors to properly cite the resources used when researching
+their papers is an obligation. In the interest of
+promoting uniformity and complete citations, the IEEE
+Editorial Style for Transactions and Journals, which itself
+adheres to the Chicago Manual of Style, has been adopted~\cite{IEEE}.
+When citing a periodical, the official abbreviation of the journal
+should be used\cite{journal-abbreviations}.
+Please consult the appended material, \textbf{ANNEX~B},
+for details. The onus is on authors to pay attention to
+the details of the said style to ensure complete, accurate
+and properly formatted references.
+
+ \begin{table}[h!b]
+ \setlength\tabcolsep{3.5pt}
+ \centering
+ \caption{Summary of Styles}
+ \label{tab:styles}
+ \begin{tabular}{llcc}
+ \toprule
+ \textbf{Style} & \textbf{Font} & \textbf{Space} & \textbf{Space} \\
+ & & \textbf{Before} & \textbf{After} \\
+ \midrule
+ \textbf{PAPER} & \SI{14}{pt} & \SI{0}{pt} & \SI{3}{pt} \\
+ \textbf{TITLE} & \textbf{UPPERCASE} & & \\
+ & \textbf{EXCEPT FOR} & & \\
+ & \textbf{REQUIRED lowercase} & & \\
+ & \textbf{letters} & & \\
+ & \textbf{Bold} & & \\[5pt]
+ %\midrule
+ Author list & \SI{12}{pt} & \SI{9}{pt} & \SI{12}{pt} \\
+ & UPPER- and lowercase & & \\[5pt]
+ %\midrule
+ \textit{Abstract} & \SI{12}{pt} & \SI{0}{pt} & \SI{3}{pt} \\
+ \textit{Title} & \textit{Initial Caps} & & \\
+ & \textit{Italic} & & \\[5pt]
+ %\midrule
+ \textbf{Section} & \SI{12}{pt} & \SI{9}{pt} & \SI{3}{pt} \\
+ \textbf{Heading} & \textbf{UPPERCASE} & & \\
+ & \textbf{bold} & & \\[5pt]
+ %\midrule
+ \textit{Subsection} & \SI{12}{pt} & \SI{6}{pt} & \SI{3}{pt} \\
+ \textit{Heading}
+ & \textit{Initial Caps} & & \\
+ & \textit{Italic} & & \\[5pt]
+ %\midrule
+ \textbf{Third-level} & \SI{10}{pt} & \SI{6}{pt} & \SI{0}{pt} \\
+ \textbf{Heading}
+ & \textbf{Initial Caps} & & \\
+ & \textbf{Bold} & & \\[5pt]
+ %\midrule
+ Figure & \SI{10}{pt} & \SI{3}{pt} & $\ge$\SI{3}{pt} \\
+ Captions & & & \\[5pt]
+ %\midrule
+ Table & \SI{10}{pt} & $\ge$\SI{3}{pt} & \SI{3}{pt} \\
+ Captions & & & \\[5pt]
+ %\midrule
+ Equations & \SI{10}{pt} base font & $\ge$\SI{6}{pt} & $\ge$\SI{6}{pt} \\[5pt]
+ %\midrule
+ References & \SI{9}{pt} & \SI{0}{pt} & \SI{3}{pt} \\
+ when $\le9$ & \verb|\bibliography{9}| & & \\[5pt]
+ Refs. $\ge10$ & \SI{9}{pt} & \SI{0}{pt} & \SI{3}{pt} \\
+ & \verb|\bibliography{99}| & & \\
+ \bottomrule %\SI{0.25}{in}
+ \end{tabular}
+\end{table}
+
+\subsection{Footnotes}
+
+Footnotes on the title and author lines may be used for acknowledgments
+and e-mail addresses. A non-numeric sequence of characters (*, \#,
+\dag, \ddag, \P) should be used to indicate the footnote.
+These “pseudo footnotes” should only
+appear at the bottom of the first column on the first page.
+
+Any other footnote in the body of the paper should
+use the normal numeric sequencing (i.\,e., 1, 2, 3)
+and appear at the bottom of the same column in which
+it is used. All footnotes are of 8pt font size.
+
+\subsection{Acronyms}
+
+Acronyms should be defined the first time they appear,
+both in the abstract and in the rest of the paper.
+
+\section{STYLES}
+
+Table~\ref{tab:styles} summarizes the fonts and spacing used in the styles of
+a JACoW template. In \LaTeX, these
+are implemented in the “jacow” class file.
+
+\section{PAGE NUMBERS}
+
+\textbf{DO NOT include any page numbers}. They will be added
+when the final proceedings are produced.
+
+\section{TEMPLATES}
+
+Template documents for the recommended word processing
+software are available from the JACoW website~\cite{jacow-help}
+and exist for \LaTeX, Microsoft Word (Mac and PC)
+and LibreOffice/Apache OpenOffice for US letter and A4
+paper sizes. Use the correct template for your paper size and
+platform.
+
+Fonts are embedded by default with pdf\LaTeX. Using \LaTeX{} with `dvips',
+make sure that `ps2pdf' has the option \texttt{-dEmbedAllFonts=true}'.
+Fonts of included figure graphics in PDF or EPS are often not embedded.
+So make sure that this done when generating them or reprocess them
+in `Ghostscript' with the switch \texttt{-dEmbedAllFonts=true}' set.
+
+\flushcolsend
+
+\section{CHECKLIST FOR ELECTRONIC PUBLICATION}
+Authors are requested to go over the following checklist for electronic publication:
+\begin{Itemize}
+ \item Use only Times or Times New Roman (standard, bold or italic) and Symbol
+ fonts for text, \SI{10}{pt} except references, which should be \SI{9}{pt}.
+
+ \item Figures should use Times or Times New Roman (standard, bold or italic) and
+ Symbol fonts when possible---\SI{6}{pt} minimum, with fonts embedded.
+ \item Check that citations to references appear in sequential order and
+ that all references are cited.
+ \item Check that the PDF file prints correctly.
+ \item Check that there are no page numbers.
+ \item Check that the margins on the printed version are within \SI{\pm1}{mm}
+ of the specifications.
+ \item \LaTeX{} users can check their margins by invoking the
+ \texttt{boxit} option.
+\end{Itemize}
+
+Please also check the list of common oversights which can be found in \textbf{ANNEX C}.
+
+\section{CONCLUSION}
+
+Any conclusions should be in a separate section directly preceding
+the \textbf{ACKNOWLEDGMENTS}, \textbf{APPENDIX}, or \textbf{REFERENCES} sections, in that
+order.
+
+\section{ACKNOWLEDGMENTS}
+Any acknowledgement should be in a separate section directly preceding
+the \textbf{REFERENCES} or \textbf{APPENDIX} section.
+
+
+\section{APPENDIX}
+Any appendix should be in a separate section directly preceding
+the \textbf{REFERENCES} section. If there is no \textbf{REFERENCES} section,
+this should be the last section of the paper.
+
+%
+% only for "biblatex"
+%
+\ifboolexpr{bool{jacowbiblatex}}%
+ {\printbibliography}%
+ {%
+ % "biblatex" is not used, go the "manual" way
+
+ %\begin{thebibliography}{99} % Use for 10-99 references
+ \begin{thebibliography}{9} % Use for 1-9 references
+
+ \bibitem{jacow-help}
+ JACoW,
+ \url{http://www.jacow.org}
+
+ \bibitem{IEEE}
+ \textit{IEEE Editorial Style Manual},
+ IEEE Periodicals, Piscataway,
+ NJ, USA, Oct. 2014, pp. 34--52.
+
+ \bibitem{journal-abbreviations}
+ \url{https://woodward.library.ubc.ca/researchhelp/journal-abbreviations/}
+
+ \end{thebibliography}
+} % end \ifboolexpr
+
+%
+% for use as JACoW template the inclusion of the ANNEX parts have been commented out
+% to generate the complete documentation please remove the "%" of the next two commands
+%
+%%%%\newpage
+
+%%%%\include{annexes-Letter}
+
+\end{document}
diff --git a/macros/latex/contrib/jacow/JACpic2.jpg b/macros/latex/contrib/jacow/JACpic2.jpg
new file mode 100644
index 0000000000..dc611f7918
--- /dev/null
+++ b/macros/latex/contrib/jacow/JACpic2.jpg
Binary files differ
diff --git a/macros/latex/contrib/jacow/JACpic_mc.pdf b/macros/latex/contrib/jacow/JACpic_mc.pdf
new file mode 100644
index 0000000000..dfa6077adb
--- /dev/null
+++ b/macros/latex/contrib/jacow/JACpic_mc.pdf
Binary files differ
diff --git a/macros/latex/contrib/jacow/README b/macros/latex/contrib/jacow/README
new file mode 100644
index 0000000000..1680a41447
--- /dev/null
+++ b/macros/latex/contrib/jacow/README
@@ -0,0 +1,65 @@
+###########################################################################
+############ jacow.cls ############
+###########################################################################
+
+Class File: jacow.cls
+Authors: John Jowett (CERN), Michel Goossens (CERN),
+ Martin Comyn (TRIUMF), John Poole (CERN), Todd Satogata (BNL),
+ Ulrike Fischer, Volker RW Schaa (GSI)
+Version: 2.4
+Date: 01 April 2019
+Copyright: 1996-2019 by JACoW, Geneva, Switzerland
+Homepage: http://www.jacow.org
+License: LPPL 1.3c
+Status: Maintained
+Maintainer: Volker RW Schaa
+
+###########################################################################
+############ A BRIEF DESCRIPTION OF THE PACKAGE ############
+###########################################################################
+
+Many conference series have adopted the same standards for electronic
+publication and have joined the Joint Accelerator Conferences Website
+(JACoW) collaboration for the publication of their proceedings.
+
+The "jacow.cls" class is used for submissions to the proceedings in LaTeX
+in one of the 19 conferences in this series. The documents in this package
+describe the common requirements for the submission of papers to these
+conferences. Please consult individual conference information for page
+limits, method of electronic submission, etc. It is not intended that
+this should be a tutorial in word processing; the aim is to explain the
+particular requirements for electronic publication at www.JACoW.org.
+
+The package consists of the following files
+ class file
+ jacow.cls JACoW class file v2.4 of 2019/04/01
+
+ templates
+ JACoW_LaTeX_A4.tex basic A4/letter templates to demonstrate the
+ JACoW_LaTeX_Letter.tex use and explain the various parameters
+ and settings for a submission to a
+ JACoW conference proceedings.
+
+ JACoW_LaTeX_A4.pdf PDF with JACoW class file documentation and examples for
+ A4 with "en_uk" and Letter with en_us specific formatting.
+
+ JACoW_LaTeX_Letter.pdf template in format "letter" and American formatting
+
+ To generate the complete PDF for documentation
+ please remove the "%" of the last two commands
+ in "JACoW_LaTeX_A4/Letter.tex" which include the
+ Annexes A-C of "annexes-A4/Letter.tex"
+
+ annexes-A4.tex Annexes A-C which are included in "JACoW_LaTeX_A4.tex"
+ annexes-Letter.tex Annexes A-C which are included in "JACoW_LaTeX_Letter.tex"
+
+
+ figures/includes
+ JACpic_mc.pdf a graphic showing the JACoW page format
+ (being the smaller side of A4 and letter respectively)
+ JACpic2.jpg a graphic for a full width figure (spanning
+ the two columns and multiline caption) showing
+ the participants of the 2017 JACoW Team Meeting
+
+ jacow-collaboration.tex (an example) title page showing the JACoW Collaboration.
+ jacow-collaboration.pdf This PDF is included in Annex A.
diff --git a/macros/latex/contrib/jacow/annexes-A4.tex b/macros/latex/contrib/jacow/annexes-A4.tex
new file mode 100644
index 0000000000..8c2a72cbd4
--- /dev/null
+++ b/macros/latex/contrib/jacow/annexes-A4.tex
@@ -0,0 +1,544 @@
+%
+% !TeX spellcheck = en_GB
+%
+\twocolumn[\vspace*{-1.8ex}\section{ANNEX A:\endgraf FORMATTING OF AUTHORS AND AFFILIATIONS}\vspace*{\baselineskip}]
+
+\flushcolsend
+
+The names of authors, their organizations/affiliations
+and postal addresses should be grouped by affiliation and
+listed in \SI{12}{pt} upper- and lowercase letters. The name of
+the submitting or primary author should be first, followed
+by the coauthors, alphabetically by affiliation. If the
+author list for a given affiliation spans multiple lines,
+please be sure to break the line in a manner that does not
+split the author’s initials from the author’s last name. This
+is easily done by placing unbreakable spaces between the
+initials and last name. The affiliation name and address
+are also best kept together on the same (but not necessarily
+separate) line, wherever possible. (See, for example,
+the entry for GSI in the following). In cases where authors
+have multiple affiliations, the secondary affiliation is
+inserted below the author/primary affiliation listing and is
+indicated with a superscript, as shown in the following.
+
+
+Footnotes on the title and author lines may be used for
+acknowledgements and e-mail addresses, using a non-numeric
+sequence of characters (\textsuperscript{*}, \textsuperscript{†},
+\textsuperscript{‡}, \textsuperscript{§}, \textsuperscript{\P}
+as generated by \LaTeX's \verb|\footnote| command).
+
+For examples of the preferred formatting of authors and
+affiliations, please consult the following list of JACoW
+collaboration members.
+
+For manuscripts submitted by large collaborations with
+potentially many tens of authors and where, additionally,
+there may be page number limitations, a format consisting
+of the principle author’s name and institute, followed by
+“on behalf of the \ldots\ collaboration”, is preferred.
+
+
+\clearpage
+%
+% Include the title/author page of the JACoW Coolaboration
+%
+\includepdf[pages=-, noautoscale, pagecommand={}]{jacow-collaboration.pdf}{}
+
+\clearpage
+
+\twocolumn[\vspace*{-1.8ex}\section{ANNEX B:\endgraf IEEE REFERENCE STYLE GUIDE AS APPLIED TO \NoCaseChange{JACoW} PAPERS, \break PERIODICALS AND OTHER WORKS}\vspace*{\baselineskip}]
+
+\subsection{Referencing JACoW Proceedings}
+
+The format for published JACoW proceedings papers is detailed in the following
+and can also be readily deduced from Refs.~[1-3]. At the very minimum, sufficient
+information should be given to enable readers to clearly identify the paper and
+to facilitate its import into digital databases.
+\vspace*{-.6\baselineskip}
+
+\subsubsection{Author Listing} Careful attention should be given to the
+placing of commas and the use of ‘and’ in the author list.
+In particular, for the case of three or more authors
+(as in [3]), a comma also follows the penultimate author.
+The preference for ‘\emph{et al.}’\ takes precedence when the number
+of authors becomes large (e.g., $>$6).
+\vspace*{-.6\baselineskip}
+
+\subsubsection{Paper Title} As is modern practice in references, the title
+of the paper is written in sentence case, i.\,e., only the
+initial letter of the first word in the title is capitalized.
+Proper nouns, however, also have a capital. Capital letters
+appearing in acronyms likewise remain unaltered
+\vspace*{-.6\baselineskip}
+
+\subsubsection{Conference Proceedings} The title of the proceedings is
+written in title case in italics using standard abbreviations,
+such as \emph{Int.} and \emph{Conf.} The preposition, ``in'', in normal
+font, precedes the proceedings title. The location,
+i.\,e., city, state (if USA), and country of the conference
+venue, the month (three-letter abbreviation) and the year
+the conference took place, is then listed. Finally, details
+pertaining to the paper itself, such as the conference paper
+ID, mandatory page numbers, and the digital object
+identifier (DOI), if existing, are listed in the given order.
+A monospaced font for the DOI is used so as to help
+distinguish it from normal text. In \LaTeX{}
+the ‘url’ package is used. The Word template uses the Liberation
+Mono TrueType font (size 8 pt), or Lucida Sans Typewriter
+font (size 7.5 pt) in earlier Word versions where the Liberation
+Mono font may not be available. In LaTeX, the ‘url’
+package is used with its default font now being switched to
+``newtxtt'' which offers a better distinction between
+``\texttt{O}'' and ``\texttt{0}''. The conference
+paper ID is optional and may be included in the absence
+of a DOI to facilitate a search through internet search
+engines. DOIs have been assigned to all JACoW
+publications appearing in recent proceedings and will
+likewise be assigned to articles from conferences further
+past, in due course. The use of DOIs is strongly
+emphasized.
+
+The complete or abbreviated form for citations, as
+shown in the following section, is advocated. The former
+is more informative to readers outside the immediate
+conference sphere, and will further serve to avoid
+potential ambiguities in cases where an acronym is not
+unique. Both forms, however, when adhered to, ensure a
+proper import into digital libraries and information
+sources such as INSPIRE, Scopus, and Google Scholar.
+Authors are also reminded to make a distinction between
+papers published in JACoW proceedings (which have
+page numbers and, in the case of recent publications,
+DOIs) and those papers that may have been presented at
+past JACoW conferences but were not published~[4].
+References to contributions presented at the same
+conference should be written as shown in [5]; the wording
+“this conference” may be optionally appended.
+
+\subsection{Referencing Periodicals and Other Sources}
+
+The IEEE style is also shown for periodicals [6-11],
+online sources [12], books [13, 14], internal reports [15],
+theses [16], manuals or handbooks [17], patents [18] and
+unpublished material [19, 20]. When citing a periodical,
+only the official abbreviation of the journal should be used
+[21]. Examples of correctly formatted references can also be
+found at the JACoW website, under ‘Formatting Citations’ which
+is reached through the ‘for Authors’ link.
+
+\subsection{Alignment of References}
+
+In the \LaTeX{} template, \verb|\bibliography{9}| is used for
+when the total number of references is less than ten. This
+should be changed to \verb|\bibliography{99}| if the number of
+references is ten or more.
+
+\patchcmd\thebibliography{\section*{REFERENCES\@mkboth {REFERENCES}{REFERENCES}}}{}{}{}
+\section{PAPER PUBLISHED IN A CONFERENCE PROCEEDINGS}
+
+\definecolor{jgreen}{cmyk}{0.81, 0.00, 0.97, 0.00}
+\definecolor{jred}{cmyk} {0.00, 0.99, 1.00, 0.00}
+\definecolor{jgrepc}{cmyk}{0.74, 0.05, 1.00, 0.00}
+\definecolor{jblue}{cmyk} {0.87, 0.54, 0.00, 0.00}
+\definecolor{jvio}{cmyk} {0.41, 0.82, 0.00, 0.00}
+\definecolor{jbook}{cmyk} {0.28, 0.88, 0.79, 0.25}
+\definecolor{jrept}{cmyk} {0.07, 0.70, 1.00, 0.00}
+\definecolor{jmanu}{cmyk} {0.28, 0.77, 1.00, 0.23}
+\definecolor{junpu}{cmyk} {0.00, 0.83, 0.65, 0.00}
+
+
+\subsection{Complete Form}
+
+\newcommand{\CCom}[2]{\newline\textcolor{#1}{[#2]}}
+%\begin{thebibliography}{99} % Use for 10-99 references
+\begin{thebibliography}{9} % Use for 1-9 references
+
+ \bibitem{item:1-1}
+ A.~Alpha and B.~T.~Beta, “Novel techniques for future TeV electron accelerators”,
+ in \textit{Proc.\ 9th Int.\ Particle Accelerator Conf.\ (IPAC’18)},
+ Vancouver, BC, Canada, Apr.-May 2018.
+ pp. 567-569. \url{doi:10.18429/JACoW-IPAC2017-PAPERID}
+ \CCom{jgreen}{Conference Proceedings, two authors; DOI encouraged}
+
+ \bibitem{item:1-2}
+ A.~Alpha \emph{et al.},
+ “A novel injector”, in \emph{Proc.\ 29th Linear Accelerator Conf.\ (LINAC’18)},
+ Shanghai, China, Sep.\ 2018, pp.\ 27-31. %\newline
+ \url{doi:10.18429/JACoW-LINAC2018-PAPERID}
+ \CCom{jgreen}{Conference Proceedings, for six or more authors use \emph{et al.};
+ DOI encouraged}
+
+ \bibitem{item:1-3}
+ A.~Alpha, B.~T.~Beta, C.~Gamma, and D.~Delta,
+ “An overview of control systems”,
+ in \emph{Proc.\ 13th Int.\ Conf.\ on Accelerator and Large Experimental Physics Control Systems (ICALEPCS’11)}, Grenoble, France, Oct.\ 2011,
+ paper TUP014, pp.\ 89--91.
+ \CCom{jgreen}{Conference Proceedings, four authors; optional paper ID
+ in the absence of a DOI}
+\end{thebibliography}
+
+\vspace*{-.5\baselineskip}
+\subsection{Abbreviated Form}
+
+\begin{thebibliography}{9} % Use for 1-9 references
+ \bibitem{item:2-1}
+ A.~Alpha and B.~T.~Beta, “Novel techniques for future TeV electron accelerators”,
+ in \textit{Proc.\ IPAC’18}, Vancouver, BC, Canada, Apr.-May 2018,
+ pp.\ 567-569. %\newline
+ \url{doi:10.18429/JACoW-IPAC2018-PAPERID}
+ \CCom{jgreen}{Conference Proceedings, two authors; DOI encouraged}
+
+ \bibitem{item:2-2}
+ A.~Alpha \emph{et al.},
+ “A novel injector”, in \emph{Proc.\ LINAC’18},
+ Shanghai, China, Sep.\ 2018, pp.\ 27-31. %\newline
+ \url{doi:10.18429/JACoW-LINAC2018-PAPERID}
+ \CCom{jgreen}{Conference Proceedings, for six or more authors use \emph{et al.}; DOI encouraged}
+
+ \bibitem{item:2-3}
+ A.~Alpha, B.~T.~Beta, C.~Gamma, and D.~Delta,
+ “An overview of control systems”,
+ in \emph{Proc.\ ICALEPCS’11}, Grenoble, France, Oct.\ 2011,
+ paper TUP014, pp.\ 89--91.
+ \CCom{jgreen}{Conference Proceedings, four authors; optional paper ID
+ in the absence of a DOI}
+\end{thebibliography}
+
+\section{UNPUBLISHED PAPER PRESENTED AT A PREVIOUS CONFERENCE}
+
+\subsection{Complete Form}
+
+\begin{thebibliography}{9} % Use for 1-9 references
+\setcounter{enumi}{3}
+ \bibitem{item:41}
+ A.~Alpha and B.~T.~Beta,
+ “An interesting talk but paper not submitted”,
+ presented at the 5th Int.\ Particle Accelerator Conf.\ (IPAC’14),
+ Dresden, Germany, Jun.\ 2014, paper MOAX01, unpublished.
+ \CCom{jred}{Unpublished paper; conference name in normal font; paper
+ ID may only be given if material supplementing the proceedings
+ exists on the JACoW website, e.\,g., PDF of talk}
+\end{thebibliography}
+
+\subsection{Abbreviated Form}
+
+\begin{thebibliography}{9} % Use for 1-9 references
+\setcounter{enumi}{3}
+ \bibitem{item:42}
+ A.~Alpha and B.~T.~Beta,
+ “An interesting talk but paper not submitted”,
+ presented at IPAC’14,
+ Dresden, Germany, Jun.\ 2014, paper MOAX01, unpublished.
+ \CCom{jred}{Unpublished paper; conference name in normal font; paper
+ ID may only be given if material supplementing the proceedings
+ exists on the JACoW website, e.\,g., PDF of talk}
+\end{thebibliography}
+
+
+\section{PAPER PRESENTED AT THE CURRENT CONFERENCE}
+
+\subsection{Complete Form}
+
+\begin{thebibliography}{9} % Use for 1-9 references
+\setcounter{enumi}{4}
+ \bibitem{item:51}
+ A.~Alpha and B.~T.~Beta,
+ “An interesting talk at this conference”,
+ presented at the 10th Int.\ Particle Accelerator
+ Conf.\ (IPAC’19), Melbourne, Australia, May 2019,
+ paper MOAB01, this conference.
+ \CCom{jgrepc}{Current conference; conference name in normal font;
+ the wording “this conference” is optional}
+\end{thebibliography}
+
+\subsection{Abbreviated Form}
+
+\begin{thebibliography}{9} % Use for 1-9 references
+\setcounter{enumi}{4}
+ \bibitem{item:52}
+ “An interesting talk at this conference”,
+ presented at IPAC’19, Melbourne, Australia, May 2019,
+ paper MOAB01, this conference.
+ \CCom{jgrepc}{Current conference; conference name in normal font;
+ the wording “this conference” is optional}
+\end{thebibliography}
+
+
+\vspace*{-.5\baselineskip}
+\section{PAPER PUBLISHED IN, OR SUBMITTED TO, A PERIODICAL}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{5}
+ \bibitem{item:6}
+ P.~Mercury \emph{et al.},
+ “Title of paper published in journal”,
+ \emph{Phy.\ Rev.\ Lett.}, vol.\ 114, no.\ 5,
+ p.\ 050511, Feb.\ 2014.
+ \url{doi:10.1103/PhysRevLett.114.050511}
+ \CCom{jblue}{Periodical, Phys.\ Rev.\ Lett.;
+ issue no.\ and month may be omitted}
+
+ \bibitem{item:7}
+ P.~Venus \emph{et al.},
+ “New techniques in laser wakefield accelerators”,
+ \emph{Phys.\ Rev.\ ST Accel.\ Beams}, vol.\ 18,
+ p.\ 120198, Dec.~2015. %\newline
+ \url{doi:10.1103/PhysRevAccelBeams.18.120198}
+ \CCom{jblue}{Periodical, Phys.\ Rev.\ ST Accel.\ Beams;
+ month may be omitted}
+
+ \bibitem{item:8}
+ T.~Earth \emph{et al.},
+ “Low dose irradiation impact on modern silicon detectors”,
+ \emph{Nucl.\ Instr.\ Meth.}, vol.\ 692, pp.\ 256--280, 2014.
+ \url{doi:10.1016/j.nima.2014.11.022}
+ \CCom{jblue}{Periodical, Nucl. Instr. Method.}
+
+ \bibitem{item:9}
+ T.~Earth, L.~Moon, and A.~Belt,
+ “Temporal correlations of x-ray free electron lasers”,
+ \emph{Optics Express}, vol.\ 20, pp.\ 11396--11404, 2012.
+ \url{doi:10.1364/OE.20.11396}
+ \CCom{jblue}{Periodical, Optics Express}
+
+ \bibitem{item:10}
+ J.~B.~Good,
+ “A paper accepted for publication”,
+ \emph{Phys.\ Rev.\ Lett.}, to be published.
+ \CCom{jblue}{Periodical, paper accepted for publication
+ by Phys. Rev. Lett.}
+
+ \bibitem{item:11}
+ G.~D.~Read,
+ “Title of paper submitted for publication”,
+ submitted for publication.
+ \CCom{jblue}{Paper submitted for publication; the name of the
+ periodical does not appear}
+\end{thebibliography}
+
+\vspace*{-.5\baselineskip}
+\section{ONLINE SOURCE}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{11}
+ \bibitem{item:121}
+ JACoW, \url{http://www.jacow.org}
+ \CCom{jvio}{online source; no hyperlink, no period at end of URL unless there is a trailing “/” as shown below. A monospaced font should be used, this is achieved using the ‘url’ package in \LaTeX}
+
+ \setcounter{enumi}{11}
+ \bibitem{item:122}
+ JACoW, \url{http://www.jacow.org/}.
+ \CCom{jvio}{online source; no hyperlink, period after trailing “/” in URL
+ if optionally preferred. A monospaced font should be used, this is
+ achieved using the ‘url’ package in \LaTeX}
+
+\end{thebibliography}
+
+\section{CITATIONS TO BOOKS}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{12}
+ \bibitem{item:13}
+ T.~Earth and L.~Moon,
+ “Title of chapter in the book”,
+ in \emph{Title of Book}, R Mars, Ed.\ New York, NY, USA:
+ Wiley, 1994, pp.\ 42--48.
+ \CCom{jbook}{Chapter in book}
+
+ \bibitem{item:14}
+ A.~Belt, \emph{Title of Book}. Cambridge, MA, USA:
+ MIT Press, 1986.
+ \CCom{jbook}{Book}
+\end{thebibliography}
+
+\section{REPORTS AND THESES}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{14}
+ \bibitem{item:15}
+ G. Jupiter \emph{et al.},
+ “Title of report”, CERN, Geneva, Switzerland,
+ Rep.\ CERN-2012-333, Oct.\ 2012.
+ \CCom{jrept}{Report}
+
+ \bibitem{item:16}
+ A.~Student, “Title of thesis”,
+ Ph.D.\ thesis, Phys.\ Dept.,
+ Karlsruher Institut für Technologie, Karlsruhe,
+ Germany, 2014.
+ \CCom{jrept}{Thesis}
+\end{thebibliography}
+
+\section{MANUAL}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{16}
+ \bibitem{item:17}
+ \emph{IEEE Editorial Style Manual},
+ IEEE Periodicals,
+ Piscataway, NJ, USA, Oct.\ 2014, pp.\ 34-52;
+ \url{http://www.ieee.org/documents/style_manual.pdf}
+ \CCom{jmanu}{Handbook/Manual, no hyperlink, no period after URL}
+\end{thebibliography}
+
+\section{PATENTS}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{17}
+ \bibitem{item:18}
+ A.~N.~Inventor,
+ “Title of patent”,
+ Patent Authority and No., Jan.\ 20, 2016.
+
+\end{thebibliography}
+
+\section{UNPUBLISHED WORK AND PRIVATE COMMUNICATION}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{18}
+ \bibitem{item:19}
+ P.~Neptune, “Title of paper”, unpublished.
+ \CCom{junpu}{Unpublished}
+
+ \bibitem{item:20}
+ P.~Uranus, private communication, Jun.\ 2015.
+ \CCom{junpu}{Private communication}
+\end{thebibliography}
+
+\newpage
+
+\section{JOURNAL ABBREVIATIONS}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{20}
+ \bibitem{item:21}
+ \url{https://woodward.library.ubc.ca/researchhelp/journal-abbreviations/}
+
+\end{thebibliography}
+
+\newpage
+
+\twocolumn[\vspace*{-1.8ex}\section{ANNEX C:\endgraf THE DILIGENT AUTHOR’S CHECKLIST}\vspace*{\baselineskip}]
+\flushcolsend
+
+\subsection{Common Oversights}
+
+In order to lessen the load on a small team of editors
+and to help expedite publication of the Proceedings, authors
+are kindly asked to give themselves an extra few
+minutes to go over the following points, which highlight
+the most common errors, before uploading their paper. By
+providing a properly formatted JACoW paper, the Proceedings
+Office is able to benefit from an autodistill process
+which automatically converts the author's PDF file
+into a version that adheres to the JACoW-compliant PDF
+standard. The process further ensures that all fonts required
+to view the entire document are embedded, rendering
+a final PDF that qualifies technically for publication.
+
+
+\subsection{Author and Affiliation Listing}
+
+The names of authors and their affiliations should be in
+\SI{12}{pt} uppercase and lowercase letters, with standard,
+roman fonts (i.\,e., not italics). When there is more than
+one author, the submitting author should be first, followed
+by the coauthor. Coauthors should be grouped by affiliation
+and then be listed alphabetically. Please refer to \textbf{ANNEX~A}
+for further details and examples, particularly for
+the case where authors have multiple institutes.
+
+\subsection{SPMS Database and Final Manuscript Validation}
+
+Primary authors are reminded that it is their
+responsibility to verify the accuracy of the title, abstract,
+and coauthor/institute listing, and that these are identical
+in both the final manuscript and SPMS database. This is
+required to ensure the proper indexing of author/coauthor(s)
+appear in the published proceedings.
+
+\subsection{Subsection Headings}
+
+Subsection Headings are in \SI{12}{pt} \emph{italic} lowercase and uppercase.
+The initial letter of every principle word is capitalized,
+and the heading is left aligned in the column.
+
+\subsection{Figure Captions}
+
+Figure captions should be placed \emph{below} the figure and
+centred if on one line, but justified if spanning two or
+more lines:
+\begin{center}
+ Figure 1: A one line figure caption is centred.
+\end{center}
+\begin{justify}
+ Figure 2: A lengthy figure caption that spans
+ two lines is justified.
+\end{justify}
+
+Note the colon “:” after the figure number and the period
+“.” at the end of the caption.
+
+When referring to a figure from within the text, the
+convention is to use the abbreviated form, i.\,e., Fig.~1,
+\emph{unless} the reference to the figure is at the start of the sentence:
+\begin{quote}
+ Figure 1 shows a schematic view of\ldots
+
+ \ldots as shown in Fig.~1.
+\end{quote}
+
+% if set as \subsection, the title will appear at the top
+% of the column followed by "Table captions ... lines:",
+% then follows the text above after the justify till end of quote
+\iffalse
+\subsection{Table Headings}
+\else
+\noindent\textit{\vspace{1em}\large Table Headings}
+\fi
+
+Table captions should be placed \emph{above} the table and
+centred if on one line, but justified if spanning two or
+more lines:
+\begin{center}
+ Table 1: Table Heading
+\end{center}
+
+\begin{justify}
+ Table 2: A Particularly Long Table Heading
+ Spanning Two Lines
+\end{justify}
+
+Note the colon “:” after the table number, that the initial
+letters of the principle words in the table heading are
+capitalized, and the absence of a period at the end of the
+caption.
+
+When referring to a table from within the text, the convention
+is \emph{not} to abbreviate, i.\,e., Table 1.
+
+\subsection{Equations}
+
+If a displayed equation requires a number, it should be
+placed flush with the right margin of the column.
+
+\subsection{Units}
+
+An unbreakable space should always precede a unit. In \LaTeX{} use
+a “\verb|\,|” or the ‘siunitx’ package to format units.
+Examples are:
+\SI{3}{keV}, \SI{4}{GeV}, \SI{100}{kW}, \SI{7}{\micro m}.
+
+\subsection{References}
+
+References are written in \SI{9}{pt} size and should be neatly
+presented in a consistent format with reference numbers
+aligned. Please refer to \textbf{ANNEX~B} for the preferred format
+and proper alignment.
+
+Please also ensure that references in the text are cited in
+sequential order.
+
+\flushend
diff --git a/macros/latex/contrib/jacow/annexes-Letter.tex b/macros/latex/contrib/jacow/annexes-Letter.tex
new file mode 100644
index 0000000000..d4a29962fc
--- /dev/null
+++ b/macros/latex/contrib/jacow/annexes-Letter.tex
@@ -0,0 +1,543 @@
+%
+% !TeX spellcheck = en_US
+%
+\twocolumn[\vspace*{-1.8ex}\section{ANNEX A:\endgraf FORMATTING OF AUTHORS AND AFFILIATIONS}\vspace*{\baselineskip}]
+
+\flushcolsend
+
+The names of authors, their organizations/affiliations
+and postal addresses should be grouped by affiliation and
+listed in \SI{12}{pt} upper- and lowercase letters. The name of
+the submitting or primary author should be first, followed
+by the coauthors, alphabetically by affiliation. If the
+author list for a given affiliation spans multiple lines,
+please be sure to break the line in a manner that does not
+split the author’s initials from the author’s last name. This
+is easily done by placing unbreakable spaces between the
+initials and last name. The affiliation name and address
+are also best kept together on the same (but not necessarily
+separate) line, wherever possible. (See, for example,
+the entry for GSI in the following). In cases where authors
+have multiple affiliations, the secondary affiliation is
+inserted below the author/primary affiliation listing and is
+indicated with a superscript, as shown in the following.
+
+
+Footnotes on the title and author lines may be used for
+acknowledgments and e-mail addresses, using a non-numeric
+sequence of characters (\textsuperscript{*}, \textsuperscript{†},
+\textsuperscript{‡}, \textsuperscript{§}, \textsuperscript{\P}
+as generated by \LaTeX's \verb|\footnote| command).
+
+For examples of the preferred formatting of authors and
+affiliations, please consult the following list of JACoW
+collaboration members.
+
+For manuscripts submitted by large collaborations with
+potentially many tens of authors and where, additionally,
+there may be page number limitations, a format consisting
+of the principle author’s name and institute, followed by
+“on behalf of the \ldots\ collaboration”, is preferred.
+
+
+\clearpage
+%
+% Include the title/author page of the JACoW Coolaboration
+%
+\includepdf[pages=-, noautoscale, pagecommand={}]{jacow-collaboration.pdf}{}
+
+\clearpage
+
+\twocolumn[\vspace*{-1.8ex}\section{ANNEX B:\endgraf IEEE REFERENCE STYLE GUIDE AS APPLIED TO \NoCaseChange{JACoW} PAPERS, \break PERIODICALS AND OTHER WORKS}\vspace*{\baselineskip}]
+
+\subsection{Referencing JACoW Proceedings}
+
+The format for published JACoW proceedings papers is detailed in the following
+and can also be readily deduced from Refs.~[1-3]. At the very minimum, sufficient
+information should be given to enable readers to clearly identify the paper and
+to facilitate its import into digital databases.
+\vspace*{-.6\baselineskip}
+
+\subsubsection{Author Listing} Careful attention should be given to the
+placing of commas and the use of ‘and’ in the author list.
+In particular, for the case of three or more authors
+(as in [3]), a comma also follows the penultimate author.
+The preference for ‘\emph{et al.}’\ takes precedence when the number
+of authors becomes large (e.g., $>$6).
+\vspace*{-.6\baselineskip}
+
+\subsubsection{Paper Title} As is modern practice in references, the title
+of the paper is written in sentence case, i.\,e., only the
+initial letter of the first word in the title is capitalized.
+Proper nouns, however, also have a capital. Capital letters
+appearing in acronyms likewise remain unaltered
+\vspace*{-.6\baselineskip}
+
+\subsubsection{Conference Proceedings} The title of the proceedings is
+written in title case in italics using standard abbreviations,
+such as \emph{Int.} and \emph{Conf.} The preposition, ``in'', in normal
+font, precedes the proceedings title. The location,
+i.\,e., city, state (if USA), and country of the conference
+venue, the month (three-letter abbreviation) and the year
+the conference took place, is then listed. Finally, details
+pertaining to the paper itself, such as the conference paper
+ID, mandatory page numbers, and the digital object
+identifier (DOI), if existing, are listed in the given order.
+A monospaced font for the DOI is used so as to help
+distinguish it from normal text. In \LaTeX{}
+the ‘url’ package is used. The Word template uses the Liberation
+Mono TrueType font (size 8 pt), or Lucida Sans Typewriter
+font (size 7.5 pt) in earlier Word versions where the Liberation
+Mono font may not be available. In LaTeX, the ‘url’
+package is used with its default font now being switched to
+``newtxtt'' which offers a better distinction between
+``\texttt{O}'' and ``\texttt{0}''. The conference
+paper ID is optional and may be included in the absence
+of a DOI to facilitate a search through internet search
+engines. DOIs have been assigned to all JACoW
+publications appearing in recent proceedings and will
+likewise be assigned to articles from conferences further
+past, in due course. The use of DOIs is strongly
+emphasized.
+
+The complete or abbreviated form for citations, as
+shown in the following section, is advocated. The former
+is more informative to readers outside the immediate
+conference sphere, and will further serve to avoid
+potential ambiguities in cases where an acronym is not
+unique. Both forms, however, when adhered to, ensure a
+proper import into digital libraries and information
+sources such as INSPIRE, Scopus, and Google Scholar.
+Authors are also reminded to make a distinction between
+papers published in JACoW proceedings (which have
+page numbers and, in the case of recent publications,
+DOIs) and those papers that may have been presented at
+past JACoW conferences but were not published~[4].
+References to contributions presented at the same
+conference should be written as shown in [5]; the wording
+“this conference” may be optionally appended.
+
+\subsection{Referencing Periodicals and Other Sources}
+
+The IEEE style is also shown for periodicals [6-11],
+online sources [12], books [13, 14], internal reports [15],
+theses [16], manuals or handbooks [17], patents [18] and
+unpublished material [19, 20]. When citing a periodical,
+only the official abbreviation of the journal should be used
+[21]. Examples of correctly formatted references can also be
+found at the JACoW website, under ‘Formatting Citations’ which
+is reached through the ‘for Authors’ link.
+
+\subsection{Alignment of References}
+
+In the \LaTeX{} template, \verb|\bibliography{9}| is used for
+when the total number of references is less than ten. This
+should be changed to \verb|\bibliography{99}| if the number of
+references is ten or more.
+
+\patchcmd\thebibliography{\section*{REFERENCES\@mkboth {REFERENCES}{REFERENCES}}}{}{}{}
+\section{PAPER PUBLISHED IN A CONFERENCE PROCEEDINGS}
+
+\definecolor{jgreen}{cmyk}{0.81, 0.00, 0.97, 0.00}
+\definecolor{jred}{cmyk} {0.00, 0.99, 1.00, 0.00}
+\definecolor{jgrepc}{cmyk}{0.74, 0.05, 1.00, 0.00}
+\definecolor{jblue}{cmyk} {0.87, 0.54, 0.00, 0.00}
+\definecolor{jvio}{cmyk} {0.41, 0.82, 0.00, 0.00}
+\definecolor{jbook}{cmyk} {0.28, 0.88, 0.79, 0.25}
+\definecolor{jrept}{cmyk} {0.07, 0.70, 1.00, 0.00}
+\definecolor{jmanu}{cmyk} {0.28, 0.77, 1.00, 0.23}
+\definecolor{junpu}{cmyk} {0.00, 0.83, 0.65, 0.00}
+
+
+\subsection{Complete Form}
+
+\newcommand{\CCom}[2]{\newline\textcolor{#1}{[#2]}}
+%\begin{thebibliography}{99} % Use for 10-99 references
+\begin{thebibliography}{9} % Use for 1-9 references
+
+ \bibitem{item:1-1}
+ A.~Alpha and B.~T.~Beta, “Novel techniques for future TeV electron accelerators,”
+ in \textit{Proc.\ 9th Int.\ Particle Accelerator Conf.\ (IPAC’18)},
+ Vancouver, BC, Canada, Apr.-May 2018.
+ pp. 567-569. \url{doi:10.18429/JACoW-IPAC2017-PAPERID}
+ \CCom{jgreen}{Conference Proceedings, two authors; DOI encouraged}
+
+ \bibitem{item:1-2}
+ A.~Alpha \emph{et al.},
+ “A novel injector,” in \emph{Proc.\ 29th Linear Accelerator Conf.\ (LINAC’18)},
+ Shanghai, China, Sep.\ 2018, pp.\ 27-31. %\newline
+ \url{doi:10.18429/JACoW-LINAC2018-PAPERID}
+ \CCom{jgreen}{Conference Proceedings, for six or more authors use \emph{et al.};
+ DOI encouraged}
+
+ \bibitem{item:1-3}
+ A.~Alpha, B.~T.~Beta, C.~Gamma, and D.~Delta,
+ “An overview of control systems,”
+ in \emph{Proc.\ 13th Int.\ Conf.\ on Accelerator and Large Experimental Physics Control Systems (ICALEPCS’11)}, Grenoble, France, Oct.\ 2011,
+ paper TUP014, pp.\ 89--91.
+ \CCom{jgreen}{Conference Proceedings, four authors; optional paper ID
+ in the absence of a DOI}
+\end{thebibliography}
+
+\vspace*{-.5\baselineskip}
+\subsection{Abbreviated Form}
+
+\begin{thebibliography}{9} % Use for 1-9 references
+ \bibitem{item:2-1}
+ A.~Alpha and B.~T.~Beta, “Novel techniques for future TeV electron accelerators,”
+ in \textit{Proc.\ IPAC’18}, Vancouver, BC, Canada, Apr.-May 2018,
+ pp.\ 567-569. %\newline
+ \url{doi:10.18429/JACoW-IPAC2018-PAPERID}
+ \CCom{jgreen}{Conference Proceedings, two authors; DOI encouraged}
+
+ \bibitem{item:2-2}
+ A.~Alpha \emph{et al.},
+ “A novel injector,” in \emph{Proc.\ LINAC’18},
+ Shanghai, China, Sep.\ 2018, pp.\ 27-31. %\newline
+ \url{doi:10.18429/JACoW-LINAC2018-PAPERID}
+ \CCom{jgreen}{Conference Proceedings, for six or more authors use \emph{et al.}; DOI encouraged}
+
+ \bibitem{item:2-3}
+ A.~Alpha, B.~T.~Beta, C.~Gamma, and D.~Delta,
+ “An overview of control systems,”
+ in \emph{Proc.\ ICALEPCS’11}, Grenoble, France, Oct.\ 2011,
+ paper TUP014, pp.\ 89--91.
+ \CCom{jgreen}{Conference Proceedings, four authors; optional paper ID
+ in the absence of a DOI}
+\end{thebibliography}
+
+\section{UNPUBLISHED PAPER PRESENTED AT A PREVIOUS CONFERENCE}
+
+
+\subsection{Complete Form}
+
+\begin{thebibliography}{9} % Use for 1-9 references
+\setcounter{enumi}{3}
+ \bibitem{item:41}
+ A.~Alpha and B.~T.~Beta,
+ “An interesting talk but paper not submitted,”
+ presented at the 5th Int.\ Particle Accelerator Conf.\ (IPAC’14),
+ Dresden, Germany, Jun.\ 2014, paper MOAX01, unpublished.
+ \CCom{jred}{Unpublished paper; conference name in normal font; paper
+ ID may only be given if material supplementing the proceedings
+ exists on the JACoW website, e.\,g., PDF of talk}
+\end{thebibliography}
+
+\subsection{Abbreviated Form}
+
+\begin{thebibliography}{9} % Use for 1-9 references
+\setcounter{enumi}{3}
+ \bibitem{item:42}
+ A.~Alpha and B.~T.~Beta,
+ “An interesting talk but paper not submitted,”
+ presented at IPAC’14,
+ Dresden, Germany, Jun.\ 2014, paper MOAX01, unpublished.
+ \CCom{jred}{Unpublished paper; conference name in normal font; paper
+ ID may only be given if material supplementing the proceedings
+ exists on the JACoW website, e.\,g., PDF of talk}
+\end{thebibliography}
+
+
+\section{PAPER PRESENTED AT THE CURRENT CONFERENCE}
+
+\subsection{Complete Form}
+
+\begin{thebibliography}{9} % Use for 1-9 references
+\setcounter{enumi}{4}
+ \bibitem{item:51}
+ A.~Alpha and B.~T.~Beta,
+ “An interesting talk at this conference,”
+ presented at the 10th Int.\ Particle Accelerator
+ Conf.\ (IPAC’19), Melbourne, Australia, May 2019,
+ paper MOAB01, this conference.
+ \CCom{jgrepc}{Current conference; conference name in normal font;
+ the wording “this conference” is optional}
+\end{thebibliography}
+
+\subsection{Abbreviated Form}
+
+\begin{thebibliography}{9} % Use for 1-9 references
+\setcounter{enumi}{4}
+ \bibitem{item:52}
+ “An interesting talk at this conference,”
+ presented at IPAC’19, Melbourne, Australia, May 2019,
+ paper MOAB01, this conference.
+ \CCom{jgrepc}{Current conference; conference name in normal font;
+ the wording “this conference” is optional}
+\end{thebibliography}
+
+
+\vspace*{-.5\baselineskip}
+\section{PAPER PUBLISHED IN, OR SUBMITTED TO, A PERIODICAL}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{5}
+ \bibitem{item:6}
+ P.~Mercury \emph{et al.},
+ “Title of paper published in journal,”
+ \emph{Phy.\ Rev.\ Lett.}, vol.\ 114, no.\ 5,
+ p.\ 050511, Feb.\ 2014.
+ \url{doi:10.1103/PhysRevLett.114.050511}
+ \CCom{jblue}{Periodical, Phys.\ Rev.\ Lett.;
+ issue no.\ and month may be omitted}
+
+ \bibitem{item:7}
+ P.~Venus \emph{et al.},
+ “New techniques in laser wakefield accelerators,”
+ \emph{Phys.\ Rev.\ ST Accel.\ Beams}, vol.\ 18,
+ p.\ 120198, Dec.~2015. %\newline
+ \url{doi:10.1103/PhysRevAccelBeams.18.120198}
+ \CCom{jblue}{Periodical, Phys.\ Rev.\ ST Accel.\ Beams;
+ month may be omitted}
+
+ \bibitem{item:8}
+ T.~Earth \emph{et al.},
+ “Low dose irradiation impact on modern silicon detectors,”
+ \emph{Nucl.\ Instr.\ Meth.}, vol.\ 692, pp.\ 256--280, 2014.
+ \url{doi:10.1016/j.nima.2014.11.022}
+ \CCom{jblue}{Periodical, Nucl. Instr. Method.}
+
+ \bibitem{item:9}
+ T.~Earth, L.~Moon, and A.~Belt,
+ “Temporal correlations of x-ray free electron lasers,”
+ \emph{Optics Express}, vol.\ 20, pp.\ 11396--11404, 2012.
+ \url{doi:10.1364/OE.20.11396}
+ \CCom{jblue}{Periodical, Optics Express}
+
+ \bibitem{item:10}
+ J.~B.~Good,
+ “A paper accepted for publication,”
+ \emph{Phys.\ Rev.\ Lett.}, to be published.
+ \CCom{jblue}{Periodical, paper accepted for publication
+ by Phys. Rev. Lett.}
+
+ \bibitem{item:11}
+ G.~D.~Read,
+ “Title of paper submitted for publication,”
+ submitted for publication.
+ \CCom{jblue}{Paper submitted for publication; the name of the
+ periodical does not appear}
+\end{thebibliography}
+
+\vspace*{-.5\baselineskip}
+\section{ONLINE SOURCE}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{11}
+ \bibitem{item:121}
+ JACoW, \url{http://www.jacow.org}
+ \CCom{jvio}{online source; no hyperlink, no period at end of URL unless there is a trailing “/” as shown below. A monospaced font should be used, this is achieved using the ‘url’ package in \LaTeX}
+
+ \setcounter{enumi}{11}
+ \bibitem{item:122}
+ JACoW, \url{http://www.jacow.org/}.
+ \CCom{jvio}{online source; no hyperlink, period after trailing “/” in URL
+ if optionally preferred. A monospaced font should be used, this is
+ achieved using the ‘url’ package in \LaTeX}
+
+\end{thebibliography}
+
+\section{CITATIONS TO BOOKS}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{12}
+ \bibitem{item:13}
+ T.~Earth and L.~Moon,
+ “Title of chapter in the book,”
+ in \emph{Title of Book}, R Mars, Ed.\ New York, NY, USA:
+ Wiley, 1994, pp.\ 42--48.
+ \CCom{jbook}{Chapter in book}
+
+ \bibitem{item:14}
+ A.~Belt, \emph{Title of Book}. Cambridge, MA, USA:
+ MIT Press, 1986.
+ \CCom{jbook}{Book}
+\end{thebibliography}
+
+\section{REPORTS AND THESES}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{14}
+ \bibitem{item:15}
+ G. Jupiter \emph{et al.},
+ “Title of report,” CERN, Geneva, Switzerland,
+ Rep.\ CERN-2012-333, Oct.\ 2012.
+ \CCom{jrept}{Report}
+
+ \bibitem{item:16}
+ A.~Student, “Title of thesis,”
+ Ph.D.\ thesis, Phys.\ Dept.,
+ Karlsruher Institut für Technologie, Karlsruhe,
+ Germany, 2014.
+ \CCom{jrept}{Thesis}
+\end{thebibliography}
+
+\section{MANUAL}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{16}
+ \bibitem{item:17}
+ \emph{IEEE Editorial Style Manual},
+ IEEE Periodicals,
+ Piscataway, NJ, USA, Oct.\ 2014, pp.\ 34-52;
+ \url{http://www.ieee.org/documents/style_manual.pdf}
+ \CCom{jmanu}{Handbook/Manual, no hyperlink, no period after URL}
+\end{thebibliography}
+
+\section{PATENTS}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{17}
+ \bibitem{item:18}
+ A.~N.~Inventor,
+ “Title of patent,”
+ Patent Authority and No., Jan.\ 20, 2016.
+
+\end{thebibliography}
+
+\section{UNPUBLISHED WORK AND PRIVATE COMMUNICATION}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{18}
+ \bibitem{item:19}
+ P.~Neptune, “Title of paper,” unpublished.
+ \CCom{junpu}{Unpublished}
+
+ \bibitem{item:20}
+ P.~Uranus, private communication, Jun.\ 2015.
+ \CCom{junpu}{Private communication}
+\end{thebibliography}
+
+\newpage
+
+\section{JOURNAL ABBREVIATIONS}
+
+\begin{thebibliography}{99} % Use for 1-9 references
+ \setcounter{enumi}{20}
+ \bibitem{item:21}
+ \url{https://woodward.library.ubc.ca/researchhelp/journal-abbreviations/}
+
+\end{thebibliography}
+
+\newpage
+
+\twocolumn[\vspace*{-1.8ex}\section{ANNEX C:\endgraf THE DILIGENT AUTHOR’S CHECKLIST}\vspace*{\baselineskip}]
+\flushcolsend
+
+\subsection{Common Oversights}
+
+In order to lessen the load on a small team of editors
+and to help expedite publication of the Proceedings, authors
+are kindly asked to give themselves an extra few
+minutes to go over the following points, which highlight
+the most common errors, before uploading their paper. By
+providing a properly formatted JACoW paper, the Proceedings
+Office is able to benefit from an autodistill process
+which automatically converts the author's PDF file
+into a version that adheres to the JACoW-compliant PDF
+standard. The process further ensures that all fonts required
+to view the entire document are embedded, rendering
+a final PDF that qualifies technically for publication.
+
+
+\subsection{Author and Affiliation Listing}
+
+The names of authors and their affiliations should be in
+\SI{12}{pt} uppercase and lowercase letters, with standard,
+roman fonts (i.\,e., not italics). When there is more than
+one author, the submitting author should be first, followed
+by the coauthor. Coauthors should be grouped by affiliation
+and then be listed alphabetically. Please refer to \textbf{ANNEX~A}
+for further details and examples, particularly for
+the case where authors have multiple institutes.
+
+\subsection{SPMS Database and Final Manuscript Validation}
+
+Primary authors are reminded that it is their
+responsibility to verify the accuracy of the title, abstract,
+and coauthor/institute listing, and that these are identical
+in both the final manuscript and SPMS database. This is
+required to ensure the proper indexing of author/coauthor(s)
+appear in the published proceedings.
+
+\subsection{Subsection Headings}
+
+Subsection Headings are in \SI{12}{pt} \emph{italic} lowercase and uppercase.
+The initial letter of every principle word is capitalized,
+and the heading is left aligned in the column.
+
+\subsection{Figure Captions}
+
+Figure captions should be placed \emph{below} the figure and
+centred if on one line, but justified if spanning two or
+more lines:
+\begin{center}
+ Figure 1: A one line figure caption is centred.
+\end{center}
+\begin{justify}
+ Figure 2: A lengthy figure caption that spans
+ two lines is justified.
+\end{justify}
+Note the colon “:” after the figure number and the period
+“.” at the end of the caption.
+
+When referring to a figure from within the text, the
+convention is to use the abbreviated form, i.\,e., Fig.~1,
+\emph{unless} the reference to the figure is at the start of the sentence:
+\begin{quote}
+ Figure 1 shows a schematic view of\ldots
+
+ \ldots as shown in Fig.~1.
+\end{quote}
+
+% if set as \subsection, the title will appear at the top
+% of the column followed by "Table captions ... lines:",
+% then follows the text above after the justify till end of quote
+\iffalse
+\subsection{Table Headings}
+\else
+\noindent\textit{\vspace{1em}\large Table Headings}
+\fi
+
+Table captions should be placed \emph{above} the table and
+centred if on one line, but justified if spanning two or
+more lines:
+\begin{center}
+ Table 1: Table Heading
+\end{center}
+\begin{justify}
+ Table 2: A Particularly Long Table Heading
+ Spanning Two Lines
+\end{justify}
+
+Note the colon “:” after the table number, that the initial
+letters of the principle words in the table heading are
+capitalized, and the absence of a period at the end of the
+caption.
+
+When referring to a table from within the text, the convention
+is \emph{not} to abbreviate, i.\,e., Table 1.
+
+\subsection{Equations}
+
+If a displayed equation requires a number, it should be
+placed flush with the right margin of the column.
+
+\subsection{Units}
+
+An unbreakable space should always precede a unit. In \LaTeX{} use
+a “\verb|\,|” or the ‘siunitx’ package to format units.
+Examples are:
+\SI{3}{keV}, \SI{4}{GeV}, \SI{100}{kW}, \SI{7}{\micro m}.
+
+\subsection{References}
+
+References are written in \SI{9}{pt} size and should be neatly
+presented in a consistent format with reference numbers
+aligned. Please refer to \textbf{ANNEX~B} for the preferred format
+and proper alignment.
+
+Please also ensure that references in the text are cited in
+sequential order.
+
+\flushend
diff --git a/macros/latex/contrib/jacow/jacow-collaboration.pdf b/macros/latex/contrib/jacow/jacow-collaboration.pdf
new file mode 100644
index 0000000000..64c13de3b2
--- /dev/null
+++ b/macros/latex/contrib/jacow/jacow-collaboration.pdf
Binary files differ
diff --git a/macros/latex/contrib/jacow/jacow-collaboration.tex b/macros/latex/contrib/jacow/jacow-collaboration.tex
new file mode 100644
index 0000000000..eb8d533a88
--- /dev/null
+++ b/macros/latex/contrib/jacow/jacow-collaboration.tex
@@ -0,0 +1,98 @@
+% !TeX program = lualatex
+% !TeX encoding = utf8
+%
+% in v 2.3 Feb 2019 Volker RW Schaa
+% - JACoW Collaboration updated to the TM 2018
+%
+\documentclass[a4paper,
+ %boxit, % check whether paper is inside correct margins
+ %titlepage, % separate title page
+ %refpage % separate references
+ %biblatex, % biblatex is used
+ keeplastbox, % flushend option: not to un-indent last line in References
+ %nospread, % flushend option: do not fill with whitespace to balance columns
+ %hyphens, % allow \url to hyphenate at "-" (hyphens)
+ %xetex, % use XeLaTeX to process the file
+ luatex, % use LuaLaTeX to process the file
+ ]{jacow}
+
+\usepackage[USenglish]{babel}
+%\renewcommand{\baselinestretch}{0.9535417264123889} % -v2.2
+\renewcommand{\baselinestretch}{0.95} % v2.3
+% CHECK FOR XeTeX/LuaTeX BEFORE DEFINING AN INPUT ENCODING
+% --------------------------------------------------------
+% utf8 is default for XeTeX/LuaTeX
+% utf8 in LaTeX only realises a small portion of codes
+%
+\ifboolexpr{bool{xetex} or bool{luatex}} % test for XeTeX/LuaTeX
+ {} % input encoding is utf8 by default
+ {\usepackage[utf8]{inputenc}} % switch to utf8
+
+
+%%
+%% Lengths for the spaces in the title
+\setlength\titleblockstartskip{2pt} %before title, default 3pt
+%\setlength\titleblockmiddleskip{.3em} %between title + author, default 1em
+\setlength\titleblockendskip{.3em} %afterauthor, default 1em
+
+
+\begin{document}
+ \title{THE \NoCaseChange{JACoW} COLLABORATION\thanks{{As of Dec. 2018, JACoW Collaboration Team Meeting. \newline
+ Templates are managed by the collaboration and implemented by:}}}
+
+ \author{C. Petit-Jean-Genaz, J. Poole\textsuperscript{1}, T. Baron, R. Billen,
+ P. Ferreira, N. Juszka, M. Kołodziejski,\\
+ A. Mönnich, P. Poulopoulou, M. Vidal, CERN, 1211 Geneva 23, Switzerland \\
+ C. E. Eyberger, K. Jaje, Y. Jaski, Argonne National Laboratory, Lemont, IL 60439, USA \\
+ D. Button, M. Hewes, ANSTO, Lucas Heights NSW 2234, Australia \\
+ R. Dowd, K. Riches, E. Tan, N. White, ANSTO, Clayton VIC 3168, Australia \\
+ R. Picoreti, S. Marques, Brazilian Synchrontron Light Laboratory, 13083-970 Campinas, Brazil \\
+ P. Dyer, C. Hoffman, Brookhaven National Laboratory, Upton, NY 11973, USA \\
+ M. V. Kuzin, Budker Institute of Nuclear Physics, 630090 Novosibirsk, Russia \\
+ L. Serani, Centre d’Etudes Nucléaires de Bordeaux Gradignan, \\
+ Université de Bordeaux/IN2P3/CNRS, 33175 Gradignan, France \\
+ M. Marx, Deutsches Elektronen-Synchrotron, 22607 Hamburg, Germany \\
+ I. Andrian\thanks{ivan.andrian@elettra.eu (OpenDocument)},
+ S. Deiuri, Elettra Sincrotrone Trieste, 34149 Basovizza, Italy \\
+ J. Olander, G. Trahern, European Spallation Source, 221 00 Lund, Sweden \\
+ M. Arena, Fermilab, Batavia IL 60510, USA \\
+ F. Chautard, Grand Accélérateur National d'Ions Lourds, 14076 Caen, France \\
+ R. Müller, V. R. W. Schaa\thanks{v.r.w.schaa@gsi.de (\LaTeX)} \\
+ GSI Helmholtzzentrum für Schwerionenforschung, 64291 Darmstadt, Germany \\
+ M. McAteer, Helmholtz-Zentrum Berlin, 14109 Berlin, Germany \\
+ P. Neumann, Helmholtz-Zentrum Dresden-Rossendorf, 01328 Dresden, Germany \\
+ Y.-Y Li, Hong Kong University of Science and Technology, Hong Kong, P. R. China \\
+ P. Pisciotta, INFN-LNS, 95123 Catania, Italy \\
+ N. Zhao, Institute of High Energy Physics, Beijing 100049, P. R. China \\
+ L. Li, Institute of Modern Physics, Lanzhou 730000, P. R. China \\
+ J. G. de Villiers, J. Mira, iThemba Labs, P.O. Box 722, Somerset West 7130, South Africa \\
+ Y. H. Chin, K. Furukawa, T. Kosuge, A. Shirakawa,
+ KEK, Tsukuba, Ibaraki 305-0801, Japan \\
+ P. Snopok, Illinois Institute of Technology, Chicago, IL 60616, USA \\
+ R. Apsimon, Cockcroft Institute, Lancaster University, Lancaster LA1 4YW, UK \\
+ K. A. Bishofberger, Los Alamos National Laboratory, Los Alamos, NM 87545, USA \\
+ V. G. Mitts, CAMD, Louisiana State University, Baton Rouge, LA 70806, USA \\
+ K. Makino, A. McCausey, Michigan State University, East Lansing, MI 48824, USA \\
+% A. McCausey, FRIB, Michigan State University, East Lansing, MI 48824, USA \\
+ T. Tanaka, LEBRA, Nihon University, Funabashi 274-8501, Japan \\
+ C. Horak, Oak Ridge National Laboratory, Oak Ridge, TN 37831, USA \\
+ Y.-S. Cheng \\
+ National Synchrotron Radiation Research Center, Hsinchu 30076, Taiwan, Republic of China \\
+ J. Chrin\thanks{jan.chrin@psi.ch (MS Word)}, Paul Scherrer Institut, 5232 Villigen PSI, Switzerland \\
+ D.-E. Kim, G.-H. Kim, K.-S. Kim, N.-Y. Kim, E.-H. Lee \\
+ Pohang Accelerator Laboratory, Gyeongbuk, Korea\\
+ A. Uchiyama, K. Yamada, RIKEN, Wako, Saitama 351-0198, Japan \\
+ H. Chen, X. Han, W. Qi, Shanghai Institute of Applied Physics, Shanghai 201800, P. R. China \\
+ M. Montes-Loera, SLAC National Accelerator Laboratory, Menlo Park, CA 94025, USA \\
+ S. Waller, STFC Daresbury Laboratory, Warrington, WA4 4AD, UK \\
+ K. Tavakoli, Synchrotron Soleil, Saint-Aubin, 91192 Gif-sur-Yvette, France \\
+ E. Akers, A. Cuffe, T. Satogata\thanks{todd.satogata@jlab.org (MS Word for Mac)} \\
+ Thomas Jefferson National Accelerator Facility, Newport News, VA 23606, USA \\
+ J. Thomson, TRIUMF, Vancouver, BC V6T 2A3, Canada \\
+ \textsuperscript{1}also at JP Scientific (Nantwich) Ltd, UK}
+
+ \maketitle
+
+%\raggedend
+
+\end{document}
diff --git a/macros/latex/contrib/jacow/jacow.cls b/macros/latex/contrib/jacow/jacow.cls
new file mode 100644
index 0000000000..36df55ad00
--- /dev/null
+++ b/macros/latex/contrib/jacow/jacow.cls
@@ -0,0 +1,503 @@
+%%
+%% This file has been developed as a common template for papers
+%% destined for electronic production for Accelerator Conferences
+%%
+%% See the JACoW website for more information
+%%
+%% http://jacow.org/
+%%
+%% This work 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. This version of this license is in
+%% http://www.latex-project.org/lppl/lppl-1-3c.txt
+%% and 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".
+%%
+%% This Current Maintainer of this work is Volker RW Schaa.
+%%
+%% This work consists of the following files
+%% jacow.cls this class file
+%% JACoW_LaTeX_A4.tex A4/letter templates to demonstrate the
+%% JACoW_LaTeX_Letter.tex .. use and explain the various parameters
+%% .. and settings for a submission to
+%% .. a JACoW conference proceedings
+%% JACoW_LaTeX_A4.pdf template in format A4 and European
+%% settings (citation and hyphenation)
+%% JACoW_LaTeX_Letter.pdf template in format letter and American
+%% setting (citation and hyphenation)
+%% annexes-A4.tex Annexes A-C which are included in "JACoW_LaTeX_A4.tex"
+%% annexes-Letter.tex Annexes A-C which are included in "JACoW_LaTeX_Letter.tex"
+%%
+%% JACpic_mc.pdf a graphic showing the JACoW page format
+%% JACpic2.jpg a graphic for a full width figure and
+%% multiline caption
+%% jacow-collaboration.tex an example title page showing the
+%% jacow-collaboration.pdf JACoW Colloaboration, the responsible
+%% editors for the various platform
+%% dependent templates (LaTeX, Word on PC and
+%% Mac, ODF). The PDF is included in the template
+%%
+%
+% v0.1 to 1.3 : JAC2000.cls
+% Special thanks to John Jowett and Michel Goossens from CERN and
+% Martin Comyn at TRIUMF for their significant contributions to
+% this class file over the period 1996 to 2000.
+% John Poole
+% March 2000
+% v1.4 : JAC2001.cls
+% JAC2001.cls is a modified version of JAC2000.cls to produce indented
+% first paragraphs after section, subsection and subsubsection headings.
+% Martin Comyn April 2001
+%
+% v1.5 : JAC2003.cls
+% This is a modified version of JAC2003.cls to adjust space around
+% section and subsection headers to be more consistent with JACoW Word
+% templates. Todd Satogata March 2011
+%
+% v 1.6 : jacow.cls
+% This is a complectly rewritten version of JAC2003.cls which needs a current
+% TeX-System to run.
+% Ulrike Fischer, November 2013
+%
+% v 1.7
+% - small change to correct the text block inside JACoW's magic red borders for
+% a4paper (aca4); top has been set 18.5mm (19mm is defined in the template but
+% leaves descenders outside the lower y margin).
+% - duplicate {boxit} removed
+% Volker RW Schaa, 14 April 2014
+%
+% v1.8
+% - added setup for \micro sign which disappears when using XeTeX or LuaTeX
+% with unicode-math. Ulrike Fischer, 21 April 2014
+%
+% v1.9
+% - fixed the pdfLaTeX warnings for the text/math-micro hack
+% Ulrike Fischer, 22 April 2014
+%
+% v1.91
+% - Ligatures=TeX switch introduced to accommodate
+% Ulrike Fischer, 22 April 2014
+%
+% v1.92
+% - settings for top margin have to be different in A4 and letter to accommodate
+% JACoW's PitStop Action List. This was found after receiving Plamen Hopchev's
+% email about margins and testing the workflow with cropping the bounding box
+% which starts at the lower left edge and not at the top (see graphic JACpic_mc
+% in the template for measures).
+% Volker RW Schaa, 29 April 2014
+% v1.93
+% - setting the bottom margin (19mm) without top solves the problem for different
+% A4/Letter settings. This was already the default in v1.6. Pointed out by
+% Plamen Hopchev. To accommodate the descenders the bottom margin has been set
+% to 56pt now.
+% Volker RW Schaa, 01 May 2014
+%
+% v1.94
+% - the micro sign in UTF-8 prevents ASCII format of the cls file. Ulrike pointed
+% out a hack in http://tex.stackexchange.com/questions/172968/hide-notation-from-pdftex
+% which is now introduced.
+% Volker RW Schaa, 02 May 2014
+%
+% v1.95
+% - only change to the version 1.94 are the extended documenation and license
+% statement (lppl1.3c) as preparation for publication on CTAN.
+% Volker RW Schaa, 02 May 2014
+%
+% v1.96
+% - modification of bibatex style information. Since the JACoW template Feb-2016
+% the bibliography requires the IEEEtran style. Heine provided an adapted
+% version using the required values of the template:
+% + ieee biblatex style instead of numeric-compv
+% + doi field is cleared for all entries
+% + et al. is used when there are > 6 authors (maxnames=6). In that case,
+% only the first author is mentioned (minnames=1)
+% + url field is cleared for articles and inproceedings
+% + giveninits=true reduces all given names to initials
+% Heine Dølrath Thomsen, 30 June 2016
+%
+% v2.00
+% - after using v1.96 during conferences where DOIs/URLs were present in biblio-
+% graphic records, the following changes to Heine's version have been made:
+% + doi field allowed
+% + url field allowed
+% Volker RW Schaa, 02 May 2014
+% v2.1 new options introduced
+% flushend: new: keeplastbox
+% siunitx: new: binary-units=true
+% BibLaTeX: changed: style=ieee => bibstyle=ieee, citestyle=numeric-comp
+% new: dashed=false
+% removed: doi=false
+% Volker RW Schaa, 02 May 2014
+%
+% v2.2
+% - adapted to the changes of template version 2018-02
+% - made this one official
+% Volker RW Schaa, 23 Feb 2018
+%
+% v2.3
+% - font for tt switched to newtxtt with option zerostyle=d (dotted 0)
+% Volker RW Schaa, 15 Jan 2019
+%
+% v2.4
+% - version 2.3 did not work for XeTeX/LuaTeX, therefore font change using
+% \def\UrlFont and switching the fontencoding to T1 (suggested by Ulrike Fischer)
+% - package amsmath included to provide
+% Volker RW Schaa, 01 Apr 2019
+%
+\def\fileversion{2.4}
+\def\filedate{2019/04/01}
+\def\docdate {2019/04/01}
+
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesClass{jacow}[\filedate\space Version \fileversion]
+
+\typeout{------------------------------------------------------------------------}
+\typeout{LaTeX2e Class file for Accelerator Conference publication for LaTeX2e users}
+\typeout{ }
+\typeout{Use the boxit option to draw a box on page showing the correct margins}
+\typeout{ }
+\typeout{Itemize, Enumerate and Description environments are compact versions}
+\typeout{------------------------------------------------------------------------}
+\typeout{ }
+
+\newif\ifjacowbiblatex
+\newif\ifjacowrefpage
+
+\DeclareOption{acus}{%
+ \PassOptionsToPackage{paper=letterpaper}{geometry}
+ \typeout{Setup for US LETTER PAPER}}
+
+\DeclareOption{letterpaper}{%
+ \PassOptionsToPackage{paper=letterpaper}{geometry}
+ \typeout{Setup for US LETTER PAPER}}
+
+\DeclareOption{a4paper}{%
+ \PassOptionsToPackage{paper=a4paper}{geometry}
+ \typeout{Setup for A4 PAPER}}
+
+\DeclareOption{aca4}{%
+ \PassOptionsToPackage{paper=a4paper}{geometry}
+ \typeout{Setup for A4 PAPER}}
+
+\DeclareOption{boxit}{\PassOptionsToPackage{showframe}{geometry}}
+
+\DeclareOption{biblatex}{\jacowbiblatextrue}
+
+\DeclareOption{refpage}{\jacowrefpagetrue}
+
+\DeclareOption*{\PassOptionsToClass{\CurrentOption}{article}}
+
+\ExecuteOptions{aca4}
+\ProcessOptions
+
+\RequirePackage{fix-cm}
+\LoadClass[10pt,twocolumn]{article}
+\RequirePackage[keeplastbox]{flushend} %% modified
+% Tools:
+\RequirePackage{etoolbox}
+\RequirePackage{ifxetex}
+\RequirePackage{ifluatex}
+\RequirePackage{textcase}
+%
+%Add thanks to the list of "\@nonchangecase"-commands from textcase:
+\def\@uclcnotmath#1#2#3#4{\begingroup
+ #1%
+ \def\({$}\let\)\(%
+ \def\NoCaseChange##1{\noexpand\NoCaseChange{\noexpand##1}}%
+ \@nonchangecase\label
+ \@nonchangecase\ref
+ \@nonchangecase\ensuremath
+ \@nonchangecase\thanks %new
+ \@nonchangecase\si %new
+ \@nonchangecase\SI %new
+ \def\cite##1##{\toks@{\noexpand\cite##1}\@citex}%
+ \def\@citex##1{\NoCaseChange{\the\toks@{##1}}}%
+ \def\reserved@a##1##2{\let#2\reserved@a}%
+ \expandafter\reserved@a\@uclclist\reserved@b{\reserved@b\@gobble}%
+ \protected@edef\reserved@a{\endgroup
+ \noexpand\@skipmath#3#4$\valign$}%
+ \reserved@a}
+
+\RequirePackage[detect-mode,detect-weight, binary-units=true]{siunitx}
+\RequirePackage{graphicx}
+\RequirePackage{booktabs}
+\RequirePackage[figureposition=bottom,tableposition=top,skip=5pt]{caption}
+\RequirePackage{xcolor}
+\RequirePackage{amsmath}
+\AtEndPreamble{\RequirePackage[autostyle]{csquotes}}
+
+
+% Page layout:
+\RequirePackage[%
+ textwidth=170mm,
+ textheight=241mm,
+ heightrounded,
+ left=20mm,
+ bottom=56pt,
+ columnsep=5mm,
+ noheadfoot,
+ nomarginpar,
+ twocolumn]
+ {geometry}
+
+\columnseprule 0pt
+\usepackage[hang]{footmisc}
+\setlength{\footnotemargin}{.6em}
+
+
+\pagestyle{empty}
+
+\RequirePackage{url}
+%
+% redefine the default Typewriter Font to newtxtt with dotted zeros (v2.3)
+%
+\RequirePackage[zerostyle=d]{newtxtt}
+\newcommand\urlZDtxt{\fontencoding{T1}\fontfamily{newtxtt}\selectfont}
+\def\UrlFont{\urlZDtxt}
+
+\ifboolexpr{bool{xetex} or bool{luatex}}
+ {}
+ { \catcode`\^^^=9
+ }
+
+\ifboolexpr{bool{xetex} or bool{luatex}}
+ { \let\ori@vdots\vdots
+ \RequirePackage{unicode-math}
+ \AtBeginDocument{\let\vdots\ori@vdots}
+ \setmainfont[Ligatures=TeX]{TeX Gyre Termes}
+ \setmathfont{TeX Gyre Termes Math}
+ \sisetup{
+ math-micro = \text{^^^^03bc},
+ text-micro = ^^^^03bc
+ }
+ }
+ {
+ % Fonts: Times clones
+ \RequirePackage{textcomp}
+ \RequirePackage[T1]{fontenc}
+ \RequirePackage{lmodern}
+ \RequirePackage{tgtermes}
+ \RequirePackage{newtxmath}
+ \input{glyphtounicode}
+ \pdfgentounicode=1
+% \RequirePackage{cmap}
+ }
+
+\RequirePackage{microtype}
+
+%Lists
+
+\RequirePackage{enumitem}
+\newenvironment{Enumerate}{\begin{enumerate}[nosep]}{\end{enumerate}}
+\newenvironment{Itemize}{\begin{itemize}[nosep]}{\end{itemize}}
+\newenvironment{Description}{\begin{description}[nosep]}{\end{description}}
+
+
+%Floatparameter:
+\renewcommand{\topfraction}{.95}
+\renewcommand{\bottomfraction}{.95}
+\renewcommand{\textfraction}{0.1}
+\renewcommand{\floatpagefraction}{0.8}
+
+
+%headings:
+% section: Uppercase only for text
+\renewcommand{\section}
+ {%
+ \@startsection{section}{1}{0mm}
+ {2.0ex plus 0.8ex minus .1ex}{1.0ex plus .2ex}
+ {\normalfont\large\bfseries\mathversion{bold}\centering\MakeTextUppercase}%
+ }%
+
+\renewcommand\subsection
+ {%
+ \@startsection{subsection}{2}{\z@}
+ {1.4ex plus .8ex minus .17ex}{0.8ex plus .17ex}
+ {\normalfont\large\itshape}%
+ }
+
+\renewcommand\subsubsection
+ {%
+ \@startsection{subsubsection}{3}{\parindent}
+ {2.5ex plus .7ex minus .17ex}{-1em}
+ {\normalfont\normalsize\bfseries}%
+ }
+
+\renewcommand\paragraph
+ {%
+ \@startsection{paragraph}{4}{\z@}
+ {2.5ex plus .7ex minus .17ex}{-1em}
+ {\normalfont\normalsize\itshape}%
+ }
+
+\renewcommand\subparagraph
+ {%
+ \@startsection{subparagraph}{4}{\parindent}
+ {2.25ex plus .7ex minus .17ex}{-1em}
+ {\normalfont\normalsize\bfseries}%
+ }
+
+\setcounter{secnumdepth}{0}
+
+% This definition of \maketitle taken from article.sty, and has been
+% somewhat modified.
+
+\def\maketitle{\par
+ \begingroup
+ \def\thefootnote{\fnsymbol{footnote}}
+ \def\@makefnmark{\hbox
+ to 5pt{$^{\@thefnmark}$\hss}}
+ \twocolumn[\@maketitle]
+ \@thanks
+ \endgroup
+ \enlargethispage{\jac@copyrightspace}%
+ \setcounter{footnote}{0}
+ \let\maketitle\relax
+ \let\@maketitle\relax
+ \gdef\@thanks{}\gdef\@author{}\gdef\@title{}\let\thanks\relax}
+
+\newlength{\titleblockheight} % so user can change it if need be
+\setlength{\titleblockheight}{3.5cm}
+
+\newlength\titleblockstartskip
+\setlength\titleblockstartskip{3pt}
+
+
+\newlength\titleblockmiddleskip
+\setlength\titleblockmiddleskip{1em}
+
+\newlength\titleblockendskip
+\setlength\titleblockendskip{1em}
+
+
+\def\@maketitle{%
+ \vskip \titleblockstartskip \centering
+ {\Large\bfseries \MakeTextUppercase{\@title} \par}
+ \vskip \titleblockmiddleskip % Vertical space after title.
+ {\large\begin{tabular}[t]{@{}c@{}}\@author \end{tabular}\par}
+ \vskip \titleblockendskip}
+
+
+% The \copyrightspace command is used to produce a blank space in the first
+% column where a copyright notice may go. It works by producing
+% with \enlargethispage and is inserted by \maketitle.
+% The command should be issued in the preamble.
+
+\newcommand\jac@copyrightspace{0pt}
+\newcommand\copyrightspace[1][1cm]{\renewcommand\jac@copyrightspace{-#1}}
+
+\ifboolexpr{bool{@titlepage}}
+{\renewenvironment{abstract}
+ {\list{}{%
+ \setlength{\leftmargin}{\dimexpr\textwidth/2-0.75\columnwidth}%
+ \setlength{\rightmargin}{\dimexpr-0.75\columnwidth-\columnsep}%
+ \setlength{\listparindent}{\parindent}%
+ \setlength{\itemsep}{\parskip}%
+ \setlength{\itemindent}{\z@}%
+ \setlength{\topsep}{\z@}%
+ \setlength{\parsep}{\parskip}%
+ \setlength{\partopsep}{\z@}%
+ \let\makelabel\@gobble
+ \setlength{\labelwidth}{\z@}%
+ \advance\@listdepth\m@ne }%
+ \item\relax\subsection*{Abstract}}
+ {\endlist\clearpage}
+}
+{%
+ \renewenvironment{abstract}
+ {\subsection*{Abstract}}
+ {\par}
+}
+\ifboolexpr{bool{jacowbiblatex}}
+%2.00 {\RequirePackage[style=ieee,sorting=none,giveninits=true,doi=false,maxnames=6,minnames=1]{biblatex}
+%2.1 {\RequirePackage[style=ieee,sorting=none,giveninits=true,maxnames=6,minnames=1]{biblatex}
+%2.2
+ {\RequirePackage[bibstyle=ieee,citestyle=numeric-comp,dashed=false,sorting=none,giveninits=true,maxnames=6,minnames=1]{biblatex}
+ \renewbibmacro*{url+urldate}{%
+ \iffieldundef{url}
+ {}
+ {\printfield{url}%
+ \nopunct}}%
+ \DeclareFieldFormat{url}{\url{#1}}
+ \DeclareFieldFormat{eprint}{#1}
+%% when to activate this? Paper format acus/letter
+% \DefineBibliographyExtras{american}{\stdpunctuation} % mod
+ % Drop urls for article and inproceedings entries
+%2.00 \DeclareFieldFormat
+%2.00 [article,inproceedings]
+%2.00 {url}{}
+ %
+ \setlength\bibitemsep{0pt}
+ \setlength\bibparsep{0pt}
+ \setlength\biblabelsep{5pt}
+ \ifjacowrefpage\preto\blx@bibliography{\clearpage}\fi
+ \AtBeginBibliography{\small\clubpenalty4000\widowpenalty4000}%
+ }
+ {\RequirePackage{cite}
+ % Redefine to use smaller fonts
+ \def\thebibliography#1{\setlength{\itemsep}{0pt}\setlength{\parsep}{0pt}%
+ \ifjacowrefpage\clearpage\fi
+ \section*{REFERENCES\@mkboth
+ {REFERENCES}{REFERENCES}}\small\list
+ {[\arabic{enumi}]}{\settowidth\labelwidth{[#1]}\leftmargin\labelwidth
+ \advance\leftmargin\labelsep
+ \usecounter{enumi}}
+ \def\newblock{\hskip .11em plus .33em minus .07em}
+ \sloppy\clubpenalty4000\widowpenalty4000
+ \sfcode`\.=1000\relax}
+ \let\endthebibliography=\endlist
+ }
+
+
+%\sloppy
+\clubpenalty10000\widowpenalty10000
+\flushbottom
+%-----------------------------------------------------------------------
+
+%avoid bug of fixltx2e:
+%http://www.latex-project.org/cgi-bin/ltxbugs2html?pr=latex/4023
+\RequirePackage{fixltx2e}%
+\def\@outputdblcol{%
+ \if@firstcolumn
+ \global\@firstcolumnfalse
+ \global\setbox\@leftcolumn\copy\@outputbox
+ \splitmaxdepth\maxdimen
+ \vbadness\maxdimen
+ \setbox\@outputbox\vbox{\unvbox\@outputbox\unskip}%new
+ \setbox\@outputbox\vsplit\@outputbox to\maxdimen
+ \toks@\expandafter{\topmark}%
+ \xdef\@firstcoltopmark{\the\toks@}%
+ \toks@\expandafter{\splitfirstmark}%
+ \xdef\@firstcolfirstmark{\the\toks@}%
+ \ifx\@firstcolfirstmark\@empty
+ \global\let\@setmarks\relax
+ \else
+ \gdef\@setmarks{%
+ \let\firstmark\@firstcolfirstmark
+ \let\topmark\@firstcoltopmark}%
+ \fi
+ \else
+ \global\@firstcolumntrue
+ \setbox\@outputbox\vbox{%
+ \hb@xt@\textwidth{%
+ \hb@xt@\columnwidth{\box\@leftcolumn \hss}%
+ \hfil
+ \vrule \@width\columnseprule
+ \hfil
+ \hb@xt@\columnwidth{\box\@outputbox \hss}}}%
+ \@combinedblfloats
+ \@setmarks
+ \@outputpage
+ \begingroup
+ \@dblfloatplacement
+ \@startdblcolumn
+ \@whilesw\if@fcolmade \fi{\@outputpage\@startdblcolumn}%
+ \endgroup
+ \fi}
+
+\endinput