summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/jmlr/sample-papers/jmlr-sample.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/jmlr/sample-papers/jmlr-sample.tex')
-rw-r--r--Master/texmf-dist/doc/latex/jmlr/sample-papers/jmlr-sample.tex80
1 files changed, 63 insertions, 17 deletions
diff --git a/Master/texmf-dist/doc/latex/jmlr/sample-papers/jmlr-sample.tex b/Master/texmf-dist/doc/latex/jmlr/sample-papers/jmlr-sample.tex
index 4b2ceccff89..ac147209d6f 100644
--- a/Master/texmf-dist/doc/latex/jmlr/sample-papers/jmlr-sample.tex
+++ b/Master/texmf-dist/doc/latex/jmlr/sample-papers/jmlr-sample.tex
@@ -1,5 +1,8 @@
+ % use the "wcp" class option for workshop and conference
+ % proceedings
%\documentclass[gray]{jmlr} % test grayscale version
-\documentclass[tablecaption=bottom]{jmlr}
+ %\documentclass[tablecaption=bottom]{jmlr}% journal article
+ \documentclass[tablecaption=bottom,wcp]{jmlr} % W&CP article
% The following packages will be automatically loaded:
% amsmath, amssymb, natbib, graphicx, url, algorithm2e
@@ -18,9 +21,10 @@
%\usepackage{siunitx}
% The following command is just for this sample document:
-\newcommand{\cs}[1]{\texttt{\char`\\#1}}
+\newcommand{\cs}[1]{\texttt{\char`\\#1}}% remove this in your real article
- % Define an unnumbered theorem just for this sample document:
+ % Define an unnumbered theorem just for this sample document for
+ % illustrative purposes:
\theorembodyfont{\upshape}
\theoremheaderfont{\scshape}
\theorempostheader{:}
@@ -32,10 +36,19 @@
\jmlryear{2010}
\jmlrsubmitted{submission date}
\jmlrpublished{publication date}
+\jmlrworkshop{workshop title} % W&CP title
+ % The optional argument of \title is used in the header
\title[Short Title]{Full Title of Article\titlebreak This Title Has
A Line Break}
+ % Anything in the title that should appear in the main title but
+ % not in the article's header or the volume's table of
+ % contents should be placed inside \titletag{}
+
+ %\title{Title of the Article\titletag{\thanks{Some footnote}}}
+
+
% Use \Name{Author Name} to specify the name.
% If the surname contains spaces, enclose the surname
% in braces, e.g. \Name{John {Smith Jones}} similarly
@@ -44,9 +57,13 @@ A Line Break}
% enclose the diacritic in braces, e.g. \Name{{\'E}louise Smith}
% \thanks must come after \Name{...} not inside the argument for
- % example \Name{John Smith}\thanks{A note} NOT \Name{John
+ % example \Name{John Smith}\nametag{\thanks{A note}} NOT \Name{John
% Smith\thanks{A note}}
+ % Anything in the name that should appear in the title but not in the
+ % article's header or footer or in the volume's
+ % table of contents should be placed inside \nametag{}
+
% Two authors with the same address
\author{\Name{Author Name1\nametag{\thanks{A note}}} \Email{abc@sample.com}\and
\Name{Author Name2} \Email{xyz@sample.com}\\
@@ -79,6 +96,7 @@ A Line Break}
%}
\editor{Editor's name}
+ %\editors{Editor One and Editor Two}% for multiple editors
\begin{document}
@@ -100,7 +118,12 @@ this sample document as it can help to reduce complications when
combining the articles into a book. Please avoid using obsolete
commands, such as \verb|\rm|, and obsolete packages, such as
\textsf{epsfig}.\footnote{See
-\url{http://www.ctan.org/pkg/l2tabu}}
+\url{http://www.ctan.org/pkg/l2tabu}} Some packages that are known
+to cause problems for the production editing process are checked for
+by the \textsf{jmlr} class and will generate an error. (If you want
+to know more about the production editing process, have a look at
+the video tutorials for the production editors at
+\url{http://www.dickimaw-books.com/software/makejmlrbookgui/videos/}.)
Please also ensure that your document will compile with PDF\LaTeX.
If you have an error message that's puzzling you, first check for it
@@ -108,8 +131,8 @@ at the UK TUG FAQ
\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=man-latex}. If
that doesn't help, create a minimal working example (see
\url{http://theoval.cmp.uea.ac.uk/~nlct/latex/minexample/}) and post
-to somewhere like TeX on StackExchange
-(\url{http://tex.stackexchange.com/}) or the LaTeX Community Forum
+to somewhere like \TeX\ on StackExchange
+(\url{http://tex.stackexchange.com/}) or the \LaTeX\ Community Forum
(\url{http://www.latex-community.org/forum/}).
\begin{note}
@@ -139,7 +162,8 @@ These are unnumbered with a running head.
Always use \verb|\label| and \verb|\ref| (or one of the commands
described below) when cross-referencing. For example, the next
-section is Section~\ref{sec:math}. The \textsf{jmlr} class
+section is Section~\ref{sec:math} but you can also refer to it using
+\sectionref{sec:math}. The \textsf{jmlr} class
provides some convenient cross-referencing commands:
\verb|\sectionref|, \verb|\equationref|, \verb|\tableref|,
\verb|\figureref|, \verb|\algorithmref|, \verb|\theoremref|,
@@ -191,6 +215,10 @@ details.\footnote{Either \texttt{texdoc amsmath} or
Unnumbered single-lined equations should be displayed using
\verb|\[| and \verb|\]|. For example:
\[E = m c^2\]
+or you can use the \texttt{displaymath} environment:
+\begin{displaymath}
+E = m c^2
+\end{displaymath}
Numbered single-line equations should be displayed using the
\texttt{equation} environment. For example:
\begin{equation}\label{eq:trigrule}
@@ -207,14 +235,14 @@ Lars Madsen, \emph{Avoid eqnarray!} TUGboat 33(1):21--25, 2012.} For example:
f(x) &= x^2 + x\label{eq:f}\\
f'(x) &= 2x + 1\label{eq:df}
\end{align}
-Unnumbered multi-lined equations should be displayed using the
+Unnumbered multi-lined equations can be displayed using the
\texttt{align*} environment. For example:
\begin{align*}
f(x) &= (x+1)(x-1)\\
&= x^2 - 1
\end{align*}
If you want to mix numbered with unnumbered lines use the
-align environment and suppress unwanted line numbers with
+\texttt{align} environment and suppress unwanted line numbers with
\verb|\nonumber|. For example:
\begin{align}
y &= x^2 + 3x - 2x + 1\nonumber\\
@@ -270,6 +298,8 @@ below the operator (like \verb|\sum|) use the starred versions
\label{sec:vec}
Vectors should be typeset using \cs{vec}. For example $\vec{x}$.
+(The original version of \cs{vec} can also be accessed using
+\cs{orgvec}, for example $\orgvec{x}$.)
The \textsf{jmlr} class also provides \cs{set} to typeset a
set. For example $\set{S}$.
@@ -286,6 +316,12 @@ Floats are supposed to have a little extra space above and below
them to make them stand out from the rest of the text. This extra
spacing is put in automatically and shouldn't need modifying.
+If your article will later be reprinted in the Challenges for
+Machine Learning, please be aware that the CiML books use a
+different paper size, so if you want to resize any images use a
+scale relative to the line width (\verb|\linewidth|), text width
+(\verb|\textwidth|) or text height (\verb|\textheight|).
+
To ensure consistency, please \emph{don't} try changing the format of the caption by doing
something like:
\begin{verbatim}
@@ -307,6 +343,8 @@ phrases, for example:
Tables should go in the \texttt{table} environment. Within this
environment use \verb|\floatconts| (defined by \textsf{jmlr})
to set the caption correctly and center the table contents.
+The location of the caption depends on the \verb|tablecaption|
+setting in the document class options.
\begin{table}[htbp]
% The first argument is the label.
@@ -345,12 +383,14 @@ package which provides the commands \verb|\toprule|,
\end{tabular}}
\end{table}
-If you want vertical lines as well, you can't use the
+If you really want vertical lines as well, you can't use the
\textsf{booktabs} commands as there'll be some unwanted gaps.
Instead you can use \LaTeX's \verb|\hline|, but the rows may
appear a bit cramped. You can add extra space above or below a
row using \verb|\abovestrut| and \verb|\belowstrut|. For example,
-see \tableref{tab:example-hline}.
+see \tableref{tab:example-hline}. However, you might want to read
+the \textsf{booktabs} documentation regarding the use of vertical
+lines.
\begin{table}[htbp]
\floatconts
@@ -396,7 +436,7 @@ example:
If the table is very wide but not very long, you can use the
\texttt{sidewaystable} environment defined in the
\textsf{rotating} package (so use \verb|\usepackage{rotating}|).
-If the table is too long to fit on a page, you should use the
+If the table is too long to fit on a page, you can use the
\texttt{longtable} environment defined in the \textsf{longtable}
package (so use \verb|\usepackage{longtable}|).
@@ -437,8 +477,12 @@ If the figure is too wide to fit on the page, you can use the
\texttt{sidewaysfigure} environment defined in the
\textsf{rotating} package.
-Don't use \verb|\graphicspath|. If the images are contained in
-a subdirectory, specify this when you include the image, for
+Don't use \verb|\graphicspath|.\footnote{This is specific to the
+\textsf{jmlr} class, not a general recommendation. The main file
+that generates the proceedings or the CiML book is typically in a
+different directory to the imported articles, so it modifies the
+graphics path when it imports an article.} If the images
+are contained in a subdirectory, specify this when you include the image, for
example \verb|\includegraphics{figures/mypic}|.
\subsubsection{Sub-Figures}
@@ -744,7 +788,7 @@ Another example: {\ifprint{\bfseries}{\color{red}}important text!}
You can use the class option \texttt{gray} to see how the
document will appear in gray scale mode. \textcolor{blue}{Colored
-text} will automatically be converted to gray scale.
+text} will automatically be converted to gray scale in print mode.
The \textsf{jmlr} class loads the \textsf{xcolor}
package, so you can also define your own colors. For example:
@@ -761,7 +805,9 @@ in the \textsf{xcolor} documentation\footnote{either
\section{Citations and Bibliography}
\label{sec:cite}
-The \textsf{jmlr} class automatically loads \textsf{natbib}.
+The \textsf{jmlr} class automatically loads \textsf{natbib}
+and automatically sets the bibliography style, so you don't need to
+use \verb|\bibliographystyle|.
This sample file has the citations defined in the accompanying
BibTeX file \texttt{jmlr-sample.bib}. For a parenthetical
citation use \verb|\citep|. For example