summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-09-20 22:37:18 +0000
committerKarl Berry <karl@freefriends.org>2017-09-20 22:37:18 +0000
commitd9a254cf07ee23e20a7b959d2983f7260cb05d14 (patch)
treed239ef5d8642d3185c127292010548ddb58cb65f
parent2abea9e8c684ddce6f36df1f34a26373096139e2 (diff)
esami (20sep17)
git-svn-id: svn://tug.org/texlive/trunk@45359 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/esami/README6
-rw-r--r--Master/texmf-dist/doc/latex/esami/VERSION2
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/esami-doc-en.pdfbin458631 -> 459118 bytes
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/esami-doc-en.tex529
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.pdfbin510417 -> 466461 bytes
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.tex519
-rw-r--r--Master/texmf-dist/doc/latex/esami/esami-xyz.cfg6
-rw-r--r--Master/texmf-dist/tex/latex/esami/esami.sty22
8 files changed, 548 insertions, 536 deletions
diff --git a/Master/texmf-dist/doc/latex/esami/README b/Master/texmf-dist/doc/latex/esami/README
index b7834042aa6..c0a99346208 100644
--- a/Master/texmf-dist/doc/latex/esami/README
+++ b/Master/texmf-dist/doc/latex/esami/README
@@ -1,6 +1,6 @@
-The esami package v. 2.2
+The esami package v. 2.3
For generation of texts and solutions of exams in LaTeX
-2017/07/01
+2017/09/18
File: README
Author: Grazia Messineo and Salvatore Vassallo
@@ -93,4 +93,4 @@ File sty and files cfg and lng must be copied in a folder where LATEX can find t
README
doc-esami-en.pdf User manual in English
doc-esami-it.pdf User manual in Italian
- doc-esami-*.tex Sources for documentation
+ doc-esami-*.tex Sources for documentation \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/esami/VERSION b/Master/texmf-dist/doc/latex/esami/VERSION
index 874b5b91bb6..8983f033a3f 100644
--- a/Master/texmf-dist/doc/latex/esami/VERSION
+++ b/Master/texmf-dist/doc/latex/esami/VERSION
@@ -1 +1 @@
-VERSION 2.2 DATE=July 01, 2017
+VERSION 2.3 DATE=September 18, 2017
diff --git a/Master/texmf-dist/doc/latex/esami/doc/esami-doc-en.pdf b/Master/texmf-dist/doc/latex/esami/doc/esami-doc-en.pdf
index f23eb1c36c6..a76fd326664 100644
--- a/Master/texmf-dist/doc/latex/esami/doc/esami-doc-en.pdf
+++ b/Master/texmf-dist/doc/latex/esami/doc/esami-doc-en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/esami/doc/esami-doc-en.tex b/Master/texmf-dist/doc/latex/esami/doc/esami-doc-en.tex
index b3b221755a6..7dd27aa80ab 100644
--- a/Master/texmf-dist/doc/latex/esami/doc/esami-doc-en.tex
+++ b/Master/texmf-dist/doc/latex/esami/doc/esami-doc-en.tex
@@ -47,8 +47,8 @@
\begin{document}
%\GetFileInfo{esami.sty}
% \DocInput{esami.dtx}
- %\PrintChanges
- %\PrintIndex
+%\PrintChanges
+%\PrintIndex
%</driver>
%\fi
@@ -75,27 +75,29 @@
\changes{Version 2.0}{2015/02/25}{Eliminated the dependance on \texttt{pstricks}. Modified the use of \emph{fill-in} questions. Inserted the possibility to extract more than one variant from a file. Now it is possible to view the solutions in tests. Modified the visualization of decimal places in command \texttt{FPsv}. Modified the definition of \texttt{FPval} to allow the use of decimal places. Modified the algorithm of choice of a variant of an exercise, now completely deterministic. Added the command \texttt{Acapo}. Added the serbian localization (latin alphabet). The compilation produces a new file with the list of the chosen exercises.}
\changes{Versione 2.1}{2016/07/25}{Modified \texttt{es-german.lng} and \texttt{es-spanish.lng} for an error in the input of the solutions. The command \texttt{randestrai} has been introduced. The command \texttt{FPsignpol} has been introduced. The control on the total points of the exercises has been introduced. Removed the incompatibility between the command \texttt{fillin} and the commands \texttt{sempli} and \texttt{semplix}.}
\changes{Version 2.2}{2017/07/01}{Introduced the possibility to have two different seeds for the choice of exercises (\cmd{\semeex}) and for the permutations and choice of the parameters (\cmd{\seme}): by default, they are equal. Slightly modified the command \cmd{\estrai} so that it is possible to use it to extract parameters from a list. Documentation integrated.}
+\changes{Version 2.3}{2017/09/18}{Corrected a misprint in the code.}
+
%\IndexPrologue{\section*{Index} Numbers written in italic refer to the page where the item is described; underlined numebers refer to the line of code in which the item is described; other references are to the line of code where the item is used.}
\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{version 2.2}
-\def\filedate{2017/07/1}
+\def\fileversion{version 2.3}
+\def\filedate{2017/09/18}
- \title{Package esami\thanks{This document
- refers to the package \textsf{esami}~\fileversion, with date \filedate.}}
- \author{Grazia Messineo <grazia.messineo@unicatt.it> \\ Salvatore Vassallo <salvatore.vassallo@unicatt.it>}
+\title{Package esami\thanks{This document
+ refers to the package \textsf{esami}~\fileversion, with date \filedate.}}
+\author{Grazia Messineo <grazia.messineo@unicatt.it> \\ Salvatore Vassallo <salvatore.vassallo@unicatt.it>}
\newcommand{\nuovo}[1]{\marginpar{\raggedleft{ \footnotesize{\textsf{New #1}}}}}
- \maketitle
+\maketitle
- \tableofcontents
- \newpage
+\tableofcontents
+\newpage
\newcommand*\pkgname[1]{\texttt{#1}}
\newcommand*\clsname[1]{\texttt{#1}}
\newcommand*\optname[1]{\emph{#1}}
@@ -111,20 +113,20 @@ The development of the package has begun in 2008 (\cite{esami}, \cite{tug}) with
\section{Required packages}
Package \pkgname{esami} depends on some other non standard packages\footnote{The complete list of the packages used in a normal compilation of an exam is: etex, graphicx, enumerate, fp, currfile, array, environ, ifthen, xargs, xkeyval, multicol, amssymb, amsfonts, xcolor, babel, etoolbox, icomma, numprint, amsmath, fontenc, inputenc, lmodern. Obviously, every loaded package can have other dependencies.}:
\begin{enumerate}
-\item \pkgname{fp}: for mathematical operations;
-\item \pkgname{currfile}: to obtain the file and folder names;
-\item \pkgname{xargs}: to have more than one optional parameter;
-\item \pkgname{environ}: to transform commands in environments;
+ \item \pkgname{fp}: for mathematical operations;
+ \item \pkgname{currfile}: to obtain the file and folder names;
+ \item \pkgname{xargs}: to have more than one optional parameter;
+ \item \pkgname{environ}: to transform commands in environments;
\end{enumerate}
Moreover following packages are optional, but recommended:
\begin{enumerate}
-\item \pkgname{ifluatex} and \pkgname{ifxetex} to compile with \Hologo{XeLaTeX} and \Hologo{LuaLaTeX} (here below we will refer only to the compilation with \hologo{pdfLaTeX})\nuovo{vers. 2.0}\footnote{At the moment the support for \Hologo{XeLaTeX} and \Hologo{LuaLaTeX} is only partial and it is not possibile to use some type of exercises.}.
-\item \pkgname{lmodern} and \pkgname{amsfonts}: useful for a good pdf output;
-\item \pkgname{numprint}: to have a better output and different formats for numbers, depending on language;
-%\item \pkgname{icomma}: from \pkgname{ws} package, for a correct format of commas;
-\item \pkgname{eurosym}: (optional) to use the euro symbol in Financial Mathematics exercises;
-\item \pkgname{icomma}: from the package \pkgname{ws} for a correct formatting of commas. This package can be substituted, for the Italian language, by the macro \cmd{\IntelligentComma} of the package \pkgname{babel}: this is the default option in the italian localization file \texttt{es-italian.lng} and can be modified by commenting the macro \cmd{\IntelligentComma} (or by using the macro \cmd{\NoIntelligentComma});\nuovo{vers. 1.1}
-\item \pkgname{pstricks, pstricks-add} and \pkgname{auto-pst-pdf} or \pkgname{tikz} or another package for graphics.\nuovo{vers. 2.0}
+ \item \pkgname{ifluatex} and \pkgname{ifxetex} to compile with \Hologo{XeLaTeX} and \Hologo{LuaLaTeX} (here below we will refer only to the compilation with \hologo{pdfLaTeX})\nuovo{vers. 2.0}\footnote{At the moment the support for \Hologo{XeLaTeX} and \Hologo{LuaLaTeX} is only partial and it is not possibile to use some type of exercises.}.
+ \item \pkgname{lmodern} and \pkgname{amsfonts}: useful for a good pdf output;
+ \item \pkgname{numprint}: to have a better output and different formats for numbers, depending on language;
+ %\item \pkgname{icomma}: from \pkgname{ws} package, for a correct format of commas;
+ \item \pkgname{eurosym}: (optional) to use the euro symbol in Financial Mathematics exercises;
+ \item \pkgname{icomma}: from the package \pkgname{ws} for a correct formatting of commas. This package can be substituted, for the Italian language, by the macro \cmd{\IntelligentComma} of the package \pkgname{babel}: this is the default option in the italian localization file \texttt{es-italian.lng} and can be modified by commenting the macro \cmd{\IntelligentComma} (or by using the macro \cmd{\NoIntelligentComma});\nuovo{vers. 1.1}
+ \item \pkgname{pstricks, pstricks-add} and \pkgname{auto-pst-pdf} or \pkgname{tikz} or another package for graphics.\nuovo{vers. 2.0}
\end{enumerate}
All these packages are available both in \TeX Live and in MiK\TeX.
@@ -153,7 +155,7 @@ Command \cmd{\date} is the standard \LaTeX\ command, but the date must be writte
\pagestyle{esame}
%\setcounter{vers}{m}
\end{verbatim}
- Command \cmd{\pagestyle} is defined in a configuration file (see section \ref{sec:cfg}) and defines headers and footers. The commented command \cmd{\setcounter}\{vers\}\{$m$\} is used, jointly to the command \cmd{\numcompiti} with inside a number $n$ (greater than $m$), to generate the versions from $m+1$ to $n$.
+Command \cmd{\pagestyle} is defined in a configuration file (see section \ref{sec:cfg}) and defines headers and footers. The commented command \cmd{\setcounter}\{vers\}\{$m$\} is used, jointly to the command \cmd{\numcompiti} with inside a number $n$ (greater than $m$), to generate the versions from $m+1$ to $n$.
\begin{verbatim}
\whiledo{\thevers<\numcompiti}{\stepvers
\end{verbatim}
@@ -165,13 +167,13 @@ the routine for the compilation of variants begins here and it will end at the e
generates the seed for the randomization process and assigns it also to \cmd{\randomi}.
\textcolor[rgb]{1.00,0.00,0.00}{\textbf{N.B.} If the seed is a number smaller than 1, it is initialized using date and hour, so two compilations will give different outputs.}
- \nuovo{vers. 2.2} It is now possible to define in a different way the seed for permutations (\cmd{\seme}) and the one for the choice of the exercises (\cmd{\semeex}): the need arises from the request to be able to choose for each exam the same exercises for all the students (\cmd{\semeex} depends only on the date), but also to be able to permute them in each version.
+\nuovo{vers. 2.2} It is now possible to define in a different way the seed for permutations (\cmd{\seme}) and the one for the choice of the exercises (\cmd{\semeex}): the need arises from the request to be able to choose for each exam the same exercises for all the students (\cmd{\semeex} depends only on the date), but also to be able to permute them in each version.
\begin{verbatim}
\permuta
\testa
\istruzionii
\end{verbatim}
- \cmd{\testa}, \cmd{\istruzionii} are defined in the configuration file and contain the instructions for the heading and the instructions for the exam, while the macro \cmd{\permuta} allows the randomization of exercises order.
+\cmd{\testa}, \cmd{\istruzionii} are defined in the configuration file and contain the instructions for the heading and the instructions for the exam, while the macro \cmd{\permuta} allows the randomization of exercises order.
\begin{verbatim}
\begin{test}[points]
@@ -199,42 +201,42 @@ It ends the routine for the compilation. The macro \verb+\def\stringasol{}+ is u
\nuovo{vers. 2.0} The compilation produces a pdf file with all the desired variants. The compilation of the solutions file produces also another file, namely \texttt{filename-sol.loe} (loe = list of exercises) which contains the labels assigned to the chosen exercises, to identify them: each chosen exercise is identified by a string such as \emph{e:number of version -file:name of file-q:number of question in roman digits}.
-\nuovo{vers. 2.1} At the end of the solutions file there is the string of the correct answers for multiple choice questions: as a default behaviour this string is, for each version, included in a \envname{minipage} environment. If this choice is not suitable for our purposes (i. e. if we have 40 multiple choice questions and the answers cannot be contained in a page) it is possibile to modify it adapting the macros \cmd{\stepverssols} and \cmd{\closeverssols}: in the example cfg file there are (commented) the definitions to have a continuous string of correct answers.
-
+\nuovo{vers. 2.1} At the end of the solutions file there is the string of the correct answers for multiple choice questions: as a default behaviour this string is, for each version, included in a \envname{minipage} environment. If this choice is not suitable for our purposes (i. e. if we have 40 multiple choice questions and the answers cannot be contained in a page) it is possibile to modify it adapting the macros \cmd{\stepverssols} and \cmd{\closeverssols}: in the example cfg file there are (commented) the definitions to have a continuous string of correct answers.
+
During the compilation, we have introduced a control that checks if the number of points marked for a test or an exercises divided in parts is equal to the sum of the partial points. This possibility can be excluded by commenting in the configuration file the definition of the command \cmd{\checkpoints}. \nuovo{vers. 2.1}
\section{Package options}\label{sec:opzioni}
The package can be loaded with the usual command
\cmd{\usepackage}[\meta{options}]\{esami\}. The possibile options are:
- \begin{itemize}
- \item \optname{allowrandomize} and \optname{norandomize}: with the first one the answers in MCQ are shuffled (default), with the second one they are printed in the same order in which they are written;
- \item \optname{shuffle}, \optname{shufflerandom} and \optname{noshuffle}: the first one (the default) shuffles the exercises (randomly if they are more than eight, in a deterministic way if they are 8 or less), with the second one the exercises are always shuffled randomly (uncommenting some lines in the file \texttt{esami.sty} it is possible to modify it so that the choice is random for more than $n<8$ exercises and deterministic otherwise), with the third the exercises are not shuffled;
- \item \optname{xyz}: it reads the file (\verb|esami-xyz.cfg|) that contains some commands and configurations, such as the name of the course, the instructions for the students, etc. The name of some configuration files is written in the file \texttt{esami.sty}, but it is possible to read a configuration file without modifying it: it is sufficient to put an unknown option like \optname{zzz} and write the file \verb|esami-zzz.cfg|;
- \item \optname{pointsonright}: it is a boolean option that generates a little box on the right of the page with the score of the exercise;
- \item \optname{nosolutions}: with this option the exam is generated without solutions (default);
- \item \optname{solutions}: it generates the solutions file;
- \item \optname{noquizsolutions}: it generates the test without solutions in MCQ;\nuovo{vers. 2.0}
- \item \optname{quizsolutions}: it generates the test with the solutions in MCQ;\nuovo{vers. 2.0}
- \item \optname{prova}: it is the Italian word for trial. Compiling the file \verb|totale-versioni| with this option, a PDF file is generated with all the variants of an exercise; automatically the correct answers of MCQ and the solutions of the exercises are shown;
- \item \optname{param}: with this option, used only in conjunction with the option \optname{prova}, the versions of the exercise are printed in parametric form, moreover it shows the range of variation of the parameters;
- \item \optname{correzione}: it is the Italian word for correction. It can be used only with the option \optname{prova}. It prints only the text of all the exercises, without solution;
- \item {\color{blue}{\optname{fillb}}}: deprecated, it remains for compatibility with previous versions. It is used with ``fillin'' exercises, but it is recommended to use the macro \cmd{\fillinproblem} (see \ref{par:fillin})\nuovo{vers. 2.0}
- \item \optname{twocolumns}: with this option the multiple choice questions are printed in two columns;
- \item \optname{sansserif}: a \textit{sans serif} font is used.
- \item \optname{autopston} e \optname{autopstoff}: both these options load the packages \pkgname{pstricks}, \pkgname{pstricks-add} and \pkgname{auto-pst-pdf} but the second one with the option \optname{off}; in this way it is possible to compile the file directly with pdf\LaTeX\ also if the exercises contain graphics in \pkgname{pstricks}, the graphics package we use. With the first one the images are generated and included in the document, while the second one does not generate the images but includes them if they exist.\VerbatimFootnotes
-\footnote{The package \pkgname{auto-pst-pdf} requires pdf\LaTeX\ to be called with the \texttt{shell-escape} (in \TeX Live) or \texttt{write18} (in MiK\TeX) option}.
-\item {\optname{language}}: it reads the localisation file es-language.lng (see \ref{sec:lng}). In this file there are the translations of the labels (exercise, solution, \dots), of the error messages, of the headings contained in the file (\texttt{esami-xyz.cfg}). By default Italian language is chosen. Since these language options have the same name of the languages in \pkgname{babel} it's possible to put the option in \cmd{\documentclass}.
+\begin{itemize}
+ \item \optname{allowrandomize} and \optname{norandomize}: with the first one the answers in MCQ are shuffled (default), with the second one they are printed in the same order in which they are written;
+ \item \optname{shuffle}, \optname{shufflerandom} and \optname{noshuffle}: the first one (the default) shuffles the exercises (randomly if they are more than eight, in a deterministic way if they are 8 or less), with the second one the exercises are always shuffled randomly (uncommenting some lines in the file \texttt{esami.sty} it is possible to modify it so that the choice is random for more than $n<8$ exercises and deterministic otherwise), with the third the exercises are not shuffled;
+ \item \optname{xyz}: it reads the file (\verb|esami-xyz.cfg|) that contains some commands and configurations, such as the name of the course, the instructions for the students, etc. The name of some configuration files is written in the file \texttt{esami.sty}, but it is possible to read a configuration file without modifying it: it is sufficient to put an unknown option like \optname{zzz} and write the file \verb|esami-zzz.cfg|;
+ \item \optname{pointsonright}: it is a boolean option that generates a little box on the right of the page with the score of the exercise;
+ \item \optname{nosolutions}: with this option the exam is generated without solutions (default);
+ \item \optname{solutions}: it generates the solutions file;
+ \item \optname{noquizsolutions}: it generates the test without solutions in MCQ;\nuovo{vers. 2.0}
+ \item \optname{quizsolutions}: it generates the test with the solutions in MCQ;\nuovo{vers. 2.0}
+ \item \optname{prova}: it is the Italian word for trial. Compiling the file \verb|totale-versioni| with this option, a PDF file is generated with all the variants of an exercise; automatically the correct answers of MCQ and the solutions of the exercises are shown;
+ \item \optname{param}: with this option, used only in conjunction with the option \optname{prova}, the versions of the exercise are printed in parametric form, moreover it shows the range of variation of the parameters;
+ \item \optname{correzione}: it is the Italian word for correction. It can be used only with the option \optname{prova}. It prints only the text of all the exercises, without solution;
+ \item {\color{blue}{\optname{fillb}}}: deprecated, it remains for compatibility with previous versions. It is used with ``fillin'' exercises, but it is recommended to use the macro \cmd{\fillinproblem} (see \ref{par:fillin})\nuovo{vers. 2.0}
+ \item \optname{twocolumns}: with this option the multiple choice questions are printed in two columns;
+ \item \optname{sansserif}: a \textit{sans serif} font is used.
+ \item \optname{autopston} e \optname{autopstoff}: both these options load the packages \pkgname{pstricks}, \pkgname{pstricks-add} and \pkgname{auto-pst-pdf} but the second one with the option \optname{off}; in this way it is possible to compile the file directly with pdf\LaTeX\ also if the exercises contain graphics in \pkgname{pstricks}, the graphics package we use. With the first one the images are generated and included in the document, while the second one does not generate the images but includes them if they exist.\VerbatimFootnotes
+ \footnote{The package \pkgname{auto-pst-pdf} requires pdf\LaTeX\ to be called with the \texttt{shell-escape} (in \TeX Live) or \texttt{write18} (in MiK\TeX) option}.
+ \item {\optname{language}}: it reads the localisation file es-language.lng (see \ref{sec:lng}). In this file there are the translations of the labels (exercise, solution, \dots), of the error messages, of the headings contained in the file (\texttt{esami-xyz.cfg}). By default Italian language is chosen. Since these language options have the same name of the languages in \pkgname{babel} it's possible to put the option in \cmd{\documentclass}.
\end{itemize}
- \section{Exercises}
- \subsection{Variants}
- Each exercise (with all its variants) must be written in a separate file.
+\section{Exercises}
+\subsection{Variants}
+Each exercise (with all its variants) must be written in a separate file.
\DescribeMacro{\newproblem}
Each variant is enclosed in the command
\cmd{\newproblem\{ \dots \}} (which has no optional arguments).
\begin{esempio}
-\begin{verbatim}
+ \begin{verbatim}
%%% This is file1.tex with 2 variants of an exercise
\newproblem{Text of first variant}
\newproblem{Text of second variant}
@@ -262,7 +264,7 @@ The questions of each group, in the master file, are enclosed in the environment
\end{verbatim}
It is possibile to insert in a \envname{test} environment more than one \envname{questions} environment. The exercises of each group will be independently scrambled.
\begin{esempio}
-\begin{verbatim}
+ \begin{verbatim}
\begin{test}
\begin{questions}
....
@@ -285,7 +287,7 @@ It is possibile both to insert all the exercises in a unique command and to use
This is useful for example if you want exercises from two different subsets (5 exercises on limits chosen among 7 and 3 exercises on derivatives chosen among 5) or if you want to have some exercises on two columns and other on one column, for a better layout of the page. In this case you must precede the part on two columns with
\cmd{\begin\{multicols\}\{2\}} and end it with \cmd{\end\{multicols\}}. You \textbf{must not} use option \optname{twocolumns}.
\begin{esempio}
-\begin{verbatim}
+ \begin{verbatim}
\begin{test}[punti]
\begin{multicols}{2}
\esercizi{es1,es2,es3}
@@ -322,35 +324,35 @@ In the file of the exercises, in
\end{verbatim}
in which:
\begin{itemize}
- \item {\color{blue}{\begin{verbatim}
+ \item {\color{blue}{\begin{verbatim}
\item \PTs{points}
\end{verbatim}}}
-\DescribeMacro{\PTs}
-introduces a question with points written in the command \cmd{\PTs} (it can be a decimal number and the separator can be the comma).
+ \DescribeMacro{\PTs}
+ introduces a question with points written in the command \cmd{\PTs} (it can be a decimal number and the separator can be the comma).
-\item {\color{blue}{\begin{verbatim}
+ \item {\color{blue}{\begin{verbatim}
\begin{answers}{number of columns}
\bChoices[random]
...
\eChoices
\end{answers}
\end{verbatim}}}
-\DescribeEnv{answers}
-\DescribeMacro{\Ans0}
-\DescribeMacro{\Ans1}
-\DescribeMacro{\bChoices}
-\DescribeMacro{\eChoices}
-\DescribeMacro{\eFreeze}
-introduces answers split on the specified number of columns. Answers will be randomly shuffled only if the option \optname{random} is specified.
-
-\item {\color{blue}{\cmd{\Ans0} }} introduces a wrong answer
-\item {\color{blue}{\cmd{\Ans1}}} introduces the correct answer
-\item {\color{blue}{\cmd{\eFreeze}}} introduces (if desireded) one or more answers which will not be randomly shuffled.
+ \DescribeEnv{answers}
+ \DescribeMacro{\Ans0}
+ \DescribeMacro{\Ans1}
+ \DescribeMacro{\bChoices}
+ \DescribeMacro{\eChoices}
+ \DescribeMacro{\eFreeze}
+ introduces answers split on the specified number of columns. Answers will be randomly shuffled only if the option \optname{random} is specified.
+
+ \item {\color{blue}{\cmd{\Ans0} }} introduces a wrong answer
+ \item {\color{blue}{\cmd{\Ans1}}} introduces the correct answer
+ \item {\color{blue}{\cmd{\eFreeze}}} introduces (if desireded) one or more answers which will not be randomly shuffled.
\end{itemize}
\DescribeEnv{solution}
The environment \envname{solution} can be inserted \emph{after} the environment \envname{answers} and shows, using the option \optname{quizsolutions}, the solutions of the exercise.\nuovo{vers. 2.0}
\begin{esempio}
- \begin{verbatim}
+ \begin{verbatim}
\newproblem{
\item \PTs{1} The solutions of the equation
\[x^2-5x+6=0\]
@@ -385,8 +387,8 @@ are
Besides MCQ, you can use in the environment \envname{test} other kinds of questions, that will be described in section \ref{sec:altri_esercizi}. Unfortunately using \texttt{fill-in} type exercises, if you have more than one blank space to fill, the string of correct answers will be less useful because the numbering of the questions is wrong.
-\textbf{N.B.} By default each question of the test is enclosed in \envname{minipage} environment. In the example cfg file there are some commented lines which allow to have questions out of this environment.
-
+\textbf{N.B.} By default each question of the test is enclosed in \envname{minipage} environment. In the example cfg file there are some commented lines which allow to have questions out of this environment.
+
\subsection{Environments problem and problem*}
\DescribeEnv{problem}
@@ -404,7 +406,7 @@ if you choose to write an open answer exercise with only one part; with the synt
\end{problem*}
\end{verbatim}
if you choose to write an open answer exercise with more than one part. The code for these environments is taken, with various modifications, from the code of the environment exercise in the package \pkgname{exerquiz}\footnote{The environment \envname{exercise} still exists and can be used as a template to build other environments such as new exercises, examples, etc.}.
- \paragraph{Exercises in one part}
+\paragraph{Exercises in one part}
It is introduced by the environment \envname{problem}.
\begin{verbatim}
@@ -415,12 +417,12 @@ It is introduced by the environment \envname{problem}.
\end{solution}
\end{problem}
\end{verbatim}
- \DescribeEnv{solution}
+\DescribeEnv{solution}
The argument \oarg{score} contains the points of the exercise, the argument \oarg{space for the solution} contains the dimension of the \emph{possible} white space which must be left for the solution.
\paragraph{Exercise in more than one part}
\DescribeEnv{parts}
It is introduced by the environment \envname{problem*}.
- \begin{verbatim}
+\begin{verbatim}
\begin{problem*} [score]
....text....
\begin{parts}
@@ -435,11 +437,11 @@ It is introduced by the environment \envname{problem*}.
\end{verbatim}
The argument \cmd{\PTs\{partial score\}} contains the points of each part.
-\paragraph{Exercises in a minipage}
- \DescribeEnv{problemmp}
- \DescribeEnv{problemmp*}
- We have also created the environments \envname{problemmp} and \envname{problemmp*} \nuovo{vers. 2.1} which are identical to the environments \envname{problem} and \envname{problem*}, but enclose all the text of the problem in a \envname{minipage} environment.
-
+\paragraph{Exercises in a minipage}
+\DescribeEnv{problemmp}
+\DescribeEnv{problemmp*}
+We have also created the environments \envname{problemmp} and \envname{problemmp*} \nuovo{vers. 2.1} which are identical to the environments \envname{problem} and \envname{problem*}, but enclose all the text of the problem in a \envname{minipage} environment.
+
\subsection{Other kinds of exercise}\label{sec:altri_esercizi}
We have defined other new kinds of exercise:
\paragraph{fillin:}\label{par:fillin} \DescribeMacro{\fillin}
@@ -447,9 +449,9 @@ it is used to create exercises in which some parts of the text is left blank and
These exercises are introduced with a slightly different syntax and they are defined in the text by the command \cmd{\newfillinproblem} or by \cmd{\newproblem}\cmd{\fillinproblem}\texttt{\{text of the problem\}}. \nuovo{vers. 2.0}
The syntax is:\\
- \cs{fillin}\verb+[+\meta{type}\verb+]{+\meta{width of blank}\verb+}{+\meta{answer}\verb+}+
+\cs{fillin}\verb+[+\meta{type}\verb+]{+\meta{width of blank}\verb+}{+\meta{answer}\verb+}+
- The two mandatory parameters are the width of the blank space, expressed as a length, and the correct answer (text or number) that the student has to write: it will be printed only in the solutions.
+The two mandatory parameters are the width of the blank space, expressed as a length, and the correct answer (text or number) that the student has to write: it will be printed only in the solutions.
The optional parameter \meta{type} defines the way in which the blank space is denoted: \texttt{u} (\emph{underlined}), the default, produces an underlined space, \texttt{b} (\emph{boxed}) produces a little box , \texttt{e} (\emph{empty}) produces an empty space.
%In the blank space it is not possible to use the commands \cmd{\sempli} or \cmd{\semplix} (see Section \ref{sec:comandi}).
@@ -479,8 +481,8 @@ The two lists are shuffled and then printed with the command \cmd{\matching}.
\begin{esempio}
-\begin{minipage}{.4\textwidth}
-\begin{verbatim}
+ \begin{minipage}{.4\textwidth}
+ \begin{verbatim}
\pair{United Kingdom}{London}
\pair{France}{Paris}
\pair{Italy}{Rome}
@@ -488,18 +490,18 @@ The two lists are shuffled and then printed with the command \cmd{\matching}.
\pair{Greece}{Athens}
\matching
\end{verbatim}
-\end{minipage}
-\begin{minipage}{.4\textwidth}
-\begin{center}
-\begin{tabular}{l l l }
-\rule{1cm}{1pt}& Greece & (A) Paris\\
-\rule{1cm}{1pt}& United Kingdom & (B) Berlin\\
-\rule{1cm}{1pt}& France & (C) Rome\\
-\rule{1cm}{1pt}& Italy & (D) London\\
-\rule{1cm}{1pt}& Germany & (E) Athens
-\end{tabular}
-\end{center}
-\end{minipage}
+ \end{minipage}
+ \begin{minipage}{.4\textwidth}
+ \begin{center}
+ \begin{tabular}{l l l }
+ \rule{1cm}{1pt} & Greece & (A) Paris \\
+ \rule{1cm}{1pt} & United Kingdom & (B) Berlin \\
+ \rule{1cm}{1pt} & France & (C) Rome \\
+ \rule{1cm}{1pt} & Italy & (D) London \\
+ \rule{1cm}{1pt} & Germany & (E) Athens
+ \end{tabular}
+ \end{center}
+ \end{minipage}
\end{esempio}
The solutions show the correct matching.
@@ -519,8 +521,8 @@ The second parameter gives the alignment of the visible columns (the same for al
This kind of exercise works with \Hologo{XeLaTeX}, but not with \Hologo{LuaLaTeX}.
\begin{esempio}
-With the code
-\begin{verbatim}
+ With the code
+ \begin{verbatim}
\begin{center}
\renewcommand\arraystretch{3}
\begin{tabella}[1]{l}{l}
@@ -534,22 +536,22 @@ The range of $f(x)$ is:
\end{tabella}
\end{center}
\end{verbatim}
- we obtain (the second column is visible in the solutions only):
- \renewcommand\arraystretch{3}
- \begin{center}
-\DeleteShortVerb{\|}
- \MakeShortVerb{\!}
-\begin{tabular}{r|c}
- \hline
- The domain of the function is:
-&\textcolor[rgb]{1.00,0.00,0.00}{$D=(-\infty;2]$}\\
- \hline
-The range of $f(x)$ is:
-& \textcolor[rgb]{1.00,0.00,0.00}{$f(D)=(-\infty,0]$} \\
- \hline
- \end{tabular}
-\end{center}
- \end{esempio}
+ we obtain (the second column is visible in the solutions only):
+ \renewcommand\arraystretch{3}
+ \begin{center}
+ \DeleteShortVerb{\|}
+ \MakeShortVerb{\!}
+ \begin{tabular}{r|c}
+ \hline
+ The domain of the function is:
+ & \textcolor[rgb]{1.00,0.00,0.00}{$D=(-\infty;2]$} \\
+ \hline
+ The range of $f(x)$ is:
+ & \textcolor[rgb]{1.00,0.00,0.00}{$f(D)=(-\infty,0]$} \\
+ \hline
+ \end{tabular}
+ \end{center}
+\end{esempio}
\paragraph{workarea:}\DescribeEnv{workarea} this environment defines a blank space on the paper sheet where the student can write. The syntax is:
\begin{verbatim}
\begin{solution}{height}
@@ -562,9 +564,9 @@ The height of \envname{workarea} and of \envname{solution} should be equal; on t
\subsection{Other commands}
The package defines other two commands used in the file {\tt totale-versioni} (see \ref{sec:totale})
\begin{itemize}
- \item {\color{blue}{\cmd{\selectallproblems\{\textbackslash esercizio\}}}}:\DescribeMacro{\selectallproblems}\ it is used in the file which shows all the variants of an exercise, with calculated or uncalculated parameters.
- \item {\color{blue}{\cmd{\esercizio}}}:\DescribeMacro{\esercizio}\ it is used in the file which shows all the variants of an exercise and defines the name of the exercise on that you are working and which is the argument of the command \cmd{\selectallproblems}. It will be printed as the title of the generated file. The syntax is \cmd{\def\textbackslash esercizio\{name\}}.
- \end{itemize}
+ \item {\color{blue}{\cmd{\selectallproblems\{\textbackslash esercizio\}}}}:\DescribeMacro{\selectallproblems}\ it is used in the file which shows all the variants of an exercise, with calculated or uncalculated parameters.
+ \item {\color{blue}{\cmd{\esercizio}}}:\DescribeMacro{\esercizio}\ it is used in the file which shows all the variants of an exercise and defines the name of the exercise on that you are working and which is the argument of the command \cmd{\selectallproblems}. It will be printed as the title of the generated file. The syntax is \cmd{\def\textbackslash esercizio\{name\}}.
+\end{itemize}
\section{Commands to work with parameters and lists}
\subsection{Commands to work on (random) parameters} \label{sec:comandi}
@@ -573,165 +575,165 @@ We have defined some commands to work with (random) parameters.
These commands are based on the package \pkgname{fp} \cite{fp}, which allows the execution of (complex) operations inside a \LaTeX\ document.
\DescribeMacro{\FPsetpar} \ The basic command to define a parameter is
-{\color{blue}{\cmd{\FPsetpar}\oarg{seed}\marg{parameter-name}\marg{first value}\marg{last value}\oarg{{excl-values}}}}.
+ {\color{blue}{\cmd{\FPsetpar}\oarg{seed}\marg{parameter-name}\marg{first value}\marg{last value}\oarg{{excl-values}}}}.
The name of the random parameter will be\cs{param-name} and its range will be between \texttt{inf} and \texttt{sup} (included).
The parameter will be an integer number.\footnote{Even if it is possible to define rational or (pseudo)real parameters, as in the package \pkgname{rangen} \cite{rangen}, we preferred to limit the choice to integer numbers and to obtain the other cases with operations on parameters.}
The optional parameter \oarg{seed} is used to have a different seed for the generation of the random number. The default value is \cmd{\seme} (the Italian word for seed): it is defined in the preamble and it is based on the date of the exam and on the number of version.
- It's possible to exclude one or more values from the choice (parameter \oarg{excl-values}). If the excluded values are more than one, they are enclosed in braces. The lower and the upper bounds (\marg{inf} and \marg{sup}, with \marg{inf} $<$ \marg{sup}) and the excluded values can be random parameters defined before. In order to satisfy the conditions, the generation of the random number is repeated many times: the maximum number of repetitions is given by the command \cmd{\maxLoopLimit}, by default $10$ (it can be redefined in the preamble of the document).
+It's possible to exclude one or more values from the choice (parameter \oarg{excl-values}). If the excluded values are more than one, they are enclosed in braces. The lower and the upper bounds (\marg{inf} and \marg{sup}, with \marg{inf} $<$ \marg{sup}) and the excluded values can be random parameters defined before. In order to satisfy the conditions, the generation of the random number is repeated many times: the maximum number of repetitions is given by the command \cmd{\maxLoopLimit}, by default $10$ (it can be redefined in the preamble of the document).
\begin{esempio}
-\begin{verbatim}
+ \begin{verbatim}
\FPsetpar{a}{2}{10}
\end{verbatim}
-creates a parameter \cmd{\a} which can be a random value between $2$ and $10$, in this case, the seed is defined in the preamble of the document.
-The commands
-\begin{verbatim}
+ creates a parameter \cmd{\a} which can be a random value between $2$ and $10$, in this case, the seed is defined in the preamble of the document.
+ The commands
+ \begin{verbatim}
\FPsetpar{a}{2}{10}[3]
\FPsetpar{b}{4}{12}[{\a,6}]
\end{verbatim}
-create two parameters, \cmd{\a} (which can be a random value between 2 and 10, except 3) and \cmd{\b} (which can be a random value between 4 and 12,
- except 6 and the value assigned to \cmd{\a}).
+ create two parameters, \cmd{\a} (which can be a random value between 2 and 10, except 3) and \cmd{\b} (which can be a random value between 4 and 12,
+ except 6 and the value assigned to \cmd{\a}).
\end{esempio}
You can work on the parameters defined with this command as on numbers and we have defined commands which allow to work on them showing both the numerical result and the operations in a parametric form.
\begin{itemize}
- \item {\color{blue}{\cmd{\FPsv}\oarg{decimal places}\marg{operation}}}:\DescribeMacro{\FPsv}\ it is used to do operations (on numbers or parameters) obtaining or the numeric value with \meta{decimal} decimal places (by default 0 decimal places), eliminating the useless zeroes or, with the option \optname{param} in the package, the typesetting of the operation (if you choose the option \optname{param} in the package \pkgname{esami}).
-
-\begin{esempio}
- \begin{center}
- \begin{tabular}{l|l|l}
- \color{blue}{Instruction} & \color{blue}{Numerical result} & \color{blue}{Option \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}
-The fundamental characteristics of the command \cmd{\FPsv} are (in the examples, $k=2$):
-\begin{itemize}
-\item the operations must be written explicitly
-\begin{esempio}
-\begin{center}
-\begin{tabular}{lr}
-\verb!$\FPsv{2*k}$! & $4$\\
-\end{tabular}
-\end{center}
-\end{esempio}
-\item each operation is automatically enclosed in parenthesis. The parenthesis is not printed if the numerical value is shown, but it is printed when you use the option \optname{param}
- \begin{esempio}
- \begin{center}
- \begin{tabular}{l|l|l}
- \color{blue}{Instruction} & \color{blue}{Numerical result} & \color{blue}{Option \texttt{param}}\\
- \verb|$\FPsv{2*k+1}x$| & $5x$ & $(2*k+1)x$
- \end{tabular}
- \end{center}
- \end{esempio}
-\item you can use the following symbols for operations: \verb|+,-,*,/,^|
-\item Attention must be paid to the fact that the package \pkgname{fp} cannot handle powers with a negative basis.
-\end{itemize}
-
- \item {\color{blue}{\cmd{\FPval}\marg{name}\oarg{decimal places}\marg{parameter/operation on parameters}}}:\DescribeMacro{\FPval}\
- it assigns to \marg{nome} the rounded value of the operation (it is the command \cmd{\FPeval} from \pkgname{fp}, modified) or it prints the operation if you choose the option \optname{param} in the package \pkgname{esami}, as
- with \cmd{\FPsv}. The result is given with the chosen number of decimal places, eliminating the useless zeroes.\nuovo{vers. 2.0}
-\begin{esempio}
-Let $k=2$. The code
- \begin{verbatim}
+ \item {\color{blue}{\cmd{\FPsv}\oarg{decimal places}\marg{operation}}}:\DescribeMacro{\FPsv}\ it is used to do operations (on numbers or parameters) obtaining or the numeric value with \meta{decimal} decimal places (by default 0 decimal places), eliminating the useless zeroes or, with the option \optname{param} in the package, the typesetting of the operation (if you choose the option \optname{param} in the package \pkgname{esami}).
+
+ \begin{esempio}
+ \begin{center}
+ \begin{tabular}{l|l|l}
+ \color{blue}{Instruction} & \color{blue}{Numerical result} & \color{blue}{Option \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}
+ The fundamental characteristics of the command \cmd{\FPsv} are (in the examples, $k=2$):
+ \begin{itemize}
+ \item the operations must be written explicitly
+ \begin{esempio}
+ \begin{center}
+ \begin{tabular}{lr}
+ \verb!$\FPsv{2*k}$! & $4$ \\
+ \end{tabular}
+ \end{center}
+ \end{esempio}
+ \item each operation is automatically enclosed in parenthesis. The parenthesis is not printed if the numerical value is shown, but it is printed when you use the option \optname{param}
+ \begin{esempio}
+ \begin{center}
+ \begin{tabular}{l|l|l}
+ \color{blue}{Instruction} & \color{blue}{Numerical result} & \color{blue}{Option \texttt{param}} \\
+ \verb|$\FPsv{2*k+1}x$| & $5x$ & $(2*k+1)x$
+ \end{tabular}
+ \end{center}
+ \end{esempio}
+ \item you can use the following symbols for operations: \verb|+,-,*,/,^|
+ \item Attention must be paid to the fact that the package \pkgname{fp} cannot handle powers with a negative basis.
+ \end{itemize}
+
+ \item {\color{blue}{\cmd{\FPval}\marg{name}\oarg{decimal places}\marg{parameter/operation on parameters}}}:\DescribeMacro{\FPval}\
+ it assigns to \marg{nome} the rounded value of the operation (it is the command \cmd{\FPeval} from \pkgname{fp}, modified) or it prints the operation if you choose the option \optname{param} in the package \pkgname{esami}, as
+ with \cmd{\FPsv}. The result is given with the chosen number of decimal places, eliminating the useless zeroes.\nuovo{vers. 2.0}
+ \begin{esempio}
+ Let $k=2$. The code
+ \begin{verbatim}
\FPsetpar{k}{1}{3}
\FPval{a}{2*k+1}
\FPsetpar{b}{2}{20}[\a]
\end{verbatim}
- generates a parameter \cmd{\b} which assumes a random value between $2$ and $20$, with the exception (in this case) of the value $5$. In the parametric version, a similar string appears (as far as the parameter \cmd{\b} is concerned)
- \begin{center}
- The parameter $b$ varies between $2$ and $20$. $b\neq (2*k+1)$. The seed is 209.
- \end{center}
- \end{esempio}
- \item {\color{blue}{\cmd{\sempli}\marg{num}\marg{den}}}:\DescribeMacro{\sempli}\ it simplifies a fraction where \meta{num} and \meta{den} can contain parameters or operations on them.
- Inside the command \cmd{\sempli} you must not use \cmd{\FPsv}.
-\begin{esempio}
-
-If $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}
-In the log file it is possible to see if and in which exercises the result of this operation is $1$ or $-1$ (see below).
- \item {\color{blue}{\cmd{\semplix}\marg{num}\marg{den}}}:\DescribeMacro{\semplix}\ it simplifies a fraction where \marg{num} and \marg{den} can contain parameters, but where the result $1$ does not appear and the result $-1$ is shown like a minus sign ``$-$'' (for example it can be used before a $x$).
-
- It works exactly as the command \cmd{\sempli}.
-
- The command can also be used, setting the denominator equal to $1$, to format coefficients of a variable, so that the value $1$ does not appear and the value $-1$ appears as $-$.
-
-\begin{esempio}
-
-If the parameter $k$ is equal to $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}\ it simplifies a fraction so that the result $1$ cannot appear, but the result $-1$ has to appear explicitly (like in exponents). The command can be used also with denominator equal to $1$ to format the exponents correctly.
-
- It works exactly as the command \cmd{\sempli}.
-
- The command can also be used, setting the denominator equal to $1$, to format exponents, so that the value $1$ does not appear and the value $-1$ appears as $-1$.
-\begin{esempio}
-
-If the parameter $k$ is equal to $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}\ simplifies fractions that can assume the value $0$ (for example, in answers). While with the other commands the result $0$ gives an \textbf{error} and stops the compilation, with this command the value $0$ is written.
-
- It works exactly as the command \cmd{\sempli}.
- \item {\color{blue}{\cmd{\simpsqrt}\marg{ind}\marg{rad}}}:\DescribeMacro{\simpsqrt}\ With this command it's possible to extract factors from radicals. With these factors is not possible to do other operations. The first mandatory parameter \marg{ind} is the index of the radical and can be parametric; the second one, \marg{rad} is the radicand and can be also a parameter or an operation (also in this case \cmd{\FPsv} must not be used inside it).
-\begin{esempio}
-
-If $a$ is equal to $2$ and $b$ is equal to $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}\ it is used to give a random sign ($+$ o $-$) to a number. The command is similar to the one of the package \pkgname{rangen}.
-
- \item {\color{blue}{\cmd{\FPsignpol}\marg{expression}}}:\DescribeMacro{\FPsignpol}\ gives the value of ``expression'' with its sign: it is useful, for example, if ``expression'' is the coefficient of a polynomial. This macro has been contributed by 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}
+ generates a parameter \cmd{\b} which assumes a random value between $2$ and $20$, with the exception (in this case) of the value $5$. In the parametric version, a similar string appears (as far as the parameter \cmd{\b} is concerned)
+ \begin{center}
+ The parameter $b$ varies between $2$ and $20$. $b\neq (2*k+1)$. The seed is 209.
+ \end{center}
+ \end{esempio}
+ \item {\color{blue}{\cmd{\sempli}\marg{num}\marg{den}}}:\DescribeMacro{\sempli}\ it simplifies a fraction where \meta{num} and \meta{den} can contain parameters or operations on them.
+ Inside the command \cmd{\sempli} you must not use \cmd{\FPsv}.
+ \begin{esempio}
+
+ If $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}
+ In the log file it is possible to see if and in which exercises the result of this operation is $1$ or $-1$ (see below).
+ \item {\color{blue}{\cmd{\semplix}\marg{num}\marg{den}}}:\DescribeMacro{\semplix}\ it simplifies a fraction where \marg{num} and \marg{den} can contain parameters, but where the result $1$ does not appear and the result $-1$ is shown like a minus sign ``$-$'' (for example it can be used before a $x$).
+
+ It works exactly as the command \cmd{\sempli}.
+
+ The command can also be used, setting the denominator equal to $1$, to format coefficients of a variable, so that the value $1$ does not appear and the value $-1$ appears as $-$.
+
+ \begin{esempio}
+
+ If the parameter $k$ is equal to $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}\ it simplifies a fraction so that the result $1$ cannot appear, but the result $-1$ has to appear explicitly (like in exponents). The command can be used also with denominator equal to $1$ to format the exponents correctly.
+
+ It works exactly as the command \cmd{\sempli}.
+
+ The command can also be used, setting the denominator equal to $1$, to format exponents, so that the value $1$ does not appear and the value $-1$ appears as $-1$.
+ \begin{esempio}
+
+ If the parameter $k$ is equal to $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}\ simplifies fractions that can assume the value $0$ (for example, in answers). While with the other commands the result $0$ gives an \textbf{error} and stops the compilation, with this command the value $0$ is written.
+
+ It works exactly as the command \cmd{\sempli}.
+ \item {\color{blue}{\cmd{\simpsqrt}\marg{ind}\marg{rad}}}:\DescribeMacro{\simpsqrt}\ With this command it's possible to extract factors from radicals. With these factors is not possible to do other operations. The first mandatory parameter \marg{ind} is the index of the radical and can be parametric; the second one, \marg{rad} is the radicand and can be also a parameter or an operation (also in this case \cmd{\FPsv} must not be used inside it).
+ \begin{esempio}
+
+ If $a$ is equal to $2$ and $b$ is equal to $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}\ it is used to give a random sign ($+$ o $-$) to a number. The command is similar to the one of the package \pkgname{rangen}.
+
+ \item {\color{blue}{\cmd{\FPsignpol}\marg{expression}}}:\DescribeMacro{\FPsignpol}\ gives the value of ``expression'' with its sign: it is useful, for example, if ``expression'' is the coefficient of a polynomial. This macro has been contributed by 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{Commands to choose from a list}\label{list}
Besides the command \cmd{\esercizi} that we have already presented there are other commands to choose exercises, or, more in general, objects, from a list.
@@ -741,7 +743,7 @@ The first command allows to choose randomly $n-m$ elements of a list
The elements of the list must be comma separated.
\begin{esempio}
-With the command \cmd{\estrai[1]\{sets,logic,powers\}\{alpha\}} you choose 2 elements of the set and these elements will have the name\cmd{\alphai} e \cmd{\alphaii}. If these names are names of exercises, it is possible to insert in the file list argument of the command \cmd{\esercizi} also \cmd{\alphai} e \cmd{\alphaii}.
+ With the command \cmd{\estrai[1]\{sets,logic,powers\}\{alpha\}} you choose 2 elements of the set and these elements will have the name\cmd{\alphai} e \cmd{\alphaii}. If these names are names of exercises, it is possible to insert in the file list argument of the command \cmd{\esercizi} also \cmd{\alphai} e \cmd{\alphaii}.
\end{esempio}
\DescribeMacro{\randestrai}.\ The macro \cmd{\randestrai}\oarg{m}\marg{list}\marg{name} is similar to the macro \cmd{\estrai}, but the choice of the elements is completely randomized. \nuovo{vers. 2.1}
@@ -751,7 +753,7 @@ With the command \cmd{\estrai[1]\{sets,logic,powers\}\{alpha\}} you choose 2 ele
The elements of the list must be comma separated.
\begin{esempio}
-With the command \cmd{\estraialfa[2]\{a,b,c,d\}\{alpha\}} you choose 2 elements from the set, preserving the alphabetical order, and these elements will be named \cmd{\alphai} and \cmd{\alphaii}.
+ With the command \cmd{\estraialfa[2]\{a,b,c,d\}\{alpha\}} you choose 2 elements from the set, preserving the alphabetical order, and these elements will be named \cmd{\alphai} and \cmd{\alphaii}.
\end{esempio}
\DescribeMacro{\estraies} \label{estraies} The command \cmd{\estraies}\oarg{m}\marg{list} works as the command \cmd{\estrai}, but only on a list of exercises. Once the elements have been chosen, it prints them as the command \cmd{\esercizi}.
@@ -759,9 +761,9 @@ With the command \cmd{\estraialfa[2]\{a,b,c,d\}\{alpha\}} you choose 2 elements
\section{The auxiliary files}
\subsection{The localisation file}\label{sec:lng}
- The package has localisations in Italian (the default), UK English, US English, French, Spanish (thanks to Maria Hernandez Cifre), German (thanks to Kerstin von Kirschhausen), Serbian with latin alphabet (thanks to Dusko Latas), Greek (thanks to Sotiris Hasapis). Using greek language (and maybe other non latin localisations) it's necessary to load the packages \pkgname{fontenc}, \pkgname{inputenc} e \pkgname{babel} before the package \pkgname{esami}\footnote{The option \optname{greek} requires at this moment the option \optname{iso-8859-7} for the package \pkgname{inputenc}}. In this file one can also load some language dependent packages, such as \pkgname{numprint}, \pkgname{geometry}, etc. and there are the definitions of the commands \cmd{\shortdate} and \cmd{\longdate} to write the date.
+The package has localisations in Italian (the default), UK English, US English, French, Spanish (thanks to Maria Hernandez Cifre), German (thanks to Kerstin von Kirschhausen), Serbian with latin alphabet (thanks to Dusko Latas), Greek (thanks to Sotiris Hasapis). Using greek language (and maybe other non latin localisations) it's necessary to load the packages \pkgname{fontenc}, \pkgname{inputenc} e \pkgname{babel} before the package \pkgname{esami}\footnote{The option \optname{greek} requires at this moment the option \optname{iso-8859-7} for the package \pkgname{inputenc}}. In this file one can also load some language dependent packages, such as \pkgname{numprint}, \pkgname{geometry}, etc. and there are the definitions of the commands \cmd{\shortdate} and \cmd{\longdate} to write the date.
- \textcolor[rgb]{1.00,0.00,0.00}{\textbf{N.B.:} There is an known incompatibility between the package \pkgname{babel} for the French language (which is not necessary for the localization) and the package \pkgname{fp}: to manage this incompatibility, one can use the macro \cmd{\shorthandoff\{:\}} immediately after \cmd{\begin\{document\}}.}
+\textcolor[rgb]{1.00,0.00,0.00}{\textbf{N.B.:} There is an known incompatibility between the package \pkgname{babel} for the French language (which is not necessary for the localization) and the package \pkgname{fp}: to manage this incompatibility, one can use the macro \cmd{\shorthandoff\{:\}} immediately after \cmd{\begin\{document\}}.}
\subsection{The configuration file}\label{sec:cfg}
The configuration file \texttt{esami-xyz.cfg} contains various definitions, i.e. the header (command \cmd{\testa}), the footer, the format for the solution file, the page style, the instructions for the exam.
\subsection{The \texttt{master} and \texttt{master-sol} files}
@@ -778,11 +780,12 @@ The file \texttt{totale-versioni} is used to generate all the variants of an exe
Inside this file you should use only one command, \cmd{\def \textbackslash esercizio\{name\}}, that should contain the name of the exercise to compile. If you compile the parametric version, the parameters and their intervals are shown at the end of the exercise.
\section{Changelog}
\begin{description}
- \item[Version 1.0 (2013/03/08)] First version released to CTAN.
- \item[Version 1.1 (2013/12/09)] Inserted the dependance on the package \texttt{environ} to remove some errors in the \LaTeX\ compilation. Removed the dependance on the package \texttt{icomma} in the italian localization file es-italian.lng because of the introduction of new features in the package \texttt{babel} for the Italian langaguage (macro \texttt{IntelligentComma}).
- \item[Version 2.0 (2015/02/25)] Eliminated the dependance on \pkgname{pstricks}. Modified the use of \emph{fill-in} questions. Inserted the possibility to extract more than one variant from a file. Now it is possible to view the solutions in tests. Modified the visualization of decimal places in command \cmd{\FPsv}. Modified the definition of \cmd{\FPval} to allow the use of decimal places. Modified the algorithm of choice of a variant of an exercise, now completely deterministic. Added the command \cmd{\Acapo}. Added the serbian localization (latin alphabet). The compilation produces a new file with the list of the chosen exercises.
- \item[Versione 2.1 (2016/07/25)] Modified \texttt{es-german.lng} and \texttt{es-spanish.lng} for an error in the input of the solutions. Introduced the macro \texttt{randestrai}. Introduced the macro \texttt{FPsignpol}. Introduced a control on the total points of the exercises. Solved the incompatibility with \pkgname{babel} for the Spanish language. Removed the incompatibility between the command \cmd{\fillin} and the commands \cmd{\sempli} and \cmd{\semplix}.
- \item[Version 2.2 (2017/07/01)]Introduced the possibility to have two different seeds for the choice of exercises (\cmd{\semeex}) and for the permutations and choice of the parameters (\cmd{\seme}): by default, they are equal. Slightly modified the command \cmd{\estrai} so that it is possible to use it to extract parameters from a list. Documentation integrated.
+ \item[Version 1.0 (2013/03/08)] First version released to CTAN.
+ \item[Version 1.1 (2013/12/09)] Inserted the dependance on the package \texttt{environ} to remove some errors in the \LaTeX\ compilation. Removed the dependance on the package \texttt{icomma} in the italian localization file es-italian.lng because of the introduction of new features in the package \texttt{babel} for the Italian langaguage (macro \texttt{IntelligentComma}).
+ \item[Version 2.0 (2015/02/25)] Eliminated the dependance on \pkgname{pstricks}. Modified the use of \emph{fill-in} questions. Inserted the possibility to extract more than one variant from a file. Now it is possible to view the solutions in tests. Modified the visualization of decimal places in command \cmd{\FPsv}. Modified the definition of \cmd{\FPval} to allow the use of decimal places. Modified the algorithm of choice of a variant of an exercise, now completely deterministic. Added the command \cmd{\Acapo}. Added the serbian localization (latin alphabet). The compilation produces a new file with the list of the chosen exercises.
+ \item[Versione 2.1 (2016/07/25)] Modified \texttt{es-german.lng} and \texttt{es-spanish.lng} for an error in the input of the solutions. Introduced the macro \texttt{randestrai}. Introduced the macro \texttt{FPsignpol}. Introduced a control on the total points of the exercises. Solved the incompatibility with \pkgname{babel} for the Spanish language. Removed the incompatibility between the command \cmd{\fillin} and the commands \cmd{\sempli} and \cmd{\semplix}.
+ \item[Version 2.2 (2017/07/01)]Introduced the possibility to have two different seeds for the choice of exercises (\cmd{\semeex}) and for the permutations and choice of the parameters (\cmd{\seme}): by default, they are equal. Slightly modified the command \cmd{\estrai} so that it is possible to use it to extract parameters from a list. Documentation integrated.
+ \item[Version 2.3 (2017/09/18)]Corrected a misprint in the code.
\end{description}
\bibliographystyle{plain}
diff --git a/Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.pdf b/Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.pdf
index a4b60f060fe..eb2447309dc 100644
--- a/Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.pdf
+++ b/Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.pdf
Binary files differ
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}
diff --git a/Master/texmf-dist/doc/latex/esami/esami-xyz.cfg b/Master/texmf-dist/doc/latex/esami/esami-xyz.cfg
index 59a96af21a7..f86d83c316b 100644
--- a/Master/texmf-dist/doc/latex/esami/esami-xyz.cfg
+++ b/Master/texmf-dist/doc/latex/esami/esami-xyz.cfg
@@ -1,11 +1,11 @@
%% Package `esami' to use with LaTeX 2e
-%% Copyright (C) 2008-2017 G. Messineo e S. Vassallo
+%% Copyright (C) 2008-2016 G. Messineo e S. Vassallo
%%
%% This is file `esami-xyz.cfg',
%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%% esami-xyz.cfg, 2017-07-01 %%
-%% Copyright (C) 2008-2017 G. Messineo e S. Vassallo %%
+%% esami-xyz.cfg, 2016-07-27 %%
+%% Copyright (C) 2008-2016 G. Messineo e S. Vassallo %%
%% %%
%% This program can be redistributed and/or modified %%
%% under the terms of the LaTeX Project Public License %%
diff --git a/Master/texmf-dist/tex/latex/esami/esami.sty b/Master/texmf-dist/tex/latex/esami/esami.sty
index 61b17698d51..4e1f358583e 100644
--- a/Master/texmf-dist/tex/latex/esami/esami.sty
+++ b/Master/texmf-dist/tex/latex/esami/esami.sty
@@ -2,7 +2,7 @@
%% This is file `esami.sty',
%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%% esami.sty package, 2017-07-01 %%
+%% esami.sty package, 2017-09-18 %%
%% Copyright (C) 2008-2017 G. Messineo e S. Vassallo %%
%% %%
%% This program can be redistributed and/or modified %%
@@ -32,11 +32,17 @@
%Modified es-german.lng and es-spanish.lng for an error in the input of the solutions. Introduced the macro randestrai.
%Introduced the macro FPsignpol. Introduced a control on the total points of the exercises. Solved the incompatibility
%with babel for the Spanish language. Removed the incompatibility between the command \fillin and the commands \sempli and \semplix.
+% Version 2.2
% 2017/07/01
-%Introduced the possibility to have two different seeds for exercises choice and for scrambling. Sligtly modified teh command \estrai so that can be used to extract parameters from a list. Improved the documentation.
+%Introduced the possibility to have two different seeds for exercises choice and for scrambling. Sligtly modified the command \estrai so that can be used
+%to extract parameters from a list. Improved the documentation.
+% Version 2.3
+% 2017/09/18
+%Corrected a misprint in the code
+
\NeedsTeXFormat{LaTeX2e} \ProvidesPackage{esami}
- [2017/07/01 v2.2 An Exam Construction Package]
+ [2017/09/18 v2.3 An Exam Construction Package]
% +=============================+
% | THE OPTIONS |
@@ -1908,11 +1914,6 @@
\advance\tmp@cntb by -#1
\loop
\expandafter\edef\csname #3\romannumeral\tmp@cntb\endcsname{#3\romannumeral\tmp@cntb}%
-\ifes@fillin%
-\ifes@solutions
-\immediate\write\parametri{\string\def\expandafter\unexpanded\expandafter{\csname #3\romannumeral\beg@al\endcsname}{\csname al@f\romannumeral\tmpalf \endcsname}}%
-\fi%
-\fi
\advance\tmp@cntb by-1
\ifnum\tmp@cntb>0
\repeat
@@ -1926,6 +1927,11 @@
\advance\tmp@cntb by -#1
\loop
\expandafter\edef\csname #3\romannumeral\tmp@cntb\endcsname{\csname tmp@out\romannumeral\tmp@cntb\endcsname}%
+ \ifes@fillin%
+\ifes@solutions
+\immediate\write\parametri{\string\def\expandafter\unexpanded\expandafter{\csname #3\romannumeral\tmp@cntb\endcsname}{\csname tmp@out\romannumeral\tmp@cntb\endcsname}}%
+\fi%
+\fi
\advance\tmp@cntb by-1
\ifnum\tmp@cntb>0
\repeat