summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/chemfig
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/chemfig')
-rw-r--r--Master/texmf-dist/doc/generic/chemfig/README4
-rw-r--r--Master/texmf-dist/doc/generic/chemfig/chemfig-en.pdfbin1087797 -> 1092263 bytes
-rw-r--r--Master/texmf-dist/doc/generic/chemfig/chemfig-en.tex32
-rw-r--r--Master/texmf-dist/doc/generic/chemfig/chemfig-fr.pdfbin1116449 -> 1120059 bytes
-rw-r--r--Master/texmf-dist/doc/generic/chemfig/chemfig-fr.tex32
5 files changed, 56 insertions, 12 deletions
diff --git a/Master/texmf-dist/doc/generic/chemfig/README b/Master/texmf-dist/doc/generic/chemfig/README
index cad2e431746..de87a14c9b5 100644
--- a/Master/texmf-dist/doc/generic/chemfig/README
+++ b/Master/texmf-dist/doc/generic/chemfig/README
@@ -2,9 +2,9 @@ ___________________________________
The
Chemfig package
- v1.55
+ v1.56
- 2020/06/15
+ 2020/07/13
___________________________________
Maintainer: Christian Tellechea
diff --git a/Master/texmf-dist/doc/generic/chemfig/chemfig-en.pdf b/Master/texmf-dist/doc/generic/chemfig/chemfig-en.pdf
index 5ec811ed99e..990c8454ba6 100644
--- a/Master/texmf-dist/doc/generic/chemfig/chemfig-en.pdf
+++ b/Master/texmf-dist/doc/generic/chemfig/chemfig-en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/chemfig/chemfig-en.tex b/Master/texmf-dist/doc/generic/chemfig/chemfig-en.tex
index d7e5474480c..281530c1cdb 100644
--- a/Master/texmf-dist/doc/generic/chemfig/chemfig-en.tex
+++ b/Master/texmf-dist/doc/generic/chemfig/chemfig-en.tex
@@ -247,6 +247,9 @@ Together with the use of the macro \verb|\charge|, this new feature makes it pos
\exemple{Consecutive bonds}/\chemfig{[:30]-\charge{90=\:}{}
-[:-30]\charge{-90=\"}{}-\charge{90:2pt=$\delta^+$}{}-[:-30]}/
+\subsection{Center of rings}
+The center of each ring is reachable with a \TIKZ node. See page~\pageref{centre_cycle}.
+
\subsection{Manual Update}
More detailed explanations are given on:
\begin{itemize}
@@ -313,16 +316,18 @@ Here is the complete list of parameters as well as their default values\label{li
\CFparam{lewis sep}
\CFparam{lewis length}
\CFparam{lewis style}
- \CFparam{lewis dist}\hline
+ \CFparam{lewis dist}
+ \CFparam{lewis radius}
+ \CFparam{lewis diag coeff}
+ \CFparam{cycle radius coeff}
+ \CFparam{stack sep}
+ \CFparam{show cntcycle}
+ \CFparam{autoreset cntcycle}\hline
\end{longtable}
\end{minipage}\hfill
\begin{minipage}[t]{.45\linewidth}
\begin{longtable}{rl}\hline
\chevrons{keys} & default \chevrons{values}\\\hline\endhead
- \CFparam{lewis radius}
- \CFparam{lewis diag coeff}
- \CFparam{cycle radius coeff}
- \CFparam{stack sep}
\CFparam{scheme debug}
\CFparam{compound style}
\CFparam{compound sep}
@@ -799,6 +804,21 @@ Some care must be taken with rings when one or more vertices are made up of grou
In order for the ring to have a regular shape, it is necessary to override the \CF mechanism which automatically calculates the departure and arrival atoms of bonds. Here, \verb/C-F/ and \verb/F-G/ must be connected by using the optional argument of these bonds:
\exemple{Forced departure and arrival atoms}|\chemfig{AB*5(-CDE-[,,1]F-[,,,1]GH-I-)}|
+\subsection{Center of rings}\label{centre_cycle}
+Each ring has at its center a node of zero dimension whose name is \Verb|centrecycle<n>| where \Verb|<n>| is the number of the ring, (the rings are numbered in the order in which they are drawn). It is possible to display the number of each ring by setting the boolean \CFkey{show cntcycle} to true.
+
+The default true boolean \CFkey{autoreset cntcycle} resets the ring counter at the beginning of each molecule to 0 (i.e., each time \verb|\chemfig| is executed).
+
+\exemple{Centre of rings}/\chemfig{*5(---(-*3(---))--)}
+\chemmove{\draw[red](cyclecenter1)to[out=20,in=-45](cyclecenter2);}
+\qquad
+\chemfig{*6(-=-=-=)}
+\chemmove{%
+ \node[at=(cyclecenter1)](){.+}
+ node [at=(cyclecenter1),shift=(120:1.75cm)](end){\printatom{R^1}};
+ \draw[-,shorten <=.5cm](cyclecenter1)--(end);
+}/
+
\section{Representing electron movements}\label{mecanismes-reactionnels}
Starting with \CF version 0.3, we can represent the movement of electrons in mesomeric effects or reaction mechanisms. This is done by marking the departure and arrival points of the electron movement arrow using the syntax ``\Verb-@{<argument>}-''. This syntax allows a \TIKZ node to be placed and makes this node accessible outside the argument of the \verb-\chemfig- command thanks to the ``\texttt{remember picture}'' option which is passed to all the ``\falseverb{tikzpicture}'' environments. It is assumed that the viewer supports ``\falseverb{picture remembering}'' and that the compilation is done twice.
@@ -2457,6 +2477,8 @@ The commands created by \CF are:
\item \CFkv{lewis diag coeff} {1}: factor that multiplies the distance to Lewis formulas in odd directions
\item \CFkv{cycle radius coeff} {0.75}: shrinkage ratio of the circle or arc inside cycles
\item \CFkv{stack sep} {1.5pt}: vertical gap between arguments of \verb-\chemabove- and \verb-\chembelow- macros
+ \item \CFkv{show cntcycle} {false}: show rings numbers
+ \item \CFkv{autoreset cntcycle} {true}: reset ring counter at \verb|\chemfig| execution
\item \CFkv{compound style} {{}}: style of compounds
\item \CFkv{compound sep} {5em}: space between compounds
\item \CFkv{arrow offset} {4pt}: space between compound and arrow
diff --git a/Master/texmf-dist/doc/generic/chemfig/chemfig-fr.pdf b/Master/texmf-dist/doc/generic/chemfig/chemfig-fr.pdf
index f773cb1b4b2..1777f6d5b99 100644
--- a/Master/texmf-dist/doc/generic/chemfig/chemfig-fr.pdf
+++ b/Master/texmf-dist/doc/generic/chemfig/chemfig-fr.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/chemfig/chemfig-fr.tex b/Master/texmf-dist/doc/generic/chemfig/chemfig-fr.tex
index de76a743a36..d52bb1259e5 100644
--- a/Master/texmf-dist/doc/generic/chemfig/chemfig-fr.tex
+++ b/Master/texmf-dist/doc/generic/chemfig/chemfig-fr.tex
@@ -247,6 +247,9 @@ Conjointement à l'utilisation de la macro \verb|\charge|, cette nouvelle foncti
\exemple{Liaisons jointives}/\chemfig{[:30]-\charge{90=\:}{}
-[:-30]\charge{-90=\"}{}-\charge{90:2pt=$\delta^+$}{}-[:-30]}/
+\subsection{Centre des cycles}
+Le centre de chaque cycle est désormais accessible via un nœud de \TIKZ. Voir page~\pageref{centre_cycle}.
+
\subsection{Mise à jour du manuel}
Des explications plus détaillées sont données sur:
\begin{itemize}
@@ -313,16 +316,18 @@ Voici la liste exhaustive des paramètres ainsi que leurs valeurs par défaut\la
\CFparam{lewis sep}
\CFparam{lewis length}
\CFparam{lewis style}
- \CFparam{lewis dist}\hline
+ \CFparam{lewis dist}
+ \CFparam{lewis radius}
+ \CFparam{lewis diag coeff}
+ \CFparam{cycle radius coeff}
+ \CFparam{stack sep}
+ \CFparam{show cntcycle}
+ \CFparam{autoreset cntcycle}\hline
\end{longtable}
\end{minipage}\hfill
\begin{minipage}[t]{.45\linewidth}
\begin{longtable}{rl}\hline
\chevrons{clés} & \chevrons{valeurs} par défaut\\\hline\endhead
- \CFparam{lewis radius}
- \CFparam{lewis diag coeff}
- \CFparam{cycle radius coeff}
- \CFparam{stack sep}
\CFparam{scheme debug}
\CFparam{compound style}
\CFparam{compound sep}
@@ -799,6 +804,21 @@ Il faut prendre des précautions avec les cycles lorsque un ou plusieurs sommets
Pour que le cycle ait une forme régulière, il faut passer outre le mécanisme de \CF qui calcule automatiquement les atomes de départ et d'arrivée des liaisons. Ici, il faut relier \verb/C-F/ et \verb/F-G/ en le spécifiant avec l'argument optionnel de ces liaisons :
\exemple{Atomes de départ et d'arrivée imposés}|\chemfig{AB*5(-CDE-[,,1]F-[,,,1]GH-I-)}|
+\subsection{Centre du cycle}\label{centre_cycle}
+Chaque cycle porte en son centre un nœud de dimension nulle dont le nom est \Verb|centrecycle<n>| où \Verb|<n>| est le numéro du cycle, entendu que les cycles sont numérotés dans l'ordre où ils sont tracés. Il est possible d'afficher le numéro de chaque cycle en mettant à vrai la \chevrons{clé} booléenne \CFkey{show cntcycle}.
+
+La \chevrons{clé} booléenne \CFkey{autoreset cntcycle}, vraie par défaut, remet à 0 le compteur de cycle au début de chaque molécule tracée (c'est-à-dire à chaque appel de \verb|\chemfig|).
+
+\exemple{Centre de cycle}/\chemfig{*5(---(-*3(---))--)}
+\chemmove{\draw[red](cyclecenter1)to[out=20,in=-45](cyclecenter2);}
+\qquad
+\chemfig{*6(-=-=-=)}
+\chemmove{%
+ \node[at=(cyclecenter1)](){.+}
+ node [at=(cyclecenter1),shift=(120:1.75cm)](end){\printatom{R^1}};
+ \draw[-,shorten <=.5cm](cyclecenter1)--(end);
+}/
+
\section{Représentation des déplacements d'électrons}\label{mecanismes-reactionnels}
Depuis la version 0.3 de \CF, on peut représenter les déplacements d'électrons des effets mésomères ou des mécanismes réactionnels. Cela est rendu possible en marquant le point de départ et le point d'arrivée de la flèche que l'on utilise pour indiquer la migration des électrons à l'aide de la syntaxe «\Verb-@{<argument>}-». Cette syntaxe permet de poser un nœud (au sens de \TIKZ) en rendant ce nœud accessible en dehors de l'argument de la commande \verb-\chemfig- grâce à l'option «\texttt{remember picture}» qui est passée à tous les environnements «\falseverb{tikzpicture}». Cela suppose que le visualiseur prenne en charge le «\falseverb{picture remembering}» et que la compilation soit lancée deux fois.
@@ -2457,6 +2477,8 @@ Les commandes créées par \CF sont :
\item \CFkv{lewis diag coeff} {1}: coefficient multiplicatif de la distance dans les directions impaires
\item \CFkv{cycle radius coeff} {0.75}: coefficient du cercle ou de l'arc de cercle tracé dans les cycles
\item \CFkv{stack sep} {1.5pt}: espacement vertical pour les arguments des macros \verb-\chemabove- et \verb-\chembelow-
+ \item \CFkv{show cntcycle} {false}: affichage des numéros des cycles
+ \item \CFkv{autoreset cntcycle} {true}: remise à 0 du compteur de cycles à chaque exécution de \verb|\chemfig|
\item \CFkv{compound style} {{}}: style des composés
\item \CFkv{compound sep} {5em}: espacement entre 2 composés
\item \CFkv{arrow offset} {4pt}: espacement entre un composé et la flèche