diff options
author | Karl Berry <karl@freefriends.org> | 2015-02-27 22:45:28 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2015-02-27 22:45:28 +0000 |
commit | 1763513125c2b946a98a96c58651faed9c8f5634 (patch) | |
tree | 0b809d843f9a29eb2a94c42cff845f0b347a6065 /Master/texmf-dist | |
parent | 958e0067544a1527819ac2f103da0983a2792c8d (diff) |
esami (27feb15)
git-svn-id: svn://tug.org/texlive/trunk@36393 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
37 files changed, 1303 insertions, 1378 deletions
diff --git a/Master/texmf-dist/doc/latex/esami/README b/Master/texmf-dist/doc/latex/esami/README index c2a04a70759..9b7c72310aa 100644 --- a/Master/texmf-dist/doc/latex/esami/README +++ b/Master/texmf-dist/doc/latex/esami/README @@ -14,7 +14,7 @@ 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--2013 Grazia Messineo & Salvatore Vassallo +Copyright: (C) 2008--2015 Grazia Messineo & Salvatore Vassallo Licence: LPPL FILES IN DISTRIBUTION @@ -43,24 +43,35 @@ FILES IN DISTRIBUTION Exercises for test test1.tex + test2.tex + test3.tex + test4.tex + test5-fillin.tex + test9.tex test11.tex - test12.tex - test13.tex - test14.tex - test2.tex - test3.tex - test4.tex - test5-fillin.tex - + test12.tex + test13.tex + test14.tex + Exercises with open answers problem1.tex + problem2.tex problem2-tabella.tex problem3-matching.tex problem4-fillin.tex - Examples of an exam built using above exercises + Examples of an exam (and solutions) built using above exercises using pdflatex, xelatex and lualatex testA.pdf testA.tex + testA-luatex-sol.pdf + testA-luatex.pdf + testA-sol.pdf + testA-sol.tex + testA-xetex-sol.pdf + testA-xetex.pdf + testA.pdf + testA.tex + testA-sol.loe BASIC INSTALLATION ==================== @@ -76,7 +87,7 @@ File sty and files cfg and lng must be copied in a folder where LATEX can find t es-*.lng Localisation files - <texmf>/doc/latex/booktabs/ + <texmf>/doc/latex/esami/ README doc-esami-en.pdf User manual in English doc-esami-it.pdf User manual in Italian 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 Binary files differindex 76d9c2c4237..fae5223ff85 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 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 80e2e2e7cd2..f12342dd08b 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 @@ -10,6 +10,7 @@ \usepackage[braces]{colordoc} \usepackage[T1]{fontenc} \usepackage{calc} +\usepackage{hologo} %\usepackage{textcomp} \usepackage{lmodern} \usepackage{comandi} @@ -70,7 +71,8 @@ % \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 langaguage (macro \texttt{IntelligentComma}).} +\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.} \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}} @@ -80,14 +82,14 @@ \fontshape\updefault \footnotesize} \GetFileInfo{esami.sty} -\def\fileversion{versione 1.1} -\def\filedate{2013/12/09} +\def\fileversion{version 2.0} +\def\filedate{2015/02/25} \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{Nuovo #1}}}}} +\newcommand{\nuovo}[1]{\marginpar{\raggedleft{ \footnotesize{\textsf{New #1}}}}} \maketitle @@ -104,35 +106,37 @@ Package \texttt{esami} (i.e. exams in Italian) was created to generate texts and The package allows to write various type of exercises (multiple choiche questions with answers varying in random order, with closed or open answer, \emph{matching}, problems, and so on). Questions 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, as far as we know, it is the only package which allows to do this just using \LaTeX\ ad not auxiliary programs. -The development of the package has begun in 2008 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}. +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: +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{pstricks}, \pkgname{pstricks-add} e \pkgname{auto-pst-pdf}: for graphics (our choice was \pkgname{pstricks} instead of other similar packages because we are used to it); +\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{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}). +\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. +All these packages are available both in \TeX Live and in MiK\TeX. \section{Installation} -The package contains the file {\tt esami.sty}, some configuration files {\tt *.cfg}, 3 templates for the compilation and the documentation files. File {\tt sty} and files {\tt cfg} and {\tt lng} must be copied in a folder where \LaTeX\ can find them (i.e. {\tt texmf-local/tex/latex/esami}). An update of the database must be run. +The package contains the file {\tt esami.sty}, some configuration files {\tt *.cfg}, the localization files, 3 templates for the compilation and the documentation files. File {\tt sty} and files {\tt cfg} and {\tt lng} must be copied in a folder where \LaTeX\ can find them (i.e. {\tt texmf-local/tex/latex/esami}). An update of the database must be run. \section{How to write an exam} In this section we will see how to build an exam using the ``esami'' package. \subsection{Preamble} \begin{verbatim} -\documentclass[<language>]{article} +\documentclass[language]{article} \usepackage[<options>]{esami} \end{verbatim} Options are discussed in section \ref{sec:opzioni}. @@ -145,12 +149,12 @@ Command \cmd{\date} is the standard \LaTeX\ command, but the date must be writte \subsection{The document} \begin{verbatim} \begin{document} -\date{\Data} \pagestyle{esame} -%% \immediate\openout\sols=\thenomefile.sol.tex +\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 is used in the solutions file to generate another file which contains the string of the correct answers to MCQ. + 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}{\stepcounter{vers} + \whiledo{\thevers<\numcompiti}{\stepvers \end{verbatim} the routine for the compilation of variants begins here and it will end at the end of document. \begin{verbatim} @@ -159,35 +163,36 @@ the routine for the compilation of variants begins here and it will end at the e \end{verbatim} generates the seed for the randomization process and assigns it also to \cmd{\randomi}. \begin{verbatim} -%%\immediate\write\sols{\string\begin{minipage}{.33\string\textwidth} -\string\large\string\textbf{Solution of Version n. \thevers}} +\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 commented command generates the string of the correct answers in the solutions file. + \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] \begin{questions} \esercizi{test1,test2,test3,test4} +\begin{esdb}{dbone} + \selectrandomlyn{2}{dbtest1} +\selectrandomlyn{4}{dbtest2} +\end{esdb} \end{questions} \end{test} -%%\immediate\write\sols{\string\par\string\end\string{enumerate\string}\string\end{minipage} -%% \string\vspace{1.5cm}} \end{verbatim} -Here we define an environment for a test with (usually) MCQ. The command \cmd{\esercizi} chooses randomly the exercises from the files written in it and scrambles them. As before, the commented commands are used in the solutions file to generate the string of the correct answers. +Here we define an environment for a test with (usually) MCQ. The command \cmd{\esercizi} chooses randomly the exercises from the files written in it and scrambles them, the environment \envname{esdb} defines a virtual database of exercises in which they are put by the command \cmd{\selectrandomlyn}. \begin{verbatim} \esercizi{problema1, problema2} \end{verbatim} chooses between two exercises with open answer. \begin{verbatim} -\setcounter{page}{1} +\closevers } -%%\immediate\closeout\sols -%%\stringasol +%%\def\stringasol{} \end{document} \end{verbatim} -It ends the routine for the compilation and closes the string of correct answers in the solution file. +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} \section{Package options}\label{sec:opzioni} The package can be loaded with the usual command @@ -199,16 +204,17 @@ The package can be loaded with the usual command \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{solutionsonly}: it generates a file with the solutions only if the environment \envname{domanda} is used; + \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 \optname{fillb}: this option is necessary in order to have the correct answers in the string of solutions if there are exercises of \verb|fillin| type; + \item \optname{fillb}: it is an old option not anymore used, it remains for compatibility with old versions; \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 package \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:lngsec: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}. + \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} @@ -236,7 +242,7 @@ The environment is created by the command \end{test} \end{verbatim} \DescribeMacro{points} -The optional parameter \oarg{points} must be an integer number greater or equal to 1, which is the total number of points given to the whole group of questions. +The optional parameter \oarg{points} represents the total number of points given to the whole group of questions. \DescribeEnv{questions} The questions of each group, in the master file, are enclosed in the environment \emph{questions} which is a modified version of the environment with the same name in the package \pkgname{exerquiz}: @@ -260,11 +266,11 @@ It is possibile to insert in a \envname{test} environment more than one \envname \end{verbatim} \end{esempio} \DescribeMacro{\esercizi} -Inside this environment, questions are loaded by the command \cmd{\esercizi} (exercises in Italian): +Inside this environment, questions are ``loaded'' in two ways: with the environment \envname{esdb} which will be described later, or with the command \cmd{\esercizi} (exercises in Italian): \begin{verbatim} \esercizi{name of source file 1, name of source file 2,...} \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 commands for loading the exercises in subsection \ref{list}.}. +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} 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 @@ -281,6 +287,16 @@ This is useful for example if you want exercises from two different subsets (5 e \end{esempio} In this way, exercises \texttt{es1,es2,es3} are typeset on two columns, while exercises \texttt{es4,es5,es6} are typeset on one column. +\DescribeEnv{esdb} +\DescribeMacro{selectrandomlyn} + +The environment \envname{esdb}\marg{nome db} defines a virtual database of exercises named \emph{nome db} (the name of the database \textbf{must} be different from the name of every other file of exercises, of other databases and from the name given to the master file, because it is the name of a file written during the compilation). Within this environment, one or more exercises can be chosen with the commands \cmd{\selectrandomlyn}\marg{numero esercizi}\marg{nome file}, where \emph{nome file} is the name of the file from which exercises are extracted and \emph{numero esercizi} is the number of exercises to be extracted (if the number of exercises is ``all'' or is greater than the number of variants in the file, all the exercises are chosen)\nuovo{vers. 2.0}. + +The environment generates a file \texttt{nome db.tex} which contains the references to all the exercises chosen. When the environment is closed, exercises are automatically written with the command \cmd{\esercizidb}\marg{nome db} (not to be written). If more than one environment \envname{esdb} is used, each one must be given a different name. + +Also this environment is a modified version of a similar environment in \pkgname{probsoln} and, at the moment, does not work nor with \hologo{XeLaTeX} nor with \hologo{LuaLaTeX}. + + In the file of the exercises, in \cmd{\newproblem} you must write: \begin{verbatim} \item \PTs{points} @@ -321,6 +337,8 @@ introduces answers split on the specified number of columns. Answers will be ran \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} \newproblem{ @@ -408,12 +426,15 @@ We have defined other new kinds of exercise: \paragraph{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} The syntax is:\\ \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 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}). + +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) this environment must contain the text of the exercise (not the solution). It is used in \envname{problem} and \envname{problem*} and with the package option \optname{solutionsonly} only the solution of the exercise is printed and not the text. In previous versions of this package (not released to CTAN) there was another environment in order to obtain this. \paragraph{risposta:}\DescribeEnv{risposta} This environment generates a ruled or boxed space in which the student has to write the answer of an exercise (``risposta'' is the Italian word for ``answer''). @@ -460,6 +481,8 @@ The two lists are shuffled and then printed with the command \cmd{\matching}. \end{minipage} \end{esempio} The solutions show the correct matching. + +Also this kind of exercise does not work with \Hologo{XeLaTeX} or \Hologo{LuaLaTeX}. \paragraph{tabella:}\DescribeEnv{tabella} (the word ``tabella'' means ``table'' in Italian) it is used to create exercises with many short open answers in column. The syntax is (the \cs{cr} at the end of the line is necessary): @@ -473,6 +496,7 @@ The syntax is (the \cs{cr} at the end of the line is necessary): The first parameter (default 2) is the number of columns of the table visible in the text of the exercise. The last column is invisible in the text and visible in the solutions. The second parameter gives the alignment of the visible columns (the same for all the columns) and the third one the alignment of the hidden column. +This kind of exercise works with \Hologo{XeLaTeX}, but not with \Hologo{LuaLaTeX}. \begin{esempio} With the code \begin{verbatim} @@ -531,7 +555,7 @@ These commands are based on the package \pkgname{fp} \cite{fp}, which allows the {\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 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). @@ -554,7 +578,7 @@ create two parameters, \cmd{\a} (which can be a random value between 2 and 10, e 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}\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) 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}). + \item {\color{blue}{\cmd{\FPsv}\oarg{decimal}\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} @@ -592,7 +616,7 @@ The fundamental characteristics of the command \cmd{\FPsv} are (in the examples, \item {\color{blue}{\cmd{\FPval}\marg{name}\marg{operation}}}:\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 - con \cmd{\FPsv}. + with \cmd{\FPsv}. The result is given with the chosen number of decimal places, eliminating the useless zeroes. \begin{esempio} Let $k=2$. The code \begin{verbatim} @@ -618,6 +642,7 @@ If $k=1$: \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}. @@ -657,7 +682,7 @@ If the parameter $k$ is equal to $2$: \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 error and stops the compilation, with this command the value $0$ is written. + \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). @@ -675,7 +700,7 @@ If $a$ is equal to $2$ and $b$ is equal to $1$ 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. The first command allows to choose randomly $n-m$ elements of a list -\DescribeMacro{\estrai}.\ The command \cmd{\estrai}\oarg{m}\marg{list}\marg{name} is the user command to extract the elements from the list \marg{list} excluding \oarg{m} of them. The chosen elements will have the name \cmd{\namei}, \cmd{\nameii}, \dots. +\DescribeMacro{\estrai}.\ The command \cmd{\estrai}\oarg{m}\marg{list}\marg{name} is the user command to extract the elements from the list \marg{list} excluding \emph{m} of them. The chosen elements will have the name \cmd{\namei}, \cmd{\nameii}, \dots. The elements of the list must be comma separated. \begin{esempio} @@ -688,11 +713,11 @@ The elements of the list must be comma separated. 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}\marg{name} 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{\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}. \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), 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. \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} @@ -706,11 +731,12 @@ It is also possible to define the name of the parts in which the test is divided \subsection{The \texttt{totale-versioni} file}\label{sec:totale} The file \texttt{totale-versioni} is used to generate all the variants of an exercise. With this file the package has always the option \optname{prova} and you can use the option \optname{param} to generate the parametric version of exercises. -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. +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.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. \end{description} \bibliographystyle{plain} diff --git a/Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.dtx b/Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.dtx deleted file mode 100644 index 53f0ad10dae..00000000000 --- a/Master/texmf-dist/doc/latex/esami/doc/esami-doc-it.dtx +++ /dev/null @@ -1,827 +0,0 @@ -%\documentclass[10pt]{article} - -%\iffalse This is a METACOMMENT -% -%<*driver> -%\ProvidesFile{esami.dtx} -\documentclass{ltxdoc} -%\usepackage[colorlinks,hyperindex]{hyperref} -%\usepackage{esami} -\usepackage[braces]{colordoc} -\usepackage[T1]{fontenc} -\usepackage{calc} -%\usepackage{textcomp} -\usepackage{lmodern} -\usepackage{comandi} -\usepackage[utf8]{inputenc} -\usepackage[italian]{babel} -\usepackage{graphicx} -\usepackage[dvipsnames,svgnames]{xcolor} -\usepackage{fancyvrb} -\usepackage[lmargin=3.5cm,rmargin=3.5cm]{geometry} -\usepackage[colorlinks=true,pdftex,hyperindex=true]{hyperref} -\newcounter{esempio} -\newsavebox{\fcolbox} %\newlength{\fcolwidth} -\newenvironment{esempio} -{\par \medskip -\begin{example} - } - {\end{example}\medskip} - -\newenvironment{example} -{\noindent\stepcounter{esempio}%\setlength{\fcolwidth}{\textwidth-2\fboxsep-2\fboxrule}% -\begin{lrbox}{\fcolbox}% -\begin{minipage}[c]{\textwidth-2\fboxsep-2\fboxrule} -\textbf{\textsf{Esempio \theesempio.}} -} -{\end{minipage}\end{lrbox}\fbox{\usebox{\fcolbox}}} - - -\EnableCrossrefs -\CodelineIndex -\PageIndex -\RecordChanges -\OnlyDescription -\CheckSum{345} -\begin{document} -%\GetFileInfo{esami.sty} -% \DocInput{esami.dtx} - %\PrintChanges - %\PrintIndex - -%</driver> -%\fi -% -% \CharacterTable -% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z -% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z -% Digits \0\1\2\3\4\5\6\7\8\9 -% Exclamation \! Double quote \" Hash (number) \# -% Dollar \$ Percent \% Ampersand \& -% Acute accent \' Left paren \( Right paren \) -% Asterisk \* Plus \+ Comma \, -% Minus \- Point \. Solidus \/ -% Colon \: Semicolon \; Less than \< -% Equals \= Greater than \> Question mark \? -% Commercial at \@ Left bracket \[ Backslash \\ -% Right bracket \] Circumflex \^ Underscore \_ -% Grave accent \` Left brace \{ Vertical bar \| -% Right brace \} Tilde \~} -% - -\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 \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}).} - -%\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} -\GetFileInfo{esami.sty} -\def\fileversion{versione 1.1} -\def\filedate{2013/12/09} - - - \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 - - \tableofcontents - \newpage -\newcommand*\pkgname[1]{\texttt{#1}} -\newcommand*\clsname[1]{\texttt{#1}} -\newcommand*\optname[1]{\emph{#1}} -\newcommand*\envname[1]{\textsf{#1}} - -%\section{Il pacchetto esami} -\section{Introduzione e motivazioni} -Il pacchetto \texttt{esami} è stato creato per produrre i testi e le soluzioni per gli esami di Matematica nella Facoltà di Economia dell'Università Cattolica -di Milano e nasce dall'esigenza di poter generare molte versioni (da 12 a 50 solitamente) di una stessa prova d'esame contenenti esercizi simili, ma diversi e -di stampare le soluzioni e, se fossero presenti domande a risposta chiusa, la stringa delle soluzioni. - -Il pacchetto consente di scrivere esercizi di vario tipo (a risposta multipla con risposte che variano in ordine casuale, a risposta chiusa o aperta, -\emph{matching}, problemi, ecc.). Le domande di ogni gruppo ruotano in modo casuale all'interno del compito e le varianti di ciascun esercizio vengono scelte -in modo casuale da un file che le contiene tutte e, a nostra conoscenza, è l'unico che permetta di ottenere tali risultati senza utilizzare programmi esterni a -\LaTeX. - -Lo sviluppo del pacchetto è iniziato nel 2008 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: -\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{pstricks}, \pkgname{pstricks-add} e \pkgname{auto-pst-pdf}: per i grafici; -\item \pkgname{environ}: per trasformare comandi in ambienti. -\end{enumerate} -Inoltre i seguenti pacchetti sono opzionali, ma raccomandati: -\begin{enumerate} - \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}). -\end{enumerate} -Tutti i pacchetti sono disponibili sia in \TeX Live che in Mik\TeX. - -\section{Installazione} Il pacchetto è composto dal file {\tt esami.sty}, da alcuni file di configurazione {\tt *.cfg}, da 3 template per la compilazione e -dalla documentazione. Il file {\tt sty} e i file {\tt cfg} e {\tt lng} devono essere copiati in una cartella dove possano essere trovati da \LaTeX\ (ad esempio -{\tt texmf-local/tex/latex/esami} e in seguito deve essere aggiornato il database. - -\section{Come scrivere un esame} -In questa sezione si vedrà come costruire una prova d'esame usando il pacchetto \pkgname{esami}. - -\subsection{Il preambolo} -\begin{verbatim} -\documentclass[italian]{article} -\usepackage[<opzioni>]{esami} -\end{verbatim} -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 -\def\Data{\longdate}%%% or \shortdate: the date in the heading -\end{verbatim} -Il comando \cmd{\date} è quello solito di \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. -Il comando \cmd{\Data} stamperà la data in formato lungo (D MMMM YYYY \cmd{\longdate}) o corto (D/M/YYYY \cmd{\shortdate}). -\subsection{Il documento} -\begin{verbatim} -\begin{document} -\pagestyle{esame} -%% \immediate\openout\sols=\thenomefile.sol.tex -\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 si usa nel file delle soluzioni per generare il file che contiene la stringa delle soluzioni. -\begin{verbatim} - \whiledo{\thevers<\numcompiti}{\stepvers -\end{verbatim} -inizia la routine di compilazione delle varianti che terminerà alla fine del documento. -\begin{verbatim} -\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} -\begin{verbatim} -%%\immediate\write\sols{\string\begin{minipage}{.33\string\textwidth} - \string\large\string\textbf{Soluzione Versione n. \thevers}} -\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 l'istruzione commentata serve nel file soluzioni per la stringa delle soluzioni. -\begin{verbatim} -\begin{test}[punti] -\begin{questions} -\esercizi{test1,test2,test3,test4} -\end{questions} -\end{test} -%%\immediate\write\sols{\string\par\string\end\string{enumerate\string}\string\end{minipage} -%% \string\vspace{1.5cm}} -\end{verbatim} -In questo modo si definisce un ambiente per un test tipicamente con domande a risposta multipla, il comando \cmd{\esercizi} serve per scegliere casualmente gli -esercizi dai file indicati e per rimescolarli. Come sopra i comandi commentati servono per il file soluzioni per generare la stringa delle soluzioni. -\begin{verbatim} -\esercizi{problema1, problema2} -\end{verbatim} - sceglie tra due esercizi a risposta aperta. -\begin{verbatim} -\closevers -} -%%\immediate\closeout\sols -%%\stringasol -\end{document} -\end{verbatim} -Termina la routine di compilazione, e, nel file delle soluzioni, chiude il file della stringa delle risposte. - - -\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 predefiniti 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 (default). - \item {\color{blue}{\optname{solutions}}}: genera il file delle soluzioni. - \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 iniziale, 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}}}: da usare se nel compito ci sono esercizi di tipo \texttt{fillin}, per poter inserire le risposte corrette nella - stringa delle soluzioni. - \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: utile soprattutto se si usano le due colonne. - \item {\color{blue}{\optname{autopston}}} e {\color{blue}{\optname{autopstoff}}}: caricano il pacchetto \pkgname{auto-pst-pdf} e permettono di compilare - il file direttamente con 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} (\TeX Live) o \texttt{write18} (MiK\TeX) nell'esecuzione di pdflatex.}. -\item {\color{blue}{\optname{language}}}: legge il file di localizzazione es-language.lng (si veda \ref{sec:lngsec: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\{ .... \}} (che non ha alcun argomento opzionale). -\begin{esempio} -\begin{verbatim} -%%%% Questo è il file file1.tex con 2 varianti di un esercizio -\newproblem{ Testo della prima variante} -\newproblem{Testo della seconda variante} -\end{verbatim} -\end{esempio} -Il comando \cmd{\newproblem} è una versione molto modificata dell'analogo comando del pacchetto \pkgname{probsoln}. -\subsection{L'ambiente test} -\DescribeEnv{test} -L'ambiente \envname{test} consente di scrivere esercizi a risposta multipla o a risposta aperta breve, in cui ciascuno dei quesiti è tratto casualmente da uno -dei file nel quale sono contenuti tutti gli esercizi con le rispettive varianti. - -L'ambiente viene creato dal comando -\begin{verbatim} - \begin{test}[punti] - ... - \end{test} -\end{verbatim} -\DescribeMacro{punti} -Il parametro opzionale \oarg{punti} può essere solo un numero intero maggiore o uguale a 1, che indica il punteggio \textbf{totale} attribuito all'intero -gruppo di domande. - -\DescribeEnv{questions} -I quesiti del gruppo, nel documento principale, sono racchiusi nell'ambiente \emph{questions} che è una versione modificata dell'ambiente omonimo del pacchetto -\pkgname{exerquiz}: -\begin{verbatim} - \begin{questions} - .... - \end{questions} -\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{test} - \begin{questions} - .... - \end{questions} -.... - \begin{questions} - .... - \end{questions} -\end{test} -\end{verbatim} -\end{esempio} -\DescribeMacro{\esercizi} -All'interno di tale ambiente, i quesiti vengono ``caricati'' dal comando -\begin{verbatim} - \esercizi{nome file sorgente 1, nome file sorgente 2,...} -\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 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 -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}. -\begin{esempio} -\begin{verbatim} - \begin{test}[punti] - \begin{multicols}{2} - \esercizi{es1,es2,es3} - \end{multicols} - \esercizi{es4,es5,es6} - \end{test} -\end{verbatim} -\end{esempio} -In questo modo gli esercizi \texttt{es1,es2,es3} sono formattati su due colonne mentre gli esercizi \texttt{es4,es5,es6} sono formattati su una colonna. - -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} - \bChoices[random] -\Ans0 risposta errata \eAns -\Ans0 risposta errata \eAns -\Ans1 risposta esatta \eAns - \eFreeze -\Ans0 nessuna delle precedenti \eAns - \eChoices -\end{answers} - \end{verbatim} -nella quale: -\begin{itemize} - \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). - -\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 -\item {\color{blue}{\cmd{\eFreeze}}} introduce (se si vuole) una o più risposte che non saranno in ordine casuale. -\end{itemize} -\begin{esempio} - \begin{verbatim} -\newproblem{ -\item \PTs{1} Le soluzioni dell'equazione -\[x^2-5x+6=0\] -sono: -\begin{answers}{2} - \bChoices[random] -\Ans0 $x=3$ e $x=-2$ \eAns -\Ans0 $x=-3$ e $x=-2$ \eAns -\Ans1 $x=3$ e $x=2$ \eAns - \eFreeze -\Ans0 nessuna delle precedenti \eAns - \eChoices -\end{answers} -} - -\newproblem{ -\item \PTs{1} Le soluzioni dell'equazione -\[x^2+5x+6=0\] -sono: -\begin{answers}{2} - \bChoices[random] -\Ans0 $x=3$ e $x=-2$ \eAns -\Ans1 $x=-3$ e $x=-2$ \eAns -\Ans0 $x=3$ e $x=2$ \eAns - \eFreeze -\Ans0 nessuna delle precedenti \eAns - \eChoices -\end{answers} -} - \end{verbatim} -\end{esempio} - -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. - -\subsection{Gli ambienti problem e problem*} -\DescribeEnv{problem} -\DescribeEnv{problem*} -Servono per scrivere problemi con risposte aperte. Si usano all'interno del file che contiene le varianti dell'esercizio, annidati nel comando -\cmd{\newproblem}, con la seguente sintassi: -\begin{verbatim} -\begin{problem} - ... -\end{problem} -\end{verbatim} -se si sceglie di scrivere un esercizio a risposta aperta in una sola parte; con la sintassi -\begin{verbatim} -\begin{problem*} - ... -\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}. -\begin{verbatim} -\begin{problem} [punteggio] -........Testo.......... -\begin{solution}[spazio_soluzione] -.... testo soluzione ...... -\end{solution} -\end{problem} - \end{verbatim} - \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{problem*} [punteggio] -....testo.... -\begin{parts} -\item \PTs{punteggio della parte} -....testo.... - \begin{solution}[spazio_soluzione] - .... 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. -\subsection{Altre tipologie di esercizi}\label{sec:altri_esercizi} -Sono state definite alcune nuove tipologie di esercizio: -\paragraph{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}. - -La sintassi è -\begin{verbatim} - \fillin[u|e|b]{larghezza dello spazio}{risposta} -\end{verbatim} -I due parametri obbligatori sono la \marg{larghezza dello spazio} da lasciare, che deve essere espressa con una lunghezza (cm, pt, ecc.) e la \marg{risposta} -esatta (parola o numero) che lo studente dovrebbe inserire (che verrà stampata solo nel file delle soluzioni). - -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}). -\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. -\paragraph{risposta:}\DescribeEnv{risposta} serve per creare, in esercizi a risposta aperta lunga, lo spazio per inserire la risposta in un box o su righe. - -La sintassi del comando è -\begin{verbatim} - \begin{risposta}{b|l}{spazio verticale} - \end{risposta} -\end{verbatim} -Il primo parametro definisce se lo spazio per la risposta deve essere riquadrato (opzione \emph{b}, di default) oppure diviso in righe su cui andrà scritta la -risposta (opzione \emph{l}). Il secondo parametro definisce invece l'altezza dello spazio per la risposta (in cm se con opzione \emph{b}, in numero di righe se -con opzione \emph{l}) \paragraph{matching:}\DescribeMacro{\matching} è basato su un'idea del pacchetto \pkgname{examdesign} \cite{examdesign}. Serve per creare -esercizi in cui le parole o formule contenute su due colonne vanno abbinate dallo studente in modo corretto. - -\DescribeMacro{\pair}Le coppie vengono definite dal comando \cmd{\pair}: -\begin{verbatim} - \pair{nome 1}{nome 2} -\end{verbatim} -che va inserito tante volte quanti sono i nomi o le formule da abbinare. - -L'elenco dei nomi (mischiati in ordine casuale su ciascuna colonna) viene visualizzato con il comando \cmd{\matching}. - -\begin{esempio} - -\begin{minipage}{.4\textwidth} -\begin{verbatim} - \pair{Regno Unito}{Londra} - \pair{Francia}{Parigi} - \pair{Italia}{Roma} - \pair{Germania}{Berlino} - \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{esempio} -Nelle soluzioni viene invece visualizzato l'abbinamento corretto. -\paragraph{tabella:}\DescribeEnv{tabella} serve per creare esercizi con più risposte aperte incolonnate. - -La sintassi è -\begin{verbatim} - \begin{tabella}[numero colonne sempre visibili] - {allineamento colonne visibili}{allineamento colonna nascosta} - \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. - -\begin{esempio} -Con il codice -\begin{verbatim} -\begin{center} -\renewcommand\arraystretch{3} -\begin{tabella}[1]{r}{c} -\hline - Il dominio della funzione è & $D_f=(-\infty;2]$\cr - \hline - L'insieme immagine della funzione è & $Im(f)=(-\infty,0]$ \cr - \hline - \end{tabella} -\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} - -\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 è -\begin{verbatim} -\begin{solution}{lunghezza} - \begin{workarea}[larghezza]{lunghezza} - \end{workarea} - \end{solution} -\end{verbatim} -La lunghezza dello spazio soluzione e della workarea dovrebbero essere uguali caso contrario il testo presente nella workarea -viene posizionato male nello spazio della soluzione, sovrapponendosi al testo dell’esercizio -se la sua lunghezza è maggiore di quella della soluzione. La larghezza della workarea è opzionale e di default è uguale alla larghezza del testo. A differenza -dell’ambiente \envname{solution}, nella workarea è possibile inserire testo, grafici, ecc.; ad esempio, è possibile inserire degli assi -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} -%\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). - -Questi comandi si basano sul pacchetto \pkgname{fp} \cite{fp}, che permette di eseguire calcoli anche molto complessi all'interno di un documento \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. -\begin{esempio} -\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} -\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}). -\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) 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}\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}. -\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} - \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 $-$. -\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 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}. - \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. - -Il primo comando permette di scegliere casualmente $n-m$ elementi di una lista -\DescribeMacro{\estrai}.\ Il comando \cmd{\estrai}\oarg{m}\marg{lista}\marg{nome} è il comando utente per estrarre gli elementi -dalla lista \marg{lista} escludendone \oarg{m}. Gli elementi estratti avranno nome \cmd{\nomei}, \cmd{\nomeii}, \dots. -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}. -\end{esempio} -\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. -\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}. -\end{esempio} -\DescribeMacro{\estraies} \label{estraies} Il comando \cmd{\estraies}\oarg{m}\marg{lista}\marg{nome} 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}. - -\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), 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. -\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. - -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}). - -È anche possibile definire il nome delle parti in cui è diviso il tema d'esame. -\subsection{Il file \texttt{totale-versioni}}\label{sec:totale} -Il file \texttt{totale-versioni} serve per generare tutte le varianti di un esercizio. Con questo file il pacchetto ha sempre l'opzione \optname{prova} e può -essere definita l'opzione \optname{param} per generare la versione parametrica degli esercizi. - -Al suo interno si deve usare un solo comando, \cmd{\def \textbackslash esercizio\{nome\}\textbackslash}, che deve contenere il nome dell'esercizio da -compilare. Se si compila la versione parametrica, i parametri e i loro intervalli di variazione vengono indicati alla fine dell'esercizio. - - -\bibliographystyle{plain} -\bibliography{esami} - \end{document} 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 Binary files differindex f084556822a..413e11f8a84 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 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 73e151fa562..8e7fa8a648b 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 @@ -10,7 +10,7 @@ \usepackage[braces]{colordoc} \usepackage[T1]{fontenc} \usepackage{calc} -%\usepackage{textcomp} +\usepackage{hologo} \usepackage{lmodern} \usepackage{comandi} \usepackage[utf8]{inputenc} @@ -70,7 +70,8 @@ % \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 \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 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.} %\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}} @@ -80,8 +81,8 @@ \fontshape\updefault \footnotesize} \GetFileInfo{esami.sty} -\def\fileversion{versione 1.1} -\def\filedate{2013/12/09} +\def\fileversion{versione 2.0} +\def\filedate{2015/02/25} \title{Il pacchetto esami\thanks{Questo documento @@ -102,28 +103,29 @@ \section{Introduzione e motivazioni} Il pacchetto \texttt{esami} è stato creato per produrre i testi e le soluzioni per gli esami di Matematica nella Facoltà di Economia dell'Università Cattolica di Milano e nasce dall'esigenza di poter generare molte versioni (da 12 a 50 solitamente) di una stessa prova d'esame contenenti esercizi simili, ma diversi e di stampare le soluzioni e, se fossero presenti domande a risposta chiusa, la stringa delle soluzioni. -Il pacchetto consente di scrivere esercizi di vario tipo (a risposta multipla con risposte che variano in ordine casuale, a risposta chiusa o aperta, \emph{matching}, problemi, ecc.). Le domande di ogni gruppo ruotano in modo casuale all'interno del compito e le varianti di ciascun esercizio vengono scelte in modo casuale da un file che le contiene tutte e, a nostra conoscenza, è l'unico che permetta di ottenere tali risultati senza utilizzare programmi esterni a \LaTeX. +Il pacchetto consente di scrivere esercizi di vario tipo (a risposta multipla con risposte che variano in ordine casuale, a risposta chiusa o aperta, \emph{matching}, problemi, ecc.). Le domande di ogni gruppo ruotano in modo casuale all'interno del compito e le varianti di ciascun esercizio vengono scelte in modo casuale da un file che le contiene tutte e, a nostra conoscenza, è l'unico che permetta di ottenere tali risultati senza utilizzare programmi esterni a \hologo{LaTeX}. -Lo sviluppo del pacchetto è iniziato nel 2008 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}. +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: +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{pstricks}, \pkgname{pstricks-add} e \pkgname{auto-pst-pdf}: per i grafici; -\item \pkgname{environ}: per trasformare comandi in ambienti. +\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}). + \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 \TeX Live che in Mik\TeX. +Tutti i pacchetti sono disponibili sia in \Hologo{TeX} Live che in \Hologo{MiKTeX}. -\section{Installazione} Il pacchetto è composto dal file {\tt esami.sty}, da alcuni file di configurazione {\tt *.cfg}, da 3 template per la compilazione e dalla documentazione. Il file {\tt sty} e i file {\tt cfg} e {\tt lng} devono essere copiati in una cartella dove possano essere trovati da \LaTeX\ (ad esempio {\tt texmf-local/tex/latex/esami} e in seguito deve essere aggiornato il database. +\section{Installazione} Il pacchetto è composto dal file {\tt esami.sty}, da alcuni file di configurazione {\tt *.cfg}, dai file di localizzazione, da 3 template per la compilazione e dalla documentazione. Il file {\tt sty} e i file {\tt cfg} e {\tt lng} devono essere copiati in una cartella dove possano essere trovati da \Hologo{LaTeX} (ad esempio {\tt texmf-local/tex/latex/esami} e in seguito deve essere aggiornato il database. \section{Come scrivere un esame} In questa sezione si vedrà come costruire una prova d'esame usando il pacchetto \pkgname{esami}. @@ -139,15 +141,16 @@ Le opzioni sono discusse nella sezione \ref{sec:opzioni} \date{2013/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 \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. +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. Il comando \cmd{\Data} stamperà la data in formato lungo (D MMMM YYYY \cmd{\longdate}) o corto (D/M/YYYY \cmd{\shortdate}). \subsection{Il documento} \begin{verbatim} \begin{document} \pagestyle{esame} -%% \immediate\openout\sols=\thenomefile.sol.tex +%\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 si usa nel file delle soluzioni per generare il file che contiene la stringa delle soluzioni. + 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} @@ -158,22 +161,23 @@ inizia la routine di compilazione delle varianti che terminerà alla fine del do \end{verbatim} genera il seme per i processi di randomizzazione e lo assegna anche a \cmd{\randomi} \begin{verbatim} -%%\immediate\write\sols{\string\begin{minipage}{.33\string\textwidth} - \string\large\string\textbf{Soluzione Versione n. \thevers}} +\permuta \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 l'istruzione commentata serve nel file soluzioni per la stringa delle soluzioni. + \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} \esercizi{test1,test2,test3,test4} +\begin{esdb}{dbone} +\selectrandomlyn{2}{dbtest1} +\selectrandomlyn{4}{dbtest2} +\end{esdb} \end{questions} \end{test} -%%\immediate\write\sols{\string\par\string\end\string{enumerate\string}\string\end{minipage} -%% \string\vspace{1.5cm}} \end{verbatim} -In questo modo si definisce un ambiente per un test tipicamente con domande a risposta multipla, il comando \cmd{\esercizi} serve per scegliere casualmente gli esercizi dai file indicati e per rimescolarli. Come sopra i comandi commentati servono per il file soluzioni per generare la stringa delle soluzioni. +In questo modo si definisce un ambiente per un test tipicamente con domande a risposta multipla, il comando \cmd{\esercizi} serve per scegliere casualmente gli esercizi dai file indicati e per rimescolarli, l'ambiente \envname{esdb} serve a definire un database (virtuale) di esercizi in cui vengono inseriti con il comando \cmd{\selectrandomlyn}. \begin{verbatim} \esercizi{problema1, problema2} \end{verbatim} @@ -181,11 +185,10 @@ In questo modo si definisce un ambiente per un test tipicamente con domande a ri \begin{verbatim} \closevers } -%%\immediate\closeout\sols -%%\stringasol +%%\def\stringasol{} \end{document} \end{verbatim} -Termina la routine di compilazione, e, nel file delle soluzioni, chiude il file della stringa delle risposte. +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} \section{Le opzioni del pacchetto}\label{sec:opzioni} @@ -194,20 +197,22 @@ Per usare il pacchetto bisogna usare il solito comando \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 predefiniti 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{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 (default). + \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 iniziale, 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{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}}}: da usare se nel compito ci sono esercizi di tipo \texttt{fillin}, per poter inserire le risposte corrette nella stringa delle soluzioni. + \item {\color{blue}{\optname{fillb}}}: non più usata, resta per compatibilità con le versioni precedenti.\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: utile soprattutto se si usano le due colonne. - \item {\color{blue}{\optname{autopston}}} e {\color{blue}{\optname{autopstoff}}}: caricano il pacchetto \pkgname{auto-pst-pdf} e permettono di compilare il file direttamente con 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 + \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} (\TeX Live) o \texttt{write18} (MiK\TeX) nell'esecuzione di pdflatex.}. -\item {\color{blue}{\optname{language}}}: legge il file di localizzazione es-language.lng (si veda \ref{sec:lngsec: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}. +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} @@ -219,11 +224,18 @@ Ogni variante è racchiusa nel comando \begin{esempio} \begin{verbatim} %%%% Questo è il file file1.tex con 2 varianti di un esercizio -\newproblem{ Testo della prima variante} +\newproblem{Testo della prima variante} \newproblem{Testo della seconda variante} \end{verbatim} \end{esempio} -Il comando \cmd{\newproblem} è una versione molto modificata dell'analogo comando del pacchetto \pkgname{probsoln}. +Il comando \cmd{\newproblem} è una versione molto modificata dell'analogo comando del pacchetto \pkgname{probsoln}.\\[2mm] +\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} +} \subsection{L'ambiente test} \DescribeEnv{test} L'ambiente \envname{test} consente di scrivere esercizi a risposta multipla o a risposta aperta breve, in cui ciascuno dei quesiti è tratto casualmente da uno dei file nel quale sono contenuti tutti gli esercizi con le rispettive varianti. @@ -235,7 +247,7 @@ L'ambiente viene creato dal comando \end{test} \end{verbatim} \DescribeMacro{punti} -Il parametro opzionale \oarg{punti} può essere solo un numero intero maggiore o uguale a 1, che indica il punteggio \textbf{totale} attribuito all'intero gruppo di domande. +Il parametro opzionale \oarg{punti} indica il punteggio \textbf{totale} attribuito all'intero gruppo di domande. \DescribeEnv{questions} I quesiti del gruppo, nel documento principale, sono racchiusi nell'ambiente \emph{questions} che è una versione modificata dell'ambiente omonimo del pacchetto \pkgname{exerquiz}: @@ -259,13 +271,13 @@ I quesiti del gruppo, nel documento principale, sono racchiusi nell'ambiente \em \end{verbatim} \end{esempio} \DescribeMacro{\esercizi} -All'interno di tale ambiente, i quesiti vengono ``caricati'' dal comando +All'interno di tale ambiente, i quesiti vengono ``caricati'' in due modi: o con l'ambiente \envname{esdb} che verrà descritto successivamente, o con il comando \begin{verbatim} \esercizi{nome file sorgente 1, nome file sorgente 2,...} \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 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} (si veda \ref{estraies}).\label{duecolonne} @@ -285,6 +297,15 @@ si deve introdurre la parte che deve essere su due colonne con \end{esempio} In questo modo gli esercizi \texttt{es1,es2,es3} sono formattati su due colonne mentre gli esercizi \texttt{es4,es5,es6} sono formattati su una colonna. +\DescribeEnv{esdb} +\DescribeMacro{selectrandomlyn} + +L'ambiente \envname{esdb}\marg{nome db} definisce un database virtuale di esercizi di nome \emph{nome db} (il nome del database \textbf{deve} essere diverso dal nome di ogni altro file di esercizi, di ogni altro database e del file master, poiché è il nome di un file che viene scritto in fase di compilazione). All'interno di tale ambiente possono essere scelti uno o più esercizi da uno o più file con i comandi \cmd{\selectrandomlyn}\marg{numero esercizi}\marg{nome file}, dove \emph{nome file} indica il file da cui estrarre gli esercizi e \emph{numero esercizi} indica quanti esercizi devono essere estratti (se il numero di esercizi è ``all'' oppure è maggiore del numero di varianti presenti nel file vengono scelti tutti gli esercizi)\nuovo{vers. 2.0}. + +L'ambiente genera un file \texttt{nome db.tex} che contiene i riferimenti agli esercizi scelti. Alla chiusura dell'ambiente gli esercizi vengono mandati automaticamente in output mediante il comando \cmd{\esercizidb}\marg{nome db} (da non dare esplicitamente). Ovviamente se si usano più ambienti \envname{esdb} ad ognuno deve essere assegnato un nome diverso. + +Anche questo ambiente è una versione modificata di un analogo ambiente presente nel pacchetto \pkgname{probsoln} e, al momento non funziona né con \hologo{XeLaTeX} né con \hologo{LuaLaTeX}. + Nel file degli esercizi, la sintassi da usare all'interno di \cmd{\newproblem} è la seguente: \begin{verbatim} \item \PTs{punteggio} @@ -297,6 +318,9 @@ Nel file degli esercizi, la sintassi da usare all'interno di \Ans0 nessuna delle precedenti \eAns \eChoices \end{answers} +\begin{solution} +Soluzione +\end{solution} \end{verbatim} nella quale: \begin{itemize} @@ -322,9 +346,13 @@ introduce una domanda con punteggio indicato in \cmd{\PTs} (può essere anche un 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 +\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} \newproblem{ @@ -340,6 +368,10 @@ sono: \Ans0 nessuna delle precedenti \eAns \eChoices \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}$. +\end{solution} } \newproblem{ @@ -411,6 +443,7 @@ Sono state definite alcune nuove tipologie di esercizio: \paragraph{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} La sintassi è \begin{verbatim} \fillin[u|e|b]{larghezza dello spazio}{risposta} @@ -420,6 +453,8 @@ 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}). + +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. \paragraph{risposta:}\DescribeEnv{risposta} serve per creare, in esercizi a risposta aperta lunga, lo spazio per inserire la risposta in un box o su righe. @@ -463,6 +498,8 @@ L'elenco dei nomi (mischiati in ordine casuale su ciascuna colonna) viene visual \end{minipage} \end{esempio} Nelle soluzioni viene invece visualizzato l'abbinamento corretto. + +Anche questo esercizio non funziona né con \Hologo{XeLaTeX} né con \Hologo{LuaLaTeX}. \paragraph{tabella:}\DescribeEnv{tabella} serve per creare esercizi con più risposte aperte incolonnate. La sintassi è @@ -474,6 +511,7 @@ La sintassi è \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. +Questo tipo di esercizio funziona con \Hologo{XeLaTeX}, ma non con \Hologo{LuaLaTeX}. \begin{esempio} Con il codice \begin{verbatim} @@ -511,7 +549,7 @@ Con il codice \end{workarea} \end{solution} \end{verbatim} -La lunghezza dello spazio soluzione e della workarea dovrebbero essere uguali caso contrario il testo presente nella workarea +La lunghezza dello spazio soluzione e della workarea dovrebbero essere uguali, in caso contrario il testo presente nella workarea viene posizionato male nello spazio della soluzione, sovrapponendosi al testo dell’esercizio se la sua lunghezza è maggiore di quella della soluzione. La larghezza della workarea è opzionale e di default è uguale alla larghezza del testo. A differenza dell’ambiente \envname{solution}, nella workarea è possibile inserire testo, grafici, ecc.; ad esempio, è possibile inserire degli assi coordinati per disegnare un grafico. @@ -522,6 +560,7 @@ Il pacchetto definisce altri due comandi utilizzati nel file {\tt totale-version \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{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 @@ -536,8 +575,8 @@ Il pacchetto definisce altri due comandi utilizzati nel file {\tt totale-version \subsection{Comandi per lavorare con i parametri (casuali)} \label{sec:comandi} 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 \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}. +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. \begin{esempio} @@ -557,7 +596,7 @@ creano due variabili \cmd{\a} (che può assumere un valore casuale tra 2 e 10, e 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) o stampare l'operazione eseguita (se si sceglie l'opzione \optname{param} nel pacchetto esami). + \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} @@ -593,9 +632,8 @@ Le principali caratteristiche del comando \cmd{\FPsv} sono (negli esempi, $k=2$) \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}\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}. + \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} @@ -621,11 +659,12 @@ Se $k=1$: \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 $-$. + 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$: @@ -659,7 +698,7 @@ Se il parametro $k$ assume valore $2$: \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 errore e al blocco della compilazione, con il comando \cmd{\sempliz} viene scritto il risultato $0$. + \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}). @@ -678,7 +717,7 @@ Oltre al comando \cmd{\esercizi} già visto esistono altri comandi per la scelta Il primo comando permette di scegliere casualmente $n-m$ elementi di una lista \DescribeMacro{\estrai}.\ Il comando \cmd{\estrai}\oarg{m}\marg{lista}\marg{nome} è il comando utente per estrarre gli elementi -dalla lista \marg{lista} escludendone \oarg{m}. Gli elementi estratti avranno nome \cmd{\nomei}, \cmd{\nomeii}, \dots. +dalla lista \marg{lista} escludendone \emph{m}. Gli elementi estratti avranno nome \cmd{\nomei}, \cmd{\nomeii}, \dots. Gli elementi della lista devono essere separati da virgole. \begin{esempio} @@ -692,11 +731,11 @@ Gli elementi della lista devono essere separati da virgole. 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}\marg{nome} 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{\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}. \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), 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. + 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. \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}} @@ -715,8 +754,9 @@ 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 \texttt{environ} per eliminare alcuni errori nella compilazione con \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}). + \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. \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 6691945e3fe..84e7c0c155a 100644 --- a/Master/texmf-dist/doc/latex/esami/doc/esami.bib +++ b/Master/texmf-dist/doc/latex/esami/doc/esami.bib @@ -53,3 +53,12 @@ year = {2011} } +@ARTICLE{tug, + author = {Messineo, G. and Vassallo, S.}, + title = {The esami package for examinations}, + journal = {TUGboat}, + year = {2013}, + volume = {34}, + pages = {40-46}, + number = {1} +} 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 index c7ed8b63de9..a9c42402732 100644 --- a/Master/texmf-dist/doc/latex/esami/doc/examples/esami-xyz.cfg +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/esami-xyz.cfg @@ -14,6 +14,55 @@ %% 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 | diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/master-sol.tex b/Master/texmf-dist/doc/latex/esami/doc/examples/master-sol.tex deleted file mode 100644 index 4c25293999a..00000000000 --- a/Master/texmf-dist/doc/latex/esami/doc/examples/master-sol.tex +++ /dev/null @@ -1,70 +0,0 @@ -\documentclass[a4paper,UKenglish]{article} -\usepackage[shuffle,xyz,pointsonright,autopstoff,twocolumns,solutions]{esami}%%%%% TEMA -\usepackage{lmodern,textcomp} -\usepackage[utf8]{inputenc} -\usepackage[T1]{fontenc} - -% +=============================+ -% | DEFINITIONS | -% +=============================+ - -\def\examname{The name of the exam} -\def\numcompiti{6}%%% The number of the versions -\date{2013/3/22}%%% THE DATE IN THE FORMAT YYYY/MM/DD -\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% - -\begin{document} -\testversioni -\pagestyle{esame} -\whiledo{\thevers<\numcompiti}{\stepvers -% +=============================+ -% | THE SEED | -% +=============================+ - -\FPeval\seme{round((\thenomefile+(3*\thevers)):0)} -%%% OR SOME OTHER LIKE -%\FPeval\seme{round(\thenomefile*(\thevers)+1-trunc(\thenomefile*(\thevers)/(2^31-1):0)*(2^31-1):0)} -%\FPeval\seme{round(1+abs(\thenomefile/(\thevers)+sin(\thevers)*(\thevers)^(2)):0)} - -\randomi=\seme -\permuta -% +=============================+ -% | STUFF DEFINED IN CFG FILE | -% +=============================+ - -\testa%%% the heading -\istruzionii%%% some instructions - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - -\section*{Part One} -\begin{test}[8] -\begin{questions} -\proofingsymbol{$\blacktriangleright$}%%% or something else -\esercizi{ -test1, -test2, -test3, -test4, -test5-fillin} -\end{questions} -\begin{questions} -\esercizi{test11, -test12, -test13, -test14, -} -\end{questions} -\end{test} -\newpage - -\section*{Part two} -\istruzioniii%%% Some other instructons - -\esercizi{problem1,problem2-tabella} -\newpage -\esercizi{problem3-matching,problem4-fillin} -\closevers -} -\end{document} diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/master.tex b/Master/texmf-dist/doc/latex/esami/doc/examples/master.tex deleted file mode 100644 index 7a838e4ac2a..00000000000 --- a/Master/texmf-dist/doc/latex/esami/doc/examples/master.tex +++ /dev/null @@ -1,69 +0,0 @@ -\documentclass[UKenglish,a4paper]{article} -\usepackage[shuffle,xyz,pointsonright,autopston,twocolumns,solutions]{esami}%%%%% TEMA -\usepackage{lmodern,textcomp} -\usepackage{babel} - -% +=============================+ -% | DEFINITIONS | -% +=============================+ - -\def\examname{The name of the exam} -\def\numcompiti{6}%%% The number of versions -\date{2013/3/22}%%% THE DATE IN THE FORMAT AAAA/M/D -\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% - -\begin{document} -\testversioni -\pagestyle{esame} -\whiledo{\thevers<\numcompiti}{\stepvers -% +=============================+ -% | THE SEED | -% +=============================+ - -\FPeval\seme{round((\thenomefile+(3*\thevers)):0)} -%%% OR OTHER SUCH AS -%\FPeval\seme{round(\thenomefile*(\thevers)+1-trunc(\thenomefile*(\thevers)/(2^31-1):0)*(2^31-1):0)} -%\FPeval\seme{round(1+abs(\thenomefile/(\thevers)+sin(\thevers)*(\thevers)^(2)):0)} - -\randomi=\seme - -% +=============================+ -% | STUFF DEFINED IN CFG FILE | -% +=============================+ - -\testa%%% the heading -\istruzionii%%% some instructions - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - -\section*{Part One} -\begin{test}[8] -\begin{questions} -\proofingsymbol{$\blacktriangleright$}%%% or some other symbol -\esercizi{ -test1, -test2, -test3, -test4, -test5-fillin} -\end{questions} -\begin{questions} -\esercizi{test11, -test12, -test13, -test14, -} -\end{questions} -\end{test} -\newpage - -\section*{Part two} -\istruzioniii%%% Some other instructons - -\esercizi{problem1,problem2-tabella} -\newpage -\esercizi{problem3-matching,problem4-fillin} -\closevers -} -\end{document} diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/problem1.tex b/Master/texmf-dist/doc/latex/esami/doc/examples/problem1.tex index a584624325d..62327718cf5 100644 --- a/Master/texmf-dist/doc/latex/esami/doc/examples/problem1.tex +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/problem1.tex @@ -1,14 +1,4 @@ \newproblem{ -\begin{problem}[4]\estraialfa{3}{a,b,c,x,y,z}{element}List all the elements of the power set (set of subsets) of -\[\left\{\elementi, \; \elementii,\; \elementiii\right\}\] -\begin{solution} -\[\emptyset,\; \left\{\elementi\right\},\;\left\{\elementii\right\},\;\left\{\elementiii\right\},\; -\left\{\elementi,\elementii\right\},\;\left\{\elementi,\elementiii\right\},\;\left\{\elementii,\elementiii\right\},\;\left\{\elementi,\elementii,\elementiii\right\}\] -\end{solution} -\end{problem} -} - -\newproblem{ \begin{problem*}[4]\estraialfa{4}{a,b,c,x,y,z}{element}Let $A=\{\elementi,\elementii,\elementiii\}$ and $B=\{\elementi,\elementiii,\elementiv\}$. \begin{parts} \item \PTs{2} diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/problem2.tex b/Master/texmf-dist/doc/latex/esami/doc/examples/problem2.tex new file mode 100644 index 00000000000..35d816150a5 --- /dev/null +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/problem2.tex @@ -0,0 +1,32 @@ +\newproblem{ +\begin{problem}[4]\estraialfa{3}{a,b,c,x,y,z}{element}List all the elements of the power set (set of subsets) of +\[\left\{\elementi, \; \elementii,\; \elementiii\right\}\] +\begin{solution} +\[\emptyset,\; \left\{\elementi\right\},\;\left\{\elementii\right\},\;\left\{\elementiii\right\},\; +\left\{\elementi,\elementii\right\},\;\left\{\elementi,\elementiii\right\},\;\left\{\elementii,\elementiii\right\},\;\left\{\elementi,\elementii,\elementiii\right\}\] +\end{solution} +\end{problem} +} + +%\newproblem{ +%\begin{problem*}[4]\estraialfa{4}{a,b,c,x,y,z}{element}Let $A=\{\elementi,\elementii,\elementiii\}$ and $B=\{\elementi,\elementiii,\elementiv\}$. +%\begin{parts} +%\item \PTs{2} +%List (without repetition) the elements of the set $A\cup B$ +%\begin{solution}[3cm] +%\[A \cup B=\left\{\elementi,\elementii,\elementiii,\elementiv\right\}\] +%\end{solution} +%\begin{workarea}{3cm} +%$A \cup B=$ +%\end{workarea} +%\item \PTs{2} +%List (without repetition) the elements of the set $A\cap B$ +%\begin{solution}[3cm] +%\[A \cap B=\left\{\elementi,\elementiii\right\}\] +%\end{solution} +%\begin{workarea}{3cm} +%$A \cap B=$ +%\end{workarea} +%\end{parts} +%\end{problem*} +%} diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/test1.tex b/Master/texmf-dist/doc/latex/esami/doc/examples/test1.tex index 6a1704deed3..67e27893c10 100644 --- a/Master/texmf-dist/doc/latex/esami/doc/examples/test1.tex +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/test1.tex @@ -1,14 +1,15 @@ \newproblem{ \FPsetpar{a}{2}{5} -\item \PTs{1} exercise 1a +\item \PTs{1} exercise 1a $a=\a$ \begin{answers}{1}\bChoices[random] \Ans1 answer 1 correct\eAns \Ans0 answer 2 wrong\eAns \Ans0 answer 3 wrong\eAns \eChoices\end{answers}} + \newproblem{ \FPsetpar{a}{2}{5} -\item \PTs{1} exercise 1b +\item \PTs{1} exercise 1b $a=\a$ \begin{answers}{1}\bChoices[random] \Ans1 answer 1 correct\eAns \Ans0 answer 2 wrong\eAns diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/test14.tex b/Master/texmf-dist/doc/latex/esami/doc/examples/test14.tex index af009d1df08..354953a8504 100644 --- a/Master/texmf-dist/doc/latex/esami/doc/examples/test14.tex +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/test14.tex @@ -10,7 +10,10 @@ \Ans0 answer 3 wrong\eAns \Ans0 answer 4 wrong\eAns \Ans0 answer 5 wrong \eAns - \eChoices\end{answers}} + \eChoices\end{answers} + \begin{solution} + This is the solution $a=\a$, $b=\b$, $c=\c$ + \end{solution}} \newproblem{ \FPsetpar{a}{2}{5} @@ -24,7 +27,10 @@ \Ans0 answer 3 wrong\eAns \Ans0 answer 4 wrong\eAns \Ans0 answer 5 wrong \eAns - \eChoices\end{answers}} + \eChoices\end{answers}\begin{solution} + This is the solution $a=\a$, $b=\b$, $c=\c$ + \end{solution}} + \newproblem{ @@ -39,7 +45,10 @@ \Ans0 answer 3 wrong\eAns \Ans0 answer 4 wrong\eAns \Ans0 answer 5 wrong \eAns - \eChoices\end{answers}} + \eChoices\end{answers}\begin{solution} + This is the solution $a=\a$, $b=\b$, $c=\c$ + \end{solution}} + \newproblem{ @@ -54,7 +63,10 @@ \Ans0 answer 3 wrong\eAns \Ans0 answer 4 wrong\eAns \Ans0 answer 5 wrong \eAns - \eChoices\end{answers}} + \eChoices\end{answers}\begin{solution} + This is the solution $a=\a$, $b=\b$, $c=\c$ + \end{solution}} + \newproblem{ \FPsetpar{a}{2}{5} @@ -68,4 +80,7 @@ \Ans0 answer 3 wrong\eAns \Ans0 answer 4 wrong\eAns \Ans0 answer 5 wrong \eAns - \eChoices\end{answers}} + \eChoices\end{answers}\begin{solution} + This is the solution $a=\a$, $b=\b$, $c=\c$ + \end{solution}} + diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/test3.tex b/Master/texmf-dist/doc/latex/esami/doc/examples/test3.tex index d73607c29d9..f24db14b774 100644 --- a/Master/texmf-dist/doc/latex/esami/doc/examples/test3.tex +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/test3.tex @@ -10,7 +10,8 @@ \Ans0 answer 3 wrong\eAns \Ans0 answer 4 wrong\eAns \Ans0 answer 5 wrong \eAns - \eChoices\end{answers}} + \eChoices\end{answers} + \begin{solution}answer 1\end{solution}} \newproblem{ \FPsetpar{a}{2}{5} @@ -24,7 +25,8 @@ \Ans0 answer 3 wrong\eAns \Ans0 answer 4 wrong\eAns \Ans0 answer 5 wrong \eAns - \eChoices\end{answers}} + \eChoices\end{answers} + \begin{solution}answer 1\end{solution}} \newproblem{ @@ -39,7 +41,8 @@ \Ans0 answer 3 wrong\eAns \Ans0 answer 4 wrong\eAns \Ans0 answer 5 wrong \eAns - \eChoices\end{answers}} + \eChoices\end{answers} + \begin{solution}answer 1\end{solution}} \newproblem{ @@ -54,4 +57,5 @@ \Ans0 answer 3 wrong\eAns \Ans0 answer 4 wrong\eAns \Ans0 answer 5 wrong \eAns - \eChoices\end{answers}} + \eChoices\end{answers} + \begin{solution}answer 1\end{solution}} diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/test5-fillin.tex b/Master/texmf-dist/doc/latex/esami/doc/examples/test5-fillin.tex index 9b6afd0e1e7..14fcc410e45 100644 --- a/Master/texmf-dist/doc/latex/esami/doc/examples/test5-fillin.tex +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/test5-fillin.tex @@ -1,14 +1,19 @@ -\newproblem{ -\FPsetpar{a}{2}{5} -\FPsetpar{b}{3}{5} -%\FPsetpar{c}{\a}{8} -\item \PTs{1} - $a=\a$, $b=\b$%, $c=\c$ -Evaluate $\a+\b=$\fillin{1cm}{$\FPsv{a+b}$} +\newfillinproblem{ +\FPsetpar{a}{12}{15} +\FPsetpar{b}{13}{15} +\FPsetpar{c}{2}{4} +\FPsetpar{k}{4}{5} +\item \PTs{1} + $a=\a$, $b=\b$, $c=\c$, $k=\k$ + +Evaluate with two exact decimals + +$$ \b:\k= \fillin[b]{3cm}{ \FPsv[2]{b/k}}$$ } -\newproblem{ + +\newfillinproblem{ \FPsetpar{a}{12}{15} \FPsetpar{b}{13}{15} \FPsetpar{c}{2}{4} @@ -16,7 +21,6 @@ Evaluate $\a+\b=$\fillin{1cm}{$\FPsv{a+b}$} \item \PTs{1} $a=\a$, $b=\b$, $c=\c$, $k=\k$ -Evaluate with two exact decimals +Evaluate with two exact decimals -$ \b:\k$=\fillin[u]{1cm}{$\FPsv[2]{b/k}$} - } +$$ \a:\c= \fillin[b]{3cm}{ \FPsv[2]{a/c}}$$ }
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/test9.tex b/Master/texmf-dist/doc/latex/esami/doc/examples/test9.tex new file mode 100644 index 00000000000..0d19df40a3f --- /dev/null +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/test9.tex @@ -0,0 +1,57 @@ +\newproblem{ +\FPsetpar{a}{2}{5} +\FPsetpar{b}{2}{5} +\FPsetpar{c}{2}{8} + +\item \PTs{2} exercise 9a $a=\a$, $b=\b$, $c=\c$ + \begin{answers}{1}\bChoices[random] + \Ans1 answer 1 correct\eAns + \Ans0 answer 2 wrong\eAns + \Ans0 answer 3 wrong\eAns + \Ans0 answer 4 wrong\eAns + \Ans0 answer 5 wrong \eAns + \eChoices\end{answers}} + +\newproblem{ +\FPsetpar{a}{2}{5} +\FPsetpar{b}{2}{5} +\FPsetpar{c}{2}{8} + +\item \PTs{2} exercise 9b $a=\a$, $b=\b$, $c=\c$ + \begin{answers}{1}\bChoices[random] + \Ans1 answer 1 correct\eAns + \Ans0 answer 2 wrong\eAns + \Ans0 answer 3 wrong\eAns + \Ans0 answer 4 wrong\eAns + \Ans0 answer 5 wrong \eAns + \eChoices\end{answers}} + + +\newproblem{ +\FPsetpar{a}{2}{5} +\FPsetpar{b}{2}{5} +\FPsetpar{c}{2}{8} + +\item \PTs{2} exercise 9c $a=\a$, $b=\b$, $c=\c$ + \begin{answers}{1}\bChoices[random] + \Ans1 answer 1 correct\eAns + \Ans0 answer 2 wrong\eAns + \Ans0 answer 3 wrong\eAns + \Ans0 answer 4 wrong\eAns + \Ans0 answer 5 wrong \eAns + \eChoices\end{answers}} + + +\newproblem{ +\FPsetpar{a}{2}{5} +\FPsetpar{b}{2}{5} +\FPsetpar{c}{2}{8} + +\item \PTs{2} exercise 9d $a=\a$, $b=\b$, $c=\c$ + \begin{answers}{1}\bChoices[random] + \Ans1 answer 1 correct\eAns + \Ans0 answer 2 wrong\eAns + \Ans0 answer 3 wrong\eAns + \Ans0 answer 4 wrong\eAns + \Ans0 answer 5 wrong \eAns + \eChoices\end{answers}} diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/testA-luatex-sol.pdf b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-luatex-sol.pdf Binary files differnew file mode 100644 index 00000000000..74b27a13434 --- /dev/null +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-luatex-sol.pdf diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/testA-luatex.pdf b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-luatex.pdf Binary files differnew file mode 100644 index 00000000000..73b4e342a43 --- /dev/null +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-luatex.pdf 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 new file mode 100644 index 00000000000..677a7771f5e --- /dev/null +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.loe @@ -0,0 +1,180 @@ +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 Binary files differindex ebe91fad1f5..6f97b2b68dc 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 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 new file mode 100644 index 00000000000..5ac5a3bef05 --- /dev/null +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-sol.tex @@ -0,0 +1,115 @@ +\documentclass[a4paper,english]{article} + +\usepackage[shuffle,xyz,pointsonright,solutions,quizsolutions,twocolumns]{esami}%%%%% TEMA +\ifluatex + \usepackage{luatextra} % also loads fixltx2e, fontspec, xunicode + \usepackage{unicode-math} + \setmathfont{Latin Modern Math} + \usepackage[utf8]{luainputenc} +\else\ifxetex + \usepackage{fixltx2e} + \usepackage{fontspec} + \usepackage{unicode-math} + \XeTeXinputencoding utf8 +\else + \usepackage{fixltx2e} + \usepackage[T1]{fontenc} + \usepackage[utf8]{inputenc} + \usepackage{lmodern,textcomp} +\fi\fi + +% +=============================+ +% | 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 +\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} +\begin{document} +\testversioni +\pagestyle{esame} + +\whiledo{\thevers<\numcompiti}{\stepvers +% +=============================+ +% | THE SEED | +% +=============================+ + +\FPeval\seme{round((\thenomefile+(3*\thevers)):0)} +%%% OR SOME OTHER LIKE +%\FPeval\seme{round(\thenomefile*(\thevers)+1-trunc(\thenomefile*(\thevers)/(2^31-1):0)*(2^31-1):0)} +%\FPeval\seme{round(1+abs(\thenomefile/(\thevers)+sin(\thevers)*(\thevers)^(2)):0)} + +\randomi=\seme + +\permuta +% +=============================+ +% | STUFF DEFINED IN CFG FILE | +% +=============================+ + +\testa%%% the heading +\istruzionii%%% some instructions + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\section*{Part One} + + +\begin{test}[8] +\begin{questions} +\ifluatex +\esercizi{ +test14, +test1, +test4, +test9 +} +\else\ifxetex +\esercizi{ +test14, +test1, +test4, +test9 +} +\else +\begin{esdb}{mydb} %% some exercises from 2 files + \selectrandomlyn{3}{test2} + \selectrandomlyn{2}{test3} + \end{esdb} + +\esercizi{ +test14, +test1, +test4, +test9, +test5-fillin +} +%%% all the problems of a file +\selectallproblems[random]{test11} +\fi\fi + +\end{questions} + +Some other questions\\[5mm] + + +\begin{questions} %% a new set of questions +\esercizi{test12, +test13 +} +\end{questions} +\end{test} + +\section*{Part two} +\istruzioniii%%% Some other instructions + +\esercizi{problem1} +\closevers +\newpage % + % +\setcounter{page}{1} %%% dvi +} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/testA-xetex-sol.pdf b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-xetex-sol.pdf Binary files differnew file mode 100644 index 00000000000..fc64643065f --- /dev/null +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-xetex-sol.pdf diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/testA-xetex.pdf b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-xetex.pdf Binary files differnew file mode 100644 index 00000000000..30aad4bfd9a --- /dev/null +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/testA-xetex.pdf diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/testA.pdf b/Master/texmf-dist/doc/latex/esami/doc/examples/testA.pdf Binary files differindex 273b37c8cb5..a37b9f7cc3d 100644 --- a/Master/texmf-dist/doc/latex/esami/doc/examples/testA.pdf +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/testA.pdf 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 10518d63d81..ca2029d88ae 100644 --- a/Master/texmf-dist/doc/latex/esami/doc/examples/testA.tex +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/testA.tex @@ -1,21 +1,37 @@ -\documentclass[a4paper,UKenglish]{article} -\usepackage[shufflerandom,xyz,pointsonright,autopstoff,twocolumns,nosolutions]{esami}%%%%% TEMA -\usepackage{lmodern,textcomp} -\usepackage[utf8]{inputenc} -\usepackage[T1]{fontenc} +\documentclass[a4paper,english]{article} + +\usepackage[shuffle,xyz,pointsonright,nosolutions,noquizsolutions,twocolumns]{esami}%%%%% TEMA +\ifluatex + \usepackage{luatextra} % also loads fixltx2e, fontspec, xunicode + \usepackage{unicode-math} + \setmathfont{Latin Modern Math} + \usepackage[utf8]{luainputenc} +\else\ifxetex + \usepackage{fixltx2e} + \usepackage{fontspec} + \usepackage{unicode-math} + \XeTeXinputencoding utf8 +\else + \usepackage{fixltx2e} + \usepackage[T1]{fontenc} + \usepackage[utf8]{inputenc} + \usepackage{lmodern,textcomp} +\fi\fi + % +=============================+ % | DEFINITIONS | % +=============================+ \def\examname{The name of the exam} -\def\numcompiti{4}%%% The number of the versions -\date{2014/1/3}%%% THE DATE IN THE FORMAT AAAA/M/D +\def\numcompiti{10}%%% The number of the versions +\date{2014/07/22}%%% THE DATE IN THE FORMAT AAAA/M/D \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} \begin{document} \testversioni \pagestyle{esame} + \whiledo{\thevers<\numcompiti}{\stepvers % +=============================+ % | THE SEED | @@ -41,37 +57,59 @@ \section*{Part One} - \begin{test}[8] \begin{questions} -\proofingsymbol{$\blacktriangleright$}%%% or something else +\ifluatex +\esercizi{ +test14, +test1, +test4, +test9 +} +\else\ifxetex \esercizi{ +test14, test1, -test2, -test3, -test4} -%test5-fillin} -\end{questions} -\begin{questions} -\esercizi{test11, -test12, -test13, +test4, +test9 +} +\else +\begin{esdb}{mydb} %% some exercises from 2 files + \selectrandomlyn{3}{test2} + \selectrandomlyn{2}{test3} + \end{esdb} + +\esercizi{ test14, +test1, +test4, +test9, +test5-fillin } +%%% all the problems of a file +\selectallproblems[random]{test11} +\fi\fi + \end{questions} -\end{test} -\newpage +Some other questions\\[5mm] + + +\begin{questions} %% a new set of questions +\esercizi{test12, +test13 +} +\end{questions} +\end{test} \section*{Part two} -\istruzioniii%%% Some other instructons +\istruzioniii%%% Some other instructions -\esercizi{problem1,problem2-tabella,problem3-matching,problem4-fillin} -\newpage -%\esercizi{problem3-matching,problem4-fillin} +\esercizi{problem1} \closevers \newpage % % \setcounter{page}{1} %%% dvi } + \end{document} diff --git a/Master/texmf-dist/doc/latex/esami/doc/examples/totale-versioni.tex b/Master/texmf-dist/doc/latex/esami/doc/examples/totale-versioni.tex index b787932f616..18dcb22fcb5 100644 --- a/Master/texmf-dist/doc/latex/esami/doc/examples/totale-versioni.tex +++ b/Master/texmf-dist/doc/latex/esami/doc/examples/totale-versioni.tex @@ -1,6 +1,6 @@ \documentclass[UKenglish]{article} -\usepackage[xyz,prova,pointsonright,autopstoff,param]{esami}%%% numeric version -%%\usepackage[mg,prova,pointsonright,autopstoff,param]{esami}%%% parametric version +%%\usepackage[xyz,prova,pointsonright]{esami}%%% numeric version +\usepackage[xyz,prova,pointsonright,autopstoff,param]{esami}%%% parametric version \date{2013/4/8}%%% it's necessary for the random number generation, but can be any date \FPeval\seme{2010}%%% or what you like \randomi=\seme @@ -16,7 +16,7 @@ % | FOR TEST | % +=============================+ -\def\esercizio{test11} +\def\esercizio{test3} \makeatletter \ifes@param \begin{center} {\textbf{\esercizio -p}}\vspace{5mm}\end{center} diff --git a/Master/texmf-dist/doc/latex/esami/esami-xyz.cfg b/Master/texmf-dist/doc/latex/esami/esami-xyz.cfg index c7ed8b63de9..a9c42402732 100644 --- a/Master/texmf-dist/doc/latex/esami/esami-xyz.cfg +++ b/Master/texmf-dist/doc/latex/esami/esami-xyz.cfg @@ -14,6 +14,55 @@ %% 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 | diff --git a/Master/texmf-dist/tex/latex/esami/es-UKenglish.lng b/Master/texmf-dist/tex/latex/esami/es-UKenglish.lng index 4ff77e3ecb5..9b459da0bac 100644 --- a/Master/texmf-dist/tex/latex/esami/es-UKenglish.lng +++ b/Master/texmf-dist/tex/latex/esami/es-UKenglish.lng @@ -33,6 +33,8 @@ \def\es@fpsetparerrorshort{Not all conditions are satisfied after \maxLoopLimit\space tries} \def\es@EstraiMessage#1#2{\string\textbf\string{\string\noindent\space Expressions $#2i$, $#2ii$ \string\dots\space assume the values #1 \string}\string\newline} +\def\es@fpsetparerrshort#1{It's impossible to define the parameter #1} +\def\es@fpsetparerrlong#1{In the definition of the parameter #1 the lower bound is greater than upper bound} %%% The date diff --git a/Master/texmf-dist/tex/latex/esami/es-USenglish.lng b/Master/texmf-dist/tex/latex/esami/es-USenglish.lng index f66b0be2389..d0194ca57ac 100644 --- a/Master/texmf-dist/tex/latex/esami/es-USenglish.lng +++ b/Master/texmf-dist/tex/latex/esami/es-USenglish.lng @@ -33,7 +33,8 @@ \def\es@fpsetparerrorshort{Not all conditions are satisfied after \maxLoopLimit\space tries} \def\es@EstraiMessage#1#2{\string\textbf\string{\string\noindent\space Expressions $#2i$, $#2ii$ \string\dots\space assume the values #1 \string}\string\newline} - +\def\es@fpsetparerrshort#1{It's impossible to define the parameter #1} +\def\es@fpsetparerrlong#1{In the definition of the parameter #1 the lower bound is greater than upper bound} %%% The date diff --git a/Master/texmf-dist/tex/latex/esami/es-french.lng b/Master/texmf-dist/tex/latex/esami/es-french.lng index cd3ba18bc4e..0d575ce1e53 100644 --- a/Master/texmf-dist/tex/latex/esami/es-french.lng +++ b/Master/texmf-dist/tex/latex/esami/es-french.lng @@ -33,6 +33,8 @@ \def\es@fpsetparerrorshort{Les conditions ne sont pas satisfaites apr\`{e}s \maxLoopLimit\space tentatives} \def\es@EstraiMessage#1#2{\string\textbf\string{\string\noindent\space Les expressions $#2i$, $#2ii$ \string\dots\space prennent les valeurs #1 \string}\string\newline} +\def\es@fpsetparerrshort#1{Ce n'est pas possible de définir #1} +\def\es@fpsetparerrlong#1{Dans la definition de le paramètre #1 l'extreme inferieur est plus grand que l'extreme superior} %% The date diff --git a/Master/texmf-dist/tex/latex/esami/es-german.lng b/Master/texmf-dist/tex/latex/esami/es-german.lng index 92d46829705..7362e88e144 100644 --- a/Master/texmf-dist/tex/latex/esami/es-german.lng +++ b/Master/texmf-dist/tex/latex/esami/es-german.lng @@ -36,6 +36,8 @@ Drücken Sie "x" um zu beenden und bennen Sie die Datei um. } \def\es@fpsetparerrorshort{Nicht alle Bedingungen sind nach \maxLoopLimit\space versuchen befriedigt} \def\es@EstraiMessage#1#2{\string\textbf\string{\string\noindent\space Die Ausdrücke $#2i$, $#2ii$ \string\dots\space setzten den Wert #1 voraus\string}\string\newline} +\def\es@fpsetparerrshort#1{It's impossible to define the parameter #1} +\def\es@fpsetparerrlong#1{In the definition of the parameter #1 the lower bound is greater than upper bound} %%% The date diff --git a/Master/texmf-dist/tex/latex/esami/es-greek.lng b/Master/texmf-dist/tex/latex/esami/es-greek.lng index 97a2cda12a0..be730de4800 100644 --- a/Master/texmf-dist/tex/latex/esami/es-greek.lng +++ b/Master/texmf-dist/tex/latex/esami/es-greek.lng @@ -1,63 +1,65 @@ -%%% Greek translation by Sotiris Hasapis
-
-
-%%% Labels (esami.sty)
-
-\def\es@parametermessage#1#2#3{Ç ðáñÜìåôñïò $#1$ åßíáé ìåôáîý $#2$ êáé $#3$.}
-\def\es@seedmessage#1{The seed is equal to $#1$.}
-\def\es@pointname{âáèìüò}
-\def\es@pointsname{âáèìïß}
-\def\es@exercisename{¢óêçóç}
-\def\es@solutionname{Ëýóç}
-
-%%% Labels (xyz.cfg)
-
-\def\profname{ÊáèçãçôÞò \ }
-\def\studsignname{ÕðïãñáöÞ ÌáèçôÞ}
-\def\studlastname{Åðþíõìï}
-\def\studfirstname{¼íïìá}
-\def\studid{Áñ.Ôáõôüôçôáò}
-\def\versionname{Ýêäïóç}
-\def\pagename{Óåëßäá}
-\def\solutionsname{Ëýóåéò}
-
-%%% Error Messages
-
-\def\es@cfgerrormessageshort{Ç åðéëïãÞ \CurrentOption\space äåí õðÜñ÷åé}
-\def\es@cfgerrormessagelong{Ôï ðáêÝôï esami áðáéôåß ìßá ðáñÜìåôñï ãéá ôï áñ÷åßï äéáìüñöùóçò}
-\def\es@numcompitierror{Áðáéôåßôáé ï ðñïóäéïñéóìüò ôïõ ðëÞèïõò ôùí åêäüóåùí!}
-\def\es@mastererror{WARNING: YOU CANNOT COMPILE THE MASTER FILE:\MessageBreak
- PRESS 'x' TO EXIT AND RENAME THE FILE}
-\def\es@zerodenerror#1#2{The fraction #1/#2 in exercise \nome \space has the denominator equal to 0}
-\def\es@zeronumerrorshort#1#2{The fraction #1/#2 in exercise \nome \space is equal to 0}
-\def\es@zeronumerrorlong#1#2{If the fraction can be 0, you must use the "sempliz" command}
-\def\es@fraconewarn#1#2{The fraction #1/#2 in exercise \nome \space is equal to 1}
-\def\es@radicalerror{The radicand in exercise \nome \space is negative}
-\def\es@fpsetparerrorshort{Not all conditions are satisfied after \maxLoopLimit\space tries}
-\def\es@EstraiMessage#1#2{\string\textbf\string{\string\noindent\space Expressions $#2i$, $#2ii$ \string\dots\space
- assume the values #1 \string}\string\newline}
-
-%%% The date
-
-\def\es@longdate#1/#2/#3\@empty{\ifcase#3\or
- 1ç\or 2á\or 3ç\or 4ç\or 5ç\or
- 6ç\or 7ç\or 8ç\or 9ç\or 10ç\or
- 11ç\or 12ç\or 13ç\or 14ç\or 15ç\or
- 16ç\or 17ç\or 18ç\or 19ç\or 20ç\or
- 21ç\or 22ç\or 23ç\or 24ç\or 25ç\or
- 26ç\or 27ç\or 28ç\or 29ç\or 30ç\or
- 31ç\fi~\ifcase#2\or
- ÉáíïõÜñéïò\or ÖåâñïõÜñéïò\or ÌÜñôéïò\or Áðñßëéïò\or ÌÜúïò\or Éïýíéïò\or
- Éïýëéïò\or Áýãïõóôïò\or ÓåðôÝìâñéïò\or Ïêôþâñéïòr\or ÍïÝìâñéïò\or
- ÄåêÝìâñéïò\fi \space #1}
-\def\es@shortdate#1/#2/#3\@empty{#1/#2/#3}
-
-%%% Useful Language dependent packages
-
-\AtEndOfPackage{
-\usepackage{babel}
-\usepackage{geometry}
-\geometry{a4paper,lmargin=6mm,rmargin=18mm,tmargin=6mm,bmargin=18mm,marginparsep=2mm,footskip=1cm}
-%\usepackage{eurosym}
-\usepackage[np,autolanguage]{numprint}
-}
+%%% Greek translation by Sotiris Hasapis + + +%%% Labels (esami.sty) + +\def\es@parametermessage#1#2#3{Ç ðáñÜìåôñïò $#1$ åßíáé ìåôáîý $#2$ êáé $#3$.} +\def\es@seedmessage#1{The seed is equal to $#1$.} +\def\es@pointname{âáèìüò} +\def\es@pointsname{âáèìïß} +\def\es@exercisename{¢óêçóç} +\def\es@solutionname{Ëýóç} + +%%% Labels (xyz.cfg) + +\def\profname{ÊáèçãçôÞò \ } +\def\studsignname{ÕðïãñáöÞ ÌáèçôÞ} +\def\studlastname{Åðþíõìï} +\def\studfirstname{¼íïìá} +\def\studid{Áñ.Ôáõôüôçôáò} +\def\versionname{Ýêäïóç} +\def\pagename{Óåëßäá} +\def\solutionsname{Ëýóåéò} + +%%% Error Messages + +\def\es@cfgerrormessageshort{Ç åðéëïãÞ \CurrentOption\space äåí õðÜñ÷åé} +\def\es@cfgerrormessagelong{Ôï ðáêÝôï esami áðáéôåß ìßá ðáñÜìåôñï ãéá ôï áñ÷åßï äéáìüñöùóçò} +\def\es@numcompitierror{Áðáéôåßôáé ï ðñïóäéïñéóìüò ôïõ ðëÞèïõò ôùí åêäüóåùí!} +\def\es@mastererror{WARNING: YOU CANNOT COMPILE THE MASTER FILE:\MessageBreak + PRESS 'x' TO EXIT AND RENAME THE FILE} +\def\es@zerodenerror#1#2{The fraction #1/#2 in exercise \nome \space has the denominator equal to 0} +\def\es@zeronumerrorshort#1#2{The fraction #1/#2 in exercise \nome \space is equal to 0} +\def\es@zeronumerrorlong#1#2{If the fraction can be 0, you must use the "sempliz" command} +\def\es@fraconewarn#1#2{The fraction #1/#2 in exercise \nome \space is equal to 1} +\def\es@radicalerror{The radicand in exercise \nome \space is negative} +\def\es@fpsetparerrorshort{Not all conditions are satisfied after \maxLoopLimit\space tries} +\def\es@EstraiMessage#1#2{\string\textbf\string{\string\noindent\space Expressions $#2i$, $#2ii$ \string\dots\space + assume the values #1 \string}\string\newline} +\def\es@fpsetparerrshort#1{It's impossible to define the parameter #1} +\def\es@fpsetparerrlong#1{In the definition of the parameter #1 the lower bound is greater than upper bound} + +%%% The date + +\def\es@longdate#1/#2/#3\@empty{\ifcase#3\or + 1ç\or 2á\or 3ç\or 4ç\or 5ç\or + 6ç\or 7ç\or 8ç\or 9ç\or 10ç\or + 11ç\or 12ç\or 13ç\or 14ç\or 15ç\or + 16ç\or 17ç\or 18ç\or 19ç\or 20ç\or + 21ç\or 22ç\or 23ç\or 24ç\or 25ç\or + 26ç\or 27ç\or 28ç\or 29ç\or 30ç\or + 31ç\fi~\ifcase#2\or + ÉáíïõÜñéïò\or ÖåâñïõÜñéïò\or ÌÜñôéïò\or Áðñßëéïò\or ÌÜúïò\or Éïýíéïò\or + Éïýëéïò\or Áýãïõóôïò\or ÓåðôÝìâñéïò\or Ïêôþâñéïòr\or ÍïÝìâñéïò\or + ÄåêÝìâñéïò\fi \space #1} +\def\es@shortdate#1/#2/#3\@empty{#1/#2/#3} + +%%% Useful Language dependent packages + +\AtEndOfPackage{ +\usepackage{babel} +\usepackage{geometry} +\geometry{a4paper,lmargin=6mm,rmargin=18mm,tmargin=6mm,bmargin=18mm,marginparsep=2mm,footskip=1cm} +%\usepackage{eurosym} +\usepackage[np,autolanguage]{numprint} +} diff --git a/Master/texmf-dist/tex/latex/esami/es-italian.lng b/Master/texmf-dist/tex/latex/esami/es-italian.lng index 38037620658..4b485b95346 100644 --- a/Master/texmf-dist/tex/latex/esami/es-italian.lng +++ b/Master/texmf-dist/tex/latex/esami/es-italian.lng @@ -23,6 +23,7 @@ \def\es@cfgerrormessageshort{L'opzione \CurrentOption\space non esiste} \def\es@cfgerrormessagelong{Si deve specificare un'opzione per la configurazione nel pacchetto esami} \def\es@parametermessage#1#2#3{Il parametro $#1$ varia da $#2$ a $#3$.} +\def\es@parametermessagea#1#2{Il parametro $#1$ vale $#2$.} \def\es@seedmessage#1{Il seme vale $#1$.} \def\es@numcompitierror{Si deve specificare il numero delle versioni!} @@ -34,6 +35,8 @@ \def\es@fraconewarn#1#2{La frazione #1/#2 nell'esercizio \nome \space vale 1} \def\es@radicalerror{Il radicando nell'esercizio \nome \space è negativo} \def\es@fpsetparerrorshort{Non sono state soddisfatte tutte le condizioni dopo \maxLoopLimit\space tentativi} +\def\es@fpsetparerrshort#1{Non si può definire il parametro #1} +\def\es@fpsetparerrlong#1{Nella definizione del parametro #1 l'estremo inferiore è maggiore dell'estremo superiore} %%% The date @@ -51,10 +54,10 @@ \AtEndOfPackage{ \usepackage{babel} -\IntelligentComma +\NoIntelligentComma \usepackage{geometry} \geometry{a4paper,lmargin=6mm,rmargin=22mm,tmargin=10mm,bmargin=18mm,marginparsep=2mm,footskip=1cm} -%\usepackage{icomma} +\usepackage{icomma} \usepackage{eurosym} \usepackage[np,autolanguage]{numprint} \newcommand*\npstyleitalian{% @@ -65,4 +68,7 @@ \npthousandthpartsep{} } \npfourdigitnosep + \DeclareRobustCommand{\officialeuro}{% + \ifmmode\expandafter\text\fi + {\fontencoding{U}\fontfamily{eurosym}\selectfont e}}%euro in math } diff --git a/Master/texmf-dist/tex/latex/esami/es-serbian.lng b/Master/texmf-dist/tex/latex/esami/es-serbian.lng new file mode 100644 index 00000000000..2aed64dc0c3 --- /dev/null +++ b/Master/texmf-dist/tex/latex/esami/es-serbian.lng @@ -0,0 +1,62 @@ +%%% Serbian translation by Dusko Latas + +%%% Labels (esami.sty) + +\def\es@parametermessage#1#2#3{Parametar $#1$ je izmeÄ‘u $#2$ i $#3$.} +\def\es@seedmessage#1{Delilac je jednak $#1$.} +\def\es@pointname{poen} +\def\es@pointsname{poena} +\def\es@exercisename{Zadatak} +\def\es@solutionname{Re\v senje} + +%%% Labels (xyz.cfg) + +\def\profname{Prof.\ } +\def\studsignname{Potpis studenta} +\def\studlastname{Prezime} +\def\studfirstname{Ime} +\def\studid{Broj indeksa} +\def\versionname{Verzija} +\def\pagename{Strana} +\def\solutionsname{Re\v senja} + + +%%% Error Messages + +\def\es@cfgerrormessageshort{Opcija \CurrentOption\space ne postoji} +\def\es@cfgerrormessagelong{Paketu esami je potrebno podesiti konfiguracioni fajl} +\def\es@numcompitierror{Neophodno je navesti!} +\def\es@mastererror{UPOZORENjE: NE MOZETE DA KOMPAJLIRATE FAJL:\MessageBreak +PRITISNITE 'x' DA BISTE IZASLI ILI PREIMENUJTE FAJL} +\def\es@zerodenerror#1#2{Razlomak #1/#2 u zadatku \nome \space ima imenilac koji je jednak 0} +\def\es@zeronumerrorshort#1#2{Razlomak #1/#2 u zadatku \nome \space je jednak 0} +\def\es@zeronumerrorlong#1#2{Da bi razlomak mogao da bude 0, morate da korisitie "sempliz" komandu} +\def\es@fraconewarn#1#2{Razlomak #1/#2 u zadatku \nome \space je jednak 1} +\def\es@radicalerror{Potkorena velicina u zadatku \nome \space je negativna} +\def\es@fpsetparerrorshort{Nisu zadovoljeni svi uslovi nakon \maxLoopLimit\space pokusaja} +\def\es@EstraiMessage#1#2{\string\textbf\string{\string\noindent\space Izrazi $#2i$, $#2ii$ \string\dots\space +pretpostavlja vrednosti #1 \string}\string\newline} +\def\es@fpsetparerrshort#1{It's impossible to define the parameter #1} +\def\es@fpsetparerrlong#1{In the definition of the parameter #1 the lower bound is greater than upper bound} + +%%% The date + +\def\es@longdate#1/#2/#3\@empty{#3\space\ifcase#2\or +januar\or februar\or mart\or april\or maj\or jun\or +jul\or avgust\or septembar\or oktobar\or novembar\or decembar\fi \space #1} +\def\es@shortdate#1/#2/#3\@empty{#3/#2/#1} + + +\AtEndOfPackage{ +\usepackage{geometry} +\geometry{a4paper,lmargin=6mm,rmargin=18mm,tmargin=6mm,bmargin=18mm,marginparsep=2mm,footskip=1cm} +\usepackage{eurosym} +\usepackage[np,autolanguage]{numprint} +\newcommand*\npstyleitalian{% +\npthousandsep{\,}% +\npdecimalsign{,}% +\npproductsign{\ensuremath{\cdot}}% +\npunitseparator{~}% + \npthousandthpartsep{} +} +} diff --git a/Master/texmf-dist/tex/latex/esami/es-spanish.lng b/Master/texmf-dist/tex/latex/esami/es-spanish.lng index d0543ab483a..1ac5434df8e 100644 --- a/Master/texmf-dist/tex/latex/esami/es-spanish.lng +++ b/Master/texmf-dist/tex/latex/esami/es-spanish.lng @@ -36,6 +36,8 @@ \def\es@fpsetparerrorshort{No se verifican todas las condiciones después de \maxLoopLimit\space intentos} \def\es@EstraiMessage#1#2{\string\textbf\string{\string\noindent\space Las expresiones $#2i$, $#2ii$ \string\dots\space toman los valores #1 \string}\string\newline} +\def\es@fpsetparerrshort#1{No es posible definir el parámetro #1} +\def\es@fpsetparerrlong#1{En la definición del parámetro #1 la cota inferior es mayor de la cota superior} %%% The date diff --git a/Master/texmf-dist/tex/latex/esami/esami.sty b/Master/texmf-dist/tex/latex/esami/esami.sty index ad26df52236..f8c6930ea99 100644 --- a/Master/texmf-dist/tex/latex/esami/esami.sty +++ b/Master/texmf-dist/tex/latex/esami/esami.sty @@ -2,8 +2,8 @@ %% This is file `esami.sty', %% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -%% esami.sty package, 2013-03-08 %% -%% Copyright (C) 2008-2013 G. Messineo e S. Vassallo %% +%% esami.sty package, 2015-02-25 %% +%% Copyright (C) 2008-2015 G. Messineo e S. Vassallo %% %% %% %% This program can be redistributed and/or modified %% %% under the terms of the LaTeX Project Public License %% @@ -15,18 +15,26 @@ %%%%%% CHANGELOG %%%%%%% % Version 1.0 % First release to CTAN -% Version 1.1 -% Update: 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}). +%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}). +% 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. \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{esami} - [2013/12/09 v1.1 An Exam Construction Package] + [2015/02/25 v2.0 An Exam Construction Package] % +=============================+ % | THE OPTIONS | % +=============================+ - +\usepackage{etex} \newif\ifes@language \es@languagefalse \DeclareOption{italian}{\InputIfFileExists{es-\CurrentOption.lng}% { \es@languagetrue \typeout{esami: Verrà usata la lingua italiana}}% @@ -68,77 +76,47 @@ \DeclareOption{shuffle}{\es@fissatrue \es@shuffleQuestionstrue} \DeclareOption{shufflerandom}{\es@shuffleQuestionstrue \es@fissafalse}%% the exercises are randomly shuffled \DeclareOption{noshuffle}{\es@shuffleQuestionsfalse} -\DeclareOption{fillb}{\es@fillintrue}%%% option to use if in tests there are fill-in questions +%%% 2013-06-03 eliminata opzione +\DeclareOption{fillb}{} \newif\ifes@fillin \es@fillinfalse \newif\ifes@pointsonright \es@pointsonrightfalse%%% the box with the points on the right side (from eqexam) \DeclareOption{pointsonright}{\es@pointsonrighttrue \AtEndOfPackage{\PointsOnRight}} \newif\ifes@solutions \es@solutionsfalse \DeclareOption{solutions}{\es@solutionstrue -\AtEndDocument{\immediate\closeout\sols % -\stringasol} +\AtEndDocument{ +\immediate\closeout\loe +\immediate\closeout\parametri +\immediate\closeout\sols +%%%%% 2013-06-03 % +\stringasol} %%%% }%%% for solutions \DeclareOption{nosolutions}{\es@solutionsfalse}%%% no solutions (default) +\newif\ifes@noquizsolutions \es@noquizsolutionstrue % NEW 2014 +\DeclareOption{noquizsolutions}{\es@noquizsolutionstrue} +\DeclareOption{quizsolutions}{\es@noquizsolutionsfalse} \DeclareOption*{\InputIfFileExists{esami-\CurrentOption.cfg}{}%%% reads a configuration file {\PackageError{esami}{\es@cfgerrormessageshort} {\es@cfgerrormessagelong} }} \newif\ifes@autopst \es@autopstfalse%%% Do I need auto-pst? -\DeclareOption{autopstoff}{\es@autopstfalse}%%% autopstpdf inactive (default) -\DeclareOption{autopston}{\es@autopsttrue }%%%% autopstpdf active +\newif\ifes@pst \es@pstfalse%%% Do I need pstricks? %%% NEW for tikz 2014.3.3 +\DeclareOption{autopstoff}{\es@psttrue \es@autopstfalse}%%% autopstpdf inactive (default) % +\DeclareOption{autopston}{\es@psttrue \es@autopsttrue }%%%% autopstpdf active %%% NEW for tikz 2014.3.3 \newif\ifes@prova \es@provafalse -\DeclareOption{prova}{\es@solutionstrue \es@provatrue \es@randomizeChoicesfalse}%%% for the file "totale-versioni" +\DeclareOption{prova}{\es@solutionstrue \es@provatrue \es@randomizeChoicesfalse \es@noquizsolutionsfalse}%%% for the file "totale-versioni" \DeclareOption{correzione}{\es@correzionetrue \es@solutionsfalse}%%% to print all the exercises with solutions only \newif\ifes@correzione \es@correzionefalse \newif\ifes@param \es@paramfalse%%% to print the parametric version in "totale-versioni" \newif\ifes@test \es@testfalse%%% for tests + %========================================================% % Parametric version % %========================================================% \newwrite\parametri -\DeclareOption{param}{\es@paramtrue \AtBeginDocument{\newwrite\params - \renewcommand*{\selectallproblems}[1]{%%% the definition of \selectallproblem to print parametric version - \global\@probN=0\relax - \firstpasstrue - \setcounter{tmp@quest}{0} - \input{#1} - \firstpassfalse - \setcounter{tmp@quest}{0} - \input{#1} - \global\tmp@cnt=1\relax - \whiledo{\tmp@cnt < \@probN \TE@or \tmp@cnt = \@probN}{% - \immediate\openout\params=params%%% the file on which the parameters are written - \csname @prob@f\nome q\number\tmp@cnt\endcsname - \par\vspace{2mm} - \ifes@test - \immediate\closeout\params - \input{params} \fi%%% writes the parameters at the end of the exercise - \global\advance\tmp@cnt by 1\relax - } - } -\renewcommand{\FPsv}[2][0]{(#2)}%%% \FPsv shows oparations -\renewcommand{\FPval}[2]{\expandafter\def\csname#1\endcsname{(#2)}} -\renewcommand{\simpsqrt}[2]{\sqrt[#1]{(#2)}}%%% \simpsqrt shows operations -\renewcommand{\sempli}[2]{%%% all simplifications become \frac - \ifthenelse{\equal{#2}{1}}{(#1)}{\frac{#1}{#2}}} - \renewcommand{\semplix}[2]{% - \ifthenelse{\equal{#2}{1}}{(#1)}{\frac{#1}{#2}}} - \renewcommand{\sempliz}[2]{% - \ifthenelse{\equal{#2}{1}}{(#1)}{\frac{#1}{#2}}} - \renewcommand{\esempli}[2]{% - \ifthenelse{\equal{#2}{1}}{(#1)}{\frac{#1}{#2}}} - \renewcommandx{\FPsetpar}[5][1=\seme,5={}]{%%% the parameters are not assigned - \expandafter\def\csname#2\endcsname{#2}%%% in the parametric version, the parameter appears with its name and not with its value - %\expandafter\immediate\write\params{%%% write on a file - \immediate\write\params{%%% writes on a file - \string\textbf\string{\string\noindent\space \es@parametermessage{#2}{#3}{#4} - \space \ifx#5\@empty\else $#2\neq #5$.\fi\space \es@seedmessage{#1} - \string}\string\newline}}% - \immediate\closeout\params% - \PTsHook{\emph{(\esPTs\ \ifthenelse{\equal{\esPTs}{\detokenize{1}}}{\es@pointname}{\es@pointsname})} % - } -} -} + +\DeclareOption{param}{\es@paramtrue \AtBeginDocument{\newwrite\params}} + \ProcessOptions\relax % +=============================+ @@ -146,23 +124,27 @@ % +=============================+ \usepackage{graphicx} -\usepackage{amsmath} -\usepackage{amssymb} \usepackage{enumerate} \usepackage{fp} \usepackage{currfile} \usepackage{array} -\usepackage{ifthen} \usepackage{environ} +\usepackage{ifthen} \usepackage{xargs} \usepackage{multicol} +\usepackage{amssymb} + + +\ifes@pst \usepackage{pstricks,pstricks-add} \ifes@autopst \usepackage[crop=off,dvips={}]{auto-pst-pdf} \else \usepackage[off]{auto-pst-pdf} \fi - + \else + \@ifpackageloaded{xcolor}{}{\usepackage{xcolor}} +\fi \input random %========================================================% @@ -208,6 +190,7 @@ \newbox{\es@pointbox} \newlength{\es@pointboxtotalheight}%%% the height of the point box \newsavebox{\workareasb} +\newlength\mylabelsep %========================================================% % exercise % @@ -240,7 +223,7 @@ \priorexskip{\medskipamount} \esexerskip{\medskipamount} \let\afterlabelhskip=\space - +\def\Acapo{\par} %========================================================% % test % %========================================================% @@ -263,13 +246,22 @@ \newcount\end@al%%% temporary counter in \estraialfa \newcount\beg@al%%% temporary counter in \estraialfa \newcounter{nomefile}%%% counter for year-month-day -\newcounter{tmp@quest}%%% the number of the exercise +\newcount\tmp@quest %%% the number of the exercise +\newcount\@probselN %%% in \selectrandomlyn +\newcount\@shfctr \newcount\@shfA \newcount\@shfB %%% In "\shuffle" +\newcount\icount %%% contatore per mischiare esercizi +\newcount\io +\newcount\inizio +\inizio=1 +%%%% \newcounter{vers}%%% the number of the version \setcounter{vers}{0} \newcounter{n@par}%%% it counts the number of parameters \newcount\loopCnt%%% the number of attempts in \FPsetpar \newcounter{fp@contatore}%%% used in \FPsetpar +\newcount\old@randomii%%% used to change seed shuffling exercise \newcount\old@randomi%%% used to change seed in \FPsetpar +\newcount\old@random%%% used to change seed in \selectrandomly %%%NUOVO \newcount\sh@max%%% used to choose the exercises \newcount\@probN%%% number of exercises in \selectrandomly \newcount\j@m%%% temporary counter in \newproblem @@ -286,6 +278,8 @@ \newcounter{esquestionnoiii} \renewcommand{\theesquestionnoiii}{\roman{esquestionnoiii}} +\def\es@primo{1237} + %========================================================% % test % %========================================================% @@ -356,7 +350,7 @@ \newcommand\exlabelformat{{\scshape\exlabel\ \theex@no.}} \newcommand\exlabelformatwp{{\scshape\exlabel\ \theex@no.}} \newcommand{\exsolafter}{\es@exsolafterDefault} -\newcommand{\es@exsolafterDefault}{\textit{\es@solutionname}:} +\newcommand{\es@exsolafterDefault}{\textit{\es@solutionname}: } \newcommand{\esexlisttabheader} {(\hfil\theex@partno\hfil)% } @@ -373,9 +367,16 @@ % Maths % %========================================================% -\newcommand{\FPsv}[2][0]{\FPeval\fp@tmpa{round(#2:#1)}\numprint{\fp@tmpa}}%%% It does operations with #1 decimals and with the "param" option it shows operations -\newcommand{\FPval}[2]{\FPeval#1{round(#2:0)}}%% it works like \FPsv with the option param, like \FPeval otherwise - +\ifes@param +\newcommand{\FPsv}[2][0]{(#2)}%%% \FPsv shows oparations +\newcommandx{\FPval}[3][2=0]{\expandafter\def\csname#1\endcsname{(#1)} +\immediate\write\params{%%% writes on a file + \string\textbf\string{\string\noindent\space \es@parametermessagea{#1}{#3} + \string}\string\newline}} +\else +\newcommand{\FPsv}[2][0]{\FPeval{\fp@tmpa}{clip(round(#2:#1))}\numprint{\fp@tmpa}}%%% It does operations with #1 decimals and with the "param" option it shows operations +\newcommandx{\FPval}[3][2=0]{\FPeval{#1}{clip(round(#3:#2))}}%% it works like \FPsv with the option param, like \FPeval otherwise +\fi %========================================================% % fractions % %========================================================% @@ -528,7 +529,12 @@ } %%%%%%% Fill in %%%%%% - +%%%% NEW fillin 2013-06-03 +\newcommand\fillinproblem{\es@fillintrue% +\ifes@solutions +\immediate\openout\parametri=qf\nome q\romannumeral\tmp@quest e\thevers.parametri.tex +\fi} +%%%% \ifes@solutions \def\fill@ans@color#1{\bfseries\color{red}{#1}}%%% with solutions answers are in red by default \else @@ -543,9 +549,13 @@ \fillin@Fmt{\parbox[b][.8\height][b]{#2}{% \strut\hfil\fill@ans@color{#3}\hfil}% \ifes@test + \ifes@prova + \else \ifes@solutions%%% to write the string of solutions -\immediate\write\sols{\string\item\space\string\makeatletter\space\string\input\string{qf\nome q\thetmp@quest e\thevers.parametri\string}\string\makeatother} +\immediate\write\sols{\string\item\space\string\makeatletter\space\string\input\string{qf\nome q\romannumeral\tmp@quest e\thevers.parametri\string}\string\makeatother} \immediate\write\sols{\unexpanded{#3}} +\immediate\write\loe{\es@exercisename\space\theesquestionnoi:\space \probchosen} +\fi \fi \fi } @@ -553,23 +563,16 @@ %%%%% Other commands %%%%%% -%\long\def\Collect@Body#1{%%%%% This command is taken from the environ package %%%% -% \@envbody{\expandafter#1\expandafter{\the\@envbody}}% -% \edef\process@envbody{\the\@envbody\noexpand\end{\@currenvir}}% -% \@envbody\@emptytoks \def\begin@stack{b}% -% \begingroup -% \expandafter\let\csname\@currenvir\endcsname\Collect@@Body -% \edef\process@envbody{% -% \expandafter\noexpand\csname\@currenvir\endcsname}% -% \process@envbody -%} - \newcommand\stepvers{\stepcounter{vers}\ifes@solutions -\immediate\write\sols{\string\begin{minipage}{.33\string\textwidth}\string\large\string\textbf{\es@solutionname\ \versionname\ n. \thevers}}\fi} -\newcommand\closevers{\newpage\setcounter{page}{1}\ifes@solutions\immediate\write\sols{\string\end{minipage} - \string\vspace{5ex}}\fi} - -\def\mydate#1/#2/#3\@empty{\setcounter{nomefile}{\two@digits{#3}\two@digits{#2}\two@digits{#1}}}%%% it gives to the counter "nomefile" a value determined by the date +\immediate\write\sols{\string\begin{minipage}{.33\string\textwidth}\string\large\string\textbf{\es@solutionname\ \versionname\ n. \thevers}} +\immediate\write\loe{\versionname\space n. \thevers}\fi} +\newcommand\closevers{\newpage\setcounter{page}{1}\setcounter{ex@no}{0}\ifes@solutions\immediate\write\sols{\string\end{minipage} + \string\vspace{5ex}} + \immediate\write\loe{\space} + \immediate\write\loe{\space} + \fi} + +\def\mydate#1/#2/#3\@empty{\setcounter{nomefile}{\two@digits{#1}\two@digits{#2}\two@digits{#3}}}%%% it gives to the counter "nomefile" a value determined by the date \PTsHook{\emph{(\esPTs\ \ifthenelse{\equal{\esPTs}{\detokenize{1}}}{\es@pointname}{\es@pointsname})}}%%% The name of the points \newcommand{\proofingsymbol}[1]{\def\@proofingsymbol{{#1}\hspace{-.3em}\es@segnala}}%%% this defines the symbol for the exact answer in MCQ and the label for the string of solutions \proofingsymbol{$\blacktriangleright$}%%% the proofing symbol that can be changed in document @@ -579,29 +582,44 @@ \def\longdate{\expandafter\es@longdate\@date\@empty} \def\shortdate{\expandafter\es@shortdate\@date\@empty} \expandafter\mydate\@date\@empty + \ifes@prova + \else \ifes@solutions \newwrite\sols \immediate\openout\sols=\jobname.sol.tex +\newwrite\loe +\immediate\openout\loe=\jobname.loe + \fi \fi} \newcommand\es@segnala{%%% this command gives the reference of the exact answer in the string of solutions \if\es@listType1\addtocounter{sq@quizno}{-1}\refstepcounter{sq@quizno}\fi -\ifes@prova \else \label{af\nome q\number\j@n e\thevers} \immediate\write\sols{\string\item\string\ref{af\nome q\number\j@n e\thevers}}\fi +\ifes@prova \else \label{\probchosen} \immediate\write\sols{ \string\item\string\ref{\probchosen}} +\immediate\write\loe{\es@exercisename\space\theesquestionnoi:\space \probchosen} \fi } \newcommand{\prior@questionsHook}{} %========================================================% -% definizioni di Fpsetpar % +% definitions of Fpsetpar % %========================================================% - \def\maxLoopLimit{10}% +\ifes@param +\newcommandx{\FPsetpar}[5][1=\seme,5={}]{%%% the parameters are not assigned + \expandafter\def\csname#2\endcsname{#2}%%% in the parametric version, the parameter appears with its name and not with its value + \immediate\write\params{%%% writes on a file + \string\textbf\string{\string\noindent\space \es@parametermessage{#2}{#3}{#4} + \space \ifx#5\@empty\else $#2\neq #5$.\fi\space \es@seedmessage{#1} + \string}\string\newline}} + \else \newcommandx{\FPsetpar}[5][1=\seme,5={}]{% +\ifnum#3<#4\else\PackageError{esami}{\es@fpsetparerrshort{#2}}{\es@fpsetparerrlong{#2}}\fi%% NEW 2015 +\@ifundefined{nome}{\setcounter{fp@contatore}{-2}}{ +\@ifundefined{base\nome}{\setcounter{fp@contatore}{-2}}{\setcounter{fp@contatore}{-\csname base\nome \endcsname}}} +\FPval{randomico}{\thevers+\then@par+\thequestionno+#1} \old@randomi=\number\randomi%%% it saves the old seed \stepcounter{n@par}% \setcounter{fp@contatore}{-\value{vers}}% -\randomi=#1% -\advance\randomi\value{n@par}% +\randomi=\randomico% \addtocounter{fp@contatore}{-#3}% -\advance\randomi\value{vers}% \whiledo{\value{fp@contatore}<\value{questionno}}{\nextrandom\stepcounter{fp@contatore}}% \setrannum{\tmp@a}{#3}{#4}% \def\rand@ne{#5}%%% checks the parameter (adapted from rangen) @@ -629,12 +647,11 @@ \fi% \FPeval{#2}{round(\number\tmp@a:0)}% \ifes@fillin% -%\expandafter \immediate\write\parametri{\string\FPeval\string{#2\string}\string{round(\number\tmp@a:0)\string}}% \fi% \randomi=\number\old@randomi%%% restores the seed }% - +\fi %%%%%% Alternative definitions of \FPsetpar with different randomization process (we left them for archive purposes) %%%% %\newcommandx{\FPsetpar}[5][1=\seme,5={}]{% @@ -719,6 +736,24 @@ - \fi}% +%%% Modified commands for parametric version in "totale-versioni" +\ifes@param +\renewcommand{\simpsqrt}[2]{\sqrt[#1]{(#2)}}%%% \simpsqrt shows operations +\renewcommand{\sempli}[2]{%%% all simplifications become \frac + \ifthenelse{\equal{#2}{1}}{(#1)}{\frac{#1}{#2}}} + \renewcommand{\semplix}[2]{% + \ifthenelse{\equal{#2}{1}}{(#1)}{\frac{#1}{#2}}} + \renewcommand{\sempliz}[2]{% + \ifthenelse{\equal{#2}{1}}{(#1)}{\frac{#1}{#2}}} + \renewcommand{\esempli}[2]{% + \ifthenelse{\equal{#2}{1}}{(#1)}{\frac{#1}{#2}}} + \PTsHook{\emph{(\esPTs\ \ifthenelse{\equal{\esPTs}{\detokenize{1}}}{\es@pointname}{\es@pointsname})} % + \ifes@test + \immediate\closeout\params + \fi + } +\fi + % +===================================+ % | OTHER ENVIRONMENTS AND EXERCISES | % +===================================+ @@ -839,57 +874,71 @@ \newif\iffirstpass \ifes@prova \newcommand{\newproblem}[1]{%%% \newproblem for the file "totale-versioni" -\stepcounter{tmp@quest} +\advance\tmp@quest by1 \iffirstpass \global\advance\@probN by 1 \else \let\nome\currfilebase +\global\def\problabel{e:\thevers-file:\nome} +\global\def\probnumber{q:\romannumeral\tmp@quest} \ifes@fillin \immediate\openout\parametri=qf\nome q\number\j@n e\thevers.parametri.tex \fi -\expandafter\global\expandafter\newcommand\csname @prob@f\nome q\thetmp@quest \endcsname{#1}%%% it assigns a name to exercise +\expandafter\global\expandafter\newcommand\csname \probnumber \endcsname{#1} \fi } \else \ifes@correzione \newcommand{\newproblem}[1]{%%% \newproblem for the "correzione" option - \stepcounter{tmp@quest} +\advance\tmp@quest by1 \iffirstpass \global\advance\@probN by 1 \else \let\nome\currfilebase + \global\def\problabel{e:\thevers-file:\nome} +\global\def\probnumber{q:\romannumeral\tmp@quest} \ifes@fillin - \immediate\openout\parametri=qf\nome q\thetmp@quest e\thevers.parametri.tex + \immediate\openout\parametri=qf\nome q\romannumeral\tmp@quest e\thevers.parametri.tex \fi -\expandafter\global\expandafter\newcommand\csname @prob@f\nome q\thetmp@quest e\thevers \endcsname{\unexpanded{#1}} - \expandafter\global\expandafter\newcommand\csname @prob@f\nome q\thetmp@quest \endcsname{#1} +\expandafter\global\expandafter\newcommand\csname @prob-\problabel-\probnumber \endcsname{\unexpanded{#1}} + \expandafter\global\expandafter\newcommand\csname @probi-\problabel-\probnumber \endcsname{#1} \fi } \else \newcommand{\newproblem}[1]{%%% \newproblem for the exam -\stepcounter{tmp@quest} +\advance\tmp@quest by1 \iffirstpass \global\advance\@probN by 1 \else \let\nome\currfilebase - \ifes@fillin - \immediate\openout\parametri=qf\nome q\thetmp@quest e\thevers.parametri.tex - \fi -\expandafter\global\expandafter\newcommand\csname @prob@f\nome q\thetmp@quest e\thevers \endcsname{\unexpanded{#1}} -\expandafter\global\expandafter\newcommand\csname @probi@f\nome q\thetmp@quest e\thevers \endcsname{#1}%%% it assigns a unique name to exercise +\global\def\problabel{e:\thevers-file:\nome} +\global\def\probnumber{q:\romannumeral\tmp@quest} +\expandafter\global\expandafter\newcommand\csname @prob-\problabel-\probnumber \endcsname{\unexpanded{#1}} +\expandafter\global\expandafter\newcommand\csname @probi-\problabel-\probnumber\endcsname{#1}%%% it assigns a unique name to exercise \fi } \fi \fi +%%%% NEW fillin 2013-06-03 +\newcommand{\newfillinproblem}[1]{ \newproblem{\fillinproblem #1}} + %%%%%%%% \selectrandomly %%%%%%% \newcommand{\selectrandomly}[1]{% \global\@probN=0\relax \firstpasstrue -\setcounter{tmp@quest}{0} +\tmp@quest=0 \input{#1}%%%%% -\FPeval\restotrentasei{round(\thevers+\thenomefile+1-trunc((\thevers+\thenomefile)/36:0)*36:0)} +\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 @@ -906,17 +955,16 @@ \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%%% if there are more than 8 variants, the choice is random -\setrannum{\rnd@cnta}{1}{\@probN} -\def\j@n{\number\rnd@cnta} +\else +\FPeval\j@n{round(\thevers*\es@primo+base\nome+1-trunc((\thevers*\es@primo+base\nome)/\number\@probN:0)*\number\@probN:0)} \fi -\firstpassfalse%%% now prints the question -\setcounter{tmp@quest}{0} -\input{#1} +\def\probchosen{\problabel-q:\romannumeral\j@n} \ifes@test -\begin{minipage}{.95\linewidth}\csname @probi@f\nome q\number\j@n e\thevers\endcsname \vspace{5mm}\end{minipage} +\begin{minipage}{.95\linewidth}\csname @probi-\problabel-q:\romannumeral\j@n \endcsname \vspace{5mm}\end{minipage} +\Acapo \else -\csname @probi@f\nome q\number\j@n e\thevers\endcsname \vspace{5mm} +\csname @probi-\problabel-q:\romannumeral\j@n \endcsname \vspace{5mm} +\Acapo \fi \ifes@fillin \immediate\closeout\parametri @@ -925,21 +973,138 @@ %%%% \selectallproblems %%%%% -\newcommand*{\selectallproblems}[1]{%%% it selects all the problems of a file and prints them for "totale-versioni" +\newcommand{\selectallproblems}[2][]{%% %%% it selects all problems for "totale-versioni", with the option "random" the problems are in random order \global\@probN=0\relax \firstpasstrue -\setcounter{tmp@quest}{0} -\input{#1}% +\tmp@quest=0 +\input{#2}% \firstpassfalse -\setcounter{tmp@quest}{0} -\input{#1}% +\tmp@quest=0 +\input{#2}% +\ifthenelse{\equal{#1}{random}}{\i@sh=0 +\loop +\advance\i@sh by1 +\expandafter\edef\csname ftmp\romannumeral\i@sh \endcsname {\romannumeral\i@sh} +\ifnum\i@sh <\number\tmp@quest +\repeat +\shuffle{ftmp}{\tmp@quest}}{} \global\j@m=1\relax -\whiledo{\j@m < \@probN \TE@or \j@m = \@probN}{% -\csname @prob@f\nome q\number\j@m -\endcsname \vspace{4mm} +\whiledo{\j@m < \@probN \TE@or \j@m = \@probN}{ + \ifes@prova + \ifes@param% + \immediate\openout\params=params %%% the file in which the parameters are written + \fi + \def\probchosen{\problabel-q:\romannumeral\j@m} +\csname q:\romannumeral\j@m \endcsname% + \else + \def\probchosen{\problabel-q:\romannumeral\j@m} + \ifthenelse{\equal{#1}{random}}{ + \csname @probi-\problabel-q:\csname ftmp\romannumeral\j@m\endcsname \endcsname + }{ +\csname @probi-\problabel-q:\romannumeral\j@m \endcsname + }% + \fi +\par\vspace{2mm} + \ifes@param% +\input{params} + \fi \global\advance\j@m by 1\relax }} +%%%%%%%%%%%% NEW 2013-06-05 +%%% working with datasets of exercises (you can choose more than one exercise from a file) + +\newif\ifes@db %% to work with datasets +\es@dbfalse + +\newwrite\dbtemp +\newenvironment{esdb}[1]{ +\gdef\dbname{#1} +\immediate\openout\dbtemp=\dbname.tex +\es@dbtrue% +}{ +\immediate\closeout\dbtemp +\esercizidb{\dbname} +\es@dbfalse% +} + +\newcommand{\selectrandomlyn}[2]{ +\global\@probN=0\relax +\firstpasstrue +\tmp@quest=0 +\input{#2}% +\ifthenelse{\equal{#1}{all}}{\@probselN=\number\tmp@quest}{ +\ifnum\tmp@quest<#1 \relax + \PackageWarning{esami}{\es@selectnwarn{#1}{#2}} + \@probselN=\number\tmp@quest % + \else + \@probselN=#1 + \fi} + \i@sh=0 +\loop +\advance\i@sh by1 +\expandafter\edef\csname ftmp\romannumeral\i@sh \endcsname {\romannumeral\i@sh} +\ifnum\i@sh <\number\tmp@quest +\repeat +\shuffle{ftmp}{\tmp@quest} +\firstpassfalse% +\tmp@quest=0 +\input{#2} + \i@sh=0 +\loop +\advance\i@sh by1 +\global\def\probnumber{q:\csname ftmp\romannumeral\i@sh\endcsname} +\expandafter\immediate\write\dbtemp\expandafter{\string\defitem\string{% +\string\gdef\string\problabel{\problabel}\space +\string\gdef\string\probnumber{\probnumber}\space +\string}} +\ifnum\i@sh <\number\@probselN +\repeat +} + +\def\defitem{% + \advance\icount by1 + %%% IT defines a macro called "\prbl n" where "n" is the number of the item. + \expandafter\def \csname prbl\romannumeral\icount \endcsname +} + + +\def\@getitems#1#2#3{\rand@getitems{#2}{#3}[#1]}% + +\newcommand{\esercizidb}[1]{ + \icount=0 +\input{#1.tex}% +\i@sh=0 +\loop +\advance\i@sh by1 +\expandafter\edef\csname ftemp\romannumeral\i@sh \endcsname {\romannumeral\i@sh} +\ifnum\i@sh <\number\icount +\repeat +\shuffle{ftemp}{\icount} +\setcounter{n@par}{1} +\io=\icount +\loop +\ifes@test +\begin{minipage}{.95\linewidth} +\fi +\ifes@shuffleQuestions +\csname prbl\csname ftemp\romannumeral\io\endcsname\endcsname +\else +\csname prbl\romannumeral\io \endcsname +\fi +\def\probchosen{\problabel-\probnumber} +\csname @probi-\problabel-\probnumber \endcsname +\ifes@test + \vspace{5mm}\end{minipage} + \Acapo +\vspace{4mm} + \fi + \advance\io by-1 + \ifnum\io > 0 \repeat + \par} + + + % +=============================+ % | ENVIRONMENTS | % +=============================+ @@ -980,13 +1145,19 @@ \setlength{\itemindent}{0pt}\setlength{\itemsep}{3pt}% \setlength{\leftmargin}{\labelwidth}% \settowidth{\labelsep}{\ }} + \ifes@prova + \else \ifes@solutions \immediate\write\sols{\string\begin{enumerate}} + \fi \fi% }{\end{list} +\ifes@prova +\else \ifes@solutions \immediate\write\sols{\string\par\string\end{enumerate}\string\vspace{3ex}} \fi +\fi } %%%%%%% shortquiz (where to put the environment questions) %%%% @@ -1003,13 +1174,12 @@ \setcounter{questionno}{0}% \let\answers\answers@sq \let\endanswers\endanswers@sq + \let\solution\solution@sq + \let\endsolution\endsolution@sq \sq@priorhook\sqlabel\space \ignorespaces } \def\aftershortquizskip{\medskip} -\def\aeb@endshortquiz{\setcounter{sq@quizno}{0}% - \par\aftershortquizskip -} \def\answers@sq{\stepcounter{questionno}% \answers@@sq } @@ -1032,7 +1202,7 @@ \setlength{\topsep}{0pt}\setlength{\partopsep}{0pt}% \setlength{\listparindent}{\parindent}% \setlength{\leftmargin}{\labelwidth}% - \setlength{\labelsep}{0pt}% + \setlength{\labelsep}{\mylabelsep}% \def\Ans{\Ans@list}% }% }% @@ -1162,6 +1332,18 @@ } \def\@findendans{\@ifnextchar\end{}{\expandafter\@findendans\@gobble}} +\ifes@noquizsolutions %%%% NEW 2014 solutions for test +\def\solution@sq{\gobbleenv} +\def\endsolution@sq{\endgobbleenv} +\else +\def\solution@sq{ + \par\smallskip\noindent + \textit{\es@solutionname}:\ +} + +\def\endsolution@sq +{} +\fi %========================================================% % EXERCISE AND SIMILAR % %========================================================% @@ -1290,15 +1472,36 @@ \es@testfalse \renewcommand{\punti}{#1} \ifes@solutionsonly\else\examenddef\fi -\begin{exercise}} -{ \ifes@param \immediate\closeout\params \input{params}\fi \end{exercise} } +\begin{exercise} +\ifes@prova +\else +\ifes@solutions +\immediate\write\loe{\es@exercisename\space \theex@no:\space \probchosen} +\fi +\fi +} +{ +\end{exercise} +\ifes@param +\immediate\closeout\params +\fi} + \newenvironment{problem*}[1][]{\es@testfalse \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 } -{ \ifes@param \immediate\closeout\params \input{params}\fi \end{exercise*} } - +{ +\end{exercise*} +\ifes@param +\immediate\closeout\params +\fi } %%%%%%%% Domanda %%%%%%%% %%%% (it can be used to hide the text of the exercise and print only the solution) %%% @@ -1357,13 +1560,14 @@ %========================================================% %% These values are used in pseudorandom permutations: they must be calculated for any version + \newcommand{\permuta}{ \FPeval\restosei{round(\thevers+\thenomefile+1-trunc((\thevers+\thenomefile)/6:0)*6:0)}%%% for 2 or 3 exercises permutations \FPeval\restoventiquattro{round(\thevers+\thenomefile+1-trunc((\thevers+\thenomefile)/24:0)*24:0)}%%%% for 4 exercises permutations \FPeval\restotrenta{round(\thevers+\thenomefile+1-trunc((\thevers+\thenomefile)/30:0)*30:0)} %%%% for 5,6,7,8 exercises permutations } -%%% pseudorandom versions (permutations of 1 esercise!!!!!!!!) +%%% pseudorandom versions (permutations of 1 esercise!!) \def\sceglii#1#2{\expandafter\def\csname #2i\endcsname{#1}} \def\prendii#1#2{\sceglii{#1}{#2}} %%% pseudorandom versions (permutations of 2 esercises) @@ -1672,7 +1876,11 @@ \or\prendivi{\csname #1i\endcsname}{\csname #1ii\endcsname}{\csname #1iii\endcsname}{\csname #1iv\endcsname}{\csname #1v\endcsname}{\csname #1vi\endcsname}{#3}% \or\prendivii{\csname #1i\endcsname}{\csname #1ii\endcsname}{\csname #1iii\endcsname}{\csname #1iv\endcsname}{\csname #1v\endcsname}{\csname #1vi\endcsname}{\csname #1vii\endcsname}{#3}% \or\prendiviii{\csname #1i\endcsname}{\csname #1ii\endcsname}{\csname #1iii\endcsname}{\csname #1iv\endcsname}{\csname #1v\endcsname}{\csname #1vi\endcsname}{\csname #1vii\endcsname}{\csname #1viii\endcsname}{#3}% -\else\rand@getitems{#2}{#3}[#1]% +\else +\old@randomii=\number\randomi +\nextrandom +\rand@getitems{#2}{#3}[#1]% +\randomi\number\old@randomii \fi% }% \else @@ -1694,15 +1902,42 @@ }% \else \newcommand{\sh@mixex}{%%% the exercises are not shuffled - \tmp@cnt=\value{shuf@lop} + \tmp@cnt=1% \loop% \selectrandomly{\cartella/\csname exe\romannumeral\tmp@cnt\endcsname} - \advance\tmp@cnt by-1 - \ifnum\tmp@cnt>0 + \ifnum\tmp@cnt<\value{shuf@lop} +\advance\tmp@cnt by1 \repeat } \fi +%%%% new 2013-06-05 +%%% another shuffling macro +\newcommand{\shuffle}[3][]{% %%% this command has been adapted from probsoln + \@shfctr=1\relax + \whiledo{\@shfctr < 101}% + {% + \setrannum{\@shfA}{1}{#3}\setrannum{\@shfB}{1}{#3} + \ifnum\@shfA=\@shfB + \else + \edef\@@tmpA{\csname#2\romannumeral\@shfA\endcsname}% + \let\@tmpA=\@@tmpA + \edef\@@tmpB{\csname#2\romannumeral\@shfB\endcsname}% + \let\@tmpB=\@@tmpB + \expandafter\xdef\csname#2\romannumeral\@shfA\endcsname{\@tmpB}% + \expandafter\xdef\csname#2\romannumeral\@shfB\endcsname{\@tmpA}% + \fi + \advance\@shfctr by 1\relax + \ifthenelse{\equal{#1}{}}{}{ + \@shfA=0% + \loop + \advance\@shfA by1 + \expandafter\xdef\csname#1\romannumeral\@shfA\endcsname{\csname#2\romannumeral\@shfA\endcsname} + \ifnum\@shfA<#3 \repeat +} + }% +} + %========================================================% % Random (adapted from aebrandom) % %========================================================% @@ -1782,47 +2017,4 @@ \finished@Randomizing } \fi - -%========================================================% -% 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} - \endinput |