<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
% % %                                                                                                   % % %
\section{Extension theatre.sty - Aide en FranÃ§ais}%                                                     % % %
% % %                                                                                                   % % %
% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
%
\subsection{Objet}%
Le but de cette extension est de pouvoir insÃ©rer des dialogues dans un texte en personnalisant les impressions par acteur.

Pour ce faire, il faut prÃ©alablement crÃ©er les rÃ´les et les sauver dans un fichier sÃ©parÃ©. Pour chaque rÃ´le, on dÃ©finit son nom, la couleur d'impression et deux tailles de caractÃ¨re (en vision claire ou proche et en vision sombre ou Ã©loignÃ©e) .

Ensuite, un environnement \og{}theatre\fg{} permet d'Ã©crire les rÃ©pliques. Elles seront numÃ©rotÃ©es automatiquement, ce qui facilite le suivi, vu que plusieurs mises en page peuvent Ãªtre gÃ©nÃ©rÃ©es selon les demandes des lecteurs.

\bigskip{}

\subsection{Les commandes}
Cette extension prÃ©voit qu'on puisse crÃ©er autant de rÃ´les que nÃ©cessaires, via la commande de crÃ©ation de rÃ´le.
De plus deux commandes sont prÃ©vues, une pour ajouter des commentaires, l'autre pour dÃ©crire des mouvements. Elles permettent Ã©galement de placer un commentaire avant le texte proprement-dit.

\subsubsection{PrÃ©parer les rÃ´les}
Dans un fichier sÃ©parÃ©, on crÃ©e le nombre nÃ©cessaire de rÃ´les.\\ La commande \chicom{TheatreCreerUnRole} est prÃ©vue Ã&nbsp; cet effet.

\medskip{}
Sa structure est la suivante :\\
\begin{chicitecommandelarge}
\TheatreCreerUnRole{nomcourt}{nomlong}{petit}{grand}{couleur}
\end{chicitecommandelarge}
\medskip{}
\begin{enumerate}
  \item \textbf{nomcourt} sera utilisÃ© pour crÃ©er le nom des macros des rÃ´les, un \emph{\textbf{r}} (pour rÃ©plique) puis deux lettres prÃ©cÃ©deront le nom court
    \begin{itemize}
      \item \textbf{pt} pour petite taille de texte -&gt; donc macro crÃ©Ã©e \chicom{rptnomcourt},
      \item \textbf{gd} pour grande taille de texte -&gt; donc macro crÃ©Ã©e \chicom{rgdnomcourt}.
    \end{itemize}
  \item \textbf{nomlong} sera imprimÃ© au-dessus des rÃ©pliques.   
  \item \textbf{petit} et \textbf{grand} dÃ©finissent la taille du texte pour chacune des deux macros crÃ©Ã©es. Ces tailles sont Ã&nbsp; choisir de prÃ©fÃ©rence parmi les grandes tailles (large, Large, LARGE, huge et HUGE) ou rester Ã&nbsp; la taille standard (normalsize). Mais rien n'empÃªche de choisir un taille plus petite que le standard (small, footnotesize, scriptsize ou tiny).
  \item \textbf{couleur} pour personnaliser un rÃ´le, Ã&nbsp; choisir parmi black, white, red, green, blue, cyan, magenta et yellow. Cependant, avec des packages plus spÃ©cialisÃ©s en couleur, on peut avoir un choix plus grand.
\end{enumerate}

\medskip{}

Deux variables dÃ©cident d'autres tailles. Elles peuvent Ãªtre redÃ©finies quand on veut (\chivar{def}\chivar{variable\dots}).
\begin{itemize}
\item \chivar{TheatreTailleRoleCpte} dÃ©cide de la taille du compteur qui s'imprime devant la rÃ©plique. Par dÃ©faut : small.
\item \chivar{TheatreTailleRoleNom} dÃ©cide de la taille du rÃ´le qui s'imprime au-dessus de la rÃ©plique. Par dÃ©faut : small.
\end{itemize}

\medskip{}

Deux longueurs peuvent Ãªtre redÃ©finies, en n'oubliant pas l'unitÃ© de longueur, par la commande \chicom[nom\}\{Nex]{setlength} (1ex, 2ex \dots)
\begin{itemize}
\item \chivar{TheatreEntreNomEtReplique}  augmente l'espace entre le nom et la rÃ©plique.%
\item \chivar{TheatreEcarterRepliques} augmente l'espace entre les rÃ©pliques.%
\end{itemize}
%-------------------------------------
\subsubsection{Utiliser les rÃ´les crÃ©Ã©s}
Les commandes de \og{}theatre\fg{} permettent d'Ã©crire un commentaire sur la ligne du nom du rÃ´le. Ce commentaire n'est pas obligatoire, il s'Ã©crira donc entre \og{}[\,]\fg{}, comme il se doit pour les variables optionnelles.

\bigskip{}

\begin{center}
\begin{minipage}[h]{0.9\textwidth}
\def\TheatreEcarterRepliques{3mm}
\begin{SideBySideExample}[gobble=0,fontfamily=lmss,fontseries=b,fontsize=\footnotesize,xrightmargin=0.5\textwidth,baselinestretch=2]
\CommandeEcrite
\begin{theatre}
\rptflore[\emph{commentaire}]{Quittez,\dots}
\rptclimdaph{Berger,\dots}
\rgdtirdor{Mais\dots}
\end{theatre}
\end{SideBySideExample}
\end{minipage}
\end{center}

\bigskip{}

Il suffit donc de se souvenir des noms donnÃ©s aux diffÃ©rents rÃ´les.

%---------------
\subsubsection{\chicom{TheatreMvt} : pour dÃ©crire les mouvements.}
\begin{itemize}
\item \chivar{TheatreMvtHt} dÃ©termine la hauteur du texte,
\item \chivar{TheatreMvtCouleur} dÃ©termine sa couleur.
\end{itemize}

\bigskip{}

\begin{center}
\begin{minipage}[h]{0.9\textwidth}
\begin{SideBySideExample}[gobble=0,fontfamily=lmss,fontseries=b,fontsize=\footnotesize,xrightmargin=0.5\textwidth,baselinestretch=2]
\CommandeEcrite

\TheatreMvt[commentaire]{Le texte\dots}

\TheatreMvt{Le texte\dots}
\end{SideBySideExample}
\end{minipage}
\end{center}

\bigskip{}

%----------------------------
\subsubsection{\chicom{TheatreComment} : pour placer des commentaires dans le texte}
\begin{itemize}
\item \chivar{TheatreCommentHt} dÃ©termine la hauteur du texte,
\item \chivar{TheatreCommentCouleur} dÃ©termine sa couleur.
\end{itemize}

\bigskip{}

\begin{center}
\begin{minipage}[h]{0.9\textwidth}
\begin{SideBySideExample}[gobble=0,fontfamily=lmss,fontseries=b,fontsize=\footnotesize,xrightmargin=0.5\textwidth,baselinestretch=2]
\CommandeEcrite

\TheatreComment[commentaire]{Le texte\dots}

\TheatreComment{Le texte\dots}
\end{SideBySideExample}
\end{minipage}
\end{center}
</pre></body></html>