summaryrefslogtreecommitdiff
path: root/Master/texmf-dist
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r--Master/texmf-dist/doc/latex/chemnum/README12
-rw-r--r--Master/texmf-dist/doc/latex/chemnum/chemnum_de.pdfbin944596 -> 668691 bytes
-rw-r--r--Master/texmf-dist/doc/latex/chemnum/chemnum_de.tex66
-rw-r--r--Master/texmf-dist/doc/latex/chemnum/chemnum_en.pdfbin934698 -> 660727 bytes
-rw-r--r--Master/texmf-dist/doc/latex/chemnum/chemnum_en.tex70
-rw-r--r--Master/texmf-dist/doc/latex/chemnum/chemnum_it.pdfbin0 -> 661439 bytes
-rw-r--r--Master/texmf-dist/doc/latex/chemnum/chemnum_it.tex1325
-rw-r--r--Master/texmf-dist/tex/latex/chemnum/chemnum.sty66
8 files changed, 1428 insertions, 111 deletions
diff --git a/Master/texmf-dist/doc/latex/chemnum/README b/Master/texmf-dist/doc/latex/chemnum/README
index 05b3daf261d..8a12caaa60f 100644
--- a/Master/texmf-dist/doc/latex/chemnum/README
+++ b/Master/texmf-dist/doc/latex/chemnum/README
@@ -1,4 +1,4 @@
-chemnum v0.5e
+chemnum v0.5f
a comprehensive approach for the numbering of chemical compounds
Basically one main command is provided, \cmpd{<label name>}. With
@@ -12,7 +12,7 @@ chemnum also needs the packages etoolbox, psfrag and textgreek or bm
to be fully functioning.
Clemens NIEDERBERGER
-2012/09/17
+2012/12/29
http://www.mychemistry.eu/
contact@mychemistry.eu
@@ -34,6 +34,8 @@ This work has the LPPL maintenance status `maintained'.
The Current Maintainer of this work is Clemens Niederberger.
-This work consists of the files chemnum.sty, chemnum_de.tex, chemnum_en.tex,
-scheme-tmp.ps, scheme-bla.ps, README and the derived files chemnum_de.pdf and
-chemnum_en.pdf \ No newline at end of file
+This work consists of the files
+ chemnum.sty, chemnum_de.tex, chemnum_en.tex, chemnum_it.tex
+ scheme-tmp.ps, scheme-bla.ps,
+ README
+ chemnum_de.pdf, chemnum_en.pdf, chemnum_it.pdf \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/chemnum/chemnum_de.pdf b/Master/texmf-dist/doc/latex/chemnum/chemnum_de.pdf
index 0d26ef5ab06..5cedb60d088 100644
--- a/Master/texmf-dist/doc/latex/chemnum/chemnum_de.pdf
+++ b/Master/texmf-dist/doc/latex/chemnum/chemnum_de.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/chemnum/chemnum_de.tex b/Master/texmf-dist/doc/latex/chemnum/chemnum_de.tex
index b28cc59db17..16b753c1883 100644
--- a/Master/texmf-dist/doc/latex/chemnum/chemnum_de.tex
+++ b/Master/texmf-dist/doc/latex/chemnum/chemnum_de.tex
@@ -27,15 +27,19 @@
% -
% - The Current Maintainer of this work is Clemens Niederberger.
% -
-% - This work consists of the files chemnum.sty, chemnum_de.tex, chemnum_en.tex,
-% - chemnum-codehelper.tex, scheme-tmp.eps, scheme-bla.eps, README and the
-% - derived files chemnum_de.pdf and chemnum_en.pdf
+% - This work consists of the files
+% - chemnum.sty, chemnum_de.tex, chemnum_en.tex, chemnum_it.tex
+% - scheme-tmp.ps, scheme-bla.ps,
+% - README
+% - chemnum_de.pdf, chemnum_en.pdf, chemnum_it.pdf
% -
% - in order to compile this document you need the class `cnpkgdoc' with is
% - available under the LPPL here: https://bitbucket.org/cgnieder/cnpkgdoc/
% -
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\RequirePackage[textgreek]{chemnum}
+\RequirePackage[german,naustrian,austrian,english,british,american,canadian,frenchb,
+ canadien,spanish,italian,ngerman]{babel}
+\RequirePackage[textgreek=artemisia]{chemnum}
\documentclass[DIV11,toc=index]{cnpkgdoc}
\docsetup{
pkg = chemnum,
@@ -52,9 +56,9 @@
setdoublesep,section,sf,subsection,subsubsection,tableofcontents,
texorpdfstring,textcolor,theffbibliography,uline}
-\usepackage[german,naustrian,austrian,english,british,american,canadian,frenchb,canadien,spanish,italian,ngerman]{babel}
\usepackage{textcomp,longtable,tabu,booktabs,chemscheme,hologo}
\usepackage[iupac=strict]{chemmacros}
+\chemsetup[chemformula]{format=\libertineLF}
\usepackage{chemfig}
\usepackage[runs=2]{auto-pst-pdf}
@@ -76,7 +80,6 @@
\let\name\textsc
\let\CNversion\cnpkgdocpkgversion
\let\CNdate\cnpkgdocpkgdate
-\def\Wikipedia{\textup{\libertineGlyph{W.alt}}\kern-.8pt\textsc{ikipedia}}
\cmpdinit*{a,aa,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,benzene,r,s,t,{1,3-dichlorocyclohexanole}}
@@ -116,7 +119,7 @@ ist Teil des \paket{l3packages}-Bundles, \paket*{expl3} ist Teil des
\chemnum benötigt außerdem die Pakete \paket{etoolbox} und \paket{psfrag} und
entweder das Paket \paket{textgreek} oder das Paket \paket{bm}, abhängig von den
-Paketoptionen (siehe Abschnitt~\ref{sec:package_options}).
+Paketoptionen (siehe Abschnitt~\ref{sec:package:options}).
\section{Neues und ein Wort der Entschuldigung}
\subsection{Version 0.4}
@@ -169,15 +172,15 @@ siehe S.\,\pageref{ssec:marker_in_bildern}.
\achtung{Die Reihenfolge der optionalen Argumente des Befehls \cmd{cmpdref} hat
sich geändert, siehe S.\,\pageref{ssec:cmpdref}!}
-\section{Paketoptionen}\label{sec:package_options}\secidx{Paketoptionen}
+\section{Paketoptionen}\label{sec:package:options}\secidx{Paketoptionen}
\chemnum hat eine Paketoption.
\begin{beschreibung}
\Option{textgreek}{artemisia/\default{cbgreek}/euler/false} Default: \code{false}
\end{beschreibung}
Damit können Sie sowohl einen der drei Stile des \paket{textgreek}-Pakets wählen\footnote{Zu
Details siehe Dokumentation des \paket*{textgreek}-Pakets.} oder \chemnum ohne
-\paket{textgreek} laden. Dieses Dokument wurde mit \verb+\usepackage[textgreek]{chemnum}+
-gesetzt.
+\paket{textgreek} laden. Dieses Dokument wurde mit
+\verb+\usepackage[textgreek=artemisia]{chemnum}+ gesetzt.
\secidx*{Paketoptionen}
\section{Motivation}
@@ -603,10 +606,10 @@ deklariert sondern nur referenziert und ausgegeben wird. Damit man also
worden sein. \cmd[cmpdb]{cmpd+} ist nützlich, wenn ein Label in einem beweglichen
Argument wie in \verb=\section{}= eingesetzt werden soll.
-\achtung{Er wird nicht benötigt, wenn} \cmd{cmpdinit} \textbf{verwendet wird, siehe
+\achtung{Er wird nicht benötigt, wenn \cmd{cmpdinit} verwendet wird, siehe
Abschnitt~\ref{sec:cmpdinit} (S.\,\pageref{sec:cmpdinit}ff).}
-\begin{beispiel}
+\begin{beispiel}[code only]
\subsubsection{Test-\"Uberschrift mit Verbindungslabel \cmpd+[cmpd-delim]{f.one}}
% mit hyperref:
\subsubsection{Test-\"Uberschrift mit Verbindungslabel \texorpdfstring{\cmpd+[cmpd-delim]{f.two}}{(7b)}}
@@ -751,9 +754,9 @@ folgenden Keys erfolgen.
Mit \key{hyper-target} kann man ein Ziel festsetzen. \textbf{Achtung}: wenn Sie
diesen Key mit einer Liste einsetzen, dann erhält \emph{jedes} Label den gleichen
Linkzielnamen und \paket{hyperref} wird eine Warnung
-\begin{mdframed}\ttfamily
- destination with the same identifier (name\{<link name>\}) has been already used,
- duplicate ignored
+\begin{mdframed}\ttfamily\small
+ destination with the same identifier (name\{<link name>\}) has been already
+ used, duplicate ignored
\end{mdframed}
ausgeben.
@@ -767,8 +770,9 @@ Label auf das gleiche Ziel verweisen.
Wenn Sie \key{hyper-link} einsetzen, ohne das entsprechende \key{hyper-target}
festgelegt zu haben, dann wird \paket{hyperref} eine Warnung
-\begin{mdframed}\ttfamily
- name\{<link name>\} has been referenced but does not exist, replaced by a fixed one
+\begin{mdframed}\ttfamily\small
+ name\{<link name>\} has been referenced but does not exist, replaced by a
+ fixed one
\end{mdframed}
ausgeben.
\secidx*{Verwendung mit \textsf{hyperref}}[Verwendung mit hyperref]
@@ -977,9 +981,10 @@ geändert werden.
\subsubsection{Bei Labeln -- Eingabe}\label{sssec:sub-input-sep}\index{Trennzeichen!Label!Input}
Als Voreinstellung verwendet \chemnum den Punkt \code{.} als Zeichen, um
Hauptlabelnamen von Sublabelnamen zu unterscheiden. Sie können das Symbol nach
-Belieben ändern. Die Zeichen \verb=% #= können Sie nicht verwenden und \verb=@=
-sollten Sie nicht verwenden. Außerdem sollten Sie darauf achten, für die anderen
-Trennsymbole (siehe folgende Abschnitte) nicht die gleichen Zeichen zu verwenden.
+Belieben ändern. Die Zeichen \verb=%=, \verb=,= und \verb=#= können Sie nicht
+verwenden und \verb=@= sollten Sie nicht verwenden. Außerdem sollten Sie darauf
+achten, für die anderen Trennsymbole (siehe folgende Abschnitte) nicht die
+gleichen Zeichen zu verwenden.
\begin{beschreibung}
\option{sub-input-sep}{<separator>} Default = \code{.}
\end{beschreibung}
@@ -1014,9 +1019,9 @@ Das erscheint dann zwischen Hauptlabel und Sublabel.
\subsubsection{Bei Sublabeln -- Eingabe}\label{sssec:range-input-sep}\index{Trennzeichen!Sublabel!Input}
Für die Eingabe eines Bereiches von Sublabeln verwendet \chemnum in der Voreinstellung
zwei Punkte \code{..}. Sie können aber eine beliebige andere Eingabe wählen. Die
-Zeichen \verb=% #= können Sie nicht verwenden und \verb=@= sollten Sie nicht
-verwenden. Außerdem sollten Sie darauf achten, für die anderen Trennsymbole nicht
-die gleichen Zeichen zu verwenden.
+Zeichen \verb=%=, \verb=,= und \verb=#= können Sie nicht verwenden und
+\verb=@= sollten Sie nicht verwenden. Außerdem sollten Sie darauf achten, für
+die anderen Trennsymbole nicht die gleichen Zeichen zu verwenden.
\begin{beschreibung}
\option{subrange-input-sep}{<separator>} Default = \code{..}
\end{beschreibung}
@@ -1041,9 +1046,9 @@ Bereich anders darstellen? Das geht mit dieser Option:
\subsubsection{Bei Listen -- Eingabe}\label{sssec:list-input-sep}\index{Trennzeichen!Listen!Input}
Wenn Sie mögen, können Sie das Trennsymbol der Listen-Eingabe ändern. Per Default
wird hier das Komma \code{,} verwendet. Sie können aber eine beliebige andere
-Eingabe wählen. Die Zeichen \verb=% #= können Sie nicht verwenden und \verb=@=
-sollten Sie nicht verwenden. Außerdem sollten Sie darauf achten, für die anderen
-Trennsymbole nicht die gleichen Zeichen zu verwenden.
+Eingabe wählen. Die Zeichen \verb=%=, \verb=,= und \verb=#= können Sie nicht
+verwenden und \verb=@= sollten Sie nicht verwenden. Außerdem sollten Sie darauf
+achten, für die anderen Trennsymbole nicht die gleichen Zeichen zu verwenden.
\begin{beschreibung}
\option{list-input-sep}{<separator>} Default = \code{,}
\option{sub-input-sep}{<separator>} Default = \code{,}
@@ -1118,8 +1123,8 @@ Eine spezielle Option ist \key{list-last-sep}{empty}. Wird er verwendet, wird
\subsubsection{Bei \code{\textbackslash\textcolor{code}{cmpdinit}} -- Eingabe}\label{sssec:init-input-sep}\index{Trennzeichen!cmpdinit@\textcolor{code}{\code{\textbackslash cmpdinit}}}
Wenn Sie mögen, können Sie das Trennsymbol der Listen-Eingabe ändern. Per Default
wird hier das Komma \code{,} verwendet. Sie können aber eine beliebige andere
-Eingabe wählen. Die Zeichen \verb=% #= können Sie nicht verwenden und \verb=@=
-sollten Sie nicht verwenden.
+Eingabe wählen. Die Zeichen \verb=%=, \verb=,= und \verb=#= können Sie nicht
+verwenden und \verb=@= sollten Sie nicht verwenden.
\begin{beschreibung}
\option{init-input-sep}{<separator>} Default = \code{,}
\end{beschreibung}
@@ -1168,7 +1173,7 @@ werde sie gerne hinzufügen.
Im US-Amerikanischen ist die Verwendung des sogenannten Harvard- oder Oxford-Kommas
weit verbreitet, im Britischen und in anderen europäischen Sprachen ist sie eher
unüblich.
-\begin{zitat}[\href{http://en.wikipedia.org/wiki/Serial_comma}{\protect\Wikipedia}, 2011/11/07]
+\begin{zitat}[\href{http://en.wikipedia.org/wiki/Serial_comma}{Wikipedia}, 2011/11/07]
The serial comma (also known as the Oxford comma or Harvard comma, and sometimes
referred to as the series comma) is the comma used immediately before a coordinating
conjunction (usually and or or, and sometimes nor) preceding the final item in
@@ -1298,6 +1303,9 @@ aufgelistet.
Ich möchte Joseph \name{Wright} und Russell \name{Hewitt} danken, die mir wertvolle
Vorschläge und Feedback gaben, um \chemnum zu verbessern.
+Vielen Dank außerdem an Jonas \name{Rivetti}, der die italienische Übersetzung
+beigesteuert hat.
+
\printindex
\end{document} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/chemnum/chemnum_en.pdf b/Master/texmf-dist/doc/latex/chemnum/chemnum_en.pdf
index ed0609e1a49..a44dae36611 100644
--- a/Master/texmf-dist/doc/latex/chemnum/chemnum_en.pdf
+++ b/Master/texmf-dist/doc/latex/chemnum/chemnum_en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/chemnum/chemnum_en.tex b/Master/texmf-dist/doc/latex/chemnum/chemnum_en.tex
index 61e4700dcf8..5960757a3bd 100644
--- a/Master/texmf-dist/doc/latex/chemnum/chemnum_en.tex
+++ b/Master/texmf-dist/doc/latex/chemnum/chemnum_en.tex
@@ -27,15 +27,19 @@
% -
% - The Current Maintainer of this work is Clemens Niederberger.
% -
-% - This work consists of the files chemnum.sty, chemnum_de.tex, chemnum_en.tex,
-% - chemnum-codehelper.tex, scheme-tmp.eps, scheme-bla.eps, README and the
-% - derived files chemnum_de.pdf and chemnum_en.pdf
+% - This work consists of the files
+% - chemnum.sty, chemnum_de.tex, chemnum_en.tex, chemnum_it.tex
+% - scheme-tmp.ps, scheme-bla.ps,
+% - README
+% - chemnum_de.pdf, chemnum_en.pdf, chemnum_it.pdf
% -
% - in order to compile this document you need the class `cnpkgdoc' with is
% - available under the LPPL here: https://bitbucket.org/cgnieder/cnpkgdoc/
% -
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\RequirePackage[textgreek]{chemnum}
+\RequirePackage[ngerman,german,naustrian,austrian,british,american,canadian,frenchb,
+ canadien,spanish,italian,english]{babel}
+\RequirePackage[textgreek=artemisia]{chemnum}
\documentclass[DIV11,toc=index]{cnpkgdoc}
\docsetup{
pkg = chemnum,
@@ -51,9 +55,9 @@
setdoublesep,section,sf,subsection,subsubsection,tableofcontents,
texorpdfstring,textcolor,theffbibliography,uline}
-\usepackage[ngerman,german,naustrian,austrian,british,american,canadian,frenchb,canadien,spanish,italian,english]{babel}
\usepackage{textcomp,longtable,tabu,booktabs,chemscheme,hologo}
\usepackage[iupac=strict]{chemmacros}
+\chemsetup[chemformula]{format=\libertineLF}
\usepackage{chemfig}
\usepackage[runs=2]{auto-pst-pdf}
@@ -75,7 +79,6 @@
\let\name\textsc
\let\CNversion\cnpkgdocpkgversion
\let\CNdate\cnpkgdocpkgdate
-\def\Wikipedia{\textup{\libertineGlyph{W.alt}}\kern-.8pt\textsc{ikipedia}}
\cmpdinit*{a,aa,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,benzene,r,s,t,{1,3-dichlorocyclohexanole}}
@@ -106,7 +109,7 @@
\selectlanguage{english}\cmpdreset
\section{A very short readme}
-\chemnum \CNversion\ underlies the \LaTeX\ Project Public License Version 1.3 or
+\chemnum \CNversion\ underlies the \LaTeX{} Project Public License Version~1.3 or
later. (\url{http://www.latex-project.org/lppl.txt})
\chemnum internally loads the packages \paket*{expl3} and \paket{xparse}.
@@ -114,7 +117,7 @@ later. (\url{http://www.latex-project.org/lppl.txt})
of the \paket{l3kernel} bundle. This means, \chemnum needs \LaTeX3 Support.
\chemnum also needs the packages \paket{etoolbox}, \paket{psfrag} and either
-\paket{textgreek} or \paket{bm}, see section~\ref{sec:package_options}.
+\paket{textgreek} or \paket{bm}, see section~\ref{sec:package:options}.
\section{News and a word of apology}
\subsection{Version 0.4}
@@ -169,12 +172,12 @@ internally, see p.\,\pageref{ssec:marker_in_bildern}.
\achtung{The optional arguments of \cmd{cmpdref} have changed their order, see
p.\,\pageref{ssec:cmpdref}!}
-\section{Package options}\label{sec:package_options}\secidx{Package options}
+\section{Package options}\label{sec:package:options}\secidx{Package options}
\chemnum has one package option.
\begin{beschreibung}
\Option{textgreek}{artemisia/\default{cbgreek}/euler/false} Default: \code{false}
\end{beschreibung}
-This document was set with \verb+\usepackage[textgreek]{chemnum}+.
+This document was set with \verb+\usepackage[textgreek=artemisia]{chemnum}+.
\secidx*{Package options}
\section{Motivation}
@@ -577,7 +580,7 @@ used inside a moving argument like in \verb=\section{}=.
\achtung{It is not needed when \cmd{cmpdinit} is used, see section~\ref{sec:cmpdinit}
(pages~\pageref{sec:cmpdinit}\,ff).}
-\begin{beispiel}
+\begin{beispiel}[code only]
\subsubsection{Test section title with compound label \cmpd+[cmpd-delim]{f.one}}
% with hyperref:
\subsubsection{Test section title with compound label \texorpdfstring{\cmpd+[cmpd-delim]{f.two}}{(7b)}}
@@ -715,9 +718,9 @@ a hyperlink in one or two places. This can be achieved with two options:
With \key{hyper-target} you can set the target. \textbf{Caution}: if you use this
option with a list \emph{every} label of the list will get the same link name and
\paket{hyperref} will warn you:
-\begin{mdframed}\ttfamily
- destination with the same identifier (name\{<link name>\}) has been already used,
- duplicate ignored
+\begin{mdframed}\ttfamily\small
+ destination with the same identifier (name\{<link name>\}) has been already
+ used, duplicate ignored
\end{mdframed}
\key{hyper-link} creates a link for the denominated target. \textbf{Caution}: if
@@ -730,9 +733,9 @@ same target.
If you use \key{hyper-link} without the corresponding \key{hyper-target}
\paket{hyperref} will issue a warning:
-\begin{mdframed}\ttfamily
- name\{<link name>\} has been referenced but does not exist, replaced by a fixed
- one
+\begin{mdframed}\ttfamily\small
+ name\{<link name>\} has been referenced but does not exist, replaced by a
+ fixed one
\end{mdframed}
\secidx*[Usage with hyperref]{Usage with \textsf{hyperref}}
@@ -929,8 +932,9 @@ It can be changed with
\subsubsection{Labels -- input}\label{sssec:sub-input-sep}\index{Separators!labels!input}
As a default setting \chemnum use the point \code{.} as a marker to separate main
labels from sublabels. You can change that as you like. Tokens you \emph{can't use}
-are \verb=, % #= and \emph{you shouldn't} use \verb=@=. Furthermore you should be
-careful to use different symbols for the other separators (see the next sections).
+are \verb=%=, \verb=,= and \verb=#= and \emph{you shouldn't} use \verb=@=. Furthermore
+you should be careful to use different symbols for the other separators (see the
+next sections).
\begin{beschreibung}
\option{sub-input-sep}{<separator>} Default = \code{.}
\end{beschreibung}
@@ -965,9 +969,9 @@ You can separate the labels from the sublabels if you like to.
\subsubsection{Sublabels -- input}\label{sssec:range-input-sep}\index{Separators!subabels!input}
As a default setting \chemnum use two points \code{..} as a marker to detect two
sublabels as end and beginning of a range. But you can choose any tokens you like
-to do that. Tokens you \emph{can't use} are \verb=, % #= and \emph{you shouldn't}
-use \verb=@=. Furthermore you should be careful to use different symbols for the
-other separators.
+to do that. Tokens you \emph{can't use} are \verb=%=, \verb=,= and \verb=#= and
+\emph{you shouldn't} use \verb=@=. Furthermore you should be careful to use different
+symbols for the other separators.
\begin{beschreibung}
\option{subrange-input-sep}{<separator>} Default = \code{..}
\end{beschreibung}
@@ -992,9 +996,9 @@ differently? Then you need this key:
\subsubsection{Lists -- input}\label{sssec:list-input-sep}\index{Separators!lists!input}
If you like you can change the list input separator for both main label lists and
lists of sublabels. In both cases \chemnum uses the comma \code{,} as default. You
-can change that as you like. Tokens you \emph{can't use} are \verb=, % #= and
-\emph{you shouldn't} use \verb=@=. Furthermore you should be careful to use
-different symbols for the other separators.
+can change that as you like. Tokens you \emph{can't use} are \verb=%=, \verb=,=
+and \verb=#= and \emph{you shouldn't} use \verb=@=. Furthermore you should be
+careful to use different symbols for the other separators.
\begin{beschreibung}
\option{list-input-sep}{<separator>} Default = \code{,}
\option{sub-input-sep}{<separator>} Default = \code{,}
@@ -1070,7 +1074,8 @@ with \key{list-output-sep} is used for the whole list.
When you've changed the separator for \cmd{cmpd} you might want to change it for
\cmd{cmpdinit} as well. \chemnum uses the comma in the default setting. You can
change that as you like. Sie können aber eine beliebige andere Eingabe wählen.
-Tokens you \emph{can't use} are \verb=, % #= and \emph{you shouldn't} use \verb=@=.
+Tokens you \emph{can't use} are \verb=%=, \verb=,= and \verb=#= and \emph{you
+shouldn't} use \verb=@=.
\begin{beschreibung}
\option{init-input-sep}{<separator>} Default = \code{,}
\end{beschreibung}
@@ -1091,11 +1096,10 @@ A small example how a customized input could look like:
\section{Language support}\label{sec:language_support}\secidx{Language support}
\subsection{Cooperation with \textsf{babel}}
\chemnum supports the language choice made with the \paket{babel} package for a
-number of languages. This is done with the \verb=\translate= command of the
-\paket*{translator} package, if it is available. If \paket*{translator} cannot
-be loaded, language support must be done manually, see section~\ref{sssec:last-sep}.
-Manual language settings can of course still be done if \paket*{translator} has
-been loaded.
+number of languages. This is done with the \verb=\GetTranslation= command of the
+\paket*{translations}\footnote{\paket*{translations} is part of the
+\paket*{exsheets} bundle.} package.
+
\begin{beispiel}
\selectlanguage{ngerman}DE: \cmpd{r,s,t}\\
\selectlanguage{english}EN: \cmpd{r,s,t}\\
@@ -1113,7 +1117,7 @@ gladly add it.
\subsection{Harvard comma}\label{ssec:harvard-comma}\secidx{Harvard comma}
In American English the so-called Harvard comma is quite commonly used. In British
English and other European languages it is rather uncommon.
-\begin{zitat}[\href{http://en.wikipedia.org/wiki/Serial_comma}{\protect\Wikipedia}, 2011/11/07]
+\begin{zitat}[\href{http://en.wikipedia.org/wiki/Serial_comma}{Wikipedia}, 2011/11/07]
The serial comma (also known as the Oxford comma or Harvard comma, and sometimes
referred to as the series comma) is the comma used immediately before a coordinating
conjunction (usually and or or, and sometimes nor) preceding the final item in a
@@ -1244,6 +1248,8 @@ listed.
I would like to thank Joseph \name{Wright} and Russell \name{Hewitt} who provided
me with valuable feedback and suggestions to improve \chemnum.
+Many thanks also to Jonas \name{Rivetti} who provided the Italian translation.
+
\printindex
\end{document} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/chemnum/chemnum_it.pdf b/Master/texmf-dist/doc/latex/chemnum/chemnum_it.pdf
new file mode 100644
index 00000000000..08610e236f0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/chemnum/chemnum_it.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/chemnum/chemnum_it.tex b/Master/texmf-dist/doc/latex/chemnum/chemnum_it.tex
new file mode 100644
index 00000000000..f158893ff84
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/chemnum/chemnum_it.tex
@@ -0,0 +1,1325 @@
+% arara: pdflatex: { shell: on }
+% arara: makeindex: { sort: true, style: chemnum_de.ist }
+% arara: pdflatex: { shell: on }
+% arara: pdflatex: { shell: on }
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% - chemnum - chemnum_it.tex
+% - a comprehensive approach for the numbering of chemical compounds
+% -----------------------------------------------------------------------------
+% - Clemens NIEDERBERGER
+% -
+% - contact@mychemistry.eu
+% -----------------------------------------------------------------------------
+% - If you have any ideas, questions, suggestions or bugs to report, please
+% - feel free to contact me.
+% -----------------------------------------------------------------------------
+% - Copyright 2011-2012 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.
+% -
+% - This work consists of the files
+% - chemnum.sty, chemnum_de.tex, chemnum_en.tex, chemnum_it.tex
+% - scheme-tmp.ps, scheme-bla.ps,
+% - README
+% - chemnum_de.pdf, chemnum_en.pdf, chemnum_it.pdf
+% -
+% - in order to compile this document you need the class `cnpkgdoc' with is
+% - available under the LPPL here: https://bitbucket.org/cgnieder/cnpkgdoc/
+% -
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\RequirePackage[german,naustrian,austrian,english,british,american,canadian,frenchb,
+ canadien,spanish,ngerman,italian]{babel}
+\RequirePackage[textgreek=artemisia]{chemnum}
+\documentclass[DIV11,toc=index]{cnpkgdoc}
+\docsetup{
+ pkg = chemnum,
+ language = it,
+ code-box = {skipabove=1ex,skipbelow=1ex}
+}
+\usepackage{fnpct}
+\addcmds{
+ @m,arrow,bf,ch,chemfig,chemname,cmpd,cmpdinit,cmpdref,cmpdreset,cmpdsetup,
+ CNlabel,CNlabelnoref,CNref,CNlabelsub,CNlabelsubnoref,CNrefsub,
+ color,compound,compoundprefix,compoundsuffix,declarecompound,fcite,
+ includegraphics,jobname,midrule,penalty,psfrag,renewcommand,schemename,
+ schemestart,schemestop,selectlanguage,setarrowoffset,setatomsep,setcompoundsep,
+ setdoublesep,section,sf,subsection,subsubsection,tableofcontents,
+ texorpdfstring,textcolor,theffbibliography,uline}
+
+\usepackage{textcomp,longtable,tabu,booktabs,chemscheme,hologo}
+\usepackage[iupac=strict]{chemmacros}
+\chemsetup[chemformula]{format=\libertineLF}
+\usepackage{chemfig}
+\usepackage[runs=2]{auto-pst-pdf}
+
+\usepackage{filecontents}
+\begin{filecontents*}{\jobname.ist}
+ preamble "\\begin{theindex}\n I titoli di paragrafo sono resi in \\textbf{nero},
+ i pacchetti \\textsf{senza grazie}, i comandi in \\textcolor{code}{marrone} e
+ le chiavi in \\textcolor{key}{verde}.\\newline\n\n"
+ heading_prefix "{\\bfseries "
+ heading_suffix "\\hfil}\\nopagebreak\n" %FIXME? hfil oder hfill? spielt keine große Rolle wenn \hfil funktioniert
+ headings_flag 1
+ delim_0 "\\dotfill "
+ delim_1 "\\dotfill "
+ delim_2 "\\dotfill "
+ delim_r "--"
+ suffix_2p "\\nohyperpage{\\,s.}"
+ suffix_3p "\\nohyperpage{\\,ss.}"
+\end{filecontents*}
+
+\let\prog\textsc
+\let\name\textsc
+\let\CNversion\cnpkgdocpkgversion
+\let\CNdate\cnpkgdocpkgdate
+
+\cmpdinit*{a,aa,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,benzene,r,s,t,{1,3-dichlorocyclohexanole}}
+
+\TitlePicture{%
+ \selectlanguage{ngerman}
+ \cmpdinit*{glucose.alpha, glucose.beta, glucose.chain}
+ \cmpd*[sub-counter = greek]{glucose.alpha, glucose.beta}\cmpd*{glucose.chain}
+ \setatomsep{2em}
+ \definesubmol{x}{(-[4]H)(-[0]OH)}
+ \definesubmol{y}{(-[0]H)(-[4]HO)}
+ \begin{scheme}[h]
+ \centering\small
+ \schemestart
+ \chemfig{?(-[:-170]HO)-[:-50](-[:170]HO)-[:10](-[:-55,0.7]OH)-[:-10](-[6,0.8]OH)-[:130]O-[:-170]?(-[:150,0.7]-[2,0.7]OH)}
+ \arrow(alpha--chain){<=>}
+ \chemfig{[2]OH-[3]-!x-!x-!y-!x-=[1]O}
+ \arrow(--beta){<=>}
+ \chemfig{?(-[:-170]HO)-[:-50](-[:170]HO)-[:10](-[:-55,0.7]OH)-[:-10](-[:10]OH)(-[6,,,,draw=none]\vphantom{OH})-[:130]O-[:-170]?(-[:150,0.7]-[2,0.7]OH)}
+ \arrow(@chain--chainlabel){0}[-90,.2] \normalsize\cmpd[cmpd-delim]{glucose.chain}
+ \arrow(@chainlabel--){0}[,2.5] \normalsize\cmpd[cmpd-delim]{glucose.beta}
+ \arrow(@chainlabel--){0}[180,2.3] \normalsize\cmpd[cmpd-delim]{glucose.alpha}
+ \schemestop
+ \caption{L'anomero \a e l'anomero \b del \D-glucosio \cmpd[list-delim,list-lang=IT]{glucose.alpha,glucose.beta} in soluzione sono in equilibrio attraverso la forma a catena aperta \cmpd[cmpd-delim]{glucose.chain}.}
+ \end{scheme}}
+
+\newcommand{\pes}{p.\,es.\ }
+
+\makeindex
+\begin{document}
+\selectlanguage{italian}\cmpdreset
+
+\section{Un Leggimi molto breve}
+\chemnum \CNversion\ è pubblicato sotto la \LaTeX{} Project Public License
+versione~1.3 o successive. (\url{http://www.latex-project.org/lppl.txt})
+
+Internamente \chemnum richiama i pacchetti \paket*{expl3} e \paket{xparse}.
+\paket{xparse} fa parte del bundle \paket{l3packages}, \paket*{expl3} fa parte
+del bundle \paket{l3kernel}; ciò significa che \chemnum richiede il supporto di
+\LaTeX3.
+
+\chemnum richiede inoltre i pacchetti \paket{etoolbox} e \paket{psfrag} e a
+seconda delle opzioni globali di pacchetto\footnote{d'ora in poi chiamate
+<<opzioni globali>>} impostate alternativamente uno tra i pacchetti
+\paket{textgreek} o \paket{bm} (vedi il paragrafo~\ref{sec:package:options}).
+
+\section{Novità e le mie scuse}
+\subsection{Versione 0.4}
+Con l'aggiornamento alla v0.4 vi sono stati alcuni cambiamenti riguardanti le
+opzioni. Se ne sono aggiunte alcune nuove, e alcune delle preesistenti hanno
+variato nome: ho riassegnato dei nomi tra di loro più consistenti, che a mio
+parere rispecchiano la loro funzione in modo più intuitivo. Per questo motivo
+può accadere che alcuni documenti creati con una versione precedente di \chemnum
+non si lascino più compilare correttamente; di questo vorrei scusarmi. \chemnum
+si trova ancora in fase di sviluppo; quando sarà raggiunta la v1.0, non avverranno
+più\footnote{o solo in casi eccezionali} cambiamenti di questo tipo.
+
+Le opzioni seguenti hanno dei nomi nuovi:
+\begin{center}
+ \begin{tabular}{ll}\toprule
+ \bfseries nome vecchio & \bfseries nome nuovo \\\midrule
+ \key{cmpd-sep} & \key{sub-output-sep} \\
+ \key{sub-marker} & \key{sub-input-sep} \\
+ \key{sub-range-sep} & \key{subrange-output-sep} \\
+ \key{sub-range-marker} & \key{subrange-input-sep} \\
+ \key{strict} & \key{init-strict} \\
+ \key{sub-init} & \key{init-sub} \\\bottomrule
+ \end{tabular}
+\end{center}
+Queste opzioni sono nuove:
+\begin{center}
+ \begin{tabular}{ll}\toprule
+ \bfseries opzione & \bfseries descrizione \\\midrule
+ \key{sublist-output-sep} & Simboli di elenco nelle etichette come
+ \cmpd{bsp.{one,two}}, vedi a pagina~\pageref{sssec:list-output-sep}. \\
+ \key{sublist-input-sep} & Input di etichette come \cmpd{bsp.{one,two}}, vedi
+ a pagina~\pageref{sssec:list-input-sep}. \\
+ \key{init-input-sep} & Input con \cmd{cmpdinit}, vedi a
+ pagina~\pageref{sssec:init-input-sep}. \\
+ \key{hyper-use} & Impiego di hyperlink, vedi a pagina~\pageref{sec:hyperref}. \\
+ \key{hyper-target} & \\
+ \key{hyper-link} & \\
+ \key{ref-style} & Rappresentazione delle etichette con \cmd{cmpdref},
+ vedi le pagine~\pageref{ssec:cmpdref} e~\pageref{ssec:schriftstil}. \\\bottomrule
+ \end{tabular}
+\end{center}
+
+È nuovo anche il modo di inserire elenchi e intervalli di subetichette; per questo
+motivo l'opzione \key{sub-list} scompare. Per i dettagli si veda il
+paragrafo~\ref{ssec:sub_ranges}.
+
+Inoltre è possibile generare dei collegamenti ipertestuali alle etichette, ammesso
+che venga caricato \paket{hyperref} (vedi il paragrafo~\ref{sec:hyperref}).
+
+\subsection{Versione 0.5}
+Dalla v0.5 esiste l'opzione \key{ref-pos} che permette di modificare le opzioni
+di posizionamento del comando \cmd{psfrag}, utilizzato internamente da
+\cmd{cmpdref} (vedi a pagina~\pageref{ssec:marker_in_bildern}).
+
+\achtung{L'ordine degli argomenti opzionali del comando \cmd{cmpdref} è variato
+(vedi a pagina~\pageref{ssec:cmpdref}!}
+
+\section{Opzioni globali}\label{sec:package:options}\secidx{opzioni globali}
+\chemnum ha un'opzione globale
+\begin{beschreibung}
+ \Option{textgreek}{artemisia/\default{cbgreek}/euler/false} Default: \code{false}
+\end{beschreibung}
+Con questa opzione si può selezionare uno dei tre stili del pacchetto
+\paket{textgreek}\footnote{Per i dettagli si rimanda alla documentazione del
+pacchetto \paket*{textgreek}.} o caricare \chemnum senza \paket{textgreek}.
+Questo documento è stato compilato con \verb+\usepackage[textgreek=artemisia]{chemnum}+.
+\secidx*{opzioni globali}
+
+\section{Motivazione}
+Finora per la numerazione di composti era possibile impiegare tre pacchetti (di
+mia conoscenza), ciascuno con i suoi difetti e le sue debolezze.
+
+Il primo, \paket{chemcono}, a questo scopo ridefinisce comandi bibliografici; i
+composti debbono essere definiti in una sorta di elenco di letteratura, alla quale
+si può fare riferimento nel testo. Dato che la ``biblioteca di composti'' viene
+sempre stampata, l'autore del pacchetto suggerisce il seguente:
+\begin{zitat}[Stefan Schulz]
+ After compilation and printout, discard the last page.
+\end{zitat}
+Ovviamente non si tratta di una soluzione ottimale.
+
+Il secondo, \paket{chemcompounds}, è stato creato perché l'autore del pacchetto
+voleva fare a meno dei difetti di \paket{chemcono}. Creando il pacchetto si è
+attenuto allo stesso meccanismo fondamentale di \paket{chemcono}.
+\begin{zitat}[Stephan Schenk]
+ When taking a closer look at the chemcono package, I realised that the only
+ thing one has to do is to get rid of everything which produces text. Thus, as a
+ basis I used the mechanism of \verb=\bibitem= and \verb=\cite= in pretty much
+ the same way as \paket{chemcono} does by extracting the corresponding code from
+ \verb=article.cls= and \verb=latex.ltx= but deleting any unnecessary commands
+ producing output. I also introduced several lines of code to make the printing
+ of the compound names more customisable.
+\end{zitat}
+Anche questo pacchetto ha le sue debolezze:
+\begin{enumerate}
+ \item I composti solitamente devono essere dichiarati con \verb=\declarecompound=,
+ certamente se si vogliono etichette del tipo di \cmpd{bsp.one}; in questo caso
+ è necessario impostare manualmente le etichette, cosa che fa perdere il senso
+ di una numerazione automatica.
+ \item Il layout non può essere adattato invidualmente, bensì solo globalmente
+ per tutte le etichette.
+ \item La numerazione non può essere azzerata. Sebbene nella maggioranza dei casi
+ ciò \emph{non è né necessario né consigliabile}, possono esserci dei casi
+ particolari in cui si desidera un comportamento di questo tipo.
+ \item Un elenco di più composti \verb=\compound{a,b,c}= non può essere adattata
+ o solo con grande difficoltà.
+\end{enumerate}
+
+Esiste inoltre \paket{bpchem}, che fornisce comandi simili a \verb=\label= e
+\verb=\ref=: \verb=\CNlabel{}=, \verb=\CNlabelnoref{}= e \verb=\CNref{}=. Inoltre
+aggiunge dei comandi per le subetichette: \verb=\CNlabelsub{}{}=,
+\verb=\CNlabelsubnoref{}{}= e \verb=\CNrefsub{}{}=. È quindi più flessibile degli
+altri; tuttavia non fornisce quasi nessuna modalità di personalizzazione, non
+permette gli elenchi e la presenza di comandi diversi per etichette ed etichette
+con subetichette non è una soluzione ottimale.
+
+\chemnum cerca di superare queste debolezze, e per questa ragione tutti i comandi
+sono stati interamente riscritti. Sono state tuttavia adottate alcune idee di
+\paket{chemcompounds} per le possibilità di rappresentazione, come i delimitatori
+ecc. % FIXME: DEFINIERE \ecc ! \newcommand{\ecc}{ecc.\ }
+% Wenn es Deiner Meinung nach sinnvoll ist, \ecc zu definieren, füge es einfach
+% ein
+
+Se vi dovessero mancare alcune funzionalità, vi prego di comunicarmelo inviandomi
+un'e-mail.
+
+\section{Numerare i composti}\label{sec:nummerieren}
+\subsection{Comando di base}\secidx{comando di base}\cmpdreset
+Il comando fondamentale del pacchetto è
+\begin{beschreibung}
+ \Befehl{cmpd}{<label name>}
+\end{beschreibung}
+Alla primo richiamo con \code{<label name>} l'etichetta viene generata e salvata
+(= dichiarata) e restituita. Ad ogni successiva chiamata viene impiegata questa
+etichetta.
+
+\begin{beispiel}
+ I composti \cmpd{a} e \cmpd{b} vengono dichiarati e d'ora in poi
+ possono essere richiamati in qualunque momento: \cmpd{a}. Non \`e
+ necessaria nessuna dichiarazione precedente. I composti come \cmpd{c}
+ vengono numerati nell'ordine della loro prima comparsa nel testo.\par
+ Ancora una volta: \cmpd{b}, \cmpd{a}, \cmpd{c}.
+\end{beispiel}
+
+Quando dovesse essere necessario dichiarare un composto senza restituirne
+l'etichetta nel testo, nel punto corrispondente si può usare
+\begin{beschreibung}
+ \Befehl[cmpda]{cmpd*}\ma{<label name>}\label{cmd:unsichtbares_label}
+\end{beschreibung}
+In questo modo viene dichiarata un'etichetta invisibile che non viene restituita.
+
+\achtung{Questo comando non è necessario quando si impiega \cmd{cmpdinit} (vedi
+paragrafo~\ref{sec:cmpdinit}, a pagina~\pageref{sec:cmpdinit}ss).}
+
+\begin{beispiel}
+ La versione nascosta \cmpd*{d} genera l'etichetta senza restituirla.
+ Il prossimo \cmpd{e} prosegue con la numerazione. Attraverso \cmpd{d}
+ \`e possibile richiamare l'etichetta invisibile generata.
+\end{beispiel}
+
+Come nomi delle etichette è possibile utilizzare un testo arbitrario, ad eccezione
+dei simboli usati come separatori (vedi i sottoparagrafi~\ref{ssec:unterlabel},
+\ref{ssec:listen}, \ref{ssec:sub_ranges} e~\ref{ssec:trenner}). Si consiglia di
+non utilizzare spazi all'interno dell'etichetta: questo non genera degli errori,
+ma potrebbe assegnare lo stesso numero ad etichette diverse.
+
+\lstset{showspaces=true}
+\begin{beispiel}
+ \cmpd{aa }, \cmpd{a a }, \cmpd{a a}, \cmpd{ a a}, \cmpd{ aa} e
+ \cmpd{ aa } generano tutti la stessa etichetta; come anche \cmpd{aa },
+ \cmpd{a a}, \cmpd{ aa} e \cmpd{aa}.
+\end{beispiel}
+\lstset{showspaces=false}\secidx*{comando di base}
+
+\subsection{Subetichette}\label{ssec:unterlabel}\secidx{subetichette}
+Quando si vogliono usare etichette con la forma \cmpd{a.one} lo si può ottenere
+con la sintassi seguente:
+\begin{beschreibung}
+ \Befehl{cmpd}{<label name>.<subname>}
+\end{beschreibung}
+\code{<label name>} deve rimanere invariato, mentre \code{<subname>} cambia. Questa
+sintassi significa che il punto \code{.} non deve fare parte né di \code{<label name>}
+né di \code{<subname>}. Al posto del punto è possibile utilizzare anche un separatore
+diverso (vedi il sottosottoparagrafo~\ref{sssec:sub-input-sep}).
+\begin{beispiel}
+ \cmpd{f.one} e \cmpd{f.two} sono tra loro molto simili, altrettanto
+ vale per \cmpd{g.one} e \cmpd{g.two}. Naturalmente l'etichetta rimane
+ uguale anche se richiamata pi\`u avanti: \cmpd{g.two} e \cmpd{f.one}.
+\end{beispiel}
+
+Questa sintassi funziona anche se il nome principale è stato già assegnato.
+\begin{beispiel}
+ \cmpd{a} e le sue varianti \cmpd{a.one} e \cmpd{a.two}
+\end{beispiel}
+
+Può anche essere richiamato individualmente il nome principale di etichette
+assegnate in modo combinato.
+\begin{beispiel}
+ \cmpd{f} und \cmpd{g}
+\end{beispiel}
+
+Come generare un'etichetta del tipo di \cmpd{f.{one,two}} viene spiegato nel
+sottoparagrafo~\ref{ssec:sub_ranges}.
+\secidx*{subetichette}
+
+\subsection{Elenchi}\label{ssec:listen}\secidx{elenchi}
+In realtà il comando non è stato descritto copmletamente; difatti può essere
+utilizzato anche per più di un'etichetta per volta.
+
+La descrizione corretta del comando dovrebbe essere quindi:
+\begin{beschreibung}
+ \Befehl{cmpd}{<(possibly comma separated list of) label name(s)>}
+\end{beschreibung}
+Questo significa che predefinitamente la virgola non può fare parte del nome
+dell'etichetta, se non nascosta tra parentesi graffe. Ciò può essere modificato
+(vedi sottosottoparagrafo~\ref{sssec:list-input-sep} a
+pagina~\pageref{sssec:list-input-sep}).
+
+\begin{beispiel}
+ Pi\`u etichette possono essere inseriti separati da virgole. In questo caso viene
+ restituita un elenco come \cmpd{a, b, c, e, g.two}.
+\end{beispiel}
+\secidx*{elenchi}
+
+\subsection{Elenchi e intervalli di subetichette}\label{ssec:sub_ranges}\index{subetichette!elenchi}\index{subetichette!intervalli}
+Talvolta può risultare utile o desiderabile riportare un'etichetta con un
+intervallo di subetichette. Supponiamo di avere i composti
+\cmpd{q.one,q.two,q.three,q.four,q.five}, che si distinguono \pes attraverso i
+sostituenti. Talvolta si desidera riferirsi a tutti i composti: \cmpd[cmpd-all]{q}.
+
+Il principio è abbastanza intuitivo -- basta indicare un elenco di subetichette:
+\begin{beispiel}
+ elenco di subetichette: \cmpd{q.one, q.two, q.three, q.four, q.five}\\
+ etichetta con elenco di subetichette: \cmpd{q.{one,two,three,four,five}}
+\end{beispiel}
+Dato che il subelenco per impostazione predefinita viene inserito con una virgola,
+è necessario indicare il subelenco tra parentesi graffe.
+
+In questo modo è possibile rappresentare anche intervalli di subetichette. Come
+marcatore tra i nomi delle subetichette vengono impiegati due punti \verb=..= .
+\begin{beispiel}
+ \cmpd{q.{two..four}}\\
+ \cmpd{q.{one,three..five}}\\
+ \cmpd{q.{one..three,five}}
+\end{beispiel}
+
+Come impostazione predefinita nell'input dei nomi di subetichette non sono disponibili
+né la virgola ne i due punti consecutivi. Per poterli impiegare nuovamente, utilizzando
+altri simboli come marcatori, si rimanda ai sottosottoparagrafi~\ref{sssec:range-input-sep}
+e~\ref{sssec:list-input-sep}. Nel sottoparagrafo~\ref{sssec:input-sep-bsp} è
+mostrato un esempio per un possibile input alternativo.
+
+\chemnum fornisce un'opzione (vedi il paragrafo~\ref{sec:cmpdsetup} per ulteriori
+spiegazioni) con cui restituire tutte le subetichette come intervallo:
+\begin{beschreibung}
+ \Option{cmpd-all}{\default{true}/false}
+\end{beschreibung}
+\begin{beispiel}
+ \cmpd[cmpd-all]{q}
+\end{beispiel}
+
+Affinché la chiave utilizzi le subetichette corrette, queste devono essere state
+dichiarate. Per questa ragione sono letti dal file \verb=\jobname.cmpd= (supponendo
+che il file sorgente abbia il nome \verb=\jobname.tex=). Ciò significa che è
+necessario compilare due (o più) volte il codice per rendere correttamente tutte
+le etichette.
+
+Quando si impiegano etichette con intervalli di subetichette, talvolta si desidera
+restituire \emph{solo} la subetichetta in un altro punto. È possibile realizzarlo
+con la seguente opzione:
+\begin{beschreibung}
+ \Option{sub-only}{\default{true}/false}
+\end{beschreibung}
+\begin{beispiel}
+ % use packages `chemfig', `chemmacros' and `booktabs'
+ \cmpd*{benzene.H,benzene.Me,benzene.OH,benzene.NH2}
+ \chemname{\chemfig{*6(=-=-(-R)=-)}}{\cmpd[cmpd-all]{benzene}}
+ \begin{tabular}{lll}
+ & \ch{-R} & nome \\\midrule
+ \cmpd[sub-only]{benzene.H} & \ch{-H} & benzene\\
+ \cmpd[sub-only]{benzene.Me} & \ch{-CH3} & toluene\\
+ \cmpd[sub-only]{benzene.OH} & \ch{-OH} & fenolo\\
+ \cmpd[sub-only]{benzene.NH2} & \ch{-NH2} & anilina
+ \end{tabular}
+\end{beispiel}
+
+Gli intervalli di subetichette richiedono una certa cura. Per prima cosa bisogna
+sapere esattamente quale etichetta è la minore e quale la maggiore; e come seconda
+cosa, quali etichette si trovano in un intervallo contenuto fra gli estremi.
+\chemnum non è in grado di sostituire questa cura; per questa ragione può
+succedere di ottenere etichette come le seguenti, se non si presta attenzione:
+\begin{beispiel}
+ \cmpd{q.{five..three}} or \cmpd{q.{three,one,four}}.
+\end{beispiel}
+
+\section{Inizializzare le etichette centralmente}\label{sec:cmpdinit}\secidx{inizializzare le etichette}
+I comandi descritti in questo paragrafo non sono necessari per l'impiego di
+\chemnum, ma mettono a disposizione delle funzioni che potrebbero risultare utili
+a qualche utente.
+
+\subsection{Utilizzo}
+\subsubsection{Etichette principali}
+Forse all'utente mancherà il comando \verb=\declarecompound= di \paket{chemcompounds};
+questo permette di avere una panoramica iniziale dei nomi già impiegati, e in
+determinate circostanze genera messaggi di errore quando vengono impostate delle
+etichette sbagliate\footnote{\pes per un errore di battitura}. Questo comportamento
+può essere ottenuto con i seguenti comandi.
+\begin{beschreibung}
+ \Befehl{cmpdinit}{<comma separated list of label names>}
+ \Befehl[cmpdinita]{cmpdinit*}{<comma separated list of label names>}
+\end{beschreibung}
+Tutti i composti che non vengono definiti all'interno di questo comando, sono
+inizializzati \emph{nell'ordine in cui compaiono}. Impiegando un'etichetta non
+presente nell'elenco si ottiene un messaggio di avviso.
+
+\cmpdreset
+\begin{beispiel}
+ \cmpdinit{A, B, C} \cmpd{B} \cmpd{A.a} \cmpd{C} \cmpd{D}
+\end{beispiel}
+
+\begin{mdframed}
+ \small\ttfamily\noindent
+ {}*************************************************\\
+ {}* chemnum warning: "cmpd-init"\\
+ {}* \\
+ {}* You used \verb=\cmpdinit= but didn't initiate compound "D"{} on line 1.\\
+ {}*************************************************
+\end{mdframed}
+
+Nota bene: nel caso vi siano etichette con subetichette è possibile e indicato
+inizializzare \emph{solo il nome principale}. In questo modo vengono inizializzati
+\emph{tutti} i composti con lo stesso nome principale.
+
+\cmd[cmpdinita]{cmpdinit*} restituisce lo stesso messaggio d'errore, tuttavia non
+assegna ancora i numeri, che vengono assegnati solo nel corso del testo e
+nell'ordine di comparsa.
+
+\cmpdreset
+\begin{beispiel}
+ \cmpdinit*{X, Y, Z} \cmpd{Y} \cmpd{X.x} \cmpd{Z} \cmpd{W}
+\end{beispiel}
+
+\begin{mdframed}
+ \small\ttfamily\noindent
+ {}*************************************************\\
+ {}* chemnum warning: "cmpd-init"\\
+ {}* \\
+ {}* You used \verb=\cmpdinit= but didn't initiate compound "W"{} on line 1.\\
+ {}*************************************************
+\end{mdframed}
+
+Quando si desidera o necessita assegnare delle etichette proprie (vedi a
+pagina~\pageref{ssec:own_labels}) e si desidera inizializzare le etichette in modo
+completo, si consiglia l'impiego di \cmd[cmpda]{cmpdinit*}, che \emph{non assegna}
+etichette nell'inizializzazione.
+
+Il comando può essere utilizzato più di una volta, con o senza \verb=*=.
+Probabilmente ha senso solo un impiego \emph{unico}, magari nel preambolo dopo
+il setup di \chemnum (vedi il paragrafo~\ref{sec:cmpdsetup}).
+
+\subsubsection{Subetichette}
+Quando si desidera un avviso aggiuntivo per ogni combinazione etichetta-subetichetta
+o si desidera impostare l'ordine in anticipo, si può impiegare
+\begin{beschreibung}
+ \Befehl{cmpdinit}[\key{init-sub}{true}]{<comma separated list of label names>}
+\end{beschreibung}
+In questo modo si ottiene un avviso anche in questi casi.
+
+\cmpdreset
+\begin{beispiel}
+ \cmpdinit[init-sub = true]{E.{e,f,g}}
+ \cmpd{E.e, E.h}
+\end{beispiel}
+
+\begin{mdframed}
+ \small\ttfamily\noindent
+ {}*************************************************\\
+ {}* chemnum warning: "cmpd-init-sub"\\
+ {}* \\
+ {}* You used \verb=\cmpdinit= and "{}init-sub = true"{} but didn't initiate sub-compound\\
+ {}* "{}E.h"{} on line 1.\\
+ {}*************************************************
+\end{mdframed}
+
+\subsection{Errori anziché avvisi}
+Quando si desidera un messaggio di errore anziché di un messaggio di avviso, lo
+si può realizzare richiamando \cmd{cmpdinit} nel modo seguente:
+\begin{beschreibung}
+ \Befehl{cmpdinit}[\key{init-strict}{true}]{<comma separated list ...>}
+\end{beschreibung}
+L'impiego di \key{init-strict}{false} corrisponde all'impiego senza argomento
+opzionale. Naturalmente l'opzione può essere utilizzata anche nella variante
+asteriscata del comando.
+
+Tramite \key{init-strict}{true} la compilazione con \LaTeX viene interrotta con
+il corrispondente messaggio di errore, quando si impiega un'etichetta non
+inizializzata.
+
+Naturalmente si può richiamare \cmd{cmpdinit} anche con entrambe le opzioni
+\begin{beschreibung}
+ \Befehl{cmpdinit}[\key{init-strict}{true}, \key{init-sub}{true}]{<comma separated list ...>}
+\end{beschreibung}
+oppure utilizzare \cmd{cmpdsetup} (vedi il paragrafo~\ref{sec:cmpdsetup}).
+
+\subsection{Input personalizzato}
+Quando si sono selezionati diversi simboli di input per \key{sub-input-sep} (vedi
+a pagina~\pageref{sssec:sub-input-sep}) o \key{sublist-input-sep} (vedi a
+pagina~\pageref{sssec:list-input-sep}) questi devono esser impiegati anche con
+\key{sub-init}{true}.
+
+La variazione dell'input di elenchi \key{list-input-sep} (vedi a
+pagina~\pageref{sssec:list-input-sep}) non ha effetto su \cmd{cmpdinit}. Se si
+desidera modificare l'input anche in quel luogo, si impieghi \key{init-input-sep}
+(vedi a pagina~\pageref{sssec:init-input-sep}).
+
+\subsection{Perché inizializzare?}
+Come indicato all'inizio di questo paragrafo, l'inizalizzazione delle etichette
+non è necessaria. Vi sono alcuni motivi per cui si può desiderare l'impiego di
+\cmd{cmpdinit}.
+\begin{enumerate}
+ \item L'impiego di \cmd[cmpdinita]{cmpdinit*} è una possibilità di mantenere una
+ panoramica delle etichette impiegate. Si ottiene un avviso o un messaggio di
+ errore quando un'etichetta preesistente viene scritta in modo errato. A seconda
+ del numero di etichette impiegate, questo può però portare ad una mole
+ significativa di lavoro aggiuntivo.
+ \item L'impiego di \cmd{cmpdinit} raggiunge lo stesso scopo primario di
+ \cmd[cmpdinita]{cmpdinit*}, ed \emph{inoltre} dichiara le etichette nell'ordine
+ indicato. In questo modo si rende superfluo l'impiego di \cmd[cmpda]{cmpd*}
+ (sezione~\ref{cmd:unsichtbares_label}) e \cmd[cmpdb]{cmpd+}
+ (sezione~\ref{cmd:cmpd_plus}). Si ottiene così un controllo diretto sulla
+ correlazione tra composto e numero.
+\end{enumerate}
+\secidx*{inizializzare le etichette}
+
+\section{Resettare il contatore}\label{sec:cmpdreset}\secidx{resettare il contatore}
+Con il seguente comando è possibile resettare il contatore:
+\begin{beschreibung}
+ \Befehl{cmpdreset}[<number>]
+\end{beschreibung}
+Senza argomento viene impostato a \verb=1= e corrisponde così a \cmd{cmpdreset}[1].
+A differenza della maggior parte degli altri comandi presentati questo comando ha
+effetto globalmente, non solo localmente entro un gruppo.
+\begin{beispiel}
+ \cmpdreset I composti adesso vengono contati di nuovo a partire
+ da 1: \cmpd{h, i, j}
+\end{beispiel}
+
+\achtung{Si consiglia di utilizzare questo comando con molta prudenza! Di norma
+non è consigliabile resettare il contatore; composti diversi possono venire
+indicati dallo stesso numero!}
+
+\begin{beispiel}
+ Stessi numeri: \cmpd{a}, \cmpd{h}
+\end{beispiel}
+\secidx*{resettare il contatore}
+
+\section{Impieghi particolari}\secidx{impieghi particolari}
+\subsection{Titoli di sezioni}
+L'impiego di \cmd{cmpd} in un titolo inizialmente non sembra essere un problema.
+Non vi sono errori, e l'output appare come previsto:
+\begin{beispiel}[code only]
+ \section{Compound \cmpd[cmpd-delim]{b}}
+ \ldots
+\end{beispiel}
+Quando tuttavia si impiega \verb=\tableofcontents= -- molto probabilmente, come
+prevedo --, avviene qualcosa di indesiderato: dato che l'indice generale viene
+posto all'inizio del documento, l'etichetta viene dichiarata già alla sua comparsa
+nell'indice, anziché nel luogo di prima comparsa nel testo. Vi sono due possibilità
+di evitare questo comportamento:
+\begin{enumerate}
+ \item Si dichiarano le etichette nel preambolo con \cmd{cmpdinit}{} (vedi a
+ pagina~\pageref{sec:cmpdinit}).
+ \item Si impiega \cmd[cmpdb]{cmpd+} per comporre l'etichetta. In questo modo
+ l'etichetta viene letta dal file \verb=\jobname.cmpd= (supponendo un nome
+ principale di \verb=\jobname.tex=); ciò significa che sono necessari
+ \emph{almeno due}, eventualmente anche più esecuzioni di \LaTeX\ per impostare
+ correttamente tutte le etichette.
+\end{enumerate}
+Altrettanto vale anche per qualsiasi lista di argomenti mobili che vengano impiegati
+\emph{prima} della comparsa dell'etichetta nel testo.
+
+Il comando\label{cmd:cmpd_plus}
+\begin{beschreibung}
+ \Befehl[cmpdb]{cmpd+}\ma{<label name>}
+\end{beschreibung}
+legge il nome dell'etichetta da rendere dal file \verb=\jobname.cmpd=. È in un
+certo senso la controparte di \cmd[cmpda]{cmpd*}, dato non si ha una dichiarazione
+dell'etichetta ma solo un suo riferimento e la sua resa. Per potere utilizzare
+\cmd[cmpdb]{cmpd+}{<label>} è necessario dichiarare \verb=<label>= con
+\cmd{cmpd}{<label>} oppure \cmd[cmpda]{cmpd*}{<label>} (prima o dopo).
+\cmd[cmpdb]{cmpd+} è utile quando un'etichetta dev'essere impiegata in un argomento
+mobile come \verb=\section{}=.
+
+\achtung{Il comando non è necessario quando viene impiegato \cmd{cmpdinit} (vedi
+il paragrafo~\ref{sec:cmpdinit}, pag.\,\pageref{sec:cmpdinit}ss).}
+
+\begin{beispiel}[code only]
+ \subsubsection{Titolo di prova con il l'etichetta di composto %
+ \cmpd+[cmpd-delim]{f.one}}
+ % con hyperref:
+ \subsubsection{Titolo di prova con il l'etichetta di composto %
+ \texorpdfstring{\cmpd+[cmpd-delim]{f.two}}{(7b)}}
+\end{beispiel}
+
+\subsection{Ambienti mobili}\cmpdinit*{float1,float2}
+L'impiego di \cmd{cmpd} in ambienti mobili non dovrebbe essere un problema: le
+etichette vengono dichiarate nell'ordine di comparsa nel codice, inclusi gli
+ambienti mobili. Per andare sul sicuro è comunque possibile utilizzare
+\cmd[cmpdb]{cmpd+}.
+
+\begin{beispiel}[code and float]
+ % preamble:
+ % \usepackage{chemscheme}
+ % \renewcommand*\schemename{Schema}
+ % document:
+ \cmpdreset\cmpd{float1, float2}. E ora uno schema:
+ \begin{scheme}[ht]
+ \centering
+ \caption{Questa etichetta dovrebbe essere un 2: \cmpd{float2}}
+ Se 2 = \cmpd{float2}, allora va tutto bene.
+ \end{scheme}
+\end{beispiel}
+
+Funziona tutto come desiderato, anche se l'ambiente flottante scivola davanti al
+codice del testo, \pes con l'opzione \oa{t}.
+
+\cmpdinit*{Alc,EtherBr,cpd}
+\subsection{Schemi di programmi esterni}\label{ssec:cmpdref}\secidx{schemi di programmi esterni}
+Se gli schemi vengono creati con programmi esterni come \pes \prog{ChemDraw}
+oppure \prog{Marvin\-Sketch} e si desidera ricorrere anche in questo caso a
+\chemnum, lo si può ottenere con
+\begin{beschreibung}
+ \Befehl{cmpdref}[<tag>]\oa{<options>}\ma{<label name>}
+\end{beschreibung}
+Questo comando è ispirato a \verb=\schemeref= del pacchetto \paket{chemscheme} e
+funziona nello stesso modo: lo schema viene creato e salvato con etichette
+temporanee come file \verb=eps=.
+
+\achtung{Con la v0.5 è cambiato l'ordine degli argomenti opzionali!}
+\begin{beispiel}[code and float]
+ \begin{scheme}[ht]
+ \centering
+ \includegraphics{scheme-tmp.ps}
+ \caption{Schema con marcatori temporanei.}
+ \end{scheme}
+ \begin{scheme}[ht]
+ \centering
+ \cmpdref{Alc} % sostituisce TMP1
+ \cmpdref{EtherBr} % sostituisce TMP2
+ % \cmpdref{drittes} sostituirebbe TMP3
+ \includegraphics{scheme-tmp.ps}
+ \caption{Schema con etichette automatizzate.}
+ \end{scheme}
+\end{beispiel}
+Nello schema si enumerano le sostanze con \textsf{TMP1}, \textsf{TMP2} ecc.
+Questi marcatori vengono poi sostituiti dalle etichette corrispondenti. A questo
+scopo come \paket{chemscheme} anche \chemnum impiega il comando \verb=\psfrag= del
+pacchetto \paket{psfrag}. Per farlo funzionare è quindi necessario compilare
+tramite \prog{latex}, \prog{dvips}, \prog{ps2pdf} o \pes utilizzare il pacchetto
+\paket{auto-pst-pdf} insieme a \hologo{pdfLaTeX}. \hologo{XeLaTeX} purtroppo non
+funzionerà, e probabilmente nemmeno \hologo{LuaLaTeX}, che tuttavia non è stato
+testato.
+
+In ogni caso è importante che il marcatore sia salvato come \emph{testo} nel file
+\verb=eps=.
+
+Con le opzioni presentate nel paragrafo~\ref{sec:cmpdsetup} è anche possibile
+personalizzare le etichette.
+\begin{beispiel}[code and float]
+ \begin{scheme}[ht]
+ \centering
+ \cmpdsetup{ref-style=\color{green}}
+ \cmpdref{Alc} % sostituisce TMP1
+ \cmpdref{EtherBr} % sostituisce TMP2
+ \includegraphics{scheme-tmp.ps}
+ \caption{Schema con etichette automatizzate.}
+ \end{scheme}
+\end{beispiel}
+
+È possibile sostituire anche con del testo arbitrario; a tale proposito esiste il
+secondo argomento opzionale.
+\begin{beispiel}[code and float]
+ \begin{scheme}[ht]
+ \centering
+ \includegraphics{scheme-bla.ps}
+ \caption{Schema con marcatori arbitrari.}
+ \end{scheme}
+ \begin{scheme}[ht]
+ \centering
+ \cmpdref[blah]{Alc}
+ \cmpdref[blub]{EtherBr}
+ % \cmpdref{drittes} sostituirebbe TMP1.
+ \includegraphics{scheme-bla.ps}
+ \caption{Schema con etichette impostate appositamente.}
+ \end{scheme}
+\end{beispiel}
+
+Nautralmente l'utilizzo delle subetichette funziona nel modo abituale:
+\begin{beispiel}[code and float]
+ \begin{scheme}[ht]
+ \centering
+ \cmpdref{cpd.red}
+ \cmpdref{cpd.ox}
+ \includegraphics{scheme-tmp.ps}
+ \caption{Schema con etichette e subetichette automatizzate.}
+ \end{scheme}
+\end{beispiel}
+\secidx*{schemi di programmi esterni}\secidx*{impieghi particolari}\cmpdreset[10]
+
+\section{Impiego con \textsf{hyperref}}\label{sec:hyperref}\secidx{impiego con \textsf{hyperref}}[impiego con hyperref]
+\subsection{Principio di base}
+Quando viene caricato il pacchetto \paket{hyperref}, è possibile trasformare le
+etichette nel \prog{pdf} in hyperlink cliccabili.
+\begin{beschreibung}
+ \Option{hyper-use}{\default{true}/false}
+\end{beschreibung}
+Quando questa opzione viene impostata a \texttt{true} (per informazioni ulteriori
+confronta il paragrafo~\ref{sec:cmpdsetup}), allora al primo impiego dell'etichetta
+si definisce un traguardo, a cui viene creato un collegamento ad ogni impiego
+ulteriore. Questo tuttavia funziona solamente finché l'etichetta viene impostata
+\emph{senza} elenco o intervallo di subetichette. Anche un'etichetta impostata con
+\cmd[cmpda]{cmpd*} non può essere utilizzata come traguardo.
+
+\begin{beispiel}
+ \cmpdsetup{hyper-use}
+ Al primo impiego si stabilisce il traguardo: \cmpd{a.two,b,c,d,e,f}. Al prossimo
+ impiego viene creato un collegamento: \cmpd{a.two,d,e}.
+
+ Questo funziona solo con le etichette prive senza lista o elenco di subetichette:
+ \cmpd{a,f.{one,two},c}. Dato che \cmpd{a.two} e \cmpd{a} hanno due significati
+ diversi, hanno anche traguardi diversi.
+\end{beispiel}
+
+\subsection{Impiego limitato}
+L'impiego automatizzato può non essere desiderato; in questo caso forse è sufficiente
+definire un riferimento ipertestuale in uno o due punti. Ciò può essere realizzato
+con le seguenti chiavi:
+\begin{beschreibung}
+ \Option{hyper-target}{<link name>}
+ \Option{hyper-link}{<link name>}
+\end{beschreibung}
+Con \key{hyper-target} si determina un traguardo. \textbf{Nota bene}: impiegando
+questa chiave con una lista, allora \emph{ogni} etichetta ottiene lo stesso nome
+traguardo e \paket{hyperref} restituisce un avviso del tipo
+\begin{mdframed}\ttfamily\small
+ destination with the same identifier (name\{<link name>\}) has been already
+ used, duplicate ignored
+\end{mdframed}
+
+Con \key{hyper-link} si può generare un collegamento al traguardo creato.
+\textbf{Nota bene}: se questa chiave viene impiegata con un elenco, \emph{ogni}
+etichetta indicherà lo stesso traguardo.
+\begin{beispiel}
+ Si imposta un collegamento \cmpd[hyper-link=mylink,cmpd-all]{f}
+ senza dimenticare il traguardo corrispondente
+ \cmpd[hyper-target=mylink,cmpd-all]{f}.
+\end{beispiel}
+
+Quando si usa \key{hyper-link} senza avere impostato il \key{hyper-target}
+corrispondente, allora \paket{hyperref} restituirà un avviso del tipo
+\begin{mdframed}\ttfamily\small
+ name\{<link name>\} has been referenced but does not exist, replaced by a
+ fixed one
+\end{mdframed}
+\secidx*{impiego con \textsf{hyperref}}[impiego con hyperref]
+
+\section{Personalizzazione}\label{sec:cmpdsetup}
+\subsection{Il principio}\label{ssec:prinzip}
+La personalizzazione avviene con un sistema del tipo chiave-valore. Le impostazioni
+possono essere definite centralmente tramite
+\begin{beschreibung}
+ \Befehl{cmpdsetup}{key1 = value1, key2 = value2}
+\end{beschreibung}
+oppure localmente sul comando
+\begin{beschreibung}
+ \Befehl{cmpd}[key1 = value1, key2 = value2]{<label name>}
+\end{beschreibung}
+
+Quando si usano delle opzioni \cmd{cmpdsetup}{key1,key2} senza assegnargli un
+valore vengono richiamati dei valori di default\label{opt:default}. Questi possono
+\emph{non essere} vuoti e \emph{non corrispondere} alla preimpostazione del
+pacchetto.
+
+Le opzioni sono suddivise in diverse classi\label{key_classes} che indicano l'area
+di appartenenza. Seguono tutte la forma \verb+<class>-key = <value>+:
+\begin{itemize}
+ \item \code{cmpd}: Le opzioni che iniziano con questo codice hanno effetti
+ sull'etichetta in genere o quella principale.
+ \item \code{sub}, \code{sublist}, \code{subref}: Queste opzioni hanno direttamente
+ a che fare con le subetichette.
+ \item \code{list}: Queste opzioni influenzano la resa degli elenchi.
+ \item \code{ref}: Queste opzioni sono riferite particolarmente a \cmd{cmpdref}.
+ \item \code{hyper}: Queste opzioni sono specifiche per l'uso di \paket{hyperref}.
+ \item \code{init}: Queste opzioni hanno a che fare con l'inizializzazione delle etichette.
+\end{itemize}
+
+\subsection{Stile di carattere}\label{ssec:schriftstil}\secidx{stile di carattere}
+Per variare lo stile con cui sono resi i numeri, vi sono le seguenti opzioni:
+\begin{beschreibung}
+ \Option{cmpd-style}{<style>}
+ \option{cmpd-weight}{bold/normal} Default = \code{bold}
+\end{beschreibung}
+Dato che è comune rendere gli schemi con un carattere senza grazie, mentre il
+testo viene composto con le grazie, è possibile definire uno stile separato per
+\cmd{cmpdref}. Come impostazione predefinita le etichette create con \cmd{cmpdref}
+vengono rese con \lstinline+\sffamily+.
+\begin{beispiel}
+ % preamble:
+ % \usepackage[normalem]{ulem}
+ % document:
+ \cmpd{a, b, f.two, k}\\ % default
+ \cmpd[cmpd-style = \uline]{a, b, f.two, k}\\ % sottolineato
+ \cmpd{a, b, f.two, k}\\ % nuovamente default
+ \cmpdsetup{cmpd-style = \itshape\uline}
+ \cmpd{a, b, f.two, k}\\ % corsivo e sottolineato
+ \cmpd[cmpd-weight=normal]{a, b, f.two, k}
+\end{beispiel}
+Che il peso del carattere venga impostato separatamente deriva dalla presenza di
+caratteri greci nelle etichette (vedi il paragrafo~\ref{ssec:counter}). A seconda
+della rispettiva opzione globale la variazione di peso deve essere realizzata
+diversamente.
+\secidx*{stile di carattere}
+
+\subsection{Etichette proprie}\label{ssec:own_labels}\secidx{etichette proprie}
+Con l'opzione
+\begin{beschreibung}
+ \Option{cmpd-label}{<label>}
+\end{beschreibung}
+è possibile impostare etichette proprie.
+
+\begin{beispiel}
+ Etichetta propria: \cmpd[cmpd-label = XYZ]{l}, viene attribuita a \emph{tutte
+ le etichette nuove} di una lista! \cmpd[cmpd-label = XYZ]{l, a, m}
+\end{beispiel}
+\secidx*{etichette proprie}
+
+\subsection{Marcatori nelle immagini}\secidx{marcatori nelle immagini}\label{ssec:marker_in_bildern}
+Vi sono alcune opzioni specifiche per le etichette contenute in immagini esterne
+che vengono piazzate con \cmd{cmpdref}.
+\begin{beschreibung}
+ \option{ref-marker}{<marker>} Varia il marcatore di default da sostituire.
+ Default = \code{TMP}
+ \option{ref-pos}{\{<tex-pos>\}\{<ps-pos>\}} Default = \code{bb}
+ \option{ref-style}{<style>} Varia il formato dell'etichetta negli schemi esterni.
+ Default = \verb=\sffamily=
+\end{beschreibung}
+Con l'opzione \key{ref-pos} si può variare il tipo di piazzamento utilizzato da
+\cmd{cmpdref}. Il comando \cmd{psfrag} utilizzato internamente ha due opzioni a
+riguardo. La prima determina come viene piazzato il sostituto \TeX; la seconda
+come viene piazzato il sostituto nel box creato dal marcatore. Per ulteriori
+dettagli si rimanda alla documentazione del pacchetto \paket{psfrag}.
+\secidx*{maarcatori nelle immagini}
+
+\subsection{Contatori}\label{ssec:counter}\secidx{contatori}
+Se lo si desidera è possibile anche modificare il formato del contatore di \cmpd{a.one}.
+\begin{beschreibung}
+ \option{cmpd-counter}{arabic/alph/Alph/greek/Greek/roman/Roman/Symbol}
+ Default = \code{arabic}
+ \option{sub-counter}{arabic/alph/Alph/greek/Greek/roman/Roman/Symbol}
+ Default = \code{alph}
+\end{beschreibung}
+
+Nota bene: una variazione del formato di contatore ha effetto solo sulle etichette
+\emph{non ancora generate}!
+\begin{beispiel}
+ \cmpdsetup{cmpd-counter = Alph, sub-counter = arabic}
+ \cmpd{a, b, f.two, k}\\ % nessun'effetto sulle etichette gi\`a create!
+ \cmpd{n.one,n.two,o.one}\\
+ \cmpd{f.three,f.four}\\ % Attenzione: l'etichetta principale \`e stata gi\`a
+ % generata e non verr\`a modificata!
+ \cmpd[cmpd-counter,sub-counter = greek]{p.one,p.two}
+\end{beispiel}
+\secidx*{contatori}
+
+\subsection{Limitatori}\secidx{limitatori}
+È possibile dotare di delimitatori sia i numeri singoli che le liste. A tale
+proposito esistono le opzioni seguenti:
+\begin{beschreibung}
+ \option{cmpd-delim}{<odelim><cdelim>} Richiedono \emph{due} token come valori!
+ \option{list-delim}{<odelim><cdelim>} Richiedono \emph{due} token come valori!
+\end{beschreibung}
+\begin{beispiel}
+ \cmpd{a, b, f.two, k}\\ % default
+ \cmpd[cmpd-delim = ()]{a, b, f.two, k}\\ % tra parentesi
+ \cmpd{a, b, f.two, k}\\ % nuovamente default
+ \cmpdsetup{cmpd-delim = ()}
+ \cmpd{a, b, f.two, k} % tra parentesi
+\end{beispiel}
+Quando si scrive \cmd{cmpd}[\key{cmpd-delim}]{<label>} senza specificarne il
+valore vengono impiegate \verb=()=. Altrettanto vale per \key{list-delim}. Si
+noti che i delimitatori di elenco vengono impiegati solo per almeno \emph{due}
+etichette.
+\begin{beispiel}
+ \cmpd{a, b, f.two, k}\\ % default
+ \cmpd[list-delim = {[}{]}]{a, b, f.two, k}\\ % tra parentesi
+ \cmpd{a, b, f.two, k}\\ % nuovamente default
+ \cmpdsetup{list-delim = []}
+ \cmpd{a, b, f.two, k}\\ % tra parentesi
+ \cmpd{a} % NON \`E una lista!
+\end{beispiel}
+Se si desidera ottenere generalmente le etichette racchiuse tra parentesi, ma si
+vogliono usare localamente senza, vi sono diverse possibilità:
+\begin{beispiel}
+ \cmpdsetup{cmpd-delim}
+ Normalmente \cmpd{b}, \cmpd{c}, \cmpd{d.one}, ma talvolta cos\`\i
+ \cmpd[cmpd-delim = ]{e} oppure \cmpd-{e}.
+\end{beispiel}
+Con
+\begin{beschreibung}\label{cmd:ohne_begrenzer}
+ \Befehl[cmpdc]{cmpd-}\ma{<label name>}
+ \Befehl[cmpdrefc]{cmpdref-}\ma{<label name>}
+\end{beschreibung}
+è possibile rimuovere velocemente le parentesi di un'etichetta (ma non quelle di
+un elenco).
+\begin{beispiel}
+ \cmpd{a, b, f.two, k}\\ % default
+ \cmpdsetup{cmpd-delim = (), list-delim = []}
+ \cmpd{a, b, f.two, k}\\ % tra parentesi doppie
+ \cmpd-{a, b, f.two, k} % tra parentesi semplici
+\end{beispiel}
+
+Con gli argomenti vuoti \cmd{cmpdsetup}{\key{cmpd-delim}{ }} e
+\cmd{cmpdsetup}{\key{list-delim}{ }} è possibile ripristinare i valori predefiniti.
+\secidx*{delimitatori}
+
+\subsection{Suffisso e prefisso}\secidx{suffisso e prefisso}
+Quando lo si desidera è possibile assegnare pre- e suffissi sia ad etichette singole
+che agli elenchi.
+\begin{beschreibung}
+ \Option{cmpd-prefix}{<prefix>}
+ \Option{cmpd-suffix}{<prefix>}
+ \Option{list-prefix}{<prefix>}
+ \Option{list-suffix}{<prefix>}
+\end{beschreibung}
+Come per i delimitatori vale: gli attributi di elenco vengono impegati solo per
+un elenco -- quindi per due o più etichette.
+
+Esempi per gli attributi di elenco:
+\begin{beispiel}
+ \cmpd{a, b, f.two, k}\\ % default
+ \cmpd[cmpd-prefix = nr.]{a, b, f.two, k}\\
+ \cmpdsetup{cmpd-prefix = \(\rightarrow\)}
+ \cmpd{a, b, f.two, k}\\
+ \cmpd{a} % NON \`E una lista!
+\end{beispiel}
+Esempi per gli attributi di elenco:
+\begin{beispiel}
+ \cmpd{a, b, f.two, k}\\ % default
+ \cmpd[list-prefix = elenco:]{a, b, f.two, k}\\
+ \cmpdsetup{list-prefix = raccolta:}
+ \cmpd{a, b, f.two, k}\\
+ \cmpd{a} % NON \`E una lista!
+\end{beispiel}
+
+Tra prefisso, etichetta e suffisso predefinitamente vi è uno spazio:
+\begin{beispiel}
+ \cmpd[cmpd-suffix=Sx,cmpd-prefix=Px]{k}
+\end{beispiel}
+Questo può essere adattato con
+\begin{beschreibung}
+ \Option{cmpd-space}{<space>}
+\end{beschreibung}
+\begin{beispiel}
+ \cmpd[cmpd-suffix=Sx,cmpd-prefix=Px,cmpd-space={}]{k}
+\end{beispiel}
+\secidx*{suffisso e prefisso}
+
+\subsection{Separatori}\label{ssec:trenner}\secidx{separatori}
+\subsubsection{Etichette -- input}\label{sssec:sub-input-sep}\index{separatori!etichette!input}
+Predefinitamente \chemnum impiega il punto \code{.} come simbolo per distinguere
+i nomi delle etichette principali da quelle secondarie; il simbolo può essere
+adattato a piacimento. I simboli \verb=%=, \verb=,= e \verb=#= non possono essere
+impiegati e \verb=@= non dovrebbe essere utilizzato. Inoltre è necessario badare
+a non usare gli stessi simboli (vedi le sezioni seguenti) per gli altri separatori.
+\begin{beschreibung}
+ \option{sub-input-sep}{<separator>} Default = \code{.}
+\end{beschreibung}
+\begin{beispiel}
+ \cmpdsetup{sub-input-sep = !}%
+ \cmpd{f!one, g!two}\\
+ \cmpd[sub-input-sep= +]{f+one, g+two}\\
+ \cmpd[sub-input-sep= ~]{f~one, g~two}\\
+ \cmpd[sub-input-sep= &]{f&one, g&two}\\
+ \cmpd[sub-input-sep= *]{f*one, g*two}
+\end{beispiel}
+Si consiglia -- non solo per motivi di coerenza -- di stabilire \emph{unicamente}
+all'inizio del documento i simboli utilizzati; e in particolare \emph{prima} di
+richiamare \verb=\tableofcontents=, al meglio nel preambolo. Altrimenti
+\verb=\tableofcontents= non può sapere quali simboli sono impiegati, e le
+etichette nell'indice generale possono essere rese nel modo sbagliato.
+
+\subsubsection{Etichette -- output}\index{separatori!etichette!output}
+Anche nel caso di etichette con subetichette è possibile utilizzare dei delimitatori,
+che vanno a piazzarsi tra etichetta principale e secondaria.
+\begin{beschreibung}
+ \Option{sub-output-sep}{<separator>}
+\end{beschreibung}
+\begin{beispiel}
+ \cmpd{a, b, f.two, f.three, k}\\ % default
+ \cmpd[sub-output-sep = -]{a, b, f.two, f.three, k}\\
+ \cmpdsetup{sub-output-sep = $\cdot$}
+ \cmpd{a, b, f.two, f.three, k}\\
+ \cmpd[sub-output-sep = :]{a, b, f.two, f.three, k}
+\end{beispiel}
+
+\subsubsection{Subetichette -- input}\label{sssec:range-input-sep}\index{separatori!subetichette!input}
+Per l'input di un intervallo di subetichette \chemnum impiega predefinitamente
+due punti \code{..}; si può tuttavia scegliere un qualunque input diverso. I
+simboli \verb=%=, \verb=,= e \verb=#= non possono essere impiegati e \verb=@= non
+dovrebbe essere utilizzato. Inoltre è necessario badare a non utilizzare gli stessi
+simboli per separatori diversi.
+\begin{beschreibung}
+ \option{subrange-input-sep}{<separator>} Default = \code{..}
+\end{beschreibung}
+\begin{beispiel}
+ \cmpd[subrange-input-sep=:]{q.{one:four}}\\
+ \cmpdsetup{subrange-input-sep=--}
+ \cmpd{q.{one--four}}
+\end{beispiel}
+
+\subsubsection{Subetichette -- output}\index{separatori!subetichette!output}
+Non si gradisce la resa \cmpd[cmpd-all]{q} e si vuole indicare diversamente
+l'intervallo? Può essere fatto con l'opzione seguente:
+\begin{beschreibung}
+ \option{subrange-output-sep}{<separator>} Default = \verb|--|
+\end{beschreibung}
+\begin{beispiel}
+ \cmpd[subrange-output-sep={ {\normalfont bis} }]{q.{one..four}}\\
+ \cmpdsetup{subrange-output-sep=-}
+ \cmpd{q.{one..four}}
+\end{beispiel}
+
+\subsubsection{Elenchi -- input}\label{sssec:list-input-sep}\index{separatori!elenchi!input}
+Quando lo si desidera è possibile modificare il separatore dell'input di elenchi.
+Per default viene impiegata la virgola \code{,} anche se è possibile selezionare
+qualunque input diverso. I simboli \verb=%=, \verb=,= e \verb=#= non possono
+essere impiegati e \verb=@= non dovrebbe essere utilizzato. Inoltre è necessario
+badare a non utilizzare gli stessi simboli per separatori diversi.
+\begin{beschreibung}
+ \option{list-input-sep}{<separator>} Default = \code{,}
+ \option{sub-input-sep}{<separator>} Default = \code{,}
+\end{beschreibung}
+\begin{beispiel}
+ \cmpd{a, b, f.two, k}\\ % default
+ \cmpd[list-input-sep = +]{a + b + f.two + k}\\
+ \cmpd{a, b, f.two, k}\\
+ \cmpdsetup{list-input-sep = ;}
+ \cmpd{a; b; f.two; k}
+\end{beispiel}
+Questo permette \pes l'impiego di nomi IUPAC come nomi di etichetta\footnote{Molte
+grazie a Christina Lüdigk, che in un certo senso ha proposto questa feature.}.
+\begin{beispiel}
+ \cmpdsetup{list-input-sep=;}
+ \cmpd{1,3-dichlorocyclohexanol}
+\end{beispiel}
+
+\subsubsection{Elenchi -- output}\label{sssec:list-output-sep}\index{separatori!elenchi!output}
+Anche per gli elenchi si lascia stabilire un carattere separatore che determina
+come vengono separate etichette diverse. Per impostazione predefinita è la virgola.
+\begin{beschreibung}
+ \option{list-output-sep}{<separator>} Default = \code{,}
+ \option{sub-output-sep}{<separator>} Default = \code{,}
+\end{beschreibung}
+\begin{beispiel}
+ \cmpd{a, b, f.two, k}\\ % default
+ \cmpd[list-output-sep = ]{a, b, f.two, k}\\
+ \cmpd{a, b, f.two, k}\\
+ \cmpdsetup{list-output-sep = ;}
+ \cmpd{a, b, f.two, k}
+\end{beispiel}
+
+\subsubsection{Elenchi -- ultimo separatore}\label{sssec:last-sep}\index{separatori!elenchi!ultimo separatore}
+L'ultimo separatore negli elenchi, quello tra la penultima e l'ultima etichetta
+elencate, rappresenta un caso particolare. Per questo motivo esistono due opzioni
+per adattarlo.
+\begin{beschreibung}
+ \Option{list-last-sep}{<separator>}
+ \option{list-lang}{US/GB/DE/FR/ES/IT} Default = \code{US}
+\end{beschreibung}
+\begin{beispiel}
+ \cmpd[list-lang = US]{a, b, f.two, k} \cmpd[list-lang = US]{a, b}\\
+ \cmpd[list-lang = GB]{a, b, f.two, k} \cmpd[list-lang = GB]{a, b}\\
+ \cmpd[list-lang = DE]{a, b, f.two, k} \cmpd[list-lang = DE]{a, b}\\
+ \cmpd[list-lang = FR]{a, b, f.two, k} \cmpd[list-lang = FR]{a, b}\\
+ \cmpd[list-lang = ES]{a, b, f.two, k} \cmpd[list-lang = ES]{a, b}\\
+ \cmpd[list-lang = IT]{a, b, f.two, k} \cmpd[list-lang = IT]{a, b}
+\end{beispiel}
+Come indicato l'impostazione di lingua \verb=US= impiega predefinitamente il comma
+di Harvard, tutte le altre lingue non lo fanno. Ulteriori informazioni sul
+riconoscimento linguistico e sul comma di Harvard sono riportati nel
+paragrafo~\ref{sec:language_support}.
+
+L'ultimo separatore può essere anche impostato individualmente con \key{list-last-sep}.
+\begin{beispiel}
+ \cmpdsetup{list-lang = DE}%
+ \cmpd[list-last-sep = {e poi}]{a, b, f.two, k}\\
+ \cmpd[list-last-sep = ]{a, b, f.two, k}\\
+ \cmpd[list-last-sep = come anche]{a, b, f.two, k}\\
+ \cmpd[list-last-sep = empty]{a, b, f.two, k}
+\end{beispiel}
+
+Un'opzione speciale è \key{list-last-sep}{empty}. Quando viene richiamata, viene
+impiegato ovunque il separatore stabilito da \key{list-output-sep}.
+\begin{beispiel}
+ \cmpdsetup{list-last-sep = empty}%
+ \cmpd{a, b, f.two, k}\\
+ \cmpd[list-output-sep = ;]{a, b, f.two, k}\\
+ \cmpd[list-output-sep = {\ e}]{a, b, f.two, k}
+\end{beispiel}
+
+\subsubsection{Per \code{\textbackslash\textcolor{code}{cmpdinit}} -- input}\label{sssec:init-input-sep}\index{separatori!cmpdinit@\textcolor{code}{\code{\textbackslash cmpdinit}}}
+Quando lo si desidera, è possibile variare il separatore dell'input di elenchi.
+Predefinitamente viene impiegata la virgola \code{,} ed è possibile impiegare
+qualunque altro input. I simboli \verb=%=, \verb=,= e \verb=#= non possono essere
+impiegati e \verb=@= non dovrebbe essere utilizzato.
+\begin{beschreibung}
+ \option{init-input-sep}{<separator>} Default = \code{,}
+\end{beschreibung}
+
+\subsubsection{Un esempio}\label{sssec:input-sep-bsp}
+Segue un piccolo esempio di una variante personalizzata dei separatori.
+\begin{beispiel}
+ \cmpdsetup{
+ sub-input-sep = ! ,
+ subrange-input-sep = : ,
+ sublist-input-sep = / ,
+ list-input-sep = +
+ }
+ \cmpd{a + f ! one + q ! one / three : five}
+\end{beispiel}
+\secidx*{separatori}
+
+\section{Supporto linguistico}\label{sec:language_support}\secidx{supporto linguistico}
+\subsection{Cooperazione con \textsf{babel}}
+\chemnum supporta la selezione di lingua tramite \paket{babel} per una serie di
+lingue. Questo avviene grazie al pacchetto \paket*{translations}\footnote{%
+\paket*{translations} è parte del bundle \paket*{exsheets}.}.
+
+\begin{beispiel}
+ \selectlanguage{ngerman}DE: \cmpd{r,s,t} \selectlanguage{german}\cmpd{r,s,t}\\
+ \selectlanguage{naustrian}AU: \cmpd{r,s,t} \selectlanguage{austrian}\cmpd{r,s,t}\\
+ \selectlanguage{english}EN: \cmpd{r,s,t}\\
+ \selectlanguage{british}GB: \cmpd{r,s,t}\\
+ \selectlanguage{american}US: \cmpd{r,s,t}\\
+ \selectlanguage{canadian}CDN-EN: \cmpd{r,s,t}\\
+ \selectlanguage{canadien}CDN-FR: \cmpd{r,s,t}\\
+ \selectlanguage{french}FR: \cmpd{r,s,t}\\
+ \selectlanguage{spanish}ES: \cmpd{r,s,t}\\
+ \selectlanguage{italian}IT: \cmpd{r,s,t}
+\end{beispiel}
+Il supporto linguistico di gran lunga non comprende tutte le lingue, in primo
+luogo per motivi di realizzabilità. Se vi dovesse mancare una lingua, vi prego
+di inviarmi un'e-mail\footnote{\href{mailto:contact@mychemistry.eu}{contact@mychemistry.eu}}
+con la corrispondente opzione di \paket{babel} e la traduzione corretta, e la
+aggiungerò volentieri.
+
+\subsection{Comma di Harvard}\label{ssec:harvard-comma}\secidx{comma di Harvard}
+Nell'inglese statunitense è molto diffuso l'impiego del cosiddetto comma di Harvard
+o di Oxford, mentre nell'inglese britannico e nelle altre lingue europee è raramente
+impiegato.
+\begin{zitat}[\href{http://en.wikipedia.org/wiki/Serial_comma}{Wikipedia}, 2011/11/07]
+ The serial comma (also known as the Oxford comma or Harvard comma, and sometimes
+ referred to as the series comma) is the comma used immediately before a coordinating
+ conjunction (usually and or or, and sometimes nor) preceding the final item in a list
+ of three or more items. For example, a list of three countries can be punctuated as
+ either "Portugal, Spain, and France" (with the serial comma) or as "Portugal, Spain
+ and France" (without the serial comma).
+
+ Opinions vary among writers and editors on the usage or avoidance of the serial
+ comma. In American English, the serial comma is standard usage in non-journalistic
+ writing that follows the \name{Chicago Manual of Style}. Journalists, however,
+ usually follow the AP Stylebook, which advises against it. It is used less often
+ in British English, where it is standard usage to leave it out, with some notable
+ exceptions such as \name{Fowler's Modern English Usage}. In many languages (e.g.,
+ French, German, Italian, Polish, Spanish), the serial comma is not the norm and
+ may even go against punctuation rules. It may be recommended in many cases,
+ however, to avoid ambiguity or to aid prosody.
+\end{zitat}
+\chemnum attiva il comma di Harvard quando è selezionato American English, ma non
+con le altre lingue. È tuttavia possibile (dis-)attivare il comma di Harvard a
+piacimento con l'opzione
+\begin{beschreibung}
+ \Option{list-serial-comma}{\default{true}/false}
+\end{beschreibung}
+\begin{beispiel}
+ \selectlanguage{ngerman}DE: \cmpd[list-serial-comma]{r,s,t} vs. \cmpd{r,s,t}\\
+ \selectlanguage{american}US: \cmpd[list-serial-comma=false]{r,s,t} vs. \cmpd{r,s,t}
+\end{beispiel}
+Quando si seleziona manualmente la lingua, viene richiamato l'impostazione
+predefinita della lingua. Quindi \key{list-serial-comma} dovrebbe essere
+richiamato \emph{dopo} \key{list-lang}.% TODO
+\begin{beispiel}
+ sbagliato: \cmpdsetup{list-serial-comma=false, list-lang=US}\cmpd{r,s,t}\\
+ giusto: \cmpdsetup{list-lang=US, list-serial-comma=false}\cmpd{r,s,t}
+\end{beispiel}
+\secidx*{comma di Harvard}\secidx*{supporto linguistico}
+
+\section{Panoramica}
+\subsection{Opzioni}\label{ssec:keys_uebersicht}
+In seguito sono elencate tutte le opzioni disponibili.
+\begin{center}
+ \label{tab:keys}
+ \begin{longtabu*}{>{\ttfamily\color{key}}l>{\ttfamily}l>{\ttfamily}l>{\ttfamily}l}\toprule
+ \normalfont\bfseries\normalcolor opzione &
+ \normalfont\bfseries valore vuoto &
+ \normalfont\bfseries impostazione predefinita &
+ \normalfont\bfseries tipo \\\midrule
+ cmpd-style & & & macro \\
+ cmpd-weight & bold & bold & choice \\
+ cmpd-label & & & literal \\
+ cmpd-delim\color{black}$^\mathrm{a}$ & () & & literal \\
+ cmpd-odelim & & & literal \\
+ cmpd-cdelim & & & literal \\
+ cmpd-prefix & & & literal \\
+ cmpd-suffix & & & literal \\
+ cmpd-space & \verb=\penalty\@m\ = & \verb=\penalty\@m\ = & literal \\
+ cmpd-counter & arabic & arabic & choice \\
+ cmpd-all & true & false & boolean \\\midrule
+ sub-only & true & false & boolean \\
+ sub-counter & alph & alph & choice \\
+ sub-output-sep & & , & literal \\
+ sub-input-sep & . & . & literal \\
+ sublist-output-sep & , & , & literal \\
+ sublist-input-sep & , & , & literal \\
+ subrange-output-sep & -- & -- & literal \\
+ subrange-input-sep & .. & .. & literal \\\midrule
+ list-delim\color{black}$^\mathrm{a}$ & () & & literal \\
+ list-odelim & & & literal \\
+ list-cdelim & & & literal \\
+ list-prefix & & & literal \\
+ list-suffix & & & literal \\
+ list-input-sep & , & , & literal \\
+ list-output-sep & , & , & literal \\
+ list-lang & US & US$^\mathrm{b}$ & choice \\
+ list-last-sep & and$^\mathrm{c}$ & & literal \\
+ list-serial-comma & true & true$^\mathrm{c}$ & boolean \\\midrule
+ ref-tag & TMP & TMP & literal \\
+ ref-style & & \verb=\sffamily= & macro \\
+ ref-pos\color{black}$^\mathrm{a}$ & bb & bb & literal \\\midrule
+ init-strict & true & false & boolean \\
+ init-sub & true & false & boolean \\
+ init-input-sep & , & , & literal \\\midrule
+ hyper-use & true & false & boolean \\
+ hyper-target & & & literal \\
+ hyper-link & & & literal \\\bottomrule
+ \end{longtabu*}
+ \setlength\extrarowheight{-1pt}
+ \begin{tabular}{>{\footnotesize}r>{\footnotesize\raggedright}p{.7\linewidth}}
+ a & Richiede \emph{due} token come valore. \tabularnewline
+ b & Dipende dall'impiego di \paket*{babel}. \tabularnewline
+ c & Dipende dal valore di \key{list-lang} e dall'impiego di \paket*{babel}.
+ \end{tabular}
+\end{center}
+
+\subsection{Comandi}
+In seguito sono elencati tutti i comandi definiti da \chemnum e le loro varianti.
+\begin{center}
+ \label{tab:commands}
+ \begin{longtabu*} to \linewidth {X[l]X[p]}\toprule
+ \bfseries Comando & \bfseries Descrizione \tabularnewline\midrule
+ \cmd*{cmpd}[<keyval>]{<labels>} & Comando principale; genera
+ e rende etichette o liste di etichette, vedi a pagina~\pageref{sec:nummerieren}ss. \tabularnewline
+ \cmd*[cmpda]{cmpd*}{<labels>} & invisibile, genera etichette,
+ vedi a pagina~\pageref{cmd:unsichtbares_label} \tabularnewline
+ \cmd*[cmpdc]{cmpd-}[<keyval>]{<labels>} & senza delimitatori, vedi a
+ pagina~\pageref{cmd:ohne_begrenzer} \tabularnewline
+ \cmd*[cmpdd]{cmpd+-}[<keyval>]{<labels>} & l'etichetta viene letta da
+ un file ausiliario, vedi a pagina~\pageref{cmd:cmpd_plus} \tabularnewline\midrule
+ \cmd*{cmpdinit}[<keyval]{<labels>} & inizializza e crea le etichette,
+ vedi a pagina~\pageref{sec:cmpdinit}s. \tabularnewline
+ \cmd*[cmpdinita]{cmpdinit*}[<keyval]{<labels>} & inizializza le etichette, vedi
+ a pagina~\pageref{sec:cmpdinit}s. \tabularnewline\midrule
+ \cmd*{cmpdref}[<keyval>][<marker>]{} & sostituisce le etichette
+ temporanee nei file \texttt{eps} con etichette, vedi a
+ pagina~\pageref{ssec:cmpdref} \tabularnewline
+ \cmd*[cmpdrefc]{cmpdref-}[<keyval>][<marker>]{} & sostituisce etichette
+ temporanee nei file \texttt{eps} con etichette senza delimitatori, vedi a
+ pagina~\pageref{cmd:ohne_begrenzer} \tabularnewline\midrule
+ \cmd*{cmpdreset}[<num>] & resetta il contatore, vedi a
+ pagina~\pageref{sec:cmpdreset} \tabularnewline\midrule
+ \cmd*{cmpdsetup}{<keyval>} & imposta \chemnum, vedi a
+ pagina~\pageref{sec:cmpdsetup}ss. \tabularnewline\bottomrule
+ \end{longtabu*}%
+\end{center}
+
+\appendix
+\addsec{Ringraziamenti}
+Vorrei ringraziare Joseph \name{Wright} e Russell \name{Hewitt} dei loro preziosi
+suggerimenti e feedback per migliorare \chemnum.
+
+Grazie di cuore a Jonas \name{Rivetti} che ha tradotto il testo in italiano.
+
+\printindex
+
+\end{document}
+
+
diff --git a/Master/texmf-dist/tex/latex/chemnum/chemnum.sty b/Master/texmf-dist/tex/latex/chemnum/chemnum.sty
index f531564d0f6..5d3525cddd2 100644
--- a/Master/texmf-dist/tex/latex/chemnum/chemnum.sty
+++ b/Master/texmf-dist/tex/latex/chemnum/chemnum.sty
@@ -22,17 +22,19 @@
% -
% - The Current Maintainer of this work is Clemens Niederberger.
% -
-% - This work consists of the files chemnum.sty, chemnum_de.tex, chemnum_en.tex,
-% - chemnum-codehelper.tex, scheme-tmp.eps, scheme-bla.eps, README and the
-% - derived files chemnum_de.pdf and chemnum_en.pdf
+% - This work consists of the files
+% - chemnum.sty, chemnum_de.tex, chemnum_en.tex, chemnum_it.tex
+% - scheme-tmp.ps, scheme-bla.ps,
+% - README
+% - chemnum_de.pdf, chemnum_en.pdf, chemnum_it.pdf
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\RequirePackage { expl3 , xparse , l3keys2e , etoolbox , psfrag }
\ProvidesExplPackage
{chemnum}
- {2012/09/17}
- {0.5e}
- {An approach for the numbering of chemical compounds}
+ {2012/12/29}
+ {0.5f}
+ {a comprehensive approach for the numbering of chemical compounds}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% CHECK FOR SUPPORT
@@ -1443,12 +1445,12 @@
{ \psfrag { #1 } [ #2 ] [ #3 ] { #4 } }
\cs_generate_variant:Nn \chemnum_psfrag:nnnn { VVVn }
-\cs_new:Npn \chemnum_set_psfrag_pos_local:w #1 ref-pos = #2#3 , #4 \q_stop
+\cs_new:Npn \chemnum_set_psfrag_pos_local:w #1 ref-pos #2 = #3#4 , #5 \q_stop
{
\tl_set_eq:NN \l_chemnum_psfrag_texpos_current_tl \l_chemnum_psfrag_texpos_tl
\tl_set_eq:NN \l_chemnum_psfrag_pspos_current_tl \l_chemnum_psfrag_pspos_tl
- \tl_set:Nn \l_chemnum_psfrag_texpos_tl { #2 }
- \tl_set:Nn \l_chemnum_psfrag_pspos_tl { #3 }
+ \tl_set:Nn \l_chemnum_psfrag_texpos_tl { #3 }
+ \tl_set:Nn \l_chemnum_psfrag_pspos_tl { #4 }
}
\keys_define:nn { chemnum }
@@ -1541,39 +1543,16 @@
% --------------------------------------------------------------------------- %
% language support:
-\file_if_exist:nT { translator.sty }
- {
- \RequirePackage { translator }
- \usedictionary { translator-basic-dictionary }
- % german
- \languagealias { ngerman } { German }
- \languagealias { german } { German}
- \languagealias { austrian } { German }
- \languagealias { naustrian } { German }
- % french
- \languagealias { french } { French }
- \languagealias { canadien } { French }
- % italian
- \languagealias { italian } { Italian }
- % spanish
- \languagealias { spanish } { Spanish }
- \providetranslation [ to = English ]
- { and~(list~seperator) } { and }
- \providetranslation [ to = BritishEnglish ]
- { and~(list~seperator) } { and }
- \providetranslation [ to = AmericanEnglish ]
- { and~(list~seperator) } { and }
- \providetranslation [ to = French ]
- { and~(list~seperator) } { et }
- \providetranslation [ to = German ]
- { and~(list~seperator) } { und }
- \providetranslation [ to = Italian ]
- { and~(list~seperator) } { e }
- \providetranslation [ to = Spanish ]
- { and~(list~seperator) } { y }
- \tl_set:Nn \l_chemnum_list_last_separator_lang_tl
- { \translate { and~(list~seperator) } }
- }
+
+\RequirePackage { translations }
+\DeclareTranslationFallback { and~(list~seperator) } { and }
+\DeclareTranslation { English } { and~(list~seperator) } { and }
+\DeclareTranslation { French } { and~(list~seperator) } { et }
+\DeclareTranslation { German } { and~(list~seperator) } { und }
+\DeclareTranslation { Italian } { and~(list~seperator) } { e }
+\DeclareTranslation { Spanish } { and~(list~seperator) } { y }
+\tl_set:Nn \l_chemnum_list_last_separator_lang_tl
+ { \GetTranslation { and~(list~seperator) } }
\AtBeginDocument
{
@@ -1681,8 +1660,5 @@ HISTORY:
% TODO:
- add a possibility to \ref{} the compounds
- (rudimentäre) Unterstützung für hyperref und pdfstrings
- - polyglossia: localization of us-variant of english
- - Bug: Key "cmpd-style" wenn zB \color{<farbe>} eingegeben: Fehler beim Test
- auf Makro; Test entfernen?
- provide expandable makro which gives the label and/or sublabel without any
formatting \ No newline at end of file
generated by cgit v1.2.3 (git 2.39.1) at 2024-11-10 14:28:22 +0000