summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/esami
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-07-30 23:11:21 +0000
committerKarl Berry <karl@freefriends.org>2016-07-30 23:11:21 +0000
commitef63475b97ba5f335f4b642c65af6f39982a00d2 (patch)
tree4a855450950adb4559fa2cbbe4b01a171602d2a5 /Master/texmf-dist/doc/latex/esami
parent467990204e7f3a87879281268759ba31fe0ac56d (diff)
esami (27jul16)
git-svn-id: svn://tug.org/texlive/trunk@41774 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/esami')
-rw-r--r--Master/texmf-dist/doc/latex/esami/README36
-rw-r--r--Master/texmf-dist/doc/latex/esami/VERSION1
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/esami-doc-en.pdfbin453136 -> 457576 bytes
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/esami-doc-en.tex67
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.pdfbin460454 -> 464562 bytes
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.tex91
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/esami.bib4
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/examples/esami-xyz.cfg137
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.loe180
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.pdfbin270806 -> 230852 bytes
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.tex6
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/examples/testA.pdfbin194517 -> 193516 bytes
-rw-r--r--Master/texmf-dist/doc/latex/esami/doc/examples/testA.tex10
-rw-r--r--Master/texmf-dist/doc/latex/esami/esami-xyz.cfg123
14 files changed, 261 insertions, 394 deletions
diff --git a/Master/texmf-dist/doc/latex/esami/README b/Master/texmf-dist/doc/latex/esami/README
index 9b7c72310aa..38741054280 100644
--- a/Master/texmf-dist/doc/latex/esami/README
+++ b/Master/texmf-dist/doc/latex/esami/README
@@ -1,6 +1,6 @@
- The esami package
+The esami package v. 2.1
For generation of texts and solutions of exams in LaTeX
-
+2016/07/25
File: README
Author: Grazia Messineo and Salvatore Vassallo
@@ -14,14 +14,15 @@ varying in random order, with closed or open answer, matching, problems, and so
of each group are randomly scrambled across the exam and variants of each exercise are chosen
randomly from a file which contains them all and.
-Copyright: (C) 2008--2015 Grazia Messineo & Salvatore Vassallo
+Copyright: (C) 2008--2016 Grazia Messineo & Salvatore Vassallo
Licence: LPPL
FILES IN DISTRIBUTION
=====================
BASE DISTRIBUTION:
-
+
+ VERSION
README This file.
esami.sty The main file
xyz.cfg A template of configuration file
@@ -29,18 +30,19 @@ FILES IN DISTRIBUTION
DOCUMENTATION:
- doc-esami-en.pdf User manual in English
- doc-esami-it.pdf User manual in Italian
- doc-esami-*.tex Sources for documentation
-
+ esami-doc-en.pdf User manual in English
+ esami-doc-it.pdf User manual in Italian
+ esami-doc-*.tex Sources for documentation
+ esami.bib Source for references
+
EXAMPLES:
Templates for the production of exams with solutions
- master-sol.tex
- master.tex
-
+ master-sol.tex
+ master.tex
+
Template of file for testing exercise
totale-versioni.tex
-
+
Exercises for test
test1.tex
test2.tex
@@ -53,14 +55,14 @@ FILES IN DISTRIBUTION
test13.tex
test14.tex
- Exercises with open answers
+ Exercises with open answers
problem1.tex
problem2.tex
problem2-tabella.tex
problem3-matching.tex
problem4-fillin.tex
- Examples of an exam (and solutions) built using above exercises using pdflatex, xelatex and lualatex
+ Examples of an exam (and solutions) built using above exercises using pdflatex, xelatex and lualatex
testA.pdf
testA.tex
testA-luatex-sol.pdf
@@ -76,7 +78,7 @@ FILES IN DISTRIBUTION
BASIC INSTALLATION
====================
-File sty and files cfg and lng must be copied in a folder where LATEX can find them
+File sty and files cfg and lng must be copied in a folder where LATEX can find them
For a basic installation on a TDS compliant system, move the
following files to the following directories:
@@ -86,9 +88,9 @@ File sty and files cfg and lng must be copied in a folder where LATEX can find t
xyz.cfg A template of configuration file
es-*.lng Localisation files
-
+
<texmf>/doc/latex/esami/
README
doc-esami-en.pdf User manual in English
doc-esami-it.pdf User manual in Italian
- doc-esami-*.tex Sources for documentation \ No newline at end of file
+ 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
new file mode 100644
index 00000000000..9cd6d201d23
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/esami/VERSION
@@ -0,0 +1 @@
+VERSION 2.1 DATE=July 25, 2016
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 ee5b341b2ab..3f5b7be70d0 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 feb51f1be23..1e755c1e7d9 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
@@ -13,7 +13,7 @@
\usepackage{hologo}
%\usepackage{textcomp}
\usepackage{lmodern}
-\usepackage{comandi}
+%\usepackage{comandi}
\usepackage[utf8]{inputenc}
\usepackage[english]{babel}
\usepackage{graphicx}
@@ -73,8 +73,9 @@
\changes{Version 1.0}{2013/03/08}{First version released to CTAN}
\changes{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 language (macro \texttt{IntelligentComma}).}
\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}.}
-\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.}
+%\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
@@ -82,8 +83,8 @@
\fontshape\updefault
\footnotesize}
\GetFileInfo{esami.sty}
-\def\fileversion{version 2.0}
-\def\filedate{2015/02/25}
+\def\fileversion{version 2.1}
+\def\filedate{2016/07/1}
\title{Package esami\thanks{This document
@@ -108,7 +109,7 @@ The package allows to write various type of exercises (multiple choiche question
The development of the package has begun in 2008 (\cite{esami}, \cite{tug}) with the aim of unify and extend some properties of the packages \pkgname{exerquiz} e \pkgname{eqexam} by D.P. Story \cite{acrotex} and \pkgname{probsoln} by N.Talbot \cite{probsoln}.
\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: 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.}:
+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;
@@ -142,7 +143,7 @@ In this section we will see how to build an exam using the ``esami'' package.
Options are discussed in section \ref{sec:opzioni}.
\begin{verbatim}
\def\numcompiti{10}
-\date{2013/04/21}%%% THE DATE IN THE FORMAT YYYY/MM/DD
+\date{2018/04/21}%%% THE DATE IN THE FORMAT YYYY/MM/DD
\def\Data{\longdate}%%% or \shortdate: the date in the heading
\end{verbatim}
Command \cmd{\date} is the standard \LaTeX\ command, but the date must be written in the form YYYY/MM/DD. Command \cmd{\numcompiti} states the number of versions to generate. Command \cmd{\Date} now prints the date in the form DD MMMM YYYY (\cmd{\longdate}) or DD/MM/YYYY
@@ -162,6 +163,8 @@ the routine for the compilation of variants begins here and it will end at the e
\randomi=\seme
\end{verbatim}
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.}
\begin{verbatim}
\permuta
\testa
@@ -192,7 +195,11 @@ chooses between two exercises with open answer.
\end{verbatim}
It ends the routine for the compilation. The macro \verb+\def\stringasol{}+ is used to avoid the generation of the string of correct answers in the solution file, if you don't want it.
-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.0}
+\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.
+
+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. \nuovo{vers. 2.1}
\section{Package options}\label{sec:opzioni}
The package can be loaded with the usual command
@@ -209,7 +216,7 @@ The package can be loaded with the usual command
\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 \optname{fillb}: it is an old option not anymore used, it remains for compatibility with old versions; \nuovo{vers. 2.0}
+ \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
@@ -223,7 +230,7 @@ The package can be loaded with the usual command
Each exercise (with all its variants) must be written in a separate file.
\DescribeMacro{\newproblem}
Each variant is enclosed in the command
-\cmd{\newproblem\{ .... \}} (which has no optional arguments).
+\cmd{\newproblem\{ \dots \}} (which has no optional arguments).
\begin{esempio}
\begin{verbatim}
%%% This is file1.tex with 2 variants of an exercise
@@ -272,7 +279,7 @@ Inside this environment, questions are ``loaded'' in two ways: with the environm
\end{verbatim}
The mandatory parameter is the name of each exercise you want to insert into the test, separated by a comma\footnote{We will describe other similar commands for loading the exercises in subsection \ref{list}.}.
-It is possibile both to insert all the exercises in a unique command and to use more than one command \cmd{\esercizi} or \cmd{\estraies} (see \ref{estraies}).\label{duecolonne}
+It is possibile both to insert all the exercises in a unique command and to use more than one command \cmd{\esercizi} or \cmd{\estraies} or \cmd{\randestraies} (see \ref{estraies} and \ref{randestraies}).\label{duecolonne}
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}
@@ -300,7 +307,8 @@ Also this environment is a modified version of a similar environment in \pkgname
In the file of the exercises, in
\cmd{\newproblem} you must write:
\begin{verbatim} \item \PTs{points}
-...text... \begin{answers}{number of columns}
+...text...
+\begin{answers}{number of columns}
\bChoices[random]
\Ans0 wrong answer \eAns
\Ans0 wrong answer \eAns
@@ -375,6 +383,9 @@ 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.
+
+
\subsection{Environments problem and problem*}
\DescribeEnv{problem}
\DescribeEnv{problem*}
@@ -421,9 +432,15 @@ It is introduced by the environment \envname{problem*}.
\end{parts} \end{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.
+
\subsection{Other kinds of exercise}\label{sec:altri_esercizi}
We have defined other new kinds of exercise:
-\paragraph{fillin:} \DescribeMacro{\fillin}
+\paragraph{fillin:}\label{par:fillin} \DescribeMacro{\fillin}
it is used to create exercises in which some parts of the text is left blank and must be filled by the student. It can also be used to create exercises with an open short answer. This kind of exercise is similar to the one introduced by D. P. Story in \pkgname{eqexam}.
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}
@@ -432,7 +449,7 @@ The syntax is:\\
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}).
+%In the blank space it is not possible to use the commands \cmd{\sempli} or \cmd{\semplix} (see Section \ref{sec:comandi}).
This kind of exercise cannot be used, at the moment, with \Hologo{XeLaTeX} or \Hologo{LuaLaTeX}.
\paragraph{domanda:}\DescribeEnv{domanda} (the word ``domanda'' means ``question'' in Italian)
@@ -695,6 +712,22 @@ If $a$ is equal to $2$ and $b$ is equal to $1$
\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.
@@ -706,6 +739,9 @@ The elements of the list must be comma separated.
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}
+
\DescribeMacro{\estraialfa} The command \cmd{\estraialfa}\marg{m}\marg{list}\marg{name} extracts \marg{m} random objects from the list
\marg{list}, preserving the order. The chosen elements will have name \cmd{\namei}, \cmd{\nameii}, \dots.
The elements of the list must be comma separated.
@@ -715,9 +751,13 @@ With the command \cmd{\estraialfa[2]\{a,b,c,d\}\{alpha\}} you choose 2 elements
\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}.
+\DescribeMacro{\randestraies} \label{randestraies} The macro \cmd{\randestraies}\oarg{m}\marg{list} works as the macro \cmd{\randestrai}, but only on a list of exercises. Once the elements have been chosen, it prints them as the command \cmd{\esercizi}.
+
\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.
+
+ \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}
@@ -737,6 +777,7 @@ Inside this file you should use only one command, \cmd{\def \textbackslash eserc
\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}.
\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 35dfdbee287..cf3c0db9835 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 d977b749b47..ab71d52a61d 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
@@ -12,7 +12,7 @@
\usepackage{calc}
\usepackage{hologo}
\usepackage{lmodern}
-\usepackage{comandi}
+%\usepackage{comandi}
\usepackage[utf8]{inputenc}
\usepackage[italian]{babel}
\usepackage{graphicx}
@@ -72,7 +72,7 @@
\changes{Versione 1.0}{2013/03/08}{Prima versione rilasciata al CTAN}
\changes{Versione 1.1}{2013/12/09}{Reinserita la dipendenza dal pacchetto \texttt{environ} per eliminare alcuni errori nella compilazione con \hologo{LaTeX}. Eliminata la dipendenza dal pacchetto \texttt{icomma} nel file di localizzazione es-italian.lng a seguito dell'introduzione di nuove funzionalità nel pacchetto \texttt{babel} per la lingua italiana (comando \texttt{IntelligentComma}).}
\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}.}
%\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
@@ -81,8 +81,8 @@
\fontshape\updefault
\footnotesize}
\GetFileInfo{esami.sty}
-\def\fileversion{versione 2.0}
-\def\filedate{2015/02/25}
+\def\fileversion{versione 2.1}
+\def\filedate{2016/07/1}
\title{Il pacchetto esami\thanks{Questo documento
@@ -107,7 +107,7 @@ Il pacchetto consente di scrivere esercizi di vario tipo (a risposta multipla co
Lo sviluppo del pacchetto è iniziato nel 2008 (\cite{esami}, \cite{tug}) con l'intento di estendere e unificare alcune proprietà dei pacchetti \pkgname{exerquiz} e \pkgname{eqexam} di D.P. Story \cite{acrotex} e \pkgname{probsoln} di N.Talbot \cite{probsoln}.
\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 è: 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.}
+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;
@@ -138,7 +138,7 @@ In questa sezione si vedrà come costruire una prova d'esame usando il pacchetto
Le opzioni sono discusse nella sezione \ref{sec:opzioni}
\begin{verbatim}
\def\numcompiti{10}
-\date{2013/04/21}%%% THE DATE IN THE FORMAT YYYY/MM/DD
+\date{2018/04/21}%%% THE DATE IN THE FORMAT YYYY/MM/DD
\def\Data{\longdate}%%% or \shortdate: the date in the heading
\end{verbatim}
Il comando \cmd{\date} è quello solito di \Hologo{LaTeX}, ma la data deve essere scritta nel formato YYYY/MM/DD, mentre il comando \cmd{\numcompiti} serve a definire il numero di versioni che devono essere generate.
@@ -159,7 +159,7 @@ inizia la routine di compilazione delle varianti che terminerà alla fine del do
\FPeval\seme{round((\thenomefile+\thevers):0)}
\randomi=\seme
\end{verbatim}
-genera il seme per i processi di randomizzazione e lo assegna anche a \cmd{\randomi}
+genera il seme per i processi di randomizzazione e lo assegna anche a \cmd{\randomi}. \textcolor[rgb]{1.00,0.00,0.00}{\textbf{N.B.} Se il seme è un numero minore di 1, il seme viene inizializzato usando la data e l'ora e quindi due compilazioni daranno esiti diversi.}
\begin{verbatim}
\permuta
\testa
@@ -188,8 +188,12 @@ In questo modo si definisce un ambiente per un test tipicamente con domande a ri
%%\def\stringasol{}
\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. 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}
+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.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.
+Durante la compilazione viene controllato che il numero di punti indicato per un test o un esercizio in più parti sia uguale alla somma dei punteggi parziali. \nuovo{vers. 2.1}
\section{Le opzioni del pacchetto}\label{sec:opzioni}
Per usare il pacchetto bisogna usare il solito comando
@@ -206,13 +210,13 @@ Per usare il pacchetto bisogna usare il solito comando
\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}}}: non più usata, resta per compatibilità con le versioni precedenti.\nuovo{vers. 2.0}
+ \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}.
+\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}
@@ -220,7 +224,7 @@ abilitare \texttt{shell-escape} (\Hologo{TeX} Live) o \texttt{write18} (\Hologo{
Ogni esercizio (con tutte le sue varianti) va scritto in un file separato.
\DescribeMacro{\newproblem}
Ogni variante è racchiusa nel comando
-\cmd{\newproblem\{ .... \}} (che non ha alcun argomento opzionale).
+\cmd{\newproblem\{\dots \}} (che non ha alcun argomento opzionale).
\begin{esempio}
\begin{verbatim}
%%%% Questo è il file file1.tex con 2 varianti di un esercizio
@@ -280,8 +284,9 @@ che si vogliono inserire nel test, separati da una virgola\footnote{In seguito
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} (si veda \ref{estraies}).\label{duecolonne}
-Questa possibilità è utile ad esempio se si vuole che ci siano esercizi da due
+più comandi \cmd{\esercizi} o \cmd{\estraies} o \cmd{\randestraies} (si veda \ref{estraies} e \ref{randestraies}).
+
+\label{duecolonne}Questa possibilità è utile ad esempio se si vuole che ci siano esercizi da due
sottoinsiemi diversi (5 esercizi sui limiti scelti tra 7 e 3 esercizi sulle derivate scelti tra 5) o se si vuole per esigenze di impaginazione avere alcuni esercizi su due colonne ed altri su una colonna: in tale caso
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}.
@@ -309,7 +314,8 @@ Anche questo ambiente è una versione modificata di un analogo ambiente presente
Nel file degli esercizi, la sintassi da usare all'interno di
\cmd{\newproblem} è la seguente:
\begin{verbatim} \item \PTs{punteggio}
-...testo... \begin{answers}{numero colonne}
+...testo\dots
+\begin{answers}{numero colonne}
\bChoices[random]
\Ans0 risposta errata \eAns
\Ans0 risposta errata \eAns
@@ -370,7 +376,7 @@ sono:
\end{answers}
\begin{solution}
Le soluzioni dell'equazione di secondo grado sono date dalla formula
-$x_{1,2}=\dfrac{5\pm\sqrt{5^2-4\cdot 6}}{2}$.
+$x_{1,2}=\dfrac{5\pm\sqrt{5^2-4 \cdot 6}}{2}$.
\end{solution}
}
@@ -393,6 +399,8 @@ sono:
Oltre alle domande a risposta multipla è possibile inserire nell'ambiente \envname{test} altri tipi di domande che verranno descritti nella sezione \ref{sec:altri_esercizi}, ma se si usano esercizi di tipo \texttt{fill-in} se ci sono più spazi bianchi da riempire la stringa delle soluzioni avrà un utilità minore poiché non seguirà la numerazione delle risposte.
+\textbf{N.B.} Di default ogni domanda del test è inserita in un ambiente \envname{minipage}. Nel file di configurazione di esempio ci sono alcune righe commentate che permettono di avere le domande fuori da tale ambiente.
+
\subsection{Gli ambienti problem e problem*}
\DescribeEnv{problem}
\DescribeEnv{problem*}
@@ -415,7 +423,7 @@ se invece si sceglie di scrivere un esercizio a risposta aperta in più parti. I
\begin{problem} [punteggio]
........Testo..........
\begin{solution}[spazio_soluzione]
-.... testo soluzione ......
+.\dots testo soluzione ......
\end{solution}
\end{problem}
\end{verbatim}
@@ -431,16 +439,21 @@ In \oarg{punteggio} va il punteggio dell'esercizio, in \oarg{spazio\_soluzione}
\item \PTs{punteggio della parte}
....testo....
\begin{solution}[spazio_soluzione]
- .... testo soluzione ......
+ .\dots testo soluzione ......
\end{solution}
\item \PTs{punteggio della parte}
.....
\end{parts} \end{problem*}
\end{verbatim}
Con \cmd{\PTs\{punteggio della parte\}} si indica il punteggio della singola parte.
+\paragraph{Esercizi in una minipage}
+\DescribeEnv{problemmp}
+\DescribeEnv{problemmp*}
+Esistono anche gli ambienti \envname{problemmp} e \envname{problemmp*} \nuovo{vers. 2.1} che sono del tutto identici agli ambienti \envname{problem} e \envname{problem*}, ma inseriscono tutto il testo dell'esercizio in un ambiente \envname{minipage}.
+
\subsection{Altre tipologie di esercizi}\label{sec:altri_esercizi}
Sono state definite alcune nuove tipologie di esercizio:
-\paragraph{fillin:} \DescribeMacro{\fillin}
+\paragraph{fillin:} \label{par:fillin}\DescribeMacro{\fillin}
serve per creare esercizi ``a riempimento''. Parte del testo viene lasciata vuota e deve essere riempita dallo studente. Può essere usato anche per creare esercizi a risposta aperta breve. Anche questo tipo di esercizio è simile ad un tipo di esercizio introdotto da D.P. Story nel pacchetto \pkgname{eqexam}.
Questi esercizi sono introdotti con una sintassi leggermente diversa e nel testo sono definiti o dal comando \cmd{\newfillinproblem} o da \cmd{\newproblem}\cmd{\fillinproblem}\texttt{\{testo del problema\}}. \nuovo{vers. 2.0}
@@ -452,7 +465,7 @@ I due parametri obbligatori sono la \marg{larghezza dello spazio} da lasciare, c
Il parametro opzionale definisce come deve essere segnalato lo spazio in cui inserire la risposta: \emph{u} (\emph{underlined}), che è l'opzione di default, fa sì che lo spazio sia evidenziato mediante una riga su cui va inserita la risposta, \emph{e} (\emph{empty}) crea uno spazio vuoto (non evidenziato in alcun modo), \emph{b} (\emph{boxed}) crea uno spazio circondato da un riquadro.
-All'interno del comando \cmd{\fillin} (nello spazio per la risposta) non è possibile usare i comandi \cmd{\sempli} o \cmd{\semplix} (si veda la sezione \ref{sec:comandi}).
+%All'interno del comando \cmd{\fillin} (nello spazio per la risposta) non è possibile usare i comandi \cmd{\sempli} o \cmd{\semplix} (si veda la sezione \ref{sec:comandi}).
Questo tipo di esercizio non può al momento essere usato né con \Hologo{XeLaTeX} né con \Hologo{LuaLaTeX}
\paragraph{domanda:}\DescribeEnv{problema} questo ambiente deve contenere il testo dell'esercizio (non le soluzioni). Viene usato negli ambienti \envname{problema} e \envname{problema*}, con l'opzione \optname{solutionsonly} non viene stampato il testo degli esercizi, ma solo la soluzione. Nelle versioni precedenti del pacchetto per lo stesso scopo veniva usato un altro ambiente.
@@ -506,7 +519,7 @@ La sintassi è
\begin{verbatim}
\begin{tabella}[numero colonne sempre visibili]
{allineamento colonne visibili}{allineamento colonna nascosta}
- \dots & \dots \cr
+ \dots & \dots \cr
\end{tabella}
\end{verbatim}
Il primo parametro (il cui valore di default è 2) indica il numero di colonne della tabella il cui contenuto deve essere visibile anche nel testo dell'esercizio (e non solo nella soluzione), mentre è possibile avere solo una colonna il cui contenuto è invisibile nel testo, ma appare nella soluzione. Il secondo parametro consente di scegliere l'allineamento delle colonne il cui contenuto è sempre visibile e il terzo l'allineamento della colonna invisibile.
@@ -561,16 +574,7 @@ Il pacchetto definisce altri due comandi utilizzati nel file {\tt totale-version
\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{Il pacchetto comandi}
-%\subsection{Introduzione}
-% Il pacchetto \texttt{comandi} contiene alcune macro per la formattazione del testo matematico e per l'esecuzione dei calcoli (sia all'interno degli esami che in altri file). Alcuni di questi comandi sono disponibili nel pacchetto \verb|esami| senza bisogno di caricare il pacchetto
-%
-% Per utilizzarlo all'interno di un documento occorre scrivere:
-%
-%\begin{verbatim}
-% \usepackage{comandi}
-%\end{verbatim}
-% Il pacchetto non prevede opzioni.
+
\section{I comandi per lavorare con i parametri e con le liste}
\subsection{Comandi per lavorare con i parametri (casuali)} \label{sec:comandi}
Sono stati definiti alcuni comandi per lavorare con i parametri (casuali).
@@ -643,7 +647,7 @@ Sia $k=2$. Il codice
\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.
+ 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.
@@ -711,6 +715,21 @@ Se $a$ vale $2$ e $b$ vale $1$
\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.
@@ -723,6 +742,8 @@ Gli elementi della lista devono essere separati da virgole.
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}
+
\DescribeMacro{\estraialfa} Il comando \cmd{\estraialfa}\marg{m}\marg{lista}\marg{nome} estrae \marg{m} oggetti casuali dalla lista
\marg{lista} mantenendo l'ordine fissato. Gli elementi estratti avranno nome \cmd{\nomei}, \cmd{\nomeii}, \dots.
Gli elementi della lista devono essere separati da virgole.
@@ -732,17 +753,16 @@ Con il comando \cmd{\estraialfa[2]\{a,b,c,d\}\{alpha\}} si scelgono 2 elementi d
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\}}.}
\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}}
-Questi due file differiscono solo perché il secondo mostra le soluzioni e contengono le istruzioni per generare effettivamente la prova d'esame. \textbf{I file vanno rinominati prima della compilazione}: in caso contrario la compilazione si arresta con un messaggio di errore. In entrambi è necessario indicare la data (comando \cmd{\date}) in formato YYYY/MM/DD, %il modulo dell'esame (comando \verb!\modulo!),
-il numero di compiti da generare (comando \cmd{\numcompiti}),
-%se si tratta di prova completa o parziale (comando \verb|\compito|)
-e, ovviamente, gli esercizi. Il tema d'esame può essere diviso in più parti e in ognuna si può usare uno o più degli ambienti introdotti e uno o più comandi per la stampa degli esercizi.
+Questi due file differiscono solo perché il secondo mostra le soluzioni e contengono le istruzioni per generare effettivamente la prova d'esame. \textbf{I file vanno rinominati prima della compilazione}: in caso contrario la compilazione si arresta con un messaggio di errore. In entrambi è necessario indicare la data (comando \cmd{\date}) in formato YYYY/MM/DD, il numero di compiti da generare (comando \cmd{\numcompiti}), e, ovviamente, gli esercizi. Il tema d'esame può essere diviso in più parti e in ognuna si può usare uno o più degli ambienti introdotti e uno o più comandi per la stampa degli esercizi.
Nel file possono essere definiti anche il numero massimo di ripetizioni che il comando \cmd{\FPsetpar} deve eseguire per cercare di soddisfare le condizioni poste (comando \cmd{\maxLoopLimit}) e il meccanismo di calcolo del seme iniziale per la generazione dei numeri casuali (comando \cmd{\seme}).
@@ -757,6 +777,7 @@ Al suo interno si deve usare un solo comando, \cmd{\def \textbackslash esercizio
\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}.
\end{description}
diff --git a/Master/texmf-dist/doc/latex/esami/doc/esami.bib b/Master/texmf-dist/doc/latex/esami/doc/esami.bib
index 84e7c0c155a..4380dffa628 100644
--- a/Master/texmf-dist/doc/latex/esami/doc/esami.bib
+++ b/Master/texmf-dist/doc/latex/esami/doc/esami.bib
@@ -4,7 +4,7 @@
@MISC{examdesign,
author = {Jason Alexander},
title = {The package \pkgname{examdesign}},
- howpublished = {\url{CTAN:/tex-archive/macros/latex/contrib/examdesign}},
+ howpublished = {\url{CTAN:/macros/latex/contrib/examdesign}},
year = {2006}
}
@@ -55,7 +55,7 @@
@ARTICLE{tug,
author = {Messineo, G. and Vassallo, S.},
- title = {The esami package for examinations},
+ title = {The \pkgname{esami} package for examinations},
journal = {TUGboat},
year = {2013},
volume = {34},
diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/esami-xyz.cfg b/Master/texmf-dist/doc/latex/esami/doc/examples/esami-xyz.cfg
deleted file mode 100644
index a9c42402732..00000000000
--- a/Master/texmf-dist/doc/latex/esami/doc/examples/esami-xyz.cfg
+++ /dev/null
@@ -1,137 +0,0 @@
-%% Package `esami' to use with LaTeX 2e
-%% Copyright (C) 2008-2013 G. Messineo e S. Vassallo
-%%
-%% This is file `esami-xyz.cfg',
-%%
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%% esami-xyz.cfg, 2013-03-20 %%
-%% Copyright (C) 2008-2013 G. Messineo e S. Vassallo %%
-%% %%
-%% This program can be redistributed and/or modified %%
-%% under the terms of the LaTeX Project Public License %%
-%% Distributed from CTAN archives in directory %%
-%% macros/latex/base/lppl.txt; either version 1 of the %%
-%% License, or (at your option) any later version. %%
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-%%% other packages
-\AtEndOfPackage{
-\usepackage{ifxetex}%%NUOVO
-\usepackage{ifluatex}%%%NUOVO
-\usepackage{amsmath}
-%========================================================%
-% Some shortcuts and Italian maths %
-%========================================================%
-
-\DeclareMathOperator{\sen}{sen}
-\DeclareMathOperator{\tg}{tg}
-\DeclareMathOperator{\arcsen}{arcsen}
-\DeclareMathOperator{\arctg}{arctg}
-\providecommand*{\dif}{\mathop{}\!\mathrm{d}}
-\providecommand{\dlim}{\displaystyle \lim}
-\providecommand{\me}{\mathrm{e}}
-\providecommand{\D}{\displaystyle}
-
-\newenvironment{sistema}{%%% Taken from somewhere in GUIT forum to write equations systems
-\left\lbrace\begin{array}{@{}l@{}}}%
- {\end{array}\right.%
- }
-
-\DeclareRobustCommand{\annu}[2]{_{%%% the annuity command
- \def\arraystretch{0}
- \setlength\arraycolsep{1pt}
-\setlength\arrayrulewidth{.2pt}
-\begin{array}[b]{c c}
- \setlength\arraycolsep{1.5pt}
- \begin{array}
- [b]{r|}\hline
- \\[\arraycolsep]
- \scriptstyle #1
- \end{array}&\scriptstyle#2%
-\end{array}%
-}}
-
-\newcommand{\vect}[1]{\boldsymbol{#1}}
-
-%%% We prefer var greek math %%%
-
-\newcommand{\eps}{\varepsilon}
-\newcommand{\oldtheta}{\theta} \renewcommand{\theta}{\vartheta}
-\newcommand{\oldepsilon}{\epsilon} \renewcommand{\epsilon}{\varepsilon}
-\newcommand{\oldrho}{\rho} \renewcommand{\rho}{\varrho}
-\newcommand{\oldphi}{\phi} \renewcommand{\phi}{\varphi}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%
-}
-
-% +=============================+
-% | THE HEADING |
-% +=============================+
-
- \@ifpackagewith{esami}{prova}{%
- \def\testa{\relax}}
-{%
-\def\testa{
-{\bfseries\sffamily\small
-\begin{center}
-\begin{tabular}{|lp{.33\textwidth}|lp{.3\textwidth}|lp{.3\textwidth}|}
-\hline
-\multicolumn{1}{|p{.33\textwidth}|}{\examname \newline \Data}&\multicolumn{1}{|p{.3\textwidth}|}{\profname } &\multicolumn{1}{|p{.3\textwidth}|}{\studsignname}\\[4ex]
-\hline
-\multicolumn{1}{|p{.33\textwidth}|}{\studlastname:}&\multicolumn{1}{|p{.3\textwidth}|}{\studfirstname:}&\multicolumn{1}{|p{.3\textwidth}|}{\studid:}\\[4ex]
-\hline
-\end{tabular}\\[3ex]
-\end{center}}
- }
- }
-
-% +=============================+
-% | THE FOOTER |
-% +=============================+
-
-\ifes@solutions%%%solutions
-\def\ps@esame{\let\@oddhead\@empty\def\@oddfoot{\hfil \textbf{\versionname\
-n. \thevers} -- %%
-\textbf{\solutionsname} -- %%
- \pagename\ \thepage
-\hfil}\let\@evenhead\@empty\let\@evenfoot\@empty}
-\else%%% no solutions
- \def\ps@esame{
- \let\@oddhead\@empty\def\@oddfoot%%
- {\hfil \textbf{\versionname\ n. \thevers\
- -- \pagename\ \thepage}\hfil}\let\@evenhead\@empty\let\@evenfoot\@empty}
-\fi
-
-% +=============================+
-% | THE SOLUTION STRING |
-% +=============================+
-
-\def\ps@soltest{\let\@oddhead\@empty\def\@oddfoot{\hfil %\textbf{\versionname\ n. \thevers} -- %%
-\textbf{\solutionsname} -- \pagename\ \thepage
-\hfil}\let\@evenhead\@empty\let\@evenfoot\@empty}
-
-\ifes@solutions
-\newcommand{\stringasol}{\newpage%
-\vspace{.8cm}
-\pagestyle{soltest}
- \input{\jobname.sol.tex} %
-}
-\else
-\newcommand{\stringasol}{\relax}
-\fi
-
-
-% +=============================+
-% | SOME INTRUCTIONS |
-% +=============================+
-
-\def\istruzionii{{
-\sffamily \textbf{INSTRUCTIONS}
-\begin{itemize}
- \item Write here your instructions
- \item two
- \item three
-\end{itemize}}}
-
-\def\istruzioniii{\setlength{\fboxsep}{1.5ex}\setlength{\fboxrule}{1.2pt}{\sffamily
-\framebox{\parbox{\textwidth}{\textbf{Some other instructions.}}}}\\[3ex]}
diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.loe b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.loe
deleted file mode 100644
index 677a7771f5e..00000000000
--- a/Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.loe
+++ /dev/null
@@ -1,180 +0,0 @@
-Version n. 1
-Exercise 1: e:1-file:test2-q:iii
-Exercise 2: e:1-file:test2-q:i
-Exercise 3: e:1-file:test2-q:ii
-Exercise 4: e:1-file:test3-q:ii
-Exercise 5: e:1-file:test3-q:i
-Exercise 6: e:1-file:test4-q:v
-Exercise 7: e:1-file:test14-q:i
-Exercise 8: e:1-file:test9-q:iv
-Exercise 9: e:1-file:test1-q:i
-Exercise 10: e:1-file:test5-fillin-q:i
-Exercise 11: e:1-file:test11-q:i
-Exercise 12: e:1-file:test11-q:ii
-Exercise 1: e:1-file:test12-q:i
-Exercise 2: e:1-file:test13-q:i
-Exercise 1: e:1-file:problem1-q:i
-
-
-Version n. 2
-Exercise 1: e:2-file:test3-q:iv
-Exercise 2: e:2-file:test2-q:i
-Exercise 3: e:2-file:test3-q:i
-Exercise 4: e:2-file:test2-q:iii
-Exercise 5: e:2-file:test2-q:ii
-Exercise 6: e:2-file:test1-q:ii
-Exercise 7: e:2-file:test14-q:v
-Exercise 8: e:2-file:test4-q:i
-Exercise 9: e:2-file:test5-fillin-q:ii
-Exercise 10: e:2-file:test9-q:ii
-Exercise 11: e:2-file:test11-q:i
-Exercise 12: e:2-file:test11-q:ii
-Exercise 1: e:2-file:test13-q:iv
-Exercise 2: e:2-file:test12-q:ii
-Exercise 1: e:2-file:problem1-q:i
-
-
-Version n. 3
-Exercise 1: e:3-file:test2-q:i
-Exercise 2: e:3-file:test2-q:iii
-Exercise 3: e:3-file:test3-q:iii
-Exercise 4: e:3-file:test2-q:ii
-Exercise 5: e:3-file:test3-q:ii
-Exercise 6: e:3-file:test14-q:i
-Exercise 7: e:3-file:test5-fillin-q:i
-Exercise 8: e:3-file:test1-q:i
-Exercise 9: e:3-file:test9-q:iii
-Exercise 10: e:3-file:test4-q:iv
-Exercise 11: e:3-file:test11-q:i
-Exercise 12: e:3-file:test11-q:ii
-Exercise 1: e:3-file:test12-q:i
-Exercise 2: e:3-file:test13-q:ii
-Exercise 1: e:3-file:problem1-q:i
-
-
-Version n. 4
-Exercise 1: e:4-file:test3-q:iv
-Exercise 2: e:4-file:test2-q:i
-Exercise 3: e:4-file:test2-q:iii
-Exercise 4: e:4-file:test3-q:ii
-Exercise 5: e:4-file:test2-q:ii
-Exercise 6: e:4-file:test5-fillin-q:ii
-Exercise 7: e:4-file:test1-q:ii
-Exercise 8: e:4-file:test9-q:iii
-Exercise 9: e:4-file:test14-q:iv
-Exercise 10: e:4-file:test4-q:ii
-Exercise 11: e:4-file:test11-q:i
-Exercise 12: e:4-file:test11-q:ii
-Exercise 1: e:4-file:test13-q:iii
-Exercise 2: e:4-file:test12-q:iii
-Exercise 1: e:4-file:problem1-q:i
-
-
-Version n. 5
-Exercise 1: e:5-file:test2-q:i
-Exercise 2: e:5-file:test2-q:ii
-Exercise 3: e:5-file:test3-q:iii
-Exercise 4: e:5-file:test3-q:iv
-Exercise 5: e:5-file:test2-q:iii
-Exercise 6: e:5-file:test9-q:ii
-Exercise 7: e:5-file:test4-q:iii
-Exercise 8: e:5-file:test1-q:i
-Exercise 9: e:5-file:test5-fillin-q:i
-Exercise 10: e:5-file:test14-q:ii
-Exercise 11: e:5-file:test11-q:i
-Exercise 12: e:5-file:test11-q:ii
-Exercise 1: e:5-file:test12-q:i
-Exercise 2: e:5-file:test13-q:iii
-Exercise 1: e:5-file:problem1-q:i
-
-
-Version n. 6
-Exercise 1: e:6-file:test3-q:iv
-Exercise 2: e:6-file:test3-q:ii
-Exercise 3: e:6-file:test2-q:iii
-Exercise 4: e:6-file:test2-q:ii
-Exercise 5: e:6-file:test2-q:i
-Exercise 6: e:6-file:test14-q:iii
-Exercise 7: e:6-file:test1-q:ii
-Exercise 8: e:6-file:test4-q:i
-Exercise 9: e:6-file:test9-q:i
-Exercise 10: e:6-file:test5-fillin-q:ii
-Exercise 11: e:6-file:test11-q:i
-Exercise 12: e:6-file:test11-q:ii
-Exercise 1: e:6-file:test13-q:ii
-Exercise 2: e:6-file:test12-q:iii
-Exercise 1: e:6-file:problem1-q:i
-
-
-Version n. 7
-Exercise 1: e:7-file:test3-q:i
-Exercise 2: e:7-file:test3-q:iv
-Exercise 3: e:7-file:test2-q:i
-Exercise 4: e:7-file:test2-q:ii
-Exercise 5: e:7-file:test2-q:iii
-Exercise 6: e:7-file:test1-q:i
-Exercise 7: e:7-file:test4-q:iii
-Exercise 8: e:7-file:test5-fillin-q:i
-Exercise 9: e:7-file:test9-q:iv
-Exercise 10: e:7-file:test14-q:i
-Exercise 11: e:7-file:test11-q:i
-Exercise 12: e:7-file:test11-q:ii
-Exercise 1: e:7-file:test12-q:ii
-Exercise 2: e:7-file:test13-q:i
-Exercise 1: e:7-file:problem1-q:i
-
-
-Version n. 8
-Exercise 1: e:8-file:test2-q:ii
-Exercise 2: e:8-file:test3-q:iii
-Exercise 3: e:8-file:test3-q:i
-Exercise 4: e:8-file:test2-q:iii
-Exercise 5: e:8-file:test2-q:i
-Exercise 6: e:8-file:test1-q:ii
-Exercise 7: e:8-file:test9-q:ii
-Exercise 8: e:8-file:test14-q:iii
-Exercise 9: e:8-file:test4-q:v
-Exercise 10: e:8-file:test5-fillin-q:ii
-Exercise 11: e:8-file:test11-q:i
-Exercise 12: e:8-file:test11-q:ii
-Exercise 1: e:8-file:test13-q:iv
-Exercise 2: e:8-file:test12-q:iii
-Exercise 1: e:8-file:problem1-q:i
-
-
-Version n. 9
-Exercise 1: e:9-file:test3-q:i
-Exercise 2: e:9-file:test3-q:iv
-Exercise 3: e:9-file:test2-q:ii
-Exercise 4: e:9-file:test2-q:iii
-Exercise 5: e:9-file:test2-q:i
-Exercise 6: e:9-file:test5-fillin-q:i
-Exercise 7: e:9-file:test4-q:iv
-Exercise 8: e:9-file:test9-q:iii
-Exercise 9: e:9-file:test1-q:i
-Exercise 10: e:9-file:test14-q:v
-Exercise 11: e:9-file:test11-q:i
-Exercise 12: e:9-file:test11-q:ii
-Exercise 1: e:9-file:test12-q:i
-Exercise 2: e:9-file:test13-q:ii
-Exercise 1: e:9-file:problem1-q:i
-
-
-Version n. 10
-Exercise 1: e:10-file:test3-q:ii
-Exercise 2: e:10-file:test3-q:i
-Exercise 3: e:10-file:test2-q:i
-Exercise 4: e:10-file:test2-q:iii
-Exercise 5: e:10-file:test2-q:ii
-Exercise 6: e:10-file:test5-fillin-q:ii
-Exercise 7: e:10-file:test14-q:iv
-Exercise 8: e:10-file:test9-q:iv
-Exercise 9: e:10-file:test1-q:ii
-Exercise 10: e:10-file:test4-q:ii
-Exercise 11: e:10-file:test11-q:i
-Exercise 12: e:10-file:test11-q:ii
-Exercise 1: e:10-file:test13-q:iii
-Exercise 2: e:10-file:test12-q:ii
-Exercise 1: e:10-file:problem1-q:i
-
-
diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.pdf b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.pdf
index 6f97b2b68dc..c97d3ce5829 100644
--- a/Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.pdf
+++ b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.tex b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.tex
index 5ac5a3bef05..a6fe9379252 100644
--- a/Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.tex
+++ b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.tex
@@ -17,14 +17,14 @@
\usepackage[utf8]{inputenc}
\usepackage{lmodern,textcomp}
\fi\fi
-
+\usepackage{enumitem}
% +=============================+
% | DEFINITIONS |
% +=============================+
\def\examname{The name of the exam}
\def\numcompiti{10}%%% The number of the versions
-\date{2014/07/22}%%% THE DATE IN THE FORMAT AAAA/M/D
+\date{2014/07/22}%%% THE DATE IN THE FORMAT AAAA/M/D THE DATE IN THE FORMAT YYYY/M/D or D/M/YYYY
\def\Data{\longdate}%%% or \shortdate: the date in the heading
%\def\cartella{d:/folder}%%% The folder where are the exercises: by default the current folder%
%\def\Acapo{\newpage}
@@ -57,7 +57,7 @@
\section*{Part One}
-\begin{test}[8]
+\begin{test}[18]
\begin{questions}
\ifluatex
\esercizi{
diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/testA.pdf b/Master/texmf-dist/doc/latex/esami/doc/examples/testA.pdf
index a37b9f7cc3d..cef44ec338c 100644
--- a/Master/texmf-dist/doc/latex/esami/doc/examples/testA.pdf
+++ b/Master/texmf-dist/doc/latex/esami/doc/examples/testA.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/testA.tex b/Master/texmf-dist/doc/latex/esami/doc/examples/testA.tex
index ca2029d88ae..181d3a042c1 100644
--- a/Master/texmf-dist/doc/latex/esami/doc/examples/testA.tex
+++ b/Master/texmf-dist/doc/latex/esami/doc/examples/testA.tex
@@ -1,4 +1,4 @@
-\documentclass[a4paper,english]{article}
+\documentclass[a4paper,italian]{article}
\usepackage[shuffle,xyz,pointsonright,nosolutions,noquizsolutions,twocolumns]{esami}%%%%% TEMA
\ifluatex
@@ -23,11 +23,13 @@
% +=============================+
\def\examname{The name of the exam}
-\def\numcompiti{10}%%% The number of the versions
-\date{2014/07/22}%%% THE DATE IN THE FORMAT AAAA/M/D
+\def\numcompiti{1}%%% The number of the versions
+\date{2014/07/22}%%% THE DATE IN THE FORMAT YYYY/M/D or D/M/YYYY
\def\Data{\longdate}%%% or \shortdate: the date in the heading
%\def\cartella{d:/folder}%%% The folder where are the exercises: by default the current folder%
%\def\Acapo{\newpage}
+\usepackage{babel}
+
\begin{document}
\testversioni
\pagestyle{esame}
@@ -57,7 +59,7 @@
\section*{Part One}
-\begin{test}[8]
+\begin{test}[18]
\begin{questions}
\ifluatex
\esercizi{
diff --git a/Master/texmf-dist/doc/latex/esami/esami-xyz.cfg b/Master/texmf-dist/doc/latex/esami/esami-xyz.cfg
index a9c42402732..2a2faf91ba4 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-2013 G. Messineo e S. Vassallo
+%% Copyright (C) 2008-2016 G. Messineo e S. Vassallo
%%
%% This is file `esami-xyz.cfg',
%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%% esami-xyz.cfg, 2013-03-20 %%
-%% Copyright (C) 2008-2013 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 %%
@@ -135,3 +135,120 @@ n. \thevers} -- %%
\def\istruzioniii{\setlength{\fboxsep}{1.5ex}\setlength{\fboxrule}{1.2pt}{\sffamily
\framebox{\parbox{\textwidth}{\textbf{Some other instructions.}}}}\\[3ex]}
+
+ %\AtBeginDocument{
+ %\renewcommand\stepverssols{\immediate\write\sols{{\string\large\string\textbf{\es@solutionname\ \versionname\ n. \thevers}}}
+%}
+ %\renewcommand\closeverssols{
+ %\immediate\write\sols{\string\vspace{5ex}}}
+% }
+
+\AtEndOfPackage{
+\newdimen\punteggio %% NEW 2016/04/11 to check the total score of exercises
+\setlength{\punteggio}{0pt}
+\def\@PTs#1{%
+\addtolength{\punteggio}{#1 pt} %% NEW 2016/04/11 to check the total score of exercises
+\global\punteggio=\punteggio
+ \gdef\es@PTs{#1}\ifx\es@PTs\@empty\gdef\es@PTs{1}\fi
+ \global\let\esPTs=\es@PTs\global\let\es@PTs=\@empty
+ \if\es@star*\else\PTs@Hook\fi
+}
+\renewcommand{\checkpoints}{%
+\ifdim\punteggio=\punti pt %% NEW 2016/04/11 to check the total score of exercises
+ \else
+\PackageError{esami}{\es@pointerrorshort} {\es@pointerrorlong}
+ \fi
+ \global\punteggio=0pt%
+ }
+ }
+
+%%%% %%%%% HERE I GET RID OF THE MINIPAGE IN MULTIPLE CHOICE QUESTIONS
+%\AtEndOfPackage{
+%\renewcommand{\selectrandomly}[1]{%
+%\global\@probN=0\relax
+%\firstpasstrue
+%\tmp@quest=0
+%\input{#1}%%%%%
+%\firstpassfalse%%% now prints the question
+%\tmp@quest=0
+%\input{#1}
+%\@ifundefined{base\nome}{\old@random=\number\randomi %%% 2015/01/16
+%\setrannum{\rnd@cnta}{1}{\@probN}
+%\randomi=\number\old@random
+%\expandafter\global\expandafter\edef\csname base\nome \endcsname{\number\rnd@cnta}
+%}{}
+%\FPeval\restotrentasei{round(\thevers+\thenomefile+1+base\nome-trunc((\thevers+\thenomefile+base\nome)/36:0)*36:0)}
+%\ifcase\@probN\or
+%\def\j@n{1}%%% just one variant
+%\or%%% 2 variants
+%\ifthenelse{\isodd{\thevers}}{\def\j@n{1}}{\def\j@n{2}}
+%\or%%% 3 variants
+%\def\j@n{\ifcase\restotrentasei\or 3\or 2\or 1\or 2\or 1\or 3\or 1\or 3\or 2\or 3\or 1\or 2\or 1\or 2\or 3\or 2\or 3\or 1\or 3\or 2\or 1\or 2\or 1\or 3\or 1\or 3\or 2\or 3\or 1\or 2\or 1\or 2\or 3\or 2\or 3\or 1\fi}%
+%\or%%% 4 variants
+%\def\j@n{\ifcase\restotrentasei\or 3\or 4\or 1\or 2\or 1\or 2\or 3\or 4\or 3\or 1\or 4\or 2\or 4\or 2\or 3\or 1\or 2\or 3\or 1\or 4\or 1\or 4\or 2\or 3\or 3\or 2\or 1\or 4\or 2\or 3\or 4\or 1\or 4\or 3\or 2\or 1\fi}%
+%\or%%% 5 variants
+%\def\j@n{\ifcase\restotrentasei\or 5\or 1\or 2\or 3\or 4\or 5\or 2\or 3\or 5\or 1\or 4\or 3\or 1\or 4\or 2\or 5\or 4\or 2\or 3\or 5\or 1\or 5\or 1\or 4\or 2\or 3\or 1\or 3\or 5\or 4\or 2\or 3\or 4\or 5\or 2\or 1\fi}%
+%\or%%% 6 variants
+%\def\j@n{\ifcase\restotrentasei\or 2\or 5\or 1\or 3\or 4\or 2\or 6\or 1\or 3\or 6\or 5\or 4\or 2\or 3\or 2\or 5\or 4\or 1\or 6\or 1\or 4\or 3\or 2\or 6\or 5\or 4\or 6\or 2\or 5\or 1\or 3\or 6\or 3\or 5\or 1\or 4\fi}%
+%\or%%% 7 variants
+%\def\j@n{\ifcase\restotrentasei\or 2\or 4\or 1\or 5\or 3\or 6\or 7\or 4\or 1\or 5\or 7\or 6\or 2\or 3\or 7\or 2\or 4\or 6\or 5\or 3\or 1\or 3\or 4\or 7\or 2\or 6\or 1\or 5\or 4\or 5\or 6\or 7\or 3\or 2\or 1\or 5\fi}%
+%\or%%% 8 variants
+%\def\j@n{\ifcase\restotrentasei\or 2\or 8\or 6\or 7\or 4\or 3\or 1\or 5\or 8\or 5\or 1\or 3\or 7\or 6\or 4\or 2\or 7\or 1\or 8\or 6\or 3\or 2\or 5\or 4\or 1\or 3\or 7\or 5\or 6\or 4\or 2\or 8\or 4\or 3\or 1\or 5\fi}%
+%\else
+%\FPeval\j@n{round(\thevers*\es@primo+base\nome+1-trunc((\thevers*\es@primo+base\nome)/\number\@probN:0)*\number\@probN:0)}
+%\fi
+%\def\probchosen{\problabel-q:\romannumeral\j@n}
+%\ifes@test
+%\csname @probi-\problabel-q:\romannumeral\j@n \endcsname \vspace{5mm}
+%\Acapo
+%\else
+%\csname @probi-\problabel-q:\romannumeral\j@n \endcsname \vspace{5mm}
+%\Acapo
+%\fi
+% \ifes@fillin
+% \immediate\closeout\parametri
+% \fi
+%}
+%}
+
+%%%% %%%%% HERE I GET RID OF THE MINIPAGE IN EXERCISES
+%\AtEndOfPackage{
+%\renewenvironment{problem}[1][]{%%% it's like exercise, but with points
+%\es@testfalse
+%%\begin{minipage}{\linewidth} %%% new 2016/02/19
+%\renewcommand{\punti}{#1}
+%\ifes@solutionsonly\else\examenddef\fi
+%\begin{exercise}
+%\ifes@prova
+%\else
+%\ifes@solutions
+%\immediate\write\loe{\es@exercisename\space \theex@no:\space \probchosen}
+%\fi
+%\fi
+%}
+%{
+%\end{exercise}
+%%\end{minipage}%%% new 2016/02/19
+%\ifes@param
+%\immediate\closeout\params
+%\fi}
+%
+%\renewenvironment{problem*}[1][]{\es@testfalse
+%%\begin{minipage}{\linewidth} %%% new 2016/02/19
+%\renewcommand{\punti}{#1}
+%\ifes@solutionsonly\else\examenddef\fi
+%\begin{exercise*}
+%\ifes@prova
+%\else
+%\ifes@solutions
+%\immediate\write\loe{\es@exercisename\space \theex@no:\space \probchosen}
+%\fi
+%\fi
+%}
+%{
+%\end{exercise*}
+%%\end{minipage}%%% new 2016/02/19
+%\ifes@param
+%\immediate\closeout\params
+%\fi }
+%}