diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex | 68 |
1 files changed, 51 insertions, 17 deletions
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex index 447fa1b652f..b32946b52e8 100644 --- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex +++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex @@ -5,7 +5,7 @@ % - macros and commands for chemists % ----------------------------------------------------------------------------- % - Clemens Niederberger -% - 2012/05/07 +% - 2012/05/13 % ----------------------------------------------------------------------------- % - https://bitbucket.org/cgnieder/chemmacros/ % - contact@mychemistry.eu @@ -57,7 +57,7 @@ \colorlet{chemformula}{darkgray} \begin{filecontents}{index_en.ist} - preamble "\\begin{theindex}\n Section titles are indicated \\textbf{bold}, packages \\textsf{sans serif}, commands \\textcolor{code}{\\code{\\textbackslash brown}}, keys \\textcolor{key}{\\code{green}} and modules (only \\chemmacros) \\textcolor{module}{\\code{red}}.\\newline\n\n" + preamble "\\begin{theindex}\n Section titles are indicated \\textbf{bold}, packages \\textsf{sans serif}, commands \\code{\\textbackslash\\textcolor{code}{brown}}, options \\textcolor{key}{\\code{green}} and modules (only \\chemmacros) \\textcolor{module}{\\code{red}}.\\newline\n\n" heading_prefix "{\\bfseries " heading_suffix "\\hfil}\\nopagebreak\n" headings_flag 1 @@ -79,6 +79,13 @@ year = {2008}, publisher = {\IUPAC \&\ RSC Publishing, Cambridge} } +@book{iupac:redbook, + author = {Neil G. Connelly and Ture Damhus and Richard M. Hartshorn and Alan T. Hutton}, + title = {“Nomenclature of Inorganic Chemistry”, \IUPAC Red Book}, + year = {2005}, + publisher = { \IUPAC \&\ RSC Publishing, Cambridge}, + isbn = {0-85404-438-8} +} @misc{eu:ghsystem_regulation, author = {{The European Parliament and The Council of the European Union}}, title = {Regulation (EC) No 1272/2008 of the European Parliament and of the Council}, @@ -122,13 +129,13 @@ \redox(r1,r2)[blue,-cf][-1]{\small\ch[font-spec={[Color=blue]Augie},math-space=.3em]{$+$ 2 e-}}} \addcmds{ - a,abinitio,AddRxnDesc,aq,aqi,b,ba,bottomrule,cancel,cd,cdot,ce,cee,celsius, + a,abinitio,AddRxnDesc,anti,aq,aqi,b,ba,bottomrule,bridge,cancel,cd,cdot,ce,cee,celsius, centering,chemabove,Chemalpha,Chembeta,Chemgamma,Chemdelta,ChemDelta,chemfig, chemname,Chemomega,chemsetup,cip,cis,ch,cnsetup,CNMR,color,cstsetup,d,D,data, DeclareChemArrow,DeclareChemIUPAC,DeclareChemLatin,DeclareChemNMR, DeclareChemParticle,DeclareChemPhase,DeclareChemReaction,DeclareChemState, DeclareInstance,DeclareSIUnit,definecolor,delm,delp,Delta,Dfi,draw,E,el, - electronvolt,ElPot,Enthalpy,enthalpy,Entropy,footnotesize,fmch,fpch,fscrm, + electronvolt,ElPot,endo,Enthalpy,enthalpy,Entropy,footnotesize,fmch,fpch,fscrm, fscrp,g,gas,ghs,ghslistall,ghspic,Gibbs,glqq,gram,grqq,H,hapto,HNMR,Helmholtz, hertz,hspace,includegraphics,insitu,intertext,invacuo,iupac,IUPAC,J,joule,Ka, Kb,kilo,Kw,L,latin,lewis,Lewis,Lfi,listofreactions,lqd,mch,mega,meta,metre, @@ -308,6 +315,12 @@ Choosing the language \code{italian} defines two additional IUPAC commands: \item The package option \key{upgreek} got renamed into \key{greek}. \item Some additional \code{\textbackslash\textcolor{code}{Chem<greekletter>}}-commands are provided, see section \ref{sec:teilchen}. \end{itemize} + +\subsection{Version 3.3a} +\begin{itemize} + \item The IUPAC commands \cmd{hapto} and \cmd{bridge} are new. + \item The H and P statements now are available in Italian. +\end{itemize} \secidx*{News}\secidx*{PRELIMINARIES} \part{\texorpdfstring{\Chemmacros}{chemmacros}}\secidx{CHEMMACROS}\label{part:chemmacros} @@ -335,6 +348,7 @@ Choosing the language \code{italian} defines two additional IUPAC commands: \befehl{Chemdelta} \Chemdelta \befehl{Chemepsilon} \Chemepsilon \befehl{Chemeta} \Chemeta + \befehl{Chemkappa} \Chemkappa \befehl{Chemmu} \Chemmu \befehl{Chemnu} \Chemnu \befehl{Chemrho} \Chemrho @@ -403,7 +417,7 @@ Depending on the \key{method} you chose as option the \code{<definition>} will e \subsection{\IUPAC Names}\secidx{IUPAC Names} Similar to the \paket{bpchem} package \chemmacros provides a command\footnote{The idea and the implementation is shamelessly borrowed from \paket*{bpchem} by Bjørn Pedersen.} to typeset \IUPAC names. Why is that useful? \IUPAC names can get very long. So long indeed that they span over more than two lines, especially in two-column documents. This means they must be allowed to be broken more than one time. This is what the following command does. \begin{beschreibung} - \item\cmd{iupac}{<IUPAC name>} Inside this command use \cmd{|} and \cmd{-} to indicate a breaking point or a breaking dash. Use {\catcode`\^=11\cmd{^}} as a shortcut for \lstinline=\textsuperscript=\footnote{Actually another mechanism is used, but the effect is essentially the same.}. + \item\cmd{iupac}{<IUPAC name>} Inside this command use \cmd{|} and \cmd{-} to indicate a breaking point or a breaking dash. Use {\catcode`\^=11\relax\cmd{^}} as a shortcut for \lstinline=\textsuperscript=\footnote{Actually another mechanism is used, but the effect is essentially the same.}. \end{beschreibung} \begin{beispiel} @@ -411,7 +425,7 @@ Similar to the \paket{bpchem} package \chemmacros provides a command\footnote{Th \iupac{Tetra\|cyclo[2.2.2.1\^{1,4}]\-un\|decane-2\-dodecyl\-5\-(hepta\|decyl\|iso\|dodecyl\|thio\|ester)} \end{minipage} \end{beispiel} -The \cmd{iupac} command is more of a semantic command. Most times you can achieve (nearly) the same thing by using \cmd{-} instead of \cmd{|}, \code{-} instead of \cmd{-} and \lstinline=\textsuperscript= instead of {\catcode`\^=11\cmd{^}}. +The \cmd{iupac} command is more of a semantic command. Most times you can achieve (nearly) the same thing by using \cmd{-} instead of \cmd{|}, \code{-} instead of \cmd{-} and \lstinline=\textsuperscript= instead of {\catcode`\^=11\relax\cmd{^}}. There are some subtleties: \cmd{-} inserts a small space before the hyphen a removes a small space after it. The command \cmd{|} not only prevents ligatures but also inserts a small space. \begin{beispiel} @@ -455,6 +469,9 @@ Greek letters in compound names are typeset upright. For this there are the pack \befehl{b} \iupac{\b} \befehl{g} \iupac{\g} \befehl{d} \iupac{\d} + \befehl{k} \iupac{\k} + \befehl{m} \iupac{\m} + \befehl{n} \iupac{\n} \befehl{w} \iupac{\w} \end{beschreibung} \begin{beispiel} @@ -511,7 +528,7 @@ The package \paket{cool} defines the commands \cmd{E} and \cmd{D}, too. If you l \befehl{para} \para \end{beschreibung} -\paragraph{absolute configuration}\index{absolute configuration} (uses \TikZ) +\paragraph{Absolute Configuration}\index{absolute configuration} (uses \TikZ) \begin{beschreibung} \befehl{Rconf}[<letter>] \cmd{Rconf}: \Rconf \quad\cmd{Rconf}[]: \Rconf[] \befehl{Sconf}[<letter>] \cmd{Sconf}: \Sconf \quad\cmd{Sconf}[]: \Sconf[] @@ -531,6 +548,23 @@ Examples: \end{beispiel} \secidx*{Stereo Descriptors and Nomenclature} +\paragraph{Coordination Chemistry} +\chemmacros provides two commands useful with coordination chemistry: +\begin{beschreibung} + \befehl{bridge}{<num>} \bridge{3} + \befehl{hapto}{<num>} \hapto{5} +\end{beschreibung} +\begin{beispiel} + Ferrocene = \iupac{bis(\hapto{5}cyclo\|penta\|dienyl)iron} \\ + \iupac{tetra\-\bridge{3}iodido\-tetrakis[tri\|methyl\|platinum(IV)]} +\end{beispiel} + +Two options allow customization: +\begin{beschreibung} + \option[iupac]{bridge-number}{sub/super} appends the number as a supscript or superscript. IUPAC recommendation is the subscript \cite{iupac:redbook}. Default = \code{sub} + \option[iupac]{coord-use-hyphen}{\default{true}/false} append a hyphen to \cmd{hapto} and \cmd{bridge} or don't. Default = \code{true} +\end{beschreibung} + \subsubsection{Own Naming Commands}\secidx[own]{IUPAC Names} If you find any commands missing you can define them using \begin{beschreibung} @@ -539,9 +573,9 @@ If you find any commands missing you can define them using \end{beschreibung} A command defined in this way will obey the setting of the option \key[option]{iupac}. This means any existing command is only overwritten with \key{iupac}{strict}. However, \cmd{DeclareChemIUPAC} will \emph{not} change the definition of an existing \IUPAC naming command but issue a warning/an error (depending on the package option \key{strict}) if the \IUPAC naming command already exists. \begin{beispiel} - % uses the `upgreek' package - \DeclareChemIUPAC\hapto{\Chemeta} - Ferrocene = \iupac{bis(\hapto\^5\-cyclo\|penta\|dienyl)iron} + \DeclareChemIUPAC\endo{\textit{endo}} + \DeclareChemIUPAC\anti{\textit{anti}} + \iupac{(2\-\endo,7\-\anti)\-2\-bromo\-7\-fluoro\|bicyclo[2.2.1]heptane} \end{beispiel} \cmd{RenewChemIUPAC} allows you to redefine the existing iupac naming commands. @@ -865,8 +899,6 @@ Examples:% TODO: watch pagebreaks! \redox(o1,o2)[draw=red,->][3.33]{\small OX: $- 2\el$} \redox(r1,r2)[draw=blue,->]{\small RED: $+ 2\el$} \end{beispiel} - -\newpage \bspmidlength{dist}{7mm} \begin{beispiel}[dist] \ch{ 2 "\OX{o1,\ox{0,Na}}" + "\OX{r1,\ox{0,Cl}}" {}2 -> 2 "\OX{o2,\ox{+1,Na}}" @@ -2402,11 +2434,11 @@ To resolve this \ghsystem tests which engine is used and if \pdfTeX\ which mode \secidx*{Pictograms} \section{Available Languages}\label{sec:ghsystem_language} -Right now the H and P statements are only available in English or German. The package adapts the package option \key[option]{german} but does not (yet) recognize language settings by \paket{babel} or \paket{polyglossia}. +Right now the H and P statements are only available in English, German or Italian. The package adapts the package option \key[option]{german} but does not (yet) recognize language settings by \paket{babel} or \paket{polyglossia}. You can also choose the language explicitly. \begin{beschreibung} - \Option{language}{english/german} + \Option{language}{english/german/italian} \end{beschreibung} \begin{beispiel} \ghs{h}{201} @@ -2485,10 +2517,12 @@ Some options can be set without value. Then the \default{underlined} value is us xspace & option & \default{true}/false & true & page \pageref{key:option_xspace} \\ \multicolumn{5}{l}{\cmd{ba}, \cmd{Nu}:} \\ elpair & particle & \default{dots}/dash/false & false & page \pageref{key:particle_elpair} \\ - \multicolumn{5}{l}{\cmd{|}, \cmd{-}:} \\ + \multicolumn{5}{l}{IUPAC commands:} \\ + break-space & iupac & <dim> & .01em & page \pageref{key:iupac_break-space} \\ + bridge-number & iupac & sub/super & sub & page \pageref{key:iupac_bridge-number} \\ + coord-use-hyphen & iupac & \default{true}/false & true & page \pageref{key:iupac_coord-use-hyphen} \\ hyphen-pre-space & iupac & <dim> & .01em & page \pageref{key:iupac_hyphen-pre-space} \\ hyphen-post-space & iupac & <dim> & -.03em & page \pageref{key:iupac_hyphen-post-space} \\ - break-space & iupac & <dim> & .01em & page \pageref{key:iupac_break-space} \\ \multicolumn{5}{l}{\cmd{DeclareChemLatin}:} \\ format & latin & <anything> & \lstinline=\itshape= & page \pageref{key:latin_format} \\ \multicolumn{5}{l}{\cmd{pch}, \cmd{mch}, \cmd{fpch}, \cmd{fmch}:} \\ @@ -2592,7 +2626,7 @@ Many thanks to all the people who already provided me with feedback, especially \item \href{http://www.mathannotated.com/}{Peter Cao} \item Christina Lüdigk \item Dr.\@ Paul King - \item Jonas Rivetti + \item Jonas Rivetti (Special thanks for his translation of the hazard and precautionary statements into Italian!) \item Christoph Schäfer \end{itemize} |