summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/chemstyle/chemstyle.dtx
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-07-05 19:04:42 +0000
committerKarl Berry <karl@freefriends.org>2013-07-05 19:04:42 +0000
commitdde0e3b32c9054caf6e79a9eb6a337a3c097aa47 (patch)
tree6ae213c3ea9b838b6e26e5e936cbaed966c06bfa /Master/texmf-dist/source/latex/chemstyle/chemstyle.dtx
parente54eda8832ef70dfae37d4200bd56bd2dee6118e (diff)
chemstyle (4jul13)
git-svn-id: svn://tug.org/texlive/trunk@31096 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/chemstyle/chemstyle.dtx')
-rw-r--r--Master/texmf-dist/source/latex/chemstyle/chemstyle.dtx125
1 files changed, 76 insertions, 49 deletions
diff --git a/Master/texmf-dist/source/latex/chemstyle/chemstyle.dtx b/Master/texmf-dist/source/latex/chemstyle/chemstyle.dtx
index 57e6125b610..db67d49a9c2 100644
--- a/Master/texmf-dist/source/latex/chemstyle/chemstyle.dtx
+++ b/Master/texmf-dist/source/latex/chemstyle/chemstyle.dtx
@@ -1,32 +1,52 @@
% \iffalse meta-comment
-% !TEX program = pdflatex
%<*internal>
\iffalse
%</internal>
%<*readme>
-----------------------------------------------------------------
-The chemstyle bundle --- Schemes and style for chemistry
-E-mail: joseph.wright@morningstar2.co.uk
-Released under the LaTeX Project Public License v1.3c or later
-See http://www.latex-project.org/lppl.txt
-----------------------------------------------------------------
+The chemstyle bundle - Schemes and style for chemistry
+======================================================
-The chemstyle bundle provides two packages: chemstyle and
-chemscheme. Both are intended to help chemists create floating
+The `chemstyle` bundle provides two packages: `chemstyle` and
+`chemscheme`. Both are intended to help chemists create floating
graphics and match published styles.
-The chemscheme package consists of two parts, both related to
-chemical schemes. The package adds a scheme float type to the
-LaTeX default types figure and table. The scheme float type
+The `chemscheme` package consists of two parts, both related to
+chemical schemes. The package adds a `scheme` float type to the
+LaTeX default types figure and table. The `scheme` float type
acts in the same way as those defined by the LaTeX kernel, but
is intended for chemical schemes. The package also provides a
method for adding automatic chemical numbering to schemes.
-The chemstyle package provides a "one-stop shop" for setting up
+The `chemstyle` package provides a "one-stop shop" for setting up
formatting of LaTeX documents following the editorial policies
of various chemical journals. It provides a number of handy
chemistry-related commands, and loads several support packages
to aid the chemist.
+
+Installation
+------------
+
+The package is supplied in `.dtx` format and as a pre-extracted
+`.zip` file, `chemstyle.tds.zip`. The later is most convenient
+for most users: simply unzip this in your local `texmf`
+directory. If you want to unpack the `.dtx` yourself, running
+`tex chemstyle.dtx` will extract the package whereas `latex
+chemstyle.dtx` will extract it and also typeset the
+documentation.
+
+Typesetting the documentation requires a number of packages in
+addition to those needed to use the package. This is mainly
+because of the number of demonstration items included in the
+text. To compile the documentation without error, you will
+need the packages:
+ - `booktabs`
+ - `csquotes`
+ - `helvet`
+ - `mathpazo`
+ - `mhchem`
+ - `microtype`
+ - `listings`
+ - `lmodern`
%</readme>
%<*internal>
\fi
@@ -50,7 +70,7 @@ See http://www.latex-project.org/lppl.txt
\endpreamble
\postamble
-Copyright (C) 2006-2011 by
+Copyright (C) 2006-2011,2013 by
Joseph Wright <joseph.wright@morningstar2.co.uk>
It may be distributed and/or modified under the conditions of
@@ -114,7 +134,7 @@ This work consists of the file chemstyle.dtx and
%<*driver>
\documentclass[a4paper]{ltxdoc}
\usepackage[T1]{fontenc}
-\usepackage{array,booktabs,chemstyle,lmodern}
+\usepackage{array,booktabs,chemstyle,csquotes,lmodern}
\usepackage[scaled=0.95]{helvet}
\usepackage[final]{listings,microtype}
\usepackage[osf]{mathpazo}
@@ -319,7 +339,7 @@ This work consists of the file chemstyle.dtx and
% for chemical schemes. The package also provides a method for adding
% automatic chemical numbering to schemes.
%
-% The \textsf{chemstyle} package provides a ``one-stop shop'' for
+% The \textsf{chemstyle} package provides a \enquote{one-stop shop} for
% setting up formatting of \LaTeX\ documents following the editorial
% policies of various chemical journals. It provides a number of handy
% chemistry-related commands, and loads several support packages to aid
@@ -368,7 +388,7 @@ This work consists of the file chemstyle.dtx and
% (pdf)\TeX\ on \file{chemstyle.dtx}. This will produce all of the
% package files, and also \file{README.txt}. To extract the
% files and build the documentation, run (pdf)\LaTeX\ on
-% \texttt{chemstyle.dtx}: you will need to enable ``write18'' if
+% \texttt{chemstyle.dtx}: you will need to enable \enquote{write18} if
% you compile in PDF mode.
%
%\section{Requirements}
@@ -447,13 +467,13 @@ This work consists of the file chemstyle.dtx and
% \pkg{chemstyle} alters the naming of the references section of a
% document. By default, \pkg{chemstyle} alters the value of \cs{bibname}
% or \cs{refname} (as appropriate) to the form of words chosen by the
-% target journal for the ``References'' section.
+% target journal for the \enquote{References} section.
%
-% The ``\refname'' naming commands are language-aware, \emph{via} the
+% The \enquote{\refname} naming commands are language-aware, \emph{via} the
% \pkg{babel} interface. Currently, \pkg{chemstyle} includes appropriate
-% labels for \pkg{babel} languages \opt{english}, \opt{german} and
-% \opt{french}. Other languages can be added if appropriate wordings are
-% provided to the author. The naming system is designed to work
+% labels for \pkg{babel} languages \opt{english}, \opt{german},
+% \opt{french} and \opt{italian}. Other languages can be added if appropriate
+% wordings are provided to the author. The naming system is designed to work
% correctly with both \pkg{natbib} and \pkg{biblatex}.
%
%\DescribeOption{notes}
@@ -462,15 +482,15 @@ This work consists of the file chemstyle.dtx and
% The package recognises the \opt{notes} option for controlling how
% the references section is named. The accepts the values
% \opt{true}, \opt{false} and \opt{auto}. The Boolean values either
-% enable or disable the addition of ``Notes and'' to the
-% ``References'' of the section title. The \opt{auto} option works
+% enable or disable the addition of \enquote{Notes and} to the
+% \enquote{References} of the section title. The \opt{auto} option works
% in conjunction with the \pkg{notes2bib} package. If notes are
-% added, ``Notes and'' is included in the section title, whereas if
-% no notes are given the section title remains as ``References''.
+% added, \enquote{Notes and} is included in the section title, whereas if
+% no notes are given the section title remains as \enquote{References}.
% The \opt{nonotes} option is equivalent to \opt{notes=false}.
% The second option for this area is \opt{notesbefore}. This takes
-% \opt{true} and \opt{false} only, and sets whether ``Notes and
-% References'' or ``References and Notes'' is produced.
+% \opt{true} and \opt{false} only, and sets whether \enquote{Notes and
+% References} or \enquote{References and Notes} is produced.
%
%\subsection{Additional units}
%
@@ -542,10 +562,10 @@ This work consists of the file chemstyle.dtx and
%\end{LaTeXdemo}
%
%\DescribeOption{abbrcomma}
-% For American journals, where it is obligatory to follow ``\eg'' and
-% ``\ie'' with a comma, the package provides a mechanism for handling
+% For American journals, where it is obligatory to follow \enquote{\eg} and
+% \enquote{\ie} with a comma, the package provides a mechanism for handling
% this automatically. Thus, when using an appropriate journal style,
-% |\eg|, |\eg.| and |\eg,| will all result in typesetting ``\eg,''.
+% |\eg|, |\eg.| and |\eg,| will all result in typesetting \enquote{\eg,}.
% The Boolean package option \opt{abbrcomma} controls this.
%\begin{LaTeXdemo}
% \eg this\\
@@ -717,9 +737,9 @@ This work consists of the file chemstyle.dtx and
% popular chemistry drawing package, \textsc{ChemDraw}, is able to do
% this from the \texttt{Save As \ldots} dialogue. The positions where
% the auto-labels should be have to be marked in the EPS file. The
-% marker should consist of an ``indicator'' that the text is to be
+% marker should consist of an \enquote{indicator} that the text is to be
% replaced, followed by a reference number or letter. For automated
-% substitution, the ``indicator'' text should be the same in all
+% substitution, the \enquote{indicator} text should be the same in all
% graphics.
%
%\DescribeMacro{\schemeref}
@@ -768,7 +788,7 @@ This work consists of the file chemstyle.dtx and
% obtain good alignment of labels and structures.
%
%\DescribeMacro{\schemerefmarker}
-% When using automatic substitution mode, the ``marker'' text to be
+% When using automatic substitution mode, the \enquote{marker} text to be
% searched for is stored as \cs{schemerefmarker}, which has
% default value \texttt{\schemerefmarker}. Thus the graphics should
% contain labels \textsf{\schemerefmarker1}, \textsf{\schemerefmarker2},
@@ -815,7 +835,7 @@ This work consists of the file chemstyle.dtx and
%\DescribeMacro{\floatcontentsleft}
%\DescribeMacro{\floatcontentsright}
% The \LaTeX\ default is to position all float contents flush-left.
-% There is no ``hook'' provided to alter this. The \pkg{chemscheme}
+% There is no \enquote{hook} provided to alter this. The \pkg{chemscheme}
% package therefore provides commands to align all float contents
% automatically. As the macro names make clear,
% \cs{floatcontentscentre} will make all floats centred (for users
@@ -878,7 +898,7 @@ This work consists of the file chemstyle.dtx and
% other hand, the ppch\TeX\ system, developed originally for
% Con\TeX{}t, is available. Both systems suffer from the lack of
% chemical logic in the input: it is very hard to tell from the code
-% what is being represented. Drawing items such as ``curly arrows'',
+% what is being represented. Drawing items such as \enquote{curly arrows},
% or making subtle alterations to positioning, is very challenging in
% purely macro-based systems. For these reasons, it is usually much
% more sensible to examine the available graphical methods.
@@ -898,7 +918,7 @@ This work consists of the file chemstyle.dtx and
% abilities of dedicated software become a necessity. As well as the
% already-mentioned \textsc{ChemDraw}, programs such as \textsc{ISIS
% Draw} and \textsc{ChemSketch} are available free for personal
-% use;\footnote{``Free'' as in without charge, not as in open
+% use;\footnote{\enquote{Free} as in without charge, not as in open
% source.} these programs are all Windows specific. In the
% open-source arena, there are a number of packages such as
% \textsc{XDrawChem} and \textsc{BKchem}, which offer cross-platform
@@ -995,7 +1015,7 @@ This work consists of the file chemstyle.dtx and
% \begin{macrocode}
%<*package>
\ProvidesPackage{chemstyle}
- [2011/01/28 v2.0l Schemes and style for chemistry]
+ [2013/07/03 v2.0m Schemes and style for chemistry]
\RequirePackage{amstext,caption,chemscheme,xspace}
\SetupKeyvalOptions{
family=cst,
@@ -1238,7 +1258,7 @@ This work consists of the file chemstyle.dtx and
%\begin{macro}{\standardstate}
%\begin{macro}{\cst@standardstate}
%\begin{macro}{\cst@standardstate@aux}
-% The ``standard state'' symbol is handy. This definition is adapted
+% The \enquote{standard state} symbol is handy. This definition is adapted
% from one posted several times to \texttt{comp.text.tex} by Donald
% Arseneau.
% \begin{macrocode}
@@ -1550,6 +1570,7 @@ This work consists of the file chemstyle.dtx and
%\end{macro}
%
%\begin{macro}{\cst@refsec@lang}
+% \changes{v2.0m}{2013/07/03}{Add phrase translations for Italian}
%\begin{macro}{\cst@refsec@lang@clist}
%\begin{macro}{\cst@refsec@lang@define}
% The language-dependent definitions are created.
@@ -1575,6 +1596,7 @@ This work consists of the file chemstyle.dtx and
\cst@refsec@lang@define{german}{Literatur}{und}{Notizen}
\cst@refsec@lang@define{french}{R\'ef\'erences}{et}{Notes}
\cst@refsec@lang@define{frenchb}{R\'ef\'erences}{et}{Notes}
+\cst@refsec@lang@define{italian}{Bibliografia}{e}{Note}
% \end{macrocode}
%\end{macro}
%\end{macro}
@@ -1793,7 +1815,7 @@ This work consists of the file chemstyle.dtx and
% \begin{macrocode}
%<*chemscheme>
\ProvidesPackage{chemscheme}
- [2011/01/28 v2.0l Schemes for chemistry]
+ [2013/07/03 v2.0m Schemes for chemistry]
\RequirePackage{kvoptions,psfrag}
\SetupKeyvalOptions{
family=cst,
@@ -1994,7 +2016,7 @@ This work consists of the file chemstyle.dtx and
%
%\begin{macro}{\cst@float@make@float}
% When using \pkg{float}, definition depends on the existence of
-% chapters. The name and ``list of'' macros are then created separately.
+% chapters. The name and \enquote{list of} macros are then created separately.
% \begin{macrocode}
\newcommand*\cst@float@make@float{%
\begingroup\expandafter\expandafter\expandafter\endgroup
@@ -2124,6 +2146,7 @@ This work consists of the file chemstyle.dtx and
%
%\changes{v2.0j}{2010/11/04}{Include \texttt{ngerman} in \pkg{babel}
% support}
+% \changes{v2.0m}{2013/07/03}{Add phrase translations for Italian}
% Some simple label changes.
% \begin{macrocode}
\AtBeginDocument{%
@@ -2140,6 +2163,10 @@ This work consists of the file chemstyle.dtx and
\def\listschemename{Schemenverzeichnis}%
\def\schemename{Schema}%
}%
+ \addto{\captionsitalian}{%
+ \def\listschemename{Lista degli schemi}%
+ \def\schemename{Schema}%
+ }%
\expandafter\selectlanguage\expandafter{\languagename}%
}{}%
}
@@ -2316,7 +2343,7 @@ This work consists of the file chemstyle.dtx and
% \begin{macrocode}
%<*angew>
\ProvidesFile{angew.chemstyle.cfg}
- [2011/01/28 v2.0l Angew. Chem. journal style]
+ [2013/07/03 v2.0m Angew. Chem. journal style]
\setkeys{cst}{
abbremph = false,
radhyphen = false
@@ -2338,7 +2365,7 @@ This work consists of the file chemstyle.dtx and
% \begin{macrocode}
%<*ic>
\ProvidesFile{ic.chemstyle.cfg}
- [2011/01/28 v2.0l Inorg. Chem. journal style]
+ [2013/07/03 v2.0m Inorg. Chem. journal style]
\DeclareCaptionLabelSeparator{perquad}{.\quad}
\captionsetup{
labelfont = {bf,it,sf},
@@ -2373,7 +2400,7 @@ This work consists of the file chemstyle.dtx and
% \begin{macrocode}
%<*jacs>
\ProvidesFile{jacs.chemstyle.cfg}
- [2011/01/28 v2.0l J. Am. Chem. Soc. journal style]
+ [2013/07/03 v2.0m J. Am. Chem. Soc. journal style]
\DeclareCaptionLabelSeparator{perquad}{.\quad}
\captionsetup{
labelfont = {bf,it,sf},
@@ -2406,7 +2433,7 @@ This work consists of the file chemstyle.dtx and
% \begin{macrocode}
%<*jomc>
\ProvidesFile{jomc.chemstyle.cfg}
- [2011/01/28 v2.0l J. Organomet. Chem. journal style]
+ [2013/07/03 v2.0m J. Organomet. Chem. journal style]
\setkeys{cst}{
abbremph = false,
radhyphen = true,
@@ -2430,7 +2457,7 @@ This work consists of the file chemstyle.dtx and
% \begin{macrocode}
%<*jpc>
\ProvidesFile{jpc.chemstyle.cfg}
- [2011/01/28 v2.0l J. Phys. Chem. journal style]
+ [2013/07/03 v2.0m J. Phys. Chem. journal style]
\DeclareCaptionFormat{labelcaps}{\MakeUppercase{#1}#2#3}
\captionsetup{
font = bf,
@@ -2464,7 +2491,7 @@ This work consists of the file chemstyle.dtx and
% \begin{macrocode}
%<*orglett>
\ProvidesFile{orglett.chemstyle.cfg}
- [2011/01/28 v2.0l Org. Lett. journal style]
+ [2013/07/03 v2.0m Org. Lett. journal style]
\DeclareCaptionLabelSeparator{perquad}{.\quad}
\captionsetup{
labelfont = bf,
@@ -2588,7 +2615,7 @@ This work consists of the file chemstyle.dtx and
% \begin{macrocode}
%<*rsc>
\ProvidesFile{rsc.chemstyle.cfg}
- [2011/01/28 v2.0l RSC journal style]
+ [2013/07/03 v2.0m RSC journal style]
\captionsetup{
labelsep = quad,
labelfont = bf
@@ -2604,7 +2631,7 @@ This work consists of the file chemstyle.dtx and
% \begin{macrocode}
%<*tetlett>
\ProvidesFile{tetlett.chemstyle.cfg}
- [2011/01/28 v2.0l Tetrahedron Lett. journal style]
+ [2013/07/03 v2.0m Tetrahedron Lett. journal style]
\captionsetup{
labelsep = period,
labelfont = bf,