You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
247 lines
7.5 KiB
247 lines
7.5 KiB
% Define \jmlrprehyperref to load packages before hyperref is
|
|
% loaded
|
|
\def\jmlrprehyperref{%
|
|
% Packages used by imported articles:
|
|
\usepackage{lipsum}
|
|
\usepackage{booktabs}
|
|
\usepackage{siunitx}
|
|
}
|
|
\documentclass[wcp,7x10]{jmlrbook}% on-line color version, 7inx10in
|
|
%\documentclass[wcp,gray,7x10]{jmlrbook}% print version, 7inx10in
|
|
|
|
% Load last
|
|
\ifprint{}{\usepackage{bookmark}}
|
|
|
|
% Title is added to the PDF properties. Optional argument
|
|
% is used instead, if present.
|
|
%\title[Short Title]{Big Long Title}
|
|
\title{A Sample Book}
|
|
|
|
\author[Anne Editor et al.]{Anne Editor, Anne Other Editor and Nicola Talbot}
|
|
|
|
% change the arguments, as appropriate, in the following:
|
|
\volume{1}
|
|
\subtitle{Making a Book from JMLR Articles}
|
|
\logo{\includegraphics{bookLogo}}
|
|
\team{The Sample Book Team}
|
|
|
|
\productioneditor{Nicola Talbot}
|
|
|
|
\begin{document}
|
|
\maketitle
|
|
|
|
\frontmatter
|
|
|
|
\chapter{Foreword}
|
|
|
|
This is an example book that combines multiple articles. Each
|
|
article uses the \textsf{jmlr} class file. \emph{The articles
|
|
should not need to be edited in order to combine them using this
|
|
class file.}\footnote{Unless the authors have done something
|
|
weird or have used problematic packages.} In particular, you
|
|
don't need to delete \verb|\documentclass|,
|
|
\verb|\begin{document}| and \verb|\end{document}|. The articles
|
|
should be able to compile on their own or as part of this book.
|
|
|
|
In the preamble of the book, you need to include the packages
|
|
that the articles include, but you don't need to include
|
|
any packages that are automatically loaded by the \textsf{jmlr}
|
|
class (\textsf{amsmath}, \textsf{amssymb}, \textsf{natbib},
|
|
\textsf{graphicx}, \textsf{url}, \textsf{xcolor} and
|
|
\textsf{algorithm2e}). You also don't need to include the
|
|
\textsf{hyperref} and \textsf{combnat} packages as they are
|
|
automatically loaded by \textsf{jmlrbook}. For example, some of the
|
|
articles imported in this book use the \textsf{lipsum} package,
|
|
so that package needs to be included in the preamble of the
|
|
book.
|
|
|
|
Commands defined in the imported articles will be local to that
|
|
article unless \verb|\gdef| or \verb|\global| has been used. This
|
|
means that if more than one article has defined the same command,
|
|
there shouldn't be a conflict unless the command has been defined
|
|
globally. For example, \texttt{paper1/paper1.tex} and
|
|
\texttt{paper2/paper2.tex} both define \verb|\samplecommand|, but
|
|
since \verb|\newcommand| has been used, rather than \verb|\gdef|,
|
|
there's no conflict. However, a problem will occur if the same
|
|
command is also defined in this document before either of those
|
|
files are imported.
|
|
|
|
Many packages must be loaded before \textsf{hyperref}. If these
|
|
packages haven't been loaded by \textsf{jmlr}, you will need
|
|
to specify them using \textsf{jmlrbook}'s \verb|\jmlrprehyperref|
|
|
hook. For example, to load the packages ``foo'' and ``bar'':
|
|
\begin{verbatim}
|
|
\def\jmlrprehyperref{\usepackage{foo}\usepackage{bar}}
|
|
\documentclass{jmlrbook}
|
|
\end{verbatim}
|
|
or:
|
|
\begin{verbatim}
|
|
\def\jmlrprehyperref{\usepackage{foo,bar}}
|
|
\documentclass{jmlrbook}
|
|
\end{verbatim}
|
|
|
|
|
|
The imported papers need to be placed inside the
|
|
\texttt{jmlrpapers} environment. Papers that have already
|
|
been published should be included using \verb|\importpubpaper|
|
|
and papers that haven't been published elsewhere should be
|
|
imported using \verb|\importarticle|. Both commands have an
|
|
optional argument that specifies the prefix to use in the labels
|
|
within the imported article. If omitted, the article's file
|
|
name is used.
|
|
|
|
Both articles and the book may have appendices and parts created.
|
|
Parts are created using \verb|\part|\{\emph{title}\}. Switch
|
|
to appendices using \verb|\appendix| and then use \verb|\chapter|
|
|
(for the book) or \verb|\section| (in imported articles).
|
|
|
|
Cross-referencing other parts of the book is done using the
|
|
usual \verb|\label| and \verb|\ref| mechanism. The \textsf{jmlr}
|
|
class additional provides convenience commands such as
|
|
\verb|\sectionref| and \verb|\figureref|. Unlike \verb|\ref|,
|
|
these commands may take a comma-separated list of labels as the
|
|
argument.
|
|
|
|
The \textsf{jmlrbook} additionally provides \verb|\chapterref|
|
|
(which can take a comma-separated list of labels) and commands
|
|
to reference imported articles (which take a single label
|
|
as the argument): \verb|\articlepageref| (the starting page of
|
|
the article), \verb|\articlepagesref| (the page range for the
|
|
article), \verb|\articletitleref| (the short title for the
|
|
article) and \verb|\articleauthorref| (the article's author).
|
|
|
|
You may also cross-reference parts of the imported articles,
|
|
but you need to prefix the label with the label supplied
|
|
in the optional argument of \verb|\importpubpaper| or
|
|
\verb|\importarticle|. (If omitted, this is given by
|
|
directory/file name.)
|
|
|
|
For example, the first appendix in this book is
|
|
\appendixref{apd:first}, but the first appendix in
|
|
``\articletitleref{paper1/paper1}'' by
|
|
\articleauthorref{paper1/paper1}
|
|
(pp.~\articlepagesref{paper1/paper1}) is
|
|
\appendixref{paper1/paper1apd:first}.
|
|
Here's a reference to a couple of tables in
|
|
\articletitleref{paper1/paper1}:
|
|
\tableref{paper1/paper1tab:sample,paper1/paper1tab:sample2}.
|
|
|
|
The author of a foreword (or other chapter) can sign off using
|
|
the \texttt{authorsignoff} environment. Each author should be
|
|
specified using \verb|\Author|.
|
|
|
|
\begin{authorsignoff}
|
|
\Author{Nicola Talbot\\
|
|
University of East Anglia}
|
|
\end{authorsignoff}
|
|
|
|
\begin{preface}
|
|
The preface environment should be used for the preface if you want
|
|
makejmlrbook to extract the preface and turn it into a standalone
|
|
document.
|
|
|
|
The editorial team can sign off at the end of the preface using
|
|
the \texttt{signoff} environment. This has two arguments: the
|
|
optional argument is a name for the editorial team (defaults to
|
|
``The Editorial Team'') and the mandatory argument is the date.
|
|
Within the environment, use \verb|\Editor| for each editor.
|
|
|
|
\begin{signoff}{March 2010}
|
|
% First editor:
|
|
\Editor{Nicola Talbot\\
|
|
University of East Anglia\\
|
|
\mailto{N.Talbot@uea.ac.uk}}
|
|
% Second editor:
|
|
\Editor{Anne Editor\\
|
|
University of Nowhere\\
|
|
\mailto{ae@sample.com}}
|
|
\end{signoff}
|
|
|
|
\end{preface}
|
|
|
|
\tableofcontents
|
|
|
|
\mainmatter
|
|
|
|
\part{First Part of the Book}
|
|
|
|
\chapter{Introduction}
|
|
|
|
This is an introduction to the book.
|
|
|
|
\section{Sample Section}
|
|
|
|
This is a section in the introduction.
|
|
|
|
\subsection{Sample Sub-Section}
|
|
|
|
This is a sub-section.
|
|
|
|
\subsubsection{Sample Sub-Sub-Section}
|
|
|
|
This is a sub-sub-section.
|
|
|
|
\paragraph{Sample Sub-Sub-Sub-Section}
|
|
|
|
This is a sub-sub-sub-section.
|
|
|
|
\subparagraph{Sample Sub-Sub-Sub-Sub-Section}
|
|
|
|
This is a sub-sub-sub-sub-section.
|
|
|
|
% Add a part to the TOC but don't print anything
|
|
\addtocpart{Papers Published in JMLR W\&CP}
|
|
|
|
\begin{jmlrpapers}
|
|
% Prepublished papers are imported using:
|
|
% \importpubpaper[label]{dir}{file}{pages}
|
|
% pages refers to the page range in the original publication
|
|
% which doesn't necessarily correspond to the page numbers in
|
|
% this book.
|
|
\importpubpaper{paper1}{paper1}{23--45}
|
|
|
|
\importpubpaper{paper2}{paper2}{63--70}
|
|
|
|
\end{jmlrpapers}
|
|
|
|
% Add a part to the TOC but don't print anything
|
|
\addtocpart{Unpublished Papers}
|
|
|
|
\begin{jmlrpapers}
|
|
% Unpublished papers are imported using:
|
|
% \importarticle[label]{dir}{file}
|
|
\importarticle{paper3}{paper3}
|
|
|
|
\importarticle{paper4}{paper4}
|
|
\end{jmlrpapers}
|
|
|
|
\appendix
|
|
|
|
\part{First Part of Appendices}\label{pt:apd1}
|
|
|
|
\chapter*{Introduction}
|
|
|
|
This is an introduction to \partref{pt:apd1}.
|
|
|
|
\chapter{First Appendix}
|
|
\label{apd:first}
|
|
|
|
This is an appendix.
|
|
|
|
\chapter{Second Appendix}
|
|
\label{apd:second}
|
|
|
|
This is another appendix.
|
|
|
|
\lipsum
|
|
|
|
\part{Second Part of Appendices}
|
|
|
|
\chapter{An Appendix}
|
|
\label{apd:third}
|
|
|
|
This is an appendix in another part.
|
|
|
|
\lipsum
|
|
|
|
\end{document}
|