summaryrefslogtreecommitdiff
path: root/graphics/pgf/contrib/rouequestions/doc/RoueQuestionsDoc.tex
blob: 0f7870f2a10bdc30bfa151268d742e4dbbc05fc0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
\documentclass[a4paper,12pt]{article}
\usepackage{RoueQuestions}
\usepackage[most]{tcolorbox} % pour les boites de propriétés/définition

\usepackage{fancyhdr}
\usepackage{siunitx}
\usepackage{geometry}
\geometry{hmargin=1.5cm,vmargin=2.5cm}


\newtcolorbox{Consigne}[1][]{colback=blue!5!white,
	colframe=blue,
	title=\textbf{#1}}


\begin{document}
	% En-têtes et pieds de pages
	\pagestyle{fancy}
	\setlength{\headheight}{25pt}
	\fancyhead[L]{Maryline Vignal}
	\fancyhead[R]{RoueQuestions}
	\renewcommand{\footrulewidth}{1pt}
	\fancyfoot[C]{ } 
	\fancyfoot[R]{page \textbf{\thepage}} 
	\fancyfoot[L]{ }
	\setcounter{page}{1}

	\begin{center}
		\textbf{Roues de questions}
	\end{center}
	
\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}}$,%
	$\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.3cm}
\begin{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}		
	
\clearpage	
	Ce package permet de générer des roues de questions. Il a été imaginé pour des jeux en mathématiques mais peut servir à d'autres applications.\\[6pt]
	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]
	
	Nouveautés :
	\begin{enumerate}
		\item[v0.0.3] \begin{itemize}
			\item Correction de la position des questions et réponses dans la roue (utilisation de \verb|tkz-euclide|)
			\item Correction du code relatif à l'apparition du conseil sur la 2ème roue générée par
			
			\hfil\verb|\rouesQuestions[options]{liste}|.
		\end{itemize}
		\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
			
			\hfil\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}{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}}$,%
	$\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$%
}
\end{mybox}

\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}}$,%
	$\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.3cm}
\begin{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}

\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}