diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/chemmacros/chemmacros_it.tex')
| -rw-r--r-- | Master/texmf-dist/doc/latex/chemmacros/chemmacros_it.tex | 3465 |
1 files changed, 0 insertions, 3465 deletions
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_it.tex b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_it.tex deleted file mode 100644 index 5b88b4c684d..00000000000 --- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_it.tex +++ /dev/null @@ -1,3465 +0,0 @@ -% arara: xelatex -% arara: biber -% arara: xelatex -% arara: xelatex -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% ----------------------------------------------------------------------------- -% - the CHEMMACROS bundle -% - chemmacros_it.tex -% - macros and commands for chemists -% ----------------------------------------------------------------------------- -% - Clemens Niederberger -% ----------------------------------------------------------------------------- -% - https://bitbucket.org/cgnieder/chemmacros/ -% - contact@mychemistry.eu -% ----------------------------------------------------------------------------- -% - If you have any ideas, questions, suggestions or bugs to report, please -% - feel free to contact me. -% ----------------------------------------------------------------------------- -% - Copyright 2011-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. -% ----------------------------------------------------------------------------- -% - the Italian translation was kindly provided by Jonas Rivetti. Many thanks! -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% -% if you want to compile this documentation -% a) you'll need the document class `cnpkgdoc' which you can get here: -% https://bitbucket.org/cgnieder/cnpkgdoc/ -% the class is licensed LPPL 1.3 or later -% b) you need the following compilation order: -% > xelatex chemmacros_it (2 or probably 3 times) -% > biber chemmacros_it -% > xelatex chemmacros_it (2 times) -% -\documentclass[DIV11,toc=index,toc=bib]{cnpkgdoc} -\docsetup{ - pkg = chemmacros, - title = Il bundle \Chemmacros, - language = it, - subtitle = {I pacchetti \Chemmacros, \Chemformula\ e \Ghsystem}, - modules = true, - code-box = {skipabove=1ex,skipbelow=1ex}, - label = {}, -} - -\usepackage{chemfig,upgreek,textgreek,booktabs,cancel} -\usepackage[version=3]{mhchem} -\usepackage{hologo} -\newcommand*\pdfTeX{\hologo{pdfTeX}} -\newcommand*\XeTeX{\hologo{XeTeX}} -\newcommand*\LuaTeX{\hologo{LuaTeX}} -\newcommand*\XeLaTeX{\hologo{XeLaTeX}} -\newcommand*\LuaLaTeX{\hologo{LuaLaTeX}} - -\usepackage{fnpct} -\usepackage[biblatex]{embrac} -\ChangeEmph{[}[,.02em]{]}[.055em,-.08em] -\ChangeEmph{(}[-.01em,.04em]{)}[.04em,-.05em] - -\pagestyle{headings} - -\usepackage{acro} -\acsetup{long-format=\scshape} -\DeclareAcronym{ghs}{ - short = GHS , - long = Globally Harmonized System of Classification and Labelling of Chemicals -} -\DeclareAcronym{eu}{ - short = EU , - long = European Union -} -\DeclareAcronym{iupac}{ - short = IUPAC , - long = International Union of Pure and Applied Chemistry -} -\DeclareAcronym{UN}{ - short = UN , - long = Nazioni Unite -} -\DeclareAcronym{dvi}{ - short = dvi , - long = device independent file format , - format = \scshape -} -\DeclareAcronym{pdf}{ - short = pdf , - long = portable document file , - format = \scshape -} - -\chemsetup[option]{synchronize,language=italian} -\colorlet{chemformula}{darkgray} - -\sisetup{ - detect-mode=false, - mode=text, - text-rm=\addfontfeatures{Numbers={Proportional,Lining}} -} - -\usepackage{filecontents} - -\begin{filecontents*}{\jobname.ist} - preamble "\\begin{theindex}\n I titoli sono posti in \\textbf{grassetto}, i - pacchetti \\textsf{senza grazie}, i comandi in - \\code{\\textbackslash\\textcolor{code}{marrone}}, le opzioni in - \\textcolor{key}{\\code{verde}} e i moduli (solo per \\chemmacros) in - \\textcolor{module}{\\code{rosso}}.\\newline\n\n" - heading_prefix "{\\bfseries " - heading_suffix "\\hfil}\\nopagebreak\n" - headings_flag 1 - delim_0 "\\dotfill\\hyperpage{" - delim_1 "\\dotfill\\hyperpage{" - delim_2 "\\dotfill\\hyperpage{" - delim_r "}\\textendash\\hyperpage{" - delim_t "}" - suffix_2p "\\nohyperpage{\\,f.}" - suffix_3p "\\nohyperpage{\\,ff.}" -\end{filecontents*} - -\usepackage[backend=biber,style=alphabetic,maxbibnames=20]{biblatex} -\addbibresource{\jobname.bib} -\begin{filecontents*}{\jobname.bib} -@book{iupac:greenbook, - author = {E. Richard Cohan and Tomislav Cvita\v{s} and Jeremy G. Frey and - Bertil Holmström and Kozo Kuchitsu and Roberto Marquardt and Ian Mills and - Franco Pavese and Martin Quack and Jürgen Stohner and Herbert L. Strauss and - Michio Takami and Anders J Thor}, - title = {“Quantities, Symbols and Units in Physical Chemistry”, \acs{iupac} - Green Book}, - edition = {3rd Edition. 2nd Printing}, - year = {2008}, - publisher = {\acs{iupac} \&\ RSC Publishing, Cambridge} -} -@book{iupac:redbook, - author = {Neil G. Connelly and Ture Damhus and Richard M. Hartshorn and - Alan T. Hutton}, - title = {“Nomenclature of Inorganic Chemistry”, \acs{iupac} Red Book}, - year = {2005}, - publisher = { \acs{iupac} \&\ RSC Publishing, Cambridge}, - isbn = {0-85404-438-8} -} -@misc{eu:ghsystem_regulation, - author = {{The European Parliament and The Council of the European Union}}, - title = {Regulation (EC) No 1272/2008 of the European Parliament and of the Council}, - subtitle = {on classification, labelling and packaging of substances and mixtures, - amending and repealing Directives 67/548/EEC and 1999/45/EC, and amending - Regulation (EC) No 1907/2006}, - journal = {Official Journal of the European Union}, - date = {2008-12-16} -} -@online{unece:ghsystem_implementation, - author = {United Nations Economic Commission for Europe}, - title = {GHS Implementation}, - url = {http://www.unece.org/trans/danger/publi/ghs/implementation_e.html}, - urldate = {2012-03-20}, - date = {2012-03-20} -} -\end{filecontents*} - -\DeclareInstance{xfrac}{chemformula-text-frac}{text} - { - scale-factor = 1 , - denominator-bot-sep = -.2ex , - denominator-format = \scriptsize #1 , - numerator-top-sep = -.2ex , - numerator-format = \scriptsize #1 , - slash-right-kern = .05em , - slash-left-kern = .05em - } - -\newcommand*\chemformula{{\scshape\textcolor{cnpkgblue}{chemformula}}\xspace} -\newcommand*\ghsystem{{\scshape\textcolor{cnpkgblue}{ghsystem}}\xspace} - -\newcommand*\Chemmacros{{\fontspec[Color=cnpkgblue,Scale=1.2]{Linux Biolinum Shadow O}chemmacros}} -\newcommand*\Chemformula{{\fontspec[Color=cnpkgblue,Scale=1.2]{Linux Biolinum Shadow O}chemformula}} -\newcommand*\Ghsystem{{\fontspec[Color=cnpkgblue,Scale=1.2]{Linux Biolinum Shadow O}ghsystem}} - -\renewcommand*\AmS{\hologo{AmS}} -% \newcommand*\pdfTeX{\hologo{pdfTeX}} -% \renewcommand*\LuaTeX{\hologo{LuaTeX}} - -\TitlePicture{% - \ch[font-spec={[Color=chemformula]Augie}]{ 2 "\OX{o1,\ox{0,Na}}" + "\OX{r1,\ox{0,Cl}}" {}2 -> 2 "\OX{o2,\ox{+1,Na}}" {}+ + 2 "\OX{r2,\ox{-1,Cl}}" {}- } - \redox(o1,o2)[red,-cf]{\small\ch[font-spec={[Color=red]Augie},math-space=.3em]{$-$ 2 e-}} - \redox(r1,r2)[blue,-cf][-1]{\small\ch[font-spec={[Color=blue]Augie},math-space=.3em]{$+$ 2 e-}}} - -\addcmds{ - a,abinitio,AddRxnDesc,anti,aq,aqi, - b,ba,bond,bottomrule,bridge, - cancel,cd,cdot,ce,cee,celsius,centering,chemabove,Chemalpha,Chembeta,Chemgamma, - Chemdelta,ChemDelta,chemfig,chemname,Chemomega,chemsetup,cip,cis,ch,cnsetup, - CNMR,color,cstsetup, - d,D,data,DeclareChemArrow,DeclareChemBond,DeclareChemBondAlias,DeclareChemIUPAC, - DeclareChemLatin,DeclareChemNMR,DeclareChemParticle,DeclareChemPhase, - DeclareChemReaction,DeclareChemState,DeclareInstance,DeclareSIUnit,definecolor, - delm,delp,Delta,Dfi,draw, - E,el,electronvolt,ElPot,endo,Enthalpy,enthalpy,Entropy, - footnotesize,fmch,fpch,fscrm,fscrp, - g,gas,ghs,ghslistall,ghspic,Gibbs,glqq,gram,grqq, - H,hapto,HNMR,Helmholtz,hertz,hspace, - includegraphics,insitu,intertext,invacuo,iupac,IUPAC,J,joule, - Ka,Kb,kilo,Kw, - L,latin,lewis,Lewis,Lfi,listofreactions,lqd,ltn, - mch,mega,meta,metre,mhName,midrule,milli,mmHg,mole, - N,nano,nicefrac,newman,NMR,Nu,Nuc,num,numrange, - O,ominus,orbital,ortho,oplus,ox,OX, - p,P,para,pch,per,percent,pgfarrowsdeclarealias,pgfarrowsrenewalias,pH,phase, - photon,pKa,pKb,pOH,pos,positron,Pot,prt, - R,Rad,redox,RenewChemArrow,RenewChemBond,RenewChemIUPAC,RenewChemLatin,RenewChemNMR, - RenewChemParticle,RenewChemPhase,RenewChemState,renewtagform,rightarrow, - S,Sf,sample,scriptscriptstyle,scrm,scrp,second,setatomsep,setbondoffset,sfrac, - shorthandoff,ShowChemArrow,ShowChemBond,si,SI,sisetup,sld,Sod,square,State, - subsection, - textcolor,textendash,textsuperscript,tiny,toprule,trans, - upbeta,upeta,upgamma, - val,volt,vphantom,vspave, - w,xspace,Z} - -\newcommand*\pes{\mbox{p.\,es.}\xspace} - -\usepackage{imakeidx} -\indexsetup{othercode=\footnotesize} -\makeindex[columns=3,intoc,options={-sl \jobname.ist}] - -\begin{document} -\chemsetup[chemformula]{ - font-spec = - {[Color=chemformula,Numbers={Proportional,Lining}]Latin Modern Sans} -} -\def\glqq{„} -\def\grqq{“} - -\part{Prima di cominciare}\secidx{PRIMA DI COMINCIARE} -\section{Licenza, requisiti e LEGGIMI} -Il bundle \chemmacros è pubblicato sotto la \LaTeX\ Project Public License -(LPPL) versione 1.3 o successive (\url{http://www.latex-project.org/lppl.txt}) -ed ha lo stato \enquote{maintained}. - -Il bundle \chemmacros richiede versioni attuali dei bundle \paket{l3kernel} e -\paket{l3packages}. Inoltre sono richiesti i pacchetti \paket{siunitx}, -\paket{mathtools}, \paket{bm}, \paket{nicefrac} ed \paket{environ} come anche -\paket*{tikz}\footnote{CTAN:~\href{http://www.ctan.org/pkg/pgf/}{pgf}} e le sue -librerie \code{calc} e \code{arrows}. - -L'opzione globale del pacchetto (d'ora in poi indicata come \enquote{opzione -globale}) \key{bpchem} (vedi paragrafo~\ref{sec:optionen}) richiede -\paket{bpchem}, l'opzione globale \key{xspace} richiede \paket{xspace} e l'opzione -globale \key{method}{mhchem} richiede \paket{mhchem}. - -Dalla v3.0 il pacchetto \chemmacros è stato riunito con i nuovi pacchetti -\chemformula e \ghsystem; \chemformula è un'alternativa a \paket{mhchem}. Questo -ha portato ad alcuni cambiamenti interni a \chemmacros. Contemporaneamente è -stato totalmente rielaborato questo manuale. - -Forse l'utente ricorderà che le opzioni di \chemmacros appartengono tutte a -moduli diversi (per ulteriori informazioni a riguardo vedi il paragrafo~% -\ref{sec:setup}). Questi vengono poste nel margine sinistro quando l'opzione -viene citata per la prima volta. L'appendice (vedi la parte~\ref{sec:overview}) -elenca tutte le opzioni di \chemmacros e i rispettivi moduli. In questo documento -le opzioni sono contrassegnate dal colore \textcolor{key}{\code{verde}} e i moduli -dal colore \textcolor{module}{\code{rosso}}. - -Il pacchetto \ghsystem richiede i pacchetti \chemmacros, \paket{tabu}, -\paket{longtable}, \paket{ifpdf} e \paket{graphicx}. %\ghsystem non ha opzioni -%sdi pacchetto proprie ma passa tutte le opzioni a \chemmacros. - -\achtung{Il pacchetto riconosce alcuni comandi e opzioni obsolete, che non -vengono più descritti in questo manuale; sono ancora definiti per garantire la -compatibilità con documenti meno recenti. Questi comandi restituiscono un -avviso; in futuro potrebbero non essere più definiti.} - -\section{Motivazioni e ragioni} -\chemmacros nacque qualche anno fa come una lista crescente di macro che usavo -frequentemente. Non ricordo più il momento e le ragioni che mi spinsero a -pubblicarle come pacchetto. Ora lo avete davanti a voi \textendash\ spero che -anche voi riusciate a trarne qualche beneficio. - -Nel corso del tempo le macro ed il loro funzionamento sono leggermente variati, -e se ne sono aggiunte di nuove. Con il passare del tempo molte cose si sono -unificate, introducendo sempre più possibilità di apportare personalizzazioni. - -Ogni chimico che usi \LaTeX\ per la compilazione dei propri documenti conoscerà -il meraviglioso pacchetto \paket{mhchem} di Martin Hensel. Fin dall'inizio vi -furono delle difficoltà a fare cooperare \paket{mhchem} e \chemmacros. -Alcuni dettagli di \paket{mhchem} non mi hanno mai soddisfatto particolarmente, -ma non sembravano essere sufficienti per un nuovo pacchetto, nemmeno per inviare -un \enquote{feature request} all'autore di \paket{mhchem}. La sfida e il -divertimento nel creare un pacchetto nuovo nonché il desiderio di raggiungere -una flessibilità massima hanno infine portato a \chemformula. - -\chemformula funziona in modo analogo a \paket{mhchem}, ma è più severo per quanto -riguarda l'input di composti, fattori stechiometrici e frecce di reazione; -contemporaneamente \chemformula offre alcune possibilità di adattare l'output che -\paket{mhchem} non ha. Dato che \chemformula nasce come alternativa a -\paket{mhchem}, \chemmacros offre un'opzione per selezionare uno tra -\paket{mhchem} e \chemformula. - -Il lettore di formazione chimica probabilmente sarà a conoscenza che le -\acl{UN} hanno introdotto il \ac{ghs} come sostituto di validità -globale per i numerosi sistemi dei diversi paesi, simili ma non unitari. Nonostante -non sia ancora stato adottato da tutti i paesi \cite{unece:ghsystem_implementation}, -questo avverrà ben presto. Il pacchetto \ghsystem offre la possibilità di inserire -e richiamare in modo semplice tutti gli \enquote{hazard and precautionary statements}. -Le frasi sono tratte dal regolamento CE 1272/2008 \cite{eu:ghsystem_regulation}. - -Con questo bundle spero di essere riuscito a realizzare i seguenti quattro punti: -\begin{itemize} - \item permettere un utilizzo intuitivo, soprattutto per quanto riguarda la - sintassi dei comandi; - \item proporre dei comandi non solo per semplificare la stesura ma anche la - lettura del codice, migliorandone la semantica e rendendola più logica - (\lstinline=\ortho-diclorobenzene= è più leggibile e più comprensibile di - \lstinline=\textsl{o}-diclorobenzene=); - \item introdurre flessibilità e adattabilità ove possibile, in modo che ogni - utente possa adattare i comandi alle proprie necessità; - \item usare impostazioni predefinite conformi alle norme e le indicazioni della \ac{iupac}. -\end{itemize} -L'ultimo punto in particolare ha richiesto qualche incitamento da parte degli -utenti\footnote{Molte grazie al Dr.~Paul~King!} per applicare le -impostazioni giuste in numerosi punti. Se doveste notare qualcosa che non -corrisponde ai consigli \ac{iupac}\footnote{Questo non vale per il comando \cmd{ox}. -La versione \ac{iupac} è \cmd[oxa]{ox*}.} sarei molto grato di una notifica via -e-mail! - -In un pacchetto di questa mole comprendente parti meno e più recenti (le ultime -debbono essere considerate ancora in fase beta) non è possibile evitare la -presenza di errori o bug. Ho grande interesse a correggere e migliorare questo -pacchetto, e quindi prego tutti gli utenti che notino un funzionamento imprevisto -o indesiderato (anche se apparentemente insignificante) di mandarmi un'e-mail, e -vedrò di fare quel che posso. Sono particolarmente interessato a feedback -riguardante \chemformula (vedi la parte~\ref{part:chemformula}) e \ghsystem (vedi -la parte~\ref{part:ghsystem}), ma sono felice di ricevere feedback anche su -qualunque altra parte del bundle. - -\section{Installazione e caricamento del bundle}\secidx{Caricamento del -bundle}\secidx{Installazione} -Il bundle contiene tre fogli di stile\footnote{Con l'estensione \code{sty}.}, una -cartella di nome \code{language/} che contiene i file di definizione di lingua per -il GHS (estensione \code{def}) e una cartella di nome \code{pictures/} che -contiene immagini di tipo \code{eps}, \code{pdf}, \code{jpg} e \code{png} (i -pittogrammi GHS). Nel caso di un'installazione manuale \emph{è necessario copiare -le cartelle \code{language/} e \code{pictures/} nella \emph{stessa} cartella dei -fogli di stile}. - -Il caricamento di \chemmacros via -\begin{beispiel}[code only] - \usepackage{chemmacros} % `chemmacros', `chemformula' and `ghsystem' are loaded -\end{beispiel} -carica anche \chemformula e \ghsystem. È tuttavia possibile impedire a \chemmacros -di caricare \ghsystem: -\begin{beispiel}[code only] - \usepackage[ghsystem=false]{chemmacros} % `chemmacros' and `chemformula' are loaded -\end{beispiel} -Il caricamento di \chemformula non può essere evitato a causa dell'interazione tra -\chemmacros e \chemformula. - -Il caricamento esplicito di \chemformula o \ghsystem è possibile e carica -contemporaneamente anche \chemmacros, se non ancora caricato; implicitamente -quindi si caricano a vicenda. -\begin{beispiel}[code only] - \usepackage{chemformula} - or - \usepackage{ghsystem} -\end{beispiel} - -Si consiglia tuttavia di utilizzare solamente \lstinline=\usepackage{chemmacros}= -e di applicare le opzioni desiderate con \lstinline=\chemsetup= (confronta il -paragrafo~\ref{sec:setup}). -\secidx*{Installazione}\secidx*{Caricamento del pacchetto} - -\section{Opzioni globali}\label{sec:optionen}\secidx{Opzioni globali} -\chemmacros ha diverse opzioni, che seguono tutte il principio chiave/valore: -\begin{beispiel}[code only] - \usepackage[option1 = <value1>, option2 = <value2>]{chemmacros} -\end{beispiel} -La maggior parte delle opzioni può essere richiamata anche senza assegnargli un -valore (\lstinline+\usepackage[option]{chemmacros}+); in questo caso richiamano il -valore \default{sot\-to\-li\-ne\-a\-to}. - -Sia \chemformula che \ghsystem non hanno opzioni di pacchetto proprie; se caricati -esplicitamente, perdono tutte le opzioni passate loro, che devono poi essere -impostate con il comando di setup. -\chemmacros. -\begin{beschreibung} - % bpchem - \option[option]{bpchem}{\default{true}|false} Questa opzione carica \paket{bpchem} - e adatta il layout di \cmd{NMR} ai comandi propri di \paket{bpchem} - \lstinline+\HNMR+ e \lstinline+\CNMR+. Default = \code{false} - % circled - \option[option]{circled}{\default{formal}|all|none} \chemmacros distingue due - tipi di cariche:\footnote{Ringrazio Christoph Schäfer per avermi fatto notare - che la v1.1 trattava le cariche in modo poco coerente!} le cariche reali ($+/-$) - e quelle formali (\fplus/\fminus). L'opzione \code{formal} distingue tra i - due tipi, \code{all} le rappresenta tutte cerchiate, \code{none} tutte senza - cerchio. Default = \code{formal} - % circletype - \option[option]{circletype}{\default{chem}|math} Questa opzione varia tra due - rappresentazioni per le cariche formali: \cmd{fplus} \fplus\ e - \lstinline+$\oplus$+ $\oplus$. Default = \code{chem} - % cmversion - \option[option]{cmversion}{1|2|bundle} Questa opzione ripristina le definizioni - di alcuni comandi, in modo da compilare correttamente documenti composti - utilizzando v1.*. Default = \code{bundle}; in realtà \code{2} e \code{bundle} - sono equivalenti. L'opzione può essere impostata solamente nel preambolo. - % ghsystem - \option[option]{ghsystem}{\default{true}|false} Attiva/disattiva il pacchetto - \ghsystem. L'impostazione \key{ghs}{false} sopprime il caricamento di \ghsystem. - Default = \code{true} - % greek - \option[option]{greek}{auto|math|textgreek|\default{upgreek}} Questa opzione - determina come vengono rappresentate la lettera \cmd{Chemalpha} e le sue simili - (vedi a pagina~\pageref{desc:upgreek} per ulteriori informazioni). L'opzione - può essere impostata solo nel preambolo. Nota bene: l'opzione non carica né - \paket{upgreek} né \paket{textgreek}, bensì determina solamente quale dei due - viene utilizzato, se caricato. Scegliendo \code{upgreek}, è necessario - \emph{anche} caricare il pacchetto corrispondente. - Default = \code{auto} - % iupac - \option[option]{iupac}{auto|restricted|strict} Determina le impostazioni dei comandi - di nomenclatura (vedi a pagina~\pageref{desc:iupac}). Default = \code{auto} - % language - \option[option]{language}{american|british|english|french|german|italian|ngerman} - Carica impostazioni specifiche per una lingua. \code{english}, \code{american} - e \code{british} sono tra loro equivalenti, come anche \code{german} e \code{ngerman}. - L'opzione può essere impostata solo nel preambolo. Default = \code{english} - % method - \option[option]{method}{\default{chemformula}|mhchem} È possibile scegliere tra - \paket{mhchem} e \chemformula per gli ambienti di reazione di \chemmacros (vedi - il paragrafo~\ref{sec:reactions}) e per le particelle (vedi il paragrafo~\ref{sec:teilchen}). - Default = \code{chemformula}. L'opzione può essere impostata solo nel preambolo. - % Nu - \option[option]{Nu}{\default{chemmacros}|mathspec} Anche il pacchetto \paket{mathspec} - definisce una macro \cmd{Nu}; questa opzione decide quale definizione verrà - applicata (vedi a pagina~\pageref{Nu}). Default = \code{chemmacros}. L'opzione - può essere impostata solo nel preambolo. - % strict - \option[option]{strict}{\default{true}|false} L'impostazione \key{strict}{true} - trasforma tutti gli avvisi in messaggi di errore. Default = \code{false} - % synchronize - \option[option]{synchronize}{\default{true}|false} Impostando \code{true}, se - \chemformula è stato scelto come metodo \chemmacros ne adotta le impostazioni - di carattere. Default = \code{false}. Per dimostrare il funzionamento di questa - opzione, il documento è stato compilato con \key{synchronize}{true} e l'impostazione - di \chemformula \lstinline+\chemsetup[chemformula]{font-spec={[Color=darkgray]Latin Modern Sans}}+. - % xspace - \option[option]{xspace}{\default{true}|false} Con questa opzione la maggior parte - delle macro comprende un \lstinline+\xspace+. Default = \code{true} -\end{beschreibung} -\secidx*{Opzioni globali} - -\section{Setup}\label{sec:setup}\secidx{Setup} -Numerosi comandi di \chemmacros, \chemformula e \ghsystem hanno come opzioni delle -coppie chiave/valore attraverso le quali possono essere adattate. Tipicamente -possono essere utilizzate come argomento (opzionale) del comando, e in genere anche -con il comando \cmd{chemsetup}. -\begin{beschreibung} - \Befehl{chemsetup}[<module>]{<key> = <value>} oppure - \Befehl{chemsetup}{<module>/<key> = <value>} -\end{beschreibung} -Quasi tutte le opzioni appartengono ad un modulo, che indica quale comando vanno -ad influenzare. Quando viene presentata un'opzione, il suo modulo di appartenenza -viene qui segnato nel margine sinistro. Con il comando \cmd{chemsetup} è possibile -utilizzare le opzioni in due modalità diverse, come mostrato sopra. - -Le opzioni globali possono essere considerate anche come opzioni appartenenti al -modulo \textcolor{module}{\ttfamily option}; possono essere quindi richiamate anche -da \cmd{chemsetup}. -\begin{beispiel} - \chemsetup[option]{circled=none}\mch\ \pch\ \fmch\ \fpch\ \el\ \prt \\ - \chemsetup[option]{circled=formal}\mch\ \pch\ \fmch\ \fpch\ \el\ \prt \\ - \chemsetup[option]{circletype=math}\mch\ \pch\ \fmch\ \fpch\ \el\ \prt \\ - \chemsetup{option/circletype=chem,option/circled=all}\mch\ \pch\ \fmch\ \fpch\ \el\ \prt \\ - \chemsetup{option/circletype=math}\mch\ \pch\ \fmch\ \fpch\ \el\ \prt -\end{beispiel} -Le opzioni che non appartengono a nessun modulo \emph{non possono essere utilizzate} -con \cmd{chemsetup}! - -Tutte le opzioni di \chemformula appartengono al modulo \textcolor{module}{\code{chemformula}}, -e tutte le opzioni di \ghsystem appartengono al modulo \textcolor{module}{\code{ghs}}. -\secidx*{Setup} - -\section{Impostazioni di lingua}\label{sec:languages}\secidx{Impostazioni di lingua} -\subsection{Lingue supportate} -Impostando l'opzione -\begin{beispiel}[code only] - \chemsetup[option]{language=<language>} -\end{beispiel} -può essere selezionata una tra le seguenti lingue: \code{american}, \code{british}, -\code{english}, \code{french}, \code{german}, \code{italian} e \code{ngerman}. Le -lingue \code{american}, \code{british} e \code{english} sono tra loro equivalenti, -come anche le lingue \code{german} e \code{ngerman} - -Vengono tradotti -\begin{itemize} - \item Il titolo della lista delle reazioni. - \item Le voci della lista delle reazioni. - \item Le frasi H e P. -\end{itemize} - -\achtung{Attenzione: le frasi GHS non sono disponibili in tutte le lingue (vedi -anche il paragrafo~\ref{sec:ghsystem_language}).} - -\subsection{Particolarità} -\subsubsection{Tedesco} -Selezionando come lingua \code{german/ngerman} vengono tradotti i comandi di fase -\cmd{sld}, \cmd{lqd} nonché \cmd{pKa}. - -\subsubsection{Italiano} -Selezionando come lingua \code{italian} vengono definiti ulteriori comandi \ac{iupac}: -\begin{beschreibung} - \befehl{ter} \iupac{\ter} - \befehl{sin} \iupac{\sin} -\end{beschreibung} -\secidx*{Impostazioni di lingua} - -\section{Novità}\secidx{Novità} -\subsection{Versione 3.3} -\begin{itemize} - \item Dalla versione 3.3 è disponibile l'ambiente \env{experimental}{} (vedi il - paragrafo~\ref{sec:spektroskopie}), che può essere impiegato con alcuni nuovi - comandi e opzioni per riportare dei dati sperimentali in modo consistente. - \item L'ambiente \env{reaction}{} e i suoi simili sanno utilizzare - \lstinline+\label+, \lstinline+\ref+ e \lstinline+\intertext+ (vedi il - paragrafo~\ref{sec:reactions}). - \item Le opzioni globali \key{german} e \key{ngerman} vengono sostituite dall'opzione - \key{language} (vedi a pagina~\pageref{key:option_language} e il paragrafo~\ref{sec:languages} - da pagina~\pageref{sec:languages}). - \item L'opzione \key{upgreek} è stata rinominata a \key{greek}. - \item Ai comandi del tipo \code{\textbackslash\textcolor{code}{Chem<greekletter>}} - sono state aggiunte alcune lettere (vedi il paragrafo~\ref{sec:teilchen}). -\end{itemize} - -\subsection{Versione 3.3a} -\begin{itemize} - \item I comandi \ac{iupac} \cmd{hapto} e \cmd{bridge} sono nuovi. - \item Le frasi H e P sono ora disponibili anche in italiano. -\end{itemize} - -\subsection{Versione 3.3d} -\begin{itemize} - \item Versioni \code{pdf} dei pittogrammi \ac{ghs}. - \item Nuovi valori di default per lunghezza e offset dei legami, vedi a - pagina~\pageref{ssec:compounds:customization}. - \item Nuova opzione \key{bond-style}, vedi a - pagina~\pageref{ssec:compounds:customization}. - \item Nuova opzione \key{cip-kern}, vedi a pagina~\pageref{par:cip}. -\end{itemize} - -\subsection{Versione 3.4} -\begin{itemize} - \item \chemmacros ha ora un manuale italiano; tante grazie a Jonas Rivetti per la - sua traduzione sia delle frasi H \&\ P che di questo manuale! - \item Il comando \cmd{bond} permette di usare legami ulteriori a quello - singolo, doppio e triplo (vedi il sottoparagrafo~\ref{ssec:bonds}). Volevo - aggiungere questa funzionalità da molto tempo! - \item Alcuni cambiamenti all'aspetto del punto radicalico e nuove opzioni per la - sua personalizzazione (vedi il sottoparagrafo~\ref{ssec:compounds:customization}). -\end{itemize} - -\subsection{Versioni 3.5 e 3.6} -\begin{itemize} - \item Le interruzioni di riga che precedono o seguono i legami nelle formule non - sono più possibili. - \item Le interruzioni di riga seguenti le frecce di reazione nelle formule sono - ora permesse. - \item Alcuni degli spazi orizzontali nelle formule ora hanno dei componenti - elastici. - \item È ora possibile inserire un ambiente matematico protetto all'interno - delle formule anche con \cmd*{(} e \cmd*{)}. - \item Le nuove opzioni \key{radical-vshift}, \key{radical-hshift} e - \key{radical-space} permettono un controllo fine sul punto di radicale. - \item Nei fattori stechiometrici viene inserito uno zero iniziale quando mancante. - \item Nuova opzione \key{stoich-paren-parse}. - \item Numerose variazioni interne del codice. - \item Nuova opzione \key{arrow-min-length}. -\end{itemize} -\secidx*{Novità}\secidx*{PRIMA DI COMINCIARE} - -\part{\texorpdfstring{\Chemmacros}{chemmacros}}\secidx{CHEMMACROS} -\section{Particelle, ioni e simboli}\label{sec:teilchen}\secidx{Particelle, ioni e simboli} -\subsection{Predefiniti}\secidx[predefiniti]{Particelle, ioni e simboli} -\chemmacros definisce alcune semplici macro per raffigurare particelle e simboli -di uso comune. Si noti che questi possono essere rappresentati in modo diverso a -seconda delle opzioni globali utilizzate. I comandi possono essere utilizzati -anche in modalità matematica. -\begin{beschreibung} - \befehl{Hpl} \Hpl (protone) - \befehl{Hyd} \Hyd (ione idrossido) - \befehl{HtO} \HtO (ione ossonio) (\textbf{H} \textbf{t}hree \textbf{O}) - \befehl{water} \water - \befehl{el} \el (elettrone) - \befehl{prt} \prt (protone) - \befehl{ntr} \ntr (neutrone) - \befehl{Nu} \Nu (nucleofilo). Anche il pacchetto \paket{mathspec} definisce una - macro di nome \cmd{Nu}: selezionando l'opzione globale \key[option]{Nu}{mathspec}, - \chemmacros definisce una macro sostitutiva \cmd{Nuc}\label{Nu}. - \befehl{El} \El (elettrofilo) - \befehl{ba} \ba (base) - \befehl{fplus} \fplus - \befehl{fminus} \fminus - \befehl{transitionstatesymbol} \transitionstatesymbol - \befehl{standardstate} \standardstate. Questo simbolo viene reso da \chemmacros - solamente se non è caricato il pacchetto \paket{chemstyle}. L'idea proviene proprio - da questo pacchetto\footnote{Molte grazie al suo autore~\href{http://www.texdev.net/}{Joseph Wright}.}. - \befehl{Chemalpha} \Chemalpha - \befehl{Chembeta} \Chembeta - \befehl{Chemgamma} \Chemgamma - \befehl{Chemdelta} \Chemdelta - \befehl{Chemepsilon} \Chemepsilon - \befehl{Chemeta} \Chemeta - \befehl{Chemkappa} \Chemkappa - \befehl{Chemmu} \Chemmu - \befehl{Chemnu} \Chemnu - \befehl{Chemrho} \Chemrho - \befehl{Chempi} \Chempi - \befehl{Chemsigma} \Chemsigma - \befehl{Chemomega} \Chemomega - \befehl{ChemDelta} \ChemDelta -\end{beschreibung} - -\achtung{Il comando \cmd{Rad} non è più disponibile!} - -Entrambe le particelle \cmd{Nu} e \cmd{ba} possono essere adattate. Per farlo si -impiega l'opzione -\begin{beschreibung} - \Option[particle]{elpair}{false|\default{dots}|dash} -\end{beschreibung} -Questa ha effetto solo quando è caricato il pacchetto \paket{chemfig}, da cui -prende il comando \lstinline+\Lewis+. -\begin{beispiel} - % needs package `chemfig' - \ba[elpair] \Nu[elpair=dash] - - \chemsetup[particle]{elpair} - \ba \Nu -\end{beispiel} - -\label{desc:upgreek}Le lettere greche non sono comandi nuovi: la loro definizione -dipende dai pacchetti caricati. La loro versione predefinita corrisponde alle lettere -greche corsive proprie del modo matematico. Se è caricato il pacchetto \paket{textgreek}, -vengono utilizzate le sue lettere; se è caricato il pacchetto \paket{upgreek}, -vengono utilizzate le lettere di quest'ultimo. Questo manuale impiega \paket{upgreek}. -Quando sono caricati entrambi \paket{textgreek} e \paket{upgreek}, viene impiegato -automaticamente \paket{upgreek}. - -Nel caso in cui l'utente non voglia adattarsi alla selezione automatica di \chemmacros, -per scegliere autonomamente va impiegata l'opzione globale \key[option]{greek}. -La tabella~\ref{tab:upgreek_mode} mostra le diverse varianti di alcune lettere. - -\begin{table}[h] - \centering - \begin{tabular}{lccc}\toprule - & math & upgreek & textgreek \\\midrule - \cmd{Chemalpha} & $\alpha$ & $\upalpha$ & \textalpha \\ - \cmd{Chembeta} & $\beta$ & $\upbeta$ & \textbeta \\ - \cmd{ChemDelta} & $\Delta$ & $\Updelta$ & \textDelta \\ \bottomrule - \end{tabular} - \caption{Le lettere greche}\label{tab:upgreek_mode} -\end{table} - -La ragione per cui \chemmacros definisce queste macro è per conformarsi alle regole -\ac{iupac}: la \ac{iupac} consiglia di utilizzare lettere greche tonde nella nomenclatura. - -\begin{zitat}[{\ac{iupac} Green Book {\cite[][p.\,9]{iupac:greenbook}}}] - Greek letters are used in systematic organic, inorganic, macromolecular and - biochemical nomenclature. These should be roman (upright), since they are not - symbols for physical quantities. -\end{zitat} - -\chemmacros impiega questi comandi per definire comandi di nomenclatura (vedi a -pagina~\pageref{par:greek_letters}). - -\subsection{Definire particelle proprie}\secidx[proprie]{Particelle, ioni e simboli} -Talvolta può essere utile avere a disposizione delle ulteriori particelle come macro, -come ad esempio \lstinline+\positron+ oppure \lstinline+\photon+. È possibile -definirle agevolmente con i seguenti comandi: -\begin{beschreibung} - \Befehl{DeclareChemParticle}{<cmd>}\ma{<definition>} - \Befehl{RenewChemParticle}{<cmd>}\ma{<definition>} -\end{beschreibung} -A seconda del \key{method} scelto come opzione, la \code{<definition>} viene svolta -alternativamente con \paket{mhchem} o con \chemformula. La particella si comporta -come quelle predefinite, tranne che per un'eccezione: la particella così definita -obbedisce all'opzione \key{circled} solamente se è stato selezionato -\key{method}{chemformula}. Se si desiderano cariche formali con \key{method}{mhchem}, -è necessario richiamare i comandi di \chemmacros in modo esplicito (vedi il -paragrafo~\ref{sec:ladungen}). -\begin{beispiel} - % uses the `upgreek' package - \DeclareChemParticle{\positron}{$\upbeta$+} - \DeclareChemParticle{\photon}{$\upgamma$} - \RenewChemParticle{\el}{$\upbeta$-} - \positron\ \photon\ \el -\end{beispiel} -\cmd{DeclareChemParticle} definisce la particella solamente se \code{<cmd>} non -esiste ancora. In caso diverso \chemmacros restituisce un avvertimento oppure un -errore, dipendentemente dall'opzione \key{strict}. \cmd{RenewChemParticle} definisce -una particella \emph{solamente} se \code{<cmd>} è \emph{già} esistente e restituisce -un avvertimento o un errore in caso contrario. -\secidx*{Particelle, ioni e simboli} - -\section{Nomenclatura, stereodescrittori e termini in latino}\label{sec:stereo} -\subsection{Nomi IUPAC}\secidx{Nomi IUPAC} -Analogamente al pacchetto \paket{bpchem} anche \chemmacros mette a disposizione -un comando\footnote{L'idea e la realizzazione provengono dal pacchetto \paket*{bpchem} -di Bjørn Pedersen.} per inserire nomi \ac{iupac}. La sua utilità deriva da un -motivo molto semplice: i nomi \ac{iupac} possono diventare particolarmente lunghi, -così lunghi da riempire anche più di due righe, specialmente all'interno di documenti -in due colonne. Ciò significa che devono poter essere divisi più di una volta. Per -metterlo in pratica si può utilizzare il seguente comando: -\begin{beschreibung} - \befehl{iupac}{<IUPAC name>} All'interno di questo comando vengono impiegati - {\catcode`\|=11\cmd{|}} e \cmd{-} per segnare punti di divisione oppure un - trattino separatore. {\catcode`\^=11\cmd{^}} può essere utilizzato come - abbreviazione per \lstinline=\textsuperscript=. -\end{beschreibung} -\begin{beispiel} - \begin{minipage}{.4\linewidth} - \iupac{Tetra\|ciclo[2.2.2.1\^{1,4}]\-un\|decano-2\-dodecil\-5\-(epta\|decil\|iso\|dodecil\|tio\|estere)} - \end{minipage} -\end{beispiel} -Nonostante ciò, il comando \cmd{iupac} è più che altro un comando semantico. Nella -maggior parte dei casi si può raggiungere un risultato (quasi) identico utilizzando -\cmd{-} anziché {\catcode`\|=11\cmd{|}}, \code{-} anziché \cmd{-} e -\lstinline=\textsuperscript= anziché {\catcode`\^=11\cmd{^}}. - -Vi sono delle sottili differenze: \cmd{-} inserisce un sottile spazio prima del -trattino e rimuove un sottile spazio dopo. Il comando {\catcode`\|=11\cmd{|}} non -evita solo le legature, bensì inserisce anche un sottile spazio. -\begin{beispiel} - \huge\iupac{2,4\-di\|cloro\|pentano} \\ - 2,4-dicloropentano -\end{beispiel} - -Gli spazi inseriti possono essere adattati: -\begin{beschreibung} - \option[iupac]{hyphen-pre-space}{<dim>} default = \code{.01em} - \option[iupac]{hyphen-post-space}{<dim>} default = \code{-.03em} - \option[iupac]{break-space}{<dim>} default = \code{.01em} -\end{beschreibung} - -Il comando \cmd{iupac} serve anche ad un altro scopo: indipendentemente dall'opzione -globale \key[option]{iupac} tutti i comandi presentati in questo paragrafo sono -sempre definiti \emph{internamente} a \cmd{iupac}. Tutta una serie di comandi di -nomenclatura ha nomi molto generici come \cmd{meta}, \cmd{D}, \cmd{E}, \cmd{L}, -\cmd{R}, \cmd{S}, \cmd{trans} e così via; ne segue che spesso sono già predefiniti -(\cmd{L} \L) oppure facilmente modificati da altri pacchetti o altre classi (ad -esempio, il pacchetto \paket{cool} definisce sia \cmd{D} che \cmd{E}). Per potere -controllare quali comandi siano definiti e come, esiste l'opzione globale -\key[option]{iupac}\label{desc:iupac}, con tre modalità di utilizzo: -\begin{itemize} - \item \key{iupac}{auto}: se il comando \emph{non è definito} all'interno di un - pacchetto o una classe in uso è disponibile generalmente, altrimenti solo - \emph{all'interno} di \cmd{iupac}. - \item \key{iupac}{restricted}: tutti i comandi di nomenclatura sono definiti - \emph{solo internamente} a \cmd{iupac}. Sono disponibili esternamente solo se - definiti da un'altro pacchetto. - \item \key{iupac}{strict}: \chemmacros sovrascrive ogni definizione preesistente - e rende disponibili i comandi \emph{in tutto il documento}. Possono essere ridefiniti - (solo dopo \lstinline=\begin{document}=). Mantengono il significato di nomenclatura - all'interno di \cmd{iupac}. -\end{itemize} -Nella tabella~\ref{tab:iupac_modes} è dimostrato il funzionamento delle diverse modalità. - -\begin{table}[h] - \centering - \begin{tabular}{lccc}\toprule - & auto & restricted & strict \\\midrule - \lstinline=\L= & \L & \L & \iupac{\L} \\ - \lstinline=\iupac{\L}= & \iupac{\L} & \iupac{\L} & \iupac{\L} \\ - \lstinline=\D= & \D & -- & \D \\ - \lstinline=\iupac{\D}= & \iupac{\D} & \iupac{\D} & \iupac{\D} \\\bottomrule - \end{tabular} - \caption{Esempio dimostrativo del funzionamento delle diverse modalità di \protect\key{iupac}.}\label{tab:iupac_modes} -\end{table} - -\subsubsection{Comandi predefiniti}\secidx[predefiniti]{Nomi IUPAC}\secidx{Stereodescrittori e nomenclatura} -\paragraph{Caratteri greci}\label{par:greek_letters}\secidx[caratteri greci]{Nomi IUPAC} -Le lettere greche all'interno dei nomi di composti vanno scritte in carattere tondo; -per realizzarlo sono impiegati i pacchetti \paket{upgreek} e \paket{textgreek}. -Quando viene caricato uno dei due, vengono scritti in tondo i seguenti caratteri: -\begin{beschreibung} - \befehl{a} \iupac{\a} - \befehl{b} \iupac{\b} - \befehl{g} \iupac{\g} - \befehl{d} \iupac{\d} - \befehl{k} \iupac{\k} - \befehl{m} \iupac{\m} - \befehl{n} \iupac{\n} - \befehl{w} \iupac{\w} -\end{beschreibung} -\begin{beispiel} - \iupac{5\a\-androstan\-3\b\-olo} \\ - \iupac{\a\-(tri\|cloro\|metil)\-\w\-cloro\|poli(1,4\-fenilene\|metilene)} -\end{beispiel} - -\paragraph{Eteroatomi e idrogeni aggiunti}\secidx[Eteroatomi]{Nomi IUPAC} -I legami agli eteroatomi e gli idrogeni aggiunti sono rappresentati da caratteri -corsivi \cite{iupac:greenbook}. \chemmacros definisce alcune abbreviazioni: -\begin{beschreibung} - \befehl{H} \iupac{\H} - \befehl{O} \iupac{\O} - \befehl{N} \iupac{\N} - \befehl{Sf} \iupac{\Sf} - \befehl{P} \iupac{\P} -\end{beschreibung} -\begin{beispiel} - \iupac{\N\-methyl\|benz\|amide} \\ - \iupac{3\H\-pyrrole} \\ - \iupac{\O\-ethyl hexanethioate} -\end{beispiel} - -\paragraph{Cahn-Ingold-Prelog}\index{Cahn-Ingold-Prelog}\secidx[Cahn-Ingold-Prelog]{Nomi IUPAC}\label{par:cip} -\begin{beschreibung} - \befehl{cip}{<conf>} \pes: \cmd{cip}{R,S} \cip{R,S} - \befehl{R} \iupac{\R} - \befehl{S} \iupac{\S} -\end{beschreibung} -Dato che il comando \cmd{S} ha già un altro significato (\S) come impostazione di -default è disponibile solo all'interno di \cmd{iupac}. - -Sia i comandi che i descrittori \emph{entgegen}/\emph{zusammen} ricevono un po' di -kerning aggiuntivo dopo la parentesi chiusa. La sua quantità può essere variata -attraverso l'opzione seguente: -\begin{beschreibung} - \option[iupac]{cip-kern}{<dim>} ammontare del kerning dopo la parentesi chiusa. - Default = \code{.075em} -\end{beschreibung} - -\paragraph{Fischer}\index{Fischer}\secidx[Fischer]{Nomi IUPAC} -\begin{beschreibung} - \befehl{D} \iupac{\D} - \befehl{L} \iupac{\L} -\end{beschreibung} -Dato che il comando \cmd{L} ha già un altro significato (\L) come impostazione di -default è disponibile solo all'interno di \cmd{iupac}. - -\paragraph{cis/trans, zusammen/entgegen, sin/anti \& tert}\index{tert}\secidx[tert]{Nomi IUPAC}\index{cis/trans}\secidx[cis/trans]{Nomi IUPAC}\index{zusammen/entgegen}\secidx[zusammen/entgegen]{Nomi IUPAC}\secidx[sin/anti]{Nomi IUPAC} -\begin{beschreibung} - \befehl{cis} \cis - \befehl{trans} \trans - \befehl{Z} \Z - \befehl{E} \E - \befehl{syn} \syn - \befehl{anti} \anti - \befehl{tert} \tert -\end{beschreibung} -Anche il pacchetto \paket{cool} definisce i comandi \cmd{E} e \cmd{D}. Quando viene -caricato, come impostazione predefinita la loro versione in \chemmacros è disponibile -solo all'interno di \cmd{iupac}. - -\paragraph{orto/meta/para}\index{orto/meta/para}\secidx[orto/meta/para]{Nomi IUPAC} -\begin{beschreibung} - \befehl{ortho} \ortho - \befehl{meta} \meta - \befehl{para} \para -\end{beschreibung} - -\paragraph{Configurazione assoluta}\index{Configurazione assoluta} (utilizza \TikZ) -\begin{beschreibung} - \befehl{Rconf}[<letter>] \cmd{Rconf}: \Rconf \quad\cmd{Rconf}[]: \Rconf[] - \befehl{Sconf}[<letter>] \cmd{Sconf}: \Sconf \quad\cmd{Sconf}[]: \Sconf[] -\end{beschreibung} - -Esempi: -\begin{beispiel} - \iupac{acido \D\-tartar\|ico} = - \iupac{acido \cip{2S,3S}\-tartar\|ico} \\ - \iupac{\D\-($-$)\-treosio} = - \iupac{\cip{2S,3R}\-($-$)\-2,3,4\-tri\|idrossi\|butanale} \\ - \iupac{\cis\-2\-butene} = - \iupac{\Z\-2\-butene} \\ - \iupac{\cip{2E,4Z}\-esa\|diene} \\ - \iupac{\meta\-xilene} = - \iupac{1,3\-di\|metil\|benzene} -\end{beispiel} -\secidx*{Stereodescrittori e nomenclatura} - -\paragraph{Chimica di coordinazione} -\chemmacros mette a disposizione due comandi che possono essere utili in chimica -di coordinazione: -\begin{beschreibung} - \befehl{bridge}{<num>} \bridge{3} - \befehl{hapto}{<num>} \hapto{5} -\end{beschreibung} -\begin{beispiel} - Ferrocene = \iupac{bis(\hapto{5}cyclo\|penta\|dienyl)iron} \\ - \iupac{tetra\-\bridge{3}iodido\-tetrakis[tri\|methyl\|platinum(IV)]} -\end{beispiel} - -Sono disponibili due opzioni per l'adattamento: -\begin{beschreibung} - \option[iupac]{bridge-number}{sub|super} appende il numero come apice o pedice; - \ac{iupac} consiglia l'uso del pedice \cite{iupac:redbook}. Default = \code{sub} - \option[iupac]{coord-use-hyphen}{\default{true}|false} appende un trattino a - \cmd{hapto} e \cmd{bridge} quando vale \code{true}. Default = \code{true} -\end{beschreibung} - -\subsubsection{Comandi di nomenclatura propri}\secidx[propri]{Nomi IUPAC} -Se l'utente avesse bisogno di nuovi comandi è possibile definirli nel modo seguente: -\begin{beschreibung} - \Befehl{DeclareChemIUPAC}{<cmd>}\ma{<declaration>} - \Befehl{RenewChemIUPAC}{<cmd>}\ma{<declaration>} -\end{beschreibung} -Un comando definito in questa maniera obbedisce all'opzione \key[option]{iupac}. -Eventuali comandi preesistenti vengono sostituiti solamente se è attiva l'opzione -globale \key{iupac}{strict}. \cmd{DeclareChemIUPAC} \emph{non sostituisce} la -definizione di un comando di nomenclatura preesistente, bensì restituisce -un'avvertimento o un errore (in base all'opzione globale \key{strict}). -\begin{beispiel} - \DeclareChemIUPAC\endo{\textit{endo}} - \RenewChemIUPAC\anti{\textit{anti}} - \iupac{(2\-\endo,7\-\anti)\-2\-bromo\-7\-fluoro\|bicyclo[2.2.1]heptane} -\end{beispiel} - -\cmd{RenewChemIUPAC} permette di ridefinire i comandi predefiniti. -\begin{beispiel} - \iupac{\meta\-xilene} \\ - \RenewChemIUPAC\meta{\textit{m}} - \iupac{\meta\-xilene} -\end{beispiel} -\secidx*{Nomi IUPAC} - -\subsection{Termini in latino}\secidx{Termini in latino} -Il pacchetto \paket{chemstyle} mette a disposizione il comando \cmd{latin} per -riportare termini latini comuni in modo consistente. \chemmacros definisce un -comando \cmd{latin} analogo solamente se \paket{chemstyle} \emph{non} è caricato; -mette inoltre a disposizione i seguenti comandi: -\begin{beschreibung} - \befehl{insitu} \insitu - \befehl{abinitio} \abinitio - \befehl{invacuo} \invacuo -\end{beschreibung} - -Nel caso sia caricato il pacchetto \paket{chemstyle}, i comandi sono stati già -definiti con il suo comando \lstinline+\latin+; il loro aspetto dipende quindi -dall'opzione \code{abbremph} di \paket{chemstyle}. - -Le macro sono state definite con il comando seguente: -\begin{beschreibung} - \Befehl{DeclareChemLatin}{<cmd>}\ma{<phrase>} - \Befehl{RenewChemLatin}{<cmd>}\ma{<phrase>} -\end{beschreibung} -\begin{beispiel} - \DeclareChemLatin\ltn{latin text} - \ltn -\end{beispiel} -Nel caso in cui \paket{chemstyle} \emph{non} sia stato caricato è possibile -cambiarne l'aspetto tramite l'opzione seguente: -\begin{beschreibung} - \option[latin]{format}{<definition>} Default = \lstinline+\itshape+ -\end{beschreibung} -\secidx*{Termini in latino} - -\section{Unità di misura per l'impiego con \textsf{siunitx}}\label{sec:einheiten}\secidx{Unità di misura}[Unita di misura] -In chimica sono largamente impiegate alcune unità non-SI. Il pacchetto -\paket{siunitx} mette a disposizione il comando \lstinline+\DeclareSIUnit{<command>}{<unit>}+ -per definire unità arbitrarie, e \chemmacros impiega questo comando per definire -le unità elencate in seguito. Come tutte le unità di misura di \paket{siunitx}, -anche queste unità aggiuntive sono valide solamente all'interno di \lstinline+\SI{<num>}{<unit>}+ -e \lstinline+\si{<unit>}+. -\begin{beschreibung} - \befehl{atmosphere} \si{\atmosphere} - \befehl{atm} \si{\atm} - \befehl{calory} \si{\calory} - \befehl{cal} \si{\cal} - \befehl{cmc} \si{\cmc} Le unità \cmd{cmc}, \cmd{molar} e \cmd{Molar} sono - definite anche dal pacchetto \paket{chemstyle}; \chemmacros le definisce solo - nel caso in cui \paket{chemstyle} non sia stato caricato. - \befehl{molar} \si{\molar} - \befehl{moLar} \si{\moLar} - \befehl{Molar} \si{\Molar} - \befehl{MolMass} \si{\MolMass} - \befehl{normal} \si{\normal} - \befehl{torr} \si{\torr} -\end{beschreibung} - -Nota bene: \lstinline+\mmHg+ \si{\mmHg} è messo a disposizione da \paket{siunitx} -e \paket{chemstyle}. -\secidx*{Unità di misura}[Unita di misura] - -\section{Acidi/basi}\label{sec:saeure_base}\secidx{Acidi/basi} -È possibile rappresentare semplicemente \pH, \pKa \ldots\ (la resa dei comandi -\cmd{Ka} e \cmd{pKa} dipende dall'opzione globale \key{language}). -\begin{beschreibung} - \befehl{pH} \pH - \befehl{pOH} \pOH - \befehl{Ka} \Ka - \befehl{Kb} \Kb - \befehl{Kw} \Kw - \befehl{pKa}[<num>] \cmd{pKa}: \pKa, \cmd{pKa}[1]: \pKa[1] - \befehl{pKb}[<num>] \cmd{pKb}: \pKb, \cmd{pKb}[1]: \pKb[1] - \befehl{p}{<anything>} \pes: \cmd{p}{\cmd{Kw}} \p{\Kw} -\end{beschreibung} - -\begin{beispiel} - \Ka \Kb \pKa \pKa[1] \pKb \pKb[1] -\end{beispiel} - -\achtung{L'aspetto predefinito dei comandi di tipo \p{} è stato modificato per -accogliere l'indicazione \ac{iupac}.} -\begin{zitat}[{\ac{iupac} Green Book {\cite[][p.\,103]{iupac:greenbook}}}] - The operator \p{} \textelp{} shall be printed in Roman type. -\end{zitat} - -Esiste un'opzione che varia lo stile di rappresentazione di \p{}: -\begin{beschreibung} - \option[acid-base]{p-style}{italics|slanted|upright} Default = \code{upright} -\end{beschreibung} -\begin{beispiel} - \pH, \pKa - - \chemsetup[acid-base]{p-style=slanted} \pH, \pKa - - \chemsetup[acid-base]{p-style=italics} \pH, \pKa -\end{beispiel} -\secidx*{Acido/base} - -\section{Numeri di ossidazione, cariche reali e formali}\label{sec:ladungen} -\chemmacros distingue tra simboli di cariche reali ($+$/$-$) e formali (\fplus/\fminus) -(vedi anche il paragrafo~\ref{sec:optionen}). Tutti i comandi che restituiscono -cariche formali iniziano con la lettera \code{f}. - -\subsection{Cariche ioniche}\label{ssec:ionen}\secidx{Cariche ioniche} -Le cariche (reali) sono di facile impiego. Si noti che i comandi sono stati -introdotti quando \chemmacros aveva ancora come obbiettivo l'alta compatibilità -con \paket{mhchem}, e \Chemformula non esisteva ancora. Sono ancora disponibili, -anche se personalmente consiglio di usare \cmd{ch} (vedi~ref{part:chemformula}) -e di dimenticare questi comandi. -\begin{beschreibung} - \befehl{pch}[<number>] carica positiva (\textbf{p}lus + \textbf{ch}arge) - \befehl{mch}[<number>] carica negativa (\textbf{m}inus + \textbf{ch}arge) -\end{beschreibung} - -\begin{beispiel} - \pch, Na\pch, Ca\pch[2]\\ - \mch, F\mch, S\mch[2] -\end{beispiel} - -Altrettanto vale per le cariche formali: -\begin{beschreibung} - \befehl{fpch}[<number>] carica positiva - \befehl{fmch}[<number>] carica negativa -\end{beschreibung} - -\begin{beispiel} - \fpch\ \fmch\ \fpch[3] \fmch[3] -\end{beispiel} - -Esiste un'opzione che influenza il comportamento delle cariche: -\begin{beschreibung} - \option[charges]{append}{\default{true}|false} Quando è impostata a \code{true}, - la carica viene appesa ad un gruppo vuoto. Default = \code{false} -\end{beschreibung} - -Questo ha delle conseguenze: -\begin{beispiel} - % uses package `mhchem' - \chemsetup{charges/append=false,phases/pos=sub} - \ce{H\pch\aq} \ce{H\aq\pch} - - \chemsetup[charges]{append=true} - \ce{H\pch\aq} \ce{H\aq\pch} -\end{beispiel} - -Nella maggior parte dei casi questo comportamento può essere indesiderato, anche -se esistono delle occasioni dove può tornare utile: -\begin{beispiel} - \chemsetup{charges/append=false,phases/pos=sub} - \ce{\ox{1,H}\pch\aq} - - \chemsetup[charges]{append=true} - \ce{\ox{1,H}\pch\aq} -\end{beispiel} -\secidx*{Cariche ioniche} - -\subsection{Numeri di ossidazione}\label{ssec:oxidationszahlen}\secidx{Numeri di ossidazione} -Inserimento di numeri di ossidazione: -\begin{beschreibung} - \befehl{ox}[<options>]{<number>,<atom>} inserisce \code{<number>} al di sopra di - \code{<atom>}; \code{<number>} deve essere un numero (razionale)! -\end{beschreibung} - -\begin{beispiel} - \ox{+1,Na}, \ox{2,Ca}, \ox{-2,S}, \ox{-1,F} -\end{beispiel} - -Esiste una serie di opzioni con le quali è possibile adattare \cmd{ox}. -\begin{beschreibung} - \option[ox]{parse}{\default{true}|false} Quando vale \code{false}, può essere - inserito un contenuto qualunque per \code{<number>}. Default = \code{true} - \option[ox]{roman}{\default{true}|false} Seleziona l'impiego di numeri romani o - arabi. Default = \code{true} - \option[ox]{pos}{top|super|side} Varia la posizione del numero di ossidazione: - \code{top} pone \code{<number>} al di sopra di \code{<atom>}, \code{super} come - apice alla destra e \code{side} a destra tra parentesi. Default = \code{top} - \option[ox]{explicit-sign}{\default{true}|false} Restituisce $+$ per numeri positivi - e $\pm$ per $0$ aus. Default = \code{false} - \option[ox]{decimal-marker}{comma|point} Sceglie il tipo di segno decimale per - i numeri di ossidazione come \ox{1.2,X}. Default = \code{point} - \option[ox]{align}{center|right} Centra il numero di ossidazione sopra l'atomo - o lo giustifica a destra. Default = \code{center} -\end{beschreibung} - -\begin{beispiel} - \ox[roman=false]{2,Ca} \ox{2,Ca} \\ - \ox[pos=super]{3,Fe}-oxide \\ - \ox[pos=side]{3,Fe}-oxide \\ - \ox[parse=false]{?,Mn} \\ - \ox[align=right]{2,Ca} -\end{beispiel} - -La variante \key[ox]{pos}{super} può essere selezionata anche tramite -l'abbreviazione \cmd[oxa]{ox*}: -\begin{beispiel} - \ox{3,Fe} \ox*{3,Fe} -\end{beispiel} - -Impiegando \key[ox]{explicit-sign} viene sempre indicato il segno del numero di -ossidazione: -\begin{beispiel} - \chemsetup[ox]{explicit-sign = true} - \ox{+1,Na}, \ox{2,Ca}, \ox{-2,S}, \ch{"\ox{0,F}" {}2} -\end{beispiel} - -\begin{beispiel} - Si confronti ad esempio \ox{-1,\ch{O2^2-}} con \ch{"\ox{-1,O}" {}2^2-} -\end{beispiel} - -Talvolta è necessario impiegare numeri d'ossidazione formali come \num{.5} oppure -$\frac{1}{3}$: -\begin{beispiel} - \ox{.5,\ch{Br2}} \ch{"\ox{1/3,I}" {}3+} -\end{beispiel} - -La frazione impiega il comando \lstinline+\sfrac+ del pacchetto \paket{xfrac}. A -questo proposito è definita l'istanza \lstinline+chemmacros-ox-frac+. -\begin{beispiel}[code only] -\DeclareInstance{xfrac}{chemmacros-ox-frac}{text} - { - scale-factor = 1.2 , - denominator-bot-sep = -.5ex , - numerator-top-sep = -.3ex , - slash-left-kern = -.2em , - slash-right-kern = -.2em , - slash-symbol-font = lmr - } -\end{beispiel} -Naturalmente può essere ridefinita a seconda dei propri gusti. -\secidx*{Numeri di ossidazione} - -\subsection{Cariche parziali e simili}\label{ssec:partialladungen}\secidx{Cariche parziali} -Sono poco usate, ma possono risultare utili: -\begin{beschreibung} - \befehl{delp} \delp\ (\textbf{del}ta + \textbf{p}lus) - \befehl{delm} \delm\ (\textbf{del}ta + \textbf{m}inus) - \befehl{fdelp} \fdelp - \befehl{fdelm} \fdelm -\end{beschreibung} - -Segue un esempio con il comando \cmd{ox} oppure con il pacchetto \paket{chemfig}: -\begin{beispiel} - \chemsetup{ - option/circled = all, - ox/parse = false - } - \ce{\ox{\delp,H}-\ox{\delm,Cl}} \hspace*{1cm} - \chemfig{\chemabove[3pt]{\lewis{246,Br}}{\delm}-\chemabove[3pt]{H}{\delp}} -\end{beispiel} - -Anche queste macro possono essere utilizzate comodamente con \paket{chemfig}. -\begin{beschreibung} - \befehl{scrp} \scrp\ (\textbf{scr}iptstyle + \textbf{p}lus) - \befehl{scrm} \scrm\ (\textbf{scr}iptstyle + \textbf{m}inus) - \befehl{fscrp} \fscrp - \befehl{fscrm} \fscrm - \befehl{fsscrp} \fsscrp\ (impiega \lstinline+\scriptscriptstyle+) - \befehl{fsscrm} \fsscrm -\end{beschreibung} - -\begin{beispiel} - \setatomsep{1.8em}\chemfig{CH_3-\chemabove{C}{\scrp}(-[6]C|H_3)-\vphantom{H_3}CH_3} - - \chemfig{\fmch{}|O-\chemabove{N}{\fscrp}(-[1]O|\fmch)-[7]O|\fmch} -\end{beispiel} -\secidx*{Cariche parziali} - -\section{Meccanismi di reazione}\label{sec:mechanismen}\secidx{Meccanismi di reazione} -Con il comando -\begin{beschreibung} - \Befehl{mech}[<type>] -\end{beschreibung} -è possibile specificare i meccanismi di reazione più diffusi. \code{<type>} può -assumere uno dei valori seguenti: -\begin{beschreibung} - \befehl{mech} (vuoto, nessun argomento opzionale) sostituzione nucleofila \mech - \befehl{mech}[1] sostituzione nucleofila unimolecolare \mech[1] - \befehl{mech}[2] sostituzione nucleofila bimolecolare \mech[2] - \befehl{mech}[se] sostituzione elettrofila \mech[se] - \befehl{mech}[1e] sostituzione elettrofila unimolecolare \mech[1e] - \befehl{mech}[2e] sostituzione elettrofila bimolecolare \mech[2e] - \befehl{mech}[ar] sostituzione elettrofila aromatica \mech[ar] - \befehl{mech}[e] eliminazione \mech[e] - \befehl{mech}[e1] eliminazione unimolecolare \mech[e1] - \befehl{mech}[e2] eliminazione bimolecolare \mech[e2] - \befehl{mech}[cb] eliminazione unimolecolare \enquote{conjugated base}, cioè via - carbanione \mech[cb] -\end{beschreibung} -\secidx*{Meccanismi di reazione} - -% TODO: watch pagebreaks! -\section{Reazioni redox}\label{sec:redoxreaktionen}\secidx{Reazioni redox} -\chemmacros mette a disposizione due comandi con cui mostrare il trasferimento -di elettroni nelle reazioni redox\footnote{Ringrazio~\href{http://www.mathannotated.com/}{Peter Cao}, -che ha proposto questa funzione.}. Entrambi i comandi utilizzano \TikZ. -\begin{beschreibung} - \Befehl{OX}{<name>,<atom>} - \Befehl{redox}(<name1>,<name2>)[<tikz>]\oa{<num>}\ma{<text>} \cnpkgdocarrow\ È - necessario solamente il primo argomento\\\da{<name1>,<name2>}; gli altri due - sono opzionali. -\end{beschreibung} - -\cmd{OX} pone \code{<atom>} in un nodo (un \enquote{node}) dal nome \code{<name>}. -Una volta impiegati due \cmd{OX}, questi possono essere collegati tramite \cmd{redox}; -i nomi dei nodi da collegare vanno posti tra parentesi tonde. Dato che \cmd{redox} -crea una Tikzpicture con le opzioni \code{remember picture,overlay}, il documento -deve essere compilato \emph{almeno due volte}. -\begin{beispiel}[dist] - \OX{a,Na} $\rightarrow$ \OX{b,Na}\pch\redox(a,b){ossidazione} -\end{beispiel} -Questa linea può essere adattata con chiavi \TikZ entro \oa{<tikz>}: -\begin{beispiel}[dist] - \OX{a,Na} $\rightarrow$ \OX{b,Na}\pch\redox(a,b)[->,red]{ox} -\end{beispiel} - -Con l'argomento \oa{<num>} si può adattare la lunghezza delle linee verticali. -L'impostazione predefinita vale \code{.6em}, lunghezza che poi viene moltiplicata -per \code{<num>}. Un valore negativo pone la linea \emph{sotto} il testo. -\begin{beispiel}[dist] - \OX{a,Na} $\rightarrow$ \OX{b,Na}\pch - \redox(a,b)[->,red]{ox} - \redox(a,b)[<-,blue][-1]{red} - \vspace{7mm} -\end{beispiel} - -Con la chiave -\begin{beschreibung} - \option[redox]{dist}{<dim>} Default = \code{.6em} -\end{beschreibung} -è possibile aggiustare il valore predefinito delle linee verticali: -\begin{beispiel}[dist] - \chemsetup{redox/dist=1em} - \OX{a,Na} $\rightarrow$ \OX{b,Na}\pch\redox(a,b)[->,red]{ox} -\end{beispiel} - -Inoltre l'opzione -\begin{beschreibung} - \option[redox]{sep}{<dim>} Default = \code{.2em} -\end{beschreibung} -permette di variare la distanza tra atomo e inizio della linea. -\begin{beispiel}[dist] - \chemsetup{redox/sep=.5em} - \OX{a,Na} $\rightarrow$ \OX{b,Na}\pch\redox(a,b)[->,red]{ox} -\end{beispiel} - -% TODO: watch pagebreaks! -Esempi: -\begin{beispiel}[dist] - \ch{ 2 "\OX{o1,Na}" + "\OX{r1,Cl}" {}2 -> 2 "\OX{o2,Na}" \pch{} + 2 -"\OX{r2,Cl}" \mch } - \redox(o1,o2){\small OX: $- 2\el$} - \redox(r1,r2)[][-1]{\small RED: $+ 2\el$} - \vspace{7mm} -\end{beispiel} - -\begin{beispiel}[dist] - \ch{ 2 "\OX{o1,\ox{0,Na}}" + "\OX{r1,\ox{0,Cl}}" {}2 -> 2 "\OX{o2,\ox{+1,Na}}" -\pch{} + 2 "\OX{r2,\ox{-1,Cl}}" \mch } - \redox(o1,o2){\small OX: $- 2\el$} - \redox(r1,r2)[][-1]{\small RED: $+ 2\el$} - \vspace{7mm} -\end{beispiel} -\bspmidlength{dist}{15mm} -\begin{beispiel}[dist] - \ch{ 2 "\OX{o1,\ox{0,Na}}" + "\OX{r1,\ox{0,Cl}}" {}2 -> 2 "\OX{o2,\ox{+1,Na}}" -\pch{} + 2 "\OX{r2,\ox{-1,Cl}}" \mch } - \redox(o1,o2)[draw=red,->][3.33]{\small OX: $- 2\el$} - \redox(r1,r2)[draw=blue,->]{\small RED: $+ 2\el$} -\end{beispiel} - -\bspmidlength{dist}{7mm} - \begin{beispiel}[dist] - \ch{ 2 "\OX{o1,\ox{0,Na}}" + "\OX{r1,\ox{0,Cl}}" {}2 -> 2 "\OX{o2,\ox{+1,Na}}" -\pch{} + 2 "\OX{r2,\ox{-1,Cl}}" \mch } - \redox(o1,o2)[green,-stealth]{\small OX} - \redox(r1,r2)[purple,-stealth][-1]{\small RED} - \vspace{7mm} -\end{beispiel} -\secidx*{Reazioni redox} - -% TODO: watch pagebreaks! -\newpage -\section{Stati (standard), termodinamica}\label{sec:standardstate}\secidx{Termodinamica} -\subsection{Grandezze termodinamiche}\label{ssec:siunitx} -I comandi seguenti impiegano \paket{siunitx}: -\begin{beschreibung} - \Befehl{Enthalpy}[<options>]\da{<subscript>}\ma{<value>} - \Befehl{Entropy}[<options>]\da{<subscript>}\ma{<value>} - \Befehl{Gibbs}[<options>]\da{<subscript>}\ma{<value>} -\end{beschreibung} - -Il loro utilizzo si spiega da sé: -\begin{beispiel} - \Enthalpy{123} \\ - \Entropy{123} \\ - \Gibbs{123} -\end{beispiel} -\da{<subscript>} aggiunge un pedice descrittivo: \cmd{Enthalpy}(r){123} \Enthalpy(r){123}. - -Questi comandi possono essere adattati tramite diverse opzioni: -\begin{beschreibung} - \Option*{exponent}{<anything>} - \Option*{delta}{<anything>/false} - \Option*{subscript}{left/right} - \Option*{unit}{<unit>} -\end{beschreibung} - -Il valore predefinito dipende dal relativo comando: -\begin{beispiel} - \Enthalpy[unit=\kilo\joule]{-285} \\ - \Gibbs[delta=false]{0} \\ - \Entropy[delta=\Delta,exponent=]{56.7} -\end{beispiel} - -Numero e unità vengono composti secondo le regole di \paket{siunitx} e dipendono -dalle sue impostazioni: -\begin{beispiel} - \Enthalpy{-1234.56e3} \\ - \sisetup{per-mode=symbol,exponent-product=\cdot,output-decimal-marker={,},group-four-digits=true} - \Enthalpy{-1234.56e3} -\end{beispiel} - -\subsubsection{Definire nuove grandezze} -Con il comando -\begin{beschreibung} - \Befehl{DeclareChemState}[<options>]{<name>}\ma{<symbol>}\ma{<unit>} -\end{beschreibung} -è possibile definire nuove grandezze. -\begin{beispiel} - \DeclareChemState{Helmholtz}{A}{\kilo\joule\per\mole} - \DeclareChemState[subscript-left=false,exponent=]{ElPot}{E}{\volt} - \Helmholtz{123.4} \\ - \ElPot{-1.1} \\ - \ElPot[exponent=0]($\ch{Sn}|\ch{Sn^2+}||\ch{Pb^2+}|\ch{Pb}$){0.01} -\end{beispiel} - -Le opzioni di questo comando sono quasi identiche a quelle delle grandezze stesse, -con cui possono essere variate le impostazioni predefinite delle nuove grandezze. -\begin{beschreibung} - \Option*{exponent}{<anything>} - \Option*{delta}{<anything>|false} - \Option*{subscript-left}{\default{true}|false} - \Option*{subscript}{<anything>} -\end{beschreibung} - -\subsubsection{Ridefinire grandezze} -Con -\begin{beschreibung} - \Befehl{RenewChemState}[<options>]{<name>}\ma{<symbol>}\ma{<unit>} -\end{beschreibung} -è possibile ridefinire grandezze preesistenti: - -\begin{beispiel} - \RenewChemState{Enthalpy}{h}{\joule} - \Enthalpy(f){12.5} -\end{beispiel} -Il comando è analogo a \cmd{DeclareChemState}, cioè ha le stesse opzioni. - -Sarebbe quindi facile -- seguendo le convenzioni termodinamiche -- definire una -grandezza molare ed una assoluta: -\begin{beispiel} - \DeclareChemState[exponent=]{enthalpy}{h}{\kilo\joule\per\mole}% molar - \RenewChemState[exponent=]{Enthalpy}{H}{\kilo\joule}% absolute - \enthalpy{-12.3} \Enthalpy{-12.3} -\end{beispiel} - -\subsection{Grandezze di stato}\label{ssec:state} -I comandi presentati nel paragrafo~\ref{ssec:siunitx} internamente impiegano il -comando\footnote{Nota bene: \ma{<subscript>} è un argomento \emph{opzionale}.} -\begin{beschreibung} - \Befehl{State}[<options>]{<symbol>}\ma{<subscript>} -\end{beschreibung} -Questo comando può essere utilizzato per scrivere le grandezze prive di valore e -unità. - -Esempi: -\begin{beispiel} - \State{A}, \State{G}{f}, \State[subscript-left=false]{E}{\ch{Na}}, \State[exponent=\SI{1000}{\celsius}]{H} -\end{beispiel} - -Le sue opzioni sono (quasi) identiche a quelle viste in precedenza: -\begin{beschreibung} - \Option[state]{exponent}{<anything>} - \Option[state]{subscript-left}{true|false} - \Option[state]{delta}{<anything>|false} -\end{beschreibung} -\secidx*{Termodinamica} - -\section{Spettroscopia e valori sperimentali}\label{sec:spektroskopie}\secidx{Spettroscopia} -\subsection{Il comando \code{\textbackslash\textcolor{code}{NMR}}} -Quando delle sostanze vengono analizzate per verificare se sono quello che si è -previsto spesso si ricorre alla spettroscopia NMR. I valori sperimentali vengono -riportati all'incirca in questo modo: -\begin{center} - \NMR(400)[CDCl3] = \num{1.59} -\end{center} -\chemmacros mette a disposizione un comando che semplifica questa stesura (impiega -\paket{siunitx}). - -\begin{beschreibung} - \Befehl{NMR}{<num>,<elem>}\da{<num>,<unit>}\oa{<solvent>} - \Befehl{NMR*}{<num>,<elem>}\da{<num>,<unit>}\oa{<solvent>} -\end{beschreibung} - -\emph{Tutti} gli argomenti sono opzionali! Senza argomenti\footnote{Tutti gli -argomenti possono essere combinati a piacimento. Il comando può essere impiegato -anche in modalità matematica.} si ottiene: -\begin{beispiel} - \NMR \\ - \NMR* -\end{beispiel} - -Il primo argomento specifica il tipo di analisi NMR eseguito: -\begin{beispiel} - \NMR{13,C} -\end{beispiel} - -Con il secondo argomento viene riportata la frequenza utilizzata (in \si{\mega\hertz}): -\begin{beispiel} - \NMR(400) -\end{beispiel} -Anche munita della sua unità: -\begin{beispiel} - \NMR(4e8,\hertz) -\end{beispiel} -Nota bene: le impostazioni del pacchetto \paket{siunitx} hanno effetto anche su -questo comando: -\begin{beispiel} - \sisetup{exponent-product=\cdot}\NMR(4e8,\hertz) -\end{beispiel} - -Con il terzo argomento può essere indicato il solvente: -\begin{beispiel} - \NMR[CDCl3] -\end{beispiel} - -\subsection{Abbreviazioni} -Dato che all'interno di un singolo documento alcuni nuclei possono essere richiamati -più di una volta \chemmacros offre una possibilità di definire delle abbreviazioni. -\begin{beschreibung} - \Befehl{DeclareChemNMR}{<csname>}\ma{<num>,<atom>} - \Befehl{RenewChemNMR}{<csname>}\ma{<num>,<atom>} -\end{beschreibung} -Questo definisce un comando con gli stessi argomenti di \cmd{NMR} \emph{eccetto} -\ma{<num>,<atom>}. -\begin{beispiel} - \DeclareChemNMR\HNMR{1,H}% - \DeclareChemNMR\CNMR{13,C}% - \CNMR*(100) \\ - \HNMR*(400) -\end{beispiel} - -\subsection{Un ambiente per elencare valori sperimentali} -\chemmacros offre un ambiente dedicato per facilitare l'elenco di valori sperimentali. -\begin{beschreibung}\catcode`\#=11 - \umg{experimental}{Dati} Ambiente per l'elenco di dati sperimentali. All'interno - di questo ambiente sono definiti i comandi seguenti: - \Befehl{data}{<tipo>}\oa{<specifiche>} \cnpkgdocarrow\ Tipo dei dati, \pes IR, - MS\ldots\ Nell'argomento opzionale possono essere inserite specifiche ulteriori - che vengono stampate in parentesi tonde. - \Befehl{data*}{<tipo>}\oa{<specifiche>} \cnpkgdocarrow\ Come \cmd{data}, ma - restituisce \code{=} anziché \code{:} se vale \key{use-equal}{true}. - \Befehl{NMR}{<num>,<elem>\oa{<coupling core>}}\da{<num>,<unit>}\oa{<solvent>} - \cnpkgdocarrow\ questo comando prende un argomento aggiuntivo: - \cmd{NMR}{13,C[\textasciicircum 1H]} \NMR{13,C[^1H]} - \Befehl{J}\da{<bonds>;<nuclei>}\oa{<unit>}\ma{<list of nums>} \cnpkgdocarrow\ - Costante di accoppiamento (NMR) con il separatore \code{;} tra i valori. - L'argomento \da{<bonds>;<nuclei>} è opzionale e permette di specificare - ulteriormente l'accoppiamento. - \befehl{#}{<num>} Numero di nuclei (NMR). - \befehl{pos}{<num>} Posizione/numero del nucleo (NMR). - \befehl{val}{<num>} Valore numerico, un alias per \lstinline+\num{<num>}+ di - \paket*{siunitx}. - \befehl{val}{<num1>-{}-<num2>} Un alias per \lstinline+\numrange{<num1>}{<num2>}+ - di \paket*{siunitx}. -\end{beschreibung} - -\begin{beispiel} - \begin{experimental} - \data{TIPO1} dati. - \data{TIPO2}[specifiche] altri dati. - \data*{TIPO3} ulteriori dati. - \end{experimental} -\end{beispiel} - -\subsection{Personalizzazione} -L'output dell'ambiente e dei comandi NMR può essere adattato con una serie di -opzioni; per ragioni storiche appartengono al modulo \textcolor{module}{\code{nmr}}. -\begin{beschreibung} - \option[nmr]{unit}{<unit>} Default = \lstinline=\mega\hertz= - \option[nmr]{nucleus}{\{<num>,<atom>\}} Default = \ma{1,H} - \option[nmr]{format}{<commands>} Formato delle specifiche dei dati, ad esempio - \lstinline=\bfseries=. - \option[nmr]{pos-number}{side|sub} Posizione del numero vicino all'atomo. - Default = \code{side} - \option[nmr]{coupling-unit}{<unit>} Un'unità di \paket{siunitx}. Default = - \lstinline=\hertz= - \option[nmr]{parse}{\default{true}|false} Tratta il solvente come formula di - \paket{mhchem}/\chemformula. Default = \code{true} - \option[nmr]{delta}{<token>} I \code{<token>} vengono inseriti dopo $\delta$. - \option[nmr]{list}{true|false} L'ambiente \env{nmr}[<options>]{} viene formattato - come lista. Default = \code{false} - \option[nmr]{list-setup}{<setup>} Setup della lista. Default = vedi in basso. - \option[nmr]{use-equal}{\default{true}|false} Inserisce un segno di uguale dopo - \cmd{NMR} e \cmd{data}. Default = \code{false} -\end{beschreibung} - -Il setup di default della lista: -\begin{beispiel}[code only] - \topsep\z@skip \partopsep\z@skip - \itemsep\z@ \parsep\z@ \itemindent\z@ - \leftmargin\z@ -\end{beispiel} - -\begin{beispiel} - \begin{experimental}[format=\bfseries] - \data{TIPO1} dati. - \data{TIPO2}[specifiche] altri dati. - \data*{TIPO3} ulteriori dati. - \end{experimental} -\end{beispiel} - -Il comando \cmd{NMR} e tutti i comandi definiti con \cmd{DeclareChemNMR} possono -essere impiegati al posto di \cmd{data} per dati NMR. - -\begin{beispiel} - \begin{experimental}[format=\bfseries,use-equal] - \data{TIPO1} dati. - \data{TIPO2}[specifiche] altri dati. - \NMR ulteriori dati. - \end{experimental} -\end{beispiel} - -\subsection{Esempio di applicazione} -Il codice seguente è riportato in diverse versioni a seconda della selezione delle -\code{<opzioni>}. Ovviamente le opzioni possono essere impostate anche globalmente -con \cmd{chemsetup}. - -\begin{beispiel}[code only] -\sisetup{separate-uncertainty,per-mode=symbol,detect-all,range-phrase=--} -\begin{experimental}[<opzioni>] - \data*{Resa} \SI{17}{\milli\gram} aghi gialli (\SI{0.04}{\milli\mole}, \SI{13}{\percent}). - % - \data{P.f.} \SI{277}{\celsius} (DSC). - % - \NMR(600)[CDCl3] \val{2.01} (s, \#{24}, \pos{5}), \val{2.31} (s, \#{12}, \pos{1}), \val{6.72--6.74} (m, \#{2}, \pos{11}), \val{6.82} (s, \#{8}, \pos{3}), \val{7.05--7.07} (m, \#{2}, \pos{12}), \val{7.39--7.41} (m, \#{4}, \pos{9}), \val{7.48--7.49} (m, \#{4}, \pos{8}). - % - \NMR{13,C}(150)[CDCl3] \val{21.2} ($+$, \#{4}, \pos{1}), \val{23.4} ($+$, \#{8}, \pos{5}), \val{126.0} ($+$, \#{4}, \pos{9}), \val{128.2} ($+$, \#{8}, \pos{3}), \val{130.8} ($+$, \#{2}, \pos{12}), \val{133.6} ($+$, \#{2}, \pos{11}), \val{137.0} ($+$, \#{4}, \pos{8}), \val{138.6} (q, \#{4}, \pos{2}), \val{140.6} (q, \#{2}, \pos{10}), \val{140.8} (q, \#{8}, \pos{4}), \val{141.8} (q, \#{4}, \pos{6}), \val{145.6} (q, \#{2}, \pos{7}). - % - \data{MS}[DCP, EI, \SI{60}{\electronvolt}] \val{703} (2, \ch{M+}), \val{582} (1), \val{462} (1), \val{249} (13), \val{120} (41), \val{105} (100). - % - \data{MS}[\ch{MeOH + H2O + KI}, ESI, \SI{10}{\electronvolt}] \val{720} (100, \ch{M+ + OH-}), \val{368} (\ch{M+ + 2 OH-}). - % - \data{IR}[KBr] \val{3443} (w), \val{3061} (w), \val{2957} (m), \val{2918} (m), \val{2856} (w), \val{2729} (w), \val{1725} (w), \val{1606} (s), \val{1592} (s), \val{1545} (w), \val{1446} (m), \val{1421} (m), \val{1402} (m), \val{1357} (w), \val{1278} (w), \val{1238} (s), \val{1214} (s), \val{1172} (s), \val{1154} (m), \val{1101} (w), \val{1030} (w), \val{979} (m), \val{874} (m), \val{846} (s), \val{818} (w), \val{798} (m), \val{744} (w), \val{724} (m), \val{663} (w), \val{586} (w), \val{562} (w), \val{515} (w). - % - \data*{UV-Vis} \SI{386}{\nano\metre} ($\varepsilon = \val{65984}$), \SI{406}{\nano\metre} ($\varepsilon = \val{65378}$). - % - \data*{Resa quantica} $\Phi = \val{0.74+-0.1}$\,. -\end{experimental} -\end{beispiel} - -\subsubsection{Quasi standard} -Output per \lstinline+<opzioni>: delta=(ppm),pos-number=sub,use-equal+: -\bigskip - -\begin{experimental}[delta=(ppm),pos-number=sub,use-equal] - \sisetup{separate-uncertainty,per-mode=symbol,detect-all,range-phrase=--} - \chemsetup[chemformula]{ - font-spec = - {[Numbers={Proportional,Lining}]Linux Libertine O} - } - % - \data*{Resa} \SI{17}{\milli\gram} aghi gialli (\SI{0.04}{\milli\mole}, \SI{13}{\percent}). - % - \data{P.f.} \SI{277}{\celsius} (DSC). - % - \NMR(600)[CDCl3] \val{2.01} (s, \#{24}, \pos{5}), \val{2.31} (s, \#{12}, \pos{1}), \val{6.72--6.74} (m, \#{2}, \pos{11}), \val{6.82} (s, \#{8}, \pos{3}), \val{7.05--7.07} (m, \#{2}, \pos{12}), \val{7.39--7.41} (m, \#{4}, \pos{9}), \val{7.48--7.49} (m, \#{4}, \pos{8}). - % - \NMR{13,C}(150)[CDCl3] \val{21.2} ($+$, \#{4}, \pos{1}), \val{23.4} ($+$, \#{8}, \pos{5}), \val{126.0} ($+$, \#{4}, \pos{9}), \val{128.2} ($+$, \#{8}, \pos{3}), \val{130.8} ($+$, \#{2}, \pos{12}), \val{133.6} ($+$, \#{2}, \pos{11}), \val{137.0} ($+$, \#{4}, \pos{8}), \val{138.6} (q, \#{4}, \pos{2}), \val{140.6} (q, \#{2}, \pos{10}), \val{140.8} (q, \#{8}, \pos{4}), \val{141.8} (q, \#{4}, \pos{6}), \val{145.6} (q, \#{2}, \pos{7}). - % - \data{MS}[DCP, EI, \SI{60}{\electronvolt}] \val{703} (2, \ch{M+}), \val{582} (1), \val{462} (1), \val{249} (13), \val{120} (41), \val{105} (100). - % - \data{MS}[\ch{MeOH + H2O + KI}, ESI, \SI{10}{\electronvolt}] \val{720} (100, \ch{M+ + OH-}), \val{368} (\ch{M+ + 2 OH-}). - % - \data{IR}[KBr] \val{3443} (w), \val{3061} (w), \val{2957} (m), \val{2918} (m), \val{2856} (w), \val{2729} (w), \val{1725} (w), \val{1606} (s), \val{1592} (s), \val{1545} (w), \val{1446} (m), \val{1421} (m), \val{1402} (m), \val{1357} (w), \val{1278} (w), \val{1238} (s), \val{1214} (s), \val{1172} (s), \val{1154} (m), \val{1101} (w), \val{1030} (w), \val{979} (m), \val{874} (m), \val{846} (s), \val{818} (w), \val{798} (m), \val{744} (w), \val{724} (m), \val{663} (w), \val{586} (w), \val{562} (w), \val{515} (w). - % - \data*{UV-Vis} \SI{386}{\nano\metre} ($\varepsilon = \val{65984}$), \SI{406}{\nano\metre} ($\varepsilon = \val{65378}$). - % - \data*{Resa quantica} $\Phi = \val{0.74+-0.1}$\,. -\end{experimental} - -\subsubsection{Lista formattata} -Output per le seguenti \lstinline+<opzioni>: format=\bfseries,delta=(ppm),list=true,use-equal+: -\bigskip - -\begin{experimental}[format=\bfseries,delta=(ppm),list=true,use-equal] - \sisetup{separate-uncertainty,per-mode=symbol,detect-all,range-phrase=--} - \chemsetup[chemformula]{ - font-spec = - {[Numbers={Proportional,Lining}]Linux Libertine O} - } - % - \data*{Resa} \SI{17}{\milli\gram} aghi gialli (\SI{0.04}{\milli\mole}, \SI{13}{\percent}). - % - \data{P.f.} \SI{277}{\celsius} (DSC). - % - \NMR(600)[CDCl3] \val{2.01} (s, \#{24}, \pos{5}), \val{2.31} (s, \#{12}, \pos{1}), \val{6.72--6.74} (m, \#{2}, \pos{11}), \val{6.82} (s, \#{8}, \pos{3}), \val{7.05--7.07} (m, \#{2}, \pos{12}), \val{7.39--7.41} (m, \#{4}, \pos{9}), \val{7.48--7.49} (m, \#{4}, \pos{8}). - % - \NMR{13,C}(150)[CDCl3] \val{21.2} ($+$, \#{4}, \pos{1}), \val{23.4} ($+$, \#{8}, \pos{5}), \val{126.0} ($+$, \#{4}, \pos{9}), \val{128.2} ($+$, \#{8}, \pos{3}), \val{130.8} ($+$, \#{2}, \pos{12}), \val{133.6} ($+$, \#{2}, \pos{11}), \val{137.0} ($+$, \#{4}, \pos{8}), \val{138.6} (q, \#{4}, \pos{2}), \val{140.6} (q, \#{2}, \pos{10}), \val{140.8} (q, \#{8}, \pos{4}), \val{141.8} (q, \#{4}, \pos{6}), \val{145.6} (q, \#{2}, \pos{7}). - % - \data{MS}[DCP, EI, \SI{60}{\electronvolt}] \val{703} (2, \ch{M+}), \val{582} (1), \val{462} (1), \val{249} (13), \val{120} (41), \val{105} (100). - % - \data{MS}[\ch{MeOH + H2O + KI}, ESI, \SI{10}{\electronvolt}] \val{720} (100, \ch{M+ + OH-}), \val{368} (\ch{M+ + 2 OH-}). - % - \data{IR}[KBr] \val{3443} (w), \val{3061} (w), \val{2957} (m), \val{2918} (m), \val{2856} (w), \val{2729} (w), \val{1725} (w), \val{1606} (s), \val{1592} (s), \val{1545} (w), \val{1446} (m), \val{1421} (m), \val{1402} (m), \val{1357} (w), \val{1278} (w), \val{1238} (s), \val{1214} (s), \val{1172} (s), \val{1154} (m), \val{1101} (w), \val{1030} (w), \val{979} (m), \val{874} (m), \val{846} (s), \val{818} (w), \val{798} (m), \val{744} (w), \val{724} (m), \val{663} (w), \val{586} (w), \val{562} (w), \val{515} (w). - % - \data*{UV-Vis} \SI{386}{\nano\metre} ($\varepsilon = \val{65984}$), \SI{406}{\nano\metre} ($\varepsilon = \val{65378}$). - % - \data*{Resa quantica} $\Phi = \val{0.74+-0.1}$\,. -\end{experimental} - -\subsubsection{Buffo} -Output per \code{<opzioni>}: -\begin{lstlisting} - format=\color{red}\itshape, - list=true, - delta=\textcolor{green}{\ch{M+ + H2O}}, - pos-number=side, - coupling-unit=\mega\gram\per\square\second, - list-setup=, - use-equal -\end{lstlisting} - -\begin{experimental}[ - format=\color{red}\itshape, - list=true, - delta=\textcolor{green}{\ch{M+ + H2O}}, - pos-number=side, - coupling-unit=\mega\gram\per\square\second, - list-setup=,use-equal] - \sisetup{separate-uncertainty,per-mode=symbol,detect-all,range-phrase=--} - \chemsetup[chemformula]{ - font-spec = - {[Numbers={Proportional,Lining}]Linux Libertine O} - } - % - \data*{Resa} \SI{17}{\milli\gram} aghi gialli (\SI{0.04}{\milli\mole}, \SI{13}{\percent}). - % - \data{P.f.} \SI{277}{\celsius} (DSC). - % - \NMR(600)[CDCl3] \val{2.01} (s, \#{24}, \pos{5}), \val{2.31} (s, \#{12}, \pos{1}), \val{6.72--6.74} (m, \#{2}, \pos{11}), \val{6.82} (s, \#{8}, \pos{3}), \val{7.05--7.07} (m, \#{2}, \pos{12}), \val{7.39--7.41} (m, \#{4}, \pos{9}), \val{7.48--7.49} (m, \#{4}, \pos{8}). - % - \NMR{13,C}(150)[CDCl3] \val{21.2} ($+$, \#{4}, \pos{1}), \val{23.4} ($+$, \#{8}, \pos{5}), \val{126.0} ($+$, \#{4}, \pos{9}), \val{128.2} ($+$, \#{8}, \pos{3}), \val{130.8} ($+$, \#{2}, \pos{12}), \val{133.6} ($+$, \#{2}, \pos{11}), \val{137.0} ($+$, \#{4}, \pos{8}), \val{138.6} (q, \#{4}, \pos{2}), \val{140.6} (q, \#{2}, \pos{10}), \val{140.8} (q, \#{8}, \pos{4}), \val{141.8} (q, \#{4}, \pos{6}), \val{145.6} (q, \#{2}, \pos{7}). - % - \data{MS}[DCP, EI, \SI{60}{\electronvolt}] \val{703} (2, \ch{M+}), \val{582} (1), \val{462} (1), \val{249} (13), \val{120} (41), \val{105} (100). - % - \data{MS}[\ch{MeOH + H2O + KI}, ESI, \SI{10}{\electronvolt}] \val{720} (100, \ch{M+ + OH-}), \val{368} (\ch{M+ + 2 OH-}). - % - \data{IR}[KBr] \val{3443} (w), \val{3061} (w), \val{2957} (m), \val{2918} (m), \val{2856} (w), \val{2729} (w), \val{1725} (w), \val{1606} (s), \val{1592} (s), \val{1545} (w), \val{1446} (m), \val{1421} (m), \val{1402} (m), \val{1357} (w), \val{1278} (w), \val{1238} (s), \val{1214} (s), \val{1172} (s), \val{1154} (m), \val{1101} (w), \val{1030} (w), \val{979} (m), \val{874} (m), \val{846} (s), \val{818} (w), \val{798} (m), \val{744} (w), \val{724} (m), \val{663} (w), \val{586} (w), \val{562} (w), \val{515} (w). - % - \data*{UV-Vis} \SI{386}{\nano\metre} ($\varepsilon = \val{65984}$), \SI{406}{\nano\metre} ($\varepsilon = \val{65378}$). - % - \data*{Resa quantica} $\Phi = \val{0.74+-0.1}$\,. -\end{experimental} -\secidx*{Spettroscopia} - -\section{Comandi per \textsf{mhchem}}\label{sec:mhchem}\secidx{Comandi per \textsf{mhchem}}[Comandi per mhchem] -\paket{mhchem} non viene più caricato automaticamente da \chemmacros bensì solamente -nel caso in cui si utilizzi nel preambolo l'opzione \key[option]{method}{mhchem}; -predefinitamente si utilizza invece \chemformula. - -\chemmacros mette a disposizione solo un unico comando speciale per \paket{mhchem}% -\footnote{\chemformula ha una possibilità diversa per ottenere lo stesso risultato.} -che permette di inserire del testo al di sotto di una formula. -\begin{beschreibung} - \Befehl{mhName}[<options>]{<formula>}\ma{<text>} -\end{beschreibung} - -Per esempio: -\begin{beispiel} - \ce{4 C2H5Cl + Pb / Na -> \mhName{Pb(C2H5)4}{former antiknock additive} + NaCl} -\end{beispiel} - -\cmd{mhName} può essere adattato con le opzioni seguenti: -\begin{beschreibung} - \option[mhName]{align}{<alignment command>} L'orientamento del testo all'interno - del box in cui viene scritto. Default = \lstinline+\centering+ - \option[mhName]{format}{<anything>} Il formato del testo. - \option[mhName]{fontsize}{<font size command>} Il corpo del testo. Default = - \lstinline+\tiny+ - \option[mhName]{width}{<dim>|auto} La larghezza del box all'interno di cui viene - scritto il testo. Default = \code{auto} -\end{beschreibung} -\begin{beispiel} - \ce{4 C2H5Cl + Pb / Na -> \mhName[fontsize=\footnotesize]{Pb(C2H5)4}{former antiknock additive} + NaCl}\\ - \chemsetup[mhName]{align=\raggedright,fontsize=\small,format=\bfseries\color{red},width=3cm} - \ce{4 C2H5Cl + Pb / Na -> \mhName{Pb(C2H5)4}{former antiknock additive} + NaCl} -\end{beispiel} -\secidx*{Comandi per \textsf{mhchem}}[Comandi per mhchem] - -\section{Ambienti di reazione}\label{sec:reactions}\secidx{Ambienti di reazione} -\subsection{Definiti da \chemmacros} -Sono disponibili i seguenti ambienti per reazioni numerate\ldots -\begin{beschreibung} - \Umg{reaction}{<formula or mhchem code>} - \Umg{reactions}{<formula or mhchem code>} -\end{beschreibung} - -\ldots e le loro versioni asteriscate per reazioni non numerate. -\begin{beschreibung} - \Umg{reaction*}{<formula or mhchem code>} - \Umg{reactions*}{<formula or mhchem code>} -\end{beschreibung} -In questo modo è possibile inserire reazioni (non) numerate in modo analogo alle -equazioni matematiche. - -Per rappresentare le reazioni gli ambienti \code{reaction}/\code{reaction*} internamente -utilizzano ambienti \code{equation}/\code{equation*}, e gli ambienti -\code{reactions}/\code{reactions*} utilizzano gli ambienti \code{align}/\code{align*}. - -\begin{beispiel} - reazione con contatore: - \begin{reaction} - A -> B - \end{reaction} -\end{beispiel} - -\begin{beispiel} - reazione senza contatore: - \begin{reaction*} - C -> D - \end{reaction*} -\end{beispiel} - -\begin{beispiel} - più reazioni allineate, con contatore: - \begin{reactions} - A &-> B + C \\ - D + E &-> F - \end{reactions} -\end{beispiel} - -\begin{beispiel} - più reazioni allineate, senza contatore: - \begin{reactions*} - G &-> H + I \\ - J + K &-> L - \end{reactions*} -\end{beispiel} - -Quando si desidera cambiare il formato dell'etichetta, è possibile usare -\begin{beschreibung} - \Befehl{renewtagform}{<tagname>}\oa{<format>}\ma{<right delim>}\ma{<left delim>}% - \footnote{Messo a disposizione dal pacchetto \paket*{mathtools}.}. -\end{beschreibung} - -\begin{beispiel} - \renewtagform{reaction}[R \textbf]{[}{]} - \begin{reaction} - H2O + CO2 <<=> H2CO3 - \end{reaction} -\end{beispiel} - -Dalla versione 3.3 i riferimenti incrociati e il comando \cmd{intertext} di \AmS math -funzionano come previsto: -\begin{beispiel} - \begin{reactions} - A + 2 B &-> 3 C + D \label{rxn:test} - \intertext{Un po' di testo tra due reazioni allineate.} - 3 E + F &<=> G + 1/2 H - \end{reactions} - Vedi reazione~\ref{rxn:test}. -\end{beispiel} - -\achtung{Nell'impostazione predefinita, cioè con \key{method}{chemformula}, è -sconsigliato utilizzare \cmd{mch} e simili all'interno degli ambienti -\code{reaction}: nella maggior parte dei casi scombinano l'allineamento corretto. -Come impostazione predefinita le cariche riconoscono automaticamente l'impostazione -dell'opzione \key{circled} all'interno degli ambienti, in modo che i comandi non -siano nemmeno necessari.} - -\subsection{Reazioni proprie} -Attraverso il comando -\begin{beschreibung} - \Befehl{DeclareChemReaction}[<options>]{<name>}\ma{<math name>} -\end{beschreibung} -è possibile definire nuovi ambienti di reazione: \code{<name>} sarà il nome del -nuovo ambiente; \code{<math name>} è il tipo di ambiente matematico impiegato. - -Il comando ha due opzioni: -\begin{beschreibung} - \Option*{star}{\default{true}|false} - \Option*{arg}{\default{true}|false} -\end{beschreibung} -La prima opzione è \key*{star}, che definisce anche la variante asteriscata, -ammesso che esista l'equivalente ambiente matematico; in caso contrario restituirà -un errore. - -La seconda opzione è \key*{arg}, che viene impiegata per definire un ambiente con -un argomento obbligatorio. Anche in questo caso l'opzione è valida solamente se -anche l'ambiente matematico corrispondente ha un argomento obbligatorio. - -Gli ambienti predefiniti sono stati definiti tramite -\begin{beschreibung} - \Befehl{DeclareChemReaction}[star]{reaction}\ma{equation} und - \Befehl{DeclareChemReaction}[star]{reactions}\ma{align}. -\end{beschreibung} - -Ammettiamo che l'utente voglia definire un ambiente con il comportamento dell'ambiente -\code{alignat} per reazioni di \chemformula/\paket{mhchem}. È possibile fare il -seguente: -\begin{beispiel}[code only] - \DeclareChemReaction[star,arg]{reactionsat}{alignat} -\end{beispiel} - -In questo modo si è definito l'ambiente \code{reactionsat}. -\begin{beispiel} - \DeclareChemReaction[star,arg]{reactionsat}{alignat} - \begin{reactionsat}{3} - A &-> B &&-> C &&-> D \\ - aaaaa &-> bbbbb &&-> ccccc &&-> ddddd - \end{reactionsat} - \begin{reactionsat*}{2} - A &-> B & C &-> D \\ - aaaaa &-> bbbbb &\quad{} ccccc &-> ddddd - \end{reactionsat*} -\end{beispiel} - -\subsection{Lista delle reazioni} -\chemmacros mette a disposizione un comando per elencare le reazioni inserite negli -ambienti di reazione. -\begin{beschreibung} - \Befehl{listofreactions} -\end{beschreibung} -\begin{beispiel}[below] - \listofreactions -\end{beispiel} - -L'output può essere adattato con le opzioni seguenti: -\begin{beschreibung} - \option[reaction]{list-name}{<name of the list>} Imposta il titolo della lista. - Default = \code{List of reactions} - \option[reaction]{list-entry}{<prefix to each entry>} Prefisso di ogni voce. - Default = \code{Reaction} -\end{beschreibung} -Entrambi i valori predefiniti reagiscono all'opzione di lingua \key[option]{italian}, -variando rispettivamente a \enquote{Elenco delle reazioni} e \enquote{Reazione}. -Un'alternativa all'impostazione dell'opzione \key{list-name} è di ridefinire -\cmd{reactionlistname}. - -Nell'elenco vengono elencate esclusivamente tutte le reazioni numerate. Tutte le -reazioni non asteriscate hanno un argomento opzionale, attraverso il quale è -possibile aggiungere una descrizione della reazione nell'elenco. -\begin{beispiel} - \begin{reaction}[Autoprotolisi] - 2 H2O <<=> H3O+ + OH- - \end{reaction} -\end{beispiel} -Questo non funzionerà quando viene impiegato l'ambiente \code{reactions}. In -questo caso è possibile ricorrere a -\begin{beschreibung} - \Befehl{AddRxnDesc}{<description>} -\end{beschreibung} - -\begin{beispiel} - \begin{reactions} - Cl "\Lewis{0.,\vphantom{Cl}}" + CH4 &-> HCl + "\Lewis{4.,\vphantom{CH}}" CH3 \AddRxnDesc{first~step~of~chain} \\ - "\Lewis{4.,\vphantom{CH}}" CH3 + Cl2 &-> CH3Cl + Cl "\Lewis{0.,\vphantom{Cl}}" \AddRxnDesc{second~step~of~chain} - \end{reactions} -\end{beispiel} -Nota bene: non è necessario impiegare i comandi \enquote{phantom}, se il formato -degli atomi non è stato variato (vedi il paragrafo~\ref{sec:format} a pagina~\pageref{sec:format}). -\secidx*{Ambienti di reazione} - -\section{Fasi}\label{sec:phasen}\secidx{Fasi} -\subsection{Principi}\secidx[Principi]{Fasi} -Questi comandi sono pensati per indicare la fase di una sostanza. -\begin{beschreibung} - \befehl{sld} \sld - \befehl{lqd} \lqd - \befehl{gas} \gas - \befehl{aq} \aq -\end{beschreibung} - -\achtung{Il comportamento predefinito dei comandi di fase è variato per seguire -le raccomandazioni \ac{iupac}. Sia \cmd{sld} che \cmd{lqd} non hanno più nessun -argomento opzionale.} - -\begin{beispiel} - \ch{C\sld{} + 2 H2O\lqd{} -> CO2\gas{} + 2 H2\gas}\\ - per completezza: NaCl\aq. -\end{beispiel} - -% Con l'opzione \key{language}{german} (vedi il paragrafo~\ref{sec:optionen}) si ottengono le versioni in tedesco. % IST SCHON ÜBERSETZT, WÜRDE ICH ABER VORERST WEGLASSEN. -Jonas - -La raccomandazione \ac{iupac}\footnote{Ringrazio Paul King del suggerimento.} per -indicare uno stato di aggregazione è di porlo tra parentesi dopo la formula~\cite{iupac:greenbook}; -è tuttavia molto diffusa anche l'indicazione in pedice. - -\begin{zitat}[{\ac{iupac} Green Book {\cite[][p.\,54]{iupac:greenbook}}}] - The \textelp{} symbols are used to represent the states of aggregation of chemica - species. The letters are appended to the formula in parentheses and should be - printed in Roman (upright) type without a full stop (period). -\end{zitat} - -Vi sono due opzioni per adattare l'output: -\begin{beschreibung} - \option[phases]{pos}{side|sub} Cambia la posizione dell'indicatore di fase. - Default = \code{side} - \option[phases]{space}{<dim>} Varia l'interspazio tra formula e indicatore di fase - per \key{pos}{side}. Una grandezza di \TeX. Default = \code{.1333em} -\end{beschreibung} -\begin{beispiel} - \chemsetup[phases]{pos=sub} - \ch{C\sld{} + 2 H2O\lqd{} -> CO2\gas{} + 2 H2\gas}\\ - per completezza: NaCl\aq. -\end{beispiel} - -\subsection{Definire fasi proprie}\secidx[proprie]{Fasi} -In base al argomento del testo può essere necessario indicare ulteriori stati di -aggregazione; questi possono essere definiti convenientemente attraverso: -\begin{beschreibung} - \Befehl{DeclareChemPhase}{<cmd>}\oa{<german>}\ma{<english>} - \Befehl{RenewChemPhase}{<cmd>}\oa{<german>}\ma{<english>} - \befehl{phase}{<phase>} Quando è necessario impiegare la fase solo poche volte. -\end{beschreibung} -\cmd{DeclareChemPhase} definisce la fase solamente se \code{<cmd>} non esiste ancora; -altrimenti \chemmacros dà un avvertimento o un errore, dipendentemente dall'opzione -\key{strict}. \cmd{RenewChemParticle} definisce una fase \emph{solamente} se \code{<cmd>} -esiste già, e dà un avvertimento/un errore in caso opposto. -\begin{beispiel} - \DeclareChemPhase{\aqi}{aq,$\infty$}% aqueous solution at infinite dilution - \DeclareChemPhase{\cd}{cd}% condensed phase - \RenewChemPhase{\lqd}{lc}% liquid crystal - NaOH\aqi\ \ch{H2O\cd} U\phase{cr} A\lqd \\ - \chemsetup[phases]{pos=sub} - NaOH\aqi\ \ch{H2O\cd} U\phase{cr} A\lqd -\end{beispiel} -\secidx*{Phasen} - -\section{Proiezioni di Newman}\label{sec:newman}\secidx{Proiezioni di Newman} -\chemmacros mette a disposizione il comando -\begin{beschreibung} - \Befehl{newman}[<options>]\da{<angle>}\ma{<1>,<2>,<3>,<4>,<5>,<6>} -\end{beschreibung} -che permette di rappresentare le proiezioni di Newman (impiega \TikZ). L'argomento -\da{<angle>} gira gli atomi posteriori in senso antiorario rispetto agli atomi -anteriori. -\begin{beispiel} - \newman{} \newman(170){} - \newman{1,2,3,4,5,6} \newman{1,2,3} \newman{,,,4,5,6} -\end{beispiel} - -Sono disponibili alcune opzioni per adattare il comando: -\begin{beschreibung} - \option[newman]{angle}{<angle>} Angolo predefinito (in gradi). Default = \code{0} - \option[newman]{scale}{<factor>} Scala l'intera proiezione. Default = \code{1} - \option[newman]{ring}{<tikz>} Adatta l'aspetto dell'anello con chiavi di \TikZ. - \option[newman]{atoms}{<tikz>} Adatta l'aspetto dei nodi contenenti gli atomi con - chiavi di \TikZ. - \option[newman]{back-atoms}{<tikz>} Adatta solo gli atomi posteriori. -\end{beschreibung} - -\begin{beispiel} - \chemsetup[newman]{angle=45} \newman{} - \newman[scale=.75,ring={draw=blue,fill=blue!20}]{} -\end{beispiel} -\begin{beispiel} - \chemsetup[newman]{atoms={draw=red,fill=red!20,inner sep=2pt,rounded corners}} - \newman{1,2,3,4,5,6} -\end{beispiel} -\begin{beispiel} - \chemsetup[newman]{ - atoms = {draw=red,fill=red!20,inner sep=2pt,rounded corners}, - back-atoms = {draw=blue,fill=blue!20,inner sep=2pt,rounded corners} - } - \newman{1,2,3,4,5,6} \newman(170){1,2,3,4,5,6} -\end{beispiel} -\secidx*{Proiezioni di Newman} - -\section{Orbitali s, p e ibridi}\label{sec:orbitale}\secidx{Orbitali} -\chemmacros mette a disposizione un comando per rappresentare alcuni orbitali: -\begin{beschreibung} - \Befehl{orbital}[<options>]{<type} -\end{beschreibung} - -Sono disponibili i seguenti tipi orbitalici per \ma{<type>}: -\begin{description} - \item \code{s} - \item \code{p} - \item \code{sp} - \item \code{sp2} - \item \code{sp3} -\end{description} - -\begin{beispiel} - \orbital{s} \orbital{p} \orbital{sp} \orbital{sp2} \orbital{sp3} -\end{beispiel} - -A seconda del tipo sono disponibili diverse opzioni per modificare l'orbitale: -\begin{beschreibung} - \option[orbital]{phase}{\default{+}|-} Varia la fase dell'orbitale (tutti i tipi). - \option[orbital]{scale}{<factor>} Varia la dimensione dell'orbitale (tutti i tipi). - \option[orbital]{color}{<color>} Varia il colore dell'orbitale (tutti i tipi). - \option[orbital]{angle}{<angle>} Ruota gli orbitali con un contributo p in senso - antiorario (tutti i tipi tranne \code{s}). - \option[orbital]{half}{\default{true}|false} Raffigura solo metà orbitale (solo per - \code{<type> = p}). -\end{beschreibung} - -\begin{beispiel} - \orbital{s} \orbital[phase=-]{s} - \orbital{p} \orbital[phase=-]{p} - \orbital{sp3} \orbital[phase=-]{sp3} - - \orbital[angle=0]{p} \orbital[color=red!50]{p} \orbital[angle=135,scale=1.5]{p} \orbital[half]{p} -\end{beispiel} - -Esistono due opzioni ulteriori attraverso le quali si può influenzare il comportamento -di \TikZ: -\begin{beschreibung} - \option[orbital]{overlay}{\default{true}|false} L'orbitale \enquote{non ha bisogno - di spazio}; viene disegnato con la chiave di \TikZ \code{overlay}. - \option[orbital]{opacity}{<num>} L'orbitale diviene trasparente; \code{<value>} - accetta valori compresi tra \code{1} (opaco) e \code{0} (trasparente). -\end{beschreibung} - -\begin{beispiel}[dist] - \hspace{1cm} - \chemsetup[orbital]{ - overlay, - p/color = black!70 - } - \setbondoffset{0pt} - \chemfig{?\orbital{p}-[,1.3]{\orbital[phase=-]{p}}-[:30,1.1]\orbital{p}-[:150,.9]{\orbital[phase=-]{p}}-[4,1.3]\orbital{p}-[:-150,1.1]{\orbital[phase=-]{p}}?} - \vspace{7mm} -\end{beispiel} - -\bspmidlength{dist}{10mm} -\begin{beispiel}[dist] - \hspace{2cm} - \setbondoffset{0pt} - \chemsetup[orbital]{ - overlay , - opacity = .75 , - p/scale = 1.6 , - s/color = blue!50 , - s/scale = 1.6 - } - \chemfig{\orbital{s}-[:-20]{\orbital[scale=2]{p}}{\orbital[half,angle=0]{p}}{\orbital[angle=170,half]{p}}{\orbital[angle=-150,half]{p}}(-[:-150]\orbital{s})-\orbital{s}} - \vspace{1cm} -\end{beispiel} -\bspmidlength{dist}{7mm} -\secidx*{Orbitali}\secidx*{CHEMMACROS} - -\newpage -\part{\texorpdfstring{\Chemformula}{chemformula}}\label{part:chemformula}\secidx{CHEMFORMULA} -\chemsetup[chemformula]{ - font-spec = - {[Numbers={Proportional,Lining}]Linux Libertine O} -} -\section{Impostazioni} -Tutte le opzioni di \chemformula appartengono al modulo \textcolor{module}{\code{chemformula}}. Quindi possono essere impostate attraverso -\begin{beispiel}[code only] - \chemsetup[chemformula]{<options>} oppure - \chemsetup{chemformula/<option1>,chemformula/<option2>} -\end{beispiel} -Possono inoltre essere passate direttamente come opzioni al comando \cmd{ch}. - -\section{Principio di base} -\chemformula ha un comando di base. -\begin{beschreibung} - \Befehl{ch}[<options>]{<input>} -\end{beschreibung} - -Il suo utilizzo sarà intuitivo per l'utente pratico di \paket{mhchem}: -\begin{beispiel} - \ch{H2O} \\ - \ch{Sb2O3} \\ - \ch{H+} \\ - \ch{CrO4^2-} \\ - \ch{AgCl2-} \\ - \ch{[AgCl2]-} \\ - \ch{Y^{99}+} \\ - \ch{Y^{99+}} \\ - \ch{H2_{(aq)}} \\ - \ch{NO3-} \\ - \ch{(NH4)2S} \\ - \ch{^{227}_{90}Th+} \\ - $V_{\ch{H2O}}$ \\ - \ch{Ce^{IV}} \\ - \ch{KCr(SO4)2 * 12 H2O} -\end{beispiel} - -Tuttavia esistono delle differenze. La più importante è: \chemformula distingue -diversi tipi di input. Questi tipi diversi devono essere \emph{necessariamente} -separati da spazi: -\begin{beschreibung} - \Befehl{ch}{type1 type2 type3 type4} -\end{beschreibung} -Uno spazio nell'input non corrisponde \emph{mai} ad uno spazio nell'output. Il -ruolo dello spazio vale strettamente, e quando non viene seguito può produrre output -erratico. A titolo di esempio, \cmd{ch}{2H2O} viene considerata come \emph{una} -particella, in questo caso una formula bruta. -\begin{beispiel} - \ch{2H2O} \\ - \ch{2 H2O} -\end{beispiel} -Ciò significa anche che una particella non può contenere spazi perché verrebbe -automaticamente divisa in due parti. Quando necessario, uno spazio può essere -introdotto con \lstinline+~+. Dato che la maggior parte delle macro ignora gli -spazi seguenti, un input del tipo \cmd{ch}{\textbackslash command ABC} viene -trattato come un'unità. Nel caso si desideri separare un input di questo tipo -è necessario introdurre un gruppo vuoto: \cmd{ch}{\textbackslash command\{\} ABC}. -I diversi tipi di input verranno trattati separatamente in seguito. - -Un'ulteriore differenza importante è che \chemformula cerca di evitare il modo -matematico quanto più possibile: -\begin{beispiel} - \ch{A + B ->[a] C} \\ - \ce{A + B ->[a] C} -\end{beispiel} - -Il comando \cmd{ch} ha alcune opzioni per modificare l'output. Possono essere -impostate localmente come argomenti opzionali oppure globalmente con il comando -\begin{beschreibung} - \Befehl{chemsetup}[chemformula]{<options>} -\end{beschreibung} -Tutte le opzioni di \chemformula appartengono al modulo \textcolor{module}{\code{chemformula}}. - -\section{Fattori stechiometrici}\secidx{Fattori stechiometrici} -Un fattore stechiometrico deve contenere solo cifre e simboli tra i seguenti: \lstinline+.,_/()+ -\begin{beispiel} - \ch{2} \\ - \ch{12} - - % decimals: - \ch{.5} \\ - \ch{5,75} - - % fractions: - \ch{3/2} \\ - \ch{1_1/2} - - % ``iupac'': - \ch{(1/2)} -\end{beispiel} - -Come nell'esempio per le frazioni decimali viene introdotto uno zero iniziale -quando manca nell'input. - -Nell'input è necessario badare alla sintassi giusta, anche se ritengo che sia -piuttosto intuitiva. -\begin{beispiel}[code only] - questo non funzionerà, ma darà invece un errore: \ch{1/1_1} -\end{beispiel} - -Quando i fattori stechiometrici sono scritti tra parentesi le frazioni non vengono -convertite e gli eventuali zeri iniziali non vengono aggiunti. -Il testo inserito tra parentesi viene reso allo stesso modo dell'input. -\begin{beispiel} - \ch{(1/2) H2O} \ch{1/2 H2O} \ch{0.5 H2O} -\end{beispiel} -Numerosi esempi come il seguente per l'utilizzo delle parentesi per racchiudere -fattori stechiometrici possono essere trovati per esempio nello „\ac{iupac} Green -Book“~\cite{iupac:greenbook}: -\begin{reaction*} - (1/5) K "\ox*{7,Mn}" O4 + (8/5) HCl == (1/5) "\ox*{2,Mn}" Cl2 + (1/2) Cl2 + (1/5) KCl + (4/5) H2O -\end{reaction*} - -L'output può essere adattato utilizzando le opzioni seguenti: -\begin{beschreibung} - \option{decimal-marker}{<marker>} Il simbolo usato come separatore decimale. - Default = \code{.} - \option{frac-style}{math|xfrac|nicefrac} Determina in che modo vengono rappresentate - le frazioni. Default = \code{math} - \option{stoich-space}{<skip>} La dimensione dello spazio dopo un fattore stechiometrico. - Una lunghezza elastica. Default = \code{.1667em plus .0333em minus .0117em} - \option{stoich-paren-parse}{\default{true}|false} Quando l'opzione è impostata - a \code{true} anche i fattori stechiometrici compresi tra parentesi vengono - elaborati, cioè le frazioni convertite e gli zeri iniziali inseriti. - Default = \code{false} -\end{beschreibung} -\begin{beispiel} - \ch[decimal-marker={,}]{3.5} \ch[decimal-marker={$\cdot$}]{3,5} -\end{beispiel} - -L'opzione \key{frac-style}{xfrac} utilizza il comando \lstinline+\sfrac+ del -pacchetto \paket{xfrac}; l'output può dipendere fortemente dal carattere impiegato. -\secidx[xfrac]{Fattori stechiometrici} -\begin{beispiel} - \ch[frac-style=xfrac]{3/2} \ch[frac-style=xfrac]{1_1/2} -\end{beispiel} - -\chemformula definisce l'istanza \lstinline=formula-text-frac=, che può essere -adattata alle proprie necessità. Le impostazioni di default sono elencate di seguito: -\begin{beispiel}[code only] - \DeclareInstance{xfrac}{chemformula-text-frac}{text} - { - slash-left-kern = -.15em , - slash-right-kern = -.15em - } -\end{beispiel} -Questo documento impiega il Font Linux Libertine~O e la definizione seguente: -\begin{beispiel}[code only] - \DeclareInstance{xfrac}{chemformula-text-frac}{text} - { - scale-factor = 1 , - denominator-bot-sep = -.2ex , - denominator-format = \scriptsize #1 , - numerator-top-sep = -.2ex , - numerator-format = \scriptsize #1 , - slash-right-kern = .05em , - slash-left-kern = .05em - } -\end{beispiel} - -L'opzione \key{frac-style}{nicefrac} utilizza il comando \lstinline+\nicefrac+ del -pacchetto \paket{nicefrac}.\secidx[nicefrac]{Fattori stechiometrici} -\begin{beispiel} - \ch[frac-style=nicefrac]{3/2} \ch[frac-style=nicefrac]{1_1/2} -\end{beispiel} - -L'opzione \key{stoich-space} permette di adattare la larghezza dello spazio tra -fattore stechiometrico e formula bruta.\secidx[space]{Fattori stechiometrici} -\begin{beispiel} - \ch{2 H2O} \\ - \ch[stoich-space=.3em]{2 H2O} -\end{beispiel} -\secidx*{Fattori stechiometrici} - -\section{Formule brute}\label{ssec:compounds}\secidx{Formule brute} -\chemformula considera le formule brute come il tipo \enquote{diverso da tutti gli -altri}. Questo diverrà più chiaro in seguito quando saranno elencati gli altri tipi. -\begin{beispiel} - \ch{H2SO4} \\ - \ch{[Cu(NH3)4]^2+} -\end{beispiel} - -\subsection{Addotti}\secidx[Addotti]{Formule brute} -\chemformula riconosce due identificatori che creano addotti. -\begin{beschreibung} - \befehl{ch}{A.B} \ch{A.B} - \befehl{ch}{A*B} \ch{A*B} -\end{beschreibung} -\begin{beispiel} - \ch{CaSO4.H2O} \\ - \ch{CaSO4*H2O} -\end{beispiel} -Dato che le cifre all'interno di una formula bruta vengono considerate sempre -come pedici (vedi il paragrafo~\ref{ssec:subscripts}), talvolta è necessario -lasciare uno spazio in modo che il numero venga riconosciuto come fattore -stechiometrico: -\begin{beispiel} - \ch{Na3PO4*12H2O} \\ - \ch{Na3PO4* 12 H2O} \\ - \ch{Na3PO4 * 12 H2O} -\end{beispiel} - -\subsection{Pedici}\label{ssec:subscripts}\secidx[Pedici]{Formle brute} -\emph{Tutte} le cifre in una sostanza vengono considerate come pedici. -\begin{beispiel} - \ch{H2SO4} -\end{beispiel} -Quando si desidera utilizzare un carattere come pedice, va utilizzata la sintassi -matematica: -\begin{beispiel} - \ch{A_nB_m} -\end{beispiel} - -Il pedice riconosce i gruppi, all'interno dei quali è anche possibile usare il modo -matematico. -\begin{beispiel} - \ch{A_{$n$}B_{$m$}} \\ - \ch{NaCl_{(aq)}} -\end{beispiel} - -\subsection{Comandi}\secidx[Comandi]{Formule brute} -All'interno di una formula bruta sono permessi i comandi: -\begin{beispiel} - \ch{\textbf{A2}B3} \ch{A2\color{red}B3} -\end{beispiel} -Quando però un comando richiede come argomento un numero, ad esempio comandi -regolanti la spaziatura oppure il comando \lstinline+\ox+, l'utilizzo diretto -fallirà. Questo deriva dal fatto che le cifre verranno riconosciute come pedice -\emph{prima} dell'espansione del comando. -\begin{beispiel}[code only] - \ch{A\hspace{2mm}B} darà un errore, dato che \hspace vedrà qualcosa del genere: \hspace{$_2$mm}. -\end{beispiel} -Vedi il paragrafo~\ref{ssec:text} per una via d'uscita da questo problema. - -\subsection{Cariche ed altri apici}\secidx[Cariche]{Formule brute}\secidx[Apici]{Formule brute} -\paragraph{Principi} -Quando una formula bruta \emph{termina} con un segno più o meno, questo verrà -interpretato come un simbolo di carica e messo ad apice. In altri punti un più -rappresenta un legame triplo ed un trattino un legame singolo, vedi il -paragrafo~\ref{ssec:bonds}. -\begin{beispiel} - \ch{A+B} \ch{AB+} \\ - \ch{A-B} \ch{AB-} -\end{beispiel} - -Per gruppi di carica più lunghi oppure altri apici è possibile utilizzare la sintassi -matematica, che riconosce i gruppi e permette il modo matematico al loro interno. -Entro questi gruppi né il simbolo \code{+} né \code{-} vengono interpretati come -legami. Quando ad apice si trova un punto \code{.} non indica un addotto bensì un -radicale. Un asterisco \code{*} indica uno stato eccitato. -\begin{beispiel} - \ch{A^{x-}} \\ - \ch{A^x-} \\ - \ch{A^{x}-} \\ - \ch{A^{$x-$}} \\ - \ch{RNO2^{-.}} \\ - \ch{^31H} \\ - \ch{^{14}6C} \\ - \ch{^{58}_{26}Fe} \\ - \ch{NO^*} -\end{beispiel} - -Ioni e composti ionici con più di una carica vengono inseriti in modo analogo: -\begin{beispiel} - \ch{SO4^2-} \ch{Ca^2+ SO4^2-} -\end{beispiel} - -\paragraph{Comandi ionici}\secidx[Apici!Comandi di carica]{Formule brute} -All'interno di \cmd{ch} non sono necessari comandi del tipo di \cmd{mch}; difatti -\emph{è opportuno evitarli}, dato che possono scombinare l'orientamento degli apici -e dei pedici. L'opzione \code{circled} di \chemmacros viene rispettata da \cmd{ch}. -\begin{beispiel} - \chemsetup[option]{circled=all} - \ch{H+ + OH- <=> H2O} -\end{beispiel} - -\paragraph{Comportamento}\secidx[Apici!Comportamento]{Formule brute} -Nel caso apice e pedice siano direttamente consecutivi in una formula bruta gli -apici si comportano diversamente in base alla loro posizione. -\begin{beispiel} - \ch{^33B} \ch{{}^33B} \ch{3^3B} \ch{B^3} \ch{B3^3} \\ - \ch{^{23}_{123}B} \ch{{}^{23}_{123}B} \ch{_{123}^{23}B} \ch{B^{23}} \ch{B_{123}^{23}} \\ - \ch{^{123}_{23}B} \ch{{}^{123}_{23}B} \ch{_{23}^{123}B} \ch{B^{123}} \ch{B23^{123}} -\end{beispiel} -\begin{itemize} - \item Quando una formula \emph{inizia} con un apice, gli apici e i pedici vengono - giustificati a \emph{destra}, altrimenti a \emph{sinistra}. - \item Quando un apice \emph{segue} un pedice, questo verrà ulteriormente spostato - di una lunghezza che viene determinata dall'opzione \key{charge-hshift}{<dim>} - (vedi anche a pagina~\pageref{desc:charge-hshift}s). -\end{itemize} - -Il secondo punto segue l'indicazione \ac{iupac}: -\begin{zitat}[{\ac{iupac} Green Book {\cite[][p.\,51]{iupac:greenbook}}}] - In writing the formula for a complex ion, spacing for charge number can be added - (staggered arrangement), as well as parentheses: \ch[charge-hshift=full]{SO4^2-}, - \ch{(SO4)^2-} The staggered arrangement is now recommended. -\end{zitat} - -\subsection{Legami}\label{ssec:bonds}\secidx[Legami]{Formule brute} -\subsubsection{Legami nativi} -Vi sono tre tipi di quelli chiamati d'ora in poi \enquote{legami nativi}. -\begin{beispiel} - singolo: \ch{CH3-CH3} \\ - doppio: \ch{CH2=CH2} \\ - triplo: \ch{CH+CH} -\end{beispiel} - -\subsubsection{Legami flessibili} -\paragraph{Predefiniti} -Oltre i tre legami nativi ve ne sono alcuni altri che possono essere richiamati -tramite -\begin{beschreibung} - \Befehl{bond}{<bond name>} -\end{beschreibung} -I tipi predefiniti sono mostrati nella tabella~\ref{tab:bond_types}. - -\begin{table} - \centering - \caption{Legami disponibili con \protect\cmd{bond}.} - \label{tab:bond_types} - \begin{tabular}{lcl} - \toprule - \bfseries Nome & \bfseries Aspetto & \bfseries Alias \\ - \midrule - \code{single} & \bond{single} & \code{normal}, \code{sb} \\ - \code{double} & \bond{double} & \code{db} \\ - \code{triple} & \bond{triple} & \code{tp} \\ - \code{dotted} & \bond{dotted} & \code{semisingle} \\ - \code{deloc} & \bond{deloc} & \code{semidouble} \\ - \code{tdeloc} & \bond{tdeloc} & \code{semitriple} \\ - \code{co>} & \bond{co>} & \code{coordright} \\ - \code{<co} & \bond{<co} & \code{coordleft} \\ - \bottomrule - \end{tabular} -\end{table} - -\begin{beispiel} - \ch{C\bond{sb}C\bond{db}C\bond{tp}C\bond{deloc}C\bond{tdeloc}C\bond{co>}C\bond{<co}C} -\end{beispiel} - -\paragraph{Legami personalizzati} -\chemformula offre dei comandi per definire dei tipi di legame personali: -\begin{beschreibung} - \Befehl{DeclareChemBond}{<name>}\ma{<code>} - \Befehl{RenewChemBond}{<name>}\ma{<code>} - \Befehl{DeclareChemBondAlias}{<new name>}\ma{<old name>} - \Befehl{ShowChemBond}{<name>} -\end{beschreibung} -Il loro uso è facilmente descritto da un esempio. Vediamo come sono definiti il -legame \code{single} ed il legame \code{co>}: -\begin{beispiel}[code only] - \DeclareChemBond{single} - { \draw[chembond] (chemformula-bond-start) -- (chemformula-bond-end) ; } - \DeclareChemBond{coordright} - { \draw[chembond,butt cap->] (chemformula-bond-start) -- (chemformula-bond-end) ; } - \DeclareChemBondAlias{co>}{coordright} -\end{beispiel} -Due punti sono importanti: i nomi delle coordinate di partenza e di arrivo, -\code{chemformula-bond-start} e \code{chemformula-bond-end}, e lo stile \TikZ -dei legami \code{chembond}. - -Supponiamo di voler definire un particolare tipo di legame tratteggiato, ad -esempio nel modo seguente: -\begin{beispiel} - \usetikzlibrary{decorations.pathreplacing} - \makeatletter - \DeclareChemBond{dashed} - { - \draw[ - chembond, - decorate, - decoration={ticks,segment length=\chemformula@bondlength/10,amplitude=1.5pt}] - (chemformula-bond-start) -- (chemformula-bond-end) ; - } - \makeatother - \chemsetup[chemformula]{bond-length=2ex} - \ch{C\bond{dashed}C} -\end{beispiel} - -L'ultimo esempio mostra un'ulteriore macro: \makeatletter\cmd{chemformula@bondlength}\makeatother. -Esiste solamente per accedere direttamente alla lunghezza di legame impostata -direttamente con \key{bond-length}.% (vedi anche a pagina~\pageref{key:bond-length}). - -\subsection{Personalizzazione}\secidx[Personalizzazione]{Formule brute}\label{ssec:compounds:customization} -Le seguenti opzioni permettono di adattare l'output: -\begin{beschreibung} - \option{subscript-vshift}{<dim>} Ulteriore spostamento verticale dei pedici. - Default = \code{0pt} - \option{subscript-style}{text|math} Stile usato per i pedici. Default = \code{text} - \option{charge-hshift}{<dim>} Spostamento degli apici seguenti un pedice. Default - = \code{.25em}\label{desc:charge-hshift} - \option{charge-style}{text|math} Stile usato per gli apici. Default = \code{text} - \option{adduct-space}{<dim>} Spazio vuoto ai lati del punto di addotto. Default - = \code{.1333em} - \option{bond-length}{<dim>} Lunghezza dei legami. Default = \code{.5833em}. - \option{bond-offset}{<dim>} Distanza tra atomo e legame. Default = \code{.07em} - \option{bond-style}{<tikz>} Opzioni di \TikZ\ per i legami. Inizialmente vuoto. - \option{radical-style}{<tikz>} Opzioni di \TikZ\ per il punto radicalico. - Inizialmente vuoto. - \option{radical-radius}{<dim>} Il raggio del punto radicalico. Default = \code{.2ex} - \option{radical-hshift}{<dim>} Spazio orizzontale precedente il punto - radicalico. Default = \code{.15em} - \option{radical-vshift}{<dim>} Posizione verticale del punto radicalico - riferita all'attuale linea di base. Default = \code{.5ex} - \option{radical-space}{<dim>} Spazio orizzontale seguente il punto radicalico. - Default = \code{.15em} -\end{beschreibung} - -Forse l'utente si sarà accorto che per alcuni ioni le cariche sono spostate a -destra:\secidx[Cariche!Spostamento]{Formule brute} -\begin{beispiel} - \ch{SO4^2-} \ch{NH4+} \ch{Na+} -\end{beispiel} -Queste vengono spostate quando \emph{seguono} un pedice, seguendo la -raccomandazione \ac{iupac}~\cite[][p.\,51]{iupac:greenbook}. La dimensione dello -spostamento può essere impostata con l'opzione \key{charge-hshift}. -\begin{beispiel} - \ch{SO4^2-} \ch{NH4+} \ch{Na+} \\ - \chemsetup[chemformula]{charge-hshift=.5ex} - \ch{SO4^2-} \ch{NH4+} \ch{Na+} \\ - \chemsetup[chemformula]{charge-hshift=.5pt} - \ch{SO4^2-} \ch{NH4+} \ch{Na+} -\end{beispiel} - -Nonostante l'indicazione \ac{iupac}, \chemformula nell'impostazione predefinita -non genera apici completamente spostati, che a mio parere in alcuni casi sono di -difficile lettura ed in altri casi di aspetto sgradevole. Trattandosi di una -percezione soggettiva, \chemformula offre sia la possibilità di impostare un -valore assoluto per lo spostamento che di spostare completamente l'apice. -Nell'ultimo caso va impiegato \key{charge-hshift}{full}. -\begin{beispiel} - \ch[charge-hshift=0pt]{C5H11+} \ch[charge-hshift=0pt]{SO4^2-} \\ - \ch{C5H11+} \ch{SO4^2-} \\ - \ch[charge-hshift=1ex]{C5H11+} \ch[charge-hshift=1ex]{SO4^2-} \\ - \ch[charge-hshift=full]{C5H11+} \ch[charge-hshift=full]{SO4^2-} -\end{beispiel} - -Se non si desidera rendere le cariche in modo testuale è possibile passare al -modo matematico: -\begin{beispiel} - \ch{M^x+} \ch{SO4^2-} \\ - \chemsetup[chemformula]{charge-style = math} - \ch{M^x+} \ch{SO4^2-} -\end{beispiel} - -L'opzione \key{subscript-vshift} può essere impiegata per adattare lo spostamento -verticale dei pedici.\secidx[Pedici!Spostamento]{Formule brute} -\begin{beispiel} - \ch{H2SO4} \ch{Na3PO4} \\ - \chemsetup[chemformula]{subscript-vshift=.5ex} - \ch{H2SO4} \ch{Na3PO4} \\ - \chemsetup[chemformula]{subscript-vshift=-.2ex} - \ch{H2SO4} \ch{Na3PO4} -\end{beispiel} - -Si può inolte selezionare in quale modo verranno composti i pedici: -\begin{beispiel} - \ch{A_nB_m} \ch{H2SO4} \\ - \chemsetup[chemformula]{subscript-style = math} - \ch{A_nB_m} \ch{H2SO4} -\end{beispiel} - -Con l'opzione \key{adduct-space} è possibile variare lo spazio a sinistra e destra -del segno di addotto. -\begin{beispiel} - \ch{Na3PO3*H2O} \\ - \chemsetup[chemformula]{adduct-space=.2em} - \ch{Na3PO3*H2O} -\end{beispiel} - -La lunghezza dei legami va modificata con:\secidx[Legami!Lunghezza]{Formule brute} -\begin{beispiel} - \chemsetup[chemformula]{bond-length=4mm}% - single: \ch{CH3-CH3} \\ - double: \ch{CH2=CH2} \\ - triple: \ch{CH+CH} -\end{beispiel} - -Si può inoltre impostare la distanza tra atomo e legame: -\begin{beispiel} - \ch{H-H + N+N + O=O} \\ - \ch[bond-offset=1pt]{H-H + N+N + O=O} -\end{beispiel} -\secidx*{Formule brute} - -\section{Tipi speciali di input}\secidx{Tipi speciali di input} -Esistono alcuni \enquote{tipi di input speciali}. - -\subsection{Token a input singolo}\secidx[Token a input singolo]{Tipi speciali di input} -Questo tipo è composto da un singolo token compreso tra i seguenti: -\begin{beschreibung} - \befehl{ch}{ + } \ch{+} Genera un segno più tra formule se spaziato a destra e sinistra:\\ - \cmd{ch}{2 Na + Cl2} \ch{2 Na + Cl2} - \befehl{ch}{ v } \ch{v} Simbolo per una precipitazione o la formazione di un solido: \cmd{ch}{BaSO4 v} \ch{BaSO4 v} - \befehl{ch}{ \lstinline+^+ } \ch{^} Simbolo per la formazione di gas: \cmd{ch}{\lstinline=H2 ^=} \ch{H2 ^} -\end{beschreibung} - -Lo spazio a sinistra e destra del più può essere adattato tramite un'opzione: -\begin{beschreibung} - \option{plus-space}{<skip>} Una lunghezza elastica. Default = - \code{.3em plus .1em minus .1em} -\end{beschreibung} -\begin{beispiel} - \ch{A + B}\\ - \ch[plus-space=4pt]{A + B} -\end{beispiel} - -\subsection{Input di opzioni}\secidx[Input di opzioni]{Tipi di input speciali} -Talvolta si desidera applicare un'opzione solo ad una parte di una reazione; -naturalmente è possibile impiegare ripetutamente \cmd{ch}. -\begin{beispiel} - \ch{H2O +}\textcolor{red}{\ch{H2SO4}}\ch{-> H3O+ + HSO4-} \\ - \ch{H2O +}\ch[subscript-vshift=2pt]{H2SO4}\ch{-> H3O+ + HSO4-} -\end{beispiel} -Tuttavia questo interrompe l'input nel sorgente e \emph{potrebbe} influenzare la -spaziatura. Per questo motivo esiste un'alternativa: -\begin{beschreibung}\makeatletter - \befehl{ch}{ @\{<options>\} } Le opzioni date sono attive \emph{solo} fino alla - fine della \emph{prossima} formula bruta. -\end{beschreibung} -\begin{beispiel} - \ch{H2O +}\textcolor{red}{\ch{H2SO4}}\ch{-> H3O+ + HSO4-} \\ - \ch{H2O + @{format=\color{red}} H2SO4 -> H3O+ + HSO4-} \\ - o naturalmente:\\ - \ch{H2O + \textcolor{red}{H2SO4} -> H3O+ + HSO4-}\\[1em] - \ch{H2O +}\ch[subscript-vshift=2pt]{H2SO4}\ch{-> H3O+ + HSO4-} \\ - \ch{H2O + @{subscript-vshift=2pt} H2SO4 -> H3O+ + HSO4-} -\end{beispiel} -\achtung{Si tratta di una modalità sperimentale che potrebbe scomparire nelle versioni future.} -\secidx*{Tipi di input speciali} - -\section{Input protetto}\secidx{Input protettto} -In certi casi si può desiderare di evitare che \chemformula elabori l'input. -Esistono due possibilità di ottenere proprio questo. - -\subsection{Testo}\label{ssec:text}\secidx[text]{Input protetto} -Quando del testo viene posto tra \lstinline+" "+ oppure \lstinline+' '+ allora -l'input viene considerato come testo normale ad eccezione per gli spazi: non sono -ammessi e devono essere inseriti con \lstinline+~+. -\begin{beschreibung} - \Befehl{ch}{ "<escaped text>" } - \Befehl{ch}{ '<escaped text>' } -\end{beschreibung} -\begin{beispiel} - \ch{"\ox{2,Ca}" O} \\ - \ch{"\ldots\," Na + "\ldots\," Cl2 -> "\ldots\," NaCl} \\ - \ch{'A~->~B'} -\end{beispiel} -Questo stratagemma sarà necessario in pochi casi; ma quando risulta difficoltoso -impiegare un comando all'interno di \cmd{ch} può essere utile applicare il modo protetto. - -\subsection{Matematica}\secidx[math]{Input protetto} -Quando si ha dell'input matematico, è sufficiente porlo tra \lstinline+$ $+. -L'output si distingue dal testo protetto (oltre che per il modo matematico) -anche per la presenza di uno spazio in seguito. Il motivo è che suppongo che -l'input matematico venga utilizzato soprattutto in luogo dei fattori -stechiometrici. -\begin{beschreibung} - \Befehl{ch}{ \string$<escaped math>\string$ } - \Befehl{ch}{ \string\(<escaped math>\string\) } -\end{beschreibung} -\begin{beispiel} - escaped text: \ch{"$x$" H2O} \\ - escaped math: \ch{$x$ H2O} \\ - also escaped math: \ch{\(x\) H2O} \\ - \ch{$2n$ Na + $n$ Cl2 -> $2n$ NaCl} -\end{beispiel} - -Lo spazio seguente l'input matematico protetto può essere adattato. -\begin{beschreibung} - \option{math-space}{<skip>} Una lunghezza elastica. Default = - \code{.1667em plus .0333em minus .0117em} -\end{beschreibung} -\begin{beispiel} - \ch{$2n$ Na + $n$ Cl2 -> $2n$ NaCl} \\ - \chemsetup[chemformula]{math-space=.25em} - \ch{$2n$ Na + $n$ Cl2 -> $2n$ NaCl} \\ - \ch{$A->B$} -\end{beispiel} -\secidx*{Input protetto} - -\section{Frecce}\label{sec:arrows}\secidx{Frecce} -\subsection{Tipi di frecce}\secidx[Tipi]{Frecce} -Le frecce vengono indicate nello stesso modo intuitivo di \paket{mhchem}. Ne esiste -una serie: -\begin{beschreibung} - \befehl{ch}{ -> } \ch{->} freccia semplice a destra - \befehl{ch}{ <- } \ch{<-} freccia semplice a sinistra - \befehl{ch}{ -/> } \ch{-/>} non reagisce (destra) - \befehl{ch}{ </- } \ch{</-} non reagisce (sinistra) - \befehl{ch}{ <-> } \ch{<->} doppia freccia di mesomeria - \befehl{ch}{ <> } \ch{<>} la reazione avviene in entrambe le direzioni - \befehl{ch}{ == } \ch{==} equazione stechiometrica - \befehl{ch}{ <=> } \ch{<=>} doppia freccia di equilibrio - \befehl{ch}{ \lstinline+<=>>+ } \ch{<=>>} equilibrio spostato a destra - \befehl{ch}{ \lstinline+<<=>+ } \ch{<<=>} equilibrio spostato a sinistra - \befehl{ch}{ <o> } \ch{<o>} freccia isolobale -\end{beschreibung} -Tutte le frecce sono disegnate con \TikZ. -\begin{beispiel} - \ch{H2 + Cl2 -> 2 HCl} \\ - \ch{H2O + CO3^2- <=> OH- + HCO3-} \\ - \ch{A <- B} \\ - \ch{\{[CH2=CH-CH2]- <-> [CH2-CH=CH2]- \}} \\ - \ch{A <> B} \\ - \ch{H+ + OH- <=>> H2O} \\ - \ch{2 NO2 <<=> N2O4} -\end{beispiel} - -\subsection{Etichettazione}\secidx[Etichettazione]{Frecce} -Le frecce hanno due argomenti opzionali per essere etichettate. -\begin{beschreibung} - \Befehl{ch}{ ->[<above>][<below>] } -\end{beschreibung} -\begin{beispiel} - \ch{A ->[a] B} \\ - \ch{A ->[a][b] B} \\ - \ch{A ->[\SI{100}{\celsius}] B} -\end{beispiel} -Il testo descrittivo può essere elaborato indipendentemente dalla freccia: basta -usare degli spazi. -\begin{beispiel} - \ch{A ->[H2O] B} \\ - \ch{A ->[ H2O ] B} \\ - \ch{A ->[ "\ox{2,Ca}" F2 ] B} \\ - \ch{A ->[$\Delta$,~ \[H+ \]] B} -\end{beispiel} - -Quando sono presenti degli spazi \chemformula elabora dapprima la parte tra -parentesi come un input normale. Le frecce leggono i loro argomenti solo \emph{dopo} -l'elaborazione. Come si può vedere, le frecce \enquote{crescono} con la lunghezza -dell'etichetta, mentre rimane costante la parte eccedente. Nell'ultimo esempio si -può inoltre vedere che le parentesi quadre all'interno degli argomenti dei comandi -freccia devono essere inserite con \cmd{[} e \cmd{]}; naturalmente al di fuori di -\cmd{ch} mantengono il loro comportamento normale. Questi comandi sono necessari -perché il metodo solitamente impiegato di racchiudere le parentesi quadre tra -parentesi graffe non funziona a causa del modo in cui \cmd{ch} legge il suo -argomento. -\begin{beispiel} - \ch{A ->[a] B} \\ - \ch{A ->[ab] B} \\ - \ch{A ->[abc] B} \\ - \ch{A ->[abc~abc] B} \\ - % needs the `chemfig' package: - \setatomsep{15pt} - \ch{A ->[ "\chemfig{-[:30]-[:-30]OH}" ] B} \\ - \ch{A ->[[]] B} vs. \ch{A ->[\[\]] B} -\end{beispiel} - -\subsection{Adattamento}\secidx[Adattamento]{Frecce} -Con le opzioni seguenti è possibile adattare la resa grafica delle frecce: -\begin{beschreibung} - \option{arrow-offset}{<dim>} La lunghezza della freccia eccedente l'etichetta (a - sinistra e destra). La lunghezza di una freccia vuota è il doppio di \code{arrow-offset}. - Una lunghezza di \TeX. Default = \code{.75em} -\option{arrow-min-length}{<dim>} La lunghezza minima che deve avere un errore, - se tale lunghezza è inferiore al doppio di \key{arrow-offset} più la larghezza - dell'etichetta. Default = \code{0pt} - \option{arrow-yshift}{<dim>} Sposta una freccia verso l'alto (valore positivo) o - verso il basso (valore negativo); una dimensione di \TeX. Default = \code{0pt} - \option{arrow-ratio}{<factor>} Il rapporto tra le lunghezze delle frecce di equilibrio - spostato: \code{.4} significa che la freccia più corta è lunga \num{0.4} volte - la freccia più lunga. Default = \code{.6} - \option{compound-sep}{<dim>} Lo spazio vuoto tra formule e freccia; una dimensione - di \TeX. Default = \code{.5em} - \option{label-offset}{<dim>} Lo spazio tra freccia ed etichette; una dimensione - di \TeX. Default = \code{2pt} - \option{label-style}{<font command>} Il corpo del font dell'etichetta. Default = - \lstinline+\footnotesize+ -\end{beschreibung} - -Il codice seguente mostra gli effetti delle varie opzioni sulla freccia \lstinline+<=>>+: -\begin{beispiel} - standard: \ch{A <=>>[x][y] B} \\ - più lunga: \ch[arrow-offset=12pt]{A <=>>[x][y] B} \\ - più alta: \ch[arrow-yshift=2pt]{A <=>>[x][y] B} \\ - più bilanciata: \ch[arrow-ratio=.8]{A <=>>[x][y] B} \\ - etichetta più distante: \ch[label-offset=4pt]{A <=>>[x][y] B} \\ - distanza maggiore dalle formule: \ch[compound-sep=2ex]{A <=>>[x][y] B} \\ - etichette più piccole: \ch[label-style=\tiny]{A <=>[x][y] B} -\end{beispiel} - -\subsection{Modificare i tipi di frecce}\label{sec:arrows_modify}\secidx[tipi!modificare]{Frecce} -Le frecce sono definite attraverso il comando -\begin{beschreibung} - \Befehl{DeclareChemArrow}{<tokens>}\ma{<tikz>} -\end{beschreibung} -\ma{<tokens>} sono i simboli sostituiti dal codice proprio della freccia. Ad esempio, -la freccia principale è stata definita attraverso -\begin{beispiel}[code only] - \DeclareChemArrow{->}{\draw[-cf] (cf_arrow_start) -- (cf_arrow_end) ;} -\end{beispiel} -Nel caso si desideri definire frecce proprie sono necessarie conoscenze fondamentali -di \TikZ\footnote{Si rimanda alla guida \textsf{pgfmanual}.}. Si consiglia l'uso -di alcune coordinate predefinite: -\begin{description} - \item[\code{(cf\_arrow\_start)}] L'inizio della freccia. - \item[\code{(cf\_arrow\_end)}] La fine della freccia. - \item[\code{(cf\_arrow\_mid)}] La metà della freccia. - \item[\code{(cf\_arrow\_mid\_start)}] L'inizio della freccia più breve nelle freccie - del tipo \lstinline+<=>>+. - \item[\code{(cf\_arrow\_mid\_end)}] La fine della freccia più breve nelle freccie - del tipo \lstinline+<=>>+. - \item[\code{cf}, \code{left cf}, \code{right cf}] Punte di frecce definite per - \chemformula. -\end{description} -\begin{beispiel} - \DeclareChemArrow{.>}{\draw[-cf,dotted,red] (cf_arrow_start) -- (cf_arrow_end);} - \DeclareChemArrow{n>}{\draw[-cf] (cf_arrow_start) .. controls ([yshift=3ex]cf_arrow_mid) .. (cf_arrow_end);} - \ch{A .> B} \ch{A .>[a][b] B} \ch{A n> B} -\end{beispiel} -Quando si desidera ridefinire una freccia preesistente, è possibile usare uno dei -due comandi seguenti: -\begin{beschreibung} - \Befehl{RenewChemArrow}{<tokens>}\ma{<tikz>} - \Befehl{ShowChemArrow}{<tokens>} -\end{beschreibung} -Il secondo mostra la definizione attuale, il primo ridefinisce la freccia. -\begin{beispiel} - \texttt{\ShowChemArrow{->}} \\ - \RenewChemArrow{->}{\draw[->,red] (cf_arrow_start) -- (cf_arrow_end) ;} - \texttt{\ShowChemArrow{->}} \\ - \ch{A -> B} -\end{beispiel} -\secidx*{Frecce} - -\section{Didascalie di formule}\secidx{Didascalie di formule} -\subsection{Sintassi}\secidx[sintassi]{Didascalie di formule} -\chemformula ha una propria sintassi per scrivere del testo sotto ad una formula -chimica, che funziona in modo analogo agli argomenti opzionali delle frecce. -\begin{beschreibung} - \Befehl{ch}{ !(<name>)( <formula> ) } -\end{beschreibung} -Quando un punto esclamativo viene seguito da una coppia di parentesi tonde, -\chemformula fa il seguente: -\begin{beispiel} - \ch{!(ethanol)( CH2CH2OH )} -\end{beispiel} - -Quel che vale per le etichette delle frecce vale anche qui: lasciando degli spazi -le parti di input vengono elaborate a seconda del loro tipo prima che il testo -venga scritto sotto la formula. -\begin{beispiel} - \ch{!(water)(H2O)} \quad - \ch{!( "\textcolor{blue}{water}" )( H2O )} \quad - \ch{!( $2n-1$ )( H2O )} \quad - \ch{!( H2O )( H2O )} \quad - \ch{!(oxonium)( H3O+ )} -\end{beispiel} - -Se per qualche ragione si desidera avere un punto esclamativo \emph{senza} aggiungere -un testo sotto una formula, è sufficiente evitare di farlo seguire da parentesi. -\begin{beispiel} - \ch{H2O~(!)} \\ - \ch{A!{}()} -\end{beispiel} - -\subsection{Personalizzazione}\secidx[Personalizzazione]{Didascalie di formule} -\chemformula mette a disposizione due opzioni per adattare il testo: -\begin{beschreibung} - \option{name-format}{<commands>} Il formato del testo; può essere inserito un - input qualunque. Default = \lstinline+\scriptsize\centering+ - \option{name-width}{<dim>|auto} La larghezza del box nel quale viene posto il - testo: \code{auto} riconosce la larghezza della didascalia e imposta il box di - conseguenza. Default = \code{auto} -\end{beschreibung} -\begin{beispiel} - \ch{!(acido)( H2SO4 ) -> B} \\ - \ch[name-format=\sffamily\small]{!(acido)( H2SO4 ) -> B} \\ - \ch[name-format=\scriptsize N:~]{!(acido)( H2SO4 ) -> B} \\ - \ch[name-width=3em,name-format=\scriptsize\raggedright]{!(acido)( H2SO4 ) -> B} -\end{beispiel} -\secidx*{Didascalie di formule} - -\section{Formato e carattere}\label{sec:format}\secidx{Formato e carattere} -Come impostazione predefinita \chemformula non varia l'output delle formule. -Prendiamo come esempio un input privo di senso chimico per dimostrare tutte le -capacità di \chemformula: -\begin{beispiel} - \newcommand*\sample{\ch{H2C-C+C-CH=CH+ + CrO4^2- <=>[x][y] 2.5 Cl^{-.} + 3_1/2 Na*OH_{(aq)} + !(name)( A^n ) "\LaTeXe"}} - \sample -\end{beispiel} -\newcommand*\sample{\ch{H2C-C+C-CH=CH+ + CrO4^2- <=>[x][y] 2.5 Cl^{-.} + 3_1/2 Na*OH_{(aq)} + !(name)( A^n ) "\LaTeXe"}} -Ora variamo alcuni aspetti del testo e osserviamo i risultati: -\begin{beispiel}[below] - \sffamily Ciao \sample \\ - \ttfamily Ciao \sample \normalfont \\ - \bfseries Ciao \sample \normalfont \\ - \itshape Ciao \sample -\end{beispiel} -Come si osserva la maggior parte delle funzioni adattano le caratteristiche del -font circostante. - -Quando si vuole cambiare questo comportamento preimpostato oppure il formato di -default è possibile usare la seguente opzione: -\begin{beschreibung} - \option{format}{<anything>} Inserisce il codice desiderato all'inizio del comando - \cmd{ch}. -\end{beschreibung} -\begin{beispiel} - % blu e privo di grazie: - \definecolor{newblue}{rgb}{.1,.1,.5}\chemsetup[chemformula]{format=\color{newblue}\sffamily} - \sffamily Ciao \sample \\ - \ttfamily Ciao \sample \normalfont \\ - \bfseries Ciao \sample \normalfont \\ - \itshape Ciao \sample -\end{beispiel} - -Si possono inoltre variare specificatamente la famiglia, la serie e la forma del -font dell'output: -\begin{beschreibung} - \option{font-family}{<family>} Varia la famiglia con: \lstinline+\fontfamily{<family>}\selectfont+. - \option{font-series}{<series>} Varia la serie con: \lstinline+\fontseries{<series>}\selectfont+. - \option{font-shape}{<shape>} Varia la forma con \lstinline+\fontshape{<shape>}\selectfont+. -\end{beschreibung} -\begin{beispiel} - % sempre in nero: - \chemsetup[chemformula]{font-series=bx} - Ciao \sample \\ - \sffamily Ciao \sample \normalfont \\ - \chemsetup[chemformula]{font-family=lmr,font-series=m} Ciao \sample \normalfont \\ - \itshape Ciao \sample -\end{beispiel} - -Quando si impiegano \XeLaTeX\ oppure \LuaLaTeX\ avendo caricato il pacchetto -\paket{fontspec}, è possibile variare il carattere di \chemformula anche nel -modo seguente: -\begin{beschreibung} - \Option{font-spec}{\{<font>\}} oppure con opzioni - \Option{font-spec}{\{[<options>]<font>\}} -\end{beschreibung} -\begin{beispiel} - \chemsetup[chemformula]{font-spec={Linux Biolinum O}} \sample \\ - \chemsetup[chemformula]{font-spec={[Color=darkgray]Augie}} \sample \\ - \chemsetup[chemformula]{font-spec={Tipbrush Script}} \sample \\ - \chemsetup[chemformula]{font-spec={Latin Modern Sans}} \sample \\ - \bfseries \sample \normalfont \\ - \chemsetup[chemformula]{font-spec={Feathergraphy Decoration}} \sample -\end{beispiel} -\secidx*{Formato e carattere} - -\section{Utilizzo in ambienti matematici}\secidx{Ambienti matematici} -Il comando \cmd{ch} può essere utilizzato in ambienti matematici; riconosce -\lstinline+\\+ e \lstinline+&+ e ne passa oltre i contenuti; tuttavia gli -argomenti opzionali di \lstinline+\\+ non possono essere utilizzati all'interno -di \cmd{ch}. -\begin{beispiel} - \begin{align} - \ch{ - H2O & ->[a] H2SO4 \\ - Cl2 & ->[x][y] CH4 - } - \end{align} - \begin{align*} - \ch{ - RNO2 &<=>[ + e- ] RNO2^{-.} \\ - RNO2^{-.} &<=>[ + e- ] RNO2^2- - } - \end{align*} -\end{beispiel} -\secidx*{Ambienti matematici} - -\section{Ulteriori esempi} -Questo paragrafo mostra ulteriori esempi per l'impiego di \chemformula, ed in -particolare l'accoppiamento agli ambienti \code{reaction} di \chemmacros. - -\begin{beispiel} - \begin{reaction}[Sintesi di alcani] - !(gas~di~sintesi)( $n$ CO + $(2n+1)$ H2 ) ->[\SI{200}{\celsius}][\[CoNi\]] C_{$n$}H_{$2n+2$} + $n$ H2O - \end{reaction} -\end{beispiel} - -\begin{beispiel} - \begin{reactions*} - "a)" && CH4 + Cl2 &-> CH3Cl + HCl && "{\small clorometano/cloruro~di~metile}" \\ - "b)" && CH3Cl + Cl2 &-> CH2Cl2 + HCl && "{\small diclorometano/cloruro~di~metilene}" \\ - "c)" && CH2Cl2 + Cl2 &-> CHCl3 + HCl && "{\small triclorometano/cloroformio}" \\ - "d)" && CHCl3 + Cl2 &-> CCl4 + HCl && "{\small tetraclorometano/tetracloruro~di~carbonio}" - \end{reactions*} -\end{beispiel} - -\begin{beispiel} - \chemsetup[ox]{parse=false}\ch{"\ox{\delm,C}" -{} "\ox{\delp,M}" \qquad ( <-> "\ox{\delp,C}" -{} "\ox{\delm,Br}" )} \\ - \ch[adduct-space=0pt]{X. + .Y <=> X-Y + energia~di~legame} \\ - \ch[name-format=\normalsize]{!(\State{H}{f}\qquad)() !(\textcolor{red}{??})( CH4\gas{} ) + !(\num{0})( 2 O2\gas{} ) -> !(\num{-94.3})( CO2\gas{} ) + !(\num{-57.9})( H2O\lqd{} ) + !(\num{-192.1})( "\State{H}" )} -\end{beispiel} - -\begin{beispiel} - \begin{reactions*} - CH3MgBr + "\ox*{1,Cu}" X &-> "\glqq" CH3 "\ox*{1,Cu}\grqq" + MgBrX "\qquad X~$=$~Br,I,CN" \\ - 2 MeLi + CuI &-> !(dimetilcuprato~(cuprato~di~Gilmann))( Me2CuLi ) + Li - \end{reactions*} -\end{beispiel} - -\begin{beispiel} - % needs `chemfig' - \begin{reactions*} - H3C-CH3 + Cl2 &->[$\Delta$][$h\nu$] H3CCH2Cl + HCl & &"\Enthalpy{-27.1}" \\ - H3C-CH3 + "\Lewis{0.,Cl}" &-> H3CCH2 "\Lewis{0.,\vphantom{H}}" + HCl & &"\Enthalpy{-5.0}" \\ - H3C-CH2 "\Lewis{0.,\vphantom{H}}" + Cl2 &-> H3CCH2Cl + "\Lewis{0.,Cl}" & &"\Enthalpy{-23.0}" - \end{reactions*} -\end{beispiel} - -L'esempio seguente mostra come si può rappresentare la semplificazione di sistemi -di reazioni\footnote{Ispirato da una domanda su TeX.SE: -\url{http://tex.stackexchange.com/q/30118/5049}}. -\begin{beispiel} - % needs `cancel' - \begin{align*} - \centering - \ch{\cancel{HCOOH\aq} + H2O\lqd{} &<=> H3O^+\aq{} + \cancel{HCOO^-\aq}} \\ - \ch{\cancel{HCOO^-\aq} + H2O\lqd{} &<=> \cancel{HCOOH\aq} + OH^-\aq}\\[-1ex] - \cline{1-2} - \ch{H2O\lqd{} + H2O\lqd{} &<=> H3O^+\aq{} + OH^-\aq} - \end{align*} -\end{beispiel} -\secidx*{CHEMFORMULA} - -\part{\texorpdfstring{\Ghsystem}{ghsystem}}\label{part:ghsystem}\secidx{GHSYSTEM} -\section{Setup} -Tutte le opzioni di \ghsystem appartengono al modulo \textcolor{module}{\code{ghsystem}}. -Possono essere impostate anche con -\begin{beschreibung} - \Befehl{chemsetup}[ghsystem]{<options>} oppure - \Befehl{chemsetup}{ghsystem/<option1>,ghsystem/<option2>} -\end{beschreibung} -Inoltre possono essere passate anche localmente ai comandi come argomenti opzionali. - -\section{Richiamare le frasi di rischio (H) e sicurezza (P)}\secidx{Frasi di rischio e sicurezza}[Frasi di rischio e sicurezza] -\subsection{Chiamata semplice}\secidx[Chiamata]{GHSYSTEM} -È generalmente semplice richiamare le frasi: -\begin{beschreibung} - \Befehl{ghs}[<options>]{<type>}\ma{<number>} - \Befehl[ghsa]{ghs*}[<options>]{<type>}\ma{<number>} -\end{beschreibung} -Esistono tre tipi di frasi: \code{h}, \code{euh} e \code{p}; l'argomento \ma{<type>} -non distingue tra maiuscole e minuscole. -\begin{beispiel} - \ghs{h}{200} \\ - \ghs{H}{224} \\ - \ghs{euh}{001} \\ - \ghs{Euh}{202} \\ - \ghs{p}{201} -\end{beispiel} - -La versione asteriscata nasconde il numero e restituisce solo la frase. Quando si -desidera nascondere la frase e richiamare solo il numero, è possibile utilizzare -l'opzione seguente: -\begin{beschreibung} - \Option{hide}{\default{true}|false} -\end{beschreibung} - -Inoltre esiste un'opzione per adattare l'output. -\begin{beschreibung} - \option{space}{<space command>} Spazio tra \code{<type>} e \code{<number>}. -\end{beschreibung} -\begin{beispiel} - \ghs{h}{200} \\ - \ghs[space=\,]{h}{200} \\ - \ghs*{h}{200} \\ - \ghs[hide]{h}{200} -\end{beispiel} - -\subsection{Frasi con segnaposto}\secidx[Segnaposto]{GHSYSTEM} -Alcune frasi utilizzano dei segnaposto; ve ne sono quattro diversi: -\begin{itemize} - \item \textit{\textless indicare la via di esposizione se è accertato che - nessun'altra via di esposizione comporta il medesimo pericolo\textgreater} - \item \textit{\textless indicare l'effetto specifico, se noto\textgreater} - \item \textit{\textless o indicare tutti gli organi interessati, se noti\textgreater} - \item \textit{\textless denominazione della sostanza sensibilizzante\textgreater} -\end{itemize} - -Da predefinito sono nascosti tutti tranne l'ultimo, che deve essere sostituito. -Possono essere resi visibili attraverso l'opzione -\begin{beschreibung} - \option{fill-in}{\default{true}|false} Default = \code{false} -\end{beschreibung} -\begin{beispiel}[below] - \ghs{h}{340} \\ - \ghs[fill-in]{h}{340} \\ - \ghs{h}{360} \\ - \ghs[fill-in]{h}{360} \\ - \ghs{h}{370} \\ - \ghs[fill-in]{h}{370} \\ - \ghs{euh}{208} \\ - \ghs[fill-in]{euh}{208} -\end{beispiel} - -Con le opzioni seguenti è possibile sostituire i segnaposto: -\begin{beschreibung} - \option{exposure}{<text>} segnaposto di esposizione - \option{effect}{<text>} segnaposto di effetto - \option{organs}{<text>} segnaposto di organo - \option{substance}{<text>} segnaposto di sostanza -\end{beschreibung} -\begin{beispiel} - \ghs[exposure=In questo modo si è esposti al pericolo.]{h}{340} \\ - \ghs[effect=Questi sono gli effetti.]{h}{360} \\ - \ghs[organs=quest'organo]{h}{370} \\ - \ghs[substance=sostanza]{euh}{208} -\end{beispiel} - -\subsection{Frasi con buchi}\secidx[Frasi con buchi]{GHSYSTEM} -Alcune frasi hanno dei \enquote{buchi}: -\begin{beispiel} - \ghs{p}{301} \\ - \ghs{p}{401} \\ - \ghs{p}{411} \\ - \ghs{p}{413} -\end{beispiel} - -Con le seguenti opzioni questi buchi possono essere riempiti: -\begin{beschreibung} - \option{text}{<text>} Riempie il \enquote{buco invisibile} che segue un doppio - punto. - \option{dots}{<text>} Riempie il buco indicato da \enquote{\ldots}. - \option{C-temperature}{<num>} Inserisce la temperatura in Celsius. - \option{F-temperature}{<num>} Inserisce la temperatura in Fahrenheit. - \option{kg-mass}{<num>} Inserisce la massa in chilogrammi. - \option{lbs-mass}{<num>} Inserisce la massa in libbre. -\end{beschreibung} -\begin{beispiel} - \ghs[dots=Contattare un medico!]{p}{301} \\ - \ghs[text=qui]{p}{401} \\ - \ghs[C-temperature=50, F-temperature=122]{p}{411} \\ - \ghs[kg-mass=5.0, lbs-mass=11, C-temperature=50, F-temperature=122]{p}{413} -\end{beispiel} - -\subsection{Frasi combinate}\secidx[Frasi combinate]{GHSYSTEM} -Esistono alcune frasi combinate. Vengono inserite con un \code{+} tra i numeri: -\begin{beispiel}[below] - \ghs{p}{235+410} \\ - \ghs{p}{301+330+331} -\end{beispiel} - -Si noti che sono valide solo le combinazioni ufficiali. \emph{Non è possibile -combinare le frasi a piacere}. -\secidx*{Frasi di rischio e sicurezza} - -\section{Pittogrammi}\secidx{Pittogrammi} -\subsection{Le immagini} -Il \ac{ghs} contiene alcuni pittogrammi: - -\ghspic{explos} \ghspic{flame} \ghspic{flame-O} \ghspic{bottle} \ghspic{acid} -\ghspic{skull} \ghspic{exclam} \ghspic{health} \ghspic{aqpol} - -Il comando -\begin{beschreibung} - \Befehl{ghspic}[<options>]{<name>} -\end{beschreibung} -li carica. La tabella~\ref{tab:ghs_pictograms} mostra tutti i pittogrammi e i nomi -dei loro file, o meglio: mostra i nomi dei file da utilizzare con il comando \cmd{ghspic}. -In realtà i file si chiamano \lstinline=ghsystem_<name>.<filetype>=, dove -\code{<filetype>} è un'estensione tra \code{eps}, \code{pdf}, \code{jpg} -oppure \code{png}, vedi anche il paragrafo~\ref{ssec:picture_type}. -\begin{beispiel} - \ghspic{skull} -\end{beispiel} - -Se si preferisce variare la dimensione, è disponibile l'opzione -\begin{beschreibung} - \option{scale}{<factor>} Scala il pittogramma. Default = \code{1} -\end{beschreibung} -Le immagini originali sono piuttosto grandi. La preimpostazione (fattore = $1$) -scala le immagini ad un ventesimo della loro dimensione reale. -\begin{beispiel} - \ghspic[scale=2]{skull} -\end{beispiel} - -Se si desidera utilizzare opzioni speciali di \lstinline=\includegraphics=, ad -esempio per ruotare il pittogramma, va usata l'opzione seguente: -\begin{beschreibung} - \Option{includegraphics}{\{<includegraphics keyvals>\}} -\end{beschreibung} -\begin{beispiel} - \ghspic[includegraphics={angle=90}]{skull} -\end{beispiel} - -\begin{longtable}{>{\ttfamily}ll>{\ttfamily}ll} - \caption{Tutti i pittogrammi \ac{ghs} disponibili.\label{tab:ghs_pictograms}} \\ - \toprule - \normalfont\bfseries nome & \bfseries pittogramma & \normalfont\bfseries nome & \bfseries pittogramma \\ - \midrule\endfirsthead - \toprule - \normalfont\bfseries nome & \bfseries pittogramma & \normalfont\bfseries nome & \bfseries pittogramma \\ - \midrule\endhead - \bottomrule\endfoot - explos & \ghspic{explos} & explos-1 & \ghspic{explos-1} \\ - explos-2 & \ghspic{explos-2} & explos-3 & \ghspic{explos-3} \\ - explos-4 & \ghspic{explos-4} & explos-5 & \ghspic{explos-5} \\ - explos-6 & \ghspic{explos-6} & & \\ - flame & \ghspic{flame} & flame-2-white & \ghspic{flame-2-white} \\ - flame-2-black & \ghspic{flame-2-black} & flame-3-white & \ghspic{flame-3-white} \\ - flame-3-black & \ghspic{flame-3-black} & flame-4-1 & \ghspic{flame-4-1} \\ - flame-4-2 & \ghspic{flame-4-2} & flame-4-3-white & \ghspic{flame-4-3-white} \\ - flame-4-3-black & \ghspic{flame-4-3-black} & flame-5-2-white & \ghspic{flame-5-2-white} \\ - flame-5-2-black & \ghspic{flame-5-2-black} & & \\ - flame-O & \ghspic{flame-O} & flame-O-5-1 & \ghspic{flame-O-5-1} \\ - bottle & \ghspic{bottle} & bottle-2-black & \ghspic{bottle-2-white} \\ - bottle-2-white & \ghspic{bottle-2-black} & & \\ - acid & \ghspic{acid} & acid-8 & \ghspic{acid-8} \\ - skull & \ghspic{skull} & skull-2 & \ghspic{skull-2} \\ - skull-6 & \ghspic{skull-6} & & \\ - exclam & \ghspic{exclam} & & \\ - health & \ghspic{health} & & \\ - aqpol & \ghspic{aqpol} & & \\ -\end{longtable} - -\subsection{Il tipo dell'immagine dipende dal compilatore}\label{ssec:picture_type} -L'utente probabilmente è a conoscenza che non tutti i tipi di immagini sono compatibili -con ciascun compilatore. \pdfTeX{} in modalità \acs{dvi} richiede file di tipo -\code{eps}, mentre \pdfTeX{} in modalità \acs{pdf}, \XeTeX{} e \LuaTeX{} convertono -file di tipo \code{eps} in \code{pdf}, ammesso che l'utente abbia diritti di scrittura -nella cartella contenente le immagini. Gli ultimi elencati sanno tuttavia -includere immagini di tipo \code{jpg} e \code{png} senza problemi, mentre -\pdfTeX{} in modalità \acs{dvi} non ne è capace. - -Per risolvere il problema \ghsystem verifica quale compilatore viene utilizzato, -e nel caso di \pdfTeX{} anche la modalità di utilizzo; poi sceglie quale immagine -utilizzare tra \code{eps} e \code{png} per i pittogrammi. In ogni caso il tipo di -immagine può essere selezionato a piacimento attraverso l'opzione -\begin{beschreibung} - \Option{pic-type}{eps|pdf|jpg|png} -\end{beschreibung} -\secidx*{Pittogrammi} - -\section{Lingue disponibili}\label{sec:ghsystem_language} -Al momento attuale le frasi H e P sono disponibili solo in inglese, tedesco ed -italiano. Il pacchetto reagisce all'opzione \key[option]{italian} di \chemmacros, -ma non riconosce (ancora) la lingua impostata con \paket{babel} o \paket{polyglossia}. - -È possibile scegliere la lingua anche in modo esplicito. -\begin{beschreibung} - \Option{language}{english|german|italian} -\end{beschreibung} -\begin{beispiel} - \ghs{h}{201} - - \chemsetup[ghsystem]{language=english} - \ghs{h}{201} -\end{beispiel} - -È mia intenzione implementare ulteriori lingue in futuro; tuttavia potrebbe volerci -ancora del tempo. Chi volesse partecipare a \ghsystem e trascrivere le frasi in -un'altra lingua, è invitato a contattarmi% -\footnote{\href{mailto:contact@mychemistry.eu}{contact@mychemistry.eu}}; -gli metterò a disposizione un file template, un \acs{pdf} contenenti le traduzioni -officiali ed ogni ulteriore aiuto necessario. - -\section{Lista delle frasi}\secidx{Lista delle frasi} -Se si desidera elencare tutte le frasi, è possibile utilizzare il comando -\begin{beschreibung} - \Befehl{ghslistall}[<options>] -\end{beschreibung} - -Questo comando crea una tabella di tutte le frasi nell'ambiente \lstinline=longtable= -del pacchetto \paket{longtable}. Il suo aspetto può essere adattato con le opzioni -seguenti. -\begin{beschreibung} - \option{table-head-number}{<text>} Default = \code{Numero} - \option{table-head-text}{<text>} Default = \code{Frase} - \option{table-next-page}{<text>} Default = \code{Continua nella prossima pagina} - \option{table-caption}{<text>} Didascalia della tabella. Default = \code{Elenco - di tutte le frasi H, EUH e P.} - \option{table-caption-short}{<text>} \code{<short>} in \lstinline=\caption[<short>]{<text>}=. - \option{table-label}{<text>} L'etichetta per l'uso di riferimenti incrociati con - i comandi del tipo di \lstinline=\ref=. Default = \code{tab:ghs-hp-statements} - \option{table-row-sep}{<dim>} Distanza tra le righe. Una dimensione di \TeX. - Default = \code{3pt} - \option{table-rules}{\default{default}|booktabs|none} Lo stile delle righe - orizzontali della tabella. \code{default} utilizza \lstinline=\hline=, \code{booktabs} - utilizza \lstinline=\toprule=, \lstinline=\midrule= e \lstinline=\bottomrule=. - Questa opzione richiede che sia caricato il pacchetto \paket{booktabs}. Default - = \code{default} - \option{table-top-head-rule}{\default{default}|booktabs|none} Varia la riga in - modo esplicito. Default = \code{default} - \option{table-head-rule}{\default{default}|booktabs|none} Varia la riga in modo - esplicito. Default = \code{default} - \option{table-foot-rule}{\default{default}|booktabs|none} Varia la riga in modo - esplicito. Default = \code{default} - \option{table-last-foot-rule}{\default{default}|booktabs|none} Varia la riga in - modo esplicito. Default = \code{default} -\end{beschreibung} - -Il codice seguente mostra come è stata creata la tabella~\ref{tab:ghs-hp-statements}: -\begin{beispiel}[code only] - \ghslistall[fill-in,table-rules=booktabs] -\end{beispiel} - -\ghslistall[fill-in,table-rules=booktabs] -\secidx*{Lista delle frasi}\secidx*{GHSYSTEM} - -\appendix -\part{Appendice}\index{APPENDICE@\textbf{APPENDICE}} -\addsec{Panoramica delle opzioni e modalità di adattamento}\label{sec:overview}\secidx{Panoramica delle opzioni (chemmacros)}[Panoramica delle opzioni] -\minisec{Opzioni} -Nella tabella seguente sono elencate tutte le opzioni disponibili in \chemmacros. -Tutte le opzioni che appartengono ad un particolare modulo possono essere impostate -tramite -\begin{beschreibung} - \Befehl{chemsetup}[<module>]{<options>} oppure - \Befehl{chemsetup}{<module>/<options>} -\end{beschreibung} -Alcune opzioni possono essere richiamate senza assegnargli un valore; in tal caso -verrà utilizzato il valore \default{sottolineato}. Le opzioni dei moduli -\code{\textcolor{module}{chemformula}} e \code{\textcolor{module}{ghssystem}} non -sono elencate a parte. -\small -\begin{longtable}{>{\ttfamily\color{key}\hspace{5mm}}l>{\ttfamily\color{module}}l>{\ttfamily}l>{\ttfamily}ll} - \toprule - \normalfont\normalcolor\bfseries opzione & - \normalfont\normalcolor\bfseries modulo & - \normalfont\bfseries valori & - \normalfont\bfseries default & \\ - \midrule - \endhead - \bottomrule - \endfoot - \multicolumn{5}{l}{opzioni globali:} \\ - bpchem & option & \default{true}|false & false & pagina \pageref{key:option_bpchem} \\ - circled & option & \default{formal}|all|none & formal & pagina \pageref{key:option_circled} \\ - circletype & option & chem|math & chem & pagina \pageref{key:option_circletype} \\ - cmversion & option & 1|2|bundle & bundle & pagina \pageref{key:option_cmversion} \\ - ghsystem & option & \default{true}|false & true & pagina \pageref{key:option_ghsystem} \\ - iupac & option & auto|restricted|strict & auto & pagina \pageref{key:option_iupac} \\ - language & option & <language> & english & pagina \pageref{key:option_language} \\ - method & option & chemformula|mhchem & chemformula & pagina \pageref{key:option_method} \\ - Nu & option & chemmacros|mathspec & chemmacros & pagina \pageref{key:option_Nu} \\ - strict & option & \default{true}|false & false & pagina \pageref{key:option_strict} \\ - synchronize & option & \default{true}|false & false & pagina \pageref{key:option_synchronize} \\ - greek & option & math|textgreek|\default{upgreek} & upgreek & pagina \pageref{key:option_greek} \\ - xspace & option & \default{true}|false & true & pagina \pageref{key:option_xspace} \\ - \multicolumn{5}{l}{\cmd{ba}, \cmd{Nu}:} \\ - elpair & particle & \default{dots}|dash|false & false & pagina \pageref{key:particle_elpair} \\ - \multicolumn{5}{l}{comandi IUPAC:} \\ - break-space & iupac & <dim> & .01em & pagina \pageref{key:iupac_break-space} \\ - bridge-number & iupac & sub|super & sub & pagina \pageref{key:iupac_bridge-number} \\ - cip-kern & iupac & <dim> & .075em & pagina \pageref{key:iupac_cip-kern} \\ - coord-use-hyphen & iupac & \default{true}|false & true & pagina \pageref{key:iupac_coord-use-hyphen} \\ - hyphen-pre-space & iupac & <dim> & .01em & pagina \pageref{key:iupac_hyphen-pre-space} \\ - hyphen-post-space & iupac & <dim> & -.03em & pagina \pageref{key:iupac_hyphen-post-space} \\ - \multicolumn{5}{l}{\cmd{DeclareChemLatin}:} \\ - format & latin & <anything> & \lstinline=\itshape= & pagina \pageref{key:latin_format} \\ - \multicolumn{5}{l}{\cmd{pch}, \cmd{mch}, \cmd{fpch}, \cmd{fmch}:} \\ - append & charges & \default{true}|false & false & pagina \pageref{key:charges_append} \\ - \multicolumn{5}{l}{acido/base:} \\ - p-style & acid-base & slanted|italics|upright & upright & pagina \pageref{key:acid-base_p-style} \\ - \multicolumn{5}{l}{\cmd{ox}:} \\ - align & ox & center|right & center & pagina~\pageref{key:ox_align} \\ - parse & ox & \default{true}|false & true & pagina \pageref{key:ox_parse} \\ - roman & ox & \default{true}|false & true & pagina \pageref{key:ox_roman} \\ - pos & ox & top|super|side & top & pagina \pageref{key:ox_pos} \\ - explicit-sign & ox & \default{true}|false & false & pagina \pageref{key:ox_explicit-sign} \\ - decimal-marker & ox & comma|point & point & pagina \pageref{key:ox_decimal-marker} \\ - align & ox & center|right & center & pagina \pageref{key:ox_align}\\ - \multicolumn{5}{l}{\cmd{OX}, \cmd{redox}:} \\ - dist & redox & <dim> & .6em & pagina \pageref{key:redox_dist} \\ - sep & redox & <dim> & .2em & pagina \pageref{key:redox_sep} \\ - \multicolumn{5}{l}{\cmd{Enthalpy}, \cmd{Entropy}, \cmd{Gibbs}:} \\ - exponent & & <anything> & \cmd{standardstate} & pagina \pageref{key:none_exponent} \\ - delta & & <anything>|false & & pagina \pageref{key:none_delta} \\ - subscript & & left|right & & pagina \pageref{key:none_subscript} \\ - unit & & <unit> & & pagina \pageref{key:none_unit} \\ - \multicolumn{5}{l}{\cmd{DeclareChemState}, \cmd{RenewChemState}:} \\ - exponent & & <anything> & \cmd{standardstate} & pagina \pageref{key:none_exponent} \\ - delta & & <anything>|false & & pagina \pageref{key:none_delta} \\ - subscript & & <anything> & & pagina \pageref{key:none_subscript} \\ - subscript-left & & \default{true}|false & & pagina \pageref{key:none_subscript-left} \\ - \multicolumn{5}{l}{\cmd{State}:} \\ - exponent & state & <anything> & \cmd{standardstate} & pagina \pageref{key:state_exponent} \\ - delta & state & <anything>|false & & pagina \pageref{key:state_delta} \\ - subscript-left & state & \default{true}|false & & pagina \pageref{key:state_subscript-left} \\ - \multicolumn{5}{l}{\cmd{NMR}, \env{spectroscopy}{}:} \\ - unit & nmr & <unit> & \cmd{mega}\cmd{hertz} & pagina \pageref{key:nmr_unit} \\ - nucleus & nmr & \{<num>,<atom symbol>\} & \{1,H\} & pagina \pageref{key:nmr_nucleus} \\ - format & nmr & <anything> & & pagina \pageref{key:nmr_format} \\ - pos-number & nmr & side|sub & side & pagina \pageref{key:nmr_pos-number} \\ - coupling-unit & nmr & <unit> & \lstinline+\hertz+ & pagina \pageref{key:nmr_coupling-unit} \\ - parse & nmr & \default{true}|false & true & pagina \pageref{key:nmr_parse} \\ - delta & nmr & <anything> & & pagina \pageref{key:nmr_delta} \\ - list & nmr & \default{true}|false & false & pagina \pageref{key:nmr_list} \\ - list-setup & nmr & & (vedi il testo) & pagina \pageref{key:nmr_list-setup} \\ - use-equal & nmr & \default{true}|false & false & pagina \pageref{key:nmr_use-equal} \\ - \multicolumn{5}{l}{\cmd{DeclareChemReaction}:} \\ - star & & \default{true}|false & false & pagina \pageref{key:none_star} \\ - arg & & \default{true}|false & false & pagina \pageref{key:none_arg} \\ - list-name & reaction & <anything> & Elenco delle reazioni & pagina \pageref{key:reaction_list-name} \\ - list-entry & reaction & <anything> & Reazione & pagina \pageref{key:reaction_list-entry} \\ - \multicolumn{5}{l}{\cmd{mhName}:} \\ - align & mhName & <alignment> & \cmd{centering} & pagina \pageref{key:mhName_align} \\ - format & mhName & <commands> & & pagina \pageref{key:mhName_format} \\ - fontsize & mhName & <fontsize> & \cmd{tiny} & pagina \pageref{key:mhName_fontsize} \\ - width & mhName & <dim> & auto & pagina \pageref{key:mhName_width} \\ - \multicolumn{5}{l}{fasi:} \\ - pos & phases & side|sub & side & pagina \pageref{key:phases_pos} \\ - space & phases & <dim> & .1333em & pagina \pageref{key:phases_space} \\ - \multicolumn{5}{l}{\cmd{newman}:} \\ - angle & newman & <angle> & 0 & pagina \pageref{key:newman_angle} \\ - scale & newman & <factor> & 1 & pagina \pageref{key:newman_scale} \\ - ring & newman & <tikz> & & pagina \pageref{key:newman_ring} \\ - atoms & newman & <tikz> & & pagina \pageref{key:newman_atoms} \\ - back-atoms & newman & <tikz> & & pagina \pageref{key:newman_back-atoms} \\ - \multicolumn{5}{l}{\cmd{orbital} \ttfamily <type> = s|p|sp|sp2|sp3:} \\ - phase & orbital/<type> & +|- & + & pagina \pageref{key:orbital_phase} \\ - scale & orbital/<type> & <factor> & 1 & pagina \pageref{key:orbital_scale} \\ - color & orbital/<type> & <color> & black & pagina \pageref{key:orbital_color} \\ - angle & orbital/<type> & <angle> & 90 & pagina \pageref{key:orbital_angle} \\ - half & orbital/p & \default{true}|false & false & pagina \pageref{key:orbital_half} \\ - overlay & orbital & \default{true}|false & false & pagina \pageref{key:orbital_overlay} \\ - opacity & orbital & <num> & 1 & pagina \pageref{key:orbital_opacity} -\end{longtable} -\normalsize - -\minisec{Comandi di personalizzazione} -È stata presentata una serie di comandi che mostrano le possibilità di adattare -\chemmacros. Vengono elencati nuovamente qui sotto. -\begin{beschreibung} - \befehl{DeclareChemArrow} Definisce una nuova freccia; vedi a - pagina~\pageref{cmd:DeclareChemArrow}. - \befehl{RenewChemArrow} Modifica una freccia già esistente. - \befehl{DeclareChemBond} Definisce un nuovo legame; vedi a - pagina~\pageref{cmd:DeclareChemBond}. - \befehl{RenewChemBond} Ridefinisce un legame. - \befehl{DeclareChemBondAlias} Definisce un alias per un legame esistente. - \befehl{DeclareChemIUPAC} Definisce un nuovo comando IUPAC; vedi a - pagina~\pageref{cmd:DeclareChemIUPAC}. - \befehl{RenewChemIUPAC} Ridefinisce un comando IUPAC. - \befehl{DeclareChemLatin} Definisce un nuovo termine latino; vedi a - pagina~\pageref{cmd:DeclareChemLatin}. - \befehl{RenewChemLatin} Ridefinisce un termine latino. - \befehl{DeclareChemNMR} Definisce un nuovo comando NMR; vedi a - pagina~\pageref{cmd:DeclareChemNMR}. - \befehl{RenewChemNMR} Ridefinisce un comando NMR. - \befehl{DeclareChemParticle} Definisce una nuova particella; vedi a - pagina~\pageref{cmd:DeclareChemParticle}. - \befehl{RenewChemParticle} Ridefinisce una particella. - \befehl{DeclareChemPhase} Definisce un nuovo comando di fase; vedi a - pagina~\pageref{cmd:DeclareChemPhase}. - \befehl{RenewChemPhase} Ridefinisce un comando di fase. - \befehl{DeclareChemReaction} Definisce un nuovo ambiente di reazione; vedi a - pagina~\pageref{cmd:DeclareChemReaction}. - \befehl{DeclareChemState} Definisce una nuova grandezza di stato; vedi a - pagina~\pageref{cmd:DeclareChemState}. - \befehl{RenewChemState} Ridefinisce una grandezza di stato. -\end{beschreibung} -\secidx*{Panoramica delle opzioni (chemmacros)}[Panoramica delle opzioni] - -\addsec{Suggerimenti e avvisi di bug} -Ogni feedback riguardante \chemmacros, \chemformula e \ghsystem è il benvenuto! -Se avete proposte, se mancano delle funzionalità oppure vengono notati dei bug, -non esitate a contattarmi. Se trovate degli errori, siano essi di natura chimica, -di documentazione sbagliata ecc.\ sarei grato di una breve e-mail% -\footnote{\href{mailto:contact@mychemistry.eu}{contact@mychemistry.eu}}. - -Se trovate un bug, sarebbe il meglio mandarmi un esempio minimale con cui sia possibile -riprodurre il bug. È anche possibile segnalaro come \enquote{Issue} su -\url{https://bitbucket.org/cgnieder/chemmacros/}. - -Ringrazio tanto anche tutti coloro da cui ho già avuto segnalazioni, in particolare -(in ordine alfabetico): -\begin{itemize} - \item Peter Cao - \item Christina Lüdigk - \item Dr.\ Paul King - \item Jonas Rivetti (traduzione delle frasi H e P in italiano; molte grazie anche - per la traduzione del manuale!) - \item Christoph Schäfer - \item Timo Stein -\end{itemize} - -\printbibliography - -{\catcode`\^=11 \catcode`\#=11 \catcode`\|=11 -\printindex} - -\end{document}
\ No newline at end of file |