diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/chemmacros/chemgreek_en.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/chemmacros/chemgreek_en.tex | 513 |
1 files changed, 0 insertions, 513 deletions
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemgreek_en.tex b/Master/texmf-dist/doc/latex/chemmacros/chemgreek_en.tex deleted file mode 100644 index 6df2ffb9498..00000000000 --- a/Master/texmf-dist/doc/latex/chemmacros/chemgreek_en.tex +++ /dev/null @@ -1,513 +0,0 @@ -% arara: pdflatex: { shell: on } -% arara: biber -% arara: pdflatex -% arara: pdflatex -% -------------------------------------------------------------------------- -% the CHEMMACROS bundle -% chemgreek_en.tex -% macros and commands for chemists -% -------------------------------------------------------------------------- -% Clemens Niederberger -% -------------------------------------------------------------------------- -% https://bitbucket.org/cgnieder/chemmacros/ -% contact@mychemistry.eu -% -------------------------------------------------------------------------- -% If you have any ideas, questions, suggestions or bugs to report, please -% feel free to contact me. -% -------------------------------------------------------------------------- -% Copyright 2011-2013 Clemens Niederberger -% -% This work may be distributed and/or modified under the -% conditions of the LaTeX Project Public License, either version 1.3 -% of this license or (at your option) any later version. -% The latest version of this license is in -% http://www.latex-project.org/lppl.txt -% and version 1.3 or later is part of all distributions of LaTeX -% version 2005/12/01 or later. -% -% This work has the LPPL maintenance status `maintained'. -% -% The Current Maintainer of this work is Clemens Niederberger. -% -------------------------------------------------------------------------- -\documentclass[load-preamble+]{cnltx-doc} -\usepackage[utf8]{inputenc} -\usepackage[greek=newtx]{chemmacros} -\setcnltx{ - package = {chemgreek}, - title = \huge the \chemmacros\ bundle, - url = https://bitbucket.org/cgnieder/chemmacros/ , - authors = Clemens Niederberger , - email = contact@mychemistry.eu , - info = { - packages \chemmacros\ (v\csname chemmacros@version\endcsname), - \chemformula\ (v\csname chemformula@version\endcsname), - \ghsystem\ (v\csname ghsystem@version\endcsname) and - \chemgreek\ (v\csname chemgreek@version\endcsname)\\[2ex] - {\Large documentation for the \chemgreek\ package}} , - abstract = {% - \centering - \includegraphics{chemmacros-logo.pdf} - \par - } , - add-cmds = { - abinitio, activatechemgreekmapping, AddRxnDesc, anti, aq, aqi, - ba, bond, bridge, - cd, ch, changechemgreeksymbol, charrow, chcpd, chemabove, chemalpha, - chembeta, chemgamma, chemdelta, chemDelta, chemformula@bondlength, - chemomega, chemphi, chemPhi, chemsetup, chlewis, chname , cip, cis, ch, - CNMR, - data, DeclareChemArrow, DeclareChemBond, DeclareChemBondAlias, - declarechemgreekmapping, DeclareChemIUPAC, DeclareChemLatin, - DeclareChemNMR, DeclareChemParticle, DeclareChemPhase, - DeclareChemReaction, DeclareChemState, delm, delp, Delta, Dfi, - el, ElPot, endo, Enthalpy, enthalpy, Entropy, - fmch, fpch, fscrm, fscrp, - gas, ghs, ghslistall, ghspic, Gibbs, gram, - hapto, HNMR, Helmholtz, hydrogen, - insitu, invacuo, iupac, - Ka, Kb, Kw, - Lfi, listofreactions, lqd, - mch, mega, meta, mhName, - NewChemArrow, NewChemBond, NewChemBondAlias, - newchemgreekmapping, NewChemIUPAC, NewChemLatin, - NewChemNMR, NewChemParticle, NewChemPhase, - NewChemReaction, NewChemState, - newman, nitrogen, NMR, Nu, Nuc, - orbital, ortho, ox, OX, oxygen, - para, pch, per, pH, phase, phosphorus, photon, pKa, pKb, pOH, pos, - positron, Pot, prt, printchemgreekalphabet , - Rad, redox, RenewChemArrow, RenewChemBond, renewchemgreekmapping, - RenewChemIUPAC, RenewChemLatin, RenewChemNMR, RenewChemParticle, - RenewChemPhase, RenewChemState, - Sf, scrm, scrp, second, selectchemgreekmapping, setchemformula, - ShowChemArrow, ShowChemBond, sld, Sod, State, sulfur, - trans, - val - } , - add-silent-cmds = { - addplot, - bottomrule, - cancel, cdot, ce, cee, celsius, centering, chemfig, chemname, clap, - cnsetup, color, cstack, cstsetup, - DeclareInstance, DeclareSIUnit, definecolor, draw, - electronvolt, - footnotesize, - glqq, grqq, - hertz, hspace, - includegraphics, intertext, IUPAC, - joule, - kilo, - latin, lewis, Lewis, liquid, ltn, - metre, midrule, milli, mmHg, mole, - nano, nicefrac, num, numrange, - ominus, oplus, - percent, pgfarrowsdeclarealias, pgfarrowsrenewalias, - renewtagform, rightarrow, - sample, scriptscriptstyle, setatomsep, setbondoffset, setmainfont, sfrac, - shorthandoff, si, SI, sisetup, square, subsection, - textcolor, textendash, textsuperscript, tiny, toprule, - upbeta, upeta, upgamma, upPhi, upphi, usetikzlibrary, - volt, vphantom, vspave, - xspace, - z@, z@skip - } -} - -\usepackage{chemfig,booktabs,cancel,varioref} -\usepackage[version=3]{mhchem} - -\expandafter\def\csname libertine@figurestyle\endcsname{LF} -\usepackage[libertine]{newtxmath} -\expandafter\def\csname libertine@figurestyle\endcsname{OsF} - -\usepackage[biblatex]{embrac} -\ChangeEmph{[}[,.02em]{]}[.055em,-.08em] -\ChangeEmph{(}[-.01em,.04em]{)}[.04em,-.05em] - -\usepackage[accsupp]{acro} -\acsetup{ - long-format = \scshape , - short-format = \scshape -} -\DeclareAcronym{ghs}{ - short = ghs , - long = Globally Harmonized System of Classification and Labelling of - Chemicals , - pdfstring = GHS , - accsupp = GHS -} -\DeclareAcronym{eu}{ - short = EU , - long = European Union , - pdfstring = EU , - accsupp = EU -} -\DeclareAcronym{iupac}{ - short = iupac , - long = International Union of Pure and Applied Chemistry , - pdfstring = IUPAC , - accsupp = IUPAC -} -\DeclareAcronym{UN}{ - short = un , - long = United Nations , - pdfstring = UN , - accsupp = UN -} -\DeclareAcronym{dvi}{ - short = dvi , - long = device independent file format , - pdfstring = DVI , - accsupp = DVO -} -\DeclareAcronym{pdf}{ - short = pdf , - long = portable document file , - pdfstring = PDF , - accsupp = PDF -} - -\chemsetup{ - option/synchronize , - chemformula/format = \libertineLF -} -% \colorlet{chemformula}{black!90} - -\sisetup{ - detect-mode=false, - mode=text, - text-rm=\libertineLF -} - -\usepackage{filecontents} - -\defbibheading{bibliography}{\addsec{References}} -\addbibresource{\jobname.bib} -\begin{filecontents*}{\jobname.bib} -@book{iupac:greenbook, - author = {E. Richard Cohan and Tomislav Cvita\v{s} and Jeremy G. Frey and - Bertil Holmstr\"om and Kozo Kuchitsu and Roberto Marquardt and Ian Mills and - Franco Pavese and Martin Quack and J\"urgen Stohner and Herbert L. Strauss and - Michio Takami and Anders J Thor} , - title = {``Quantities, Symbols and Units in Physical Chemistry'', \acs{iupac} - Green Book} , - sorttitle = {Quantities, Symbols and Units in Physical Chemistry} , - indexsorttitle = {Quantities, Symbols and Units in Physical Chemistry} , - edition = {3rd Edition. 2nd Printing} , - year = {2008} , - publisher = {\acs{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'', \acs{iupac} Red Book} , - sorttitle = {Nomenclature of Inorganic Chemistry} , - indexsorttitle = {Nomenclature of Inorganic Chemistry} , - year = {2005} , - publisher = { \acs{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} , - subtitle = {on classification, labelling and packaging of substances and - mixtures, amending and repealing Directives 67/548/EEC and 1999/45/EC, and - amending Regulation (EC) No 1907/2006} , - journal = {Official Journal of the European Union} , - date = {2008-12-16} -} -@online{unece:ghsystem_implementation, - author = {United Nations Economic Commission for Europe} , - title = {GHS Implementation} , - url = - {http://www.unece.org/trans/danger/publi/ghs/implementation_e.html} , - urldate = {2012-03-20} , - date = {2012-03-20} -} -\end{filecontents*} - -\DeclareInstance{xfrac}{chemformula-text-frac}{text} - { - scale-factor = 1 , - denominator-bot-sep = -.2ex , - denominator-format = \scriptsize #1 , - numerator-top-sep = -.2ex , - numerator-format = \scriptsize #1 , - slash-right-kern = .05em , - slash-left-kern = .05em - } - -\usetikzlibrary{calc,positioning,decorations.pathmorphing,patterns} - -\newpackagename\chemmacros{chemmacros} -\newpackagename\chemformula{chemformula} -\newpackagename\ghsystem{ghsystem} -% \newpackagename\chemgreek{chemgreek} - - -\newidxcmd\manual{\textsf{#1}}[\ (manual)] - -\newenvironment{codedesc} - {% - \def\Code##1{\item\code{##1}\hfill\newline}% - \cnltxlist - } - {\endcnltxlist} - -\renewcommand*\AmS{\hologo{AmS}} - -\newcommand*\TikZ{Ti\textit{k}Z} - -\newcommand*\tablehead[1]{\textrm{\bfseries#1}} - -\begin{document} - -\section{Introduction} -The \chemgreek\ package is an auxiliary package for other chemistry packages -such as \chemmacros. In chemistry there is often the need for upright greek -letters. The \chemgreek\ package provides an interface to various other -packages that provide upright greek letters. One could mention -\pkg{textgreek}, \pkg{upgreek}, \pkg{newtx} or \pkg{kpfonts}. All of these -packages provide upright greek letters, some a whole alphabet some only the -upright variants of the standard italic symbols for which macros are defined -in base \LaTeX. - -\chemgreek\ offers a possibility to map those different interfaces to a -unified set of macros for usage in a chemistry package. This is useful as -then for example names like \iupac{\b\-\D\-gluco\|pyranose} can be typeset -with a semantic interface and still have matching greek letters while the user -is not limited to a certain package or font. Consequently this package is -used by \chemmacros\ and its \acs{iupac} naming commands. - -\section{Licence and Requirements} -\license - -\chemgreek\ loads the following packages: -\pkg{expl3}\footnote{\CTANurl{l3kernel}}~\cite{bnd:l3kernel} and -\pkg{xparse}\footnote{\CTANurl{l3packages}}~\cite{bnd:l3packages}. - -\section{News} -\subsection{Version~0.2} -\begin{itemize} - \item The mapping ``mathdesign'' has been added. In order to use it you - need the \pkg{mathdesign} package~\cite{pkg:mathdesign} loaded. - \item The mapping ``fourier'' has been added. In order to use it you - need the \pkg{fourier} package~\cite{pkg:fourier} loaded. -\end{itemize} - -\subsection{Version~0.3} -\begin{itemize} - \item The provided macros have been renamed from \cs*{Chem\meta{\ldots}} - into \cs*{chem\meta{\ldots}}. The uppercase version still are provided - for backwards compatibility but issue a warning message and will be - removed some time in the future. - \item The commands for defining mappings have gotten an optional argument - which allows to specify the name of the package a mapping needs. The - command \cs{selectchemgreekmapping} now checks for this package and gives - a warning if it doesn't find it loaded. - \item The mapping ``textalpha'' has been added. In order to use it you - need the \pkg{textalpha} package (part of - \bnd{greek-fontenc}~\cite{bnd:greek-fontenc}) loaded. - \item If the package \pkg{hyperref}~\cite{pkg:hyperref} is loaded with the - \code{unicode} option \emph{and} the \pkg{textalpha} package has been - loaded at begin document all the \cs*{chem\meta{\ldots}} commands are let - to \pkg{textalpha}'s \cs*{text\meta{\ldots}} commands for the \acs{pdf} - bookmarks. This allows Greek letters in the bookmarks without worrying - about \cs*{texorpdfstring}. -\end{itemize} - -\subsection{Version~0.4} -\begin{itemize} - \item The mapping ``fontspec'' has been added. In order to use it you - need the \pkg{fontspec} package~\cite{pkg:fontspec} loaded. This means it - can only be used with \LuaLaTeX\ or \XeLaTeX. - \item New command \cs{printchemgreekalphabet}. -\end{itemize} - -\section{Define Mappings} -\selectchemgreekmapping{default} - -\chemgreek's main commands are: -\begin{commands} - \command{newchemgreekmapping}[\oarg{package}\marg{name}\marg{mapping list}] - \changedversion{0.3}Add a new mapping to \chemgreek. Issue an error if it - already exists. With the optional argument the package that is needed for - this mapping can (and should) be specified. - \command{renewchemgreekmapping}[\oarg{package}\marg{name}\marg{mapping list}] - \changedversion{0.3}Renew a \chemgreek\ mapping. Issue an error if it - doesn't exist yet. With the optional argument the package that is needed - for this mapping can (and should) be specified. - \command{declarechemgreekmapping}[\oarg{package}\marg{name}\marg{mapping list}] - \changedversion{0.3}Declare a new mapping to \chemgreek. If the mapping - already exists it will be overwritten. With the optional argument the - package that is needed for this mapping can (and should) be specified. -\end{commands} - -The command \cs{newchemgreekmapping} needs to get a comma separated list of -24 pairs divided by a slash. The first entry is the lowercase version und the -second the uppercase version for the corresponding greek letter at the current -position. This will become clearer if you look at how the \code{default} -mapping is defined: - -\begin{sourcecode} - \newchemgreekmapping{default} - { - \ensuremath{\alpha} / \ensuremath{\mathrm{A}} , % 1: alpha - \ensuremath{\beta} / \ensuremath{\mathrm{B}} , % 2: beta - \ensuremath{\gamma} / \ensuremath{\Gamma} , % 3: gamma - \ensuremath{\delta} / \ensuremath{\Delta} , % 4: delta - \ensuremath{\epsilon} / \ensuremath{\mathrm{E}} , % 5: epsilon - \ensuremath{\zeta} / \ensuremath{\mathrm{Z}} , % 6: zeta - \ensuremath{\eta} / \ensuremath{\mathrm{H}} , % 7: eta - \ensuremath{\theta} / \ensuremath{\Theta} , % 8: theta - \ensuremath{\iota} / \ensuremath{\mathrm{I}} , % 9: iota - \ensuremath{\kappa} / \ensuremath{\mathrm{K}} , % 10: kappa - \ensuremath{\lambda} / \ensuremath{\Lambda} , % 11: lambda - \ensuremath{\mu} / \ensuremath{\mathrm{M}} , % 12: mu - \ensuremath{\nu} / \ensuremath{\mathrm{N}} , % 13: nu - \ensuremath{\xi} / \ensuremath{\Xi} , % 14: xi - \ensuremath{o} / \ensuremath{\mathrm{O}} , % 15: omikron - \ensuremath{\pi} / \ensuremath{\Pi} , % 16: pi - \ensuremath{\rho} / \ensuremath{\mathrm{P}} , % 17: rho - \ensuremath{\sigma} / \ensuremath{\Sigma} , % 18: sigma - \ensuremath{\tau} / \ensuremath{\mathrm{T}} , % 19: tau - \ensuremath{\upsilon} / \ensuremath{\Upsilon} , % 20: upsilon - \ensuremath{\phi} / \ensuremath{\Phi} , % 21: phi - \ensuremath{\psi} / \ensuremath{\Psi} , % 22: psi - \ensuremath{\chi} / \ensuremath{\mathrm{X}} , % 23: chi - \ensuremath{\omega} / \ensuremath{\Omega} % 24: omega - } -\end{sourcecode} - -There \emph{must} be 24 pairs of entries, \ie, a complete mapping! Those -entries are the ones that will be used by the interface macros. For each -letter a pair \cs{chemalpha}/\cs{chemAlpha} is defined that uses the entries -of the currently active mapping. That means there are 48 (robust) macros -defined each beginning with \cs*{chem...} followed by the lowercase or -uppercase name of the Greek letter. - -The default mapping is -- as you can probably see -- \emph{not an upright - one}. This is because \chemgreek\ will not make any choice for a specific -package but let's the user (or another package) choose. The \chemmacros\ -package for example provides a package option that selects one of the -available mappings. - -\begin{example} - Default mapping: \chemphi\ and \chemPhi, $\phi$ and $\Phi$ -\end{example} - -\section{Predefined Mappings and Selection of a Mapping} -\chemgreek\ predefines some mappings. Some of the mappings require additional -packages to be loaded. The mapping names and the required packages are listed -in table~\ref{tab:mappings}. Ths mapping \code{fontspec} is a bit different -here: if you use this mapping then the fact is used that \pkg{fontspec} also -defines commands like \cs*{textalpha}. However, they only work if you also -use a font that has the Greek glyphs. - -\begin{table} - \centering - \begin{tabular}{>{\ttfamily}ll} - \toprule - \tablehead{mapping} & \tablehead{package} \\ - \midrule - default & --- \\ - var-default & --- \\ - textgreek & \pkg{textgreek} \cite{pkg:textgreek} \\ - upgreek & \pkg{upgreek} \cite{pkg:upgreek} \\ - newtx & \pkg*{newtxmath} \cite{pkg:newtx} \\ - kpfonts & \pkg{kpfonts} \cite{pkg:kpfonts} \\ - mathdesign & \pkg{mathdesign} \cite{pkg:mathdesign} \\ - fourier & \pkg{fourier} \cite{pkg:fourier} \\ - textalpha & \pkg{textalpha} \cite{bnd:greek-fontenc} \\ - fontspec & \pkg{fontspec} \cite{pkg:fontspec} \\ - \bottomrule - \end{tabular} - \caption{Predefined mappings.} - \label{tab:mappings} -\end{table} - -A mapping is selected and activated with one of the following commands: -\begin{commands} - \command{activatechemgreekmapping}[\sarg\marg{name}] - \changedversion{0.3}This commands selects and activates the mapping - \meta{name}. If the star variant is used also the package of mapping - \meta{name} (as defined with \cs{newchemgreekmapping} is loaded. The - command can only be used in the document preamble. - \command{selectchemgreekmapping}[\marg{name}] - \changedversion{0.3}This commands selects and activates the mapping - \meta{name}. A required package has to be loaded additionally the usual - way via \cs*{usepackage} or \cs*{RequirePackage}. If the package hasn't - been loaded a warning will be written to the log. The command can be used - throughout the document. -\end{commands} - -\begin{example} - % requires the `newtxmath' package to be loaded: - \chemphi\ and \chemPhi, $\phi$ and $\Phi$\par - \selectchemgreekmapping{newtx} - \chemphi\ and \chemPhi, $\upphi$ and $\upPhi$ -\end{example} - -Since the \code{fontspec} mapping is a little bit different than the others -I'd like to show a little example for it. The difference is subtle: you need -to choose a font containing the needed glyphs. - -\begin{example}[compile,program=lualatex,runs=1,add-frame=false] - \documentclass[margin=3pt]{standalone} - \usepackage{fontspec} - \setmainfont{Linux Libertine O}% need a font that has the glyphs! - \usepackage{chemgreek} - \selectchemgreekmapping{fontspec} - \begin{document} - \printchemgreekalphabet - \end{document} -\end{example} - -\section{Changing a Specific Symbol in an Existing Mapping} -If you should want to change a specific entry of a specific mapping it would -be rather tedious to redefine the whole mapping. That is why \chemgreek\ -provides a command for that purpose: -\begin{commands} - \command{changechemgreeksymbol}[\marg{mapping - name}\Marg{upper|lower}\marg{entry name}\marg{entry}] - Changes the \code{upper}- or \code{lower}case entry \meta{entry name} in - the mapping \meta{mapping name}. -\end{commands} - -In order to activate the change you need the (re-) activate the affected -mapping afterwards: -\begin{example} - \chemalpha - \changechemgreeksymbol{default}{lower}{alpha}{xxx}% - \selectchemgreekmapping{default} - \chemalpha -\end{example} - -\section{Inspecting a Mapping} -\selectchemgreekmapping{newtx} -If you want to check if a mapping has been correctly set you can use the -following commands: -\begin{commands} - \command{printchemgreekmapping}[\marg{mapping}] - \sinceversion{0.3}This will typeset a table (using a simple \code{tabular} - environment) with all~48 characters like the one shown in - table~\ref{tab:showmapping}. - \command{printchemgreekalphabet} - \sinceversion{0.4}This will print the twentyfour pairs of lower- and - uppercase letters of the currently active mapping: \printchemgreekalphabet. - \command{showchemgreekmapping}[\marg{mapping}] - \changedversion{0.3}This command will write information about the - definition of all 48~macros for a mapping to the log file. -\end{commands} - -\begin{table} - \centering - \printchemgreekmapping{newtx} - \caption{A demonstration of the \cs*{printchemgreekmapping} command.} - \label{tab:showmapping} -\end{table} - -\clearpage - -\end{document} |