diff options
author | Reinhard Kotucha <reinhard.kotucha@web.de> | 2007-04-08 17:41:48 +0000 |
---|---|---|
committer | Reinhard Kotucha <reinhard.kotucha@web.de> | 2007-04-08 17:41:48 +0000 |
commit | caef592b102b13a49c19d22bc87241b0a99d4045 (patch) | |
tree | ae3286c83dc1de120d96970506a1f7b32c0645c0 /Master/texmf-dist/source/latex/achemso | |
parent | fef1c7cc8da3bb031c00eebb78b8e40629c27c03 (diff) |
update achemso to v2.1
git-svn-id: svn://tug.org/texlive/trunk@4129 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/achemso')
-rw-r--r-- | Master/texmf-dist/source/latex/achemso/achemso.dtx | 275 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/achemso/achemso.ins | 4 |
2 files changed, 207 insertions, 72 deletions
diff --git a/Master/texmf-dist/source/latex/achemso/achemso.dtx b/Master/texmf-dist/source/latex/achemso/achemso.dtx index ad82164e826..24e83c19dfa 100644 --- a/Master/texmf-dist/source/latex/achemso/achemso.dtx +++ b/Master/texmf-dist/source/latex/achemso/achemso.dtx @@ -12,13 +12,14 @@ % %<package>\NeedsTeXFormat{LaTeX2e}[2005/12/01] %<package>\ProvidesPackage{achemso} -%<package> [2007/01/17 v2.0 Enhancements for ACS publications] +%<package> [2007/02/15 v2.1 Enhancements for ACS publications] % %<*driver> \documentclass[a4paper]{ltxdoc} \usepackage[T1]{fontenc} -\usepackage[english,UKenglish]{babel} -\usepackage{achemso,rsc,booktabs,array,url} +\usepackage{booktabs,array} % Used to get nice-looking tables +\usepackage{url} +\usepackage{achemso} \EnableCrossrefs %\DisableCrossrefs % Say \DisableCrossrefs if index is ready \RecordChanges % Gather update information @@ -37,16 +38,22 @@ \end{document} %</driver> % \fi -% \CheckSum{73} -% \changes{v1.0}{1998/06/01}{Initial release of package by Mats Dahlgren} +% \CheckSum{88} +% \changes{v1.0}{1998/06/01}{Initial release of package by Mats +% Dahlgren} % \changes{v2.0}{2007/01/17}{Re-write of package by Joseph Wright} -% \changes{v2.0}{2007/01/17}{Several improvements to BibTeX style files} +% \changes{v2.0}{2007/01/17}{Several improvements to BibTeX style +% files} % \changes{v2.0}{2007/01/17}{License changed to LPPL} +% \changes{v2.1}{2007/02/15}{Updated documentation to reflect 3rd +% edition of ACS Style Guide} +% \changes{v2.1}{2007/02/15}{BibTeX style improved to reflect 3rd +% edition of ACS Style Guide} % % \DoNotIndex{\def,\else,\fi,\global,\texttt,\ifx,\newif,\undefined} % \DoNotIndex{\ProcessOptions,\DeclareOption,\OptionNotUsed,\@gobble} % \DoNotIndex{\RequirePackage,\PackageWarning,\renewcommand,\@eha} -% \DoNotIndex{\@ifpackageloaded,\PackageError,\relax} +% \DoNotIndex{\@ifpackageloaded,\PackageError,\relax,\emph} % % \maketitle % @@ -59,38 +66,84 @@ % % \section{Introduction} % -% Although synthetic chemists do not, in the main, use LaTeX for the -% preparation of journal articles, it would be nice to be able to use -% it for reports. Some (mainly) physical chemistry journals do -% also accept LaTeX submissions, and so the need for BibTeX styles -% for chemistry is real. The package |achemso| provides for a BibTeX -% style and other support for articles and reports in the style of -% the American Chemical Society (A.C.S.). Journals which use the -% standard A.C.S. citation style are summarised in -% \ref{tbl:journals}. +% Synthetic chemists do not, in the main, use LaTeX for the +% preparation of journal articles. Some journals, mainly in the +% physical chemistry area, do accept LaTeX submissions. Given the +% clear advantages of LaTeX over other methods, it would be +% nice to be able to use LaTeX for preparing reports. Thus the need +% for BibTeX styles for chemistry is real. The package |achemso| +% provides for a BibTeX style and other support for articles and +% reports in the style of the American Chemical Society (ACS). +% +% As describe in \emph{The ACS Style Guide} \cite{Coghill2006}, +% almost all ACS publications use the same style for the formatting +% of references. The reproduction of this style is the aim of the +% BibTeX style file provided here. However, the ACS use different +% citation styles in different publications. The |achemso| package +% provides support for the two numerical systems: superscript +% and italic in-text citations. The majority of ACS journals use +% the superscript method (Table \ref{tbl:journals-super}), with a +% smaller number using the italic system (Table +% \ref{tbl:journals-inline}). The journal \emph{Biochemistry} does +% not use the standard ACS style for references, and so is not +% covered by the |achemso| package. % \begin{table} +% \centering +% \small % \begin{tabular}{>{\itshape}l>{\itshape}l} % \toprule -% \upshape{Journal Title} & \upshape{Abbreviation} \\ +% \upshape{Journal Title} & \upshape{\emph{CASSI} Abbreviation} \\ % \midrule -% Journal of the American Chemical Society & J.~Am.~Chem.~Soc. \\ % Accounts of Chemical Research & Acc.~Chem.~Res. \\ +% Analytical Chemistry & Anal.~Chem. \\ +% Biomacromolecules & Biomacromolecules \\ % Chemical Reviews & Chem.~Rev. \\ +% Chemistry of Materials & Chem.~Mater. \\ +% Crystal Growth \& Design & Cryst.~Growth Des. \\ +% Energy \& Fuels & Energy Fuels \\ +% Industrial \& Engineering Chemistry Research & Ind.~Eng.~Chem.~Res. \\ % Inorganic Chemistry & Inorg.Chem. \\ +% Journal of the American Chemical Society & J.~Am.~Chem.~Soc. \\ +% Journal of Chemical and Engineering Data & J.~Chem.~Eng.~Data \\ +% Journal of Chemical Theory and Computation & J.~Chem.~Theory Comput. \\ +% Journal of Chemical Information and Modeling & J.~Chem.~Inf.~Model. \\ +% Journal of Combinatorial Chemistry & J.~Comb.~Chem. \\ % Journal of Medicinal Chemistry & J.~Med.~Chem. \\ -% Journal of Organic Chemistry & J.~Org.~Chem. \\ -% Journal of Physical Chemistry A & J.~Phys.~Chem.~A \\ -% Journal of Physical Chemistry B & J.~Phys.~Chem.~B \\ -% Journal of Physical Chemistry C & J.~Phys.~Chem.~C \\ +% Journal of Natural Products & J.~Nat.~Prod. \\ +% The Journal of Organic Chemistry & J.~Org.~Chem. \\ +% The Journal of Physical Chemistry A & J.~Phys.~Chem.~A \\ +% The Journal of Physical Chemistry B & J.~Phys.~Chem.~B \\ +% The Journal of Physical Chemistry C & J.~Phys.~Chem.~C \\ +% Journal of Proteome Research & J.~Proteome Res. \\ % Langmuir & Langmuir \\ % Macromolecules & Macromolecules \\ +% Molecular Pharmaceutics & Mol.~Pharm. \\ % Nano Letters & Nano Lett. \\ % Organic Letters & Org.~Lett. \\ +% Organic Process Research \& Design & Org.~Process Res.~Dev. \\ % Organometallics & Organometallics \\ % \bottomrule % \end{tabular} -% \caption{Journals using the A.C.S.~citation style} -% \label{tbl:journals} +% \caption{Journals using the ACS reference style with superscript citations} +% \label{tbl:journals-super} +% \end{table} +% \begin{table} +% \small +% \centering +% \begin{tabular}{>{\itshape}l>{\itshape}l} +% \toprule +% \upshape{Journal Title} & \upshape{\emph{CASSI} Abbreviation} \\ +% \midrule +% ACS Chemical Biology & ACS Chem.~Biol. \\ +% Bioconjugate Chemistry & Bioconjugate Chem. \\ +% Biotechnology Progress & Biotechnol.~Prog. \\ +% Chemical Research in Toxicology & Chem.~Res.~Toxicol. \\ +% Environmental Science and Technology & Envirn.~Sci.~Technol. \\ +% Journal of Agricultural and Food Chemistry & J.~Agric.~Food Chem. \\ +% \bottomrule +% \end{tabular} +% \caption{Journals using the ACS reference style with in-text citations} +% \label{tbl:journals-inline} % \end{table} % % This package consists of two BibTeX files (|achemso.bst| @@ -99,7 +152,7 @@ % the need to pick a unique name. To quote the documentation to the % first version: % \begin{quote} -% [\dots] there is already a LaTeX 2.09 and +% there is already a LaTeX 2.09 and % BibTeX style package called |acsarticle| and % |acs.bst|, which are not ``ACS'' as in `American Chemical % Society' (rather, this package is @@ -107,7 +160,7 @@ % \emph{Advances in Control Systems}). Hence, \emph{this} % new package had to be given another name. The name of choice % was then |achemso|, which is made from the words -% ``\emph{A}merican \emph{Chem}ical \emph{So}ciety''. +% ``\emph{A}merican \emph{Chem}ical \emph{So}ciety.'' % \end{quote} % % \subsection{Change of maintainer} @@ -123,12 +176,14 @@ % \section{The BibTeX style files} % % The BibTeX style files implement the bibliographic style specified -% by the A.C.S.\ in \emph{The ACS Style Guide: A Manual for Authors -% and Editors}, on the A.C.S.\ website -% (\url{http://pubs.acs.org/books/references.shtml}) and in current -% A.C.S.~publications. Some of this information can be -% contradictory; the consensus of current practice in the printed -% journals has been taken as the correct approach. +% by the ACS in \emph{The ACS Style Guide} \cite{Coghill2006}, +% on the ACS website \cite{ACS2007}, and in current ACS publications. +% Some of this information can be contradictory; the consensus of +% current practice in \emph{Journal of the American Chemical Society} +% has been taken as the correct approach. In addition to the problem +% of picking the correct style, some of the BibTeX record types are +% difficult to match to standard references in ACS journals. The +% ``best guess'' has been taken with these. % % \subsection{Additional record types} % @@ -139,7 +194,7 @@ % \item[|patent|] A patent: formatting is similar to other record % types. The data entry for this record type follows the % pattern used in |rsc.bst|: |journal| is used to hold -% the patent type (\emph{e.g.} ``U.S. Pat.''), with the +% the patent type (\emph{e.g.}~``U.S.~Patent''), with the % patent number given in |pages|. Whilst this format is % non-standard, it is relatively easy to use and implement! % \item[|submitted|] Articles submitted to journals but not @@ -156,10 +211,22 @@ % The requirements for entries in the BibTeX database are slightly % different using |achemso.bst| to the standard style files. This % is mainly because some fields are not cited in -% A.C.S.\ bibliographies. In particular, journal articles do not -% require a title (as the |title| field is ignored). Articles +% ACS bibliographies. In particular, journal articles do not +% require a title (the |title| field is ignored). Articles % in books only need the title of the book; the title of the -% subunit (given in |title|) is again ignored. +% subunit (given in |title|) is again ignored. This is the practice +% in \emph{Journal of the American Chemical Society}: some of the +% other journals may take a different approach. +% +% \subsection{References to software} +% +% Referencing software is always a little difficult. The style files +% provided here follow the normal LaTeX convention of using the +% |manual| record type to cite software. The only requirement is a +% |title|, but fields such as |organization| may be used for more +% detail. The |edition| field is used to format the software version +% correctly: this will automatically be prefixed with ``version'' by +% the style file. % % \subsection{The \textsf{annotate} field} % @@ -186,9 +253,9 @@ % \subsection{Predefined journal abbreviations} % % A number of journal abbreviations are defined in the |.bst| files. -% The abbreviations cover a number A.C.S.\ journals, several other +% The abbreviations cover a number ACS journals, several other % physical chemistry publications and other journals listed as -% highly cited by \emph{Chem.\ Abs.} The interested user should +% highly cited by \emph{Chem.\ Abs.}~The interested user should % consult the |.bst| files for full details. % % \section{The LaTeX Package} @@ -212,7 +279,7 @@ % types.\footnote{This only works if the |babel| package is % \emph{not} loaded.} % -% The |achemso| package has three options: |note|, +% The |achemso| package has four options: |note|, % |list|, and |number|: % \begin{description} % \item[|note|] If the bibliography contains notes as well @@ -229,9 +296,16 @@ % about a particular database entry. It also adds the % BibTeX key for each citation as a marginal note to the % output, using the |showkeys| package. +% \item[|notsuper|] Switches from superscript citations +% (\emph{e.g.}~Author \emph{et al.}$^3$) to +% in-text ones in italics (\emph{e.g.} Author +% \emph{et al.}~(\emph{3})). There is a |super| +% option for completeness, which simply gives the default +% behaviour. % \end{description} % -% \StopEventually{\PrintChanges} +% \StopEventually{\PrintChanges% +% \bibliography{achemso}} % % \section{The Package Code} % @@ -243,38 +317,54 @@ % can detect the version of achemso in use. % \begin{macrocode} %<*package> -\def\ACSver{\texttt{achemso} v2.0 (2007/01/17)} +\def\ACSver{\texttt{achemso} v2.1 (2007/02/15)} % \end{macrocode} % \end{macro} % \begin{macro}{\ACS@sctnnmbr} % \begin{macro}{\ACS@lst} % \begin{macro}{\ACS@note} % \changes{v2.0}{2007/01/17}{Boolean values made internal to package} -% Three Boolean values are used to handle the options. +% \begin{macro}{\ACS@super} +% \changes{v2.1}{2007/02/15}{New Boolean for citation control} +% Four Boolean values are used to handle the options. % \begin{macrocode} \newif \ifACS@sctnnmbr \ACS@sctnnmbrfalse \newif \ifACS@lst \ACS@lstfalse \newif \ifACS@note \ACS@notefalse +\newif \ifACS@super \ACS@supertrue % \end{macrocode} % \end{macro} % \end{macro} % \end{macro} -% The options are processed, and the |cite| package is loaded to -% sort and compress references correctly. The ACS also have -% no gaps in between reference numbers, so the |nospace| option -% is used. +% \end{macro} +% The options are processed. % \begin{macrocode} \DeclareOption{note}{\global\ACS@notetrue} \DeclareOption{number}{\global\ACS@sctnnmbrtrue} -\DeclareOption{list}{\global\ACS@lsttrue} +\DeclareOption{list}{} +\DeclareOption{notsuper}{\global\ACS@superfalse} \DeclareOption*{\OptionNotUsed} \ProcessOptions -\RequirePackage[super,nospace]{cite} +% \end{macrocode} +% \changes{v2.1}{2007/02/15}{|cite| package is loaded with different +% options depending on citation style requested} +% The |cite| package is loaded to sort and compress references +% correctly. Depending upon the package option given, citations are +% either superscript or italic and in parentheses. +% \begin{macrocode} +\ifACS@super + \RequirePackage[super,nospace]{cite} +\else + \RequirePackage{cite} + \def\citeleft{(} + \def\citeright{)} + \def\citeform{\emph{#1}} +\fi % \end{macrocode} % If the |babel| package is loaded, the |note| option does not % work. So it is disabled here with a suitable warning. % \begin{macrocode} - \@ifpackageloaded{babel} +\@ifpackageloaded{babel} {\ACS@notefalse\PackageWarning{achemso}% {babel package loaded - note option disabled}} {\relax} @@ -581,6 +671,9 @@ FUNCTION {bbl.submitted} FUNCTION {bbl.techreport} { "Technical Report" } +FUNCTION {bbl.version} +{ "version" } + FUNCTION {bbl.volume} { "Vol." } @@ -1050,6 +1143,13 @@ FUNCTION {format.organization.address} if$ } +FUNCTION {format.version} +{ edition empty$ + { "" } + { bbl.version edition tie.or.space.connect } + if$ +} + FUNCTION {empty.misc.check} { author empty$ title empty$ howpublished empty$ year empty$ note empty$ @@ -1099,6 +1199,7 @@ FUNCTION {book} { title format.title "title" output.check } { booktitle format.title "booktitle" output.check } if$ + format.edition output new.block editor empty$ { "Need either an author or editor for " cite$ * warning$ } @@ -1112,9 +1213,9 @@ FUNCTION {book} { title format.title "title" output.check } { booktitle format.title "booktitle" output.check } if$ + format.edition output } if$ - format.edition output new.block format.number.series output new.block @@ -1146,6 +1247,7 @@ FUNCTION {inbook} { output.bibitem author empty$ { title format.title "title" output.check + format.edition output new.block editor empty$ { "Need at least an author or an editor for " cite$ * warning$ } @@ -1155,9 +1257,9 @@ FUNCTION {inbook} { format.authors output after.item 'output.state := title format.title.in "title" output.check + format.edition output } if$ - format.edition output new.block format.number.series output new.block @@ -1174,6 +1276,7 @@ FUNCTION {incollection} { output.bibitem author empty$ { booktitle format.title "booktitle" output.check + format.edition output new.block editor empty$ { "Need at least an author or an editor for " cite$ * warning$ } @@ -1183,9 +1286,9 @@ FUNCTION {incollection} { format.authors output after.item 'output.state := booktitle format.title.in "booktitle" output.check + format.edition output } if$ - format.edition output new.block format.number.series output new.block @@ -1217,7 +1320,13 @@ FUNCTION {inproceedings} { output.bibitem format.authors "author" output.check after.item 'output.state := - booktitle format.title.noemph "booktitle" output.check + title empty$ + 'skip$ + { title format.title.noemph output + after.sentence 'output.state := + } + if$ + booktitle format.title output address output format.bdate "year" output.check pages empty$ @@ -1234,9 +1343,9 @@ FUNCTION {manual} format.authors output after.item 'output.state := title format.title "title" output.check + format.version output new.block format.organization.address output - format.edition output format.bdate output note output fin.entry @@ -1257,7 +1366,10 @@ FUNCTION {misc} { output.bibitem format.authors output after.item 'output.state := - title format.title output + title empty$ + 'skip$ + { title format.title output } + if$ howpublished output year output note output @@ -1269,7 +1381,8 @@ FUNCTION {patent} { output.bibitem format.authors "author" output.check after.item 'output.state := - journal emphasize "journal" output.check + journal "journal" output.check + after.item 'output.state := format.pages.patent "pages" output.check format.bdate "year" output.check note output @@ -1319,19 +1432,23 @@ FUNCTION {techreport} format.authors "author" output.check after.item 'output.state := title format.title "title" output.check - institution + new.block type empty$ 'bbl.techreport 'type if$ - space.connect number empty$ - { "t" change.case$ } + 'skip$ { number tie.or.space.connect } if$ output format.pub.address output format.bdate "year" output.check + pages empty$ + 'skip$ + { new.block + format.pages output } + if$ note output fin.entry } @@ -1382,11 +1499,11 @@ MACRO {bicoc} {"Bioconj.\ Chem."} % *** MACRO {bitech} {"Biotechnol.\ Progr."} % *** MACRO {chemeng} {"Chem.\ Eng.\ News"} MACRO {chs} {"Chem.\ Health Safety"} % *** -MACRO {crt} {"Chem.\ Res.\ Tox."} % *** +MACRO {crt} {"Chem.\ Res.\ Toxicol."} % *** MACRO {chemrev} {"Chem.\ Rev."} % *** -MACRO {cmat} {"Chem.\ Mat."} % *** +MACRO {cmat} {"Chem.\ Mater."} % *** MACRO {chemtech} {"{CHEMTECH}"} % *** -MACRO {enfu} {"Energy \&{} Fuels"} % *** +MACRO {enfu} {"Energy Fuels"} % *** MACRO {envst} {"Environ.\ Sci.\ Technol."} MACRO {iecf} {"Ind.\ Eng.\ Chem.\ Fundam."} MACRO {iecpdd} {"Ind.\ Eng.\ Chem.\ Proc.\ Des.\ Dev."} @@ -1416,18 +1533,18 @@ MACRO {tfs} {"Trans.\ Faraday Soc."} MACRO {jcis} {"J.~Colloid Interface Sci."} MACRO {acis} {"Adv.~Colloid Interface Sci."} MACRO {cs} {"Colloids Surf."} -MACRO {csa} {"Colloids Surf.\ A:\ Physicochem.\ Eng.\ Apects"} -MACRO {csb} {"Colloids Surf.\ B:\ Biointerfaces"} +MACRO {csa} {"Colloids Surf.\ A"} +MACRO {csb} {"Colloids Surf.\ B"} MACRO {pcps} {"Progr.\ Colloid Polym.\ Sci."} MACRO {jmr} {"J.~Magn.\ Reson."} MACRO {jmra} {"J.~Magn.\ Reson.\ A"} MACRO {jmrb} {"J.~Magn.\ Reson.\ B"} -MACRO {sci} {"Science (Washington,~D.C.)"} -MACRO {nat} {"Nature (London)"} +MACRO {sci} {"Science"} +MACRO {nat} {"Nature"} MACRO {jcch} {"J.~Comput.\ Chem."} MACRO {cca} {"Croat.\ Chem.\ Acta"} -MACRO {angew} {"Angew.\ Chem.\ Int.\ Ed."} -MACRO {chemeurj} {"Chem.--Eur.\ J."} +MACRO {angew} {"Angew.\ Chem., Int.\ Ed."} +MACRO {chemeurj} {"Chem.---Eur.\ J."} MACRO {poly} {"Polymer"} MACRO {ajp} {"Am.\ J.\ Phys."} @@ -1437,11 +1554,11 @@ MACRO {cpl} {"Chem.\ Phys.\ Lett."} MACRO {molph} {"Mol.\ Phys."} MACRO {pac} {"Pure Appl.\ Chem."} MACRO {jbc} {"J.~Biol.\ Chem."} -MACRO {tl} {"Tetrahedron Lett.\"} +MACRO {tl} {"Tetrahedron Lett."} MACRO {psisoe} {"Proc.\ SPIE-Int.\ Soc.\ Opt.\ Eng."} -MACRO {prb} {"Phys.\ Rev.\ B:\ Condens.\ Matter"} +MACRO {prb} {"Phys.\ Rev.\ B:\ Condens.\ Matter Mater. Phys."} MACRO {jap} {"J.~Appl.\ Phys."} -MACRO {pnac} {"Proc.\ Natl.\ Acad.\ Sci.\ U.~S.~A. "} +MACRO {pnac} {"Proc.\ Natl.\ Acad.\ Sci.\ U.S.A."} MACRO {bba} {"Biochim.\ Biophys.\ Acta"} MACRO {nar} {"Nucleic.\ Acid Res."} @@ -1495,6 +1612,22 @@ FUNCTION {end.bib} EXECUTE {end.bib} %</bib> +%<*database> +@BOOK{Coghill2006, + title = {{T}he {ACS} {S}tyle {G}uide}, + publisher = {{O}xford {U}niversity {P}ress, {I}nc. and + {T}he {A}merican {C}hemical {S}ociety}, + year = {2006}, + editor = {Coghill, Anne M. and Garson, Lorrin R.}, + address = {{N}ew {Y}ork}, + edition = {3}, + subtitle = {{E}ffective {C}ommunication of {S}cientific {I}nformation}, +} + +@MISC{ACS2007, + note = {\url{http://pubs.acs.org/books/references.shtml}}, +} +%</database> % \fi % \Finale diff --git a/Master/texmf-dist/source/latex/achemso/achemso.ins b/Master/texmf-dist/source/latex/achemso/achemso.ins index 3bf7963a57e..4aea77ef341 100644 --- a/Master/texmf-dist/source/latex/achemso/achemso.ins +++ b/Master/texmf-dist/source/latex/achemso/achemso.ins @@ -29,5 +29,7 @@ Released under the LaTeX Project Public license v1.3 or later \file{achemso.bst}{\from{achemso.dtx}{bib}} \file{achemsol.bst}{\from{achemso.dtx}{bib,list}} } - +\generate{\usepostamble\empty\usepreamble\empty + \file{achemso.bib}{\from{achemso.dtx}{database}} +} \endbatchfile |