diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/chemfig/chemfig-fr.tex')
-rw-r--r-- | Master/texmf-dist/doc/generic/chemfig/chemfig-fr.tex | 87 |
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. |