\documentclass[lineno]{jot}
% Use the documentclass option 'lineno' to view line numbers
% Enter the JOT metadata in the following
\usepackage{multirow}
\jotdetails{
volume=vv, % volume
number=nn, % number or issue
articleno=aa, % article number, eg a1 for research articles, e for editorials
year=yyyy, % year
license=ccbyncnd % choose from ccby, ccbynd, ccbyncnd
}
\newcommand{\command}[1]{{\color{codepurple}\texttt{\textbackslash #1}}}
\newcommand{\param}[1]{{\color{blue}\texttt{#1}}}
% Select the article type
\articletype{regular}
% {regular} regular contribution
% {editorial} editorial (editors only)
% {manual} manual
% {column} column (requires editor's approval)
\title{How to prepare a JOT manuscript: a users guide}
\author[$\ast$]{Alfonso Pierantonio}
\author[$\dagger$]{Mark van den Brand}
\author[$\ddagger$]{Benoit Combemale}
\author[$\S$]{Sébastien Mosser}
%\author[$\ast\ast$,2,3]{Sixth Author}
\affil[$\ast$]{Università degli Studi dell'Aquila, Italy}
\affil[$\dagger$]{Technical University of Eindhoven, The Netherlands}
\affil[$\ddagger$]{University of Toulouse \& Inria, France}
\affil[$\S$]{McMaster Centre for Software Certification, McMaster University, Canada}
%\affil[$\ast\ast$]{Author five affiliation}
\keywords{Typesetting, \LaTeX\, JOT format style.}
\runningtitle{How to prepare a JOT manuscript: a users guide} % For use in the internal pages
%% For the footnote.
%% Give the last name of the first author if only one author;
% \runningauthor{FirstAuthorLastname}
%% last names of both authors if there are two authors;
% \runningauthor{FirstAuthorLastname and SecondAuthorLastname}
%% last name of the first author followed by et al, if more than two authors.
\runningauthor{Pierantonio \textit{et al.}}
\begin{abstract}
This document illustrates how to prepare a manuscript to be submitted to the Journal of Object Technology by using the \texttt{jot.cls} (v2.5 released on 2 May, 2021) class style.
\end{abstract}
\acknowledgment{We would like to thank the reviewers of this document template for their helpful comments and suggestions.}
\begin{document}
\maketitle
\urlstyle{rm}
\section{Introduction}
This documentation describes the \LaTeX\ document class for typesetting JOT manuscripts. For an extensive introduction to \LaTeX\ please refer to~\cite{lamport1994latex}.
The JOT class \texttt{jot.cls} is based on the \LaTeX\ \texttt{article.cls} class, and as such it preserves all the commands, including the standard sectioning, floats, formulas and so on. In addition, a number of JOT-specific commands are provided. % for a more concrete document definition.
Please always use the commands provided, and do not try to redefine them as this would compromise the integrity of the document's presentation.
\begin{figure}[h!]
\centering
\fbox{\includegraphics[width=0.95\columnwidth]{figures/jot.png}}
\caption{The title page of a JOT manuscript.}\label{fig:titlepage}
\end{figure}
\section{Installing the JOT style class}
The installation of the JOT style class is straightforward: just include the file \texttt{jot.cls} in the main folder of your manuscript, i.e., the folder where the main \LaTeX\ file is located.
\section{Setting the document type}
A JOT manuscript is a two-column, double sided article that uses the Times 10pt font. To initialize the document just use the following command:
\begin{verbatim}
\documentclass[lineno]{jot}
\end{verbatim}
the parameter \param{lineno} must be removed only in the camera-ready version of the paper. The first page of the manuscript looks as illustrated in Fig.~\ref{fig:titlepage}\footnote{Please note that the current document is a \textit{manual} and as such is denoted by a different header color.}.
\section{Heading}\label{sec:heading}
In this section, we describe the commands available for defining the heading section of a JOT manuscript, i.e., all the content that comes before the abstract.
\subsection{Title}
To set the title of your manuscript use the \param{title} command:
\begin{verbatim}
\title{<your title>}
\end{verbatim}
A JOT manuscript does not have a subtitle.
\subsection{Authors}
Information about the paper authors is should be given as follows:
\begin{verbatim}
\author[<superscript symbol>]{<author>}
\end{verbatim}
for instance, the following commands define the authors of the paper shown in Fig.~\ref{fig:authors}.
\begin{verbatim}
\author[$\ast$]{Patrick M. Hanrahan}
\author[$\dagger$]{Yann LeCun}
\author[$\ddagger$]{David Patterson}
\author[$\S$]{John L. Hennessy}
\author[$\ast\ast$]{Martin Hellman}
\end{verbatim}
In case all the authors share the same affiliation, the superscript symbol must be removed as follows:
\begin{verbatim}
\author{Patrick M. Hanrahan}
\author{Yann LeCun}
\author{David Patterson}
\author{John L. Hennessy}
\author{Martin Hellman}
\end{verbatim}
\subsection{Authors' affiliations}
The affiliation of authors must be entered using the \param{affil} command:
\begin{verbatim}
\affil[<superscript symbol>]{<author affiliation>}
\end{verbatim}
making sure to have the \param{<superscript symbol>} corresponds to the same symbol as in the author definition. For example:
\begin{verbatim}
\affil[$\ast$]{Stanford University, USA}
\affil[$\dagger$]{New York University, USA}
\affil[$\ddagger$]{University of California, USA}
\affil[$\S$]{Stanford University, USA}
\affil[$\ast\ast$]{Stanford University, USA}
\end{verbatim}
Also in this case if all the authors share the same affiliation, the superscript symbol must be removed, as follows:
\begin{verbatim}
\affil{Stanford University, USA}
\end{verbatim}
These commands, together with the author entries given above, produce the author heading illustrated in Fig.~\ref{fig:authors}.
\begin{figure}[b]
\centering
\fbox{\includegraphics[width=\columnwidth]{figures/heading.png}}
\caption{An example of paper heading.}
\label{fig:authors}
\end{figure}
The affiliation should comprise the following data:
\begin{itemize}
\item \param{name},
\item \param{city}, and
\item \param{country}
\end{itemize}
the city can be omitted in case the institution is world renowned, does not have a specific address, or is comprehended in the name of the institution (e.g., Università degli Studi dell'Aquila).
\subsection{Footnotes in the paper heading}
Footnotes in the paper title, authors or affiliations are not allowed.
\subsection{Running head}
In contrast with \texttt{article.cls}, the running head is not automatically produced by the \command{maketitle} command. The running head information must be explicitly defined with the following commands:
\begin{verbatim}
\runningtitle{<title>} % for use in the internal pages
\runningauthor{<author(s)>}
\end{verbatim}
with
\begin{flushleft}
\begin{itemize}
\item \texttt{\small\command{runningauthor}\{\param{<author>}\}}, if there is only one author;
\item \texttt{\small\command{runningauthor}\{\param{<author1> and <author2>}\}}, if there are two authors;
\item \texttt{\small\command{runningauthor}\{\param{<author1> \textbackslash textit\{et al\}}\}}, if there are more than two authors.
\end{itemize}
\end{flushleft}
\subsection{Producing the header}
After entering the \command{author}, \command{affil}, \command{runningtitle}, and \command{runningauthor} described in this section, you must enter the \command{maketitle} command otherwise the heading won't be produced.
In order to reproduce all the information, the following list of commands must entered
\begin{verbatim}
\maketitle
\urlstyle{rm}
\end{verbatim}
\section{Abstract and keywords}
The abstract and the keywords are managed as in the \texttt{article.cls} class style, as follows
\begin{verbatim}
\begin{abstract}
<the abstract text goes here>
\end{abstract}
\keywords{%
first keyword,
second keyword,
more keywords.}
\end{verbatim}
Each keyword must start with a capital letter and separated from the other with a comma.
\section{Metadata and article type}
Each published JOT manuscript is endowed with metadata that are provided after the acceptance notification.
\subsection{Metadata definition}
While preparing the camera ready the following command must be entered with the correct information
\begin{verbatim}
\jotdetails{%
volume=<volumenumber>,
number=<issue number>,
articleno=<article number>,
year=<year>,
license=<license code>}
\end{verbatim}
where
\begin{flushleft}
\begin{itemize}
\item \param{articleno} can be either
\begin{itemize}
\item \param{a1}, \param{a2} and so on for regular contributions, or
\item \param{e1} for editorials (typically one per issue);
\end{itemize}
\item \param{license} can be either
\begin{itemize}
\item \param{ccby}, for the CC BY 4.0,
\item \param{ccbynd}, for the CC BY-ND 4.0, or
\item \param{ccbyncnd} for the CC BY-NC-ND 4.0.
\end{itemize}
\end{itemize}
\end{flushleft}
JOT published manuscripts are licensed under a Creative Commons Attribution 4.0 International License and its variants, which permits use, sharing, adaptation, distribution and reproduction in any medium or format, as long as it is given appropriate credit to the original author(s) and the source, provide a link to the Creative Commons licence, and indicate if changes were made. To view a copy of this licence, visit \url{http://creativecomm ons.org/licenses/by/4.0/}.
\subsection{Article type}
Different kinds of manuscripts can be published in JOT. In particular, the following article types are admissible\footnote{Additional types exist, but the are mainly used for internal purposes, such as \textit{manuals} like this document.}
\begin{itemize}
\item research contributions, i.e., peer-reviewed articles
\item editorials, i.e., articles written by the journal editors-in-chief that proposes visions and positions of interest for the journal audience.
\end{itemize}
The style of the article is typographically characterized according to the type. The syntax for specifying the article type is the following:
\begin{verbatim}
\articletype{<type>}
\end{verbatim}
where \texttt{type} can be either
\begin{itemize}
\item \param{regular}, or
\item \param{editorial}
\end{itemize}
\section{Acknowledgments}
While the acknowledgments are not part of the paper heading, they are usually entered in the preamble of after the abstract although they are printed right before the References section. The syntax is the following:
\begin{verbatim}
\acknowledgment{<acknowledgment text>}
\end{verbatim}
Alternatively, the following command aliases can be used
\begin{verbatim}
\acknowledgments
\acknowledgement
\acknowledgements
\end{verbatim}
with the same behaviour as \command{acknowledgment}.
\section{Author short bio}
A short bio of the authors (in the same order as in the title) must be included at the end of the paper, after the references, as follows:
\begin{verbatim}
\section*{About the authors}
\shortbio{<author>}{%
<short bio>
\authorcontact[homepage]{email}}
\end{verbatim}
where \command{authorcontact} is used to provide the \param{homepage} (optional) and the \param{email}.
\section{Sectioning}
As in the \texttt{article.cls} class, \texttt{jot.cls} offers the following sectioning commands
\begin{itemize}
\item \command{section\{\param{<section title>}\}}
\item \command{subsection\{\param{<subsection title>}\}}
\item \command{subsubsection\{\param{<subsubsection title>}\}}
\item \command{paragraph\{\param{<paragraph title>}\}}
\end{itemize}
For instance, an example of sectioning with the previous commands is illustrated in Fig.~\ref{fig:sectioning}.
\begin{figure}
\centering
\fbox{\includegraphics[width=0.95\columnwidth]{figures/sectioning.png}}
\caption{Formats of section headings.}
\label{fig:sectioning}
\end{figure}
\section{Figures, Tables and listings}
The \texttt{jot.cls} class supports \texttt{\{figure\}}, \texttt{\{figure*\}} (two column wide figure), \texttt{\{table\}}, \texttt{\{table*\}}, and \texttt{\{tabular\}} environments. In addition, the \texttt{\{listing\}} environment is provided by default, which means that there is no need to import the package in the main TeX file.
%In this section, the float following float environments will be described:
%\texttt{\{figure\}}, \texttt{\{figure*\}} (two column wide figure), \texttt{\{table\}}, \texttt{\{table*\}}, and \texttt{\{tabular\}} environments. In addition, the \texttt{\{listing\}} environment is provided by default as \texttt{jot.cls} offers a predefined configuration (there is no need to import the package in the main file).
\subsection{Tables}
The \texttt{jot.cls} class style supports the \texttt{\{table\}}, \texttt{\{table*\}}, and \texttt{\{tabular\}} environments. A recommendation of how tables should be displayed is shown in Table~\ref{tab:example}. In this example the table spans along the two columns, to show how the \texttt{\{table*\}} environment works.
%The table style no-matter what environment is used must conform to that of Table~\ref{tab:example} where a double sided table (with the \texttt{\{table*\}} environment) is presented. It is very important, that the tables in any submitted manuscript follows the following requirements
Moreover, tables in all JOT manuscripts should conform to the following guidelines:
\begin{itemize}
\item the header font is \texttt{\textbackslash textbf},
\item the font in the cells is \texttt{\textbackslash normalfont},
\item there are not external left and right border lines
\item all the other lines are single, and finally
\item the bottom border in the header is a double line.
\end{itemize}
\begin{table*}
\centering\footnotesize{%
\begin{tabular}{p{0.1\linewidth}|p{0.15\linewidth}|p{0.7\linewidth}}\hline
\textbf{Year} & \textbf{Recipient} & \textbf{Rationale}\\\hline\hline
\multirow{2}{*}{2019} & Pat Hanrahan & \multirow{2}{\linewidth}{For fundamental contributions to 3-D computer graphics, and the revolutionary impact of these techniques on computer-generated imagery (CGI) in filmmaking and other applications}\\\cline{2-2}
& Edwin Catmull & \\\hline
\multirow{3}{*}{2018} & Yann LeCun & \multirow{3}{\linewidth}{For conceptual and engineering breakthroughs that have made deep neural networks a critical component of computing}\\\cline{2-2}
& Geoffrey Hinton & \\\cline{2-2}
& Yoshua Bengio & \\\hline
\multirow{2}{*}{2017} & David Patterson & \multirow{2}{\linewidth}{For pioneering a systematic, quantitative approach to the design and evaluation of computer architectures with enduring impact on the microprocessor industry}\\\cline{2-2}
& John L. Hennessy & \\\hline
2016 & Tim Berners-Lee & For inventing the World Wide Web, the first web browser, and the fundamental protocols and algorithms allowing the Web to scale\\\hline
\end{tabular}}
\caption{Recent recipients of the Turing Award.}\label{tab:example}
\end{table*}
\subsection{Figures}
The \texttt{\{figure\}} and \texttt{\{figure*\}} environments work exactly as those defined in the \texttt{article.cls} class style.
\subsection{Listings}
Code listings are produced with the \texttt{listings} package that is pre-loaded and pre-configured by the \texttt{jot.cls} class, and teherefore it is not necessary to import it.
Listing~\ref{lst:listing1} shows an example of a Python program that displays the Fibonacci sequence.
\begin{lstlisting}[
language=Python,
caption=Displaying the Fibonacci sequence in Python.,
label={lst:listing1}]
# Python program to display the Fibonacci sequence
def recur_fibo(n):
if n <= 1:
return n
else:
return(recur_fibo(n-1) + recur_fibo(n-2))
nterms = 10
# check if the number of terms is valid
if nterms <= 0:
print("Plese enter a positive integer")
else:
print("Fibonacci sequence:")
for i in range(nterms):
print(recur_fibo(i))
\end{lstlisting}
\begin{lstlisting}[
language=Python,
caption=Displaying the Fibonacci sequence in Python.,
float=*,
label={lis:example}]
# Python program to display the Fibonacci sequence
def recur_fibo(n):
if n <= 1:
return n
else:
return(recur_fibo(n-1) + recur_fibo(n-2))
nterms = 10
# check if the number of terms is valid
if nterms <= 0:
print("Plese enter a positive integer")
else:
print("Fibonacci sequence:")
for i in range(nterms):
print(recur_fibo(i))
\end{lstlisting}
The \LaTeX\ code fragment that produces Listing~\ref{lst:listing1} is the following:
\begin{verbatim}
\begin{lstlisting}[
language=Python,
caption=Fibonacci sequence.]
# Python program to display the Fibonacci sequence
def recur_fibo(n):
if n <= 1:
return n
else:
return(recur_fibo(n-1) + recur_fibo(n-2))
nterms = 10
# check if the number of terms is valid
if nterms <= 0:
print("Plese enter a positive integer")
else:
print("Fibonacci sequence:")
for i in range(nterms):
print(recur_fibo(i))
\end{lstlisting}
\end{verbatim}
The listing can also span over the two column by adding the following option
\begin{verbatim}
float=*
\end{verbatim}
The outcome is shown in Listing~\ref{lis:example}.
\section{Getting the JOT \LaTeX\ template}
The JOT \LaTeX\ template can be obtained from the JOT website\footnote{\url{http://www.jot.fm}} under the section "author" where the submission guidelines are given.
\bibliography{bibliography}
\section*{About the authors}
\shortbio{Alfonso Pierantonio}{is professor at the Università degli Studi dell'Aquila (Italy) and Editor-in-Chief of the Journal of Object Technology. \editorcontact[http://pieranton.io]{alfonso.pierantonio@univaq.it}}
\shortbio{Mark van den Brand}{is professor at the Technical University of Eindhoven (The Netherlands) and Deputy Editor-in-Chief of the Journal of Object Technology. \editorcontact[]{m.g.j.v.d.brand@tue.nl}}
\shortbio{Benoit Combemale}{is professor at the University of Toulouse (France) and Deputy Editor-in-Chief of the Journal of Object Technology. \editorcontact[]{benoit.combemale@irisa.fr}}
%\onecolumngrid
\end{document}
