summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.tex')
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.tex519
1 files changed, 261 insertions, 258 deletions
diff --git a/Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.tex b/Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.tex
index 18cf80123f2..05c7198c686 100644
--- a/Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.tex
+++ b/Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.tex
@@ -46,8 +46,8 @@
\begin{document}
%\GetFileInfo{esami.sty}
% \DocInput{esami.dtx}
- %\PrintChanges
- %\PrintIndex
+%\PrintChanges
+%\PrintIndex
%</driver>
%\fi
@@ -74,27 +74,28 @@
\changes{Versione 2.0}{2015/02/25}{Eliminata la dipendenza da \texttt{pstricks}. Modificato l'inserimento di domande di tipo \emph{fill-in}. Inserita la possibilità di estrarre più esercizi da un solo file. Ora è possibile visualizzare le soluzioni nei test. Modificata la visualizzazione dei decimali nel comando \texttt{FPsv}. Modificata la definizione di \texttt{FPval} in modo da avere cifre decimali. Modificato l'algoritmo di scelta della variante di un esercizio in modo completamente deterministico. Aggiunto il comando \cmd{\Acapo}. Aggiunta la localizzazione serba (alfabeto latino). Ora la compilazione produce un nuovo file con la lista degli esercizi scelti.}
\changes{Versione 2.1}{2016/04/11}{Modificato \texttt{es-german.lng} e \texttt{es-spanish.lng} per errore nell'input delle soluzioni. Introdotto il comando \texttt{randestrai}. Introdotto il comando \texttt{FPsignpol}. Introdotto controllo punteggio totale degli esercizi. Rimossa l'incompatibilità tra il comando \texttt{fillin} e i comandi \texttt{sempli} e \texttt{semplix}.}
\changes{Versione 2.2}{2017/07/01}{Introdotta la possibilità di avere due semi diversi per la scelta degli esercizi (\cmd{\semeex}) e per le permutazioni e scelta dei parametri (\cmd{\seme}): di default sono uguali. Leggermente modificato il comando \cmd{\estrai} così da poter essere usato per estrarre parametri numerici da una lista. Integrata la documentazione.}
+\changes{Versione 2.3}{2017/09/18}{Corretto un errore di battitura nel codice.}
%\IndexPrologue{\section*{Indice} I numeri scritti in italico rimandano alla pagina dove è descritto l'item; i numeri sottolineati rimandano alla riga di codice in cui l'item è descritto; le altre referenze sono alla riga di codice dove l'item è usato.}
\GlossaryPrologue{\section*{Changelog}}
\def\MacroFont{\fontencoding\encodingdefault
-\fontfamily\ttdefault
-\fontseries\mddefault
-\fontshape\updefault
-\footnotesize}
+ \fontfamily\ttdefault
+ \fontseries\mddefault
+ \fontshape\updefault
+ \footnotesize}
\GetFileInfo{esami.sty}
-\def\fileversion{versione 2.2}
-\def\filedate{2017/07/1}
+\def\fileversion{versione 2.3}
+\def\filedate{2017/09/18}
- \title{Il pacchetto esami\thanks{Questo documento
- corrisponde al pacchetto \textsf{esami}~\fileversion, con data \filedate.}}
- \author{Grazia Messineo <grazia.messineo@unicatt.it> \\ Salvatore Vassallo <salvatore.vassallo@unicatt.it>}
+\title{Il pacchetto esami\thanks{Questo documento
+ corrisponde al pacchetto \textsf{esami}~\fileversion, con data \filedate.}}
+\author{Grazia Messineo <grazia.messineo@unicatt.it> \\ Salvatore Vassallo <salvatore.vassallo@unicatt.it>}
\newcommand{\nuovo}[1]{\marginpar{\raggedleft{ \footnotesize{\textsf{Nuovo #1}}}}}
- \maketitle
+\maketitle
- \tableofcontents
- \newpage
+\tableofcontents
+\newpage
\newcommand*\pkgname[1]{\texttt{#1}}
\newcommand*\clsname[1]{\texttt{#1}}
\newcommand*\optname[1]{\emph{#1}}
@@ -110,19 +111,19 @@ Lo sviluppo del pacchetto è iniziato nel 2008 (\cite{esami}, \cite{tug}) con l'
\section{Pacchetti richiesti}
Il pacchetto \pkgname{esami} dipende da alcuni altri pacchetti non standard\footnote{La lista completa dei pacchetti usati in una normale compilazione di un esame è: etex, graphicx, enumerate, fp, currfile, array, environ, ifthen, xargs, xkeyval, multicol, amssymb, amsfonts, xcolor, babel, etoolbox, icomma, numprint, amsmath, fontenc, inputenc, lmodern. Ovviamente ogni pacchetto caricato può avere altre dipendenze.}
\begin{enumerate}
-\item \pkgname{fp}: per le operazioni matematiche;
-\item \pkgname{currfile}: per ottenere il nome del file e della cartella di lavoro;
-\item \pkgname{xargs}: per avere più di un parametro opzionale;
-\item \pkgname{environ}: per trasformare comandi in ambienti.\nuovo{vers. 1.1}
+ \item \pkgname{fp}: per le operazioni matematiche;
+ \item \pkgname{currfile}: per ottenere il nome del file e della cartella di lavoro;
+ \item \pkgname{xargs}: per avere più di un parametro opzionale;
+ \item \pkgname{environ}: per trasformare comandi in ambienti.\nuovo{vers. 1.1}
\end{enumerate}
Inoltre i seguenti pacchetti sono opzionali, ma raccomandati:
\begin{enumerate}
-\item \pkgname{ifluatex} e \pkgname{ifxetex} per la compilazione con \Hologo{XeLaTeX} e \Hologo{LuaLaTeX} (nel seguito si farà riferimento solo alla compilazione con \hologo{pdfLaTeX})\nuovo{vers. 2.0}\footnote{Al momento il supporto per \Hologo{XeLaTeX} e \Hologo{LuaLaTeX} è molto parziale e alcune tipologie di esercizio non sono utilizzabili.}.
- \item \pkgname{lmodern} and \pkgname{amsfonts}: necessari per un buon output in pdf;
-\item \pkgname{numprint}: per un output migliore dei numeri e per avere formati numerici diversi a seconda del linguaggio;
- \item \pkgname{eurosym}: per usare la valuta;
- \item \pkgname{icomma}: dal pacchetto \pkgname{ws} per una corretta formattazione delle virgole. Tale pacchetto può essere sostituito per la lingua italiana dal comando \cmd{\IntelligentComma} di \pkgname{babel}: questa opzione è di default nel file di localizzazione \texttt{es-italian.lng} e può essere modificata commentando il comando \cmd{\IntelligentComma} (o usando il comando \cmd{\NoIntelligentComma})\nuovo{vers. 1.1};
- \item \pkgname{pstricks}, \pkgname{pstricks-add} e \pkgname{auto-pst-pdf} oppure \pkgname{tikz} o altro pacchetto per i grafici\nuovo{vers. 2.0}.
+ \item \pkgname{ifluatex} e \pkgname{ifxetex} per la compilazione con \Hologo{XeLaTeX} e \Hologo{LuaLaTeX} (nel seguito si farà riferimento solo alla compilazione con \hologo{pdfLaTeX})\nuovo{vers. 2.0}\footnote{Al momento il supporto per \Hologo{XeLaTeX} e \Hologo{LuaLaTeX} è molto parziale e alcune tipologie di esercizio non sono utilizzabili.}.
+ \item \pkgname{lmodern} and \pkgname{amsfonts}: necessari per un buon output in pdf;
+ \item \pkgname{numprint}: per un output migliore dei numeri e per avere formati numerici diversi a seconda del linguaggio;
+ \item \pkgname{eurosym}: per usare la valuta;
+ \item \pkgname{icomma}: dal pacchetto \pkgname{ws} per una corretta formattazione delle virgole. Tale pacchetto può essere sostituito per la lingua italiana dal comando \cmd{\IntelligentComma} di \pkgname{babel}: questa opzione è di default nel file di localizzazione \texttt{es-italian.lng} e può essere modificata commentando il comando \cmd{\IntelligentComma} (o usando il comando \cmd{\NoIntelligentComma})\nuovo{vers. 1.1};
+ \item \pkgname{pstricks}, \pkgname{pstricks-add} e \pkgname{auto-pst-pdf} oppure \pkgname{tikz} o altro pacchetto per i grafici\nuovo{vers. 2.0}.
\end{enumerate}
Tutti i pacchetti sono disponibili sia in \Hologo{TeX} Live che in \Hologo{MiKTeX}.
@@ -150,8 +151,8 @@ Il comando \cmd{\Data} stamperà la data in formato lungo (D MMMM YYYY \cmd{\lo
\pagestyle{esame}
%\setcounter{vers}{m}
\end{verbatim}
- Il comando \cmd{\pagestyle} è definito in un file di configurazione (si veda la sezione \ref{sec:cfg}) e definisce gli header e i footer.
- Il comando commentato \cmd{\setcounter}\{vers\}\{$m$\} serve, ponendo nel preambolo \cmd{\numcompiti} un numero $n$ (maggiore di $m$), a generare le versioni da $m+1$ a $n$.
+Il comando \cmd{\pagestyle} è definito in un file di configurazione (si veda la sezione \ref{sec:cfg}) e definisce gli header e i footer.
+Il comando commentato \cmd{\setcounter}\{vers\}\{$m$\} serve, ponendo nel preambolo \cmd{\numcompiti} un numero $n$ (maggiore di $m$), a generare le versioni da $m+1$ a $n$.
\begin{verbatim}
\whiledo{\thevers<\numcompiti}{\stepvers
\end{verbatim}
@@ -168,7 +169,7 @@ genera il seme per i processi di randomizzazione e lo assegna anche a \cmd{\rand
\testa
\istruzionii
\end{verbatim}
- \cmd{\testa}, \cmd{\istruzionii} vengono definiti nel file di configurazione e contengono le istruzioni per la testata e delle eventuali istruzioni per lo svolgimento dell'esame, mentre la macro \cmd{\permuta} permette la randomizzazione dell'ordine degli esercizi.
+\cmd{\testa}, \cmd{\istruzionii} vengono definiti nel file di configurazione e contengono le istruzioni per la testata e delle eventuali istruzioni per lo svolgimento dell'esame, mentre la macro \cmd{\permuta} permette la randomizzazione dell'ordine degli esercizi.
\begin{verbatim}
\begin{test}[punti]
\begin{questions}
@@ -184,7 +185,7 @@ In questo modo si definisce un ambiente per un test tipicamente con domande a ri
\begin{verbatim}
\esercizi{problema1, problema2}
\end{verbatim}
- sceglie tra due esercizi a risposta aperta.
+sceglie tra due esercizi a risposta aperta.
\begin{verbatim}
\closevers
}
@@ -192,7 +193,7 @@ In questo modo si definisce un ambiente per un test tipicamente con domande a ri
\end{document}
\end{verbatim}
Termina la routine di compilazione. L'istruzione \verb|\def\stringasol{}| serve a non generare la stringa delle soluzioni se non desiderata. La compilazione produce un file pdf con tutte le varianti richieste.
- \nuovo{vers. 2.0} Compilando il file delle soluzioni si ottiene anche un file \texttt{filename-sol.loe} (loe = list of exercises) che contiene le label che vengono assegnate agli esercizi scelti, in modo da poterli identificare: infatti ogni esercizio scelto è identificato da una stringa del tipo \emph{e:numero di versione -file:nome del file-q:numero della domanda in cifre romane}.
+\nuovo{vers. 2.0} Compilando il file delle soluzioni si ottiene anche un file \texttt{filename-sol.loe} (loe = list of exercises) che contiene le label che vengono assegnate agli esercizi scelti, in modo da poterli identificare: infatti ogni esercizio scelto è identificato da una stringa del tipo \emph{e:numero di versione -file:nome del file-q:numero della domanda in cifre romane}.
\nuovo{vers. 2.1} Al termine del file delle soluzioni vi è la stringa delle soluzioni delle domande a risposta chiusa: di default tale stringa è per ogni versione inserita in un ambiente \envname{minipage}. Se tale formattazione non fosse adatta ai propri scopi (ad esempio se si hanno 40 domande a risposta chiusa le cui risposte non stanno in una pagina) è possibile modificarla adattando i comandi \cmd{\stepverssols} e \cmd{\closeverssols}: nel file di configurazione di esempio sono presenti, commentate, le definizioni per avere una stringa di soluzioni continua.
@@ -201,35 +202,35 @@ Durante la compilazione viene controllato che il numero di punti indicato per un
\section{Le opzioni del pacchetto}\label{sec:opzioni}
Per usare il pacchetto bisogna usare il solito comando
\cmd{\usepackage}[\meta{options}]\{esami\}. Le opzioni possibili sono:
- \begin{itemize}
- \item {\color{blue}{\optname{allowrandomize}}} e {\color{blue}{\optname{norandomize}}}: la prima permette di permutare in modo casuale l'ordine delle risposte nelle domande a risposta chiusa, la seconda di non permutarlo (di default le risposte vengono permutate in modo casuale).
- \item {\color{blue}{\optname{shuffle}}}, {\color{blue}{\optname{shufflerandom}}} e {\color{blue}{\optname{noshuffle}}}: la prime due permettono di permutare gli esercizi, la prima in modo deterministico se il numero degli esercizi è minore di 9 e casuale se è maggiore, la seconda del tutto casualmente, la terza di non permutarli (l'opzione di default è \optname{shuffle}).
- \item {\color{blue}{\optname{xyz}}}: Fa caricare un file di configurazione (\texttt{esami-xyz.cfg}) con nome dell'esame, istruzioni, ecc. relative a questo esame. Nel file {\tt esami.sty} sono predefinite alcune opzioni; è possibile caricare altre configurazioni definendole in {\tt esami.sty} o creare un proprio file di configurazione e farlo leggere senza modificare il file {\tt esami.sty}: è sufficiente scrivere un'opzione sconosciuta (ad esempio \verb|math|) e scrivere il file {\tt esami-math.cfg}.
- \item {\color{blue}{\optname{pointsonright}}}: fa apparire la casella con il punteggio sulla destra dell'esercizio. Se l'opzione non è specificata, la casella non appare.
- \item {\color{blue}{\optname{nosolutions}}}: questa opzione genera il compito senza soluzioni negli esercizi a risposta aperta e l'indicazione della risposta corretta in quelli a risposta chiusa (default).
- \item {\color{blue}{\optname{solutions}}}: genera il file delle soluzioni.
- \item {\color{blue}{\optname{noquizsolutions}}}: questa opzione genera il compito senza soluzioni nelle domande a risposta chiusa (default).\nuovo{vers. 2.0}
- \item {\color{blue}{\optname{quizsolutions}}}: genera il compito con le soluzioni nelle domande a risposta chiusa.
- \item {\color{blue}{\optname{prova}}}: si usa solo con il file {\tt totale-versioni} (si veda \ref{sec:totale}) e serve per visualizzare tutte le varianti di un esercizio. Fa visualizzare automaticamente le risposte esatte negli esercizi a risposta multipla e la soluzione nei problemi da svolgere.
- \item {\color{blue}{\optname{param}}}: serve per visualizzare le lettere che rappresentano i parametri casuali anziché il valore numerico attribuito. Stampa anche una frase, nella quale sono contenuti il valore iniziale e finale attribuiti ai parametri usati nell'esercizio. Può essere usata solo insieme all'opzione \texttt{prova}.
- \item {\color{blue}{\optname{correzione}}}: stampa solo i testi di tutti gli esercizi, senza soluzioni (funziona solo nel file {\tt totale-versioni}).
- \item {\color{blue}{\optname{fillb}}}: deprecata, resta per compatibilità con le versioni precedenti. Serve quando si usano esercizi di tipo ``fillin'', ma è consigliato usare il comando \cmd{\fillinproblem} (si veda\ref{par:fillin})\nuovo{vers. 2.0}
- \item {\color{blue}{\optname{twocolumns}}}: per scrivere il testo delle domande a risposta chiusa su due colonne (ma si veda anche \ref{duecolonne}).
- \item {\color{blue}{\optname{sansserif}}}: usa caratteri sans serif.
- \item {\color{blue}{\optname{autopston}}} e {\color{blue}{\optname{autopstoff}}}: caricano i pacchetti \pkgname{pstricks}, \pkgname{pstricks-add} e \pkgname{auto-pst-pdf} e permettono di compilare il file direttamente con \hologo{pdfLaTeX} (anche se contiene codice di \pkgname{pstricks}). La prima opzione crea e include direttamente nel documento i file delle immagini, la seconda non crea i file delle immagini (e rende più veloce la compilazione)\VerbatimFootnotes
-\footnote{Per usare \pkgname{auto-pst-pdf} è necessario
-abilitare \texttt{shell-escape} (\Hologo{TeX} Live) o \texttt{write18} (\Hologo{MiKTeX}) nell'esecuzione di \hologo{pdfLaTeX}.}.\nuovo{vers. 2.0}
-\item {\color{blue}{\optname{language}}}: legge il file di localizzazione es-language.lng (si veda \ref{sec:lng}). Nel file sono contenute le traduzioni delle etichette (esercizio, soluzione, \dots ), dei messaggi d'errore, delle intestazioni contenute nel file (\texttt{esami-xyz.cfg}). Di default viene caricato il file della lingua italiana. Poiché le opzioni linguistiche hanno lo stesso nome di quelle usate in \pkgname{babel} è possibile passare l'opzione in \cmd{\documentclass}.
- \end{itemize}
-
- \section{Gli esercizi}
- \subsection{Le varianti}
- Ogni esercizio (con tutte le sue varianti) va scritto in un file separato.
+\begin{itemize}
+ \item {\color{blue}{\optname{allowrandomize}}} e {\color{blue}{\optname{norandomize}}}: la prima permette di permutare in modo casuale l'ordine delle risposte nelle domande a risposta chiusa, la seconda di non permutarlo (di default le risposte vengono permutate in modo casuale).
+ \item {\color{blue}{\optname{shuffle}}}, {\color{blue}{\optname{shufflerandom}}} e {\color{blue}{\optname{noshuffle}}}: la prime due permettono di permutare gli esercizi, la prima in modo deterministico se il numero degli esercizi è minore di 9 e casuale se è maggiore, la seconda del tutto casualmente, la terza di non permutarli (l'opzione di default è \optname{shuffle}).
+ \item {\color{blue}{\optname{xyz}}}: Fa caricare un file di configurazione (\texttt{esami-xyz.cfg}) con nome dell'esame, istruzioni, ecc. relative a questo esame. Nel file {\tt esami.sty} sono predefinite alcune opzioni; è possibile caricare altre configurazioni definendole in {\tt esami.sty} o creare un proprio file di configurazione e farlo leggere senza modificare il file {\tt esami.sty}: è sufficiente scrivere un'opzione sconosciuta (ad esempio \verb|math|) e scrivere il file {\tt esami-math.cfg}.
+ \item {\color{blue}{\optname{pointsonright}}}: fa apparire la casella con il punteggio sulla destra dell'esercizio. Se l'opzione non è specificata, la casella non appare.
+ \item {\color{blue}{\optname{nosolutions}}}: questa opzione genera il compito senza soluzioni negli esercizi a risposta aperta e l'indicazione della risposta corretta in quelli a risposta chiusa (default).
+ \item {\color{blue}{\optname{solutions}}}: genera il file delle soluzioni.
+ \item {\color{blue}{\optname{noquizsolutions}}}: questa opzione genera il compito senza soluzioni nelle domande a risposta chiusa (default).\nuovo{vers. 2.0}
+ \item {\color{blue}{\optname{quizsolutions}}}: genera il compito con le soluzioni nelle domande a risposta chiusa.
+ \item {\color{blue}{\optname{prova}}}: si usa solo con il file {\tt totale-versioni} (si veda \ref{sec:totale}) e serve per visualizzare tutte le varianti di un esercizio. Fa visualizzare automaticamente le risposte esatte negli esercizi a risposta multipla e la soluzione nei problemi da svolgere.
+ \item {\color{blue}{\optname{param}}}: serve per visualizzare le lettere che rappresentano i parametri casuali anziché il valore numerico attribuito. Stampa anche una frase, nella quale sono contenuti il valore iniziale e finale attribuiti ai parametri usati nell'esercizio. Può essere usata solo insieme all'opzione \texttt{prova}.
+ \item {\color{blue}{\optname{correzione}}}: stampa solo i testi di tutti gli esercizi, senza soluzioni (funziona solo nel file {\tt totale-versioni}).
+ \item {\color{blue}{\optname{fillb}}}: deprecata, resta per compatibilità con le versioni precedenti. Serve quando si usano esercizi di tipo ``fillin'', ma è consigliato usare il comando \cmd{\fillinproblem} (si veda\ref{par:fillin})\nuovo{vers. 2.0}
+ \item {\color{blue}{\optname{twocolumns}}}: per scrivere il testo delle domande a risposta chiusa su due colonne (ma si veda anche \ref{duecolonne}).
+ \item {\color{blue}{\optname{sansserif}}}: usa caratteri sans serif.
+ \item {\color{blue}{\optname{autopston}}} e {\color{blue}{\optname{autopstoff}}}: caricano i pacchetti \pkgname{pstricks}, \pkgname{pstricks-add} e \pkgname{auto-pst-pdf} e permettono di compilare il file direttamente con \hologo{pdfLaTeX} (anche se contiene codice di \pkgname{pstricks}). La prima opzione crea e include direttamente nel documento i file delle immagini, la seconda non crea i file delle immagini (e rende più veloce la compilazione)\VerbatimFootnotes
+ \footnote{Per usare \pkgname{auto-pst-pdf} è necessario
+ abilitare \texttt{shell-escape} (\Hologo{TeX} Live) o \texttt{write18} (\Hologo{MiKTeX}) nell'esecuzione di \hologo{pdfLaTeX}.}.\nuovo{vers. 2.0}
+ \item {\color{blue}{\optname{language}}}: legge il file di localizzazione es-language.lng (si veda \ref{sec:lng}). Nel file sono contenute le traduzioni delle etichette (esercizio, soluzione, \dots ), dei messaggi d'errore, delle intestazioni contenute nel file (\texttt{esami-xyz.cfg}). Di default viene caricato il file della lingua italiana. Poiché le opzioni linguistiche hanno lo stesso nome di quelle usate in \pkgname{babel} è possibile passare l'opzione in \cmd{\documentclass}.
+\end{itemize}
+
+\section{Gli esercizi}
+\subsection{Le varianti}
+Ogni esercizio (con tutte le sue varianti) va scritto in un file separato.
\DescribeMacro{\newproblem}
Ogni variante è racchiusa nel comando
\cmd{\newproblem\{\dots \}} (che non ha alcun argomento opzionale).
\begin{esempio}
-\begin{verbatim}
+ \begin{verbatim}
%%%% Questo è il file file1.tex con 2 varianti di un esercizio
\newproblem{Testo della prima variante}
\newproblem{Testo della seconda variante}
@@ -239,9 +240,9 @@ Il comando \cmd{\newproblem} è una versione molto modificata dell'analogo coman
\setlength\fboxrule{2pt}
\setlength\fboxsep{2mm}
\fcolorbox{red}{white}{
-\begin{minipage}[c]{\textwidth-2\fboxsep-2\fboxrule}
-È assolutamente necessario che ogni versione degli esercizi sia argomento del comando \cmd{\newproblem}, se così non è o il programma si arresta con un errore o l'output è del tutto imprevedibile.
-\end{minipage}
+ \begin{minipage}[c]{\textwidth-2\fboxsep-2\fboxrule}
+ È assolutamente necessario che ogni versione degli esercizi sia argomento del comando \cmd{\newproblem}, se così non è o il programma si arresta con un errore o l'output è del tutto imprevedibile.
+ \end{minipage}
}
\subsection{L'ambiente test}
\DescribeEnv{test}
@@ -265,7 +266,7 @@ I quesiti del gruppo, nel documento principale, sono racchiusi nell'ambiente \em
\end{verbatim}
È possibile inserire all'intero di un unico ambiente \envname{test} più ambienti \envname{questions}. Gli esercizi di ogni gruppo saranno mescolati indipendentemente.
\begin{esempio}
-\begin{verbatim}
+ \begin{verbatim}
\begin{test}
\begin{questions}
....
@@ -284,7 +285,7 @@ All'interno di tale ambiente, i quesiti vengono ``caricati'' in due modi: o con
\end{verbatim}
Il parametro obbligatorio è il nome di ciascuno degli esercizi
che si vogliono inserire nel test, separati da una virgola\footnote{In seguito
-verranno introdotti altri comandi simili per il caricamento di esercizi}.
+ verranno introdotti altri comandi simili per il caricamento di esercizi}.
È possibile sia inserire tutti gli esercizi con un unico comando, sia usare
più comandi \cmd{\esercizi} o \cmd{\estraies} o \cmd{\randestraies} (si veda \ref{estraies} e \ref{randestraies}).
@@ -294,7 +295,7 @@ sottoinsiemi diversi (5 esercizi sui limiti scelti tra 7 e 3 esercizi sulle der
si deve introdurre la parte che deve essere su due colonne con
\cmd{\begin\{multicols\}\{2\}} e concluderla con \cmd{\end\{multicols\}}. \textbf{Non} si usa l'opzione \optname{twocolumns}.
\begin{esempio}
-\begin{verbatim}
+ \begin{verbatim}
\begin{test}[punti]
\begin{multicols}{2}
\esercizi{es1,es2,es3}
@@ -333,37 +334,37 @@ Soluzione
\end{verbatim}
nella quale:
\begin{itemize}
- \item {\color{blue}{\begin{verbatim}
+ \item {\color{blue}{\begin{verbatim}
\item \PTs{punteggio}
\end{verbatim}}}
-\DescribeMacro{\PTs}
-introduce una domanda con punteggio indicato in \cmd{\PTs} (può essere anche un numero decimale e il separatore può essere la virgola).
+ \DescribeMacro{\PTs}
+ introduce una domanda con punteggio indicato in \cmd{\PTs} (può essere anche un numero decimale e il separatore può essere la virgola).
-\item {\color{blue}{\begin{verbatim}
+ \item {\color{blue}{\begin{verbatim}
\begin{answers}{numero colonne}
\bChoices[random]
...
\eChoices
\end{answers}
\end{verbatim}}}
-\DescribeEnv{answers}
-\DescribeMacro{\Ans0}
-\DescribeMacro{\Ans1}
-\DescribeMacro{\bChoices}
-\DescribeMacro{\eChoices}
-\DescribeMacro{\eFreeze}
-introduce le risposte disposte sul numero di colonne specificate. Le risposte vengono permutate in modo casuale solo se è specificata l'opzione (\optname{random}).
-
-\item {\color{blue}{\cmd{\Ans0} }} introduce una risposta errata
-\item {\color{blue}{\cmd{\Ans1}}} introduce la risposta esatta \footnote{Se nella risposta appare il segno di tabulazione \& è necessario racchiudere la risposta tra parentesi graffe.}
-\item {\color{blue}{\cmd{\eFreeze}}} introduce (se si vuole) una o più risposte che non saranno in ordine casuale.
+ \DescribeEnv{answers}
+ \DescribeMacro{\Ans0}
+ \DescribeMacro{\Ans1}
+ \DescribeMacro{\bChoices}
+ \DescribeMacro{\eChoices}
+ \DescribeMacro{\eFreeze}
+ introduce le risposte disposte sul numero di colonne specificate. Le risposte vengono permutate in modo casuale solo se è specificata l'opzione (\optname{random}).
+
+ \item {\color{blue}{\cmd{\Ans0} }} introduce una risposta errata
+ \item {\color{blue}{\cmd{\Ans1}}} introduce la risposta esatta \footnote{Se nella risposta appare il segno di tabulazione \& è necessario racchiudere la risposta tra parentesi graffe.}
+ \item {\color{blue}{\cmd{\eFreeze}}} introduce (se si vuole) una o più risposte che non saranno in ordine casuale.
\end{itemize}
È possibile aumentare lo spazio tra l'etichetta dell'item e il testo della risposta impostando la lunghezza \verb|\mylabelsep|.
\DescribeEnv{solution}
L'ambiente \envname{solution} può essere inserito o meno \emph{dopo} l'ambiente \envname{answers} e permette di visualizzare, usando l'opzione \optname{quizsolutions}, le soluzioni dell'esercizio.\nuovo{vers. 2.0}
\begin{esempio}
- \begin{verbatim}
+ \begin{verbatim}
\newproblem{
\item \PTs{1} Le soluzioni dell'equazione
\[x^2-5x+6=0\]
@@ -420,8 +421,8 @@ se si sceglie di scrivere un esercizio a risposta aperta in una sola parte; con
\end{problem*}
\end{verbatim}
se invece si sceglie di scrivere un esercizio a risposta aperta in più parti. Il codice di questi ambienti è derivato, con molte modificazioni, dal codice dell'ambiente \envname{exercise} del pacchetto \pkgname{exerquiz} \footnote{L'ambiente \envname{exercise} è rimasto e può essere usato come template per la costruzione di altri ambienti come nuovi esercizi, esempi o altro.}.
- \paragraph{Esercizio senza parti}
- È introdotto, come si è detto, dall'ambiente \envname{problem}.
+\paragraph{Esercizio senza parti}
+È introdotto, come si è detto, dall'ambiente \envname{problem}.
\begin{verbatim}
\begin{problem} [punteggio]
........Testo..........
@@ -430,12 +431,12 @@ se invece si sceglie di scrivere un esercizio a risposta aperta in più parti. I
\end{solution}
\end{problem}
\end{verbatim}
- \DescribeEnv{solution}
+\DescribeEnv{solution}
In \oarg{punteggio} va il punteggio dell'esercizio, in \oarg{spazio\_soluzione} va l'\emph{eventuale} spazio bianco che deve essere lasciato per la soluzione.
\paragraph{Esercizio in più parti}
\DescribeEnv{parts}
È introdotto dall'ambiente \envname{problem*}.
- \begin{verbatim}
+\begin{verbatim}
\begin{problem*} [punteggio]
....testo....
\begin{parts}
@@ -493,8 +494,8 @@ L'elenco dei nomi (mischiati in ordine casuale su ciascuna colonna) viene visual
\begin{esempio}
-\begin{minipage}{.4\textwidth}
-\begin{verbatim}
+ \begin{minipage}{.4\textwidth}
+ \begin{verbatim}
\pair{Regno Unito}{Londra}
\pair{Francia}{Parigi}
\pair{Italia}{Roma}
@@ -502,18 +503,18 @@ L'elenco dei nomi (mischiati in ordine casuale su ciascuna colonna) viene visual
\pair{Grecia}{Atene}
\matching
\end{verbatim}
-\end{minipage}
-\begin{minipage}{.4\textwidth}
-\begin{center}
-\begin{tabular}{l l l }
-\rule{1cm}{1pt}& Grecia & (A) Parigi\\
-\rule{1cm}{1pt}& Regno Unito & (B) Berlino\\
-\rule{1cm}{1pt}& Francia & (C) Roma\\
-\rule{1cm}{1pt}& Italia & (D) Londra\\
-\rule{1cm}{1pt}& Germania & (E) Atene
-\end{tabular}
-\end{center}
-\end{minipage}
+ \end{minipage}
+ \begin{minipage}{.4\textwidth}
+ \begin{center}
+ \begin{tabular}{l l l }
+ \rule{1cm}{1pt} & Grecia & (A) Parigi \\
+ \rule{1cm}{1pt} & Regno Unito & (B) Berlino \\
+ \rule{1cm}{1pt} & Francia & (C) Roma \\
+ \rule{1cm}{1pt} & Italia & (D) Londra \\
+ \rule{1cm}{1pt} & Germania & (E) Atene
+ \end{tabular}
+ \end{center}
+ \end{minipage}
\end{esempio}
Nelle soluzioni viene invece visualizzato l'abbinamento corretto.
@@ -532,8 +533,8 @@ Come per le domande a risposta chiusa, le risposte che contengono il carattere d
Questo tipo di esercizio funziona con \Hologo{XeLaTeX}, ma non con \Hologo{LuaLaTeX}.
\begin{esempio}
-Con il codice
-\begin{verbatim}
+ Con il codice
+ \begin{verbatim}
\begin{center}
\renewcommand\arraystretch{3}
\begin{tabella}[1]{r}{c}
@@ -546,19 +547,19 @@ Con il codice
\end{center}
\end{verbatim}
- si ottiene il seguente risultato
- \renewcommand\arraystretch{3}
- \begin{center}
-\DeleteShortVerb{\|}
- \MakeShortVerb{\!}
-\begin{tabular}{r|c}
- \hline
- Il dominio della funzione è & \color{red}{$D_f=(-\infty;2]$}\\
- \hline
- L'insieme immagine della funzione è & \color{red}{$Im(f)=(-\infty,0]$} \\
- \hline
- \end{tabular}
-\end{center}
+ si ottiene il seguente risultato
+ \renewcommand\arraystretch{3}
+ \begin{center}
+ \DeleteShortVerb{\|}
+ \MakeShortVerb{\!}
+ \begin{tabular}{r|c}
+ \hline
+ Il dominio della funzione è & \color{red}{$D_f=(-\infty;2]$} \\
+ \hline
+ L'insieme immagine della funzione è & \color{red}{$Im(f)=(-\infty,0]$} \\
+ \hline
+ \end{tabular}
+ \end{center}
\end{esempio}
\paragraph{workarea:}\DescribeEnv{workarea} non è una tipologia di esercizi, ma serve a creare un'area di lavoro, cioè uno spazio bianco sul foglio in cui lo studente possa scrivere. La sintassi è
@@ -576,10 +577,10 @@ coordinati per disegnare un grafico.
\subsection{Altri comandi}
Il pacchetto definisce altri due comandi utilizzati nel file {\tt totale-versioni} (si veda \ref{sec:totale})
\begin{itemize}
- \item {\color{blue}{\cmd{\selectallproblems\{\textbackslash esercizio\}}}}:\DescribeMacro{\selectallproblems}\ si usa all'interno del file che serve per visualizzare tutte le varianti di un esercizio, con i parametri calcolati oppure no.
- \item {\color{blue}{\cmd{\esercizio}}}:\DescribeMacro{\esercizio}\ si usa all'interno del file che serve per visualizzare tutte le varianti di un esercizio e serve per definire il nome dell'esercizio sul quale si sta lavorando, che verrà usato nel comando \cmd{\selectallproblems} visto in precedenza e verrà stampato come titolo del file pdf prodotto. La sintassi per definire il nome di un esercizio è \cmd{\def\textbackslash esercizio\{nome\}}.
- \end{itemize}
- Inoltre il comando \cmd{\Acapo} \DescribeMacro{\Acapo} equivalente di default a \verb|\par| separa gli esercizi; questo comando può essere ridefinito ad esempio in \cmd{\newpage} così da avere un esercizio per pagina (utile per studenti DSA o ipovedenti). \nuovo{vers. 2.0}
+ \item {\color{blue}{\cmd{\selectallproblems\{\textbackslash esercizio\}}}}:\DescribeMacro{\selectallproblems}\ si usa all'interno del file che serve per visualizzare tutte le varianti di un esercizio, con i parametri calcolati oppure no.
+ \item {\color{blue}{\cmd{\esercizio}}}:\DescribeMacro{\esercizio}\ si usa all'interno del file che serve per visualizzare tutte le varianti di un esercizio e serve per definire il nome dell'esercizio sul quale si sta lavorando, che verrà usato nel comando \cmd{\selectallproblems} visto in precedenza e verrà stampato come titolo del file pdf prodotto. La sintassi per definire il nome di un esercizio è \cmd{\def\textbackslash esercizio\{nome\}}.
+\end{itemize}
+Inoltre il comando \cmd{\Acapo} \DescribeMacro{\Acapo} equivalente di default a \verb|\par| separa gli esercizi; questo comando può essere ridefinito ad esempio in \cmd{\newpage} così da avere un esercizio per pagina (utile per studenti DSA o ipovedenti). \nuovo{vers. 2.0}
\section{I comandi per lavorare con i parametri e con le liste}
\subsection{Comandi per lavorare con i parametri (casuali)} \label{sec:comandi}
@@ -588,155 +589,155 @@ Sono stati definiti alcuni comandi per lavorare con i parametri (casuali).
Questi comandi si basano sul pacchetto \pkgname{fp} \cite{fp}, che permette di eseguire calcoli anche molto complessi all'interno di un documento \Hologo{LaTeX}.
Il comando fondamentale che serve per definire un parametro è {\color{blue}{\cmd{\FPsetpar}\oarg{seme}\marg{nome-parametro}\marg{primo valore}\marg{ultimo valore}\oarg{{valori esclusi}}}} che serve per dichiarare i parametri casuali all'interno di un esercizio (a risposta chiusa o aperta). Il parametro avrà nome \cmd{\nome-parametro} e varierà tra il primo valore e l'ultimo valore (inclusi).\DescribeMacro{\FPsetpar} \ Il parametro sarà un numero intero\footnote{Anche se è possibile definire parametri razionali o (pseudo)reali, come nel pacchetto \pkgname{rangen} \cite{rangen} abbiamo preferito restringere la scelta al caso intero e ottenere gli altri casi operando sui parametri.}.
Il parametro opzionale \oarg{seme}, serve a imporre un seme diverso per la generazione del numero casuale. Il valore di default del parametro è \cmd{\seme} ed è definito a partire dalla data dell'esame e dal numero della versione.
- È possibile escludere dalla scelta uno o più valori (ultimo parametro tra parentesi quadre). Se i valori sono più di uno devono essere posti tra parentesi graffe e separati tra virgole; tra i valori esclusi ci possono essere anche altri parametri purché già definiti in precedenza (anche il primo e l'ultimo valore possono essere parametri: in questo caso bisogna prestare attenzione al fatto che il primo valore deve essere minore dell'ultimo). \DescribeMacro{\maxLoopLimit}Il meccanismo usato per soddisfare tali condizioni consiste nel ripetere la generazione più volte: il numero massimo di ripetizioni è determinato dal parametro \cmd{\maxLoopLimit}, il cui valore di default è 10, ma che è definibile anche in fase di compilazione.
+È possibile escludere dalla scelta uno o più valori (ultimo parametro tra parentesi quadre). Se i valori sono più di uno devono essere posti tra parentesi graffe e separati tra virgole; tra i valori esclusi ci possono essere anche altri parametri purché già definiti in precedenza (anche il primo e l'ultimo valore possono essere parametri: in questo caso bisogna prestare attenzione al fatto che il primo valore deve essere minore dell'ultimo). \DescribeMacro{\maxLoopLimit}Il meccanismo usato per soddisfare tali condizioni consiste nel ripetere la generazione più volte: il numero massimo di ripetizioni è determinato dal parametro \cmd{\maxLoopLimit}, il cui valore di default è 10, ma che è definibile anche in fase di compilazione.
\begin{esempio}
-\begin{verbatim}
+ \begin{verbatim}
\FPsetpar{a}{2}{10}
\end{verbatim}
-crea una variabile \cmd{\a} che può assumere un valore casuale tra $2$ e $10$, in questo caso, il seme è quello stabilito nel preambolo del documento.
-I comandi
-\begin{verbatim}
+ crea una variabile \cmd{\a} che può assumere un valore casuale tra $2$ e $10$, in questo caso, il seme è quello stabilito nel preambolo del documento.
+ I comandi
+ \begin{verbatim}
\FPsetpar{a}{2}{10}[3]
\FPsetpar{b}{4}{12}[{\a,6}]
\end{verbatim}
-creano due variabili \cmd{\a} (che può assumere un valore casuale tra 2 e 10, escluso 3) e \cmd{\b} (che può assumere un valore tra 4 e 12,
- escluso 6 e il valore già assegnato ad \cmd{\a}).
+ creano due variabili \cmd{\a} (che può assumere un valore casuale tra 2 e 10, escluso 3) e \cmd{\b} (che può assumere un valore tra 4 e 12,
+ escluso 6 e il valore già assegnato ad \cmd{\a}).
\end{esempio}
Sui parametri definiti è possibile operare come su numeri e sono stati definiti comandi che permettono di operare su tali parametri mostrando il risultato numerico o le operazioni in forma parametrica.
\begin{itemize}
- \item {\color{blue}{\cmd{\FPsv}\oarg{numero di cifre decimali}\marg{parametro/operazione su parametri}}}:\DescribeMacro{\FPsv}\ serve ad eseguire operazioni su parametri e restituirne il valore numerico (con il numero prescelto di cifre decimali, eliminando gli zeri superflui) o stampare l'operazione eseguita (se si sceglie l'opzione \optname{param} nel pacchetto esami).
-
-\begin{esempio}
- \begin{center}
- \begin{tabular}{l|l|l}
- \color{blue}{Istruzione} & \color{blue}{Risultato numerico} & \color{blue}{Opzione \texttt{param}}\\
- \hline
- \hline
- \verb|\FPsv{2*k+1}| & $5$& $2*k+1$ \\
- \verb|\FPsv[2]{(2*k+1)/2}| & $2.50$& $(2*k+1)/2$ \\
- \end{tabular}
- \end{center}
-\end{esempio}
-Le principali caratteristiche del comando \cmd{\FPsv} sono (negli esempi, $k=2$):
-\begin{itemize}
-\item le operazioni devono essere sempre indicate in modo esplicito
-\begin{esempio}
-\begin{center}
-\begin{tabular}{lr}
-\verb!$\FPsv{2*k}$! & $4$\\
-\end{tabular}
-\end{center}
-\end{esempio}
-\item in via automatica, ogni operazione viene racchiusa tra parentesi tonde. La parentesi non viene visualizzata quando si vuole il risultato numerico, mentre lo è con l'opzione \optname{param}
- \begin{esempio}
- \begin{center}
- \begin{tabular}{l|l|l}
- \color{blue}{Istruzione} & \color{blue}{Risultato numerico} & \color{blue}{Opzione \texttt{param}}\\
- \verb|$\FPsv{2*k+1}x$| & $5x$ & $(2*k+1)x$
- \end{tabular}
- \end{center}
- \end{esempio}
-\item Si possono usare i seguenti simboli per le operazioni: \verb|+,-,*,/,^|
-\item Occorre prestare attenzione al fatto che il pacchetto \pkgname{fp} non può gestire potenze con base negativa
-\end{itemize}
-
- \item {\color{blue}{\cmd{\FPval}\marg{nome}\oarg{numero di cifre decimali}\marg{parametro/operazione su parametri}}}:\DescribeMacro{\FPval}\
- assegna a \marg{nome} il valore dell'operazione arrotondato (è il comando \cmd{\FPeval} di \pkgname{fp} modificato) o stampare l'operazione eseguita se si sceglie l'opzione \optname{param} nel pacchetto esami, come con \cmd{\FPsv}, il risultato viene approssimato al numero di cifre decimali indicato (di default è un intero) eliminando gli zeri superflui.\nuovo{vers. 2.0}
-\begin{esempio}
-Sia $k=2$. Il codice
- \begin{verbatim}
+ \item {\color{blue}{\cmd{\FPsv}\oarg{numero di cifre decimali}\marg{parametro/operazione su parametri}}}:\DescribeMacro{\FPsv}\ serve ad eseguire operazioni su parametri e restituirne il valore numerico (con il numero prescelto di cifre decimali, eliminando gli zeri superflui) o stampare l'operazione eseguita (se si sceglie l'opzione \optname{param} nel pacchetto esami).
+
+ \begin{esempio}
+ \begin{center}
+ \begin{tabular}{l|l|l}
+ \color{blue}{Istruzione} & \color{blue}{Risultato numerico} & \color{blue}{Opzione \texttt{param}} \\
+ \hline
+ \hline
+ \verb|\FPsv{2*k+1}| & $5$ & $2*k+1$ \\
+ \verb|\FPsv[2]{(2*k+1)/2}| & $2.50$ & $(2*k+1)/2$ \\
+ \end{tabular}
+ \end{center}
+ \end{esempio}
+ Le principali caratteristiche del comando \cmd{\FPsv} sono (negli esempi, $k=2$):
+ \begin{itemize}
+ \item le operazioni devono essere sempre indicate in modo esplicito
+ \begin{esempio}
+ \begin{center}
+ \begin{tabular}{lr}
+ \verb!$\FPsv{2*k}$! & $4$ \\
+ \end{tabular}
+ \end{center}
+ \end{esempio}
+ \item in via automatica, ogni operazione viene racchiusa tra parentesi tonde. La parentesi non viene visualizzata quando si vuole il risultato numerico, mentre lo è con l'opzione \optname{param}
+ \begin{esempio}
+ \begin{center}
+ \begin{tabular}{l|l|l}
+ \color{blue}{Istruzione} & \color{blue}{Risultato numerico} & \color{blue}{Opzione \texttt{param}} \\
+ \verb|$\FPsv{2*k+1}x$| & $5x$ & $(2*k+1)x$
+ \end{tabular}
+ \end{center}
+ \end{esempio}
+ \item Si possono usare i seguenti simboli per le operazioni: \verb|+,-,*,/,^|
+ \item Occorre prestare attenzione al fatto che il pacchetto \pkgname{fp} non può gestire potenze con base negativa
+ \end{itemize}
+
+ \item {\color{blue}{\cmd{\FPval}\marg{nome}\oarg{numero di cifre decimali}\marg{parametro/operazione su parametri}}}:\DescribeMacro{\FPval}\
+ assegna a \marg{nome} il valore dell'operazione arrotondato (è il comando \cmd{\FPeval} di \pkgname{fp} modificato) o stampare l'operazione eseguita se si sceglie l'opzione \optname{param} nel pacchetto esami, come con \cmd{\FPsv}, il risultato viene approssimato al numero di cifre decimali indicato (di default è un intero) eliminando gli zeri superflui.\nuovo{vers. 2.0}
+ \begin{esempio}
+ Sia $k=2$. Il codice
+ \begin{verbatim}
\FPsetpar{k}{1}{3}
\FPval{a}{2*k+1}
\FPsetpar{b}{2}{20}[\a]
\end{verbatim}
- genera una variabile \cmd{\b} che assume un valore casuale tra $2$ e $20$, escluso (in questo caso) il valore $5$. Nella versione parametrica appare invece una stringa di questo tipo (per quanto riguarda la variabile \cmd{\b})
- \begin{center}
- Il parametro $b$ varia da $2$ a $20$. $b \neq (2*k+1)$. Il seme vale 209.
- \end{center}
- \end{esempio}
- \item {\color{blue}{\cmd{\sempli}\marg{num}\marg{den}}}:\DescribeMacro{\sempli}\ serve per scrivere delle frazioni in cui il numeratore o il denominatore contengono parametri e che potrebbero dover essere ridotte ai minimi termini.
- All'interno del comando \cmd{\sempli} non si deve usare \cmd{\FPsv}.
-\begin{esempio}
-
-Se $k=1$:
-\begin{center}
- \begin{tabular}{lr}
-\verb!$\sempli{2*k}{3*k+1}$! & $ \frac12$\\[2mm]
-\hline\\
- \verb!$\frac{\FPsv{2*k}}{\FPsv{3*k+1}}$! & $\frac24$\\
-\end{tabular}
-\end{center}
-\end{esempio}
-Nel file di \texttt{log} è possibile vedere se e in quali esercizi il risultato di tale operazione è uguale a $1$ o $-1$ (si veda sotto).
- \item {\color{blue}{\cmd{\semplix}\marg{num}\marg{den}}}:\DescribeMacro{\semplix}\ serve per scrivere delle frazioni in cui il numeratore o il denominatore contengono parametri e che potrebbero dover essere ridotte ai minimi termini, ma nelle quali il risultato pari ad $1$ non deve apparire (ad esempio perché davanti ad una incognita).
-
- Il funzionamento è identico a quello del comando \cmd{\sempli}.
-
- Il comando può essere utilizzato ponendo il denominatore uguale ad 1 anche per la formattazione di coefficienti affinché non appaia il valore $1$ e il valore $-1$ appaia come $-$ (segno meno).
-\begin{esempio}
-
-Se il parametro $k$ assume valore $2$:
-\begin{center}
- \begin{tabular}{lr}
-\verb|$\FPsv{k-1}x$| & $1x$\\[2mm]
-\hline\\
-\verb!$\semplix{k-1}{1}x$! & $x$\\[2mm]
-\hline\\
-\verb|$\semplix{1-k}{1}x$| & $-x$\\[2mm]
-\hline\\
-\verb|$\semplix{2*k}{k+2}x$| & $x$\\
-\end{tabular}
-\end{center}
- \end{esempio}
- \item {\color{blue}{\cmd{\esempli}\marg{num}\marg{den}}}:\DescribeMacro{\esempli}\ serve per scrivere delle frazioni in cui il numeratore o il denominatore contengono parametri e che potrebbero dover essere ridotte ai minimi termini, ma nelle quali il risultato pari ad $1$ non deve apparire, ma deve apparire esplicitamente il valore $-1$ (ad esempio per gli esponenti).
-
- Il funzionamento è identico a quello del comando \cmd{\sempli}.
-
- Il comando può essere utilizzato ponendo il denominatore uguale ad 1 anche per la formattazione di esponenti affinché non appaia il valore $1$ e il valore $-1$ appaia come $-1$.
-\begin{esempio}
-
-Se il parametro $k$ assume valore $2$:
-\begin{center}
-\begin{tabular}{lr}
-\verb|$x^{\FPsv{k-1}}$| & $x^1$\\[2mm]
-\hline\\
-\verb|$x^{\esempli{k-1}{1}}$| & $x$\\[2mm]
-\hline\\
-\verb|$x^{\esempli{1-k}{1}}$| & $x^{-1}$
- \end{tabular}
- \end{center}
- \end{esempio}
- \item {\color{blue}{\cmd\sempliz\marg{num}\marg{den}}}:\DescribeMacro{\sempliz}\ serve per scrivere delle frazioni in cui il numeratore o il denominatore contengono parametri e che potrebbero dover essere ridotte ai minimi termini e che possono assumere il valore $0$ (ad esempio nelle risposte). Mentre con gli altri comandi il risultato $0$ dà luogo a un \textbf{errore} e al blocco della compilazione, con il comando \cmd{\sempliz} viene scritto il risultato $0$.
-
- Il funzionamento è identico a quello del comando \cmd{\sempli}.
- \item {\color{blue}{\cmd{\simpsqrt}\marg{ind}\marg{rad}}}:\DescribeMacro{\simpsqrt}\ serve per portar fuori da una radice tutti i fattori possibili. I fattori portati fuori dalla radice non possono essere semplificati con altri (ad esempio, se la radice è al numeratore di una frazione, non è possibile eseguire eventuali semplificazioni tra numeratore e denominatore). Il primo parametro obbligatorio, \marg{ind}, è l'indice della radice; il secondo, \marg{rad}, il radicando. Il primo può contenere un numero o un parametro; il secondo un numero, un parametro o un'operazione su parametri (anche in questo caso non si deve usare all'interno \cmd{\FPsv}).
-\begin{esempio}
-
-Se $a$ vale $2$ e $b$ vale $1$
-
- \begin{tabular}{lr}
-\verb|$\simpsqrt{2}{a^2+4*b}$| & $2\sqrt{2}$
-\end{tabular}
- \end{esempio}
- \item {\color{blue}{\cmd{\RandS}}}:\DescribeMacro{\RandS}\ serve per attribuire un segno casuale ($+$ o $-$) ad un numero. Il comando è simile a quello del pacchetto \pkgname{rangen}.
- \item {\color{blue}{\cmd{\FPsignpol}\marg{espressione}}}:\DescribeMacro{\FPsignpol}\ restituisce il valore di ``espressione'' con il suo segno: è utile, ad esempio, se espressione è il coefficiente di un polinomio (contributo di Hjalmar Basile). \nuovo{vers. 2.1}
- \begin{esempio}
-
-Se $a$ vale $2$ e $b$ vale $-1$
-
- \begin{tabular}{lr}
-\verb|$x^2\FPsignpol{2}{a+4*b}x-2$| & $x^2-2x-2$
-\end{tabular}
-
-Se $a$ vale $2$ e $b$ vale $1$
-
- \begin{tabular}{lr}
-\verb|$x^2\FPsignpol{2}{a+4*b}x-2$| & $x^2+6x-2$
-\end{tabular}
- \end{esempio}
- \end{itemize}
+ genera una variabile \cmd{\b} che assume un valore casuale tra $2$ e $20$, escluso (in questo caso) il valore $5$. Nella versione parametrica appare invece una stringa di questo tipo (per quanto riguarda la variabile \cmd{\b})
+ \begin{center}
+ Il parametro $b$ varia da $2$ a $20$. $b \neq (2*k+1)$. Il seme vale 209.
+ \end{center}
+ \end{esempio}
+ \item {\color{blue}{\cmd{\sempli}\marg{num}\marg{den}}}:\DescribeMacro{\sempli}\ serve per scrivere delle frazioni in cui il numeratore o il denominatore contengono parametri e che potrebbero dover essere ridotte ai minimi termini.
+ All'interno del comando \cmd{\sempli} non si deve usare \cmd{\FPsv}.
+ \begin{esempio}
+
+ Se $k=1$:
+ \begin{center}
+ \begin{tabular}{lr}
+ \verb!$\sempli{2*k}{3*k+1}$! & $ \frac12$ \\[2mm]
+ \hline \\
+ \verb!$\frac{\FPsv{2*k}}{\FPsv{3*k+1}}$! & $\frac24$ \\
+ \end{tabular}
+ \end{center}
+ \end{esempio}
+ Nel file di \texttt{log} è possibile vedere se e in quali esercizi il risultato di tale operazione è uguale a $1$ o $-1$ (si veda sotto).
+ \item {\color{blue}{\cmd{\semplix}\marg{num}\marg{den}}}:\DescribeMacro{\semplix}\ serve per scrivere delle frazioni in cui il numeratore o il denominatore contengono parametri e che potrebbero dover essere ridotte ai minimi termini, ma nelle quali il risultato pari ad $1$ non deve apparire (ad esempio perché davanti ad una incognita).
+
+ Il funzionamento è identico a quello del comando \cmd{\sempli}.
+
+ Il comando può essere utilizzato ponendo il denominatore uguale ad 1 anche per la formattazione di coefficienti affinché non appaia il valore $1$ e il valore $-1$ appaia come $-$ (segno meno).
+ \begin{esempio}
+
+ Se il parametro $k$ assume valore $2$:
+ \begin{center}
+ \begin{tabular}{lr}
+ \verb|$\FPsv{k-1}x$| & $1x$ \\[2mm]
+ \hline \\
+ \verb!$\semplix{k-1}{1}x$! & $x$ \\[2mm]
+ \hline \\
+ \verb|$\semplix{1-k}{1}x$| & $-x$ \\[2mm]
+ \hline \\
+ \verb|$\semplix{2*k}{k+2}x$| & $x$ \\
+ \end{tabular}
+ \end{center}
+ \end{esempio}
+ \item {\color{blue}{\cmd{\esempli}\marg{num}\marg{den}}}:\DescribeMacro{\esempli}\ serve per scrivere delle frazioni in cui il numeratore o il denominatore contengono parametri e che potrebbero dover essere ridotte ai minimi termini, ma nelle quali il risultato pari ad $1$ non deve apparire, ma deve apparire esplicitamente il valore $-1$ (ad esempio per gli esponenti).
+
+ Il funzionamento è identico a quello del comando \cmd{\sempli}.
+
+ Il comando può essere utilizzato ponendo il denominatore uguale ad 1 anche per la formattazione di esponenti affinché non appaia il valore $1$ e il valore $-1$ appaia come $-1$.
+ \begin{esempio}
+
+ Se il parametro $k$ assume valore $2$:
+ \begin{center}
+ \begin{tabular}{lr}
+ \verb|$x^{\FPsv{k-1}}$| & $x^1$ \\[2mm]
+ \hline \\
+ \verb|$x^{\esempli{k-1}{1}}$| & $x$ \\[2mm]
+ \hline \\
+ \verb|$x^{\esempli{1-k}{1}}$| & $x^{-1}$
+ \end{tabular}
+ \end{center}
+ \end{esempio}
+ \item {\color{blue}{\cmd\sempliz\marg{num}\marg{den}}}:\DescribeMacro{\sempliz}\ serve per scrivere delle frazioni in cui il numeratore o il denominatore contengono parametri e che potrebbero dover essere ridotte ai minimi termini e che possono assumere il valore $0$ (ad esempio nelle risposte). Mentre con gli altri comandi il risultato $0$ dà luogo a un \textbf{errore} e al blocco della compilazione, con il comando \cmd{\sempliz} viene scritto il risultato $0$.
+
+ Il funzionamento è identico a quello del comando \cmd{\sempli}.
+ \item {\color{blue}{\cmd{\simpsqrt}\marg{ind}\marg{rad}}}:\DescribeMacro{\simpsqrt}\ serve per portar fuori da una radice tutti i fattori possibili. I fattori portati fuori dalla radice non possono essere semplificati con altri (ad esempio, se la radice è al numeratore di una frazione, non è possibile eseguire eventuali semplificazioni tra numeratore e denominatore). Il primo parametro obbligatorio, \marg{ind}, è l'indice della radice; il secondo, \marg{rad}, il radicando. Il primo può contenere un numero o un parametro; il secondo un numero, un parametro o un'operazione su parametri (anche in questo caso non si deve usare all'interno \cmd{\FPsv}).
+ \begin{esempio}
+
+ Se $a$ vale $2$ e $b$ vale $1$
+
+ \begin{tabular}{lr}
+ \verb|$\simpsqrt{2}{a^2+4*b}$| & $2\sqrt{2}$
+ \end{tabular}
+ \end{esempio}
+ \item {\color{blue}{\cmd{\RandS}}}:\DescribeMacro{\RandS}\ serve per attribuire un segno casuale ($+$ o $-$) ad un numero. Il comando è simile a quello del pacchetto \pkgname{rangen}.
+ \item {\color{blue}{\cmd{\FPsignpol}\marg{espressione}}}:\DescribeMacro{\FPsignpol}\ restituisce il valore di ``espressione'' con il suo segno: è utile, ad esempio, se espressione è il coefficiente di un polinomio (contributo di Hjalmar Basile). \nuovo{vers. 2.1}
+ \begin{esempio}
+
+ Se $a$ vale $2$ e $b$ vale $-1$
+
+ \begin{tabular}{lr}
+ \verb|$x^2\FPsignpol{2}{a+4*b}x-2$| & $x^2-2x-2$
+ \end{tabular}
+
+ Se $a$ vale $2$ e $b$ vale $1$
+
+ \begin{tabular}{lr}
+ \verb|$x^2\FPsignpol{2}{a+4*b}x-2$| & $x^2+6x-2$
+ \end{tabular}
+ \end{esempio}
+\end{itemize}
\subsection{Comandi per la scelta da una lista }
Oltre al comando \cmd{\esercizi} già visto esistono altri comandi per la scelta di esercizi da una lista o, più in generale, di oggetti da una lista.
@@ -746,7 +747,7 @@ dalla lista \marg{lista} escludendone \emph{m}. Gli elementi estratti avranno no
Gli elementi della lista devono essere separati da virgole.
\begin{esempio}
-Con il comando \cmd{\estrai[1]\{insiemi,logica,potenze\}\{alpha\}} si scelgono 2 elementi dell'insieme e questi due elementi si chiameranno \cmd{\alphai} e \cmd{\alphaii}. Se questi nomi corrispondono a nomi di file di esercizi è possibile inserire nella lista di file argomento del comando \cmd{\esercizi} anche \cmd{\alphai} e \cmd{\alphaii}.
+ Con il comando \cmd{\estrai[1]\{insiemi,logica,potenze\}\{alpha\}} si scelgono 2 elementi dell'insieme e questi due elementi si chiameranno \cmd{\alphai} e \cmd{\alphaii}. Se questi nomi corrispondono a nomi di file di esercizi è possibile inserire nella lista di file argomento del comando \cmd{\esercizi} anche \cmd{\alphai} e \cmd{\alphaii}.
\end{esempio}
\DescribeMacro{\randestrai}.\ Il comando \cmd{\randestrai}\oarg{m}\marg{lista}\marg{nome} è simile al comando \cmd{\estrai}, ma l'estrazione degli elementi è completamente aleatoria. \nuovo{vers. 2.1}
@@ -755,16 +756,16 @@ Con il comando \cmd{\estrai[1]\{insiemi,logica,potenze\}\{alpha\}} si scelgono 2
Gli elementi della lista devono essere separati da virgole.
\begin{esempio}
-Con il comando \cmd{\estraialfa[2]\{a,b,c,d\}\{alpha\}} si scelgono 2 elementi dell'insieme, mantenendo l'ordine
-alfabetico e questi due elementi si chiameranno \cmd{\alphai} e \cmd{\alphaii}.
+ Con il comando \cmd{\estraialfa[2]\{a,b,c,d\}\{alpha\}} si scelgono 2 elementi dell'insieme, mantenendo l'ordine
+ alfabetico e questi due elementi si chiameranno \cmd{\alphai} e \cmd{\alphaii}.
\end{esempio}
\DescribeMacro{\estraies} \label{estraies} Il comando \cmd{\estraies}\oarg{m}\marg{lista} funziona come il comando \cmd{\estrai}, ma esclusivamente su una lista di esercizi. Una volta effettuata l'estrazione, li stampa come il comando \cmd{\esercizi}.
\DescribeMacro{\randestraies} \label{randestraies} Il comando \cmd{\randestraies}\oarg{m}\marg{lista} funziona come il comando \cmd{\randestrai}, ma esclusivamente su una lista di esercizi. Una volta effettuata l'estrazione, li stampa come il comando \cmd{\esercizi}.
\section{I file ausiliari}
\subsection{Il file di localizzazione}\label{sec:lng}
- Al momento sono presenti le localizzazioni in italiano (default), inglese (UK), inglese (US), francese, spagnolo (contributo di Maria Hernandez Cifre), tedesco (contributo di Kerstin von Kirschhausen), serbo con alfabeto latino (contributo di Dusko Latas), greco (contributo di Sotiris Hasapis). Usando la lingua greca (e forse altre localizzazioni in caratteri non latini) è necessario caricare i pacchetti \pkgname{fontenc}, \pkgname{inputenc} e \pkgname{babel} prima del caricamento del pacchetto \pkgname{esami}\footnote{L'opzione \optname{greek} prevede al momento l'utilizzo dell'opzione \optname{iso-8859-7} per il pacchetto \pkgname{inputenc}}. In questo file possono venire caricati anche alcuni pacchetti dipendenti dalla localizzazione, quali \pkgname{numprint}, \pkgname{geometry}, ecc. e vengono definiti i comandi \cmd{\shortdate} e \cmd{\longdate} per esprimere la data.
- \textcolor[rgb]{1.00,0.00,0.00}{\textbf{N.B.:} È nota un'incompatibilità tra il pacchetto \pkgname{babel} per la lingua francese (che non è comunque necessario per la localizzazione) e il pacchetto \pkgname{fp}: per ovviare a tale incompatibilità è sufficiente usare il comando \cmd{\shorthandoff\{:\}} subito dopo \cmd{\begin\{document\}}.}
+Al momento sono presenti le localizzazioni in italiano (default), inglese (UK), inglese (US), francese, spagnolo (contributo di Maria Hernandez Cifre), tedesco (contributo di Kerstin von Kirschhausen), serbo con alfabeto latino (contributo di Dusko Latas), greco (contributo di Sotiris Hasapis). Usando la lingua greca (e forse altre localizzazioni in caratteri non latini) è necessario caricare i pacchetti \pkgname{fontenc}, \pkgname{inputenc} e \pkgname{babel} prima del caricamento del pacchetto \pkgname{esami}\footnote{L'opzione \optname{greek} prevede al momento l'utilizzo dell'opzione \optname{iso-8859-7} per il pacchetto \pkgname{inputenc}}. In questo file possono venire caricati anche alcuni pacchetti dipendenti dalla localizzazione, quali \pkgname{numprint}, \pkgname{geometry}, ecc. e vengono definiti i comandi \cmd{\shortdate} e \cmd{\longdate} per esprimere la data.
+\textcolor[rgb]{1.00,0.00,0.00}{\textbf{N.B.:} È nota un'incompatibilità tra il pacchetto \pkgname{babel} per la lingua francese (che non è comunque necessario per la localizzazione) e il pacchetto \pkgname{fp}: per ovviare a tale incompatibilità è sufficiente usare il comando \cmd{\shorthandoff\{:\}} subito dopo \cmd{\begin\{document\}}.}
\subsection{Il file di configurazione}\label{sec:cfg}
Il file di configurazione \texttt{esami-xyz.cfg} contiene varie definizioni tra cui la testata (comando \cmd{\testa}), il piè di pagina, la formattazione della stringa delle soluzioni, lo stile di pagina, le istruzioni per l'esame.
\subsection{I file \texttt{master} e \texttt{master-sol}}
@@ -780,14 +781,16 @@ Al suo interno si deve usare un solo comando, \cmd{\def \textbackslash esercizio
\section{Changelog}
\begin{description}
- \item[Versione 1.0 (2013/03/08)] Prima versione rilasciata al CTAN
- \item[Versione 1.1 (2013/12/09)] Reinserita la dipendenza dal pacchetto \pkgname{environ} per eliminare alcuni errori nella compilazione con \Hologo{LaTeX}. Eliminata la dipendenza dal pacchetto \pkgname{icomma} nel file di localizzazione es-italian.lng a seguito dell'introduzione di nuove funzionalità nel pacchetto \pkgname{babel} per la lingua italiana (comando \cmd{\IntelligentComma}).
- \item[Versione 2.0 (2015/02/25)] Eliminata la dipendenza da \pkgname{pstricks}. Modificato l'inserimento di domande di tipo \emph{fill-in}. Inserita la possibilità di estrarre più esercizi da un solo file. Ora è possibile visualizzare le risposte nei test. Modificata la visualizzazione dei decimali nel comando \cmd{\FPsv}. Modificata la definizione di \cmd{\FPval} in modo da avere cifre decimali. Modificato l'algoritmo di scelta della variante di un esercizio in modo completamente deterministico. Aggiunto il comando \cmd{\Acapo}. Aggiunta la localizzazione serba (alfabeto latino). Ora la compilazione produce un nuovo file con la lista degli esercizi scelti.
- \item[Versione 2.1 (2016/07/25)] Modificato \texttt{es-german.lng} e \texttt{es-spanish.lng} per errore nell'input delle soluzioni. Introdotto il comando \texttt{randestrai}. Introdotto il comando \texttt{FPsignpol}. Introdotto controllo punteggio totale degli esercizi. Risolta l'incompatibilità con \pkgname{babel} per la lingua spagnola. Rimossa l'incompatibilità tra il comando \cmd{\fillin} e i comandi \cmd{\sempli} e \cmd{\semplix}.
- \item[Versione 2.2 (2017/07/01)] {Introdotta la possibilità di avere due semi diversi per la scelta degli esercizi (\cmd{\semeex}) e per le permutazioni e scelta dei parametri (\cmd{\seme}): di default sono uguali. Leggermente modificato il comando \cmd{\estrai} così da poter essere usato per estrarre parametri numerici da una lista. Integrata la documentazione.}
+ \item[Versione 1.0 (2013/03/08)] Prima versione rilasciata al CTAN
+ \item[Versione 1.1 (2013/12/09)] Reinserita la dipendenza dal pacchetto \pkgname{environ} per eliminare alcuni errori nella compilazione con \Hologo{LaTeX}. Eliminata la dipendenza dal pacchetto \pkgname{icomma} nel file di localizzazione es-italian.lng a seguito dell'introduzione di nuove funzionalità nel pacchetto \pkgname{babel} per la lingua italiana (comando \cmd{\IntelligentComma}).
+ \item[Versione 2.0 (2015/02/25)] Eliminata la dipendenza da \pkgname{pstricks}. Modificato l'inserimento di domande di tipo \emph{fill-in}. Inserita la possibilità di estrarre più esercizi da un solo file. Ora è possibile visualizzare le risposte nei test. Modificata la visualizzazione dei decimali nel comando \cmd{\FPsv}. Modificata la definizione di \cmd{\FPval} in modo da avere cifre decimali. Modificato l'algoritmo di scelta della variante di un esercizio in modo completamente deterministico. Aggiunto il comando \cmd{\Acapo}. Aggiunta la localizzazione serba (alfabeto latino). Ora la compilazione produce un nuovo file con la lista degli esercizi scelti.
+ \item[Versione 2.1 (2016/07/25)] Modificato \texttt{es-german.lng} e \texttt{es-spanish.lng} per errore nell'input delle soluzioni. Introdotto il comando \texttt{randestrai}. Introdotto il comando \texttt{FPsignpol}. Introdotto controllo punteggio totale degli esercizi. Risolta l'incompatibilità con \pkgname{babel} per la lingua spagnola. Rimossa l'incompatibilità tra il comando \cmd{\fillin} e i comandi \cmd{\sempli} e \cmd{\semplix}.
+ \item[Versione 2.2 (2017/07/01)] {Introdotta la possibilità di avere due semi diversi per la scelta degli esercizi (\cmd{\semeex}) e per le permutazioni e scelta dei parametri (\cmd{\seme}): di default sono uguali. Leggermente modificato il comando \cmd{\estrai} così da poter essere usato per estrarre parametri numerici da una lista. Integrata la documentazione.}
+ \item[Versione 2.3 (2017/09/18)]Corretto un errore di battitura nel codice.
+
\end{description}
\bibliographystyle{plain}
\bibliography{esami}
- \end{document}
+\end{document}