The esami package v. 2.9
          For generation of texts and solutions  of exams in LaTeX
2024/07/01

File:       README
Author:    Grazia Messineo and Salvatore Vassallo


DESCRIPTION
===========

The package allows to write various type of exercises (multiple choiche questions with answers
varying in random order, with closed or open answer, 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.

Copyright:  (C) 2008--2024 Grazia Messineo & Salvatore Vassallo
Licence:    LPPL

FILES IN DISTRIBUTION
=====================

   BASE DISTRIBUTION:
    
      VERSION 
      README       	This file.
      esami.sty     	The main file
      esami-xyz.cfg       A template of configuration file
      es-*.lng      	Localisation files

   DOCUMENTATION:

     esami-doc-en.pdf  User manual in English
     esami-doc-it.pdf  	User manual in Italian
     esami-doc-*.tex   	Sources for documentation
     esami.bib    Source for references
    
   EXAMPLES:
   Templates for the production of exams with solutions
        master-sol.tex
        master.tex

   Template of file for testing exercise
        totale-versioni.tex

   Exercises for test
        test1.tex
		test2.tex
		test3.tex
		test4.tex
		test5-fillin.tex
		test9.tex
        test11.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 (and solutions) built using above exercises  using pdflatex, xelatex and lualatex
        testA-luatex.pdf
		testA-luatex-sol.pdf
		testA-luatex-sol.tex
		testA-luatex.tex
		testA-pdflatex.pdf
		testA-pdflatex-sol.pdf
		testA-pdflatex-sol.tex
		testA-pdflatex.tex
		testA-xetex.pdf
		testA-xetex-sol.pdf
		testA-xetex-sol.tex
		testA-xetex.tex


BASIC INSTALLATION
====================

File sty and files cfg and lng must be copied in a folder where LATEX can find them

   For a basic installation on a TDS compliant system, move the
   following files to the following directories:

     <texmf>/tex/latex/esami/
      esami.sty     The main file
      esami-xyz.cfg       A template of configuration file
      es-*.lng      Localisation files


     <texmf>/doc/latex/esami/
         README
         doc-esami-en.pdf  User manual in English
         doc-esami-it.pdf  User manual in Italian
         doc-esami-*.tex   Sources for documentation