diff options
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/latex/scratch/README | 4 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/scratch/scratch-fr.pdf | bin | 437664 -> 450231 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/scratch/scratch-fr.tex | 82 |
3 files changed, 82 insertions, 4 deletions
diff --git a/Master/texmf-dist/doc/latex/scratch/README b/Master/texmf-dist/doc/latex/scratch/README index 84750c8f107..b91de4430df 100644 --- a/Master/texmf-dist/doc/latex/scratch/README +++ b/Master/texmf-dist/doc/latex/scratch/README @@ -3,9 +3,9 @@ ___________________________________ L'extension scratch - v0.1 + v0.2 - 16 mai 2017 + 28 mai 2017 ___________________________________ Authors : Christian Tellechea diff --git a/Master/texmf-dist/doc/latex/scratch/scratch-fr.pdf b/Master/texmf-dist/doc/latex/scratch/scratch-fr.pdf Binary files differindex e3140e7512c..2c95c1f8db4 100644 --- a/Master/texmf-dist/doc/latex/scratch/scratch-fr.pdf +++ b/Master/texmf-dist/doc/latex/scratch/scratch-fr.pdf diff --git a/Master/texmf-dist/doc/latex/scratch/scratch-fr.tex b/Master/texmf-dist/doc/latex/scratch/scratch-fr.tex index c8f4039aedf..8d7a30f5c5f 100644 --- a/Master/texmf-dist/doc/latex/scratch/scratch-fr.tex +++ b/Master/texmf-dist/doc/latex/scratch/scratch-fr.tex @@ -139,7 +139,12 @@ \leftskip=.2\linewidth \rightskip=.2\linewidth \small Cette extension permet de dessiner des empilements de blocs similaires � ceux que l'on trouve dans le logiciel de programmation \emph{visuelle} � \SCRATCH\footnote{Le logiciel que l'on peut utiliser en ligne � \texttt{https://scratch.mit.edu/}} �. \end{titlepage} -\parindent1.5em +\parindent0pt +\section{Avant propos} +La pr�sente extension \SCRATCH requiert les extensions \texttt{hlist} et \texttt{ti\textit kz}. Celles-ci sont automatiquement charg�es par \SCRATCH. + +En raison de la r�cente parution de \texttt{hlist}, post�rieure au gel de \TeX live~2016, il peut �tre n�cessaire d'installer � la main l'extension \texttt{hlist}. Pour ce faire, il suffit de t�l�charger les fichiers \texttt{hlist.sty} et \texttt{hlist.tex} sur le CTAN et copier ces fichiers dans un endroit o� \LaTeX{} les voit; le r�pertoire \texttt{texmf} personnel est tout indiqu� (il faut ensuite ex�cuter la commande \texttt{texhash}), ou le r�pertoire de compilation, pour une port�e plus locale. + \section{L'environnement \SCRATCH} Pour dessiner un programme comme le fait \SCRATCH, il faut ouvrir un environnement �\SCRATCH� et �crire dans cet environnement les macros correspondant aux \emph{blocs} que l'on veut y mettre : @@ -154,7 +159,7 @@ J'ai pris le parti d'�crire des macros ayant comme argument le texte qui figure Enfin, j'ai cherch� le bon compromis entre complexit� du code et qualit� des dessins obtenus avec cette extension: ils \emph{ressemblent} � ceux du logiciel \SCRATCH, mais le but de cette extension n'est \emph{pas} la ressemblance absolue au pixel pr�s! \section{Les blocs normaux} -Ces blocs sont les plus courants et poss�dent une encoche d'emboitement, femelle en haut et m�le en bas. Les macros permettant de dessiner ces blocs ont des noms de la forme \verb|\block<suffixe>| et ont un seul argument obligatoire qui est le texte que l'on souhaite mettre dans le bloc. Par exemple, un bloc bleu (correspondant au menu �mouvement�) a un suffixe \suffixe{move}, et est dessin� gr�ce � la macro \verb|\blocmove{<texte>}|. Ainsi, dans l'environnement \SCRATCH, �crire \verb|\blockmove{Bonjour le monde}| donne +Ces blocs sont les plus courants et poss�dent une encoche d'emboitement, femelle en haut et m�le en bas. Les macros permettant de dessiner ces blocs ont des noms de la forme \verb|\block<suffixe>| et ont un seul argument obligatoire qui est le texte que l'on souhaite mettre dans le bloc. Par exemple, un bloc bleu (correspondant au menu �mouvement�) a un suffixe \suffixe{move}, et est dessin� gr�ce � la macro \verb|\blockmove{<texte>}|. Ainsi, dans l'environnement \SCRATCH, �crire \verb|\blockmove{Bonjour le monde}| donne \begin{center}\begin{scratch}\blockmove{Bonjour le monde}\end{scratch}\end{center} La police d'�criture dans chaque bloc est la police � \textsf{sans serif} � en gras qui est d�finie dans le document au moment o� l'environnement est appel� : pratiquement, cela signifie que les macros \verb|\sffamily| et \verb|\bfseries| sont ex�cut�es avant que le texte des blocs ne soit compos�. Dans cette documentation, la police sans serif est �\textsf{biolinum}�. @@ -400,8 +405,81 @@ Repr�sente la longueur horizontale de l'arc de cercle trac� dans la partie haute \cleval{moreblock arcangle}{angle} Repr�sente l'angle avec l'horizontale de l'arc de cercle trac� dans la partie haute des blocs de de type � moreblock�. +\cleval{contrast}{entier} +Cet entier, compris entre 0 et 100 inclus, qualifie la diff�rence de teintes entre les lignes de relief trac�es autour des blocs. L'entier 0 signifie �aucun contraste� (teintes identiques) tandis que que 100 signifie �contraste maximal� auquel cas les lignes claires, qui se situent sur la partie haute des blocs, sont blanches et les lignes fonc�es sont noires. + +\cleval{print}{bool�en} +Lorsque ce bool�en est vrai, les dessins se font en noir et blanc de fa�on � pouvoir �tre dirig�s vers une impression en noir et blanc. + +\exemple/\begin{scratch} + \blockinit{Quand \greenflag est cliqu�} + \blockpen{effacer tout} + \blockpen{relever le stylo} + \blockmove{ajouter \ovalnum{5} � \ovalvariable{abscisse}} +\end{scratch} puis +\begin{scratch}[print] + \blockinit{Quand \greenflag est cliqu�} + \blockpen{effacer tout} + \blockpen{relever le stylo} + \blockmove{ajouter \ovalnum{5} � \ovalvariable{abscisse}} +\end{scratch}/ + +\cleval{fill blocks}{bool�en} +Ce bool�en n'est pris en compte que lorsque le bool�en \verb|print| est vrai. Si \verb|fill blocks| est vrai, tous les dessins (sauf les ovales contenant des nombres) seront remplis avec un gris choisi avec la cl� suivante. + +\cleval{fill gray}{taux de gris} +Lorsque \verb|fill blocks| est vrai, ce taux de blanc dans le gris (nombre compris entre 0 pour noir et 1 pour blanc) est utilis� pour d�finir une couleur de remplissage des dessins. + +\exemple/\begin{scratch} + \blockinit{Quand \greenflag est cliqu�} + \blockpen{effacer tout} + \blockpen{relever le stylo} + \blockmove{ajouter \ovalnum{5} � \ovalvariable{abscisse}} +\end{scratch} puis +\begin{scratch}[print,fill blocks] + \blockinit{Quand \greenflag est cliqu�} + \blockpen{effacer tout} + \blockpen{relever le stylo} + \blockmove{ajouter \ovalnum{5} � \ovalvariable{abscisse}} +\end{scratch} puis +\begin{scratch}[print,fill blocks,fill gray=0.66] + \blockinit{Quand \greenflag est cliqu�} + \blockpen{effacer tout} + \blockpen{relever le stylo} + \blockmove{ajouter \ovalnum{5} � \ovalvariable{abscisse}} +\end{scratch}/ + +\cleval{text color}{couleur} +Lorsque \verb|fill blocks| est vrai, cette couleur sera utilis�e pour le texte des blocs. + +\cleval{flag gray}{taux de gris} +Lorsque \verb|print| est vrai, ce taux de gris est utilis� pour la couleur du drapeau trac� avec \verb|\greenflag| ainsi que pour la fl�che se trouvant au bas des blocs de r�p�tition. + +\exemple/\begin{scratch}[print,fill blocks,fill gray=0.66] + \blockinit{Quand \greenflag est cliqu�} + \blockpen{effacer tout} + \blockpen{relever le stylo} + \blockmove{ajouter \ovalnum{5} � \ovalvariable{abscisse}} +\end{scratch} puis +\begin{scratch}[print,fill blocks,fill gray=0.33,text color=white,flag gray=0.66] + \blockinit{Quand \greenflag est cliqu�} + \blockpen{effacer tout} + \blockpen{relever le stylo} + \blockmove{ajouter \ovalnum{5} � \ovalvariable{abscisse}} +\end{scratch}/ + +\cleval{line gray}{taux de gris} +Lorsque \verb|print| est vrai, ce taux de gris est utilis� pour la couleur des lignes de relief. + \section{Mot de la fin} Le code de cette extension d�montre mon immense ignorance de ti\textit kz/pgf et les m�thodes de programmation qui lui sont propres que, d�cid�ment, je ne comprendrai jamais! C'est sans doute le trop grand �loignement avec la logique de \TeX{} et la documentation de ti\textit kz/pgf, aussi indigeste qu'illisible, qui explique cette incompatibilit� d'humeur et mon d�sint�r�t � l'�gard de ti\textit kz. Toujours est-il que cette extension fonctionne, avec une lenteur certaine que j'attribue � ma programmation hasardeuse ainsi qu'� la lenteur intrins�que de ti\textit kz. Toute remarque, remont�e de bug ---~je n'ose pas dire am�lioration du code~---, demande d'impl�mentation de fonctionnalit� est bien �videmment bienvenue; j'invite les utilisateurs � m'en faire part \emph{via} email. + +\section{Historique} +\paragraph{v0.1\quad 16/05/2017} Premi�re version. +\paragraph{v0.2\quad 28/05/2017} Pour une impression en noir et blanc, ajout de l'option �\texttt{print}�, suite � une demande de P.~\bsc{Celdran}. De cette option d�coulent les options �\texttt{fill blocks}�, �\texttt{fill gray}�, �\texttt{text color}�, �\texttt{flag gray}� et �\texttt{line gray}�. + + Ajout �galement de l'option �\texttt{contrast}� qui qualifie la diff�rence de nuance entre les lignes de contraste des parties hautes et des parties basses. + \end{document}
\ No newline at end of file |