elsarticle/doc/elsdoc.tex
changeset 0 bc6edeef8717
equal deleted inserted replaced
-1:000000000000 0:e25ebfe53b07
       
     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}