% -*- coding: utf-8; -*- % % Copyright (C) 2016, 2017 by Paul Gaborit % % Tis file may be distributed and/or modified % % 1. under the LaTeX Project Public License and/or % 2. under the GNU Public License. % \documentclass[]{iscram} \usepackage[utf8]{inputenc} \usepackage{lipsum} \usepackage{tikz} \usepackage{fancyvrb} \usepackage{listings} \usepackage{enumitem} \usepackage{tcolorbox} \usepackage{multicol} \usepackage{siunitx} \lstdefinestyle{common}{ xleftmargin=.5em, xrightmargin=.5em, frame=single,framesep=.5em,framerule=0pt, fancyvrb=true, basicstyle=\ttfamily, keywordstyle=\color{cyan!50!blue!75!black}\bfseries, commentstyle=\color{red!50!black}\itshape, stringstyle=\ttfamily\color{green!50!black}, numbers=none, showspaces=false, showstringspaces=false, fontadjust=true, keepspaces=true, flexiblecolumns=true, emphstyle=\color{red}, } \lstdefinestyle{TeX}{ style=common, backgroundcolor=\color{blue!5}, aboveskip=5pt, belowskip=5pt, language=[LaTeX]TeX, moretexcs={ % abstract, addbibresource, iscramset, keywords, mainmatter, maketitle, printbibliography, subsection, subsubsection, url, urldef, href, includegraphics, ldots, parencite, citeauthor, citeyear, citetitle, midrule, toprule, bottomrule % }, fancyvrb=true, } \lstdefinestyle{console}{ style=common, backgroundcolor=\color{gray!10}, aboveskip=5pt, belowskip=5pt, } \newlist{options}{description}{1} \setlist[options]{% beginpenalty=10000,% itemsep=.5\parskip plus .3\parskip minus .2\parskip, parsep=.5\parskip plus .3\parskip minus .2\parskip, topsep=.5\parskip plus .3\parskip minus .2\parskip, partopsep=.5\parskip plus .3\parskip minus .2\parskip, style=nextline,labelindent=1em,% font=\normalfont\ttfamily} \colorlet{macro color}{cyan!50!blue!75!black} \colorlet{option color}{red!50!black} \colorlet{generic color}{green!40!black} \newcommand\macro[1]{{\textcolor{macro color}{\ttfamily\bfseries\string#1}}} \newcommand\option[1]{\textcolor{option color}{\ttfamily#1}} \newcommand\generic[1]{\textcolor{generic color}{\ttfamily\itshape\makebox{<#1>}}} \newtcolorbox{pseudoTeX}{colback=blue!5,colframe=blue!5,before=\nobreak} \let\LaTeXorig\LaTeX \renewcommand\LaTeX{\bgroup\fontfamily{lmr}\selectfont\upshape\LaTeXorig\egroup} \addbibresource{iscram-class-doc.bib} \urldef{\sitewebgind}\url{http://gind.mines-albi.fr} \urldef{\sitewebminesalbi}\url{http://www.mines-albi.fr} \urldef{\gmailpaulgaborit}\url{paul.gaborit@gmail.com} \urldef{\jdmail}\url{j.doe@example.com} \urldef{\sitex}\url{www.example.com} \iscramset{ %CoRe Paper 2017={Documentation pseudo-Track}, title={ International Conference on Information Systems for Crisis Response and Management\\ \LaTeX{} Class %Publications Format }, short title={ISCRAM \LaTeX{} Class}, author={ short name={Paul Gaborit}, full name=Paul Gaborit\thanks{corresponding author}, affiliation={ Centre Génie Industriel -- Mines Albi% \thanks{\href{http://gind.mines-albi.fr}{\sitewebgind} and \href{http://www.mines-albi.fr}{\sitewebminesalbi}}\\ \href{mailto:paul.gaborit@gmail.com}{\gmailpaulgaborit} }, }, author={ full name=Sébastien Truptil, affiliation={ Centre Génie Industriel -- Mines Albi }, }, } \usepackage{tikzpagenodes} \usetikzlibrary{fit} \newcommand\iscramshowframe{% \begin{tikzpicture}[remember picture,overlay] \node[fit=(current page text area),inner sep=0,node contents=,name=cpta]; \node[fit=(current page header area),inner sep=0,node contents=,name=cpha]; \node[fit=(current page footer area),inner sep=0,node contents=,name=cpfa]; \node[fit=(current page),inner sep=0,node contents=,name=cp]; \path (cpta.north) -- (cpta.center) coordinate[pos=.5] (mid); \draw[red] (cpta.north west) rectangle (cpta.south east); \draw[red] (cpha.north west) rectangle (cpha.south east); \draw[red] (cpfa.south west) -- (cpfa.south east); \draw[red,dashed] (cpta.north west) -- (cpta.north west -| cp.west) coordinate[pos=.5] (mid); \draw[<->,red] (mid) -- (mid |- cp.north) node[pos=.5,above,sloped]{\SI{1}{in}}; \draw[red,dashed] (cpta.south west) -- (cpta.south west -| cp.west) coordinate[pos=.5] (mid); \draw[<->,red] (mid) -- (mid |- cp.south) node[pos=.5,above,sloped]{\SI{1}{in}}; \draw[<->,red] (cpta.west) -- (cpta.west -| cp.west) node[pos=.5,above,sloped]{\SI{1}{in}}; \draw[<->,red] (cpta.east) -- (cpta.east -| cp.east) node[pos=.5,above,sloped]{\SI{1}{in}}; \draw[red,dashed] (cpha.north east) -- (cpha.north east -| cp.east) coordinate[pos=.5] (mid); \draw[<->,red] (mid) -- (mid |- cp.north) node[pos=.5,above,sloped]{\SI{1/2}{in}}; \draw[red,dashed] (cpfa.south east) -- (cpfa.south east -| cp.east) coordinate[pos=.5] (mid); \draw[<->,red] (mid) -- (mid |- cp.south) node[pos=.5,above,sloped]{\SI{1}{cm}}; \end{tikzpicture}% } \begin{document} \maketitle \makeatletter {\centering\large\iscram@version{}\\\iscram@date\par} \makeatother \abstract{ In this document we describe the formatting requirements for the Proceedings of ISCRAM papers. \emph{Please review this document carefully: submissions must follow the format presented here} and be sure to adhere to the formatting requirements as this will ultimately be your camera-ready version, delivered as pdf. \emph{Please note several limitations on length:} (1) your abstract should be no more than 150 words, (2) your entire paper should be between \pgfmathprintnumber{4000} and \pgfmathprintnumber{8000} words in length for \textbf{CoRe Papers} (presenting completed work including a complete description of methods, results and validation), including all materials and references. Or (2) your entire paper should be between \pgfmathprintnumber{3000} to \pgfmathprintnumber{6000} words in length for \textbf{WiPe Papers} (presenting work in earlier stages, outlining and discussing concepts and methods and presenting first results), including all materials and references. \emph{Please make sure that your initial submission does not include any author identifying information: use the \option{anonymous} class option.} Avoid identifying self-citations as your own work (e.g. ``In our previous research (Author Year) we found \ldots{}''). Instead simply say ``Previous research (Author Year) found \ldots{}'' Keep the self-citations in the bibliography so that reviewers may refer to them if necessary. This will ensure a proper double-blind-review process. If your paper is accepted please remove the \option{anonymous} option before the final upload. } \keywords{Guides, Instructions, Conference Publications, ISCRAM \LaTeX{} Class.} \section{Documentation} The figure~\ref{fig:exampledoc} (at the end of this document) shows an example of use of the ISCRAM document class. \subsection{How to load the \texttt{iscram} document class} The \lstinline[style=TeX]{iscram} document class accepts some \generic{options}. You may use: \begin{pseudoTeX} \ttfamily\macro\documentclass[\generic{options}]\{iscram\} \end{pseudoTeX} or: \begin{pseudoTeX} \ttfamily\macro\documentclass\{iscram\}\\ \macro\iscramset\{\generic{options}\} \end{pseudoTeX} \subsection{\texorpdfstring{All the available \generic{options}}{The }} \begin{options} \item[\option{draft}] if this boolean option is set, the class shows any overfull boxes. \emph{Note:} don't use this option in your final submission. \item[\option{anonymous}] if this boolean option is set, the \texttt{iscram} class produces an anonymous version of the paper (no author, no affiliation, no e-mail). \textbf{Use this option to submit the first version of your paper (an anonymous version)}. \item[\option{first alone}] if this boolean option is set, the first author has its own line in the list of authors. \item[\option{title}=\generic{title}] defines \generic{title} as the main title of your paper. This title is inserted in your document by \macro\maketitle. \item[\option{short title}=\generic{short title}] defines \generic{short title} (up to 8 words) as the short title of your paper, used in the header. \item[\option{author}=\{\option{short name}=\generic{short name}, \option{full name}=\generic{full name}, \option{affiliation}=\generic{affiliation}\}] appends an author (with its affiliation) at the end of the list of authors (inserted in your paper by \macro\maketitle). The \emph{\generic{affiliation}} may contain several lines (separated by \macro{\\}). To add several authors, this option can be use several times. The \emph{\generic{short name}} (default value: \emph{\generic{full name}}) of the first author is used in the header of your paper. \item[\option{footer/line 1}=\generic{text}, \option{footer/line 2}=\generic{text}, \option{footer/line 3}=\generic{text}] define respectively \generic{text} as content of the first line, second line and third line of the footer. \end{options} \subsubsection{Prefefined styles for 2017 edition} \begin{options} \item[\option{iscram 2017 footer}] a predefined style that sets the two last lines of the footer for a paper published in ISCRAM 2017. \item[\option{WiPe Paper 2017}=\generic{track name}] a predefined style that sets the three lines of the footer for a \textbf{WiPe Paper} published in the track \emph{\generic{track name}} in ISCRAM 2017 (choose the appropriate track or use ``Open Track'' if you do not have a specific track in mind). \item[\option{CoRe Paper 2017}=\generic{track name}] a predefined style that sets the three lines of the footer for a \textbf{CoRe Paper} published in the track \emph{\generic{track name}} in ISCRAM 2017 (choose the appropriate track or use ``Open Track'' if you do not have a specific track in mind). \end{options} \subsubsection{Prefefined styles for 2018 edition} \begin{options} \item[\option{iscram 2018 footer}] a predefined style that sets the two last lines of the footer for a paper published in ISCRAM 2018. \item[\option{WiPe Paper 2018}=\generic{track name}] a predefined style that sets the three lines of the footer for a \textbf{WiPe Paper} published in the track \emph{\generic{track name}} in ISCRAM 2018 (choose the appropriate track or use ``Open Track'' if you do not have a specific track in mind). \item[\option{CoRe Paper 2018}=\generic{track name}] a predefined style that sets the three lines of the footer for a \textbf{CoRe Paper} published in the track \emph{\generic{track name}} in ISCRAM 2018 (choose the appropriate track or use ``Open Track'' if you do not have a specific track in mind). \end{options} \subsection{Using packages} In your preamble, you may use your prefered packages with, for example (choose the appropriate \generic{inputcoding}): \begin{pseudoTeX} \ttfamily\macro\usepackage[\generic{inputcoding}]\{inputenc\} \end{pseudoTeX} \subsubsection{Packages loaded by the \texttt{iscram} class} The \texttt{iscram} class requires (and loads) some packages: \begin{multicols}{6} \texttt{biblatex}\\ \texttt{booktabs}\\ \texttt{caption}\\ \texttt{etex}\\ \texttt{etoolbox}\\ \texttt{float}\\ \texttt{fontenc}\\ \texttt{geometry}\\ \texttt{hyperref}\\ \texttt{microtype}\\ \texttt{newtxmath}\\ \texttt{nowidow}\\ \texttt{newtxtext}\\ \texttt{pgfopts}\\ \texttt{titlesec}\\ \texttt{url}\\ \texttt{xcolor} \end{multicols} To pass additional \generic{options} to one of these \generic{package}, you may call \macro\PassOptionsToPackage{} \emph{before} the call to \macro\documentclass{}: \begin{pseudoTeX} \ttfamily\macro\PassOptionsToPackage\{\generic{options}\}\{\generic{package}\}\\ \macro\documentclass\{iscram\} \end{pseudoTeX} \subsection{Useful commands} Here are described some useful commands in order of usage: \begin{options} \item[\macro\addbibresource\{\}] call this command in your preamble to add a \emph{\texttt{bibfile}} as a resource to find your bibliographic references. \item[\macro\maketitle] to create a new page with the title and the list of authors or your paper (to specifiy \emph{title} and \emph{authors}, use class options or use \macro\iscramset{}). \item[\macro\abstract\{\generic{abstract}\}] to insert an \generic{abstract} as a section of your paper. \item[\macro\keywords\{\generic{keywords}\}] to insert the list of \generic{keywords} as a subsection of your paper. \item[\macro\section\{\generic{section title}\}] to insert a new section (sans-serif font, uppercase, bold, 10bp). \item[\macro\subsection\{\generic{subsection title}\}] to insert a new subsection (sans-serif font, bold, 10bp). \item[\macro\subsubsection\{\generic{subsubsection title}\}] to insert a new subsubsection (sans-serif font, italice, 10bp). \item[\macro\cite\{\generic{key}\} or \macro\cite\{\generic{key1},\generic{key2}\}] to insert one or more bibliographic references, referenced by \generic{key}, \generic{key1}, \generic{key2} \ldots{} \item[\macro\citeauthor\{\generic{key}\}] to insert the authors from the \generic{key} bibliographic reference. \item[\macro\citeyear\{\generic{key}\}] to insert the year of publication of the \generic{key} bibliographic reference. \item[\macro\citetitle\{\generic{key}\}] to insert the title of the \generic{key} bibliographic reference. \item[\macro\printbibliography] to insert the list of the cited references. Compile your document with \texttt{latexmk} or use \texttt{biber} (not \texttt{bibtex}) after a first compilation to produce the correct bibliographic file (\texttt{.bbl}) from your bibliographic sources (\texttt{.bib}). \end{options} \subsection{Compilation} The better way to compile your document is to use the \texttt{latexmk} tool: \begin{lstlisting}[style=console] latexmk -pdf my-paper.tex \end{lstlisting} You may use the traditional method: \begin{lstlisting}[style=console] pdflatex my-paper.tex biber my-paper pdflatex my-paper.tex pdflatex my-paper.tex \end{lstlisting} \section{Tips and Tricks} \subsection{Compatibility} The \texttt{iscram} class requires recent \TeX{} distributions (MikTeX or TeXLive 2016). For any questions, problems, suggestions concerning the iscram class, contact the authors by mail (\href{mailto:paul.gaborit@gmail.com}{\gmailpaulgaborit}). \subsection{Title and Authors} \subsubsection{Add footnotes in title or authors descriptions} Use \macro{\thanks} to add footnotes attached to your \option{title} or to the \option{name} of an author or to its \option{affiliation} (\emph{note:} don't use \macro{\thanks} into the \option{short title} or \option{short name} options). \subsubsection{Links to web sites and to e-mail address} You may use \macro{\href}, \macro{\urldef} and \macro{\url} to add links to web pages or to e-mail address. \begin{minipage}{.32\linewidth} e-mail: \href{mailto:j.doe@example.com}{\jdmail}\\ web site: \href{http://www.example.com/}{\sitex} \end{minipage} \hfill \begin{minipage}{.65\linewidth} In your peamble: \begin{lstlisting}[style=TeX] \urldef{\jdmail}\url{j.doe@example.com} \urldef{\sitex}\url{www.example.com} \end{lstlisting} Then in your document: \begin{lstlisting}[style=TeX] e-mail: \href{mailto:j.doe@example.com}{\jdmail}\\ web site: \href{http://www.example.com/}{\sitex} \end{lstlisting} \end{minipage} \subsubsection{First author is important} Use the \option{first alone} option to emphasize the first author: with this option, the first author (and its affiliation) is alone on its line just below the title. The others authors are grouped two by two. \subsection{Abstract and Keywords} Every submission should begin with an \macro{\abstract} of no more than \textbf{150 words}, followed by a set of \textbf{up to five keywords} (coma separated values). The abstract should be a concise statement of the problem, approach, and conclusions of the work described. It should clearly state the paper's contribution to the field. \subsection{Figures and Tables} Figures and tables should be centered. The caption of a figure should be \emph{below} the figure. The caption of a table should be \emph{above} the table. Read the documentation of the \texttt{booktabs} package to find useful advices about composition of tables. The \texttt{iscram} class uses TeX Gyre Termes (similar to Times) as serif font and TeX Gyre Heros (similar to Helvetica) as sans-serif font. You should use the same fonts in your figures and tables. \subsubsection{Examples of figures} Here is the code of the figure~\ref{fig:HMI} (a simple figure). \begin{lstlisting}[style=TeX] \begin{figure} \centering \includegraphics[width=4cm]{HMI} \caption{Human Computer Interaction} \label{fig:HMI} \end{figure} \end{lstlisting} \begin{figure} \centering \includegraphics[width=4cm]{HMI} \caption{Human Computer Interaction} \label{fig:HMI} \end{figure} Here is the code of the figure~\ref{fig:HMI2} (a figure with a description). \begin{lstlisting}[style=TeX] \begin{figure} \centering \begin{minipage}[c]{.6\linewidth} Here, some text to describe the illustration on the right. This figure combines two minipages. \end{minipage} \hfill \begin{minipage}[c]{.35\linewidth} \centering \includegraphics[width=4cm]{HMI}\par \end{minipage} \caption{Human Computer Interaction (with description)} \label{fig:HMI2} \end{figure} \end{lstlisting} \begin{figure} \centering \begin{minipage}[c]{.6\linewidth} Here, some text to describe the illustration on the right. This figure combines two minipages. \end{minipage} \hfill \begin{minipage}[c]{.35\linewidth} \centering \includegraphics[width=4cm]{HMI}\par \end{minipage} \caption{Human Computer Interaction (with description)} \label{fig:HMI2} \end{figure} Here is the code of the figure~\ref{fig:HMI3} (an HERE figure: note the \option{[H]} option). \begin{lstlisting}[style=TeX] \begin{figure}[H] \centering \includegraphics[width=4cm]{HMI} \includegraphics[width=4cm,angle=90]{HMI} \caption{Human Computer Interaction (example of HERE figure)} \label{fig:HMI3} \end{figure} \end{lstlisting} \begin{figure}[H] \centering \includegraphics[width=4cm]{HMI} \includegraphics[width=4cm,angle=90]{HMI} \caption{Human Computer Interaction (example of HERE figure)} \label{fig:HMI3} \end{figure} \subsubsection{Example of table} Here is the code of the table~\ref{tab:treatments}: \begin{table} \caption{A very nice table} \label{tab:treatments} \centering \begin{tabular}{rrr} \toprule & \textit{Treatment 1} & \textit{Treatment 2} \\\midrule \textit{Setting A} & 125 & 95 \\ \textit{Setting B} & 85 & 102 \\ \textit{Setting C} & 98 & 85 \\\bottomrule \end{tabular} \end{table} \begin{lstlisting}[style=Tex] \begin{table} \caption{A very nice table} \label{tab:treatments} \centering \begin{tabular}{rrr} \toprule & \textit{Treatment 1} & \textit{Treatment 2} \\\midrule \textit{Setting A} & 125 & 95 \\ \textit{Setting B} & 85 & 102 \\ \textit{Setting C} & 98 & 85 \\\bottomrule \end{tabular} \end{table} \end{lstlisting} \subsection{Bibliography: References and Citations} \emph{Your references should comprise only published material accessible to the public. Proprietary information (such as internal reports) may not be cited.} The \macro{\parencite} macro called with one or more bibliographic keys is the standard way to insert citations. You may add one or more \texttt{.bib} files as bibliographic sources via the \macro{\addbibresource} macro (in your preamble). The \texttt{biblatex} package provides many other macros to cite references. Here is an example:\par \nobreak \begin{minipage}{.5\linewidth} \begin{lstlisting}[style=TeX,basicstyle=\small\ttfamily] In \citeyear{Agarwal2000}, \citeauthor{Agarwal2000} wrote an article titled \citetitle{Agarwal2000} \parencite{Agarwal2000} \ldots{} \end{lstlisting} \end{minipage} \hfill \begin{minipage}{.475\linewidth} In \citeyear{Agarwal2000}, \citeauthor{Agarwal2000} wrote an article titled \citetitle{Agarwal2000} \parencite{Agarwal2000} \ldots{} \end{minipage} All our references: \parencite{pittir13924, Tractinsky:1997:AAU:258549.258626, Shneiderman:1997:DUI:523237, Ghani:1991:EFC:126686.150736, ajzen1988attitudes, AJZEN1991179,Agarwal2000}. At the end of your paper, you should call the \macro{\printbibliography} macro to insert all the cited references. \printbibliography[heading=bibliography] \iscramshowframe \section{Changes} \begin{itemize} \item \textbf{v1.1.0} 2018 edition update. \item \textbf{v1.0.2} PDF documentation included into CTAN package. \item \textbf{v1.0.1} Fix bibliography style for papers with same authors. First release to CTAN. \item \textbf{v1.0.0} First public release. \end{itemize} \begin{figure} \centering \begin{lstlisting}[style=TeX] \documentclass{iscram} \iscramset{ CoRe Paper 2018={Open Track}, title={Example of title}, short title={Example of short title}, author={ short name={J. Doe}, full name={John Doe}, affiliation={Affiliation\\j.doe@example.com}, }, } \addbibresource{example.bib} \begin{document} \maketitle \abstract{A short abstract \ldots{}} \keywords{Some keywords} \section{First section} \subsection{First subsection} \subsubsection{First subsubsection} Bla bla \parencite{key} \ldots{} \printbibliography \end{document} \end{lstlisting} \caption{Example of usage of ISCRAM document class} \label{fig:exampledoc} \end{figure} \end{document} %%% Local Variables: %%% mode: latex %%% TeX-master: t %%% End: