summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/scratch/README4
-rw-r--r--Master/texmf-dist/doc/latex/scratch/scratch-fr.pdfbin437664 -> 450231 bytes
-rw-r--r--Master/texmf-dist/doc/latex/scratch/scratch-fr.tex82
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
index e3140e7512c..2c95c1f8db4 100644
--- a/Master/texmf-dist/doc/latex/scratch/scratch-fr.pdf
+++ b/Master/texmf-dist/doc/latex/scratch/scratch-fr.pdf
Binary files differ
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