summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-08-24 22:39:08 +0000
committerKarl Berry <karl@freefriends.org>2013-08-24 22:39:08 +0000
commitc85fa36270547458332b4c790354729c2f3f3c9a (patch)
treecf1202280b0358de3a3b820b5782f1f4f7197511 /Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
parent8f202738ce363c80b55b8a2a9496340292a4b200 (diff)
chemmacros (24aug13)
git-svn-id: svn://tug.org/texlive/trunk@31513 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex')
-rw-r--r--Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex111
1 files changed, 57 insertions, 54 deletions
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
index 7f924875d57..ae8c16ccbc9 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
@@ -1,7 +1,7 @@
% arara: xelatex
% !arara: biber
-% !arara: xelatex
-% !arara: xelatex
+% arara: xelatex
+% arara: xelatex
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% -----------------------------------------------------------------------------
% - the CHEMMACROS bundle
@@ -97,6 +97,12 @@
pdfstring = EU ,
accsupp = EU
}
+\DeclareAcronym{id}{
+ short = id ,
+ long = identification string ,
+ pdfstring = ID ,
+ accsupp = ID
+}
\DeclareAcronym{iupac}{
short = iupac ,
long = International Union of Pure and Applied Chemistry ,
@@ -113,7 +119,7 @@
short = dvi ,
long = device independent file format ,
pdfstring = DVI ,
- accsupp = DVO
+ accsupp = DVI
}
\DeclareAcronym{pdf}{
short = pdf ,
@@ -156,6 +162,16 @@
\usepackage[backend=biber,style=alphabetic,maxbibnames=20]{biblatex}
\addbibresource{\jobname.bib}
\begin{filecontents*}{\jobname.bib}
+@book{iupac:bluebook,
+ author = {R. Panico and W. H. Powell and J-C. Richer},
+ title = {“Nomenclature of Organic Chemistry, Sections A, B, C, D, E, F, and H”, \acs{iupac}
+ Blue Book},
+ edition = {\mkbibacro{DRAFT}},
+ date = {2004-10-07},
+ url =
+ {http://old.iupac.org/reports/provisional/abstract04/BB-prs310305/CompleteDraft.pdf},
+ urldate = {2013-07-07}
+}
@book{iupac:greenbook,
author = {E. Richard Cohan and Tomislav Cvita\v{s} and Jeremy G. Frey and
Bertil Holmström and Kozo Kuchitsu and Roberto Marquardt and Ian Mills and
@@ -264,7 +280,7 @@
includegraphics, insitu, intertext, invacuo, iupac, IUPAC,
J, joule,
Ka, Kb, kilo, Kw,
- L, latin, lewis, Lewis, Lfi, listofreactions, lqd, ltn,
+ L, latin, lc, lewis, Lewis, Lfi, listofreactions, lqd, ltn,
mch, mega, meta, metre, mhName, midrule, milli, mmHg, mole,
N, nano, nicefrac, newman, NMR, Nu, Nuc, num, numrange,
O, ominus, orbital, ortho, oplus, ox, OX,
@@ -322,52 +338,9 @@
}
\providecommand*\chemgreek{{\scshape\textcolor{main}{chemgreek}}\xspace}
-\newcommand*\Default[1]{%
- \hfill\llap{%
- \ifblank{#1}
- {(initially~empty)}
- {Default:~\code{#1}}%
- }\newline
-}
-
-\usepackage{marginnote,ragged2e}
-\makeatletter
-\providecommand*\sinceversion[1]{%
- \@bsphack
- \marginnote{%
- \footnotesize\sffamily\RaggedRight
- \textcolor{black!75}{Introduced in version~#1}}%
- \@esphack}
-\providecommand*\changedversion[1]{%
- \@bsphack
- \marginnote{%
- \footnotesize\sffamily\RaggedRight
- \textcolor{black!75}{Changed in version~#1}}%
- \@esphack}
-
-\RenewDocumentCommand\CTANurl{O{macros/latex/contrib}m}
- {%
- on CTAN: %
- \hyper@linkurl{#2}{http://mirrors.ctan.org/#1/#2/}%
- }
-\ExplSyntaxOn
-\RenewDocumentCommand \paket { sO{macros/latex/contrib}m }
- {
- \paketfont { #3 }
- \index { #3 @ \paketfont { #3 } }
- \prop_if_in:NnF \g_cnpkgdoc_pakete_prop { #3 }
- {
- \prop_gput:Nnn \g_cnpkgdoc_pakete_prop { #3 } {}
- \IfBooleanF { #1 }
- { \footnote { \CTANurl[]{#3} } }
- }
- }
-\ExplSyntaxOff
-\makeatother
-
\DeclareChemPhase{\aqi}{aq,$\infty$}% aqueous solution at infinite dilution
\DeclareChemPhase{\cd}{cd}% condensed phase
-\RenewChemPhase{\lqd}{lc}% liquid crystal
+\DeclareChemPhase{\lc}{lc}% liquid crystal
\begin{document}
@@ -383,7 +356,7 @@ The \chemmacros\ bundle needs the bundles \paket{l3kernel} and
\paket{mathtools}, \paket{bm}, \paket{nicefrac} and \paket{environ} as well as
\paket*{tikz}\footnote{\CTANurl[graphics]{pgf}} and the \TikZ libraries
\code{calc} and \code{arrows}. Language support is done with the help of the
-\paket*{translations} package from the \paket{exsheets} bundle. The
+\paket{translations} package from the \paket{exsheets} bundle. The
\chemmacros\ package also loads the other packages of this bundle.
The package option \key{xspace} also loads the package \paket{xspace}.
@@ -433,7 +406,7 @@ There are four points I hope I have achieved with this bundle:
\item the commands shall not only make typesetting easier and faster but also
the document source more readable with respect to semantics
(\code{\cmd{ortho}-dichlorobenzene} is easier to read and understand than
- \code{\cmd*{textsl}{o}-dichlorobenzene})
+ \code{\cmd*{textit}{o}-dichlorobenzene})
\item as much customizability as I could think of so every user can adapt the
commands to his or her own wishes
\item default settings compliant with the recommendations of the \acf{iupac}.
@@ -905,6 +878,15 @@ in the default setting.
\Befehl{para} \para
\end{beschreibung}
+Although these commands are provided I like to cite~\cite{iupac:bluebook}:
+
+\begin{zitat}[{\acs{iupac} Blue Book {\cite[][p.\,90]{iupac:bluebook}}}]
+ The letters \ortho, \meta, and \para\ have been used in place of
+ \textit{ortho}, \textit{meta}, and \textit{para}, respectively, to designate
+ the 1,2- 1,3-, and 1,4- isomers of disubstituted benzene. This usage is
+ strongly discouraged and is not used in preferred \acs{iupac} names.
+\end{zitat}
+
\paragraph{Absolute Configuration}\index{absolute configuration} (uses \TikZ)
\begin{beschreibung}
\Befehl{Rconf}[<letter>] \cmd{Rconf}: \Rconf \quad\cmd{Rconf}[]: \Rconf[]
@@ -1039,7 +1021,8 @@ By the way: \cmd*{mmHg} \si{\mmHg} already is defined by \paket{siunitx} and
\section{Acid/Base}\label{sec:saeure_base}\secidx{Acid/Base}
Easy representation of \pH, \pKa \ldots\ (the command \cmd{pKa} depends on the
-package option \key[option]{language}).
+package option \key[option]{language}). The translations may be adapted,
+though, see section~\ref{sec:languages}.
\begin{beschreibung}
\Befehl{pH} \pH
\Befehl{pOH} \pOH
@@ -2103,11 +2086,31 @@ declaration commands of \chemmacros\ \cmd{DeclareChemPhase} and
% preamble:
% \DeclareChemPhase{\aqi}{aq,$\infty$}% aqueous solution at infinite dilution
% \DeclareChemPhase{\cd}{cd}% condensed phase
- % \RenewChemPhase{\lqd}{lc}% liquid crystal
- NaOH\aqi\ \ch{H2O\cd} U\phase{cr} A\lqd \\
+ % \DeclareChemPhase{\lc}{lc}% liquid crystal
+ NaOH\aqi\ \ch{H2O\cd} U\phase{cr} A\lc \\
\chemsetup[phases]{pos=sub}
- NaOH\aqi\ \ch{H2O\cd} U\phase{cr} A\lqd
+ NaOH\aqi\ \ch{H2O\cd} U\phase{cr} A\lc
+\end{beispiel}
+
+\subsection{Language Dependencies}\secidx[internationalization]{Phases}
+For each pahse command a translation into the custom language can be defined.
+If a phase is declared with \cmd{DeclareChemPhase} no translation exists and
+for every \paket{babel} languuage the literal string is used that was provided
+as a definition. Let's say you define the phase
+\begin{beispiel}[code only]
+ \DeclareChemPhase\liquid{l}
\end{beispiel}
+and want to add the German translation ``f{}l''. Then you could do
+\begin{beispiel}[code only]
+ \DeclareTranslation{German}{phase-liquid}{f{}l}
+\end{beispiel}
+This way, when you use it in a German document using the appropriate
+\paket{babel} option using \cmd*{liquid} would correctly translate. For this
+the package \paket{translations} is used. The \acs{id} always is
+\code{phase-<csname>} where \code{<csname>} is the name of the phase command
+you defined without leading backslash.
+
+See section~\ref{sec:languages} for predefined translations.
\secidx*{Phases}
\section{Newman Projections}\label{sec:newman}\secidx{Newman Projections}