summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/chemfig/chemfig-fr.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/chemfig/chemfig-fr.tex')
-rw-r--r--Master/texmf-dist/doc/generic/chemfig/chemfig-fr.tex87
1 files changed, 52 insertions, 35 deletions
diff --git a/Master/texmf-dist/doc/generic/chemfig/chemfig-fr.tex b/Master/texmf-dist/doc/generic/chemfig/chemfig-fr.tex
index 280abf8fe3f..8a73e46b814 100644
--- a/Master/texmf-dist/doc/generic/chemfig/chemfig-fr.tex
+++ b/Master/texmf-dist/doc/generic/chemfig/chemfig-fr.tex
@@ -143,6 +143,7 @@
\newcommand*\CFval[1]{{\color{teal}\textlangle\textit{#1}\textrangle}}
\newcommand*\CFkv[2]{\CFkey{#1}{\color{teal}${}={}$}\CFval{#2}}
\newcommand*\CFparam[1]{\CFkey{#1}&\ifcat\relax\detokenize\expandafter\expandafter\expandafter{\useKV[chemfig]{#1}}\relax \textlangle\textit{vide}\textrangle\else\texttt{\detokenize\expandafter\expandafter\expandafter{\useKV[chemfig]{#1}}}\fi\\}
+\newcommand*\CFdelimparam[1]{\CFkey{#1}&\ifcat\relax\detokenize\expandafter\expandafter\expandafter{\useKV[CFdelimiters]{#1}}\relax \textlangle\textit{vide}\textrangle\else\texttt{\detokenize\expandafter\expandafter\expandafter{\useKV[CFdelimiters]{#1}}}\fi}
\usepackage[plainpages=false,pdfpagelabels,bookmarks=true,bookmarksopen=true,colorlinks=true,hyperfootnotes=false,filecolor=black,linkcolor=blue,urlcolor=magenta,pdfauthor={Christian TELLECHEA},pdftitle={ChemFig},pdfsubject={Dessiner des molécules 2D avec LaTeX},pdfkeywords={ChemFig},pdfcreator={LaTeX}]{hyperref}
@@ -213,8 +214,15 @@
\setitemize{leftmargin=3em,topsep=0pt,parsep=0pt,itemsep=0pt,label=--}
\part{Introduction}
\section{Nouveau dans la v1.3}
-\subsection{Système de clés et valeurs}
-Compte tenu du grand nombre de paramètres et du nombre de macros qui servent à les spécifier, une uniformisation est devenue nécessaire, autant pour simplifier l'utilisation de \CF que pour faciliter la création de nouveaux paramètres.
+\subsection{Nouveau dans la v1.33}
+\paragraph{Arguments pour les sous-molécules}
+À partir de la version 1.33, les sous-molécules définies avec \verb|\definesubmol| peuvent avoir des arguments, voir page~\pageref{definesubmolarg}.
+
+\paragraph{Délimiteur de polymère}
+La macro \verb|\polymerdelim| permet de tracer des délimiteurs sur des molécules tracées par \CF, voir page~\pageref{polymerdelim}.
+
+\subsection{Nouveau dans la v1.3}
+\paragraph{Système de clés et valeur}Compte tenu du grand nombre de paramètres et du nombre de macros qui servent à les spécifier, une uniformisation est devenue nécessaire, autant pour simplifier l'utilisation de \CF que pour faciliter la création de nouveaux paramètres.
La plupart des \chevrons{paramètres} sont désormais spécifiés \emph{via} la macro \verb|\setchemfig| dont l'argument est une liste de \chevrons{clé}$=$\chevrons{valeur} séparées par des virgules. Bien qu'étant pour l'instant encore utilisables, toutes les macros qui spécifiaient un ou plusieurs paramètres sont désormais obsolètes.
\begin{center}
@@ -228,7 +236,7 @@ La plupart des \chevrons{paramètres} sont désormais spécifiés \emph{via} la
Les exécuter envoie un message d'avertissement sur leur obsolescence dans le fichier log.
-\subsection{La syntaxe de la macro \texttt{\textbackslash chemfig}}
+\paragraph{La syntaxe de la macro \texttt{\textbackslash chemfig}}
\begin{center}
\color{red}
La version étoilée de la macro \verb-\chemfig- est désormais obsolète et ne sera plus supportée dans une future version.
@@ -243,7 +251,7 @@ Le but est qu'à terme, la macro \verb-\chemfig- n'accepte qu'\emph{un seul} arg
Les deux arguments optionnels que prend la macro \verb-\chemfig- seront supprimés dans une prochaine version
\end{center}
-\subsection{Les clés et leur valeur par défaut}
+\paragraph{Les clés et leur valeur par défaut}
Les paramètres de chemfig, identifiés par leur \chevrons{clé} et leur \chevrons{valeur} par défaut sont :
\begin{center}
\begin{longtable}{rl}\hline
@@ -1132,7 +1140,7 @@ Mais dans certains cas, cette fonctionnalité fait gagner beaucoup de place dans
\exemple{Butane}|\definesubmol\xx{C(-[::+90]H)(-[::-90]H)}
\chemfig{[:15]H-!\xx-!\xx-!\xx-!\xx-H}|
-La commande \falseverb{\definesubmol} admet un argument optionnel et sa syntaxe complète est la suivante :
+La commande \falseverb{\definesubmol} admet un argument optionnel et sa syntaxe est la suivante :
\centerverb/\definesubmol{<nom>}[<code1>]{<code2>}/
\medskip
@@ -1142,6 +1150,18 @@ On va définir une séquence de contrôle \verb-\Me- pour «méthyl» de telle s
\exemple{Alias dual}/\definesubmol\Me[H_3C]{CH_3}
\chemfig{*6((-!\Me)=(-!\Me)-(-!\Me)=(-!\Me)-(-!\Me)=(-!\Me)-)}/
+\label{definesubmolarg}La sous-molécule sauvegardée via un \verb|<nom>| n'admet pas d'argument lorsqu'elle est appelée après «\verb|!|». Pour définir une sous-molécule admettant un ou plusieurs argument, il faut écrire ce \verb|<nombre>| d'arguments juste après le \verb|<nom>|. La syntaxe complète de \verb|\definesubmol| est donc:
+
+\centerverb/\definesubmol<nombre>{<nom>}[<code1>]{<code2>}/
+
+Dans les \verb|<codes>|, les arguments doivent figurer sous leur forme habituelle «\verb|#<n>|» où \verb|<n>| est le numéro de l'argument.
+
+\exemple{\texttt{\string\definesubmol} avec arguments}/\definesubmol\X1{-[,-0.3,,,draw=none]\footnotesize#1}
+\chemfig{*6((!\X A)-(!\X B)-(!\X C)-(!\X D)-(!\X E)-(!\X F)-)}
+
+\definesubmol{foo}3[#3|\textcolor{#1}{#2}]{\textcolor{#1}{#2}|#3}
+\chemfig{A(-[:135]!{foo}{red}XY)-B(-[:45]!{foo}{green}{W}{zoo})}/
+
\section{Décorations}
\subsection{Formule de Lewis}\label{lewis}
La macro \falseverb{\lewis} permet de placer des paires d'électrons, des électrons ou une lacune. On utilise cette syntaxe :
@@ -1472,56 +1492,53 @@ Pour plus de souplesse, on peut aussi poser des nœuds avec le marqueur «\verb-
\chemmove{\draw[-](a)..controls +(60:3em) and +(30:1em)..
++(20:2em) ..controls +(210:3em) and +(-120:4em) ..(b);}/
-\subsection{Dessiner un élément de polymère}
-La difficulté réside dans le fait d'afficher des délimiteurs (parenthèses ou crochets) sur des liaisons. Pour cela, on va encore définir avec le caractère «\verb-@-» des nœuds globaux que l'on utilisera ensuite pour qu'ils servent d'ancre aux délimiteurs.
-
-Nous allons écrire une macro toute simple \verb-\setpolymerbracket- dont les deux caractères qui suivent définissent le délimiteur ouvrant et le délimiteur fermant.
-
-Ensuite, la macro \verb-\makebraces- admettra un argument de la forme«\verb-[<dim up>,<dim down>]-». Ces deux dimensions seront la hauteur et la profondeur des délimiteurs par rapport à la ligne de base. Les arguments suivants seront l'indice placé après le délimiteur fermant puis les noms des 2 nœuds où doivent être placés les délimiteurs ouvrants et fermants.
-
-\exemple*{Polymères}|\newcommand\setpolymerdelim[2]{\def\delimleft{#1}\def\delimright{#2}}
-\def\makebraces[#1,#2]#3#4#5{%
- \edef\delimhalfdim{\the\dimexpr(#1+#2)/2}%
- \edef\delimvshift{\the\dimexpr(#1-#2)/2}%
- \chemmove{%
- \node[at=(#4),yshift=(\delimvshift)]
- {$\left\delimleft\vrule height\delimhalfdim depth\delimhalfdim
- width0pt\right.$};%
- \node[at=(#5),yshift=(\delimvshift)]
- {$\left.\vrule height\delimhalfdim depth\delimhalfdim
- width0pt\right\delimright_{\rlap{$\scriptstyle#3$}}$};}}
-\setpolymerdelim()
-Polyéthylène:
+\subsection{Dessiner un élément de polymère}\label{polymerdelim}
+La macro \verb|\polymerdelim|, jusqu'alors non documentée et en phase de test, fait avec la version 1.33 son entrée officielle dans le package \CF. Sa syntaxe est la suivante :
+
+\centerverb|\polymerdelim[<clés>=<valeurs>]{<nœud1>}<nœud2>}|
+
+L'effet, après éventuellement \emph{deux} compilations, est de positionner des délimiteurs verticaux aux nœuds spécifiés. Les paramètres sont spécifiés via les \chevrons{clés} et les \chevrons{valeurs} dont voici la liste, les valeurs par défaut et les actions.
+\begin{center}
+\begin{tabular}{rlp{8cm}}\hline
+ \chevrons{clés} & \chevrons{valeurs} par défaut & Action\\\hline
+ \CFdelimparam{delimiters} & Définit les délimiteurs. Si ces délimiteurs sont des crochets, il faut écrire \verb|delimiters={[]}|.\\
+ \CFdelimparam{height} & Définit la hauteur (au-dessus du nœud) des délimiteurs.\\
+ \CFdelimparam{depth} & Définit la profondeur (au-dessous du nœud) des délimiteurs. Si la \chevrons{valeur} est vide, alors la profondeur est égale à la hauteur.\\
+ \CFdelimparam{open xshift}& Définit le décalage horizontal du délimiteur ouvrant.\\
+ \CFdelimparam{close xshift}& Définit le décalage horizontal du délimiteur fermant. Si la \chevrons{valeur} est vide, alors ce décalage devient opposé au décalage du délimiteur ouvrant.\\
+ \CFdelimparam{indice} & Définit l'indice qui sera placé en bas à droite du délimiteur fermant.\\\hline
+\end{tabular}
+\end{center}
+\exemple*{Polymères}|Polyéthylène:
\chemfig{\vphantom{CH_2}-[@{op,.75}]CH_2-CH_2-[@{cl,0.25}]}
-\makebraces[5pt,5pt]{\!\!n}{op}{cl}
+\polymerdelim[height = 5pt, indice = \!\!n]{op}{cl}
\bigskip
Polyvinyl chloride:
-\chemfig{\vphantom{CH_2}-[@{op,.75}]CH_2-CH(-[6]Cl)-[@{cl,0.25}]}
-\makebraces[5pt,25pt]{\!\!\!n}{op}{cl}
+\chemfig{\vphantom{CH_2}-[@{op,1}]CH_2-CH(-[6]Cl)-[@{cl,0}]}
+\polymerdelim[height = 5pt, depth = 25pt, open xshift = -10pt, indice = \!\!n]{op}{cl}
\bigskip
Nylon 6:
\chemfig{\phantom{N}-[@{op,.75}]{N}(-[2]H)-C(=[2]O)-{(}CH_2{)_5}-[@{cl,0.25}]}
-\makebraces[30pt,5pt]{}{op}{cl}
+\polymerdelim[height = 30pt, depth = 5pt, indice = {}]{op}{cl}
\bigskip
-Polycaprolactame:\setchemfig{atom sep=2em}
+Polycaprolactame:\setchemfig{atom sep = 2em}
\chemfig{[:-30]-[@{left,.75}]N(-[6]H)-[:30](=[2]O)--[:30]--[:30]--[@{right,0.25}:30]}
-\makebraces[5pt,25pt]{\!\!\!n}{left}{right}
+\polymerdelim[height = 5pt, indice = \!\!n]{left}{right}
\bigskip
-\setpolymerdelim[]
Polyphénylène sulfide:
\chemfig{\vphantom{S}-[@{op,.75}]S-(**6(---(-[@{cl,0.25}])---))}
-\makebraces[15pt,15pt]{}{op}{cl}
+\polymerdelim[delimiters = (), height = 15pt, indice = {}]{op}{cl}
\bigskip
\chemfig{-CH_2-CH([6]-CO-NH-CH_2-NH-CO-CH([4]-CH_2-)([0]-[@{downleft,0.8},2]CH_2
-CH([2]-CO-NH_2)-[@{downright,0.3},2]CH_2-[,1.5]C?H-))-[@{upleft,0.8},2]CH_2
-CH([6]-CO-NH_2)-[@{upright,0.3},2]CH_2-[,1.5]CH([6]-CO-NH-CH_2-NH-C?O)-}
-\makebraces[5pt,40pt]{n}{upleft}{upright}
-\makebraces[38pt,7pt]{n}{downleft}{downright}|
+\polymerdelim[delimiters ={[]}, height = 5pt, depth = 40pt, indice = n]{upleft}{upright}
+\polymerdelim[delimiters ={[]}, height = 40pt, depth = 5pt, indice = n]{downleft}{downright}|
\subsection{Dessiner le symétrique d'une molécule}\label{retournement}
Il existe deux commandes \falseverb{\hflipnext} et \falseverb{\vflipnext} qui permettent de tracer le symétrique de la prochaine molécule par rapport à un axe horizontal ou vertical. Si on souhaite construire le symétrique de plusieurs molécules, il faut écrire les commandes avant chaque molécule concernée.