From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- macros/latex/contrib/elsarticle/README | 48 + .../latex/contrib/elsarticle/doc/1pseperateaug.pdf | Bin 0 -> 100656 bytes .../contrib/elsarticle/doc/1psingleauthorgroup.pdf | Bin 0 -> 100216 bytes macros/latex/contrib/elsarticle/doc/elsdoc.pdf | Bin 0 -> 453062 bytes macros/latex/contrib/elsarticle/doc/elsdoc.tex | 795 ++++++ macros/latex/contrib/elsarticle/doc/elstest-1p.pdf | Bin 0 -> 99904 bytes .../elsarticle/doc/elstest-1pdoubleblind.pdf | Bin 0 -> 248968 bytes macros/latex/contrib/elsarticle/doc/elstest-3p.pdf | Bin 0 -> 98705 bytes .../latex/contrib/elsarticle/doc/elstest-3pd.pdf | Bin 0 -> 100019 bytes macros/latex/contrib/elsarticle/doc/elstest-5p.pdf | Bin 0 -> 99256 bytes macros/latex/contrib/elsarticle/doc/jfigs.pdf | 2674 ++++++++++++++++++++ macros/latex/contrib/elsarticle/doc/makefile | 41 + macros/latex/contrib/elsarticle/doc/pdfwidgets.sty | 384 +++ macros/latex/contrib/elsarticle/doc/rvdtx.sty | 476 ++++ .../latex/contrib/elsarticle/elsarticle-harv.bst | 1597 ++++++++++++ .../contrib/elsarticle/elsarticle-num-names.bst | 1534 +++++++++++ macros/latex/contrib/elsarticle/elsarticle-num.bst | 1508 +++++++++++ .../elsarticle/elsarticle-template-harv.tex | 147 ++ .../elsarticle/elsarticle-template-num-names.tex | 152 ++ .../contrib/elsarticle/elsarticle-template-num.tex | 153 ++ macros/latex/contrib/elsarticle/elsarticle.dtx | 1166 +++++++++ macros/latex/contrib/elsarticle/elsarticle.ins | 67 + macros/latex/contrib/elsarticle/manifest.txt | 78 + 23 files changed, 10820 insertions(+) create mode 100644 macros/latex/contrib/elsarticle/README create mode 100644 macros/latex/contrib/elsarticle/doc/1pseperateaug.pdf create mode 100644 macros/latex/contrib/elsarticle/doc/1psingleauthorgroup.pdf create mode 100644 macros/latex/contrib/elsarticle/doc/elsdoc.pdf create mode 100644 macros/latex/contrib/elsarticle/doc/elsdoc.tex create mode 100644 macros/latex/contrib/elsarticle/doc/elstest-1p.pdf create mode 100644 macros/latex/contrib/elsarticle/doc/elstest-1pdoubleblind.pdf create mode 100644 macros/latex/contrib/elsarticle/doc/elstest-3p.pdf create mode 100644 macros/latex/contrib/elsarticle/doc/elstest-3pd.pdf create mode 100644 macros/latex/contrib/elsarticle/doc/elstest-5p.pdf create mode 100644 macros/latex/contrib/elsarticle/doc/jfigs.pdf create mode 100644 macros/latex/contrib/elsarticle/doc/makefile create mode 100644 macros/latex/contrib/elsarticle/doc/pdfwidgets.sty create mode 100644 macros/latex/contrib/elsarticle/doc/rvdtx.sty create mode 100644 macros/latex/contrib/elsarticle/elsarticle-harv.bst create mode 100644 macros/latex/contrib/elsarticle/elsarticle-num-names.bst create mode 100644 macros/latex/contrib/elsarticle/elsarticle-num.bst create mode 100644 macros/latex/contrib/elsarticle/elsarticle-template-harv.tex create mode 100644 macros/latex/contrib/elsarticle/elsarticle-template-num-names.tex create mode 100644 macros/latex/contrib/elsarticle/elsarticle-template-num.tex create mode 100644 macros/latex/contrib/elsarticle/elsarticle.dtx create mode 100644 macros/latex/contrib/elsarticle/elsarticle.ins create mode 100644 macros/latex/contrib/elsarticle/manifest.txt (limited to 'macros/latex/contrib/elsarticle') diff --git a/macros/latex/contrib/elsarticle/README b/macros/latex/contrib/elsarticle/README new file mode 100644 index 0000000000..cd0929a7d7 --- /dev/null +++ b/macros/latex/contrib/elsarticle/README @@ -0,0 +1,48 @@ +This is Elsevier's new document class for typeset journal articles, +elsarticle.cls. It is now accepted for submitted articles, both in +Elsevier's electronic submission system and elsewhere. + +Elsevier's previous document class for typeset articles, elsart.cls, +is now over 10 years old. It has been replaced with this newly written +document class elsarticle.cls, which has been developed for Elsevier +by the leading TeX developer STM Document Engineering Pvt Ltd. + +elsarticle.cls is based upon the standard LaTeX document class +article.cls. It uses natbib.sty for bibliographical references. + +Bugs and problems with elsarticle.cls may be reported to the +developers of the class via elsarticle@stmdocs.in. + +The file manifest.txt provides a list of the files in the elsarticle +bundle. The following are the main files available: +- elsarticle.dtx, the dtx file +- elsdoc.pdf, the user documentation +- elsarticle-template-num.tex, template file for numerical citations +- elsarticle-template-harv.tex, template file for name-year citations +- elsarticle-template-num-names.tex, template file for numerical + citations + new natbib option. Eg. Jones et al. [21] +- elsarticle-num.bst, bibliographic style for numerical references +- elsarticle-harv.bst, bibliographic style for name-year references +- elsarticle-num-names.bst, bibliographic style for numerical + referencces + new natbib option for citations. + +To extract elsarticle.cls from *.dtx: latex elsarticle.ins + +The documentation file is elsdoc.tex in the contrib directory. To +compile it: +1. pdflatex elsdoc +2. pdflatex elsdoc +3. pdflatex elsdoc + +or + +use the makefile. Use the target `all' (eg: make all). + +The above procedure will create a print version, namely elsdoc.pdf. + +Copyright 2007-2019, Elsevier. Bugs, feature requests, suggestions and +comments may be mailed to elsarticle@stmdocs.in. elsarticle.cls, +related documentation and supporting packages are released under the +LATEX Project Public Licence, either version 1.3 or any later +version. This work has the LPPL maintenance status +'author-maintained'. diff --git a/macros/latex/contrib/elsarticle/doc/1pseperateaug.pdf b/macros/latex/contrib/elsarticle/doc/1pseperateaug.pdf new file mode 100644 index 0000000000..c3e49ea50d Binary files /dev/null and b/macros/latex/contrib/elsarticle/doc/1pseperateaug.pdf differ diff --git a/macros/latex/contrib/elsarticle/doc/1psingleauthorgroup.pdf b/macros/latex/contrib/elsarticle/doc/1psingleauthorgroup.pdf new file mode 100644 index 0000000000..4dd7c45100 Binary files /dev/null and b/macros/latex/contrib/elsarticle/doc/1psingleauthorgroup.pdf differ diff --git a/macros/latex/contrib/elsarticle/doc/elsdoc.pdf b/macros/latex/contrib/elsarticle/doc/elsdoc.pdf new file mode 100644 index 0000000000..1669827334 Binary files /dev/null and b/macros/latex/contrib/elsarticle/doc/elsdoc.pdf differ diff --git a/macros/latex/contrib/elsarticle/doc/elsdoc.tex b/macros/latex/contrib/elsarticle/doc/elsdoc.tex new file mode 100644 index 0000000000..0c3e02cb31 --- /dev/null +++ b/macros/latex/contrib/elsarticle/doc/elsdoc.tex @@ -0,0 +1,795 @@ +%% +%% Copyright 2007-2019 Elsevier Ltd +%% +%% This file is part of the 'Elsarticle Bundle'. +%% --------------------------------------------- +%% +%% It may be distributed under the conditions of the LaTeX Project Public +%% License, either version 1.2 of this license or (at your option) any +%% later version. The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.2 or later is part of all distributions of LaTeX +%% version 1999/12/01 or later. +%% +%% The list of all files belonging to the 'Elsarticle Bundle' is +%% given in the file `manifest.txt'. +%% +%% $Id: elsdoc.tex 160 2019-01-14 09:25:49Z rishi $ +%% +\documentclass[a4paper,12pt]{article} + +\usepackage[xcolor,qtwo]{rvdtx} +\usepackage{multicol} +\usepackage{color} +\usepackage{xspace} +\usepackage{pdfwidgets} +\usepackage{enumerate} + +\def\ttdefault{cmtt} + +\headsep4pc + +\makeatletter +\def\bs{\expandafter\@gobble\string\\} +\def\lb{\expandafter\@gobble\string\{} +\def\rb{\expandafter\@gobble\string\}} +\def\@pdfauthor{C.V.Radhakrishnan} +\def\@pdftitle{elsarticle.cls -- A documentation} +\def\@pdfsubject{Document formatting with elsarticle.cls} +\def\@pdfkeywords{LaTeX, Elsevier Ltd, document class} +\def\file#1{\textsf{#1}\xspace} + +%\def\LastPage{19} + +\DeclareRobustCommand{\LaTeX}{L\kern-.26em% + {\sbox\z@ T% + \vbox to\ht\z@{\hbox{\check@mathfonts + \fontsize\sf@size\z@ + \math@fontsfalse\selectfont + A\,}% + \vss}% + }% + \kern-.15em% + \TeX} +\makeatother + +\def\figurename{Clip} + +\setcounter{tocdepth}{1} + +\begin{document} + +\def\testa{This is a specimen document. } +\def\testc{\testa\testa\testa\testa} +\def\testb{\testc\testc\testc\testc\testc} +\long\def\test{\testb\par\testb\par\testb\par} + +\pinclude{\copy\contbox\printSq{\LastPage}} + +\title{elsarticle.cls -- A better way to format your document} + +\author{Elsevier Ltd} +\contact{elsarticle@stmdocs.in} + +\version{3.2} +\date{\today} +\maketitle + +\section{Introduction} + +\file{elsarticle.cls} is a thoroughly re-written document class +for formatting \LaTeX{} submissions to Elsevier journals. +The class uses the environments and commands defined in \LaTeX{} kernel +without any change in the signature so that clashes with other +contributed \LaTeX{} packages such as \file{hyperref.sty}, +\file{preview-latex.sty}, etc., will be minimal. +\file{elsarticle.cls} is primarily built upon the default +\file{article.cls}. This class depends on the following packages +for its proper functioning: + +\begin{enumerate} +\item \file{natbib.sty} for citation processing; +\item \file{geometry.sty} for margin settings; +\item \file{fleqn.clo} for left aligned equations; +\item \file{graphicx.sty} for graphics inclusion; +\item \file{txfonts.sty} optional font package, if the document is to + be formatted with Times and compatible math fonts; +\item \file{hyperref.sty} optional packages if hyperlinking is + required in the document; +%*% +\item \file{endfloat.sty} optional packages if floats to be placed at + end of the PDF. +\end{enumerate} + +All the above packages (except some optional packages) are part of any +standard \LaTeX{} installation. Therefore, the users need not be +bothered about downloading any extra packages. Furthermore, users are +free to make use of \textsc{ams} math packages such as +\file{amsmath.sty}, \file{amsthm.sty}, \file{amssymb.sty}, +\file{amsfonts.sty}, etc., if they want to. All these packages work in +tandem with \file{elsarticle.cls} without any problems. + +\section{Major Differences} + +Following are the major differences between \file{elsarticle.cls} +and its predecessor package, \file{elsart.cls}: + +\begin{enumerate}[\textbullet] +\item \file{elsarticle.cls} is built upon \file{article.cls} +while \file{elsart.cls} is not. \file{elsart.cls} redefines +many of the commands in the \LaTeX{} classes/kernel, which can +possibly cause surprising clashes with other contributed +\LaTeX{} packages; + +\item provides preprint document formatting by default, and +optionally formats the document as per the final +style of models $1+$, $3+$ and $5+$ of Elsevier journals; + +\item some easier ways for formatting \verb+list+ and +\verb+theorem+ environments are provided while people can still +use \file{amsthm.sty} package; + +\item \file{natbib.sty} is the main citation processing package + which can comprehensively handle all kinds of citations and +works perfectly with \file{hyperref.sty} in combination with +\file{hypernat.sty}; + +\item long title pages are processed correctly in preprint and + final formats. + +\end{enumerate} + +\section{Installation} + +The package is available at author resources page at Elsevier +(\url{http://www.elsevier.com/locate/latex}). +It can also be found in any of the nodes of the Comprehensive +\TeX{} Archive Network (\textsc{ctan}), one of the primary nodes +being +\url{http://tug.ctan.org/tex-archive/macros/latex/contrib/elsarticle/}. +Please download the \file{elsarticle.dtx} which is a composite +class with documentation and \file{elsarticle.ins} which is the +\LaTeX{} installer file. When we compile the +\file{elsarticle.ins} with \LaTeX{} it provides the class file, +\file{elsarticle.cls} by +stripping off all the documentation from the \verb+*.dtx+ file. +The class may be moved or copied to a place, usually, +\verb+$TEXMF/tex/latex/elsevier/+, %$%%%%%%%%%%%%%%%%%%%%%%%%%%%% +or a folder which will be read +by \LaTeX{} during document compilation. The \TeX{} file +database needs updation after moving/copying class file. Usually, +we use commands like \verb+mktexlsr+ or \verb+texhash+ depending +upon the distribution and operating system. + + +\section{Usage}\label{sec:usage} +The class should be loaded with the command: + +\begin{vquote} + \documentclass[]{elsarticle} +\end{vquote} + +\noindent where the \verb+options+ can be the following: + + +\begin{description} + +\item [{\tt\color{verbcolor} preprint}] default option which format the + document for submission to Elsevier journals. + +\item [{\tt\color{verbcolor} review}] similar to the \verb+preprint+ +option, but increases the baselineskip to facilitate easier review +process. + +\item [{\tt\color{verbcolor} 1p}] formats the article to the look and +feel of the final format of model 1+ journals. This is always single +column style. + +\item [{\tt\color{verbcolor} 3p}] formats the article to the look and +feel of the final format of model 3+ journals. If the journal is a two +column model, use \verb+twocolumn+ option in combination. + +\item [{\tt\color{verbcolor} 5p}] formats for model 5+ journals. This +is always of two column style. + +\item [{\tt\color{verbcolor} authoryear}] author-year citation style of +\file{natbib.sty}. If you want to add extra options of +\file{natbib.sty}, you may use the options as comma delimited strings +as arguments to \verb+\biboptions+ command. An example would be: +\end{description} + +\begin{vquote} + \biboptions{longnamesfirst,angle,semicolon} +\end{vquote} + +\begin{description} +\item [{\tt\color{verbcolor} number}] numbered citation style. Extra options + can be loaded with\linebreak \verb+\biboptions+ command. + +\item [{\tt\color{verbcolor} sort\&compress}] sorts and compresses the +numbered citations. For example, citation [1,2,3] will become [1--3]. + +\item [{\tt\color{verbcolor} longtitle}] if front matter is unusually long, use + this option to split the title page across pages with the correct +placement of title and author footnotes in the first page. + +\item [{\tt\color{verbcolor} times}] loads \file{txfonts.sty}, if +available in the system to use Times and compatible math fonts. + +%*% +\item [{\tt\color{verbcolor} reversenotenum}] Use alphabets as +author--affiliation linking labels and use numbers for author +footnotes. By default, numbers will be used as author--affiliation +linking labels and alphabets for author footnotes. + +\item [{\tt\color{verbcolor} lefttitle}] To move title and +author/affiliation block to flushleft. \verb+centertitle+ is the +default option which produces center alignment. + +\item [{\tt\color{verbcolor} endfloat}] To place all floats at the end +of the document. + +\item [{\tt\color{verbcolor} nonatbib}] To unload natbib.sty. +%*% + +\item [{\tt\color{verbcolor} doubleblind}] To hide author name, +affiliation, email address etc. for double blind refereeing purpose. +%*% + +\item[] All options of \file{article.cls} can be used with this + document class. + +\item[] The default options loaded are \verb+a4paper+, \verb+10pt+, + \verb+oneside+, \verb+onecolumn+ and \verb+preprint+. + +\end{description} + +\section{Frontmatter} + +There are two types of frontmatter coding: +\begin{enumerate}[(1)] +\item each author is +connected to an affiliation with a footnote marker; hence all +authors are grouped together and affiliations follow; +\pagebreak +\item authors of same affiliations are grouped together and the +relevant affiliation follows this group. +\end{enumerate} + +An example of coding the first type is provided below. + +\begin{vquote} + \title{This is a specimen title\tnoteref{t1,t2}} + \tnotetext[t1]{This document is the results of the research + project funded by the National Science Foundation.} + \tnotetext[t2]{The second title footnote which is a longer + text matter to fill through the whole text width and + overflow into another line in the footnotes area of the + first page.} +\end{vquote} + +\begin{vquote} +\author[1]{Jos Migchielsen\corref{cor1}% + \fnref{fn1}} +\ead{J.Migchielsen@elsevier.com} + +\author[2]{CV Radhakrishnan\fnref{fn2}} +\ead{cvr@sayahna.org} + +\author[3]{CV Rajagopal\fnref{fn1,fn3}} +\ead[url]{www.stmdocs.in} +\end{vquote} + +\begin{vquote} + \cortext[cor1]{Corresponding author} + \fntext[fn1]{This is the first author footnote.} + \fntext[fn2]{Another author footnote, this is a very long + footnote and it should be a really long footnote. But this + footnote is not yet sufficiently long enough to make two + lines of footnote text.} + \fntext[fn3]{Yet another author footnote.} + + \address[1]{Elsevier B.V., Radarweg 29, 1043 NX Amsterdam, + The Netherlands} + \address[2]{Sayahna Foundations, JWRA 34, Jagathy, + Trivandrum 695014, India} + \address[3]{STM Document Engineering Pvt Ltd., Mepukada, + Malayinkil, Trivandrum 695571, India} +\end{vquote} + +The output of the above \TeX{} source is given in Clips~\ref{clip1} and +\ref{clip2}. The header portion or title area is given in +Clip~\ref{clip1} and the footer area is given in Clip~\ref{clip2}. + +\def\rulecolor{blue!70} +\src{Header of the title page.} +\includeclip{1}{130 612 477 707}{1psingleauthorgroup.pdf}%%{elstest-1p.pdf}%single author group +\def\rulecolor{orange} + +\def\rulecolor{blue!70} +\src{Footer of the title page.} +\includeclip{1}{93 135 499 255}{1pseperateaug.pdf}%%{elstest-1p.pdf}%single author group +\def\rulecolor{orange} + +Most of the commands such as \verb+\title+, \verb+\author+, +\verb+\address+ are self explanatory. Various components are +linked to each other by a label--reference mechanism; for +instance, title footnote is linked to the title with a footnote +mark generated by referring to the \verb+\label+ string of +the \verb=\tnotetext=. We have used similar commands +such as \verb=\tnoteref= (to link title note to title); +\verb=\corref= (to link corresponding author text to +corresponding author); \verb=\fnref= (to link footnote text to +the relevant author names). \TeX{} needs two compilations to +resolve the footnote marks in the preamble part. +Given below are the syntax of various note marks and note texts. + + +\begin{vquote} + \tnoteref{} + \corref{} + \fnref{} + \tnotetext[