diff options
author | Norbert Preining <norbert@preining.info> | 2023-06-28 03:01:13 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2023-06-28 03:01:13 +0000 |
commit | b5165768775a2cbc0577b7f8c532cc33d301c28f (patch) | |
tree | cbd889d0de6f6224cb5485c03afde29a2f5eaf89 /graphics/pgf | |
parent | a0b68c12d9e67182560eb31f202f3e86f0e4a5de (diff) |
CTAN sync 202306280301
Diffstat (limited to 'graphics/pgf')
-rw-r--r-- | graphics/pgf/contrib/rouequestions/doc/RoueQuestionsDoc.pdf | bin | 125630 -> 159544 bytes | |||
-rw-r--r-- | graphics/pgf/contrib/rouequestions/doc/RoueQuestionsDoc.tex | 242 | ||||
-rw-r--r-- | graphics/pgf/contrib/rouequestions/doc/test.png | bin | 0 -> 8377 bytes | |||
-rw-r--r-- | graphics/pgf/contrib/rouequestions/tex/RoueQuestions.sty | 77 |
4 files changed, 225 insertions, 94 deletions
diff --git a/graphics/pgf/contrib/rouequestions/doc/RoueQuestionsDoc.pdf b/graphics/pgf/contrib/rouequestions/doc/RoueQuestionsDoc.pdf Binary files differindex ee7acfc87c..abdbf414b4 100644 --- a/graphics/pgf/contrib/rouequestions/doc/RoueQuestionsDoc.pdf +++ b/graphics/pgf/contrib/rouequestions/doc/RoueQuestionsDoc.pdf diff --git a/graphics/pgf/contrib/rouequestions/doc/RoueQuestionsDoc.tex b/graphics/pgf/contrib/rouequestions/doc/RoueQuestionsDoc.tex index 2b866a5bde..97d3a73260 100644 --- a/graphics/pgf/contrib/rouequestions/doc/RoueQuestionsDoc.tex +++ b/graphics/pgf/contrib/rouequestions/doc/RoueQuestionsDoc.tex @@ -1,8 +1,5 @@ \documentclass[a4paper,12pt]{article} -%\input{inc/inc.tex} \usepackage{RoueQuestions} -%\usepackage{listingsutf8} -%\lstset{inputencoding=utf8/latin1} \usepackage[most]{tcolorbox} % pour les boites de propriétés/définition \usepackage{fancyhdr} @@ -12,7 +9,7 @@ \newtcolorbox{Consigne}[1][]{colback=blue!5!white, - colframe=blue,%fonttitle=\bfseries, + colframe=blue, title=\textbf{#1}} @@ -65,31 +62,68 @@ On imprime 2 roues : l'une d'elles comporte les questions et la consigne, l'autre comporte les réponses. On découpe les traits en pointillés et on colle sur la partie centrale les 2 feuilles l'une sur l'autre. On accroche un trombone sur chaque partie soulevable.\\[6pt] L'élève choisit une question et en cherche la réponse. Il soulève le volet pour vérifier. S'il a trouvé la bonne réponse, il gagne le trombone. En jouant à 2, en cas d'échec, l'adversaire gagne le trombone. A la fin de la partie, chacun compte le nombre de trombones gagnés.\\[12pt] - \verb|\usepackage{RoueQuestions}| pour utiliser le package. \\[6pt] -% \begin{Consigne}[Ajouter une roue] - \verb|\roueQuestions[options]{liste}| permet d'insérer une roue de questions. Il faudra l'appeler une 2ème fois pour générer la roue des solutions. \\[6pt] -% \end{Consigne} -% \begin{Consigne}[Les options] - \verb|LineWidth = 2pt| précise la largeur de la bordure.\\ - \verb|NbCases = 10| précise le nombre de questions. \\ - \verb|RayonCentral= 6| précise le rayon entre le centre et le début des cases (en cm). \\ - \verb|RayonTotal = 8| précise le rayon total de la roue (en cm). \\ - \verb|Consigne = {}| donne la consigne à écrire au centre de la roue. \\ - \verb|Titre = {}| indique le titre à mettre en gras. \\ - \verb|Decoupe = true| permet de tracer les traits de découpe en bleu \\ - \verb|Pliage = {}| permet de tracer les traits de pliage en vert. \\ - \verb|Solution = false| si faux, met les pointillés pour le découpage. \\[6pt] -%\end{Consigne} - - + Nouveautés : + \begin{enumerate} + \item[v0.0.2] \begin{itemize} + \item Correction documentation, Pliage est bien un booléen. + \item Retrait option NbCases puisqu'elle est calculée dans l'algorithme. + \item Ajout possibilité de générer les 2 roues en même temps avec \verb|\rouesQuestions[options]{liste}|. + \item Contrôle des aspects graphiques : ajout clés de couleurs et image de fond + \end{itemize} + \end{enumerate} + +% \setcounter{tocdepth}{1} % à remettre pour n'avoir que les sections + \tableofcontents + + \clearpage + \section{Utiliser le package} + \verb|\usepackage{RoueQuestions}| pour utiliser le package. + \section{Utiliser la roue} + \begin{center} + \verb|\roueQuestions[options]{liste}| + \end{center} + + permet d'insérer une roue de questions. Il faudra l'appeler une 2ème fois pour générer la roue des solutions ou utiliser \verb|\rouesQuestions[options]{liste}| (au pluriel). + \subsection{Clefs textes} + \begin{tabular}{|m{3cm}|m{3.5cm}|m{9.5cm}|} + \hline + Clé & Valeur par défaut & Rôle \\ \hline + \verb|Titre| & \verb|{}| & titre à mettre en gras. \\ \hline + \verb|Consigne| & \verb|{}| & consigne à écrire au centre de la roue. \\ \hline + \end{tabular} + \subsection{Clés de graphisme} + \begin{tabular}{|m{3cm}|m{3.5cm}|m{9.5cm}|} + \hline + Clé & Valeur par défaut & Rôle \\ \hline + \verb|LineWidth| & \verb|2pt| & largeur de la bordure.\\ \hline + \verb|RayonCentral| & \verb|6| & rayon entre le centre et le début des cases (en cm). \\ \hline + \verb|RayonTotal| & \verb|8| & rayon total de la roue (en cm). \\ \hline + \verb|BordureCouleur| & \verb|black| & couleur des traits en général \\ \hline + \verb|CasesCouleur| & \verb|white| & couleur de fond des cases de questions et réponses. \\ \hline + \verb|CentreCouleur| & \verb|white| & couleur de fond centrale. \\ \hline + \verb|Image| & \verb|{}| & Image de fond centrale. \\ \hline + \verb|ImageOpacite| & \verb|0.2| & Opacité de l'image ci-dessus. \\ \hline + \verb|Decoupe| & \verb|true| & permet de tracer ou non les traits de découpe en \verb|DecoupeCouleur|. \\ \hline + \verb|DecoupeCouleur| & \verb|blue| & couleur des traits de découpe \\ \hline + \verb|Pliage| & \verb|true| & permet de tracer ou non les traits de pliage en \verb|PliageCouleur|. \\ \hline + \verb|PliageCouleur| & \verb|green!30!black| & couleur des traits de pliage. \\ \hline + \end{tabular} + \subsection{Clef fonctionnelle} + \begin{tabular}{|m{3cm}|m{3.5cm}|m{9.5cm}|} + \hline + Clé & Valeur par défaut & Rôle \\ \hline + \verb|Solution| & \verb|false| & Si vrai, n'imprime pas les traits de pliage en \verb|PliageCouleur| ni les séparations des cases en \verb|DecoupeCouleur|. \\ \hline + \end{tabular} + \subsection{Liste des questions} +La \verb|liste| est une liste de valeurs séparées par des virgules. \newtcblisting{mybox}[2][]{% colback=red!5!white, colframe=red!75!black, fonttitle=\bfseries, title={#2},#1} -\begin{mybox}[listing only]{Exemple} -\roueQuestions[RayonCentral=4.2,RayonTotal=6,Titre={Puissances},Consigne={Ecrire sous la forme $a^n$, où $a$ est un nombre relatif et $n$ un entier relatif.}]{% +\begin{mybox}{Exemple avec 10 cases} +\roueQuestions[Titre={Puissances},Consigne={Ecrire sous la forme $a^n$, où $a$ est un nombre relatif et $n$ un entier relatif.}]{% $5^{-7}\times 5^{-3}$,% $6^{12}\times 6^{-10}$,% $\dfrac{21^{-13}}{21^{10}}$,% @@ -101,24 +135,29 @@ $\dfrac{9^{-3}}{(-\num{2.5})^{-3}}$,% $10^5\times\left(10^7\right)^8$% } -\vspace{-0.3cm} -\begin{flushright} - \roueQuestions[RayonCentral=4.2,RayonTotal=6,Consigne={Cette partie est encollée et placée sous la consigne de la première roue.},Solution]{% - $5^{-10}$,% - $6^2$,% - $21^{-23}$,% - $2^7$,% - $\left(-3\right)^{-4}$,% - $7^{52}$,% - $10^{-7}$,% - $\left(-4\right)^{-6}$,% - $\left(-\num{3,6}\right)^{-3}$,% - $10^{61}$% - } -\end{flushright} \end{mybox} -\roueQuestions[RayonCentral=4.2,RayonTotal=6,Titre={Puissances},Consigne={Ecrire sous la forme $a^n$, où $a$ est un nombre relatif et $n$ un entier relatif.}]{% +\begin{mybox}{Exemple avec 9 cases} +\roueQuestions[Titre={Puissances},Consigne={Ecrire sous la forme $a^n$, où $a$ est un nombre relatif et $n$ un entier relatif.}]{% + $5^{-7}\times 5^{-3}$,% + $6^{12}\times 6^{-10}$,% + $\dfrac{21^{-13}}{21^{10}}$,% + $\dfrac{2^{-4}\times 2^9}{2^5\times 2^{-7}}$,% + $\dfrac{\left((-3)^4\right)^{-2}\times (-3)}{(-3)^{-3}}$,% + $\left(\dfrac{7^{13}\times 7^ {-9}}{7^{-14}\times 7^{-8}}\right)^2$,% + $\num{2.5}^{-7}\times 4^{-7}$,% + $-4\times (-4)^{-7}$,% + $\dfrac{9^{-3}}{(-\num{2.5})^{-3}}$% +} +\end{mybox} + +\clearpage + \section{Générer les deux roues} + \subsection{Manuellement} + Une première méthode consiste à générer la roue d'énoncé et la roue de solutions de façon personnalisée : (code qui a permis de générer la 1ère page) + +\begin{mybox}[listing only]{Méthode 1} +\roueQuestions[RayonCentral=4.2,RayonTotal=5.8,Titre={Puissances},Consigne={Ecrire sous la forme $a^n$, où $a$ est un nombre relatif et $n$ un entier relatif.},Decoupe=false,Pliage=false]{% $5^{-7}\times 5^{-3}$,% $6^{12}\times 6^{-10}$,% $\dfrac{21^{-13}}{21^{10}}$,% @@ -132,45 +171,90 @@ } \vspace{-0.3cm} \begin{flushright} - \roueQuestions[RayonCentral=4.2,RayonTotal=6,Consigne={Cette partie est encollée et placée sous la consigne de la première roue.},Solution]{% - $5^{-10}$,% - $6^2$,% - $21^{-23}$,% - $2^7$,% - $\left(-3\right)^{-4}$,% - $7^{52}$,% - $10^{-7}$,% - $\left(-4\right)^{-6}$,% - $\left(-\num{3,6}\right)^{-3}$,% - $10^{61}$% - } -\end{flushright} +\roueQuestions[RayonCentral=4.2,RayonTotal=5.8,Consigne={Cette partie est encollée et placée sous la consigne de la première roue.},Solution,Decoupe=false]{% + $5^{-10}$,% + $6^2$,% + $21^{-23}$,% + $2^7$,% + $\left(-3\right)^{-4}$,% + $7^{52}$,% + $10^{-7}$,% + $\left(-4\right)^{-6}$,% + $\left(-\num{3,6}\right)^{-3}$,% + $10^{61}$% +} +\end{flushright} +\end{mybox} + +Cela permet de faire la mise en page qu'on souhaite. +\clearpage +\subsection{Automatiquement} +La 2ème méthode est d'utiliser \verb|\RouesQuestions| (donc au pluriel). Dans ce cas, les 2 roues sont décalées gauche et droite avec \verb|flushright| avec un espace de \verb|EspaceRoues| (nouvelle option de valeur par défaut \verb|-0.3cm|). Les 2 consignes sont dans \verb|Consigne| (énoncés) et dans \verb|Conseil| (solutions). Il faut également donner la liste de réponses : + +\begin{center} + \verb|\RouesQuestions[options]{listeQuestions}{listeRéponses}| +\end{center} + +Toutes les clefs de \verb|\RoueQuestions| s'appliquent, avec en plus :\\[6pt] + +\begin{tabular}{|m{3cm}|m{3.5cm}|m{9.5cm}|} + \hline + Clé & Valeur par défaut & Rôle \\ \hline + \verb|Consigne| & \verb|{}| & consigne à écrire au centre de la roue des énoncés. \\ \hline + \verb|Conseil| & \verb|{}| & consigne à écrire au centre de la roue des solutions. \\ \hline + \verb|EspaceRoues| & \verb|-0.5cm| & espace entre la roue énoncés et la roue solutions \\ \hline +\end{tabular}\\[12pt] +La \verb|listeQuestions| est une liste de valeurs séparées par des virgules.\\ +La \verb|listeRéponses| est une liste de valeurs séparées par des virgules. + + +\begin{mybox}[listing only]{Méthode 2} +\rouesQuestions[RayonCentral=4.2,RayonTotal=5.8,Titre={Puissances},Consigne={Ecrire sous la forme $a^n$, où $a$ est un nombre relatif et $n$ un entier relatif.},Conseil={Cette partie est encollée et placée sous la consigne de la première roue.},Decoupe=true,Pliage=true,DecoupeCouleur=violet,PliageCouleur=orange]{% + $5^{-7}\times 5^{-3}$,% + $6^{12}\times 6^{-10}$,% + $\dfrac{21^{-13}}{21^{10}}$,% + $\dfrac{2^{-4}\times 2^9}{2^5\times 2^{-7}}$,% + $\dfrac{\left((-3)^4\right)^{-2}\times (-3)}{(-3)^{-3}}$,% + $\left(\dfrac{7^{13}\times 7^ {-9}}{7^{-14}\times 7^{-8}}\right)^2$,% + $\num{2.5}^{-7}\times 4^{-7}$,% + $-4\times (-4)^{-7}$,% + $\dfrac{9^{-3}}{(-\num{2.5})^{-3}}$,% + $10^5\times\left(10^7\right)^8$% +}{% + $5^{-10}$,% + $6^2$,% + $21^{-23}$,% + $2^7$,% + $\left(-3\right)^{-4}$,% + $7^{52}$,% + $10^{-7}$,% + $\left(-4\right)^{-6}$,% + $\left(-\num{3,6}\right)^{-3}$,% + $10^{61}$% +} +\end{mybox} -%\roueQuestions[RayonCentral=4.2,RayonTotal=6.5,Titre={Puissances},Consigne={Ecrire sous la forme $a^n$, où $a$ est un nombre relatif et $n$ un entier relatif.}]{% -% $5^{-7}\times 5^{-3}$,% -% $6^{12}\times 6^{-10}$,% -% $\dfrac{21^{-13}}{21^{10}}$,% -% $\dfrac{2^{-4}\times 2^9}{2^5\times 2^{-7}}$,% -% $\dfrac{\left((-3)^4\right)^{-2}\times (-3)}{(-3)^{-3}}$,% -% $\left(\dfrac{7^{13}\times 7^ {-9}}{7^{-14}\times 7^{-8}}\right)^2$,% -% $\num{2.5}^{-7}\times 4^{-7}$,% -% $-4\times (-4)^{-7}$,% -% $\dfrac{9^{-3}}{(-\num{2.5})^{-3}}$,% -% $10^5\times\left(10^7\right)^8$% -%} -%\vspace{-0.5cm} -%\begin{flushright} -% \roueQuestions[RayonCentral=4.2,RayonTotal=6.5,Consigne={Cette partie est encollée et placée sous la consigne de la première roue.},Solution]{% -% $5^{-10}$,% -% $6^2$,% -% $21^{-23}$,% -% $2^7$,% -% $\left(-3\right)^{-4}$,% -% $7^{52}$,% -% $10^{-7}$,% -% $\left(-4\right)^{-6}$,% -% $\left(-\num{3,6}\right)^{-3}$,% -% $10^{61}$% -% } -%\end{flushright} +\clearpage\rouesQuestions[RayonCentral=4.2,RayonTotal=5.8,Titre={Puissances},Consigne={Ecrire sous la forme $a^n$, où $a$ est un nombre relatif et $n$ un entier relatif.},Conseil={Cette partie est encollée et placée sous la consigne de la première roue.},Decoupe=true,Pliage=true,DecoupeCouleur=violet,PliageCouleur=orange,Image=test]{% + $5^{-7}\times 5^{-3}$,% + $6^{12}\times 6^{-10}$,% + $\dfrac{21^{-13}}{21^{10}}$,% + $\dfrac{2^{-4}\times 2^9}{2^5\times 2^{-7}}$,% + $\dfrac{\left((-3)^4\right)^{-2}\times (-3)}{(-3)^{-3}}$,% + $\left(\dfrac{7^{13}\times 7^ {-9}}{7^{-14}\times 7^{-8}}\right)^2$,% + $\num{2.5}^{-7}\times 4^{-7}$,% + $-4\times (-4)^{-7}$,% + $\dfrac{9^{-3}}{(-\num{2.5})^{-3}}$,% + $10^5\times\left(10^7\right)^8$% +}{% + $5^{-10}$,% + $6^2$,% + $21^{-23}$,% + $2^7$,% + $\left(-3\right)^{-4}$,% + $7^{52}$,% + $10^{-7}$,% + $\left(-4\right)^{-6}$,% + $\left(-\num{3,6}\right)^{-3}$,% + $10^{61}$% +} \end{document} diff --git a/graphics/pgf/contrib/rouequestions/doc/test.png b/graphics/pgf/contrib/rouequestions/doc/test.png Binary files differnew file mode 100644 index 0000000000..80f302ba78 --- /dev/null +++ b/graphics/pgf/contrib/rouequestions/doc/test.png diff --git a/graphics/pgf/contrib/rouequestions/tex/RoueQuestions.sty b/graphics/pgf/contrib/rouequestions/tex/RoueQuestions.sty index de436801d5..e3d94f4c0a 100644 --- a/graphics/pgf/contrib/rouequestions/tex/RoueQuestions.sty +++ b/graphics/pgf/contrib/rouequestions/tex/RoueQuestions.sty @@ -1,44 +1,85 @@ % Author : M. Vignal % License : Released under the LaTeX Project Public License v1.3c or later, see http://www.latex-project.org/lppl.txt -\ProvidesPackage{RoueQuestions}[2023/06/25 0.0.1 Aide pour générer des roues de questions] +\ProvidesPackage{RoueQuestions}[2023/06/27 0.0.2 Aide pour générer des roues de questions] \RequirePackage{tikz} \RequirePackage{simplekv} \RequirePackage{listofitems} +\RequirePackage{ifthen} \setKVdefault[roueQuestions]{ + Titre = {}, + Consigne = {}, + Conseil = {}, LineWidth = 2pt, - NbCases = 10, RayonCentral= 6, RayonTotal = 8, - Consigne = {}, - Titre = {}, - Solution = false, + BordureCouleur=black, + CasesCouleur=white, + CentreCouleur=white, + Image = {}, + ImageOpacite= 0.2, Decoupe = true, - Pliage = true + DecoupeCouleur=blue, + Pliage = true, + PliageCouleur=green!30!black, + Solution = false, + EspaceRoues = -0.5cm } \newcommand{\roueQuestions}[2][]{% \restoreKV[roueQuestions] %paramètres par défaut \setKV[roueQuestions]{#1} % lecture des paramètres passés à la macro et remplacement des valeurs - \pgfmathparse{360/\useKV[roueQuestions]{NbCases}}\let\angle\pgfmathresult + \readlist*\listeequations{#2}% + \pgfmathparse{int(\listeequationslen)}\let\nbequations\pgfmathresult% + \pgfmathparse{360/\nbequations}\let\angle\pgfmathresult \pgfmathparse{\useKV[roueQuestions]{RayonCentral}}\let\RayonCentral\pgfmathresult \pgfmathparse{\useKV[roueQuestions]{RayonTotal}}\let\RayonTotal\pgfmathresult \pgfmathparse{(2*\RayonCentral+\RayonTotal)/3}\let\RayonTexte\pgfmathresult \pgfmathparse{(4*\RayonCentral)/3}\let\LargeurTexte\pgfmathresult \edef\LineWidth{\useKV[roueQuestions]{LineWidth}} - \readlist*\listeequations{#2}% - \def\nbequations{\inteval{\listeequations-1}}% - \begin{tikzpicture} - \foreach \n in {1,...,\useKV[roueQuestions]{NbCases}}{% + \edef\Image{\useKV[roueQuestions]{Image}} + \pgfmathparse{\useKV[roueQuestions]{ImageOpacite}}\let\ImageOpacite\pgfmathresult + \edef\DecoupeCouleur{\useKV[roueQuestions]{DecoupeCouleur}} + \edef\PliageCouleur{\useKV[roueQuestions]{PliageCouleur}} + \edef\CasesCouleur{\useKV[roueQuestions]{CasesCouleur}} + \edef\CentreCouleur{\useKV[roueQuestions]{CentreCouleur}} + \edef\BordureCouleur{\useKV[roueQuestions]{BordureCouleur}} +% + \ifboolKV[roueQuestions]{Solution}{% + \vspace{\useKV[roueQuestions]{EspaceRoues}} + }{} +% + \begin{tikzpicture}[remember picture] + \foreach \n in {1,...,\nbequations}{% + %pour masquer ce qui dépasse du scope + \filldraw[\CentreCouleur] (0,0) -- (\angle*\n:\RayonCentral) -- (\angle*\n+\angle:\RayonCentral) -- cycle; + } + %scope + \begin{scope} + \clip (0,0) circle (\RayonCentral); + \ifthenelse{\equal{\Image}{}}{}{% + c{}{ + %\filldraw[blue] (-7,-7) rectangle (7,7); + %ajout image + \node[opacity=\ImageOpacite] (centre) at(0,0) {\includegraphics[]{\Image}}; + } + } + \end{scope} + + \foreach \n in {1,...,\nbequations}{% + %pour masquer ce qui dépasse du scope + \filldraw[\CasesCouleur] (\angle*\n-\angle:\RayonCentral) -- (\angle*\n-\angle:\RayonTotal) -- (\angle*\n:\RayonTotal) -- (\angle*\n:\RayonCentral) -- cycle; + } + \foreach \n in {1,...,\nbequations}{% \ifboolKV[roueQuestions]{Decoupe}{% - \edef\couleurExt{blue} + \edef\couleurExt{\DecoupeCouleur} }{% - \edef\couleurExt{black} + \edef\couleurExt{\BordureCouleur} } \ifboolKV[roueQuestions]{Pliage}{% - \edef\couleurPli{green!30!black} + \edef\couleurPli{\PliageCouleur} }{% - \edef\couleurPli{black} + \edef\couleurPli{\BordureCouleur} } % intérieur vers extérieur \ifboolKV[roueQuestions]{Solution}{% @@ -59,3 +100,9 @@ \node[text width=\LargeurTexte cm,text justified] at(0,0) {\useKV[roueQuestions]{Consigne}}; \end{tikzpicture} } +\newcommand{\rouesQuestions}[3][]{% + \roueQuestions[#1]{#2} + \begin{flushright} + \roueQuestions[#1,Solution]{#3} + \end{flushright} +} |