summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/chemnum
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-11-04 23:17:17 +0000
committerKarl Berry <karl@freefriends.org>2011-11-04 23:17:17 +0000
commit963f84feffa4aced809934a4c59f4c2bfdcb8d65 (patch)
tree3f02d185530ac37e8ed15ea900742360abc752dc /Master/texmf-dist/doc/latex/chemnum
parentcb33be94e6d58477c394350360dc7b482612c18c (diff)
chemnum (4nov11)
git-svn-id: svn://tug.org/texlive/trunk@24495 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/chemnum')
-rw-r--r--Master/texmf-dist/doc/latex/chemnum/README2
-rw-r--r--Master/texmf-dist/doc/latex/chemnum/bsp.tex3
-rw-r--r--Master/texmf-dist/doc/latex/chemnum/chemnum_doc_de.pdfbin423337 -> 634556 bytes
-rw-r--r--Master/texmf-dist/doc/latex/chemnum/chemnum_doc_de.tex42
-rw-r--r--Master/texmf-dist/doc/latex/chemnum/chemnum_doc_en.pdfbin411004 -> 618627 bytes
-rw-r--r--Master/texmf-dist/doc/latex/chemnum/chemnum_doc_en.tex32
6 files changed, 58 insertions, 21 deletions
diff --git a/Master/texmf-dist/doc/latex/chemnum/README b/Master/texmf-dist/doc/latex/chemnum/README
index e49258841d0..016891fd79a 100644
--- a/Master/texmf-dist/doc/latex/chemnum/README
+++ b/Master/texmf-dist/doc/latex/chemnum/README
@@ -11,7 +11,7 @@ chemnum also needs the packages etoolbox, psfrag and textgreek
to be fully functioning.
Clemens NIEDERBERGER
-2011/09/03
+2011/11/03
http://www.mychemistry.eu/
contact@mychemistry.eu
diff --git a/Master/texmf-dist/doc/latex/chemnum/bsp.tex b/Master/texmf-dist/doc/latex/chemnum/bsp.tex
index 81c4a4fd282..850fd13495d 100644
--- a/Master/texmf-dist/doc/latex/chemnum/bsp.tex
+++ b/Master/texmf-dist/doc/latex/chemnum/bsp.tex
@@ -3,7 +3,7 @@
% - a comprehensive numbering method for chemical compounds - %
% ------------------------------------------------------------------------------------- %
% - Clemens NIEDERBERGER - %
-% - 2011/09/03 - %
+% - 2011/11/03 - %
% ------------------------------------------------------------------------------------- %
% - http://www.mychemistry.eu/ - %
% - contact@mychemistry.eu - %
@@ -83,6 +83,7 @@
arrow,
bf,
chemfig,
+ chemname,
cmpd,
cmpdinit,
cmpdref,
diff --git a/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_de.pdf b/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_de.pdf
index 827b5ae7d32..afb79cc6066 100644
--- a/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_de.pdf
+++ b/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_de.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_de.tex b/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_de.tex
index a283262c9d6..5edb8f73c95 100644
--- a/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_de.tex
+++ b/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_de.tex
@@ -3,7 +3,7 @@
% - a comprehensive numbering method for chemical compounds - %
% ------------------------------------------------------------------------------------- %
% - Clemens NIEDERBERGER - %
-% - 2011/09/03 - %
+% - 2011/11/03 - %
% ------------------------------------------------------------------------------------- %
% - http://www.mychemistry.eu/ - %
% - contact@mychemistry.eu - %
@@ -36,7 +36,7 @@
\colorlet{code}{RawSienna}
\colorlet{shadecolor}{yellow!20}
\usepackage[runs=2]{auto-pst-pdf}
-\usepackage{chemnum,textcomp,url,xspace,booktabs,array,chemscheme}
+\usepackage{chemnum,textcomp,lmodern,microtype,url,xspace,booktabs,array,chemscheme}
\usepackage[version=3]{mhchem}
\renewcommand*\schemename{Schema}
\usepackage[normalem]{ulem}
@@ -118,15 +118,15 @@
\ExplSyntaxOff
\newcommand*\chemnum{\textsf{chemnum}\xspace}
-\newcommand*\CNversion{v0.3a\xspace}
-\newcommand*\CNdate{2011/09/03\xspace}
+\newcommand*\CNversion{v0.3b\xspace}
+\newcommand*\CNdate{2011/11/03\xspace}
\newcommand*\paket[1]{\textsf{#1}\footnote{\url{http://www.ctan.org/pkg/#1}}}
\newcommand*\zB{\mbox{z.\,B.}\xspace}
\newcommand*\bzw{\mbox{bzw.}\xspace}
\newcommand*\usw{\mbox{usw.}\xspace}
-\cmpdinit*{a,aa,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q}
+\cmpdinit*{a,aa,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,benzol}
\begin{document}
\begin{titlepage}
@@ -220,7 +220,7 @@ Dann gibt es noch \paket{bpchem}, das Befehle ähnlich den Befehlen \lstinline=\
\chemnum soll diese Schwächen beheben. Dafür wurden alle Befehle vollständig neu geschrieben. Allerdings wurden Ideen von \textsf{chemcompounds} aufgegriffen was Dar\-stel\-lungs\-mög\-lich\-kei\-ten wie Begrenzer \usw betrifft.
-Wenn Ihnen irgendwelche fehlenden Features auffallen, geben Sie mir bitte Bescheid, indem Sie mir eine E-Mail senden.
+Wenn Ihnen irgendwelche fehlenden Features auf"|fallen, geben Sie mir bitte Bescheid, indem Sie mir eine E-Mail senden.
\section{Verbindungen Nummerieren}\label{sec:nummerieren}
\subsection{Basisbefehl}
@@ -239,13 +239,13 @@ Falls es nötig sein sollte, eine Verbindung zu deklarieren, ohne ein Label ausz
\begin{framed}\label{cmd:unsichtbares_label}
\centering\lstinline=\cmpd*{<label name>}=
\end{framed}
-\noindent verwenden. Dadurch wird ein entsprechendes Label deklariert aber nicht ausgegeben. \textbf{Dieser Befehl wird nicht benötigt, wenn man} \lstinline=\cmpdinit{}= \textbf{verwendet, siehe Abschnitt \ref{sec:cmpdinit} (S. \pageref{sec:cmpdinit}ff).}
+\noindent verwenden. Dadurch wird ein entsprechendes Label deklariert aber nicht ausgegeben. \textbf{Dieser Befehl wird nicht benötigt, wenn man} \lstinline=\cmpdinit{}= \textbf{verwendet, siehe Abschnitt \ref{sec:cmpdinit} (S.\,\pageref{sec:cmpdinit}ff).}
\begin{beispiel}
Die versteckte Version\cmpd*{d} erzeugt zwar das Label, schreibt es aber nicht aus. Der n\"achste \cmpd{e} f\"uhrt die Z\"ahlung einfach weiter. Mit \cmpd{d} kann nat\"urlich auf das erzeugte Label zur\"uckgegriffen werden.
\end{beispiel}
-Als Label-Namen können Sie im Prinzip einsetzen, was Sie wollen\footnote{Es gibt ein Einschränkungen, siehe Abschnitt \ref{ssec:unterlabel} (S. \pageref{ssec:unterlabel}) und Abschnitt \ref{ssec:sub_label_marker} (S. \pageref{ssec:sub_label_marker}).}. Sie sollten allerdings darauf achten, dass der Name keine Leerzeichen enthält. Das führt zwar nicht unbedingt zu einem Fehler, könnte aber verschiedenen Labeln die gleiche Nummer zuweisen.
+Als Label-Namen können Sie im Prinzip einsetzen, was Sie wollen\footnote{Es gibt ein Einschränkungen, siehe Abschnitt \ref{ssec:unterlabel} (S.\,\pageref{ssec:unterlabel}) und Abschnitt \ref{ssec:sub_label_marker} (S.\,\pageref{ssec:sub_label_marker}).}. Sie sollten allerdings darauf achten, dass der Name keine Leerzeichen enthält. Das führt zwar nicht unbedingt zu einem Fehler, könnte aber verschiedenen Labeln die gleiche Nummer zuweisen.
\lstset{showspaces=true}
\begin{beispiel}
@@ -291,7 +291,7 @@ Die richtige Beschreibung des Befehls lautet also eher:
Mehrere Label k\"onnen einfach durch Kommata getrennt eingegeben werden. Dann wird eine Liste wie \cmpd{a, b, c, e, g.two} ausgegeben.
\end{beispiel}
-Wie das nicht-US-Amerikenern merkwürdig anmutende \verb=, and= zwischen \cmpd{e} und \cmpd{g.two} schon vermuten lässt, kann man die Ausgabe der Liste noch verändern, siehe Abschnitt \ref{ssec:trenner} (S. \pageref{ssec:trenner}).
+Wie das nicht-US-Amerikenern merkwürdig anmutende \verb=, and= zwischen \cmpd{e} und \cmpd{g.two} schon vermuten lässt, kann man die Ausgabe der Liste noch verändern, siehe Abschnitt \ref{ssec:trenner} (S.\,\pageref{ssec:trenner}).
\section{Label zentral initialisieren}\label{sec:cmpdinit}
Die in diesem Abschnitt beschriebenen Befehle sind für den Einsatz von \chemnum nicht nötig, stellen aber Funktionen bereit, die der ein oder andere Anwender nützlich finden könnte.
@@ -425,7 +425,7 @@ Der Befehl\label{cmd:cmpd_plus}
\begin{framed}
\centering\lstinline=\cmpd+{<label name>}=
\end{framed}
-liest den Labelnamen, der ausgegeben werden soll, aus der Datei \lstinline=<jobname>.cmpd=. Damit ist er sozusagen das Gegenteil von \lstinline=\cmpd*=, da das Label nicht deklariert sondern nur referenziert und ausgegeben wird. Damit man also \lstinline=\cmpd+{<label>}= einsetzen kann, muss \lstinline=<label>= entweder mit \lstinline=\cmpd{<label>}= oder \lstinline=\cmpd*{<label>}= (davor oder danach) deklariert worden sein. \lstinline=\cmpd+= ist nützlich, wenn ein Label in einem beweglichen Argument wie in \lstinline=\section{}= eingesetzt werden soll. \textbf{Er wird nicht benötigt, wenn} \lstinline=\cmpdinit{}= \textbf{verwendet wird, siehe Abschnitt \ref{sec:cmpdinit} (S. \pageref{sec:cmpdinit}ff).}
+liest den Labelnamen, der ausgegeben werden soll, aus der Datei \lstinline=<jobname>.cmpd=. Damit ist er sozusagen das Gegenteil von \lstinline=\cmpd*=, da das Label nicht deklariert sondern nur referenziert und ausgegeben wird. Damit man also \lstinline=\cmpd+{<label>}= einsetzen kann, muss \lstinline=<label>= entweder mit \lstinline=\cmpd{<label>}= oder \lstinline=\cmpd*{<label>}= (davor oder danach) deklariert worden sein. \lstinline=\cmpd+= ist nützlich, wenn ein Label in einem beweglichen Argument wie in \lstinline=\section{}= eingesetzt werden soll. \textbf{Er wird nicht benötigt, wenn} \lstinline=\cmpdinit{}= \textbf{verwendet wird, siehe Abschnitt \ref{sec:cmpdinit} (S.\,\pageref{sec:cmpdinit}ff).}
\begin{beispiel}
\subsubsection{Test-\"Uberschrift mit Verbindungslabel \cmpd+[cmpd-delim]{f.one}}
@@ -609,7 +609,7 @@ Benötigen \emph{zwei} Token als Wert!
\cmpdsetup{cmpd-delim = ()}
\cmpd{a, b, f.two, k} % eingeklammert
\end{beispiel}
-Bitte Beachten Sie, dass die Default-Werte (siehe S. \pageref{opt:default} und \pageref{ssec:uebersicht}) von \lstinline=cmpd-delim= und \lstinline=list-delim= und die Voreinstellung von \chemnum \emph{nicht} übereinstimmen. Per Default verwendet \chemnum keine Begrenzer. Beachten Sie außerdem, dass die Listenbegrenzer erst ab \emph{zwei} Labeln verwendet werden.
+Bitte Beachten Sie, dass die Default-Werte (siehe S.\,\pageref{opt:default} und \pageref{ssec:uebersicht}) von \lstinline=cmpd-delim= und \lstinline=list-delim= und die Voreinstellung von \chemnum \emph{nicht} übereinstimmen. Per Default verwendet \chemnum keine Begrenzer. Beachten Sie außerdem, dass die Listenbegrenzer erst ab \emph{zwei} Labeln verwendet werden.
\begin{beispiel}
\cmpd{a, b, f.two, k}\\ % default
\cmpd[list-delim = {[}{]}]{a, b, f.two, k}\\ % eingeklammert
@@ -777,6 +777,23 @@ Mit den Keys \lstinline=sub-range-sep= und \lstinline=sub-range-marker= kann man
Damit die Keys die richtigen Sublabel verwenden können, müssen diese deklariert worden sein. Daher werden sie aus der Datei \lstinline=<jobname>.cmpd= (angenommen Ihre Quelldatei heißt \lstinline=<jobname>.tex=) gelesen. Daher müssen Sie zweimal (oder öfter) kompilieren, bis alle Labels richtig dargestellt werden.
+Verwendet man Label mit Sublabel-Bereichen, dann möchte man vielleicht an anderer Stelle \emph{nur} das Sublabel ausgeben. Das ist möglich mit folgendem Key:
+\begin{framed}
+ \noindent\lstinline+sub-only = <bool>+\hfill Typ: \lstinline=boolean=
+\end{framed}
+\begin{beispiel}
+ % use packages `chemfig', `mhchem' and `booktabs'
+ \cmpd*{benzol.H,benzol.Me,benzol.OH,benzol.NH2}
+ \chemname{\chemfig{*6(=-=-(-R)=-)}}{\cmpd[cmpd-all]{benzol}}
+ \begin{tabular}{lll}
+ & \ce{{}-R} & Name \\\midrule
+ \cmpd[sub-only]{benzol.H} & \ce{{}-H} & Benzol \\
+ \cmpd[sub-only]{benzol.Me} & \ce{{}-CH3} & Toluol \\
+ \cmpd[sub-only]{benzol.OH} & \ce{{}-OH} & Phenol \\
+ \cmpd[sub-only]{benzol.NH2} & \ce{{}-NH2} & Anilin
+ \end{tabular}
+\end{beispiel}
+
In der Zwischenzeit benötigt der Key \lstinline=sub-list= etwas Aufmerksamkeit. Leider ist automatisches Sortieren nicht so trivial, wie man sich wünschte. Daher müssen Sie die Sublabel-Namen in der richtigen Reihenfolge einsetzen, um Label wie diese zu vermeiden:
\begin{beispiel}
\cmpd[sub-list={five..three}]{q} or \cmpd[sub-list={three,one,four}]{q}.
@@ -803,7 +820,8 @@ Im folgenden sind alle verfügbaren Schlüssel aufgelistet. Bitte beachten Sie,
sub-counter & alph & choice \\
sub-list & & other$^\mathrm{b}$ \\
sub-range-sep & - & literal \\
- sub-range-marker & .. & literal \\\midrule
+ sub-range-marker & .. & literal \\
+ sub-only & & boolean \\\midrule
list-delim$^\mathrm{a}$ & () & literal \\
list-odelim & & literal \\
list-cdelim & & literal \\
diff --git a/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_en.pdf b/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_en.pdf
index 7f9c75c9c43..1c15c303335 100644
--- a/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_en.pdf
+++ b/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_en.tex b/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_en.tex
index 8eafd9d0d2c..1357f246d0a 100644
--- a/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_en.tex
+++ b/Master/texmf-dist/doc/latex/chemnum/chemnum_doc_en.tex
@@ -3,7 +3,7 @@
% - a comprehensive numbering method for chemical compounds - %
% ------------------------------------------------------------------------------------- %
% - Clemens NIEDERBERGER - %
-% - 2011/09/03 - %
+% - 2011/11/01 - %
% ------------------------------------------------------------------------------------- %
% - http://www.mychemistry.eu/ - %
% - contact@mychemistry.eu - %
@@ -32,7 +32,7 @@
\documentclass[DIV11]{scrartcl}
\usepackage[english]{babel}
\usepackage[utf8]{inputenx}
-\usepackage{chemnum,textcomp,url,xspace,booktabs,array,chemscheme}
+\usepackage{chemnum,textcomp,lmodern,microtype,url,xspace,booktabs,array,chemscheme}
\usepackage[version=3]{mhchem}
\usepackage[normalem]{ulem}
\usepackage[dvipsnames]{xcolor}
@@ -118,15 +118,15 @@
\ExplSyntaxOff
\newcommand*\chemnum{\textsf{chemnum}\xspace}
-\newcommand*\CNversion{v0.3a\xspace}
-\newcommand*\CNdate{2011/09/03\xspace}
+\newcommand*\CNversion{v0.3b\xspace}
+\newcommand*\CNdate{2011/11/03\xspace}
\newcommand*\paket[1]{\textsf{#1}\footnote{\url{http://www.ctan.org/pkg/#1}}}
\newcommand*\eg{\mbox{e.\,g.}\xspace}
\newcommand*\ie{\mbox{i.\,e.}\xspace}
\newcommand*\etc{\mbox{etc.}\xspace}
-\cmpdinit*{a,aa,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q}
+\cmpdinit*{a,aa,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,benzol}
\begin{document}
\begin{titlepage}
@@ -772,6 +772,23 @@ With the keys \lstinline=sub-range-sep= and \lstinline=sub-range-marker= you can
In order to get the right sublabels the command needs to know, which sublabels have been declared. This means that they're read from the \lstinline=<jobname>.cmpd= file (supposing your source file is called \lstinline=<jobname>.tex=). So you may need to compile twice (or more) until the labels are printed right.
+If one uses label with sublabel ranges, one might want to use \emph{only} the sublabels in a different place. This is possible with this key:
+\begin{framed}
+ \noindent\lstinline+sub-only = <bool>+\hfill type: \lstinline=boolean=
+\end{framed}
+\begin{beispiel}
+ % use packages `chemfig', `mhchem' and `booktabs'
+ \cmpd*{benzene.H,benzene.Me,benzene.OH,benzene.NH2}
+ \chemname{\chemfig{*6(=-=-(-R)=-)}}{\cmpd[cmpd-all]{benzene}}
+ \begin{tabular}{lll}
+ & \ce{{}-R} & Name \\\midrule
+ \cmpd[sub-only]{benzene.H} & \ce{{}-H} & Benzene \\
+ \cmpd[sub-only]{benzene.Me} & \ce{{}-CH3} & Toluene \\
+ \cmpd[sub-only]{benzene.OH} & \ce{{}-OH} & Phenol \\
+ \cmpd[sub-only]{benzene.NH2} & \ce{{}-NH2} & Phenylamine (Aniline)
+ \end{tabular}
+\end{beispiel}
+
For the time being the \lstinline=sub-list= key requires a little caution. Unfortunately automatic sorting isn't quite as trivial as one would wish. So you have to use the sublabel names in the right order if you want to avoid labels like these:
\begin{beispiel}
\cmpd[sub-list={five..three}]{q} or \cmpd[sub-list={three,one,four}]{q}.
@@ -798,7 +815,8 @@ In this section all keys are listed. Please be aware that the default values of
sub-counter & alph & choice \\
sub-list & & other$^\mathrm{b}$ \\
sub-range-sep & - & literal \\
- sub-range-marker & .. & literal \\\midrule
+ sub-range-marker & .. & literal \\
+ sub-only & & boolean \\\midrule
list-delim$^\mathrm{a}$ & () & literal \\
list-odelim & & literal \\
list-cdelim & & literal \\
@@ -812,7 +830,7 @@ In this section all keys are listed. Please be aware that the default values of
\hspace*{1em}
\begin{tabular}{>{\footnotesize}r>{\footnotesize\raggedright}p{.3\linewidth}}
a & value needs \emph{two} tokens. \tabularnewline
- b & input is a comma separated list, see p. \pageref{key:sub-list}. \tabularnewline
+ b & input is a comma separated list, see p.\,\pageref{key:sub-list}. \tabularnewline
c & depends on the value of \lstinline=list-lang=.
\end{tabular}
\end{center}