elsarticle/doc/elsdoc.tex
author Alpar Juttner <alpar@cs.elte.hu>
Tue, 22 Nov 2016 13:58:09 +0100
changeset 3 550f81b2f81c
permissions -rw-r--r--
Reformat
     1 %% 
     2 %% Copyright 2007, 2008, 2009 Elsevier Ltd
     3 %% 
     4 %% This file is part of the 'Elsarticle Bundle'.
     5 %% ---------------------------------------------
     6 %% 
     7 %% It may be distributed under the conditions of the LaTeX Project Public
     8 %% License, either version 1.2 of this license or (at your option) any
     9 %% later version.  The latest version of this license is in
    10 %%    http://www.latex-project.org/lppl.txt
    11 %% and version 1.2 or later is part of all distributions of LaTeX
    12 %% version 1999/12/01 or later.
    13 %% 
    14 %% The list of all files belonging to the 'Elsarticle Bundle' is
    15 %% given in the file `manifest.txt'.
    16 %% 
    17 \documentclass[a4paper,12pt]{article}
    18 
    19 \usepackage[xcolor,qtwo]{rvdtx}
    20 \usepackage{multicol}
    21 \usepackage{color}
    22 \usepackage{xspace}
    23 \usepackage{pdfwidgets}
    24 \usepackage{enum}
    25 
    26 \def\ttdefault{cmtt}
    27 
    28 \headsep4pc
    29 
    30 \makeatletter
    31 \def\bs{\expandafter\@gobble\string\\}
    32 \def\lb{\expandafter\@gobble\string\{}
    33 \def\rb{\expandafter\@gobble\string\}}
    34 \def\@pdfauthor{C.V.Radhakrishnan}
    35 \def\@pdftitle{elsarticle.cls -- A documentation}
    36 \def\@pdfsubject{Document formatting with elsarticle.cls}
    37 \def\@pdfkeywords{LaTeX, Elsevier Ltd, document class}
    38 \def\file#1{\textsf{#1}\xspace}
    39 
    40 %\def\LastPage{19}
    41 
    42 \DeclareRobustCommand{\LaTeX}{L\kern-.26em%
    43         {\sbox\z@ T%
    44          \vbox to\ht\z@{\hbox{\check@mathfonts
    45            \fontsize\sf@size\z@
    46            \math@fontsfalse\selectfont
    47           A\,}%
    48          \vss}%
    49         }%
    50      \kern-.15em%
    51     \TeX}
    52 \makeatother
    53 
    54 \def\figurename{Clip}
    55 
    56 \begin{document}
    57 
    58 \def\testa{This is a specimen document. }
    59 \def\testc{\testa\testa\testa\testa}
    60 \def\testb{\testc\testc\testc\testc\testc}
    61 \long\def\test{\testb\par\testb\par\testb\par}
    62 
    63 \pinclude{\copy\contbox\printSq{\LastPage}}
    64 
    65 \title{elsarticle.cls -- A better way to format your document}
    66 
    67 \author{Elsevier Ltd}
    68 \contact{elsarticle@river-valley.com}
    69 
    70 \version{1.20}
    71 \date{\today}
    72 \maketitle
    73 
    74 \section{Introduction}
    75 %\hypertarget{introduction}{}
    76 
    77 \file{elsarticle.cls} is a thoroughly re-written document class
    78 for formatting \LaTeX{} submissions to Elsevier journals.
    79 The class uses the environments and commands defined in \LaTeX{} kernel
    80 without any change in the signature so that clashes with other
    81 contributed \LaTeX{} packages such as \file{hyperref.sty},
    82 \file{preview-latex.sty}, etc., will be minimal.
    83 \file{elsarticle.cls} is primarily built upon the default
    84 \file{article.cls}.  This class depends on the following packages
    85 for its proper functioning:
    86 
    87 \begin{enumerate}
    88 \item \file{pifont.sty} for openstar in the title footnotes;
    89 \item \file{natbib.sty} for citation processing;
    90 \item \file{geometry.sty} for margin settings;
    91 \item \file{fleqn.clo} for left aligned equations;
    92 \item \file{graphicx.sty} for graphics inclusion;
    93 \item \file{txfonts.sty} optional font package, if the document is to
    94   be formatted with Times and compatible math fonts;
    95 \item \file{hyperref.sty} optional packages if hyperlinking is
    96   required in the document.
    97 
    98 \end{enumerate}
    99 
   100 All the above packages are part of any standard \LaTeX{} installation.
   101 Therefore, the users need not be bothered about downloading any
   102 extra packages.  Furthermore, users are free to make use of \textsc{ams}
   103 math packages such as \file{amsmath.sty}, \file{amsthm.sty},
   104 \file{amssymb.sty}, \file{amsfonts.sty}, etc., if they want to.  All
   105 these packages work in tandem with \file{elsarticle.cls} without
   106 any problems.
   107 
   108 \section{Major Differences}
   109 %\hypertarget{majordifferences}{}
   110 
   111 Following are the major differences between \file{elsarticle.cls}
   112 and its predecessor package, \file{elsart.cls}:
   113 
   114 \begin{enumerate}[\textbullet]
   115 \item \file{elsarticle.cls} is built upon \file{article.cls}
   116 while \file{elsart.cls} is not. \file{elsart.cls} redefines
   117 many of the commands in the \LaTeX{} classes/kernel, which can
   118 possibly cause surprising clashes with other contributed
   119 \LaTeX{} packages;
   120 
   121 \item provides preprint document formatting by default, and
   122 optionally formats the document as per the final
   123 style of models $1+$, $3+$ and $5+$ of Elsevier journals;
   124 
   125 \item some easier ways for formatting \verb+list+ and
   126 \verb+theorem+ environments are provided while people can still
   127 use \file{amsthm.sty} package;
   128 
   129 \item \file{natbib.sty} is the main citation processing package
   130   which can comprehensively handle all kinds of citations and
   131 works perfectly with \file{hyperref.sty} in combination with
   132 \file{hypernat.sty};
   133 
   134 \item long title pages are processed correctly in preprint and
   135   final formats.
   136 
   137 \end{enumerate}
   138 
   139 \section{Installation}
   140 %\hypertarget{installation}{}
   141 
   142 The package is available at author resources page at Elsevier
   143 (\url{http://www.elsevier.com/locate/latex}).
   144 It can also be found in any of the nodes of the Comprehensive
   145 \TeX{} Archive Network (\textsc{ctan}), one of the primary nodes
   146 being
   147 \url{http://www.ctan.org/tex-archive/macros/latex/contrib/elsevier/}.
   148 Please download the \file{elsarticle.dtx} which is a composite
   149 class with documentation and \file{elsarticle.ins} which is the
   150 \LaTeX{} installer file. When we compile the
   151 \file{elsarticle.ins} with \LaTeX{} it provides the class file,
   152 \file{elsarticle.cls} by
   153 stripping off all the documentation from the \verb+*.dtx+ file.
   154 The class may be moved or copied to a place, usually,
   155 \verb+$TEXMF/tex/latex/elsevier/+, %$%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   156 or a folder which will be read                   
   157 by \LaTeX{} during document compilation.  The \TeX{} file
   158 database needs updation after moving/copying class file.  Usually,
   159 we use commands like \verb+mktexlsr+ or \verb+texhash+ depending
   160 upon the distribution and operating system.
   161 
   162 
   163 \section{Usage}\label{sec:usage}
   164 %\hypertarget{usage}{}
   165 The class should be loaded with the command:
   166 
   167 \begin{vquote}
   168  \documentclass[<options>]{elsarticle}
   169 \end{vquote}
   170 
   171 \noindent where the \verb+options+ can be the following:
   172 
   173 \begin{description}
   174 
   175 \item [{\tt\color{verbcolor} preprint}]  default option which format the
   176   document for submission to Elsevier journals.
   177 
   178 \item [{\tt\color{verbcolor} review}]  similar to the \verb+preprint+ option, but
   179   increases the baselineskip to facilitate easier review process.
   180 
   181 \item [{\tt\color{verbcolor} 1p}]  formats the article to the look and feel of the final
   182   format of model 1+ journals. This is always single column style.
   183 
   184 \item [{\tt\color{verbcolor} 3p}] formats the article to the look and feel of the final
   185   format of model 3+ journals. If the journal is a two column
   186 model, use \verb+twocolumn+ option in combination.
   187 
   188 \item [{\tt\color{verbcolor} 5p}] formats for model 5+ journals. This is always
   189   of two column style.
   190 
   191 \item [{\tt\color{verbcolor} authoryear}] author-year citation style of
   192   \file{natbib.sty}. If you want to add extra options of
   193 \file{natbib.sty}, you may use the options as comma delimited
   194 strings as arguments to \verb+\biboptions+ command. An example
   195 would be:
   196 \end{description}
   197 \begin{vquote}
   198  \biboptions{longnamesfirst,angle,semicolon}
   199 \end{vquote}
   200 
   201 \begin{description}
   202 \item [{\tt\color{verbcolor} number}] numbered citation style. Extra options
   203   can be loaded with\linebreak \verb+\biboptions+ command.
   204 
   205 \item [{\tt\color{verbcolor} sort\&compress}] sorts and compresses the
   206 numbered citations. For example, citation [1,2,3] will become [1--3].
   207 
   208 \item [{\tt\color{verbcolor} longtitle}] if front matter is unusually long, use
   209   this option to split the title page across pages with the correct
   210 placement of title and author footnotes in the first page.
   211 
   212 \item [{\tt\color{verbcolor} times}] loads \file{txfonts.sty}, if available in
   213   the system to use Times and compatible math fonts.
   214 
   215 \item[] All options of \file{article.cls} can be used with this
   216   document class.
   217 
   218 \item[] The default options loaded are \verb+a4paper+, \verb+10pt+,
   219   \verb+oneside+, \verb+onecolumn+ and \verb+preprint+.
   220 
   221 \end{description}
   222 
   223 \section{Frontmatter}
   224 %\hypertarget{preamble}{}
   225 
   226 There are two types of frontmatter coding:
   227 \begin{enumerate}[(1)]
   228 \item each author is
   229 connected to an affiliation with a footnote marker; hence all
   230 authors are grouped together and affiliations follow;
   231 \item authors of same affiliations are grouped together and the
   232 relevant affiliation follows this group. An example coding of the first
   233 type is provided below.
   234 \end{enumerate}
   235 
   236 \begin{vquote}
   237  \title{This is a specimen title\tnoteref{t1,t2}}
   238  \tnotetext[t1]{This document is a collaborative effort.}
   239  \tnotetext[t2]{The second title footnote which is a longer
   240     longer than the first one and with an intention to fill
   241     in up more than one line while formatting.}
   242 \end{vquote}
   243 
   244 \begin{vquote}
   245  \author[rvt]{C.V.~Radhakrishnan\corref{cor1}\fnref{fn1}}
   246  \ead{cvr@river-valley.com}
   247 
   248  \author[rvt,focal]{K.~Bazargan\fnref{fn2}}
   249  \ead{kaveh@river-valley.com}
   250 
   251  \author[els]{S.~Pepping\corref{cor2}\fnref{fn1,fn3}}
   252  \ead[url]{http://www.elsevier.com}
   253 \end{vquote}
   254 
   255 \begin{vquote}
   256  \cortext[cor1]{Corresponding author}
   257  \cortext[cor2]{Principal corresponding author}
   258  \fntext[fn1]{This is the specimen author footnote.}
   259  \fntext[fn2]{Another author footnote, but a little more 
   260              longer.}
   261  \fntext[fn3]{Yet another author footnote. Indeed, you can have
   262     any number of author footnotes.}
   263 
   264  \address[rvt]{River Valley Technologies, SJP Building,
   265     Cotton Hills, Trivandrum, Kerala, India 695014}
   266  \address[focal]{River Valley Technologies, 9, Browns Court,
   267     Kennford, Exeter, United Kingdom}
   268  \address[els]{Central Application Management,
   269     Elsevier, Radarweg 29, 1043 NX\\
   270     Amsterdam, Netherlands}
   271 
   272 \end{vquote}
   273 
   274 The output of the above TeX source is given in Clips~\ref{clip1} and
   275 \ref{clip2}. The header portion or title area is given in Clip~\ref{clip1} and
   276 the footer area is given in Clip~\ref{clip2}.
   277 
   278 \vspace*{6pt}
   279 \def\rulecolor{blue!70}
   280 \src{Header of the title page.}
   281 \includeclip{1}{132 571 481 690}{els1.pdf}
   282 \def\rulecolor{orange}
   283 
   284 %\vspace*{6pt}
   285 \def\rulecolor{blue!70}
   286 \src{Footer of the title page.}
   287 \includeclip{1}{122 129 481 237}{els1.pdf}
   288 \def\rulecolor{orange}
   289 \pagebreak
   290 
   291 Most of the commands such as \verb+\title+, \verb+\author+,
   292 \verb+\address+ are self explanatory.  Various components are
   293 linked to each other by a label--reference mechanism; for
   294 instance, title footnote is linked to the title with a footnote
   295 mark generated by referring to the \verb+\label+ string of
   296 the \verb=\tnotetext=.  We have used similar commands
   297 such as \verb=\tnoteref= (to link title note to title);
   298 \verb=\corref= (to link corresponding author text to
   299 corresponding author); \verb=\fnref= (to link footnote text to
   300 the relevant author names).  \TeX{} needs two compilations to
   301 resolve the footnote marks in the preamble part.  
   302 Given below are the syntax of various note marks and note texts.
   303 
   304 \begin{vquote}
   305   \tnoteref{<label(s)>}
   306   \corref{<label(s)>}
   307   \fnref{<label(s)>}
   308   \tnotetext[<label>]{<title note text>}
   309   \cortext[<label>]{<corresponding author note text>}
   310   \fntext[<label>]{<author footnote text>}
   311 \end{vquote}
   312 
   313 \noindent where \verb=<label(s)>= can be either one or more comma
   314 delimited label strings. The optional arguments to the
   315 \verb=\author= command holds the ref label(s) of the address(es)
   316 to which the author is affiliated while each \verb=\address=
   317 command can have an optional argument of a label. In the same
   318 manner, \verb=\tnotetext=, \verb=\fntext=, \verb=\cortext= will
   319 have optional arguments as their respective labels and note text
   320 as their mandatory argument.
   321 
   322 The following example code provides the markup of the second type
   323 of author-affiliation.
   324 %as seen in the output given in the
   325 %box to the right.
   326 %\pinclude{\def\rulecolor{blue!80}
   327 %   \includeclip[width=3.25in]{1}{130 84 484 676}{els2.pdf}%
   328 % \def\rulecolor{orange}}
   329 
   330 \begin{vquote}
   331 \author{C.V.~Radhakrishnan\corref{cor1}\fnref{fn1}}
   332  \ead{cvr@river-valley.com}
   333  \address{River Valley Technologies, SJP Building,
   334    Cotton Hills, Trivandrum, Kerala, India 695014}
   335 \end{vquote}
   336 
   337 \begin{vquote}
   338 \author{K.~Bazargan\fnref{fn2}}
   339  \ead{kaveh@river-valley.com}
   340  \address{River Valley Technologies, 9, Browns Court, Kennford,
   341    Exeter, UK.}
   342 \end{vquote}
   343 
   344 \begin{vquote}
   345 \author{S.~Pepping\fnref{fn1,fn3}}
   346  \ead[url]{http://www.elsevier.com}
   347  \address{Central Application Management,
   348    Elsevier, Radarweg 43, 1043 NX Amsterdam, Netherlands}
   349 \end{vquote}
   350 
   351 \begin{vquote}
   352 \cortext[cor1]{Corresponding author}
   353 \fntext[fn1]{This is the first author footnote.}
   354 \fntext[fn2]{Another author footnote, this is a very long 
   355   footnote and it should be a really long footnote. But this 
   356   footnote is not yet sufficiently long enough to make two lines 
   357   of footnote text.}
   358 \fntext[fn3]{Yet another author footnote.}
   359 \end{vquote}
   360 
   361 The output of the above TeX source is given in Clip~\ref{clip3}.
   362 
   363 \vspace*{12pt}
   364 \def\rulecolor{blue!70}
   365 \src{Header of the title page..}
   366 \includeclip{1}{132 491 481 690}{els2.pdf}
   367 \def\rulecolor{orange}
   368 
   369 
   370 The frontmatter part has further environments such as abstracts and
   371 keywords.  These can be marked up in the following
   372 manner:
   373 
   374 %\verb+\begin{abstract}+ \dots \verb+\end{abstract}+ and
   375 %\verb+\begin{keyword}+ \verb+...+ \verb+\end{keyword}+ which
   376 %contain the abstract and keywords respectively. 
   377 
   378 \begin{vquote}
   379  \begin{abstract}
   380   In this work we demonstrate the formation of a new type of 
   381   polariton on the interface between a ....
   382  \end{abstract}
   383 \end{vquote} 
   384 
   385 \begin{vquote}
   386  \begin{keyword}
   387   quadruple exiton \sep polariton \sep WGM
   388 
   389   \PACS 71.35.-y \sep 71.35.Lk \sep 71.36.+c
   390  \end{keyword}
   391 \end{vquote}
   392 
   393 \noindent Each keyword shall be separated by a \verb+\sep+ command.
   394 \textsc{pacs} and \textsc{msc} classifications shall be provided in 
   395 the keyword environment with the commands \verb+\PACS+ and
   396 \verb+\MSC+ respectively.  \verb+\MSC+ accepts an optional
   397 argument to accommodate future revisions.
   398 eg., \verb=\MSC[2008]=. The default is 2000.\looseness=-1
   399 
   400 
   401 \section{Floats}
   402 {Figures} may be included using the command, \verb+\includegraphics+ in
   403 combination with or without its several options to further control
   404 graphic. \verb+\includegraphics+ is provided by \file{graphic[s,x].sty}
   405 which is part of any standard \LaTeX{} distribution.
   406 \file{graphicx.sty} is loaded by default. \LaTeX{} accepts figures in
   407 the postscript format while pdf\LaTeX{} accepts \file{*.pdf},
   408 \file{*.mps} (metapost), \file{*.jpg} and \file{*.png} formats. 
   409 pdf\LaTeX{} does not accept graphic files in the postscript format. 
   410 
   411 The \verb+table+ environment is handy for marking up tabular
   412 material. If users want to use \file{multirow.sty},
   413 \file{array.sty}, etc., to fine control/enhance the tables, they
   414 are welcome to load any package of their choice and
   415 \file{elsarticle.cls} will work in combination with all loaded
   416 packages.
   417 
   418 \section[Theorem and ...]{Theorem and theorem like environments}
   419 
   420 \file{elsarticle.cls} provides a few shortcuts to format theorems and
   421 theorem-like environments with ease. In all commands the options that
   422 are used with the \verb+\newtheorem+ command will work exactly in the same
   423 manner. \file{elsarticle.cls} provides three commands to format theorem or
   424 theorem-like environments: 
   425 
   426 \begin{vquote}
   427  \newtheorem{thm}{Theorem}
   428  \newtheorem{lem}[thm]{Lemma}
   429  \newdefinition{rmk}{Remark}
   430  \newproof{pf}{Proof}
   431  \newproof{pot}{Proof of Theorem \ref{thm2}}
   432 \end{vquote}
   433 
   434 The \verb+\newtheorem+ command formats a
   435 theorem in \LaTeX's default style with italicized font, bold font
   436 for theorem heading and theorem number at the right hand side of the
   437 theorem heading.  It also optionally accepts an argument which
   438 will be printed as an extra heading in parentheses. 
   439 
   440 \begin{vquote}
   441   \begin{thm} 
   442    For system (8), consensus can be achieved with $\|T_{\omega z}$
   443    ...
   444      \begin{eqnarray}\label{10}
   445      ....
   446      \end{eqnarray}
   447   \end{thm}
   448 \end{vquote}  
   449 
   450 Clip~\ref{clip4} will show you how some text enclosed between the
   451 above code looks like:
   452 
   453 \vspace*{6pt}
   454 \def\rulecolor{blue!70}
   455 \src{{\ttfamily\color{verbcolor}\bs newtheorem}}
   456 \includeclip{2}{1 1 453 120}{jfigs.pdf}
   457 \def\rulecolor{orange}
   458 
   459 The \verb+\newdefinition+ command is the same in
   460 all respects as its\linebreak \verb+\newtheorem+ counterpart except that
   461 the font shape is roman instead of italic.  Both
   462 \verb+\newdefinition+ and \verb+\newtheorem+ commands
   463 automatically define counters for the environments defined.
   464 
   465 \vspace*{12pt}
   466 \def\rulecolor{blue!70}
   467 \src{{\ttfamily\color{verbcolor}\bs newdefinition}}
   468 \includeclip{1}{1 1 453 105}{jfigs.pdf}
   469 \def\rulecolor{orange}
   470 
   471 The \verb+\newproof+ command defines proof environments with
   472 upright font shape.  No counters are defined. 
   473 
   474 \vspace*{6pt}
   475 \def\rulecolor{blue!70}
   476 \src{{\ttfamily\color{verbcolor}\bs newproof}}
   477 \includeclip{3}{1 1 453 65}{jfigs.pdf}
   478 \def\rulecolor{orange}
   479 
   480 Users can also make use of \verb+amsthm.sty+ which will override
   481 all the default definitions described above.
   482 
   483 \section[Enumerated ...]{Enumerated and Itemized Lists}
   484 \file{elsarticle.cls} provides an extended list processing macros
   485 which makes the usage a bit more user friendly than the default
   486 \LaTeX{} list macros.   With an optional argument to the
   487 \verb+\begin{enumerate}+ command, you can change the list counter
   488 type and its attributes.
   489 
   490 \begin{vquote}
   491  \begin{enumerate}[1.]
   492  \item The enumerate environment starts with an optional
   493    argument `1.', so that the item counter will be suffixed
   494    by a period.
   495  \item You can use `a)' for alphabetical counter and '(i)' for
   496    roman counter.
   497   \begin{enumerate}[a)]
   498     \item Another level of list with alphabetical counter.
   499     \item One more item before we start another.
   500     \begin{enumerate}[(i)]
   501      \item This item has roman numeral counter.
   502      \item Another one before we close the third level.
   503     \end{enumerate}
   504     \item Third item in second level.
   505   \end{enumerate}
   506  \item All list items conclude with this step.
   507  \end{enumerate}
   508 \end{vquote}
   509 
   510 \vspace*{12pt}
   511 \def\rulecolor{blue!70}
   512 \src{List -- Enumerate}
   513 \includeclip{4}{1 1 453 185}{jfigs.pdf}
   514 \def\rulecolor{orange}
   515 
   516 
   517 Further, the enhanced list environment allows one to prefix a
   518 string like `step' to all the item numbers.  Take a look at the
   519 example below:
   520 
   521 \begin{vquote}
   522  \begin{enumerate}[Step 1.]
   523   \item This is the first step of the example list.
   524   \item Obviously this is the second step.
   525   \item The final step to wind up this example.
   526  \end{enumerate}
   527 \end{vquote}
   528 
   529 \def\rulecolor{blue!70}
   530 \src{List -- enhanced}
   531 \includeclip{5}{1 1 313 83}{jfigs.pdf}
   532 \def\rulecolor{orange}
   533 
   534 \vspace*{-18pt}
   535 
   536 \section{Cross-references}
   537 In electronic publications, articles may be internally
   538 hyperlinked. Hyperlinks are generated from proper
   539 cross-references in the article.  For example, the words
   540 \textcolor{black!80}{Fig.~1} will never be more than simple text,
   541 whereas the proper cross-reference \verb+\ref{tiger}+ may be
   542 turned into a hyperlink to the figure itself:
   543 \textcolor{blue}{Fig.~1}.  In the same way,
   544 the words \textcolor{blue}{Ref.~[1]} will fail to turn into a
   545 hyperlink; the proper cross-reference is \verb+\cite{Knuth96}+.
   546 Cross-referencing is possible in \LaTeX{} for sections,
   547 subsections, formulae, figures, tables, and literature
   548 references.
   549 
   550 \section[Mathematical ...]{Mathematical symbols and formulae}
   551 
   552 Many physical/mathematical sciences authors require more
   553 mathematical symbols than the few that are provided in standard
   554 \LaTeX. A useful package for additional symbols is the
   555 \file{amssymb} package, developed by the American Mathematical
   556 Society. This package includes such oft-used symbols as
   557 $\lesssim$ (\verb+\lesssim+), $\gtrsim$ (\verb+\gtrsim+)  or 
   558 $\hbar$ (\verb+\hbar+). Note that your \TeX{}
   559 system should have the \file{msam} and \file{msbm} fonts installed. If
   560 you need only a few symbols, such as $\Box$ (\verb+\Box+), you might try the
   561 package \file{latexsym}.
   562 
   563 Another point which would require authors' attention is the
   564 breaking up of long equations.  When you use
   565 \file{elsarticle.cls} for formatting your submissions in the 
   566 \verb+preprint+ mode, the document is formatted in single column
   567 style with a text width of 384pt or 5.3in.  When this document is
   568 formatted for final print and if the journal happens to be a double column
   569 journal, the text width will be reduced to 224pt at for 3+
   570 double column and 5+ journals respectively. All the nifty 
   571 fine-tuning in equation breaking done by the author goes to waste in
   572 such cases.  Therefore, authors are requested to check this
   573 problem by typesetting their submissions in final format as well
   574 just to see if their equations are broken at appropriate places,
   575 by changing appropriate options in the document class loading
   576 command, which is explained in section~\ref{sec:usage},
   577 \nameref{sec:usage}. This allows authors to fix any equation breaking
   578 problem before submission for publication.
   579 \file{elsarticle.cls} supports formatting the author submission
   580 in different types of final format.  This is further discussed in
   581 section \ref{sec:final}, \nameref{sec:final}.
   582 
   583 \section{Bibliography}
   584 
   585 Three bibliographic style files (\verb+*.bst+) are provided ---
   586 \file{elsarticle-num.bst}, \file{elsarticle-num-names.bst} and
   587 \file{elsarticle-harv.bst} --- the first one for the numbered scheme, the
   588 second for the numbered with new options of \file{natbib.sty} and the
   589 last one for the author year scheme.
   590 
   591 In \LaTeX{} literature, references are listed in the
   592 \verb+thebibliography+ environment.  Each reference is a
   593 \verb+\bibitem+ and each \verb+\bibitem+ is identified by a label,
   594 by which it can be cited in the text:
   595 
   596 \verb+\bibitem[Elson et al.(1996)]{ESG96}+ is cited as
   597 \verb+\citet{ESG96}+. 
   598 
   599 \noindent In connection with cross-referencing and
   600 possible future hyperlinking it is not a good idea to collect
   601 more that one literature item in one \verb+\bibitem+.  The
   602 so-called Harvard or author-year style of referencing is enabled
   603 by the \LaTeX{} package \file{natbib}. With this package the
   604 literature can be cited as follows:
   605 
   606 \begin{enumerate}[\textbullet]
   607 \item Parenthetical: \verb+\citep{WB96}+ produces (Wettig \& Brown, 1996).
   608 \item Textual: \verb+\citet{ESG96}+ produces Elson et al. (1996).
   609 \item An affix and part of a reference:
   610 \verb+\citep[e.g.][Ch. 2]{Gea97}+ produces (e.g. Governato et
   611 al., 1997, Ch. 2).
   612 \end{enumerate}
   613 
   614 In the numbered scheme of citation, \verb+\cite{<label>}+ is used,
   615 since \verb+\citep+ or \verb+\citet+ has no relevance in the numbered
   616 scheme.  \file{natbib} package is loaded by \file{elsarticle} with
   617 \verb+numbers+ as default option.  You can change this to author-year
   618 or harvard scheme by adding option \verb+authoryear+ in the class
   619 loading command.  If you want to use more options of the \file{natbib}
   620 package, you can do so with the \verb+\biboptions+ command, which is
   621 described in the section \ref{sec:usage}, \nameref{sec:usage}.  For
   622 details of various options of the \file{natbib} package, please take a
   623 look at the \file{natbib} documentation, which is part of any standard
   624 \LaTeX{} installation.
   625 
   626 \subsection*{Displayed equations and double column journals}
   627 
   628 Many Elsevier journals print their text in two columns. Since
   629 the preprint layout uses a larger line width than such columns,
   630 the formulae are too wide for the line width in print. Here is an
   631 example of an equation  (see equation 6) which is perfect in a
   632 single column preprint format:
   633 
   634 \bigskip
   635 \setlength\Sep{6pt}
   636 \src{See equation (6)}
   637 \def\rulecolor{blue!70}
   638 \includeclip{4}{134 391 483 584}{els1.pdf}
   639 \def\rulecolor{orange}
   640                  	
   641 \noindent When this document is typeset for publication in a
   642 model 3+ journal with double columns, the equation will overlap
   643 the second column text matter if the equation is not broken at
   644 the appropriate location.
   645 
   646 \vspace*{6pt}
   647 \def\rulecolor{blue!70}
   648 \src{See equation (6) overprints into second column}
   649 \includeclip{3}{61 531 532 734}{els-3pd.pdf}
   650 \def\rulecolor{orange}
   651 
   652 \pagebreak
   653 
   654 \noindent The typesetter will try to break the equation which
   655 need not necessarily be to the liking of the author or as it
   656 happens, typesetter's break point may be semantically incorrect.
   657 Therefore, authors may check their submissions for the incidence
   658 of such long equations and break the equations at the correct
   659 places so that the final typeset copy will be as they wish.
   660 
   661 \section{Final print}\label{sec:final}
   662 
   663 The authors can format their submission to the page size and margins
   664 of their preferred journal.  \file{elsarticle} provides four
   665 class options for the same. But it does not mean that using these
   666 options you can emulate the exact page layout of the final print copy. 
   667 \lmrgn=3em
   668 \begin{description}
   669 \item [\texttt{1p}:] $1+$ journals with a text area of
   670 384pt $\times$ 562pt or 13.5cm $\times$ 19.75cm or 5.3in $\times$
   671 7.78in, single column style only.
   672 
   673 \item [\texttt{3p}:] $3+$ journals with a text area of 468pt
   674 $\times$ 622pt or 16.45cm $\times$ 21.9cm or 6.5in $\times$
   675 8.6in, single column style.
   676 
   677 \item [\texttt{twocolumn}:] should be used along with 3p option if the
   678 journal is $3+$ with the same text area as above, but double column
   679 style. 
   680 
   681 \item [\texttt{5p}:] $5+$ with text area of 522pt $\times$
   682 682pt or 18.35cm $\times$ 24cm or 7.22in $\times$ 9.45in,
   683 double column style only.
   684 \end{description}
   685 
   686 Following pages have the clippings of different parts of
   687 the title page of different journal models typeset in final
   688 format.
   689 
   690 Model $1+$ and $3+$  will have the same look and
   691 feel in the typeset copy when presented in this document. That is
   692 also the case with the double column $3+$ and $5+$ journal article
   693 pages. The only difference will be wider text width of
   694 higher models.  Therefore we will look at the
   695 different portions of a typical single column journal page and
   696 that of a double column article in the final format.
   697 
   698 \vspace*{2pc}
   699 
   700 \begin{center}
   701 \hypertarget{bsc}{}
   702 \hyperlink{sc}{
   703 {\bf [Specimen single column article -- Click here]}
   704 }
   705 
   706 \vspace*{2pc}
   707 
   708 \hypertarget{bsc}{}
   709 \hyperlink{dc}{
   710 {\bf [Specimen double column article -- Click here]}
   711 }
   712 \end{center}
   713 
   714 \newpage
   715 \vspace*{-2pc}
   716 \src{}\hypertarget{sc}{}
   717 \def\rulecolor{blue!70}
   718 \hyperlink{bsc}{\includeclip{1}{121 81 497 670}{els1.pdf}}
   719 \def\rulecolor{orange}
   720 
   721 
   722 \newpage
   723 
   724 \src{}\hypertarget{dc}{}
   725 \def\rulecolor{blue!70}
   726 \hyperlink{bsc}{\includeclip{1}{55 93 535 738}{els-3pd.pdf}}
   727 \def\rulecolor{orange}
   728 
   729 \end{document}