Mise à jour de la documentation

[mp-scratch.git] / doc / mp-scratch.tex

diff --git a/doc/mp-scratch.tex b/doc/mp-scratch.tex
index 66d4451..bba9203 100644 (file)
--- a/doc/mp-scratch.tex
+++ b/doc/mp-scratch.tex
@@ -51,6 +51,17 @@ Avec les nouveaux programmes 2016 du Cycle 4 (Classes de 5\ieme\ à 3\ieme\ de c
   \url{http://melusine.eu.org/syracuse/G/mp-scratch/}
 \end{center}
 et l'ensemble des fichiers sera à placer correctement dans une arborescence \TeX\footnote{Arborescence locale de préférence, par exemple dans {\sffamily /home/christophe/texmf/metapost/} sous Linux.}.
+\\Pour l'utilisation, il sera nécessaire de veiller :
+\begin{itemize}
+\item à installer, si ce n'est pas fait, la fonte {\sffamily Carlito}\footnote{\url{http://www.tug.dk/FontCatalogue/carlito/} pour un exemple. Le choix reste personnalisable évidemment mais Thierry Pasquier, à juste titre, m'a préconisé d'utiliser une fonte sans serif.};
+\item à modifier, dans le fichier {\sffamily LATEXScratch.mp}, la ligne
+\vspace{1em}
+\begin{center}
+  \lstinline!  write "\graphicspath{{/home/cp/texmf/metapost/Scratch/}}" to "mptextmp.mp";!
+\end{center}
+\vspace{1em}
+pour indiquer le chemin correspondant à votre installation.
+\end{itemize}
 \section{Utilisation}
 \begin{figure}[h]
   \centering
@@ -198,7 +209,7 @@ Les \og opérateurs\footnote{Je nomme \og opérateurs\fg\ les variables ou comma
     \par\vspace*{2em}\par Les \og opérateurs\fg\ 
 \[\includegraphics{CommandeApparence.17}\kern0.1\linewidth\includegraphics{CommandeApparence.18}\kern0.1\linewidth\includegraphics{CommandeApparence.19}\]
 s'obtiennent avec la commande \LaTeX\ \lstinline!\opAp{}!.
-    %\par\vspace*{2em}\par
+    \par\vspace*{2em}\par
   \item[Groupe {\sffamily Son}]\hfil\newline
     \begin{itemize}
     \item[\textbullet]\lstinline!draw Jouer("miaou");!
@@ -285,6 +296,16 @@ s'obtiennent par la commande \LaTeX\ \lstinline!\opSon{}!.
     \end{minipage}
 \end{center}
 s'obtiennent par les commandes \LaTeX\ \lstinline!\opVar{}!, \lstinline!\opList{}! et \lstinline!\opSousList{}!.
+\vspace{0.5em}
+\begin{center}
+    \includegraphics{CommandeVariable.15}
+%  \begin{minipage}{0.6\linewidth}
+    \begin{lstlisting}[frame=tb]
+label(LATEX("\opList{\opSousList{Pythagore}
+ contient \opSimple{(3;4;5)} ?}"),(0,0));
+    \end{lstlisting}
+%  \end{minipage}
+\end{center}
     \par\vspace*{2em}\par
 \item[Groupe {\sffamily \'Evènement}]\hfil\newline
   \begin{itemize}
@@ -410,7 +431,7 @@ Les \og opérateurs\fg
 \end{center}
 s'obtiennent par les commandes \LaTeX\ \lstinline!\opCap{}! et \lstinline!\opCapCap{}!.
 Néanmoins, il faut parfois un codage conséquent. Par exemple, voici un capteur et son code.
-\par\begin{minipage}{0.3\linewidth}
+\par\vspace{1em}\par\begin{minipage}{0.3\linewidth}
   \includegraphics{CommandeCapteurs.7}
 \end{minipage}
 \hfill
@@ -444,6 +465,7 @@ Les éléments%
     \end{minipage}
 \end{center}
 s'obtiennent par les commandes \LaTeX\ \lstinline!\opOp{}! et \lstinline!\opSousOp{}!.
+\\Afin de rapprocher le package des conventions d'écriture des opérations, le choix du $\times$ à la place de * s'est imposé. Néanmoins, cela peut être discuté et modifié\ldots
 \vspace*{2em}\par
 \item[Groupe {\sffamily Ajouter blocs}]\hfil\newline
   \begin{itemize}
@@ -455,7 +477,7 @@ s'obtiennent par les commandes \LaTeX\ \lstinline!\opOp{}! et \lstinline!\opSous
     \par\hfill\includegraphics{CommandeBloc.2}
 \end{itemize}
 \item[Groupe {\sffamily Divers}]\hfil\newline
-D'un point de vue pédagogique, il m'est apparu nécessaire d'ajouter la possibilité de donner l'illusion d'un algorithme \og vide\fg. J'ai donc créé la commande \lstinline!LigneVide! qui demande un argument simple (on pourra se reporter aux exemples du groupe {\sffamily Contrôle}.\footnote{On peut obtenir le même résultat avec le paramètre \lstinline! _coinprec ! mais la précision de placement me semble plus délicate.}
+D'un point de vue pédagogique, il m'est apparu nécessaire d'ajouter la possibilité de donner l'illusion d'un algorithme \og vide\fg. J'ai donc créé la commande \lstinline!LigneVide! qui demande un argument simple (on pourra se reporter aux exemples du groupe {\sffamily Contrôle}\footnote{On peut obtenir le même résultat avec le paramètre \lstinline! _coinprec ! mais la précision de placement me semble plus délicate à obtenir.}).
 \\On aura également à disposition \lstinline!CommandeVide("Bonjour!")! afin de faire compléter un algorithme par les élèves.
 \begin{figure}[h]
   \centering
@@ -481,7 +503,7 @@ D'un point de vue pédagogique, il m'est apparu nécessaire d'ajouter la possibi
 \end{figure}
   \end{description}
 Terminons cette liste de commandes par un algorithme associé à la suite de Syracuse :)
-\[\includegraphics[scale=0.8]{Syracuse.1}\]
+\[\includegraphics[scale=0.9]{Syracuse.1}\]
 \begin{filecontents*}{Syracuse.txt}
   beginfig(1);
   draw Drapeau;
@@ -506,8 +528,6 @@ Terminons cette liste de commandes par un algorithme associé à la suite de Syr
   draw FinBlocSi3;
   draw FinBlocRepeter1(10);
 endfig;
-
-end
 \end{filecontents*}
 {\footnotesize
 \lstinputlisting[inputencoding=utf8/latin1,frame=tb]{Syracuse.txt}
@@ -656,6 +676,8 @@ endfig;
 \newpage
 \section{Historique}
 \begin{description}
+\item[16/02/2017] {\bfseries Version 0.59} - Correction des commandes {\sffamily Dire}, {\sffamily DireT}, {\sffamily Penser}, {\sffamily PenserT}. Mise à jour de la documentation (informations sur l'installation du package).
+\item[15/02/2017] {\bfseries Version 0.57} - Correction de problèmes mineurs d'affichage. Correction de la documentation.
 \item[14/02/2017] {\bfseries Version 0.55} - Mise à jour de la documentation.
   \item[13/02/2017] {\bfseries Version 0.53} - Ajout des chanfreins sur les blocs. Correction de \og doublons\fg\ de commandes. Mise à jour de la documentation.
   \item[05/02/2017] {\bfseries Version 0.51} - Sur les conseils de Maxime Chupin et Thierry Pasquier, travail sur les couleurs (mise en accord avec celles de Scratch et personnalisation possible). Passage des majuscules aux minuscules pour les blocs.