From: Christophe Poulain Date: Tue, 14 Feb 2017 19:56:33 +0000 (+0100) Subject: Mise à jour de la documentation X-Git-Url: https://melusine.eu.org/syracuse/G/git/?a=commitdiff_plain;h=52d623d683d473d35e73e6904c7bbf78f9f5fcd6;p=mp-scratch.git Mise à jour de la documentation --- diff --git a/doc/mp-scratch.pdf b/doc/mp-scratch.pdf index 2b82b7f..7e76706 100644 Binary files a/doc/mp-scratch.pdf and b/doc/mp-scratch.pdf differ diff --git a/doc/mp-scratch.tex b/doc/mp-scratch.tex index f07d0c8..66d4451 100644 --- a/doc/mp-scratch.tex +++ b/doc/mp-scratch.tex @@ -19,12 +19,17 @@ \usepackage[tikz]{bclogo} %\renewcommand\bcStyleTitre[1]{} \title{\includegraphics[scale=0.05]{Scratch_cat.png}\kern0.05\linewidth Scratch et \MP\kern0.05\linewidth\includegraphics{Carre.1}} -\author{C.Poulain} +\author{ + \begin{tabular}{c} + C.Poulain\\ + \url{chrpoulain@gmail.com}\\ + \end{tabular} +} \date{Janvier 2017} \begin{document} \maketitle \begin{abstract} - Utiliser \MP\ pour produire des algorithmes \og papier\fg\ avec les conventions de Scratch. + Comment utiliser \MP\ pour produire des algorithmes \og papier\fg\ avec les conventions de Scratch. \end{abstract} \vspace{2em} \setcounter{tocdepth}{1} @@ -40,7 +45,7 @@ Avec les nouveaux programmes 2016 du Cycle 4 (Classes de 5\ieme\ à 3\ieme\ de c \end{figure} \footnotetext{Ce premier algorithme me permet de remercier Maxime Chupin et son package {\sffamily bclogo} : le drapeau vert a été créé à partir des sources de son package et notamment la construction, en \MP, de ses drapeaux.} \section{Installation} -Le package {\sffamily mp-scratch} est indépendant d'autres packages personnels tels \lstinline!geometriesyr16!, \lstinline!mp-geo! ou \lstinline!mp-solid!. +{\sffamily mp-scratch} est indépendant des autres packages personnels déjà produits tels \lstinline!geometriesyr16!, \lstinline!mp-geo! ou \lstinline!mp-solid!. \\Au travers d'un dépôt \lstinline!git!\footnote{Tous les contributeurs sont donc les bienvenus pour développer le package.}, on trouvera l'archive à l'adresse \begin{center} \url{http://melusine.eu.org/syracuse/G/mp-scratch/} @@ -52,8 +57,8 @@ et l'ensemble des fichiers sera à placer correctement dans une arborescence \Te \begin{minipage}{0.4\linewidth} \includegraphics{Algo1.1} \end{minipage} -\hfill -\begin{minipage}{0.5\linewidth} +\hspace{4em} +\begin{minipage}{0.4\linewidth} \small \begin{lstlisting}[firstnumber=1,frame=tb] input mp-scratch; @@ -76,14 +81,14 @@ Reprenons l'exemple de l'algorithme du carré pour faire les premières constata \begin{Enumerate} \item la syntaxe est très proche du vocabulaire utilisé par Scratch; donc très peu de nouvelles commandes à apprendre\ldots \item les couleurs\footnote{Cela reste, bien évidemment, paramétrable. Les paramètres disponibles pour personnaliser les couleurs sont \lstinline!colMouv!, \lstinline!colAp!, \lstinline!colSon!, \lstinline!colStylo!, \lstinline!colEvenements!, \lstinline!colControle!, \lstinline!colCapteur!, \lstinline!colBloc!, \lstinline!colVar!, \lstinline!colList!.} sont celles utilisées par Scratch\footnote{Une nouvelle fois, merci à Maxime Chupin pour m'avoir fait découvrir l'utilitaire \lstinline!gcolor2! sous Linux}; - \item le bloc {\sffamily Répéter} est un peu particulier car il nécessite l'ajout {\em manuel} d'un nombre (ou chiffre)\footnote{{\sffamily Repeter2}, {\sffamily Repeter5}\ldots} qui permettra à \MP\ de faire la liaison correcte lors de la présence de multiples blocs {\sffamily Répéter} comme le montre l'exemple ci-dessous. + \item le bloc {\sffamily Répéter} est particulier car il nécessite l'ajout {\em manuel} d'un nombre (ou chiffre)\footnote{{\sffamily Repeter2}, {\sffamily Repeter5}\ldots} qui permettra à \MP\ de faire la liaison correcte lors de la présence de multiples blocs {\sffamily Répéter} comme le montre l'exemple ci-dessous. %\par\vspace{1em}\par \begin{figure}[h] \centering - \begin{minipage}{0.3\linewidth} + \begin{minipage}{0.45\linewidth} \includegraphics{Algo2.1} \end{minipage} -\hspace{7.5em} +\hspace{2em} \begin{minipage}{0.35\linewidth} \small \begin{lstlisting}[firstnumber=1,frame=tb] @@ -405,20 +410,21 @@ 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.2\linewidth} +\par\begin{minipage}{0.3\linewidth} \includegraphics{CommandeCapteurs.7} \end{minipage} \hfill -\begin{minipage}{0.75\linewidth} +\begin{minipage}{0.65\linewidth} \small \begin{lstlisting}[frame=tb] - \opCap{couleur % - \definecolor{Magenta}{rgb}{1,0,1}% - \colorbox{Magenta}{\textcolor{white}{\phantom{t}}}% - touche% - \definecolor{LGray}{gray}{0.85}% - \colorbox{LGray}{\textcolor{white}{\phantom{t}}} ?% - } +\opCap{couleur % + \definecolor{Magenta}{rgb}{1,0,1}% + \colorbox{Magenta}{\textcolor{white}{% + \phantom{t}}}touche% + \definecolor{LGray}{gray}{0.85}% + \colorbox{LGray}{\textcolor{white}{% + \phantom{t}}} ?% +} \end{lstlisting} \end{minipage} \\Un peu barbare, non ? Mais, cela ne nécessitera qu'un simple copier-coller pour les autres utilisations\ldots%} @@ -564,7 +570,8 @@ beginfig(1)%François Morellet - Oeuvre Pi piquant, 1=1°, 38 décimales draw MettreVar("varpi","\opSimple{2}"); draw RepeterJ1("\opOp{\opVar{varpi}\,$\bm{>}$\,38}"); draw Si2("$\opOp{\opVar{varpi}\mbox{ modulo }\opSimple{2}\,=\,\opSimple{0}}$"); - draw Tournerg("$\opOp{\opSimple{180}}\bm{-}\opList{élément \opVar{varpi} de \opSousList{pi}}$"); + draw Tournerg("$\opOp{\opSimple{180}}\bm{-}\opList{élément \opVar{varpi} + de \opSousList{pi}}$"); draw Sinon2; draw Tournerd("$\opOp{\opSimple{180}}-\opList{élément \opVar{varpi} de \opSousList{pi}}$"); draw FinBlocSi2; @@ -630,7 +637,7 @@ beginfig(1);%https://sites.google.com/site/stjomaths/scratch draw Demander("\opSimple{dimension du motif ?}"); draw MettreVar("rang","\opCap{réponse}"); draw Bloc("Sierpinski \opBloc{rang} \opBloc{triangles}"); - _coinprec:=(10cm,0); + _coinprec:=(8.5cm,0); draw NouveauBloc("Sierpinski \opBloc{rang} \opBloc{triangles}"); draw Si1("\opOp{non $\opBloc{rang}\bm{=}0$}"); draw Repeter2(3); @@ -649,6 +656,7 @@ endfig; \newpage \section{Historique} \begin{description} +\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. \item[21/01/2017] {\bfseries Version 0.5} - Publication sur \url{www.melusine.eu.org/syracuse/}