summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/alterqcm/doc/latex/doc-aq-def.tex
blob: 5261f75cd80ef396820292511819eba955e2f157 (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
\section{Tools: The environment \tkzname{alterqcm} and the macro \tkzcname{AQquestion}}
\subsection{Environment \tkzname{alterqcm}}


\bigskip
\begin{NewEnvBox}{alterqcm}

\noindent Here is the list of available \tkzname{options} classified by category.

\medskip
\begin{tabular}{@{}Il Il Il@{}}
  \toprule
  \thead
Options                &Default & Definition                                \\ \midrule
\tbody
\multicolumn{2}{c}{\emph{\texttt{Dimensions}}} \\ \cmidrule(r){1-2}
\TOenvline{lq}        {100mm}  {width of the question column            }
\TOenvline{pq}        {0pt}    {vertical shift of the question       } \cmidrule(r){1-2}
\multicolumn{2}{c}{\emph{\texttt{Numbers}}} \\ \cmidrule(r){1-2}
\TOenvline{bonus}     {{0,5}}  {points for a correct answer      }
\TOenvline{malus}     {{0,25}} {points for wrong answer   }
\TOenvline{numbreak}  {0}    {to take over a split board          }
\TOenvline{points}  {empty}{ points awarded to the qcm in the margin} \cmidrule(r){1-2}
\multicolumn{2}{c}{\emph{\texttt{Macros}}} \\ \cmidrule(r){1-2}
\TOenvline{symb}      {\$\BS square\$} {symbol in front of the proposal     }
\TOenvline{corsymb}{\$\BS blacksquare\$}{symbol in front of the proposal    }
\TOenvline{numstyle}  {\BS arabic} {style of question numbering  }
\TOenvline{propstyle} {\BS alph} {style of proposal numbering }
\TOenvline{size}  {\BS normalsize} {font size           }
\TOenvline{afterpreskip}{\BS medskip} {skip after the presentation  }
\cmidrule(r){1-2}
\multicolumn{2}{c}{\emph{\texttt{Booleans}}} \\ \cmidrule(r){1-2}
\TOenvline{long} {true}     {longtable instead of tabular   }
\TOenvline{sep} {true}  {proposal separator}
\TOenvline{pre} {false}  {MCQ presentation          }
\TOenvline{VF} {false}  {MCQ in the form True or False }
\TOenvline{numprop}   {false}  {proposal numbering    }
\TOenvline{num}       {true}   {style of question numbering  }
\TOenvline{nosquare}  {false}   {sremoving the square of proposals     }
\TOenvline{title}     {false} {title suppression                    }
\TOenvline{correction}{false} {allows you to create an answer sheet                }
\TOenvline{alea}      {false}  {randomly place proposals     } \cmidrule(r){1-2}
\multicolumn{2}{c}{\emph{\texttt{Texts}}} \\ \cmidrule(r){1-2}
\TOenvline{tone}     {Questions} {column title 1                           }
\TOenvline{ttwo}     {R\'eponses} {column title 2     }
\TOenvline{language}  {french}  {french, english, german, greek, russian, italian, chinese, unknown }
 \bottomrule
\end{tabular}

\medskip

To create a \textcolor{red}{\texttt{MCQ}} use a \textcolor{red}{\texttt{alterqcm}} environment as well as the \textcolor{red}{ \addbs{AQquestion}} macro defined in the next section.
\end{NewEnvBox}

\subsection{The macro \tkzcname{AQquestion}}
\Imacro{AQquestion}

\begin{NewMacroBox}{AQquestion}{\oarg{local options}{\var{quest}}\{{\var{$\mathrm{prop}_1$}},\ldots,{\var{$\mathrm{prop}_n$}}\}}
This macro uses two arguments, the first defines the question, the second is a list that defines the propositions.

\medskip
\begin{tabular}{@{}Il Il Il@{}}  \toprule \thead
arguments                 & default & definition    \\
\midrule
\tbody
\TAline{quest}  {}     {issue definition}
\TAline{$\mathrm{prop}_i$}  {}     {i\th\ proposition}       \bottomrule
\end{tabular}

\medskip
Here is the list of options related to this macro.

\medskip
\begin{tabular}{@{}Il Il Il@{}}  \toprule \thead
options                 & default & definition                    \\ \midrule
\tbody
\TOline{pq}  {0pt}     {adjustment of the position of the question}
\TOline{br}  {1  }     {ranked list of correct answers  }           \bottomrule
\end{tabular}

\medskip

\end{NewMacroBox}




 \subsection{Using the \tkzname{minipage} environment to change the width of the table}
\Ienv{minipage}

\tkzHandBomb\ \begin{minipage}[c][][t]{.4\linewidth}
\begin{tkzltxexample}[small]
\begin{center}
\begin{minipage}{9cm}
\begin{alterqcm}[lq=5cm]
    ...
  \end{alterqcm}
\end{minipage}
\end{center}
\end{tkzltxexample}
\end{minipage}

\begin{minipage}[c][][t]{.6\linewidth}
\begin{alterqcm}[lq=5cm]
\AQquestion{Among the following proposals, which of the following allows for 
 to affirm that the exponential function admits for asymptote the right 
  from the equation $y = 0$?}
{%
{$\displaystyle\lim_{x \to +\infty} \text{e}^x = + \infty$},%
{$\displaystyle\lim_{x \to -\infty} \text{e}^x = 0$},%
{$\displaystyle\lim_{x \to +\infty} \dfrac{\text{e}^x}{x} = + \infty$}%
}

\AQquestion[]{exp$(\ln x) = x$ for any $x$ belonging to }
{%
{$\mathbf{R}$},%
{$\big]0~;~+ \infty\big[$},%
{$\big[0~;~+\infty\big[$}%
}\end{alterqcm}
\end{minipage}
%

\subsection{Temporary modification of \tkzcname{textwidth}}
\Imacro{textwidth}
 It is possible to use tables and other structures in the question code or proposals. An example is shown below:
 \newlength{\oldtextwidth}
\tkzHandBomb\ \begin{tkzltxexample}[small]
  \newlength{\oldtextwidth}
\end{tkzltxexample}

\medskip
  \setlength{\oldtextwidth}{\textwidth}
  \setlength{\textwidth}{14cm}
\begin{alterqcm}[language=english,lq=88mm,symb=$\Box$]
 \AQquestion{the matrix 
 \( M=\begin{pmatrix}
        0 & 1 \\
        1 & 1 \\
\end{pmatrix} \)  has for square}%
{%
{\(\begin{pmatrix}
        0 & 1 \\
        1 & 4 \\
\end{pmatrix}\)},%
{\(\begin{pmatrix}
        1 & 2 \\
        2 & 5 \\
 \end{pmatrix}\)}
}
\end{alterqcm}
\setlength{\textwidth}{\oldtextwidth}

\medskip
\begin{tkzltxexample}[small]
  \setlength{\oldtextwidth}{\textwidth}
  \setlength{\textwidth}{14cm}
 \begin{alterqcm}[language=english,lq=88mm,symb=$\Box$]
  \AQquestion{la matrice %
  \( M=\begin{pmatrix}
         0 & 1 \\
         1 & 1 \\
 \end{pmatrix} \)  a pour carré}%
 {%
 {\(\begin{pmatrix}
         0 & 1 \\
         1 & 4 \\
 \end{pmatrix}\)},%
 {\(\begin{pmatrix}
         1 & 2 \\
         2 & 5 \\
  \end{pmatrix}\)}
 }
 \end{alterqcm}
 \setlength{\textwidth}{\oldtextwidth}
\end{tkzltxexample}

\endinput