From 491687da836539cd84a4754b1b7cb5e1f8398a63 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 15 Dec 2013 23:01:51 +0000 Subject: chemmacros (15dec13) git-svn-id: svn://tug.org/texlive/trunk@32422 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/chemmacros/README | 6 +- .../doc/latex/chemmacros/chemmacros_en.pdf | Bin 890876 -> 896070 bytes .../doc/latex/chemmacros/chemmacros_en.tex | 75 +++++++++++++++++++-- 3 files changed, 72 insertions(+), 9 deletions(-) (limited to 'Master/texmf-dist/doc/latex/chemmacros') 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 Binary files a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.pdf and b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.pdf 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) -- cgit v1.2.3