summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/chemmacros
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-12-15 23:01:51 +0000
committerKarl Berry <karl@freefriends.org>2013-12-15 23:01:51 +0000
commit491687da836539cd84a4754b1b7cb5e1f8398a63 (patch)
treee23e5f0c1f4855862c761682567b9f7df1a4b022 /Master/texmf-dist/doc/latex/chemmacros
parentb156cde1780f6df554a080befab5b52305c44081 (diff)
chemmacros (15dec13)
git-svn-id: svn://tug.org/texlive/trunk@32422 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/chemmacros')
-rw-r--r--Master/texmf-dist/doc/latex/chemmacros/README6
-rw-r--r--Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.pdfbin890876 -> 896070 bytes
-rw-r--r--Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex75
3 files changed, 72 insertions, 9 deletions
diff --git a/Master/texmf-dist/doc/latex/chemmacros/README b/Master/texmf-dist/doc/latex/chemmacros/README
index 10888343fe7..bac46d36bbc 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/README
+++ b/Master/texmf-dist/doc/latex/chemmacros/README
@@ -1,8 +1,8 @@
--------------------------------------------------------------------------
-the CHEMMACROS bundle 2013/11/20
- - chemmacros package v4.2c -> macros and commands for chemists
+the CHEMMACROS bundle 2013/12/15
+ - chemmacros package v4.2d -> macros and commands for chemists
- chemformula package v4.2a -> typeset chemical compounds and reactions
- - ghsystem package v4.0 -> typeset H & P statements and pictograms
+ - ghsystem package v4.0a -> typeset H & P statements and pictograms
from the globally harmonised system (GHS)
- chemgreek package v0.2a -> handle mapping of upright greek letters to
the \chemalpha ... commands
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.pdf b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.pdf
index ff0a00ba78e..b05e91e2971 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.pdf
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
index d6f3e10db95..5efeebbfd6f 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
@@ -507,7 +507,19 @@ of \ghsystem's options belong to the module \module{ghsystem}.
\section{Language Settings}\label{sec:languages}
-\subsection{Supported Languages}
+\subsection{How it Works}
+\chemmacros\ uses the \pkg{translations} package for a number of language
+dependent strings. That means that if a suitable translation to those strings
+is given the \pkg{babel}~\cite{pkg:babel} or
+\pkg{polyglossia}~\cite{pkg:polyglossia} language will be picked up
+automatically. You can, however, overwrite this mechanism by explicitly
+chosing the language you want. This is done with the package option
+\option{language}.
+
+Section~\ref{sec:supported-languages} lists all language dependent strings and
+the provided translations.
+
+\subsection{Supported Languages}\label{sec:supported-languages}
By choosing the option
\begin{commands}
\command{chemsetup}[\oarg{option}\Marg{language=\meta{language}}]
@@ -523,7 +535,37 @@ There are some language definitions made by \chemmacros. They include
\item the H- and P-statements of the \ac{ghs} statements.
\end{itemize}
-Currently the following translations are provided:
+\chemmacros\ uses the \pkg{translations} to get translated strings sensitive
+to \pkg{babel} or \pkg{polyglossia} settings. All pre-defined
+\pkg{translations} keys are listed in
+table~\ref{tab:language-dependent-strings}. To some of those a few
+non-English translations are provided.
+
+\begin{table}
+ \centering
+ \caption{Language dependent strings.}
+ \label{tab:language-dependent-strings}
+ \begin{tabular}{>{\ttfamily}ll}
+ \toprule
+ \normalfont\bfseries \pkg{translations} key &
+ \bfseries English default \\
+ \midrule
+ K-acid & \GetTranslation{K-acid} \\
+ K-base & \GetTranslation{K-base} \\
+ K-water & \GetTranslation{K-water} \\
+ \midrule
+ phase-sld & \GetTranslation{phase-lqd} \\
+ phase-lqd & \GetTranslation{phase-sld} \\
+ phase-gas & \GetTranslation{phase-gas} \\
+ phase-aq & \GetTranslation{phase-aq} \\
+ \midrule
+ list-of-reactions & \GetTranslation{list-of-reactions} \\
+ reaction & \GetTranslation{lor-reaction} \\
+ \bottomrule
+ \end{tabular}
+\end{table}
+
+Currently this includes the following translations:
\begin{sourcecode}
% subscript used in \Ka:
\DeclareTranslation{German}{K-acid}{S}
@@ -536,10 +578,10 @@ Currently the following translations are provided:
\DeclareTranslation{Italian}{list-of-reactions}{Elenco delle reazioni}
\DeclareTranslation{French} {list-of-reactions}{Table des r\'eactions}
% name at the beginning of each entry in the list of reactions:
- \DeclareTranslation{English}{lor-reaction}{Reaction }
- \DeclareTranslation{German} {lor-reaction}{Reaktion }
- \DeclareTranslation{Italian}{lor-reaction}{Reazione }
- \DeclareTranslation{French} {lor-reaction}{R\'eaction }
+ \DeclareTranslation{English}{reaction}{Reaction}
+ \DeclareTranslation{German} {reaction}{Reaktion}
+ \DeclareTranslation{Italian}{reaction}{Reazione}
+ \DeclareTranslation{French} {reaction}{R\'eaction}
\end{sourcecode}
All other languages will fall back to English. However, you can always add
the translation you want. If you send me an email with translations you'd
@@ -1024,6 +1066,12 @@ There is one option which changes the style the \p{} is typeset:
\begin{options}
\keychoice{p-style}{italics,slanted,upright}\Module{acid-base}\Default{upright}
Set the style of the \p{} operator.
+ \keyval{K-acid}{text}\Module{acid-base}
+ The subscript to \cs{Ka} and \cs{pKa}.
+ \keyval{K-base}{text}\Module{acid-base}
+ The subscript to \cs{Kb} and \cs{pKb}.
+ \keyval{K-water}{text}\Module{acid-base}
+ The subscript to \cs{Kw}.
\end{options}
\begin{example}
\pH, \pKa \par
@@ -1031,6 +1079,21 @@ There is one option which changes the style the \p{} is typeset:
\chemsetup[acid-base]{p-style=italics} \pH, \pKa
\end{example}
+As\sinceversion{4.2d} you can see the default subscripts of \cs{Kw}, \cs{Ka}
+and \cs{Kb} are uppercase letters. The literature is inconclusive about if
+this is the right way or if lowercase letters should be preferred. In
+textbooks the uppercase variant usually seems to be used while journals seem
+to prefer the lowercase variant. Since I like the uppercase version better
+this is the default. If you want to change this you have two possibilities:
+
+\begin{example}
+ % this works only in the preamble:
+ % \DeclareTranslation{English}{K-acid}{a}% use your language here
+ % alternative:
+ \chemsetup{acid-base/K-acid=a}% overwrites language dependent settings
+ \pKa
+\end{example}
+
\section{Oxidation Numbers, Real and Formal Charges}\label{sec:ladungen}
\chemmacros\ distinguishes between real ($+$/$-$) and formal (\fplus/\fminus)