AMC-PREPARE(1) Auto Multiple Choice AMC-PREPARE(1)NAME
AMC-prepare - prepares working documents from LaTeX source file
SYNOPSIS
auto-multiple-choice prepare --mode s --prefix project-dir mcq-source-file
auto-multiple-choice prepare --mode b --data project-data-dir mcq-source-file
DESCRIPTION
The AMC-prepare.pl command extracts working documents from the source file describing the multiple choice questionnaire. Information to be
extracted depends on the --mode argument value. In any mode, the source filename must be given as an argument.
o with "--mode s", AMC-prepare.pl makes the subject file (answer sheet to be printed and given to the students), the correction (single
corrected answer sheet) and the positions file (file containing information about the positions of the boxes on the pages). The
following arguments can be used:
--out-sujet subject.pdf
sets the subject file to build.
--out-corrige corrected.pdf
sets the correction to build.
--out-calage calage.xy
sets the positions file to build.
--prefix directory
this directory is only necessary if one or more of the three previous options are not used: default values are then
directory/sujet.pdf, directory/corrige.pdf and directory/calage.xy.
o with "--mode b", AMC-prepare.pl extracts scoring data from the source file. In this mode, the --data argument must be used (see below).
The following optional arguments can be used in any mode:
--with latex-engine
gives the LaTeX engine (command) to be used. latex-engine can be pdflatex or xelatex for exemple.
--filter filter
sets the filter name to transform the MCQ source file into a LaTeX file. Native filters are latex (no change at all) and plain (source
is an AMC-TXT file).
--filtered-source mcq-latex-file
gives the LaTeX file to make from the source file using specified filter. If omitted, a filename derived from mcq-source-file adding
_filtered.tex is used.
--n-copies n
sets the number of copies to produce, overriding the number given in the LaTeX source file (first argument of the onecopy command).
--debug file.log
gives a file to fill with debugging information.
--data project-data-dir
sets the directory where the project's SQLite data files are.
AUTHORS
Alexis Bienvenue <paamc@passoire.fr>
Main author
Jean Berard
Translation from French
Georges Khaznadar
Translation from French
COPYRIGHT
Copyright (C) 2008-2012 Alexis Bienvenue
This document can be used according to the terms of the GNU General Public License, version 2 or later.
Auto Multiple Choice 1.1.1 06/19/2012 AMC-PREPARE(1)
Check Out this Related Man Page
AMC-EXPORT(1) Auto Multiple Choice AMC-EXPORT(1)NAME
AMC-export - exports marks for AMC multiple choice exams.
SYNOPSIS
auto-multiple-choice export --data project-data-dir --module module --fich-noms students-list.csv [--noms-encodage list-encoding]
--o output-file
DESCRIPTION
The AMC-export.pl command exports marks from an Auto Multiple Choice exam.
--data project-data-dir
gives the directory where data files are (see for example AMC-prepare(1)).
--module module
selects a module for export. See below for the modules included in the AMC standard distribution.
--fich-noms students-list.csv
sets the students list file.
--noms-encodage list-encoding
selects an encoding for file students-list.csv (default is utf-8).
--o output-file
gives the output file name.
--option-out options
gives an option for selected module, in the form key=value (see below for possible options for each module). To specify multiple
options, use --option several times.
--sort sort-type
sort the students names, depending on sort-type. If sort-type is l, use line number from students list file to sort. If sort-type is m,
use mark (and name if marks are equal) to sort. If sort-type is i, use student number to sort. If sort-type is n, use name to sort (or
line from students list if equal).
--useall all
if all is 0 or empty, only students with a scaned answer sheet appears in the output. If all is 1, all students in the students list
appears in the output.
MODULES
OpenDocument
With "--module ods", an OpenDocument (for use by OpenOffice or LibreOffice for example) is produced. The following options are recognized:
nom
gives a name for the exam, to be written on the beginning of the sheet.
code
gives an short name for the exam, to be used as a tab name.
columns
sets the list of columns that are to be added to each student. Default value is student.key,student.name.
stats
with a true value, a table will be added with statistics for all questions.
statsindic
with a true value, a table will be added with statistics for all indicative questions.
CSV
With "--module CSV", a CSV file is produced. The following options are recognized:
columns
sets the list of columns that are to be added to each student. Default value is student.copy,student.key,student.name.
decimal
sets the decimal point (default is a dot).
encodage
sets the encoding to use for output (default is utf-8).
separateur
sets the character used between colums (default is a comma).
entoure
sets the character used to enclose strings (default is a double quote).
ticked
if not empty, additional columns (with "CHECKED:" prefix) are included to give all the checked boxes on all the sheets. This can be
used by an external program to retrieve all the checked boxes when marks are not sufficient. Use value 01 to get 0;0;1;1;0 if boxes 3
and 4 are checked, and value AB to get CD if boxes 3 and 4 are checked.
List
With "--module List", a PDF file is produced with a list of marks for all students. The following options are recognized:
pagesize
The page size. Default value is a4.
nom
gives the name of the exam, to be printed at the top of the page.
ncols
The number of columns. Default value is 2.
decimal
sets the decimal point (default is a dot).
AUTHORS
Alexis Bienvenue <paamc@passoire.fr>
Main author
Jean Berard
Translation from French
Georges Khaznadar
Translation from French
COPYRIGHT
Copyright (C) 2008-2012 Alexis Bienvenue
This document can be used according to the terms of the GNU General Public License, version 2 or later.
Auto Multiple Choice 1.1.1 06/19/2012 AMC-EXPORT(1)