Debian Codegraph @

texmf-dist/source/latex/verifiche/verifiche.dtx

raw
1 % \iffalse meta-comment
2 %
3 % Copyright (LPPL) 2020 - 2026 by Francesco Raccanello
4 %
5 % This file may be distributed and/or modified under the
6 % conditions of the LaTeX Project Public License, either
7 % version 1.3 of this license or any later version.
8 % The latest version of this license is in:
9 %
10 % http://www.latex-project.org/lppl.txt
11 %
12 % and version 1.3 or later is part of all distributions of
13 % LaTeX version 2005/12/01 or later.
14 %
15 % \fi
16 %
17 % \iffalse
18 %<package>\NeedsTeXFormat{LaTeX2e}
19 %<package>\ProvidesPackage{verifiche} [2026/05/05 v9.4 .dtx verifiche file]
20 %<*driver>
21 \documentclass{ltxdoc}
22 \usepackage[utf8]{inputenc}
23 \usepackage[T1]{fontenc}
24 \usepackage[english, italian]{babel}
25 \usepackage{tcolorbox}
26 \tcbuselibrary{listings, skins}
27 \usepackage{xparse}
28 \usepackage[solutions]{verifiche}
29 \lstset{%
30 language=[LaTeX]TeX,
31 morekeywords={\setlength, \institute, \asyear, \testtype, \instruction, \testduration, \printheading,
32 \institutefont, \asyearfont, \testtypefont, \instructiondelimiter, \headerfont, \instrunctionfont,
33 \testdurationfont, \exerciselabel, \solutionfont, \solutionlabel, \diffsymb, \closedquestionitem,
34 \inlinesol, \completetext, \truefalse, \openquestion, \linedopenquestion, \squaredopenquestion,
35 \headercandidatenamelabel, \checked, \finderror, \textandimage, \partialpt, \ptprefix, \ptlabel,
36 \partialptlabel, \partialptdelimiters, \ptdelimiters, \partialptprefix, \checkmaker, \ref, \tikz, \makecolumn,
37 \columnseparation, \subtitle, \subtitlefont, \ptfont, \defineheadingstyle, \headingstyle, \sitem},
38 keywordstyle=\color{blue},
39 escapeinside={*@}{@*},
40 inputencoding=utf8,
41 basicstyle=\small\ttfamily}
42 %
43 \newcounter{id}
44 \NewTCBListing{sourcecode}{}{
45 before={},
46 after={\hfill},
47 width=.597\textwidth,
48 equal height group=\theid,
49 title={Esempio di codice},
50 sharp corners=east,
51 leftupper=.5ex,
52 halign=left,
53 listing only,
54 listing options={%
55 language={[LaTeX]TeX},
56 morekeywords={\setlength, \institute, \asyear, \testtype, \instruction, \testduration, \printheading,%
57 \institutefont, \asyearfont, \testtypefont, \instructiondelimiter, \headerfont, \instrunctionfont,%
58 \testdurationfont, \exerciselabel, \solutionfont, \solutionlabel, \diffsymb, \closedquestionitem,%
59 \inlinesol, \completetext, \truefalse, \openquestion, \linedopenquestion, \squaredopenquestion,%
60 \headercandidatenamelabel, \checked, \finderror, \textandimage, \partialpt, \sumpoints, \ptprefix, \ptlabel,%
61 \partialptlabel, \partialptdelimiters, \ptdelimiters, \partialptprefix, \checkmaker, \ref, \tikz, \makecolumn,%
62 \columnseparation, \subtitle, \subtitlefont, \ptfont, \defineheadingstyle, \headingstyle, \sitem},
63 keywordstyle=\color{blue},
64 basicstyle=\small\ttfamily
65 }
66 }%
67 \NewTColorBox{render}{}{
68 before={},
69 after={\\},
70 width=.397\textwidth,
71 colback=red!5!white,colframe=red!75!black,
72 equal height group=\theid,
73 title={Esempio visivo},
74 sharp corners=west,
75 halign=left,
76 }
77 \NewDocumentEnvironment{example}{m m}{}{}
78 %
79 \EnableCrossrefs
80 \CodelineIndex
81 \RecordChanges
82 \parindent0pt
83 \shuffleseed{42}
84 \begin{document}
85 \DocInput{verifiche.dtx}
86 \end{document}
87 %</driver>
88 % \fi
89 %
90 % \CheckSum{1393}
91 % \changes{v1.0}{2020/06/14}{Initial version.}
92 % \changes{v2.0}{2020/06/26}{Better performance in exercise environment.}
93 % \changes{v2.1}{2020/06/30}{Introduced closedquestionitem to control |item| symbol.}
94 % \changes{v2.2}{2020/07/01}{Modify reference to points of an exercise.}
95 % \changes{v3.0}{2021/02/14}{Remove fancyhdr and introduce a new page style. Improve the printheading command.}
96 % \changes{v4.0}{2021/02/15}{Introduce comando to change the aspect of the exercise score.}
97 % \changes{v4.1}{2021/02/16}{Introduce ptrulerlength to change the aspect of the exercise score.}
98 % \changes{v4.2}{2021/08/18}{Solved truefalse issue in solutionsmode. Add noexercisept global option to hide the score of each exercise.}
99 % \changes{v4.3}{2022/02/10}{Move |parindent{0pt}| inside the environment.}
100 % \changes{v4.4}{2022/03/10}{Minor update. Fixed labels issues.}
101 % \changes{v5.0}{2022/05/18}{Major update. Remove some unnecessary packages. Remove spurious space in closedquestion environment. Add a starred version of closedquestion environment. Add the possibility to add local label to soluzione environment. Add a new command: makecolumn.}
102 % \changes{v5.1}{2022/06/16}{Minor update. Clean the code for printheading command; better appearance for openquestion command.}
103 % \changes{v5.2}{2022/06/21}{Minor update. Resolve bugs in printheading command.}
104 % \changes{v7.0}{2023/08/22}{Major update. Remove some unnecessary packages. Add ptfont command to manage points font. Modify environments to avoid page break after the name of the environment. Adding the possibility to define own heading aspect. Define three types of headings: galilei, einstein and cattaneo.}
105 % \changes{v7.1}{2024/02/05}{Minor update. Add ptfont to partialpt.}
106 % \changes{v8.0}{2024/11/27}{Major update. Add sumpoints instead of partialpt (that remain defined for legacy reason). The partial points, now, can be decimal. Adding shuffled itemize, enumerate and closedquestion environment.}
107 % \changes{v9.0}{2025/12/01}{Major update. Multiple choices question now can show letter, arabic number or roman number.}
108 % \changes{v9.1}{2025/12/02}{Minor update. Bugs fix.}
109 % \changes{v9.2}{2025/12/02}{Minor update. Change duration command (defined in a new version of siunitix with testduration (durationfont-> testdurationfont).}
110 % \changes{v9.3}{2025/12/05}{Minor update. Fix bugs with multitest and printheading.}
111 % \changes{v9.4}{2025/12/05}{Minor update. Fix multitest issues.}
112 % \GetFileInfo{verifiche.sty}
113 % \DoNotIndex{\newcommand,\newenvironment,\def,\begin,\end,\par}
114 % \DoNotIndex{\DeclareOption,\ExecuteOptions,\ProcessOptions,\RequirePackage}
115 % \DoNotIndex{\LoadClass,\AtBeginDocument,\SetSymbolFont}
116 % \DoNotIndex{\tiny, \scriptsize, \footnotesize, \normalfont, \large, \Large, \Large, \huge, \Huge}
117 % \DoNotIndex{\newif,\geometry,\pagestyle,\setISOcompliance,\IntelligentComma}
118 % \DoNotIndex{\relax,\let,\phi,\theta,\varphi,\vartheta,\else,\fi,\undefined}
119 % \DoNotIndex{\renewcommand,\newlength,\hline,\textbf,\textit,\\,\setlength}
120 % \DoNotIndex{\DeclarePairedDelimiter,\MakeUppercase,\MessageBreak,\ClassError}
121 % \DoNotIndex{\widthof,\textwidth,\ifdefined,\null,\vspace,\noindent,\hfill}
122 % \DoNotIndex{\hrulefill,\makebox,\linewidth,\small,\centering,\lvert,\rvert}
123 % \DoNotIndex{\newunicodechar,\ensuremath,\circ,\textsuperscript,\,}
124 % \DoNotIndex{\varepsilon,\delta,\Delta,\displaystyle,\mathbb,\arraystretch}
125 % \DoNotIndex{\bm,\box,\DeclareFontShape,\DeclareFontFamily,\DeclareMathAccent}
126 % \DoNotIndex{\DeclareSymbolFont,\doublespacing,\frac,\mathstrut,\bfseries}
127 % \DoNotIndex{\usefont,\symbol,\mathpalette,\sbox,\vbox,\hbox,\box}
128 % \DoNotIndex{\m@th,\wd,\resizebox,\height,\nointerlineskip,\mathord}
129 % \DoNotIndex{\mathrm,\labelitemi,\blacktriangleright,\textup,\fbox,\parbox}
130 % \DoNotIndex{\alph,\newlist,\renewlist,\setlist,\hspace,\iflanguage,\protect}
131 % \DoNotIndex{\ifdim,\newcounter,\newsavebox,\savebox,\setcounter,\linenumbers}
132 % \DoNotIndex{\thelinenumbers,\addtocounter,\multido,\i,\phantom,\newline}
133 % \DoNotIndex{\value,\leavevmode,\leaders,\hss,\kern,\real,\tabcolsep,\space}
134 % \DoNotIndex{\doublespacing,\singlespacing,\@nil,\@nnil,\vphantom,\today}
135 % \DoNotIndex{\nolinebreak,\null,\textsc,\ifx,\tmp,\mbox,\vfill,\LARGE,\Huge}
136 % \DoNotIndex{\enitkv@key,\item,\@ifpackageloaded,\@ifpackagewith}
137 % \DoNotIndex{\addvspace, \baselineskip, \bgroup, \cdot, \color, \CurrentOption}
138 % \DoNotIndex{\DeclareOptionX, \define@choicekey, \define@key, \draw, \egroup}
139 % \DoNotIndex{\ExectureOptionsX, \fill, \foreach, \gdef, \ifmmode, \IfSubStr, \IfValueT}
140 % \DoNotIndex{\ignorespaces, \ignorespacesafterend, \item, \itshape, \marginpar, \marginparwidth, \mathit}
141 % \DoNotIndex{\NewDocumentCommand, \NewDocumentEnvironment, \newlabel, \nobreak, \node, \nr}
142 % \DoNotIndex{\or, \overset, \PackageError, \PackageWarning, \parindent, \pgfmathparse, \pgfmathresult}
143 % \DoNotIndex{\ProcessOptionsX, \protected@write, \ref, \refstepcounter, \reversemarginpar, \rule}
144 % \DoNotIndex{\scshape, setkeys, \sffamily, \sisetup, \spacedim, \string, \tikz, \underline, \usetikzlibrary}
145 % \DoNotIndex{\val, \xout, \y, \usebox, \romannumeral, \@ifundefined, \ltx@zero, \rc@default, \rc@extract@, \chardef, \llap}
146 % \DoNotIndex{\toks1}
147 %
148 %
149 % \title{Il pacchetto \textsf{verifiche}%
150 % \thanks{Questo documento corrisponde al pacchetto \textsf{verifiche}~\fileversion,
151 % in data~\filedate.}
152 %\\ {\normalsize \fileversion}}
153 % \author{Francesco Raccanello\\ \texttt{[email protected]}}
154 %
155 % \maketitle
156 %\begin{otherlanguage}{english}
157 %\begin{abstract}
158 % The aim of this package is to manage the elements of a middle or hight school test. It can compose the headings of the page, the exercises and their solutions. The exercises can show numerical ID, difficulty and score.
159 % The package manages some standard test typology: plain exercise, complete-the-text, true or false, open questions, closed questions, find-the-error.
160 %\end{abstract}
161 %\end{otherlanguage}
162 %\begin{abstract}
163 %Il presente pacchetto si propone di gestire gli elementi che generalmente compongono
164 %una prova scritta per le scuole secondarie di primo e secondo grado:
165 %l'intestazione della pagina, gli esercizi della verifica e le loro soluzioni.
166 %Gli esercizi possono presentare una numerazione, un punteggio e un grado di difficoltà.
167 %Alcuni comandi permettono di generare alcune tipologie di test: esercizi semplici, esercizi di completamento, vero o falso, domande aperte e chiuse e trova l'errore.
168 %Ciascun esercizio può presentare la soluzione corretta che viene riportata nel documento in base ad un'apposita opzione del pacchetto.
169 %\end{abstract}
170 %\clearpage
171 %\tableofcontents
172 %\clearpage
173 %
174 %\section{Introduzione}
175 %Il pacchetto \textsf{verifiche} nasce dalla necessità di creare verifiche cartacee per la scuola secondaria di primo e secondo grado.
176 %L'intento è di ottenere un supporto che controlli la parte di test, nonché la gestione delle soluzioni all'interno dello stesso documento.\par
177 %Riguardo la parte di esercizi, il presente pacchetto si occupa della suddivisione delle domande (numerate o meno) e della gestione del loro punteggio inserendolo a mano, oppure calcolandolo come totale di punteggi parziali (si veda pagina \pageref{sec:esercizio}).
178 %Sono presenti comandi o ambienti ad hoc per realizzare quesiti di vero/falso, domande aperte o chiuse,
179 %esercizi di "caccia all'errore" e la gestione di testi e immagini affiancate.
180 %
181 %Per quanto riguarda le soluzioni, ogni elemento di test presenta la possibilità di mostrare la soluzione corretta, qualora venga venga inserita una specifica opzione del pacchetto che attivi la così detta in "modalità \texttt{solutions}" indicata nel seguito anche con "modalità soluzioni".
182 %
183 %Infine, il codice carica alcuni pacchetti necessari per la gestioni dei comandi implementati.
184 %\begin{itemize}
185 %\item |xparse| e |xkeyval| per la gestione dei comandi e degli ambienti del pacchetto;
186 %\item |enumitem| per la gestione avanzata degli elenchi puntati e numerati (sono attivate le opzioni |shortlabels| e |inline|
187 %\item |pgffor| e per la gestione dei cicli for;
188 %\item |tikz| per la gestione di alcuni aspetti grafici avanzati;
189 %\item |ulem| per la gestione della formattazione avanzata del testo;
190 %\item |fp| per la gestione dei punteggi decimali dei punti;
191 %\item |randomlist| per la gestione di liste ordinate casualmente.
192 %\end{itemize}
193 %
194 %\section{Come usare il pacchetto \textsf{verifiche} e le sue opzioni}
195 %Per usare il pacchetto \textsf{verifiche} è sufficiente copiare il file \texttt{\filename} nella cartella di lavoro
196 %o installarlo secondo le procedure relative al proprio sistema operativo.
197 %
198 %Una volta installato è sufficiente caricare il pacchetto attraverso il comando:\\
199 %\begin{center} |\usepackage|\oarg{options}|{verifiche}|\end{center}
200 %Il pacchetto \textsf{verifiche} prevede alcune opzioni per modificare globalmente il proprio comportamento.
201 %Queste gestiscono l'aspetto dell'intestazione, la numerazione globale dei quesiti nonché l'attivazione della "modalità soluzioni" per poter visualizzare, nel documento, le soluzioni e variarne il colore del font.
202 %
203 %\begin{center}
204 %\begin{tabular}{lp{.55\textwidth}}
205 %\textbf{\meta{options}}& \textbf{Descrizione} \\[.5em]
206 %\hline\\
207 %|noinstitute| & non stampa il nome dell'istituto.\\
208 %|nocandidatename|& non stampa la sezione per il nome del candidato\\
209 %|noinstruction| & non stampa le istruzioni della prova\\
210 %|noduration| & non stampa la durata della prova\\
211 %|noasyear| & non stampa l'anno scolastico\\
212 %|notesttype| & non stampa il tipo di prova \\
213 %|nonumbered| & quesiti non numerati\\
214 %|noexercisept| & non stampa il punteggio degli esercizi, anche se dichiarati\\
215 %|nosubtitle| & non stampa il sottotitolo\\
216 %|solutions| & stampa le soluzioni degli esercizi (si veda pag. \pageref{sec:solutions})\\
217 %|red| & il colore del font delle soluzioni è rosso\\
218 %|blue| & il colore del font delle soluzioni è blu\\
219 %|color|=\meta{color}& il colore del font delle soluzioni è \meta{color}\\
220 %|closedquestionstyle|=\meta{style}& cambiare lo stile di closedquestion (|Letter|, |letter|, |arabic|, |Roman|, |roman|)\\[.5em]
221 %\hline
222 %\end{tabular}
223 %\end{center}
224 %Nel seguito si indicherà con "modalità test", il pacchetto caricato senza l'opzione |solutions|, altrimenti questa verrà detta "modalità soluzione" o "modalità solutions".
225 %
226 %\section{Intestazione}\label{sec:intestazione}
227 %\subsection*{Comandi}
228 %Il pacchetto \textsf{verifiche} fornisce alcuni comandi per realizzare una semplice intestazione del documento che prevede il nome dell'istituto, l'anno scolastico il tipo di prova, le istruzioni e la durata della prova.
229 %Tutte queste voci vanno dichiarate prima del comando |\printheading| che si occupa della produzione del risultato finale.
230 %Le \emph{opzioni} del pacchetto permettono la soprressione della visualizzazione di alcune di queste voci.
231 %
232 %\vspace{1em}
233 %\DescribeMacro{\institute}\label{par:institute}Il nome dell'istituto può essere indicato tramite il comando:
234 %
235 %\iffalse
236 %<*example>
237 %\fi
238 \begin{lstlisting}
239 \institute*@\marg{nome dell'istituto}@*
240 \end{lstlisting}
241 %\iffalse
242 %</example>
243 %\fi
244 %
245 %il cui argomento verrà stampato al centro dell'intestazione della pagina con un font largo, senza grazie e di colore grigio scuro.
246 %Il font può essere modificato ridefinendo il comando |\institutefont|.
247 %
248 %\DescribeMacro{\asyear}\label{par:asyear}L'anno scolastico viene indicato tramite l'apposito comando:
249 %\iffalse
250 %<*example>
251 %\fi
252 \begin{lstlisting}
253 \asyear*@\oarg{preambolo}\marg{anno scolastico}@*
254 \end{lstlisting}
255 %\iffalse
256 %</example>
257 %\fi
258 %il cui argomento viene riportato, al centro della pagina, anteponendo il \meta{preambolo} (che di default riporta la dicitura ‘‘Anno scolastico’’). Il font ed il posizionamento del testo possono essere cambiati ridefinendo il comando |\asyearfont|.
259 %
260 %\DescribeMacro{\testtype}\label{par:testtype}La tipologia di prova può essere indicata tramite il comando:
261 %\iffalse
262 %<*example>
263 %\fi
264 \begin{lstlisting}
265 \testtype*@\marg{tipo di compito}@*
266 \end{lstlisting}
267 %\iffalse
268 %</example>
269 %\fi
270 %il cui argomento viene riportato, per default, al centro della pagina. La modifica del font e del posizionamento può essere operato ridefinendo il comando |\testtypefont|.
271 %
272 %\DescribeMacro{\instruction}\label{par:instruction}Le istruzioni della prova possono essere racchiuse all'interno del comando:
273 %\iffalse
274 %<*example>
275 %\fi
276 \begin{lstlisting}
277 \instruction*@\marg{istruzioni}@*
278 \end{lstlisting}
279 %\iffalse
280 %</example>
281 %\fi
282 %che provvede a racchiudere tra due delimitatori (di default una riga orizzontale) il testo delle istruzioni. Ridefinendo il comando |\instrunctionfont| è possibile cambiare il font delle istruzioni.
283 %
284 %\DescribeMacro{\testduration}La durata della prova può venir indicata tramite il comando:
285 %\iffalse
286 %<*example>
287 %\fi
288 \begin{lstlisting}
289 \testduration*@\oarg{preambolo}\marg{durata}@*
290 \end{lstlisting}
291 %\iffalse
292 %</example>
293 %\fi
294 % che viene riportata sotto le istruzioni, al centro, anteponendo all'argomento il \meta{preambolo} (che di default riporta la dicitura ‘‘’Tempo della prova:’’). L'aspetto di questo comando può essere modificato ridefinendo il comando |\testdurationfont|.
295 %
296 %\DescribeMacro{\subtitle} Il comando |\subtitle| introduce un sottotitolo al di sotto di quanto visualizzato dal comando |\texttype|. L'aspetto ed il posizionamento di questo testo possono essere modificati ridefinendo il comando |\subtitlefont|.
297 %\iffalse
298 %<*example>
299 %\fi
300 \begin{lstlisting}
301 \subtitle*@\marg{testo del sottotitolo}@*
302 \end{lstlisting}
303 %\iffalse
304 %</example>
305 %\fi
306 %
307 %\DescribeMacro{\printheading}\label{par:printheading}L'intestazione, ovvero l'output di tutti i comandi appena definiti, viene riportata nel documento solo in presenza del comando
308 %\iffalse
309 %<*example>
310 %\fi
311 \begin{lstlisting}
312 \printheading
313 \end{lstlisting}
314 %\iffalse
315 %</example>
316 %\fi
317 %
318 %\vspace{1em}
319 %Riassumendo, il pacchetto fornisce i seguenti comandi per gestire e la stampa dell'intestazione del documento:
320 %
321 %\begin{center}
322 %\begin{tabular}{lll}
323 %\textbf{Comando} & \textbf{Font} & \textbf{Descrizione}\\
324 %\hline
325 %|\institute| & |\institutefont| & Definisce il nome dell'istituto.\\
326 %|\asyear| & |\asyearfont| & Definisce l'anno scolastico.\\
327 %|\testtype| & |\testtypefont| & Definisce il tipo di prova.\\
328 %|\instruction| & |\instrunctionfont|& Definisce le istruzioni delle prove.\\
329 %|\testduration| & |\testdurationfont| & Definisce la durata della prova.\\
330 %|\subtitle| & |\subtitlefont| & Definisce il sottotitolo.\\
331 %|\printheading| & & Stampa l'intestazione.\\
332 %\hline
333 %\end{tabular}
334 %\end{center}
335 %
336 %\subsection*{Stili di intestazione}
337 % Il pacchetto definisce tre tipi di intestazioni, la prima (di default) è definita |galilei| stampa, in sequenza, l'intestazione per il nome del candidato, la classe e la data, l'anno scolastico, il tipo di test, l'eventuale sottotitolo e le istruzioni col tempo della prova. La seconda versione, analoga alla prima, è detta |cattaneo|. La terza, nominata |einstein|, pone su due colonne le informazioni del candidato ed il tipo di prova. Il tipo di intestazione può essere variata tramite il comando:
338 %\iffalse
339 %<*example>
340 %\fi
341 \begin{lstlisting}
342 \headingstyle{einstein}
343 \end{lstlisting}
344 %\iffalse
345 %</example>
346 %\fi
347 %Il pacchetto permette di definire nuovi stili di intestazione tramite il comando |\defineheadingstyle| (si veda \pageref{par:headingstyle}).
348
349 %\subsection*{Stili di pagina}
350 % Il pacchetto definisce due stili di pagina \emph{ad hoc}: |mainverifiche| e |verifiche|. Il primo è evocato quando si definisce il comando |\institute| e stampa sulla prima pagina l'argomento di questo comando. \DescribeMacro{verifiche}Il secondo, invece, può essere utilizzato dall'utente tramite il comando:
351 %\iffalse
352 %<*example>
353 %\fi
354 \begin{lstlisting}
355 \pagestyle{verifiche}
356 \end{lstlisting}
357 %\iffalse
358 %</example>
359 %\fi
360 %e riproduce, nelle pagine dispari diversa dalla prima, l'intestazione per l'identificazione del candidato: il nome, la classe e la data.
361 %\section{Comandi ed ambienti per le \textsf{verifiche}}
362 %Nel seguito verranno presentati i comandi che permettono di strutturare un test.
363 %Il pacchetto fornisce un ambiente di esercizio in cui racchiudere le domande.
364 %Vi è la possibilità di predisporre domande chiuse a scelta multipla, prove di vero-falso, ‘‘trova l'errore’’ e domande a risposta aperta (fornendo una base su cui scrivere come un foglio a quadretti o a righe).
365 %Ogni comando prevede la possibilità di fornire le soluzioni che vengono visualizzato quando il pacchetto è caricato attivando l'opzione |solutions|.
366 %
367 %\vspace{1em}
368 % \DescribeEnv{esercizio}\label{sec:esercizio}Gli esercizi od i quesiti del test vengono gestiti dall'ambiente |esercizio|.
369 % \iffalse
370 %<*example>
371 % \fi
372 \begin{lstlisting}
373 \begin{esercizio}[label=*@\meta{label}@*,diff=*@\meta{number}@*,pt=*@\meta{number}@*,sumpoints]
374 ...
375 \end{esercizio}
376 \end{lstlisting}
377 % \iffalse
378 %</example>
379 % \fi
380 %Senza specificare alcun argomento opzionale, viene stampata la dicitura "Quesito" seguita da un indice numerico crescente ed il testo contenuto nel corpo dell'ambiente.
381 %Le modifiche dell'aspetto e del comportamento sono previste tramite delle opzioni espresse nel formato \texttt{key=val}, eventualmente separate da virgola se presenti in contemporanea:\par
382 %\begin{center}
383 %\begin{tabular}{ll}
384 %|label|=\meta{label} & definisce il titolo del quesito\\
385 %|diff|=\meta{number} & definisce la difficoltà sotto forma di punti\\
386 %|pt|=\meta{number} & definisce il punteggio della prova\\
387 %|sumpoints| & somma in automatico i punteggi parziali\\
388 %|partialpt| & somma in automatico i punteggi parziali\\
389 %\end{tabular}
390 %\end{center}
391 %
392 %Nel seguito si mostrano alcuni dei possibili risultati visivi.\\
393 %
394 % \iffalse
395 %<*example>
396 % \fi
397 \stepcounter{id}
398 \begin{sourcecode}
399 \begin{esercizio}
400 Testo dell'esercizio
401 che voglio somministrare
402 \end{esercizio}
403 \end{sourcecode}
404 \begin{render}
405 \begin{esercizio}
406 Testo dell'esercizio
407 che voglio somministrare
408 \end{esercizio}
409 \end{render}
410 %
411 % \iffalse
412 %</example>
413 % \fi
414 %
415 % \iffalse
416 %<*example>
417 % \fi
418 \stepcounter{id}
419 \begin{sourcecode}
420 \begin{esercizio}[label=Esercizio]
421 Testo dell'esercizio
422 che voglio somministrare
423 \end{esercizio}
424 \end{sourcecode}
425 \begin{render}
426 \begin{esercizio}[label=Esercizio]
427 Testo dell'esercizio
428 che voglio somministrare
429 \end{esercizio}
430 \end{render}
431 % \iffalse
432 %</example>
433 % \fi
434 %
435 % \iffalse
436 %<*example>
437 % \fi
438 \stepcounter{id}
439 \begin{sourcecode}
440 \begin{esercizio}[diff=2]
441 Testo dell'esercizio
442 che voglio somministrare
443 \end{esercizio}
444 \end{sourcecode}
445 \begin{render}
446 \begin{minipage}{.1\linewidth}
447 \hfill$\bullet\bullet$
448 \end{minipage}
449 \raisebox{-1.3\baselineskip}{
450 \begin{minipage}{.8\linewidth}
451 \begin{esercizio}
452 Testo dell'esercizio
453 che voglio somministrare
454 \end{esercizio}
455 \end{minipage}}
456 \end{render}
457 % \iffalse
458 %</example>
459 % \fi
460 %
461 % \iffalse
462 %<*example>
463 % \fi
464 \stepcounter{id}
465 \begin{sourcecode}
466 \begin{esercizio}[pt=2]
467 Testo dell'esercizio
468 che voglio somministrare
469 \end{esercizio}
470 \end{sourcecode}
471 \begin{render}
472 \begin{minipage}{.45\linewidth}
473 \underline{\phantom{1cm}}/ 2 pt
474 \end{minipage}
475 \raisebox{-2.5\baselineskip}{
476 \begin{minipage}{.45\linewidth}
477 \begin{esercizio}
478 Testo dell'esercizio
479 che voglio somministrare
480 \end{esercizio}
481 \end{minipage}}
482 \end{render}
483 % \iffalse
484 %</example>
485 % \fi
486 %
487 % \iffalse
488 %<*example>
489 % \fi
490 \stepcounter{id}
491 \begin{sourcecode}
492 \begin{esercizio}[pt=2, diff=2]
493 Testo dell'esercizio
494 che voglio somministrare
495 \end{esercizio}
496 \end{sourcecode}
497 \begin{render}
498 \begin{minipage}{.41\linewidth}
499 \hfill$\bullet\bullet$\newline
500 \hspace*{\fill}\underline{\phantom{1cm}}/ 2 pt
501 \end{minipage}
502 \raisebox{-1.5\baselineskip}{
503 \begin{minipage}{.52\linewidth}
504 \begin{esercizio}
505 Testo dell'esercizio
506 che voglio somministrare
507 \end{esercizio}
508 \end{minipage}}
509 \end{render}
510 % \iffalse
511 %</example>
512 % \fi
513 %
514 %È possibile fare dei riferimenti incrociati usando gli usuali comandi presenti in \LaTeX{}. L'etichetta viene dichiarata tramite l'usuale comando |\label=|\marg{label} introdotto dopo l'apertura dell'ambiente |esercizio|.
515 %I riferimenti incrociati possono essere richiamati tramite l'usuale comando |\ref|\marg{label}, che produce il numero dell'esercizio e |\pageref|\marg{label} che stampa la pagina del riferimento.\\
516 %
517 %
518 %\DescribeMacro{\partialpt}Il comando |\partialpt|, da non confondere con l'opzione omonima |partialpt| dell'ambiente |esercizio|, permette di riportare il punteggio parziale per le domande di un esercizio. Questo viene stampato a margine e racchiuso tra parentesi tonde.\\
519 %
520 % \iffalse
521 %<*example>
522 % \fi
523 \stepcounter{id}
524 \begin{sourcecode}
525 \begin{esercizio}
526 \begin{enumerate}
527 \item\partialpt{1} Domanda 1
528 \item\partialpt{3} Domanda 2
529 \end{enumerate}
530 \end{esercizio}
531 \end{sourcecode}
532 \begin{render}
533 \begin{minipage}[t]{.3\linewidth}
534 \vspace*{0em}
535 (1 pt)\\[.7em]
536 (3 pt)
537 \end{minipage}
538 \raisebox{\baselineskip}{
539 \begin{minipage}[t]{.6\linewidth}
540 \begin{esercizio}
541 \begin{enumerate}[leftmargin=*]
542 \item Domanda 1
543 \item Domanda 2
544 \end{enumerate}
545 \end{esercizio}
546 \end{minipage}}
547 \end{render}
548 % \iffalse
549 %</example>
550 % \fi
551 %
552 %Quando usato negli ambienti |enumerate| o |itemize|, il comando introduce uno spazio spurio che può essere rimosso posponendo il comando |\noindent|.
553 %
554 %Quando viene esplicitata l'\emph{opzione} |sumpoints| nella definizione dell'ambiente esercizio, il pacchetto si occupa della somma complessiva dei singoli punteggi parziali riportandola come punteggio totale del quesito. In questo caso il documento dev'essere compilato \emph{due volte} per ottenere correttamente il risultato finale. (Dalle versioni precedenti la 8.0 il comando |sumpoints| era |partialpt|. Tale comando rimane definito per compatibilità.\\
555 %
556 % \iffalse
557 %<*example>
558 % \fi
559 \stepcounter{id}
560 \begin{sourcecode}
561 \begin{esercizio}[sumpoints]
562 \begin{enumerate}
563 \item\partialpt{1.5} Domanda 1
564 \item\partialpt{2.5} Domanda 2
565 \end{enumerate}
566 \end{esercizio}
567 \end{sourcecode}
568 \begin{render}
569 \begin{minipage}[t]{.35\linewidth}
570 \vspace*{0pt}
571 \underline{\hspace{.5cm}}/4 pt\\[.5em]
572 (1.5 pt)\\[.7em]
573 (2.5 pt)
574 \end{minipage}
575 \begin{minipage}[t]{.58\linewidth}
576 \begin{esercizio}
577 \medskip
578 \begin{enumerate}[leftmargin=*]
579 \item Domanda 1
580 \item Domanda 2
581 \end{enumerate}
582 \end{esercizio}
583 \end{minipage}
584 \end{render}
585 % \iffalse
586 %</example>
587 % \fi
588 %
589 %
590 %Il punteggio dei quesiti può essere richiamato in qualunque punto del documento attraverso il comando
591 %\begin{center} |\ref{ptes@|\meta{n.es}|}|\end{center}
592 %dove \meta{n.es} indica il numero dell'esercizio riportato nell'intestazione dello stesso.
593 %
594 %\vspace{1em}
595 %\DescribeEnv{esercizio*}L'ambiente |esercizio| produce sempre quesiti numerati. Se si desidera indicare test non numerati è possibile farlo tramite l'ambiente |esercizio*| che prevede gli stessi argomenti opzionali definiti per l'ambiente precedente.
596 %
597 % \iffalse
598 %<*example>
599 % \fi
600 \begin{lstlisting}
601 \begin{esercizio*}[label=*@\meta{label}@*,
602 diff=*@\meta{number}@*,
603 pt=*@\meta{number}@*,
604 sumpoints ]
605 ...
606 \end{esercizio*}
607 \end{lstlisting}
608 % \iffalse
609 %</example>
610 % \fi
611 %
612 % \iffalse
613 %<*example>
614 % \fi
615 \stepcounter{id}
616 \begin{sourcecode}
617 \begin{esercizio*}[pt=2]
618 Testo dell'esercizio
619 che voglio somministrare
620 \end{esercizio*}
621 \end{sourcecode}
622 \begin{render}
623 \begin{minipage}{.45\linewidth}
624 \underline{\phantom{1cm}}/ 2 pt
625 \end{minipage}
626 \raisebox{-2.5\baselineskip}{
627 \begin{minipage}{.45\linewidth}
628 \begin{esercizio*}
629 Testo dell'esercizio
630 che voglio somministrare
631 \end{esercizio*}
632 \end{minipage}}
633 \end{render}
634 % \iffalse
635 %</example>
636 % \fi
637 %
638 %
639 %\vspace{1em}
640 %\DescribeEnv{soluzione}\label{sec:solutions}L'ambiente |soluzione| racchiude al suo interno tutto il materiale utile ad essere visualizzato solo in presenza dell'\emph{opzione} |solutions| del pacchetto \textsf{verifiche}. Quando il pacchetto è in modalità "test" il contenuto dell'ambiente |soluzione| viene ignorato. L'etichetta che introduce l'ambiente può essere modificata localmente tramite l'opzione |label|.
641 %
642 % \iffalse
643 %<*example>
644 % \fi
645 \begin{lstlisting}
646 \begin{soluzione}[label=*@\meta{label}@*]
647 ...
648 \end{soluzione}
649 \end{lstlisting}
650 % \iffalse
651 %</example>
652 % \fi
653 %
654 % \iffalse
655 %<*example>
656 % \fi
657 \stepcounter{id}
658 \begin{sourcecode}
659 \begin{soluzione}
660 Testo della soluzione
661 dell'esercizio somministrato
662 \end{soluzione}
663 \end{sourcecode}
664 \begin{render}
665 \begin{soluzione}
666 Testo della soluzione
667 dell'esercizio somministrato
668 \end{soluzione}
669 \end{render}
670 % \iffalse
671 %</example>
672 % \fi
673 %
674 %\DescribeMacro{\inlinesol}Il pacchetto presenta il comando |\inlinesol| per produrre soluzioni in linea, ovvero testo che in modalità "test" viene ignorato, ma che invece viene visualizzato nella modalità "soluzioni" (opzione |solutions| del pacchetto).
675 % \iffalse
676 %<*example>
677 % \fi
678 \begin{lstlisting}
679 \inlinesol*@\marg{testo}@*
680 \end{lstlisting}
681 % \iffalse
682 %</example>
683 % \fi
684 %
685 % \iffalse
686 %<*example>
687 % \fi
688 \stepcounter{id}
689 \begin{sourcecode}
690 Questa e' una \inlinesol{soluzione}
691 in linea
692 \end{sourcecode}
693 \begin{render}
694 \solfalse Questa e' una \inlinesol{soluzione} in linea.\\
695 \soltrue Questa e' una \inlinesol{soluzione} in linea
696 \end{render}
697 % \iffalse
698 %</example>
699 % \fi
700 %
701 %
702 %\DescribeMacro{\completetext}Gli esercizi di completamento del testo possono venir realizzati tramite il comando:
703 % \iffalse
704 %<*example>
705 % \fi
706 \begin{lstlisting}
707 \completetext*@\oarg{dim}\marg{testo}@*
708 \end{lstlisting}
709 % \iffalse
710 %</example>
711 % \fi
712 %che produce uno spazio vuoto largo \meta{dim} (che di default è di 4.5 cm) e che in modalità "soluzioni" riproduce il \meta{testo}.
713 %
714 % \iffalse
715 %<*example>
716 % \fi
717 \stepcounter{id}
718 \begin{sourcecode}
719 La \completetext[2cm]{soluzione}
720 \end{sourcecode}
721 \begin{render}
722 \solfalse La \completetext[2cm]{soluzione}\\
723 \soltrue La \completetext[2cm]{soluzione}
724 \end{render}
725 % \iffalse
726 %</example>
727 % \fi
728 %
729 %
730 %\DescribeMacro{\truefalse}I quesiti con domande vero-falso possono essere realizzati tramite il comando
731 % \iffalse
732 %<*example>
733 % \fi
734 \begin{lstlisting}
735 \truefalse*@\marg{V/F}@*
736 \end{lstlisting}
737 % \iffalse
738 %</example>
739 % \fi
740 %Il comando produce due riquadri quadrati allineati con le lettere \texttt V e \texttt F; l'argomento obbligatorio richiede di indicare la lettera |V| o |F| al fine di poter realizzare un segno di spunta ({\huge$\times$}) sulla casella giusta nella modalità |solutions| del pacchetto. Tale simbolo può essere modificato ridefinendo il comando \DescribeMacro{\checkmaker}|\checkmaker|.
741 % \iffalse
742 %<*example>
743 % \fi
744 \begin{lstlisting}
745 \renewcommand{\checkmaker}*@\marg{...}@*
746 \end{lstlisting}
747 % \iffalse
748 %</example>
749 % \fi
750 % \iffalse
751 %<*example>
752 % \fi
753 \stepcounter{id}
754 \begin{sourcecode}
755 Vero o Falso? \truefalse{V}}
756 \end{sourcecode}
757 \begin{render}
758 \solfalse Vero o Falso? \truefalse{V}\\
759 \soltrue Vero o Falso? \truefalse{V}
760 \end{render}
761 % \iffalse
762 %</example>
763 % \fi
764 %
765 %
766 %\DescribeEnv{closedquestion}Le domande a scelta multipla possono essere realizzate tramite l'ambiente |closedquestion|. Questo comando genera un elenco verticale di elementi ciascuno introdotto dal comando \DescribeMacro{\item}|\item| che realizza un quadrato davanti ad ogni voce.
767 % \iffalse
768 %<*example>
769 % \fi
770 \begin{lstlisting}
771 \begin{closedquestion}[...]
772 \item ...
773 \end{closedquestion}
774 \end{lstlisting}
775 % \iffalse
776 %</example>
777 % \fi
778 %La soluzione (o le soluzioni) possono essere segnate tramite il comando \DescribeMacro{\checked}|\checked| posto come argomento opzionale del comando |\item| e che, nella modalità |solutions|, produce un segno di spunta ({\huge$\times$}) sulla casella selezionata. Anche in questo caso tale simbolo può essere modificato ridefinendo il comando |\checkmaker|. Il pacchetto ammette degli argomenti opzionali che possono essere tutti quelli descritti nel pacchetto |enumitem|.
779 % \iffalse
780 %<*example>
781 % \fi
782 \begin{lstlisting}
783 \renewcommand{\checkmaker}*@\marg{...}@*
784 \end{lstlisting}
785 % \iffalse
786 %</example>
787 % \fi
788 %
789 % \iffalse
790 %<*example>
791 % \fi
792 \stepcounter{id}
793 \begin{sourcecode}
794 \begin{closedquestion}
795 \item Primo
796 \item[\checked] Secondo
797 \item Terzo
798 \item Quarto
799 \end{closedquestion}
800 \end{sourcecode}
801 \begin{render}
802 \begin{closedquestion}
803 \item Primo
804 \item[\checked] Secondo
805 \end{closedquestion}
806 \begin{closedquestion}
807 \item Terzo
808 \item Quarto
809 \end{closedquestion}
810 \end{render}
811 % \iffalse
812 %</example>
813 % \fi
814 %
815 %
816 % L'ambiente \DescribeEnv{closeduestion}|closeduestion*| è analogo al precedente, fatto salvo che è adibito a produrre elenchi in linea; gli elementi vengono spaziati orizzontalmente in modo da riempire tutto lo spazio disponibile. Anche in questo caso i comandi del pacchetto |enumitem| possono essere usati tra le opzioni dell'ambiente.
817 % \iffalse
818 %<*example>
819 % \fi
820 \begin{lstlisting}
821 \begin{closedquestion*}[...]
822 \item ...
823 \end{closedquestion*}
824 \end{lstlisting}
825 % \iffalse
826 %</example>
827 % \fi
828 %
829 %
830 %\DescribeMacro{\openquestion}Il comando produce una base di supporto per la scrittura, ovvero delle linee o dei quadretti. La sintassi del comando è la seguente:
831 % \iffalse
832 %<*example>
833 % \fi
834 \begin{lstlisting}
835 \openquestion[type=*@\meta{lines/squares}@*, width=*@\meta{dim}@*, height=*@\meta{dim}@*,
836 spacedim=*@\meta{dim}@*, linecolor=*@\meta{color}@*]*@\marg{soluzione}@*
837 \end{lstlisting}
838 % \iffalse
839 %</example>
840 % \fi
841 %La il testo dell'argomento obbligatorio (\meta{soluzione}) viene visualizzato solo in modalità |solutions|.
842 %Il comando gestisce alcune opzioni:\\
843 %
844 %\begin{tabular}{ll}
845 %|type|  & accetta due valori: \texttt{lines} e \texttt{squares} (default: |squares|)\\
846 %|width| & gestisce la dimensione orizzontale del campo di testo (default: 12 cm)\\
847 %|height| & gestisce la dimensione verticale del campo di testo (default: 20 cm)\\
848 %|spacedim|& gestisce la dimensione dei quadretti o delle linee (default: 0.5 cm)\\
849 %|linecolor| & colore delle linee guida (default: gray)
850 %\end{tabular}
851 %\vspace{1em}
852 %
853 %
854 % \iffalse
855 %<*example>
856 % \fi
857 \stepcounter{id}
858 \begin{sourcecode}
859 \openquestion{
860 Prova del testo della soluzione
861 della domanda aperta
862 }
863 \end{sourcecode}
864 \begin{render}
865 \vspace*{1em}\openquestion[width=4cm, height=2cm]{Prova del testo della soluzione della domanda aperta}
866 \end{render}
867 % \iffalse
868 %</example>
869 % \fi
870 %
871 % \iffalse
872 %<*example>
873 % \fi
874 \stepcounter{id}
875 \begin{sourcecode}
876 \openquestion[type=lines]{
877 Prova del testo della soluzione
878 della domanda aperta
879 }
880 \end{sourcecode}
881 \begin{render}
882 \vspace*{1em}\openquestion[type=lines, width=4cm, height=2cm]{Prova del testo della soluzione della domanda aperta}
883 \end{render}
884 % \iffalse
885 %</example>
886 % \fi
887 %
888 %
889 %\DescribeMacro{\finderror}Gli esercizi della tipologia ‘‘trova l'errore’’ possono essere composti tramite il comando
890 % \iffalse
891 %<*example>
892 % \fi
893 \begin{lstlisting}
894 \finderror*@\marg{testo sbagliato}\marg{testo giusto}@*
895 \end{lstlisting}
896 % \iffalse
897 %</example>
898 % \fi
899 %Il comando visualizza la stringa \meta{testo sbagliato} nella modalità "test", mentre mostra una cancellatura ed il testo corretto nella modalità |solutions|.\\
900 %
901 %
902 % \iffalse
903 %<*example>
904 % \fi
905 \stepcounter{id}
906 \begin{sourcecode}
907 \finderror{sbagliato}{corretto}
908 \end{sourcecode}
909 \begin{render}
910 \finderror{sbagliato}{corretto}
911 \end{render}
912 % \iffalse
913 %</example>
914 % \fi
915 %
916 %
917 %\vspace{1em}
918 %\DescribeMacro{\textandimage}L'impaginazione del testo con affiancato un'immagine viene agevolato dal comando |\textandimage| che ha la seguente sintassi:
919 % \iffalse
920 %<*example>
921 % \fi
922 \begin{lstlisting}
923 \textandimage*@\oarg{left width}\oarg{right width}\marg{sx material}\marg{dx material}@*
924 \end{lstlisting}
925 % \iffalse
926 %</example>
927 % \fi
928 %Il \meta{rx material} viene affiancato all'\meta{dx material}. La larghezza della colonna sinistra (risp. destra) è controllata tramite l'argomento opzionale \meta{left width} (risp. \meta{right width}).\\
929 % \iffalse
930 %<*example>
931 % \fi
932 \stepcounter{id}
933 \begin{sourcecode}
934 \textandimage[2cm][1cm]{Testo}{
935 \tikz{\draw(0,0) circle (.4cm)}}
936 \end{sourcecode}
937 \begin{render}
938 \phantom{.}\vspace{1em}\textandimage[2cm][1cm]{Testo}{\tikz{\draw(0,0) circle (.4cm)}}
939 \end{render}
940 % \iffalse
941 %</example>
942 % \fi
943 %
944 %
945 %\vspace{1em}
946 %\DescribeMacro{\makecolumn} Il pacchetto |verifiche| definisce anche un proprio comando per produrre del testo in colonna tramite il comando |\makecolumn| che ha la seguente sintassi:
947 % \iffalse
948 %<*example>
949 % \fi
950 \begin{lstlisting}
951 \makecolumn*@\marg{width}\marg{text}@*
952 \end{lstlisting}
953 % \iffalse
954 %</example>
955 % \fi
956 % La larghezza è controllata tramite l'argomento opzionale \meta{width}, mentre il testo da mettere in colonne può risiedere, anche con paragrafi, entro il campo \meta{text}. La spaziatura tra le colonne può essere modificata ridefinendo la lunghezza |\columnseparation| (di default viene inizializzata col valore |\hfill|).
957 % \iffalse
958 %<*example>
959 % \fi
960 \begin{lstlisting}
961 \setlength{\columnseparation}*@\marg{dim}@*
962 \end{lstlisting}
963 % \iffalse
964 %</example>
965 % \fi
966 % \iffalse
967 %<*example>
968 % \fi
969 \stepcounter{id}
970 \begin{sourcecode}
971 \makecolumn{.3\textwidth}{Colonna 1}
972 \makecolumn{.3\textwidth}{Colonna 2}
973 \end{sourcecode}
974 \begin{render}
975 \makecolumn{2.5cm}{Colonna 1} \makecolumn{2.5cm}{Colonna 2}
976 \end{render}
977 % \iffalse
978 %</example>
979 % \fi
980 %
981 %\clearpage
982 %\section{Personalizzazione}
983 %Il pacchetto prevede un certo numero di comandi per gestire l'aspetto del documento finale.
984 %\subsection*{Font}
985 %Per l'intestazione tutti i font sono definiti secondo lo schema:
986 %\begin{center}
987 %\meta{comando intestazione}|font|
988 %\end{center}
989 %ed oltre a gestire l'aspetto del carattere, alcuni di questi, specificano la posizione occupata del testo ed eventuali prefissi.
990 %
991 %\DescribeMacro{\headerfont} Il font delle intestazioni quando viene usato lo stile di pagina |verifiche|, può essere modifica ridefinendo il comando |\headerfont|:
992 %\iffalse
993 %<*example>
994 %\fi
995 \begin{lstlisting}
996 \renewcommand{\headerfont}[1]*@\marg{...}@*
997 \end{lstlisting}
998 %\iffalse
999 %</example>
1000 %\fi
1001 %\DescribeMacro{\institutefont}Il font dell'istituto, generato dal comando |\institute|, è gestito dal comando |\institutefont|. Per variare le caratteristiche del font è necessario ridefinire il comando:
1002 %\iffalse
1003 %<*example>
1004 %\fi
1005 \begin{lstlisting}
1006 \renewcommand{\institutefont}[1]*@\marg{...}@*
1007 \end{lstlisting}
1008 %\iffalse
1009 %</example>
1010 %\fi
1011 %
1012 %\DescribeMacro{\asyearfont}Il font dell'anno scolastico, generato dal comando |\asyear|, è gestito dal comando |\asyearfont|. Per variare le caratteristiche del font è necessario ridefinire il comando:
1013 %\iffalse
1014 %<*example>
1015 %\fi
1016 \begin{lstlisting}
1017 \renewcommand{\asyearfont}[1]*@\marg{...}@*
1018 \end{lstlisting}
1019 %\iffalse
1020 %</example>
1021 %\fi
1022 %
1023 %\DescribeMacro{\testtypefont}Il font tipo di test, generato dal comando |\testtype|, è gestito dal comando |\testtypefont|. Per variare le caratteristiche del font è necessario ridefinire il comando:
1024 %\iffalse
1025 %<*example>
1026 %\fi
1027 \begin{lstlisting}
1028 \renewcommand{\testtypefont}[1]*@\marg{...}@*
1029 \end{lstlisting}
1030 %\iffalse
1031 %</example>
1032 %\fi
1033 %
1034 %\DescribeMacro{\instrunctionfont}Il font delle istruzioni, generate dal comando |\instrunction|, è gestito dal comando |\instrunctionfont|. Per variare le caratteristiche del font è necessario ridefinire il comando:
1035 %\iffalse
1036 %<*example>
1037 %\fi
1038 \begin{lstlisting}
1039 \renewcommand{\instrunctionfont}[1]*@\marg{...}@*
1040 \end{lstlisting}
1041 %\iffalse
1042 %</example>
1043 %\fi
1044 %
1045 %\DescribeMacro{\ptfont} Il font dei punteggi è controllato del comando |\ptfont|. Per modificare l'aspetto di questo elemento è necessario ridefinire il comando.
1046 %\iffalse
1047 %<*example>
1048 %\fi
1049 \begin{lstlisting}
1050 \renewcommand{\ptfont}*@\marg{...}@*
1051 \end{lstlisting}
1052 %\iffalse
1053 %</example>
1054 %\fi
1055 %
1056 %\DescribeMacro{\solutionfont}Le soluzioni degli esercizi vengono stampate, quando viene esplicitata l'opzione |solutions| quando viene caricato il pacchetto, con un font più piccolo e in corsivo. Per modificare il font delle soluzioni è sufficiente ridefinire il comando |\solutionfont|:
1057 %\iffalse
1058 %<*example>
1059 %\fi
1060 \begin{lstlisting}
1061 \renewcommand{\solutionfont}*@\marg{...}@*
1062 \end{lstlisting}
1063 %\iffalse
1064 %</example>
1065 %\fi
1066 %
1067 %\subsection*{Intestazione}
1068 %\DescribeMacro{\instructiondelimiter}Le istruzioni e la durata della prova sono racchiuse tra due delimitatori che normalmente sono due righe orizzontali. Per cambiare, o rimuovere, questi delimitatori è sufficiente ridefinire il seguente comando:
1069 %\iffalse
1070 %<*example>
1071 %\fi
1072 \begin{lstlisting}
1073 \renewcommand{\instructiondelimiter}*@\marg{...}@*
1074 \end{lstlisting}
1075 %\iffalse
1076 %</example>
1077 %\fi
1078 %
1079 %\DescribeMacro{\headercandidatenamelabel}\DescribeMacro{\headerdatelabel}Quando viene composta l'intestazione principale nella prima pagina, compare una riga in cui il candidato può scrivere il proprio nome e cognome, la data e la classe. L'etichetta della prima voce è determinata dal comando |\headercandidatenamelabel|, che può essere opportunamente cambiata tramite il comando:
1080 %\iffalse
1081 %<*example>
1082 %\fi
1083 \begin{lstlisting}
1084 \renewcommand{\headercandidatenamelabel}*@\marg{...}@*
1085 \end{lstlisting}
1086 %\iffalse
1087 %</example>
1088 %\fi
1089 %Allo stesso modo è possibile modificare la descrizione della classe \DescribeMacro{\headerclasslabel}tramite la redefinizione del comando |\headerclasslabel| e della data\DescribeMacro{\headerdatelabel} tramite comando |\headerdatelabel|.
1090 % Tutte queste tre voci prevedono, per ciascuna, una riga vuota ove scrivere l'informazione richiesta.\DescribeMacro{\candidatenamerulerlength}\DescribeMacro{\classrulerlength}\DescribeMacro{\daterulerlength} Le lunghezze delle tre righe possono essere modificate impostando le lunghezze desiderate
1091 %\iffalse
1092 %<*example>
1093 %\fi
1094 \begin{lstlisting}
1095 \setlength{\...rulerlength}*@\marg{dim}@*
1096 \end{lstlisting}
1097 %\iffalse
1098 %</example>
1099 %\fi
1100 %Attraverso questi comandi è possibile anche rimuovere una (o più) delle tre voci. Se ad esempio non si vuole visualizzare la classe d'appartenenza del candidato, sarà sufficiente ridefinire gli opportuni comandi nel seguente modo: |\renewcommand{\headerclasslabel}{}|, così da non visualizzare alcuna scritta, e |\setlength{\classrulerlength}{0pt}| per rimuovere la riga associata.
1101 %
1102 % \bigskip Il pacchetto permette\label{par:headingstyle} di definire nuovi modi di visualizzare l'intestazione (oltre a quelle predefinite |galilei|, |einstein| e |cattaneo|) tramite il comando:
1103 %\iffalse
1104 %<*example>
1105 %\fi
1106 \begin{lstlisting}
1107 \defineheadingstyle*@\marg{nome dello stile}\marg{\dots}@*
1108 \end{lstlisting}
1109 %\iffalse
1110 %</example>
1111 %\fi
1112 % Il secondo argomento obbligatorio raccoglie le istruzioni per comporre tutta l'intestazione, compreso anche lo stile di pagina.
1113 % Lo stile così definito dev'essere caricato tramite il comando
1114 %\iffalse
1115 %<*example>
1116 %\fi
1117 \begin{lstlisting}
1118 \headingstyle*@\marg{nome dello stile}@*
1119 \end{lstlisting}
1120 %\iffalse
1121 %</example>
1122 %\fi
1123 %seguito dal comando |\printheading|.
1124 %
1125 %\subsection*{Ambiente \texttt{esercizio}}
1126 %\DescribeMacro{\exerciselabel}Gli esercizi vengono inseriti anteponendo al loro testo la dicitura ‘‘Quesito’’ seguito (eventualmente) da un numero. Per cambiare questa dicitura, a livello globale, ovvero per ogni esercizio, è sufficiente ridefinire il comando |\exerciselabel|.
1127 %\iffalse
1128 %<*example>
1129 %\fi
1130 \begin{lstlisting}
1131 \renewcommand{\exerciselabel}*@\marg{Preambolo dell'esercizio}@*
1132 \end{lstlisting}
1133 %\iffalse
1134 %</example>
1135 %\fi
1136 %
1137 %L'ambiente |esercizio| permette di riportare anche il punteggio complessivo e parziale per le sotto-domande. Di default il punteggio totale del quesito viene riportato anteponendo un tratto orizzontale seguito da uno slash il valore del punteggio ed un'etichetta indicante la sigla \emph{pt}.
1138 % Per quanto riguarda il punteggio parziale, questo viene riportato racchiuso tra parentesi tonde.
1139 % L'aspetto complessivo del punteggio, quindi, può essere così schematizzato:
1140 %\begin{center}
1141 %\texttt{prefisso delimitatore punteggio label delimitatore}
1142 %\end{center}
1143 %
1144 %\DescribeMacro{\ptprefix} Il comando |\ptprefix| permette di modificare il \texttt{prefisso} del punteggio. Di default traccia una linea, la cui lunghezza può essere variata modificando la lunghezza |ptrulerlength|, ed uno slash. Se si vuole modificarne l'aspetto è sufficiente evocare il comando.
1145 %\iffalse
1146 %<*example>
1147 %\fi
1148 \begin{lstlisting}
1149 \ptprefix*@\marg{...}@*
1150 \end{lstlisting}
1151 %\iffalse
1152 %</example>
1153 %\fi
1154 %\DescribeMacro{\partialptprefix} Allo stesso modo il comando |\partialptprefix| definisce un \texttt{prefisso} per il punteggio parziale.
1155 %
1156 %\DescribeMacro{\ptdelimiters}\DescribeMacro{\partialptdelimiters} I punteggi sono racchiusi tra due \texttt{delimitatori}. Il punteggio totale non presenta alcun simbolo, mentre quello parziale è racchiuso tra parentesi tonde. È possibile definire dei nuovi delimitatori utilizzando i comandi |\partialptdelimiters| e |\ptdelimiters| i quali argomenti contengono due caratteri che fungono da delimitatore dentro e sinistro.
1157 %\iffalse
1158 %<*example>
1159 %\fi
1160 \begin{lstlisting}
1161 \ptdelimiters*@\marg{coppia di caratteri}@*
1162 \partialptdelimiters*@\marg{coppia di caratteri}@*
1163 \end{lstlisting}
1164 %\iffalse
1165 %</example>
1166 %\fi
1167 %
1168 %\DescribeMacro{\ptlabel}\DescribeMacro{\partialptlabel} Il punteggio viene riportato indicando anche una \texttt{label}. Questa di default è "pt" sia per il punteggio parziale che per quello totale. È possibile definire un nome alternativo usando il comando |\ptlabel| per il punteggio totale o |\partialptlabel| per quello parziale. I comandi prevedono un argomento obbligatorio che è valido per tutti i punteggi, ma anche uno facoltativo che viene usato quanto il valore del punteggio è pari a 1 e che necessita quindi di un sostantivo singolare al posto di quello plurale (i.e. "punto" al posto di "punti").
1169 %\iffalse
1170 %<*example>
1171 %\fi
1172 \begin{lstlisting}
1173 \ptlabel*@\oarg{sing.}\marg{plur.}@*
1174 \partialptlabel*@\oarg{sing.}\marg{plur.}@*
1175 \end{lstlisting}
1176 %\iffalse
1177 %</example>
1178 %\fi
1179 %\DescribeMacro{\diffsymb}L'ambiente esercizi prevede di poter descrivere la difficoltà tramite un simbolo grafico. Di default questo è punto ($\bullet$), tuttavia è possibile cambiare il tipo di simbolo ridefinendo il comando |\diffsymb|:
1180 %\iffalse
1181 %<*example>
1182 %\fi
1183 \begin{lstlisting}
1184 \renewcommand{\diffsymb}*@\marg{codice del simbolo}@*
1185 \end{lstlisting}
1186 %\iffalse
1187 %</example>
1188 %\fi
1189 %
1190 %
1191 %\subsection*{Ambiente \texttt{closedquestion}}
1192 %\DescribeMacro{\closedquestionitem}Il simbolo delle domande chiuse è controllato dal comando |\closedquestionitem| che di default è un quadrato. Per modificare questo simbolo è sufficiente ridefinire il comando:
1193 %\iffalse
1194 %<*example>
1195 %\fi
1196 \begin{lstlisting}
1197 \renewcommand{\closedquestionitem}*@\marg{codice del simbolo}@*
1198 \end{lstlisting}
1199 %\iffalse
1200 %</example>
1201 %\fi
1202 %Il segno di spunta che viene stampato nella modalità soluzione, può essere cambiato ridefinendo il comando\DescribeMacro{\checkmaker}|\checkmaker|
1203 % \iffalse
1204 %<*example>
1205 % \fi
1206 \begin{lstlisting}
1207 \renewcommand{\checkmaker}*@\marg{...}@*
1208 \end{lstlisting}
1209 % \iffalse
1210 %</example>
1211 % \fi
1212
1213 %
1214 %\subsection*{Ambiente \texttt{soluzione}}
1215 % Per quel che riguarda l'ambiente |soluzione| è possibile cambiare il nome dell'ambente ridefinendo il comando |\solutionlabel|\DescribeMacro{\solutionlabel}.
1216 %\iffalse
1217 %<*example>
1218 %\fi
1219 \begin{lstlisting}
1220 \renewcommand{\solutionlabel}*@\marg{Preambolo della soluzione}@*
1221 \end{lstlisting}
1222 %\iffalse
1223 %</example>
1224 %\fi
1225 %\clearpage
1226 %\section{Test multipli}
1227 %Uno degli aspetti peculiari della produzione di test tramite software tipografici come \LaTeX{} è quello di poter usufruire della sua versatilità per produrre un numero definito a priori dall'utente di test diversi a partire da uno stesso schema di base.
1228 %
1229 %Le modalità e le strategie per fare questo sono molteplici.
1230 % Uno di questi metodi è utilizzare il pacchetto\footnote{https://ctan.org/pkg/datatool} |datatool| che permette di leggere un database (solitamente salvato come file |csv|) al cui interno sono contenute le domande, i dati ed eventualmente le soluzioni degli esercizi. Il pacchetto, poi, mette a disposizione il comando |\DTLforeach| che, interrogando tutto il database precedentemente costruito, permette di popolare un unico documento in cui si variano taluni elementi al fine di ottenere prove didattiche differenti. Una soluzione di questo tipo necessita di scrivere almeno due file. Il primo, con estensione |tex|, è la struttura della prova di verifica al cui interno presenta tutti i comandi per utilizzare i dati contenuti nel secondo file. Quest'ultimo è un file di tipo |csv| al cui interno, organizzate per colonne, si trovano tutte le domande che si vogliono personalizzare ed ogni riga corrisponde ad un differente compito.
1231 %Il pacchetto permette anche di generare un database direttamente interno a \LaTeX{}, senza quindi dover creare un file a parte, tramite i comandi:
1232 %\iffalse
1233 %<*example>
1234 %\fi
1235 \begin{lstlisting}
1236 \DTLnewdb*@\marg{nome del database}@*
1237 \end{lstlisting}
1238 %\iffalse
1239 %</example>
1240 %\fi
1241 % per creare un database chiamato |nome del database|; per creare una nuova riga, corrispondente ad una prova diversa, si usa il comando
1242 %\iffalse
1243 %<*example>
1244 %\fi
1245 \begin{lstlisting}
1246 \DTLnewrow*@\marg{nome del database}@*
1247 \end{lstlisting}
1248 %\iffalse
1249 %</example>
1250 %\fi
1251 %e ciascuna entrata di questa riga viene popolata introducendo un'entrata tramite il comando:
1252 %\iffalse
1253 %<*example>
1254 %\fi
1255 \begin{lstlisting}
1256 \DTLnewdbentry*@\marg{nome del database}\marg{nome colonna}\marg{dato}@*
1257 \end{lstlisting}
1258 %\iffalse
1259 %</example>
1260 %\fi
1261 %Come nel caso precedente il database può essere utilizzato tramite il comando\footnote{Si rimanda alla documentazione ufficiale per ulteriori approfondimenti. Si faccia attenzione che l'ultima voce del secondo argomento del comando, ovvero |comando=nome colonna| non deve contenere spazi, si consiglia quindi di concludere la riga con il carattere \%}
1262 %\iffalse
1263 %<*example>
1264 %\fi
1265 \begin{lstlisting}
1266 \DTLforeach**@\marg{nome del database}\marg{comando=nome colonna}\marg{dato}\marg{testo}@*
1267 \end{lstlisting}
1268 %\iffalse
1269 %</example>
1270 %\fi
1271 %dichiarato subito dopo |\begin{document}| ed il |testo| non è altro che l'intero corpo del documento.
1272 %\subsection*{L'ambiente |multitest|}
1273 % Il pacchetto |verifiche| mette a disposizione una soluzione interna per generare un numero definito dall'utente di prove personalizzate e che si basa sugli strumenti messi a disposizione da |pgf| e |tikz|.
1274 %\DescribeEnv{multitest}L'ambiente |multitest| racchiude all'interno del suo corpo lo schema della prova che si vuole somministrare ed eventualmente i comandi che permettono personalizzare la prova.
1275 %\iffalse
1276 %<*example>
1277 %\fi
1278 \begin{lstlisting}
1279 \begin{multitest}[n]
1280 ...
1281 \end{multitest}
1282 \end{lstlisting}
1283 %\iffalse
1284 %</example>
1285 %\fi
1286 %L'ambiente accetta un argomento opzionale |n| che è il numero di prove che si vogliono realizzare. Normalmente l'ambiente viene aperto dopo |\begin{document}| e chiuso prima di |\end{document}|.
1287 %
1288 %\bigskip
1289 %La personalizzazione dei dati del problema può avvenire tramite i comandi di gestione dei numeri casuali e delle liste casuali messi a disposizione dal pacchetto |pgf| che vengono di seguito riassunti lasciando il loro approfondimento alla documentazione ufficiale\footnote{https://www.ctan.org/pkg/pgf}.
1290 %\iffalse
1291 %<*example>
1292 %\fi
1293 \begin{lstlisting}
1294 \pgfmathrnd
1295 \pgfmathrand
1296 \pgfmathrandom{x,y}
1297 \pgfmathgeneratepseudorandomnumber
1298 \pgfmathrandominteger*@\marg{macro}\marg{min}\marg{max}@*
1299 \pgfmathdeclarerandomlist*@\marg{nome lista}\{ \marg{item 1} \marg{item 2} ...\}@*
1300 \pgfmathrandomitem*@\marg{macro}\marg{nome lista}@*
1301 \pgfmathsetseed*@\marg{numero intero}@*
1302 \end{lstlisting}
1303 %\iffalse
1304 %</example>
1305 %\fi
1306 %Il comando inizializza il seme dei numeri casuali col numero del compito prodotto, in modo tale da produrre gli stessi compiti casuali ad ogni compilazione.
1307 %\DescribeMacro{multitestcounter}Il contatore |multitestcounter| permette di identificare il numero della traccia generata.
1308 %\subsection*{Gli ambienti |suffled*|}
1309 % I test multipli possono richiedere elenchi puntati, numerati o domande chiuse che vengano automaticamente mescolate ad ogni nuova versione del documento. Per questo scopo il pacchetto definisce gli ambienti |shuffledenumerate|, |shuffleditemize| e |shuffledclosed|.
1310 %
1311 %\bigskip\DescribeMacro{shuffledenumerate} L'ambiente |shuffledenumerate| viene utilizzato per produrre elenchi numerati in cui l'ordine degli elementi venga randomicamente mescolato. Ogni elemento deve essere introdotto dal comando |\sitem{...}|. L'usuale comando |\item| deve essere indicato all'interno di |\sitem|. L'ambiente accetta una lista separata da virgole di opzioni definite dal pacchetto |enumitem|. La sintassi è la seguente:
1312 %\iffalse
1313 %<*example>
1314 %\fi
1315 \begin{lstlisting}
1316 \begin{shuffledenumerate}[*@\meta{enumitem options}@*]
1317 \sitem{ ... }
1318 \end{shuffledenumerate}
1319 \end{lstlisting}
1320 %\iffalse
1321 %</example>
1322 %\fi
1323 % \iffalse
1324 %<*example>
1325 % \fi
1326 \stepcounter{id}
1327 \begin{sourcecode}
1328 \begin{shuffledenumerate}[(i)]
1329 \sitem{\item Domanda 1}
1330 \sitem{\item Domanda 2}
1331 \sitem{\item Domanda 3}
1332 \end{shuffledenumerate}
1333 \end{sourcecode}
1334 \begin{render}
1335 \begin{shuffledenumerate}[(i)]
1336 \sitem{\item Domanda 1}
1337 \sitem{\item Domanda 2}
1338 \sitem{\item Domanda 3}
1339 \end{shuffledenumerate}
1340 \end{render}
1341 % \iffalse
1342 %</example>
1343 % \fi
1344 %
1345 %\bigskip\DescribeMacro{shuffleditemize} L'ambiente |shuffleditemize| viene utilizzato per produrre elenchi puntati in cui l'ordine degli elementi venga randomicamente mescolato. Ogni elemento deve essere introdotto dal comando |\sitem{...}|. L'usuale comando |\item| deve essere indicato all'interno di |\sitem|. L'ambiente accetta una lista separata da virgole di opzioni definite dal pacchetto |enumitem|. La sintassi è la seguente:
1346 %\iffalse
1347 %<*example>
1348 %\fi
1349 \begin{lstlisting}
1350 \begin{shuffleditemize}[*@\meta{enumitem options}@*]
1351 \sitem{ ... }
1352 \end{shuffleditemize}
1353 \end{lstlisting}
1354 %\iffalse
1355 %</example>
1356 %\fi
1357 % \iffalse
1358 %<*example>
1359 % \fi
1360 \stepcounter{id}
1361 \begin{sourcecode}
1362 \begin{shuffleditemize}
1363 \sitem{\item Domanda 1}
1364 \sitem{\item Domanda 2}
1365 \sitem{\item Domanda 3}
1366 \end{shuffleditemize}
1367 \end{sourcecode}
1368 \begin{render}
1369 \begin{shuffleditemize}
1370 \sitem{\item Domanda 1}
1371 \sitem{\item Domanda 2}
1372 \sitem{\item Domanda 3}
1373 \end{shuffleditemize}
1374 \end{render}
1375 % \iffalse
1376 %</example>
1377 % \fi
1378 %
1379 %\bigskip\DescribeMacro{shuffledclosed} L'ambiente |shuffledclosed| viene utilizzato per produrre elenchi di domande a crocette in cui l'ordine degli elementi venga randomicamente mescolato. Ogni elemento deve essere introdotto dal comando |\sitem{...}|. L'usuale comando |\item| deve essere indicato all'interno di |\sitem|. L'ambiente accetta una lista separata da virgole di opzioni definite dall'ambiente |closedquestion|. La sintassi è la seguente:
1380 %\iffalse
1381 %<*example>
1382 %\fi
1383 \begin{lstlisting}
1384 \begin{shuffledclosed}[*@\meta{closedquestion options}@*]
1385 \sitem{ ... }
1386 \end{shuffledclosed}
1387 \end{lstlisting}
1388 %\iffalse
1389 %</example>
1390 %\fi
1391 % \iffalse
1392 %<*example>
1393 % \fi
1394 \stepcounter{id}
1395 \begin{sourcecode}
1396 \begin{shuffledclosed}
1397 \sitem{\item Domanda 1}
1398 \sitem{\item[\checked] Domanda 2}
1399 \sitem{\item Domanda 3}
1400 \end{shuffledclosed}
1401 \end{sourcecode}
1402 \begin{render}
1403 \begin{shuffledclosed}
1404 \sitem{\item Domanda 1}
1405 \sitem{\item[\checked] Domanda 2}
1406 \sitem{\item Domanda 3}
1407 \end{shuffledclosed}
1408 \end{render}
1409 % \iffalse
1410 %</example>
1411 % \fi
1412 %
1413 %\bigskip Gli ambienti possono anche essere annidati l'uno dentro l'altro.
1414 %
1415 % \iffalse
1416 %<*example>
1417 % \fi
1418 \stepcounter{id}
1419 \begin{sourcecode}
1420 \begin{shuffledenumerate}
1421 \sitem{\item Primo}
1422 \sitem{\item Secondo
1423 \begin{shuffleditemize}
1424 \sitem{\item $\alpha$}
1425 \sitem{\item $\beta$}
1426 \sitem{\item $\gamma$}
1427 \end{shuffleditemize}
1428 }
1429 \sitem{\item Terzo
1430 \begin{shuffledclosed}
1431 \sitem{\item Q 1}
1432 \sitem{\item Q 2}
1433 \sitem{\item[\checked] Q 3}
1434 \end{shuffledclosed}
1435 }
1436 \end{shuffledenumerate}
1437 \end{sourcecode}
1438 \begin{render}
1439 \begin{shuffledenumerate}
1440 \sitem{\item Primo}
1441 \sitem{\item Secondo
1442 \begin{shuffleditemize}
1443 \sitem{\item $\alpha$}
1444 \sitem{\item $\beta$}
1445 \sitem{\item $\gamma$}
1446 \end{shuffleditemize}
1447 }
1448 \sitem{\item Terzo
1449 \begin{shuffledclosed}
1450 \sitem{\item Q 1}
1451 \sitem{\item Q 2}
1452 \sitem{\item[\checked] Q 3}
1453 \end{shuffledclosed}
1454 }
1455 \end{shuffledenumerate}
1456 \end{render}
1457 % \iffalse
1458 %</example>
1459 % \fi
1460
1461
1462
1463 %\clearpage
1464 % \StopEventually{\clearpage\PrintChanges \clearpage\PrintIndex}
1465 % \section{Implementation}
1466 %\subsection{Require packages}
1467 % The implementation of the \textsf{verifiche} package starts with the required packages:
1468 % \begin{macrocode}
1469 \RequirePackage{xparse}
1470 \RequirePackage{xkeyval}
1471 \RequirePackage{pgffor}
1472 \RequirePackage[shortlabels, inline]{enumitem}
1473 \RequirePackage{tikz}
1474 \RequirePackage[normalem]{ulem}
1475 \RequirePackage[nomessages]{fp}
1476 \RequirePackage{randomlist}
1477 % \end{macrocode}
1478 %
1479 %
1480 %\subsection{newif}
1481 %Some conditionals are defined and initiated:
1482 %\iffalse
1483 %%newif
1484 %\fi
1485 % \begin{macrocode}
1486 \newif\ifsol
1487 \newif\ifinstitute\institutetrue
1488 \newif\ifinstruction\instructiontrue
1489 \newif\ifduration\durationtrue
1490 \newif\ifasyear\asyeartrue
1491 \newif\ifsolutionscolor\solutionscolorfalse
1492 \newif\ifcandidatename\candidatenametrue
1493 \newif\iftesttype\testtypetrue
1494 \newif\ifsubtitle\subtitletrue
1495 \newif\ifshowinstructiondelimiter\showinstructiondelimiterfalse
1496 \newif\ifprintedheading\printedheadingfalse
1497 \newif\ifexercisesnumbered\exercisesnumberedtrue
1498 \newif\ifshowmarginexercise\showmarginexercisefalse
1499 \newif\ifshowexercisept\showexercisepttrue
1500 \newif\ifopenquestionlines\openquestionlinesfalse
1501 \newif\ifopenquestionsquared\openquestionsquaredfalse
1502 \newif\ifclosedquestioninline\closedquestioninlinefalse
1503 % \end{macrocode}
1504 %iffalse
1505 %%openquestionstyle
1506 %fi
1507 % \begin{macrocode}
1508 \newcommand{\@verifiche@closedquestion@frame}[1]{\setlength{\fboxsep}{0pt}\fbox{\parbox[c][1em][c]{1em}{#1}}}
1509 %
1510 \newcommand{\closedquestionitem}{\@verifiche@closedquestion@frame{~}}
1511 \define@choicekey+{closedquestion}{style}[\val\nr]{Letter,letter,arabic,Roman,roman}{%
1512 \ifcase\nr\relax
1513 \renewcommand{\closedquestionitem}{%
1514 \@verifiche@closedquestion@frame{%
1515 \centering%
1516 \Alph{%
1517 \ifclosedquestioninline%
1518 @verifiche@inlineclosedquestioni%
1519 \else%
1520 closedquestioni%
1521 \fi}}}%
1522 \or
1523 \renewcommand{\closedquestionitem}{%
1524 \@verifiche@closedquestion@frame{%
1525 \centering%
1526 \alph{%
1527 \ifclosedquestioninline%
1528 @verifiche@inlineclosedquestioni%
1529 \else%
1530 closedquestioni%
1531 \fi}}}%
1532 \or
1533 \renewcommand{\closedquestionitem}{%
1534 \@verifiche@closedquestion@frame{%
1535 \centering%
1536 \arabic{%
1537 \ifclosedquestioninline%
1538 @verifiche@inlineclosedquestioni%
1539 \else%
1540 closedquestioni%
1541 \fi}}}%
1542 \or
1543 \renewcommand{\closedquestionitem}{%
1544 \@verifiche@closedquestion@frame{%
1545 \centering%
1546 \Roman{%
1547 \ifclosedquestioninline%
1548 @verifiche@inlineclosedquestioni%
1549 \else%
1550 closedquestioni%
1551 \fi}}}%
1552 \or
1553 \renewcommand{\closedquestionitem}{%
1554 \@verifiche@closedquestion@frame{%
1555 \centering%
1556 \roman{%
1557 \ifclosedquestioninline%
1558 @verifiche@inlineclosedquestioni%
1559 \else%
1560 closedquestioni%
1561 \fi}}}%
1562 \fi
1563 }{%
1564 \PackageWarning{verifiche}{Unknown closedquestion style}%
1565 }
1566 % \end{macrocode}
1567
1568 %\subsection{Package options declaration}
1569 %The package provides some options to control the aspect of the document and the mode of the document ("test" mode or "solutions" mode).
1570 %\iffalse
1571 %%Package option declaration
1572 %\fi
1573 % \begin{macrocode}
1574 \DeclareOptionX{solutions}[]{\soltrue}
1575 \DeclareOptionX{noinstitute}[]{\institutefalse}
1576 \DeclareOptionX{noinstruction}[]{\instructionfalse}
1577 \DeclareOptionX{noduration}[]{\durationfalse}
1578 \DeclareOptionX{noasyear}[]{\asyearfalse}
1579 \DeclareOptionX{nocandidatename}[]{\candidatenamefalse}
1580 \DeclareOptionX{notesttype}[]{\testtypefalse}
1581 \DeclareOptionX{nosubtitle}[]{\subtitlefalse}
1582 \DeclareOptionX{nonumbered}[]{\exercisesnumberedfalse}
1583 \DeclareOptionX{noexercisept}[]{\showexerciseptfalse}
1584 \DeclareOptionX{color}[red]{\solutionscolortrue\def\solutionscolor{#1}}
1585 \DeclareOptionX{red}[]{\ExecuteOptionsX{color=red}}
1586 \DeclareOptionX{blue}[]{\ExecuteOptionsX{color=blue}}
1587 \DeclareOptionX{closedquestionstyle}[]{\ExecuteOptionsX<closedquestion>{style=#1}}
1588 \DeclareOptionX*{\PackageWarning{verifiche}{Unknown ‘\CurrentOption’}}
1589 \ProcessOptionsX
1590 % \end{macrocode}
1591 %
1592 %\subsection{Counters}
1593 %The package use some predefined counters: the number of the exercise is controlled by |exercisenumber|, while the partial points of an exercise are summed into |partialpoints| (and it's reseted every new exercise) to produce the sum of the partial points for a given exercise.
1594 %\iffalse
1595 %%counters
1596 %\fi
1597 % \begin{macrocode}
1598 \newcounter{exercisenumber}%
1599 \newcounter{partialpoints}[exercisenumber]%
1600 \newcounter{shuffleitemscount}%
1601 % \end{macrocode}
1602 %\subsection{Length}
1603 %\iffalse
1604 %%newlenght
1605 %\fi
1606 %In order to fine-tuning the dimension of the rulers in the headers and to leave the possibility to the user to redefine their dimensions, some length are introduced.
1607 % \begin{macrocode}
1608 \newlength{\candidatenamerulerlength}
1609 \newlength{\classrulerlength}
1610 \newlength{\daterulerlength}
1611 \newlength{\ptrulerlength}
1612 \newlength{\columnseparation}
1613 \newlength{\verifiche@remainingvspace}
1614 \newlength{\verifiche@remaininghspace}
1615 \newlength{\verifiche@truefalse@squares}
1616 \newlength{\spacedim}
1617 \setlength{\candidatenamerulerlength}{.35\textwidth}
1618 \setlength{\classrulerlength}{.1\textwidth}
1619 \setlength{\daterulerlength}{.15\textwidth}
1620 \setlength{\ptrulerlength}{1cm}
1621 \setlength{\columnseparation}{\fill}
1622 \setlength{\verifiche@truefalse@squares}{1em}
1623 % \end{macrocode}
1624 %
1625 %\subsection{Labels}
1626 %\iffalse
1627 %%labels
1628 %\fi
1629 %Some labels are define as a variable in order to leave the user the possibility of customization the predefine texts.
1630 %If the package \textsf{babel} or \textsf{polyglossia} is loaded with the italian language specify, than the predefine labels are redefine:
1631 % \begin{macrocode}
1632 \newcommand{\@verifiche@durationlabeldefault}{Time:}%
1633 \newcommand{\@verifiche@asyearlabeldefault}{School year}%
1634 \newcommand{\@verifiche@headercandidatenamelabel}{Name and Surname}%
1635 \newcommand{\@verifiche@headerclasslabel}{Class}%
1636 \newcommand{\@verifichhe@headerdatelabel}{Date}%
1637 \newcommand{\@verifiche@exerciselabel}{Exercise}%
1638 \newcommand{\@verifiche@solutionlabel}{Solution}%
1639 \newcommand{\@verifiche@Tletter}{T}%
1640 \newcommand{\@verifiche@Fletter}{F}%
1641 %
1642 \newcommand{\italiandictiornary}{%
1643 \renewcommand{\@verifiche@durationlabeldefault}{Tempo della prova:}%
1644 \renewcommand{\@verifiche@asyearlabeldefault}{Anno scolastico}%
1645 \renewcommand{\@verifiche@headercandidatenamelabel}{Nome e Cognome}%
1646 \renewcommand{\@verifiche@headerclasslabel}{Classe}%
1647 \renewcommand{\@verifichhe@headerdatelabel}{Data}%
1648 \renewcommand{\@verifiche@exerciselabel}{Quesito}%
1649 \renewcommand{\@verifiche@solutionlabel}{Soluzione}%
1650 \renewcommand{\@verifiche@Tletter}{V}%
1651 \renewcommand{\@verifiche@Fletter}{F}%
1652 }%
1653 \@ifpackageloaded{babel}{% if babel is loaded
1654 \addto\captionsitalian{\italiandictiornary}%
1655 }{%else if polyglossia is loaded
1656 \@ifpackageloaded{polyglossia}{%
1657 \addto\captionsitalian{\italiandictiornary}%
1658 }{}%
1659 }%
1660 % \end{macrocode}
1661 % \begin{macrocode}
1662 \newcommand{\@durationlabeldefault}{\@verifiche@durationlabeldefault}%
1663 \newcommand{\@asyearlabeldefault}{\@verifiche@asyearlabeldefault}%
1664 \newcommand{\headercandidatenamelabel}{\@verifiche@headercandidatenamelabel}%
1665 \newcommand{\headerclasslabel}{\@verifiche@headerclasslabel}%
1666 \newcommand{\headerdatelabel}{\@verifichhe@headerdatelabel}%
1667 \newcommand{\exerciselabel}{\@verifiche@exerciselabel}%
1668 \newcommand{\solutionlabel}{\@verifiche@solutionlabel}%
1669 % \end{macrocode}
1670 %\subsection{Macro and environment}
1671 %\iffalse
1672 %%macro and environment
1673 %\fi
1674 %\paragraph{Global variables}The package defined some global variable, that are used to indicate the institute, the year, the duration of the test, its type, the instructions and the scolar year.
1675 %\iffalse
1676 %%global variable
1677 %\fi
1678 % \begin{macrocode}
1679 \newcommand{\institute}[1]{%
1680 \gdef\@institute{#1}}
1681 \newcommand{\testduration}[2][\@durationlabeldefault]{%
1682 \gdef\@durationpreamble{#1}\gdef\@duration{#2}%
1683 \showinstructiondelimitertrue}%
1684 \newcommand{\testtype}[1]{%
1685 \gdef\@testtype{#1}}
1686 \newcommand{\subtitle}[1]{%
1687 \gdef\@subtitle{#1}}%
1688 \newcommand{\instruction}[1]{%
1689 \gdef\@instruction{\ignorespaces#1}%
1690 \showinstructiondelimitertrue}
1691 \newcommand{\asyear}[2][\@asyearlabeldefault]{%
1692 \gdef\@asyearpreamble{#1}\gdef\@asyear{#2}}
1693 % \end{macrocode}
1694 %
1695 %\paragraph{Fonts and aspects}
1696 %One of the feature of this package is the flexibility about the aspect of the final result. All the main font or typographic elements (like instructions delimiters or the difficulty symbol) are defined as macro.
1697 %\iffalse
1698 %%fonts and aspects
1699 %\fi
1700 % \begin{macrocode}
1701 \newcommand{\headerfont}[1]{%
1702 \sffamily\color{darkgray}#1}
1703 % \end{macrocode}
1704 % \begin{macrocode}
1705 \newcommand{\institutefont}[1]{%
1706 \large \sffamily\color{darkgray}#1}
1707 % \end{macrocode}
1708 % \begin{macrocode}
1709 \newcommand{\asyearfont}[1]{%
1710 #1}
1711 % \end{macrocode}
1712 % \begin{macrocode}
1713 \newcommand{\testtypefont}[1]{%
1714 \bgroup\scshape\huge#1\egroup}
1715 % \end{macrocode}
1716 % \begin{macrocode}
1717 \newcommand{\subtitlefont}[1]{%
1718 \bgroup\Large\scshape#1\egroup}%
1719 % \end{macrocode}
1720 % \begin{macrocode}
1721 \newcommand{\instructiondelimiter}{%
1722 \hrulefill}
1723 % \end{macrocode}
1724 % \begin{macrocode}
1725 \newcommand{\instrunctionfont}[1]{%
1726 \sffamily#1}
1727 % \end{macrocode}
1728 % \begin{macrocode}
1729 \newcommand{\testdurationfont}[1]{%
1730 \bgroup\hspace*{\fill}\@durationpreamble\space\bfseries #1\hspace*{\fill}\egroup}
1731 % \end{macrocode}
1732 % \begin{macrocode}
1733 \newcommand{\@header@candidatename}{%
1734 \noindent\headercandidatenamelabel%
1735 \space\underline{\hspace{\candidatenamerulerlength}}}
1736 \newcommand{\@header@class}{%
1737 \headerclasslabel\space%
1738 \underline{\hspace{\classrulerlength}}}
1739 \newcommand{\@header@date}{%
1740 \headerdatelabel\space%
1741 \underline{\hspace{\daterulerlength}}}
1742 \newcommand{\@header}{%
1743 \@header@candidatename\hfill\@header@class\hfill\@header@date}
1744 % \end{macrocode}
1745 % \begin{macrocode}
1746 \newcommand{\solutionfont}{%
1747 \footnotesize%
1748 \ifsolutionscolor\color{\solutionscolor}\fi%
1749 \itshape}
1750 % \end{macrocode}
1751 % \begin{macrocode}
1752 \newcommand{\diffsymb}{%
1753 $\bullet$}
1754 % \end{macrocode}
1755 % \begin{macrocode}
1756 \newcommand{\ptfont}{\normalsize}%
1757 % \end{macrocode}
1758 %\iffalse
1759 %%pt prefix
1760 %\fi
1761 % \begin{macrocode}
1762 \newcommand{\@ptprefix}{%
1763 \underline{\hspace{\ptrulerlength}}/}
1764 \newcommand{\ptprefix}[1]{%
1765 \renewcommand{\@ptprefix}{#1}}
1766 % \end{macrocode}
1767 %\iffalse
1768 %%partialpt prefix
1769 %\fi
1770 % \begin{macrocode}
1771 \newcommand{\@partialptprefix}{}
1772 \newcommand{\partialptprefix}[1]{%
1773 \renewcommand{\@partialptprefix}{#1}}
1774 % \end{macrocode}
1775 %\iffalse
1776 %%pt label
1777 %\fi
1778 % \begin{macrocode}
1779 \newcommand{\@ptsinglabel}{pt}
1780 \newcommand{\@ptplurlabel}{pt}
1781 \NewDocumentCommand{\ptlabel}{o m}{%
1782 \renewcommand{\@ptplurlabel}{#2}%
1783 \renewcommand{\@ptsinglabel}{\IfNoValueTF{#1}{#2}{#1}}}%
1784 \newcommand{\@useptlabel}[1]{%
1785 \FPifeq{#1}{1} \@ptsinglabel \else \@ptplurlabel\fi}%
1786 % \end{macrocode}
1787 %\iffalse
1788 %%partialpt label
1789 %\fi
1790 % \begin{macrocode}
1791 \newcommand{\@partialptsinglabel}{pt}
1792 \newcommand{\@partialptplurlabel}{pt}
1793 \NewDocumentCommand{\partialptlabel}{o m}{%
1794 \renewcommand{\@partialptplurlabel}{#2}%
1795 \renewcommand{\@partialptsinglabel}{\IfNoValueTF{#1}{#2}{#1}}}%
1796 \newcommand{\@usepartialptlabel}[1]{%
1797 \FPifeq{#1}{1} \@partialptsinglabel \else \@partialptplurlabel\fi}%
1798 % \end{macrocode}
1799 %\iffalse
1800 %%partialpt delimiter
1801 %\fi
1802 % \begin{macrocode}
1803 \newcommand{\@lpartialpt@delimiter}{(}
1804 \newcommand{\@rpartialpt@delimiter}{)}
1805 \newcommand{\@definepartialptdelimiter}[2]{
1806 \renewcommand{\@lpartialpt@delimiter}{#1}
1807 \renewcommand{\@rpartialpt@delimiter}{#2}}
1808 \newcommand{\partialptdelimiters}[1]{%
1809 \@definepartialptdelimiter#1}
1810 % \end{macrocode}
1811 %\iffalse
1812 %%pt delimiter
1813 %\fi
1814 % \begin{macrocode}
1815 \newcommand{\@lpt@delimiter}{}
1816 \newcommand{\@rpt@delimiter}{}
1817 \newcommand{\@defineptdelimiter}[2]{%
1818 \renewcommand{\@lpt@delimiter}{#1}%
1819 \renewcommand{\@rpt@delimiter}{#2}}
1820 \newcommand{\ptdelimiters}[1]{%
1821 \@defineptdelimiter#1}
1822 % \end{macrocode}
1823 %\iffalse
1824 %% checkmaker
1825 %\fi
1826 % \begin{macrocode}
1827 \newcommand{\checkmarker}{\huge$\times$\hspace*{-.15em}}%
1828 \newcommand{\verifiche@checkmarker}{%
1829 \bgroup%
1830 \ifsolutionscolor\color{\solutionscolor}\fi%
1831 \checkmarker%
1832 \egroup}%
1833 % \end{macfrocode}
1834 %\iffalse
1835 %% convert ref to num
1836 %\fi
1837 % \begin{macrocode}
1838 \newcommand*{\convertreftonum}[1]{%
1839 \romannumeral
1840 \@ifundefined{r@#1}{%
1841 \expandafter\ltx@zero
1842 \rc@default}{%
1843 \expandafter\expandafter\expandafter\rc@extract@
1844 \expandafter\expandafter\expandafter!%
1845 \csname r@#1\expandafter\endcsname
1846 \expandafter{\rc@default}\@nil}%
1847 }
1848 \def\rc@default{0}%
1849 \long\def\rc@extract@#1#2#3\@nil{%
1850 \ltx@zero
1851 #2}
1852 \chardef\ltx@zero=0%
1853 % \end{macrocode}
1854 %\iffalse
1855 %% init vertical/horizontal remaining space
1856 %\fi
1857 % \begin{macrocode}
1858 \newcommand{\verifiche@initremainingvspace}{%
1859 \pgfmathsetlength{\verifiche@remainingvspace}{%
1860 floor((\dimexpr\pagegoal-\pagetotal-.5\baselineskip\relax)/\spacedim)*\spacedim%
1861 }%
1862 }%
1863 \newcommand{\verifiche@initremaininghspace}{%
1864 \pgfmathsetlength{\verifiche@remaininghspace}{%
1865 floor(\linewidth/\spacedim)*\spacedim%
1866 }%
1867 }%
1868 % \end{macrocode}
1869
1870 %\paragraph{Page styles}
1871 %The package define two new pagestyle: \texttt{mainverifiche} and \texttt{verifiche}. The former is used if \verb|\@institute| is defined (or if \verb|noinstitute| is not declared) as \verb|\thispagestyle| mode. The latter can be used by the user and print, on the odd pages, the name, date and class of the candidate.
1872 %\iffalse
1873 %%pagestyles
1874 %\fi
1875 % \begin{macrocode}
1876 \newcommand{\ps@mainverifiche}{%
1877 \renewcommand\@oddhead{%
1878 \parbox{\textwidth}{\centering \institutefont{\@institute}}%
1879 }%
1880 \renewcommand\@evenhead{}%
1881 \renewcommand{\@oddfoot}{\hfill\normalfont\textrm\thepage\hfill}%
1882 \let\evenfoot\@oddfoot%
1883 }
1884 \newcommand{\ps@verifiche}{%
1885 \renewcommand\@oddhead{
1886 \ifodd\thepage\parbox{\textwidth}{\headerfont\@header}\fi}%
1887 \renewcommand{\@oddfoot}{\hfill\normalfont\textrm\thepage\hfill}%
1888 \let\evenfoot\@oddfoot%
1889 }
1890 % \end{macrocode}
1891 %
1892 %\paragraph{Heading styles}The purpose of |\printheading| macro is to typeset the headings of the page, printing the name of the institute (if included), the type of the test (if included) and so on.
1893 %\iffalse
1894 %%define the heading style command
1895 %\fi
1896 % \begin{macrocode}
1897 \newcommand{\defineheadingstyle}[2]{
1898 \expandafter\newcommand\csname @verifichehdgsty#1\endcsname{%
1899 \gdef\printheading{#2}}
1900 }
1901 % \end{macrocode}
1902 %\iffalse
1903 %%use the heading style
1904 %\fi
1905 % \begin{macrocode}
1906 \newcommand{\headingstyle}[1]{
1907 \ifcsname @verifichehdgsty#1\endcsname{%
1908 \csname @verifichehdgsty#1\endcsname%
1909 }%
1910 \else%
1911 \PackageError{verifiche}{%
1912 Headings style "#1" is not define.
1913 }{%
1914 Headings style "#1" is not define.
1915 Use \noexpand\defineheadingstyle to define a new ones before use it.%
1916 }%
1917 \fi%
1918 }%
1919 % \end{macrocode}
1920 %\iffalse
1921 %%define "einstein" style
1922 %\fi
1923 % \begin{macrocode}
1924 \defineheadingstyle{einstein}{%
1925 {\ifdefined\@institute\ifinstitute\thispagestyle{mainverifiche}\fi\else\thispagestyle{empty}\fi}%
1926 {\ifcandidatename%
1927 \noindent%
1928 \begin{minipage}[t]{.5\textwidth}%
1929 \vspace{0mm}%
1930 \headerfont{\@header@candidatename\\[.5em]%
1931 \@header@class\\[.5em]%
1932 \@header@date}%
1933 \end{minipage}}\fi%
1934 \begin{minipage}[t]{.5\textwidth}%
1935 \vspace{0mm}%
1936 {\ifdefined\@asyear\ifasyear\hspace*{\fill}\asyearfont{\@asyearpreamble\space\@asyear}\hspace*{\fill}\par\vspace{\baselineskip}\fi\fi}%
1937 {\ifdefined\@testtype\iftesttype\makebox[\linewidth][s]{\testtypefont{\@testtype}}\par\fi\fi}%
1938 {\ifdefined\@subtitle\ifsubtitle\vspace{\baselineskip}\hspace*{\fill}\subtitlefont{\@subtitle}\hspace*{\fill}\par\fi\fi}%
1939 \end{minipage}%
1940 \par\vspace{\baselineskip}%
1941 {\ifshowinstructiondelimiter\noindent\instructiondelimiter\par\fi}%
1942 {\ifdefined\@instruction\ifinstruction\instrunctionfont{\noindent\@instruction}\par\fi\fi}%
1943 {\ifdefined\@duration\ifduration\hspace*{\fill}\testdurationfont\@duration\hspace*{\fill}\par\fi\fi}%
1944 {\ifshowinstructiondelimiter\noindent\instructiondelimiter\par\fi}%
1945 }%
1946 % \end{macrocode}
1947 %\iffalse
1948 %%define "cattaneo" style
1949 %\fi
1950 % \begin{macrocode}
1951 \defineheadingstyle{cattaneo}{%
1952 {\ifdefined\@institute\ifinstitute\thispagestyle{mainverifiche}\fi\else\thispagestyle{empty}\fi}%
1953 {\ifdefined\@asyear\ifasyear\hspace*{\fill}\asyearfont{\@asyearpreamble\space\@asyear}\hspace*{\fill}\par\vspace{\baselineskip}\fi\fi}%
1954 {\ifdefined\@testtype\iftesttype\hspace*{\fill}\testtypefont{\@testtype}\hspace*{\fill}\par\fi\fi}%
1955 {\ifdefined\@subtitle\ifsubtitle\vspace{\baselineskip}\hspace*{\fill}\subtitlefont{\@subtitle}\hspace*{\fill}\par\vspace{\baselineskip}
1956 \fi\fi}%
1957 {\ifcandidatename\@header\par\vspace{\baselineskip}\fi}%
1958 {\ifshowinstructiondelimiter\noindent\instructiondelimiter\par\fi}%
1959 {\ifdefined\@instruction\ifinstruction\instrunctionfont{\noindent\@instruction}\par\fi\fi}%
1960 {\ifdefined\@duration\ifduration\hspace*{\fill}\testdurationfont\@duration\hspace*{\fill}\par\fi\fi}%
1961 {\ifshowinstructiondelimiter\noindent\instructiondelimiter\par\fi}%
1962 }
1963 % \end{macrocode}
1964 %\iffalse
1965 %%define "galilei" style
1966 %\fi
1967 % \begin{macrocode}
1968 \defineheadingstyle{galilei}{%
1969 {\ifdefined\@institute\ifinstitute\thispagestyle{mainverifiche}\fi\else\thispagestyle{empty}\fi}%
1970 {\ifcandidatename\@header\par\vspace{\baselineskip}\fi}%
1971 {\ifdefined\@asyear\ifasyear\hspace*{\fill}\asyearfont{\@asyearpreamble\space\@asyear}\hspace*{\fill}\par\vspace{\baselineskip}\fi\fi}%
1972 {\ifdefined\@testtype\iftesttype\hspace*{\fill}\testtypefont{\@testtype}\hspace*{\fill}\par\fi\fi}%
1973 {\ifdefined\@subtitle\ifsubtitle\vspace{\baselineskip}\hspace*{\fill}\subtitlefont{\@subtitle}\hspace*{\fill}\par\fi\fi}%
1974 {\ifshowinstructiondelimiter\noindent\instructiondelimiter\par\fi}%
1975 {\ifdefined\@instruction\ifinstruction\instrunctionfont{\noindent\@instruction}\par\fi\fi}%
1976 {\ifdefined\@duration\ifduration\hspace*{\fill}\testdurationfont\@duration\hspace*{\fill}\par\fi\fi}%
1977 {\ifshowinstructiondelimiter\noindent\instructiondelimiter\par\fi}%
1978 }
1979 % \end{macrocode}
1980 %\iffalse
1981 %% default style: "galilei"
1982 %\fi
1983 % \begin{macrocode}
1984 \headingstyle{galilei}
1985 % \end{macrocode}
1986 %
1987 %\paragraph{Esercizio.} The main element of the package is the |esericizio| environment.
1988 %It accepts some options define via |xkeyval| package. The element that are reproduced in the left margin are stored into a box and produce if |showmargin| boolean variable is switch to \textit{true}.\par
1989 %\iffalse
1990 %%ambiente esercizio
1991 %\fi
1992 % \begin{macrocode}
1993 \define@key{esercizio}{label}[\exerciselabel]{%
1994 \def\tempeserciziolabel{#1}}%
1995 \define@key{esercizio}{diff}[none]{
1996 \def\diffstar{\hfill\foreach \i in {1,..., #1}{\diffsymb}}%
1997 \showmarginexercisetrue}%
1998 \define@key{esercizio}{pt}[none]{
1999 \ifshowexercisept%
2000 \def\pointes{#1}%
2001 \def\espoint{%
2002 \ptfont%
2003 \hfill\@ptprefix\@lpt@delimiter%
2004 \pointes\space\@useptlabel{\pointes}%
2005 \@rpt@delimiter}
2006 \showmarginexercisetrue
2007 \fi}%
2008 \define@key{esercizio}{sumpoints}[none]{%
2009 \ifshowexercisept%
2010 \def\@totalpartialpt{\convertreftonum{ptes@\theexercisenumber}}%
2011 \def\sumpartialpt{%
2012 \ptfont%
2013 \@ptprefix\@lpt@delimiter%
2014 \@totalpartialpt\space\@useptlabel{\@totalpartialpt}%
2015 \@rpt@delimiter}%
2016 \showmarginexercisetrue
2017 \fi}%
2018 \define@key{esercizio}{partialpt}[none]{%
2019 \ifshowexercisept%
2020 \def\@totalpartialpt{\convertreftonum{ptes@\theexercisenumber}}%
2021 \def\sumpartialpt{%
2022 \ptfont%
2023 \@ptprefix\@lpt@delimiter%
2024 \@totalpartialpt\space\@useptlabel{\@totalpartialpt}%
2025 \@rpt@delimiter}%
2026 \showmarginexercisetrue
2027 \fi}%
2028 % \end{macrocode}
2029 %
2030 %
2031 %The part of the exercise (i.e. the title and the margin note) are stored into macro in order to streamline the code.
2032 % \begin{macrocode}
2033 \newcommand{\exercisetitle}{%
2034 \ifdefined\tempeserciziolabel\tempeserciziolabel%
2035 \else \exerciselabel\fi%
2036 }
2037 % \end{macrocode}
2038 %
2039 % \begin{macrocode}
2040 \newsavebox{\box@marginexercise}
2041 % \end{macrocode}
2042 %
2043 % \begin{macrocode}
2044 \newcommand{\exercisemargin}{%
2045 \sbox{\box@marginexercise}{\parbox[t]{\marginparwidth}{%
2046 \ifdefined\diffstar\hfill\diffstar\par\fi% stelle di difficoltà
2047 \ifdefined\espoint\hfill\espoint\par\fi%[-\baselineskip] %punteggio
2048 \ifdefined\sumpartialpt\hfill\sumpartialpt\fi} %punteggio parziale automatico
2049 }%
2050 \reversemarginpar\marginpar{\usebox{\box@marginexercise}}%
2051 }%
2052 % \end{macrocode}
2053 %
2054 % If the exercise admit points, they are stored in the .aux file of the main document in order to be recalled via |\ref| command.
2055 % \begin{macrocode}
2056 \newcommand{\savepointsaux}{%
2057 \ifdefined\sumpartialpt%
2058 \FPeval\sommafinale{clip(partialpoints)}%
2059 \protected@write \@auxout {}{\string\newlabel {ptes@\theexercisenumber}{{\sommafinale}{}}}%
2060 \fi%
2061 \ifdefined\espoint%
2062 \protected@write \@auxout {}{\string\newlabel {ptes@\theexercisenumber}{{\pointes}{}}}%
2063 \fi%
2064 }%
2065 % \end{macrocode}
2066
2067 %\begin{environment}{esercizio}
2068 %The content of the exercise are managed by the |esercizio| environment.
2069 %For every |esercizio| the counter |exercisenumber| is increased, the |showmarginexercise| are reset to false (to avoid the generation of spurious margin note if unnecessary) and the keys are set.
2070 %After that, the code produces the label of the environment, the body and manages the space before e after the environment in the page. If the exercise presents some scores, they are stored via |savepointsaux|.
2071 % \begin{macrocode}
2072 \NewDocumentEnvironment{esercizio}{o +b}{%
2073 \refstepcounter{exercisenumber}%
2074 \FPset\partialpoints{0}%
2075 \showmarginexercisefalse%
2076 \IfValueT{#1}{\setkeys{esercizio}{#1}}%
2077 \par\addvspace{\baselineskip}%
2078 {\noindent\bfseries\exercisetitle\ifexercisesnumbered\space\theexercisenumber\fi}%
2079 \ifshowmarginexercise\exercisemargin\fi%
2080 \par\nopagebreak\@nobreaktrue\ignorespaces% newline after label
2081 \setlength\parindent{0pt}%no parindent
2082 #2%body of the environment
2083 }{%
2084 \par%
2085 \ignorespacesafterend%
2086 \savepointsaux%
2087 }%
2088 % \end{macrocode}
2089 %\end{environment}
2090 %
2091 %
2092 %\begin{environment}{esercizio*}
2093 %The |esercizio*| environment has the same structure of the previous one, except for the code used to show the number of the exercise.
2094 % \begin{macrocode}
2095 \NewDocumentEnvironment{esercizio*}{o +b}{%
2096 \FPset\partialpoints{0}%
2097 \showmarginexercisefalse%
2098 \IfValueT{#1}{\setkeys{esercizio}{#1}}%
2099 \par\addvspace{\baselineskip}{\noindent\bfseries\exercisetitle}%
2100 \ifshowmarginexercise\exercisemargin\fi%
2101 \par\nopagebreak\@nobreaktrue\ignorespaces% newline after label
2102 \setlength\parindent{0pt}%no parindent
2103 #2%body of the environment
2104 }{%
2105 \par%
2106 \ignorespacesafterend
2107 \savepointsaux%print partial pt sum
2108 }%
2109 % \end{macrocode}
2110 %\end{environment}
2111 %
2112 %\begin{macro}{\partialpt}The |partialpt| macro define the content of the margin note where it's used.
2113 % \begin{macrocode}
2114 \NewDocumentCommand{\partialpt}{m}{%
2115 \ifshowexercisept%
2116 \leavevmode\reversemarginpar\marginpar{%
2117 \ptfont\hfill\@partialptprefix%
2118 \@lpartialpt@delimiter#1\space\@usepartialptlabel{#1}%
2119 \@rpartialpt@delimiter%
2120 \FPadd\partialpoints\partialpoints{#1}%
2121 \xdef\partialpoints{\partialpoints}}\ignorespaces%
2122 \fi}%
2123 % \end{macrocode}
2124 %\end{macro}
2125 %\paragraph{Soluzione}
2126 %\begin{environment}{soluzione}
2127 %The main element for the "solutions" mode is the |soluzione| environment.
2128 % \begin{macrocode}
2129 \define@key{soluzione}{label}[\solutionlabel]{%
2130 \def\verifiche@tempsoluzionelabel{#1}%
2131 }
2132 \newcommand{\verifiche@solutionlabel}{%
2133 \ifdefined\verifiche@tempsoluzionelabel\verifiche@tempsoluzionelabel%
2134 \else\solutionlabel\fi%
2135 }%
2136 \NewDocumentEnvironment{soluzione}{o +b}{%
2137 \IfValueT{#1}{\setkeys{soluzione}{#1}}%
2138 \ifsol%
2139 \par\addvspace{\baselineskip}%
2140 {\noindent\bfseries%
2141 \ifsolutionscolor\color{\solutionscolor}\fi%
2142 \verifiche@solutionlabel}%
2143 \par\nopagebreak\@nobreaktrue\noindent\ignorespaces%
2144 \setlength\parindent{0pt}%no parindent
2145 \solutionfont #2%
2146 \fi%
2147 }{%
2148 \ifsol%
2149 \par\ignorespacesafterend
2150 \fi%
2151 }%
2152 % \end{macrocode}
2153 %\end{environment}
2154 %
2155 %\begin{macro}{\inlinesol}
2156 %The code inside |\inlinesol| is composed only if in "solutions" mode.
2157 % \begin{macrocode}
2158 \newcommand{\inlinesol}[1]{%
2159 \ifsol%
2160 \bgroup%
2161 \ifmmode\mathit{\solutionfont#1}%
2162 \else{\solutionfont#1}%
2163 \fi%
2164 \egroup%
2165 \else\ignorespaces%
2166 \fi%
2167 }
2168 % \end{macrocode}
2169 %\end{macro}
2170 %
2171 %
2172 %\begin{macro}{\completetext}
2173 %The |\completetext| print a horizontal line on which write the solution if the "solutions" mode is active.
2174 % \begin{macrocode}
2175 \newcommand{\completetext}[2][4.5cm]{%
2176 \underline{\makebox[#1][c]{\ifsol\solutionfont#2\else\relax\fi}}
2177 }%
2178 % \end{macrocode}
2179 %\end{macro}
2180 %
2181 %\begin{macro}{\truefalse}
2182 %The |\truefalse| is generated via |\tikz| macro.
2183 % \begin{macrocode}
2184 \newcommand{\@verifiche@truefalse@check}{\raisebox{-1.5\depth}[0pt][0pt]{\verifiche@checkmarker}}
2185 \newcommand{\truefalse}[1]{%
2186 %True
2187 \setlength{\fboxsep}{0pt}\fbox{%
2188 \parbox[c][\verifiche@truefalse@squares]{\verifiche@truefalse@squares}{%
2189 \centering\@verifiche@Tletter}}%
2190 \ifsol\if#1\@verifiche@Tletter%
2191 \llap{\@verifiche@truefalse@check}%
2192 \fi%
2193 \fi%
2194 \quad%
2195 %False
2196 \setlength{\fboxsep}{0pt}\fbox{%
2197 \parbox[c][\verifiche@truefalse@squares]{\verifiche@truefalse@squares}{%
2198 \centering\@verifiche@Fletter}}%
2199 \ifsol\if#1\@verifiche@Fletter%
2200 \llap{\@verifiche@truefalse@check}%
2201 \fi%
2202 \fi%
2203 }
2204 % \end{macrocode}
2205 %\end{macro}
2206 %
2207 %
2208 %\begin{macro}{\finderror}
2209 %The |\finderror| write the wrong text in "test mode" and than superimpose some mark (thanks to \textsf{ulem} package) and the correct text in "solutions mode".
2210 % \begin{macrocode}
2211 \newcommand{\finderror}[2]{%
2212 \tikz[baseline=(error.base)]{%
2213 \node[inner sep=0pt](error){\ifsol\xout{#1}\else#1\fi};%
2214 \node[anchor=south, inner sep=2pt] at (error.north){\ifsol\solutionfont#2\else\relax\fi};%
2215 }%
2216 }%
2217 % \end{macrocode}
2218 %\end{macro}
2219 %
2220 %\begin{macro}{\checked}
2221 % The macro |checked| is used to check the correct answer in a multiple choices question.
2222 % \begin{macrocode}
2223 \newcommand{\checked}{%
2224 \ifsol%
2225 \ifclosedquestioninline%
2226 \stepcounter{@verifiche@inlineclosedquestioni}%
2227 \else%
2228 \stepcounter{closedquestioni}%
2229 \fi%
2230 \closedquestionitem\llap{\raisebox{-1.5\depth}[0pt][0pt]{\verifiche@checkmarker}}%
2231 \else%
2232 \ifclosedquestioninline%
2233 \stepcounter{@verifiche@inlineclosedquestioni}%
2234 \else%
2235 \stepcounter{closedquestioni}%
2236 \fi%
2237 \closedquestionitem%
2238 \fi}%
2239 % \end{macrocode}
2240 %\end{macro}
2241 %\begin{environment}{closedquestion}
2242 %The |closedquestion| environment define a new list whose item elements are preceded by square symbol, and every item is |\hfill| spaced. The |\checked| symbol is controlled and generated (in the "solutions mode") via |\tikz|.
2243 %
2244 % \begin{macrocode}
2245 \newlist{closedquestion}{enumerate}{1}%
2246 \setlist[closedquestion]{label=\closedquestionitem, leftmargin=*, parsep=0pt}
2247 \newlist{@verifiche@inlineclosedquestion}{enumerate*}{1}
2248 \setlist[@verifiche@inlineclosedquestion]{label=\closedquestionitem,itemjoin={\hfill}, }
2249 \NewDocumentEnvironment{closedquestion*}{O{} +b}{%
2250 \closedquestioninlinetrue%
2251 \begin{@verifiche@inlineclosedquestion}[#1]#2%
2252 }{%
2253 \end{@verifiche@inlineclosedquestion}%
2254 \closedquestioninlinefalse%
2255 }%
2256 % \end{macrocode}
2257 %\end{environment}
2258
2259 %\begin{macro}{\openquestion}
2260 %The |\openquestion| use key-value options defined as following presented.
2261 % \begin{macrocode}
2262 \define@key{openquestion}{spacedim}[0.5cm]{\setlength{\spacedim}{#1}\verifiche@initremainingvspace\verifiche@initremaininghspace}%
2263 \define@key{openquestion}{height}[\the\verifiche@remainingvspace]{\def\openquestionheight{#1}}%
2264 \define@key{openquestion}{width}[\the\verifiche@remaininghspace]{\def\openquestionwidth{#1}}%
2265 \define@key{openquestion}{linecolor}[gray]{\def\openquestionlinecolor{#1}}%
2266 \define@choicekey*+{openquestion}{type}[\val\nr]{lines, squares}[squares]{%
2267 \ifcase\nr\relax%
2268 % lines
2269 \openquestionsquaredfalse\openquestionlinestrue%
2270 \or%
2271 % squares
2272 \openquestionsquaredtrue\openquestionlinesfalse%
2273 \fi}%
2274 {\PackageError{verifiche}{Errore nell'opzione openquestion}{Inserire lines o squares}}
2275 % \end{macrocode}
2276 %
2277 %The macro starts with an initiation of predefined type of |\openquestion|, than possible options are overloaded.
2278 %Depending on the |type| of the |\openquestion|, squared or ruled background is composed and in the foreground is reproduce the text of the argument of the command (in the "solutions mode").
2279 % \begin{macrocode}
2280 \NewDocumentCommand{\openquestion}{o m}{%
2281 \setkeys{openquestion}{type, spacedim, width, height, linecolor} %init
2282 \IfValueT{#1}{\setkeys{openquestion}{#1}}%
2283 \vspace{-\baselineskip}%
2284 \begin{center}
2285 \ifopenquestionsquared% if squared open question
2286 \begin{tikzpicture}%
2287 \draw[step=\the\spacedim, \openquestionlinecolor]%
2288 (0,0) grid (\openquestionwidth,-\openquestionheight);%
2289 \node[%
2290 anchor=base west,%
2291 align=left, text width=\openquestionwidth,%
2292 inner sep=0cm,%
2293 font=\solutionfont,%
2294 execute at begin node=\setlength{\baselineskip}{\the\spacedim}]%
2295 at (0, -\the\spacedim){\ifsol#2\fi};
2296 \end{tikzpicture}%
2297 \else% if lined open question
2298 \begin{tikzpicture}%
2299 \pgfmathparse{int(\openquestionheight/\the\spacedim)}%
2300 \foreach \y in {1, ..., \pgfmathresult}%
2301 \draw[\openquestionlinecolor] (0, -\y*\the\spacedim) -- +(\openquestionwidth,0);%
2302 \node[%
2303 anchor=base west,align=left,%
2304 text width=\openquestionwidth,%
2305 inner sep=0cm, font=\solutionfont,%
2306 execute at begin node=\setlength{\baselineskip}{\the\spacedim}]%
2307 at (0, -\the\spacedim){\ifsol#2\fi};%
2308 \end{tikzpicture}%
2309 \fi%
2310 \end{center}%
2311 }
2312 % \end{macrocode}
2313 %\end{macro}
2314 %
2315 %
2316 %\begin{macro}{\textandimage}
2317 %The |\textandimage| manages two column material via |minipage| environment.
2318 % \begin{macrocode}
2319 \NewDocumentCommand{\textandimage}{O{.7\textwidth} O{.3\textwidth} m m}{%
2320 \begin{minipage}{#1}
2321 {#3}
2322 \end{minipage}
2323 \hfill
2324 \begin{minipage}{#2}
2325 {#4}
2326 \end{minipage}
2327 }
2328 % \end{macrocode}
2329 %\end{macro}
2330 %
2331 %
2332 %\begin{macro}{\makecolumn}
2333 %The |\makecolumn| give the possibility to create multiple column in the document.
2334 % \begin{macrocode}
2335 \NewDocumentCommand{\makecolumn}{O{t} m +m}{%
2336 \parbox[#1]{#2}{#3}%
2337 \@ifnextchar\makecolumn{\hspace*{\columnseparation}}{}%
2338 }%
2339 % \end{macrocode}
2340 %\end{macro}
2341 %
2342 %\begin{environment}{multitest} The environment |multitest| handle the possibility of generating variation of the same test.
2343 % \begin{macrocode}
2344 \NewDocumentEnvironment{multitest}{O{1} +b}{%
2345 \newcounter{multitestcounter}
2346 \setcounter{multitestcounter}{1}
2347 \loop%
2348 \setcounter{page}{1}%
2349 \setcounter{exercisenumber}{0}%
2350 \pgfmathsetseed{\themultitestcounter}%
2351 \RLsetrandomseed{\themultitestcounter}%
2352 #2%
2353 \clearpage%
2354 \addtocounter{multitestcounter}{1}
2355 \ifnum\value{multitestcounter}<\numexpr#1+1\relax%
2356 \repeat%
2357 }{}%
2358 % \end{macrocode}
2359 %\end{environment}
2360 %
2361 %
2362 %\begin{macro}{\shuffleseed}
2363 %The |\shuffleseed| command set the seed of the shuffled environments
2364 % \begin{macrocode}
2365 \newcommand{\shuffleseed}[1]{\RLsetrandomseed{#1}}%
2366 % \end{macrocode}
2367 % \end{macro}
2368 %
2369 %
2370 %\begin{macro}{\sitem}
2371 %The |\sitem| command load the shuffled item for the shuffled environments
2372 % \begin{macrocode}
2373 \newcommand{\sitem}[1]{\InsertFirstItem{\verifiche@listname}{#1}}%
2374 % \end{macrocode}
2375 % \end{macro}
2376 %
2377 %
2378 %\begin{environment}{shufflenumerate} The environment |shufflenumerate| handle shuffled enumerate lists.
2379 % \begin{macrocode}
2380 \NewDocumentEnvironment{shuffledenumerate}{O{} m}{%
2381 \addtocounter{shuffleitemscount}{1}%
2382 \edef\verifiche@listname{lista\theshuffleitemscount}%
2383 \expandafter\NewList\expandafter{\verifiche@listname}%
2384 #2%
2385 }{%
2386 \begin{enumerate}[#1]%
2387 \ForEachRandomItem{\verifiche@listname}{items}{\items}%
2388 \end{enumerate}%
2389 \expandafter\ClearList\expandafter{\verifiche@listname}%
2390 \addtocounter{shuffleitemscount}{-1}%
2391 }%
2392 % \end{macrocode}
2393 %\end{environment}
2394 %
2395 %
2396 %\begin{environment}{shuffleitemize} The environment |shuffleitemize| handle shuffled itemize lists.
2397 % \begin{macrocode}
2398 \NewDocumentEnvironment{shuffleditemize}{O{} m}{%
2399 \addtocounter{shuffleitemscount}{1}%
2400 \edef\verifiche@listname{lista\theshuffleitemscount}%
2401 \expandafter\NewList\expandafter{\verifiche@listname}%
2402 #2%
2403 }{%
2404 \begin{itemize}[#1]%
2405 \ForEachRandomItem{\verifiche@listname}{items}{\items}%
2406 \end{itemize}%
2407 \expandafter\ClearList\expandafter{\verifiche@listname}%
2408 \addtocounter{shuffleitemscount}{-1}%
2409 }%
2410 % \end{macrocode}
2411 %\end{environment}
2412 %
2413 %
2414 %\begin{environment}{shuffleclosed} The environment |shuffleclosed| handle shuffled closedquestion lists.
2415 % \begin{macrocode}
2416 \NewDocumentEnvironment{shuffledclosed}{m}{%
2417 \addtocounter{shuffleitemscount}{1}%
2418 \edef\verifiche@listname{lista\theshuffleitemscount}%
2419 \expandafter\NewList\expandafter{\verifiche@listname}%
2420 #1%
2421 }{%
2422 \begin{closedquestion}%
2423 \ForEachRandomItem{\verifiche@listname}{items}{\items}%
2424 \end{closedquestion}%
2425 \expandafter\ClearList\expandafter{\verifiche@listname}%
2426 \addtocounter{shuffleitemscount}{-1}%
2427 }%
2428 % \end{macrocode}
2429 %\end{environment}
2430 %
2431 %
2432 % \Finale
2433 \endinput