summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/scratch
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-04-07 20:58:58 +0000
committerKarl Berry <karl@freefriends.org>2018-04-07 20:58:58 +0000
commit62912cec554e0cf0a043fc8d7606c36e5b6b1756 (patch)
tree3798bd17673c594329fe1388a03d4b41a8118f4b /Master/texmf-dist/doc/latex/scratch
parent84deb36e8bed487533cffa6c630f307f030cb590 (diff)
scratch (7apr18)
git-svn-id: svn://tug.org/texlive/trunk@47360 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/scratch')
-rw-r--r--Master/texmf-dist/doc/latex/scratch/README8
-rw-r--r--Master/texmf-dist/doc/latex/scratch/scratch-fr.pdfbin452516 -> 488105 bytes
-rw-r--r--Master/texmf-dist/doc/latex/scratch/scratch-fr.tex121
3 files changed, 107 insertions, 22 deletions
diff --git a/Master/texmf-dist/doc/latex/scratch/README b/Master/texmf-dist/doc/latex/scratch/README
index 363390b3a2a..98ec7aaff3a 100644
--- a/Master/texmf-dist/doc/latex/scratch/README
+++ b/Master/texmf-dist/doc/latex/scratch/README
@@ -3,14 +3,14 @@ ___________________________________
L'extension
scratch
- v0.33
+ v0.4
- 30 d\'ecembre 2017
+ 8 avril 2018
___________________________________
-Authors : Christian Tellechea
+Author : Christian Tellechea
Maintainer: Christian Tellechea
-E-mail : unbonpetit@openmailbox.org (CT)
+E-mail : unbonpetit@netc.fr (CT)
Commentaires, signalements de bugs et
suggestions bienvenus
Licence : Released under the LaTeX Project Public License v1.3c or
diff --git a/Master/texmf-dist/doc/latex/scratch/scratch-fr.pdf b/Master/texmf-dist/doc/latex/scratch/scratch-fr.pdf
index 518e98a2de1..97299661241 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 5ae1a317e53..46aaab49b0a 100644
--- a/Master/texmf-dist/doc/latex/scratch/scratch-fr.tex
+++ b/Master/texmf-dist/doc/latex/scratch/scratch-fr.tex
@@ -131,7 +131,8 @@
\begingroup
\centering
\null\vskip.25\vsize
- {\large\bfseries L'extension pour \LaTeX\par \Huge \scrname\par}
+ {\large\bfseries L'extension pour \LaTeX\medbreak
+ \Huge \begin{scratch}[line width=1.5pt]\blockmove\scrname\end{scratch}\par}
\bigbreak
v \scrver
\smallbreak
@@ -157,7 +158,7 @@ Pour dessiner un programme comme le fait \SCRATCH, il faut ouvrir un environneme
macros pour dessiner des blocs
\end{scratch}|
-Comme le savent ceux qui enseignent l'algorithmique et la programmation avec le très-à-la-mode\footnote{Je ne déteste rien de plus comme langage de programmation que ce \emph{truc} vaguement graphique, ultra limité et contre-productif dans l'apprentissage du codage qu'est scratch et que l'éducation nationale veut à tout prix imposer. Je ne compte bien évidemment pas me plier à ce nouveau dogme ridicule et ne l'utiliserai ni ne l'enseignerai; je considère que les élèves méritent mieux que scratch --~ADA par exemple~-- comme entrée dans le monde de la programmation. Ceci dit, coder cette extension a été un petit amusement.} logiciel « \SCRATCH », les programmes sont construits avec des briques, appelés «blocs», qui peuvent s'emboiter les uns sur les autres. Ces blocs sont de plusieurs couleurs, chacune correspondant à un type d'instruction que l'on retrouve dans les menus de \SCRATCH.
+Comme le savent ceux qui enseignent l'algorithmique et la programmation avec le très-à-la-mode\footnote{Je ne déteste rien de plus comme langage de programmation que ce \emph{truc} vaguement graphique, ultra limité et contre-productif dans l'apprentissage du codage qu'est \SCRATCH et que l'éducation nationale veut à tout prix imposer. Je ne compte bien évidemment pas me plier à ce nouveau dogme ridicule et ne l'utiliserai ni ne l'enseignerai; je considère que les élèves méritent mieux que \SCRATCH --~ADA par exemple~-- comme entrée dans le monde de la programmation. Ceci dit, coder cette extension a été un petit amusement.} logiciel « \SCRATCH », les programmes sont construits avec des briques, appelés «blocs», qui peuvent s'emboiter les uns sur les autres. Ces blocs sont de plusieurs couleurs, chacune correspondant à un type d'instruction que l'on retrouve dans les menus de \SCRATCH.
J'ai pris le parti d'écrire des macros ayant comme argument le texte qui figure dans le bloc. Ce faisant, on a plus de liberté que dans \SCRATCH où les blocs ont des textes prédéfinis, mais cette liberté permet d'utiliser cette extension quelle que soit la langue dans laquelle on écrit.
@@ -216,7 +217,8 @@ Voici quelques exemples :
y: \ovaloperator{\ovalnum{4} * \ovalsensing{souris y}}}
\end{scratch}
-Toutes les macros ayant pour préfixe \verb|\oval| sont utilisables \emph{en dehors} de l'environnement \texttt{scratch}, la preuve : voici \ovalvariable{une variable} et \ovaloperator{un opérateur}./
+Toutes les macros ayant pour préfixe \verb|\oval| sont utilisables \emph{en dehors} de l'environnement
+scratch, la preuve : voici \ovalvariable{une variable} et \ovaloperator{un opérateur}./
\section{Les blocs de début}
Ces blocs sont de la couleur \suffixe{event} pour la plupart (macro \verb|\blockinit|), mais il existe aussi un bloc de début de couleur \suffixe{control} (macro \verb|\blockinitclone|). Le drapeau vert est dessiné avec la macro \verb|\greenflag|.
@@ -381,40 +383,43 @@ Voici les \verb|<paramètres>| disponibles :
Représente est le mot qui est inséré dans la branche « else » d'un bloc de test.
\cleval{x sep}{dimension}
-Représente l'espace horizontale insérée entre les bords droit et gauche du texte du bloc et les bords droits et gauche du bloc.
+Représente l'espace horizontale insérée entre les bords droit et gauche du texte du bloc et les bords droits et gauche du bloc. La valeur est ramenée si nécessaire dans l'intervalle [3pt ; 1em].
\cleval{y sepsup}{dimension}
-Représente l'espace verticale insérée entre le bas de l'encoche femelle et le bord supérieur du texte du bloc.
+Représente l'espace verticale insérée entre le bas de l'encoche femelle et le bord supérieur du texte du bloc. La valeur est ramenée si nécessaire dans l'intervalle [3pt ; 3ex].
\cleval{y sepinf}{dimension}
-Représente l'espace verticale insérée entre le bas du bloc et le bord inférieur du texte du bloc.
+Représente l'espace verticale insérée entre le bas du bloc et le bord inférieur du texte du bloc. La valeur est ramenée si nécessaire dans l'intervalle [3pt ; 3ex].
\cleval{line width}{dimension}
-Représente l'épaisseur des lignes de relief des blocs et le double des lignes de relief des losanges booléens.
+Représente l'épaisseur des lignes de relief des blocs et le double des lignes de relief des losanges booléens. La valeur est ramenée si nécessaire dans l'intervalle [0pt ; 5pt].
\cleval{loop width}{dimension}
-Représente est la largeur de la barre verticale des blocs de répétition ou de test.
+Représente est la largeur de la barre verticale des blocs de répétition ou de test. La valeur est ramenée si nécessaire dans l'intervalle [3pt ; 3em].
\cleval{loop height}{dimension}
-Représente est l'épaisseur des barres horizontales « else » et inférieure des blocs de répétition ou de test.
+Représente est l'épaisseur des barres horizontales « else » et inférieure des blocs de répétition ou de test. La valeur est ramenée si nécessaire dans l'intervalle [3pt ; 3ex].
\cleval{corner}{dimension}
-Représente la dimension des chanfreins des blocs. Cette dimension est utilisée proportionnellement pour le placement horizontal, l'épaisseur et la largeur des encoches des blocs.
+Représente la dimension des chanfreins des blocs. La valeur est ramenée si nécessaire dans l'intervalle [0.33333ex ; 1ex].
+
+\cleval{notch}{dimension}
+Représente la largeur des encoches. La valeur est ramenée si nécessaire dans l'intervalle [0.33333em ; 3em].
\cleval{scale}{coefficient}\label{cle-scale}
-Représente l'échelle à laquelle est représenté le dessin.
+Représente l'échelle à laquelle est représenté le dessin. La valeur est ramenée si nécessaire dans l'intervalle [0.2 ; 5].
\cleval{init arcangle}{angle}
-Représente l'angle avec l'horizontale de l'arc de cercle tracé dans la partie haute des blocs de départ.
+Représente l'angle avec l'horizontale de l'arc de cercle tracé dans la partie haute des blocs de départ. La valeur est ramenée si nécessaire dans l'intervalle [20 ; 40].
\cleval{init arclength}{dimension}
-Représente la longueur horizontale de l'arc de cercle tracé dans la partie haute des blocs de départ.
+Représente la longueur horizontale de l'arc de cercle tracé dans la partie haute des blocs de départ. La valeur est ramenée si nécessaire dans l'intervalle [3em ; 8em].
\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».
+Représente l'angle avec l'horizontale de l'arc de cercle tracé dans la partie haute des blocs de de type « moreblock». La valeur est ramenée si nécessaire dans l'intervalle [10 ; 20].
\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.
+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. La valeur est ramenée si nécessaire dans l'intervalle [0 ; 100].
\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.
@@ -436,7 +441,7 @@ Lorsque ce booléen est vrai, les dessins se font en noir et blanc de façon à pou
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.
+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. La valeur est ramenée si nécessaire dans l'intervalle [0 ; 1].
\exemple/\begin{scratch}
\blockinit{Quand \greenflag est cliqué}
@@ -461,7 +466,7 @@ Lorsque \verb|fill blocks| est vrai, ce taux de blanc dans le gris (nombre compr
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.
+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. La valeur est ramenée si nécessaire dans l'intervalle [0 ; 1].
\exemple/\begin{scratch}[print,fill blocks,fill gray=0.66]
\blockinit{Quand \greenflag est cliqué}
@@ -477,7 +482,76 @@ Lorsque \verb|print| est vrai, ce taux de gris est utilisé pour la couleur du dr
\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.
+Lorsque \verb|print| est vrai, ce taux de gris est utilisé pour la couleur des lignes de relief. La valeur est ramenée si nécessaire dans l'intervalle [0 ; 1].
+
+\cleval{num blocks}{booléen}
+Lorsque ce booléen est vrai, les blocs sont numérotés.
+
+\cleval{num sep}{dimension}
+Cette clé contient l'espacement entre les numéros de blocs et leur frontière gauche. La valeur est ramenée si nécessaire dans l'intervalle [0pt ; 1.5em].
+
+\cleval{num start}{entier}
+Cette clé contient le premier numéro du bloc.
+
+La macro \verb|\numblock| est chargée d'imprimer les numéros de ligne. Elle admet un argument (le numéro de ligne) et permet, lorsqu'elle est redéfinie, de personnaliser la numérotation : choix de la couleur, de la police, de sa taille et des effets applicables à son argument. Par défaut, cette macro est définie par
+\begin{center}
+ \verb|\newcommand*\numblock[1]{\color{black}\footnotesize\bfseries#1}|
+\end{center}
+
+Dans l'environnement \SCRATCH, entre des instructions \SCRATCH, on peut activer ou désactiver la numérotation \emph{pour le dessin en cours} à l'aide de
+\begin{center}
+ \verb|\setscratch{num blocks=<booléen>}|
+\end{center}
+
+\exemple/\begin{scratch}[num blocks]
+ \blockinit{Quand \greenflag est cliqué}
+ \blockpen{effacer tout}
+ \blockpen{relever le stylo}
+ \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
+\end{scratch} puis
+\renewcommand*\numblock[1]{\color{blue!80}\itshape#1}
+\begin{scratch}[num blocks,num start=3]
+ \blockinit{Quand \greenflag est cliqué}
+ \blockpen{effacer tout}
+ \blockpen{relever le stylo}
+ \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
+\end{scratch}
+puis
+\renewcommand*\numblock[1]{\fboxsep=0.5pt\fbox{\bfseries#1}}
+\begin{scratch}[num blocks=false]
+ \blockinit{Quand \greenflag est cliqué}
+ \blockpen{effacer tout}
+ \setscratch{num blocks=true}
+ \blockpen{relever le stylo}
+ \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
+\end{scratch}/
+
+\cleval{baseline}{alignement}
+Cette clé contient la consigne d'alignement du dessin tout entier, c'est-à-dire :
+\begin{itemize}
+ \item la lettre «\verb|c|» auquel cas, le dessin est centré sur la ligne de base
+ \item un entier qui spécifie un numéro de bloc existant : la numérotation est cohérente avec l'entier initial contenu dans la clé \verb|num start|. Dans ce cas, la ligne de base choisie est celle du texte contenu dans le bloc portant le numéro choisi.
+\end{itemize}
+
+\exemple/Défaut : \begin{scratch}
+ \blockinit{Quand \greenflag est cliqué}
+ \blockpen{effacer tout}
+ \blockpen{relever le stylo}
+ \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
+\end{scratch}
+bloc 3 : \begin{scratch}[baseline=3]
+ \blockinit{Quand \greenflag est cliqué}
+ \blockpen{effacer tout}
+ \blockpen{relever le stylo}
+ \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
+\end{scratch}
+centré
+\begin{scratch}[baseline=c]
+ \blockinit{Quand \greenflag est cliqué}
+ \blockpen{effacer tout}
+ \blockpen{relever le stylo}
+ \blockmove{ajouter \ovalnum{5} à \ovalvariable{abscisse}}
+\end{scratch}/
\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.
@@ -514,4 +588,15 @@ Toute remarque, remontée de bug ---~je n'ose pas dire amélioration du code~---,
\begin{version}{0.33}{30/12/2017}
>Correction d'un bug signalé par I. \textsc{Eble} : l'affichage des losanges, boites de texte, ovales n'est pas correct dans les blocs lorsque \verb|scale| est différente de 1.
\end{version}
+
+\begin{version}{0.4}{08/04/2018}
+ >Possibilité de numéroter les blocs, requête de Fabrice \textsc{Bavoil}.
+ >Augmentation automatique de la taille horizontale d'un bloc si le texte qu'il contient est trop court, bug signalé par Fabrice \textsc{Bavoil}.
+ >Possibilité de choisir la ligne de base du dessin \SCRATCH, requête de Fabrice \textsc{Bavoil}.
+ >Grâce à une clé secrète, les « losanges » n'ont plus une infime fraction de trait qui se chevauche avec les \verb|\txtbox| ou \verb|\selectmenu| intérieurs qui se trouvent en début ou fin de texte. Les ultra-perfectionnistes sont enfin comblés !
+ >Paramètres bornés (pour la plupart) et ramenés dans le domaine de fonctionnement --~ou du raisonnable~-- si nécessaire.
+ >Suppression du \verb|\normalsize| qui empêchait la prise en compte de la taille de la police en cours.
+ >Nouvelle clé «notch» pour spécifier la longueur du trait horizontal des encoches.
+ >Nettoyage du code.
+\end{version}
\end{document} \ No newline at end of file