summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/proflycee/doc/ProfLycee-doc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/proflycee/doc/ProfLycee-doc.tex')
-rw-r--r--macros/latex/contrib/proflycee/doc/ProfLycee-doc.tex165
1 files changed, 163 insertions, 2 deletions
diff --git a/macros/latex/contrib/proflycee/doc/ProfLycee-doc.tex b/macros/latex/contrib/proflycee/doc/ProfLycee-doc.tex
index 761c36edaf..d653c2ac21 100644
--- a/macros/latex/contrib/proflycee/doc/ProfLycee-doc.tex
+++ b/macros/latex/contrib/proflycee/doc/ProfLycee-doc.tex
@@ -60,8 +60,8 @@
\setlength{\parindent}{0pt}
\definecolor{LightGray}{gray}{0.9}
-\def\PLversion{1.2.5}
-\def\PLdate{3 Septembre 2022}
+\def\PLversion{1.2.6}
+\def\PLdate{22 Septembre 2022}
\tcbset{vignettes/.style={%
nobeforeafter,box align=base,boxsep=0pt,enhanced,sharp corners=all,rounded corners=southeast,%
@@ -233,6 +233,8 @@ Quelques commandes pour convertir bin/dec/hex avec certains détails.
Une commande pour, en \TikZ, créer un pixelart avec correction éventuelle.
+Une commande pour, en \TikZ, créer un SudoMaths non forcément $9\times9$.
+
\vspace{1.5cm}
\hfill{}\textit{Merci à Anne pour ses retours et sa relecture !}
@@ -3968,8 +3970,167 @@ D,-,-,D,-,D,D,F,F,F,F,F,F,D,D,-,-,-,-,D,-,-
\newpage
+\section{SudoMaths, en \TikZ}\label{sudomaths}
+
+\subsection{Introduction}
+
+\begin{codeidee}
+L'idée est de \textit{proposer} un environnement \TikZ, une commande permettant de tracer des grilles de SudoMaths.
+
+L'environnement créé, lié à \TikZ, trace la grille de SudoMaths (avec les blocs démarqués), et peut la remplir avec une liste d'éléments.
+\end{codeidee}
+
+\begin{codetex}[listing only]
+%grille classique non remplie, avec légendes H et V
+%les {} non nécessaires pour préciser que les cases seront "vides"
+\PLsudomaths{}
+\end{codetex}
+
+\begin{codesortie}
+\PLsudomaths{}
+\end{codesortie}
+
+\begin{codeinfo}
+La commande \ctex{PLsudomaths} crée donc la grille (remplie ou non), dans un environnement \TikZ, c'est \textit{c'est tout} !
+
+\smallskip
+
+Si on veut exploiter le tracé de la grille, on peut utiliser l'\textit{environnement} \ctex{PLenvsudomaths} dans lequel on peut rajouter toute commande en \TikZ{} !
+\end{codeinfo}
+
+\begin{codetex}[listing only]
+%grille "toute seule"
+\PLsudomaths[<options>]{<liste>}
+
+%grille avec ajout de code
+\begin{PLenvsudomaths}[<options>]{<grille>}
+ <commandes tikz> ;
+\end{PLenvsudomaths}
+\end{codetex}
+
+\pagebreak
+
+\subsection{Clés et options}
+
+\begin{codecles}
+Quelques \Cle{clés} sont disponibles pour cette commande :
+
+\begin{itemize}
+ \item la clé \Cle{epaisseurg} pour gérer l'épaisseur des traits épais ; \hfill~défaut \Cle{1.5pt}
+ \item la clé \Cle{epaisseur} pour gérer l'épaisseur des traits fins ; \hfill~défaut \Cle{0.5pt}
+ \item la clé \Cle{unite} qui est l'unité graphique de la figure ; \hfill~défaut \Cle{1cm}
+ \item la clé \Cle{couleurcase} pour la couleur (éventuelles) des cases ; \hfill~défaut \Cle{LightBlue!50}
+ \item la clé \Cle{couleurtexte} pour gérer la couleur du label des cases ; \hfill~défaut \Cle{blue}
+ \item la clé \Cle{nbcol} qui est le nombre de colonnes ; \hfill~défaut \Cle{9}
+ \item la clé \Cle{nbsubcol} qui est le nombre de sous-colonnes ; \hfill~défaut \Cle{3}
+ \item la clé \Cle{nblig} qui est le nombre de lignes ; \hfill~défaut \Cle{9}
+ \item la clé \Cle{nbsublig} qui est le nombre de sous-colonnes ; \hfill~défaut \Cle{3}
+ \item la clé \Cle{police} qui formatte le label des cases ; \hfill~défaut \Cle{\textbackslash{}normalfont\textbackslash{}normalsize}
+ \item le booléen \Cle{legendes} qui affiche ou non les légendes (H et V) des cases ; \hfill~défaut \Cle{true}
+ \item la clé \Cle{policeleg} qui formatte le label des légendes ; \hfill~défaut \Cle{\textbackslash{}normalfont\textbackslash{}normalsize}
+ \item la clé \Cle{listelegv} qui est la liste de la légende verticale ; \hfill~défaut \Cle{ABCD...WXYZ}
+ \item la clé \Cle{listelegh} qui est la liste de la légende horizontale ; \hfill~défaut \Cle{abcd...wxyz}
+ \item la clé \Cle{decallegende} qui est le décalage de la légende par rapport à la grille. \hfill~défaut \Cle{0.45}
+\end{itemize}
+\end{codecles}
+
+\begin{codeinfo}
+La liste éventuelle des éléments à rentrer dans le tableau est traitée par le package \ctex{listofitems}, et se présente sous la forme suivante : \ctex{ / / / ... / / § / / / ... / / § ... § / / / ... / / }
+
+\smallskip
+
+Il peut donc être intéressant de \textit{déclarer} la liste au préalable pour simplifier la saisie de la commande !
+\end{codeinfo}
+
+\begin{codeinfo}
+La \Cle{couleurcase} est gérée -- en interne -- par le caractère \ctex{*} qui permet de préciser qu'on veut que la case soit coloriée.
+\end{codeinfo}
+
+\begin{codetex}[listing only]
+%grille 6x6 avec blocs 2x3, avec coloration de cases (présentée sous forme de "cases")
+\def\grilleSuMa{%
+ (a)* / (b)* / / / (c)* / (d)* §%
+ (e)* / / / (f)* / (g)* / (h)* §%
+ / / (i)* / / / (j)* §%
+ / / (k)* / / (l)* / (m)* §%
+ (n)* / / (o)* / / / (p)* §%
+ / / / (q)* / / §%
+}
+
+\PLsudomaths[unite=0.75cm,nbcol=6,nbsubcol=2,nblig=6,nbsublig=3,police=\small\bfseries\ttfamily,%
+ couleurtexte=red,couleurcase=yellow!50,legendes=false]{\grilleSuMa}
+\end{codetex}
+
+\begin{codesortie}
+\def\grilleSuMa{%
+ (a)* / (b)* / / / (c)* / (d)* §%
+ (e)* / / / (f)* / (g)* / (h)* §%
+ / / (i)* / / / (j)* §%
+ / / (k)* / / (l)* / (m)* §%
+ (n)* / / (o)* / / / (p)* §%
+ / / / (q)* / / §%
+}
+
+\PLsudomaths[unite=0.75cm,nbcol=6,nbsubcol=2,nblig=6,nbsublig=3,police=\small\bfseries\ttfamily,couleurtexte=red,couleurcase=yellow!50,legendes=false]{\grilleSuMa}
+\end{codesortie}
+
+\pagebreak
+
+\begin{codeinfo}
+La grille, créée en \TikZ, est portée par le rectangle de \og coins \fg{} $(0\,;\,0)$ et $(\text{nbcol}\,;\,-\text{nblig})$, de sorte que les labels des cases sont situés au nœuds de coordonnées $(x,5\,;\,-y,5)$.
+\end{codeinfo}
+
+\begin{codetex}[listing only]
+%grille classique avec coloration de cases et commande tikz
+%graduations rajoutées pour la lecture des coordonnées
+\def\grilleSuMaB{%
+ */////4///§%
+ /*///3////§%
+ //*//////§%
+ ///*/////§%
+ ////*////§%
+ /////*///§%
+ //5*/////*/§%
+ /////B///*§%
+ *///9////Q/§%
+}
+
+\begin{PLenvsudomaths}[%
+ unite=0.66cm,police=\footnotesize\bfseries\ttfamily,couleurcase=ForestGreen!50,%
+ listelegv=QSDFGHJKL,listelegh=poiuytrez]{\grilleSuMaB}
+ \draw[red,very thick,<-] (7.5,-4.5) to[bend right] ++ (4,-1) node[right] {code rajouté...} ;
+\end{PLenvsudomaths}
+\end{codetex}
+
+\begin{codesortie}
+\def\grilleSuMaB{%
+ */////4///§%
+ /*///3////§%
+ //*//////§%
+ ///*/////§%
+ ////*////§%
+ /////*///§%
+ //5*/////*/§%
+ /////B///*§%
+ *///9////Q/§%
+}
+
+\begin{PLenvsudomaths}[%
+ unite=0.66cm,police=\footnotesize\bfseries\ttfamily,couleurcase=ForestGreen!50,%
+ listelegv=QSDFGHJKL,listelegh=poiuytrez]{\grilleSuMaB}
+ \draw[red,very thick,<-] (7.5,-4.5) to[bend right] ++ (4,-1) node[right] {code rajouté pour montrer la case \textsf{Ge}} ;
+ \foreach \x in {0,1,...,9} \draw[lightgray] (\x,-9) node[below,font=\scriptsize\ttfamily] {\x} ;
+ \foreach \y in {-1,-2,...,-9} \draw[lightgray] (9,\y) node[right,font=\scriptsize\ttfamily] {\y} ;
+ \draw[lightgray] (9,0) node[right,font=\scriptsize\ttfamily] {~0} ;
+\end{PLenvsudomaths}
+\end{codesortie}
+
+\newpage
+
\section{Historique}
+{\small \bverb|v1.2.6|~:~~~~Ajout d'un environnement pour des SudoMaths (page \pageref{sudomaths})
+
{\small \bverb|v1.2.5|~:~~~~Ajout de commandes pour des boîtes à moustaches (page \pageref{boiteamoustaches})
{\small \bverb|v1.2.4|~:~~~~Correction de quelques bugs mineurs, et mise à jour de la doc