'\" t
.\"     Title: AMC-prepare
.\"    Author: Alexis Bienven\(:ue <paamc@passoire.fr>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2021-01-21
.\"    Manual: Auto Multiple Choice
.\"    Source: Auto Multiple Choice 1.5.0~rc1
.\"  Language: English
.\"
.TH "AMC\-PREPARE" "1" "2021-01-21" "Auto Multiple Choice 1\&.5\&.0" "Auto Multiple Choice"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
AMC-prepare \- prepares working documents from LaTeX source file
.SH "SYNOPSIS"
.HP \w'\fBauto\-multiple\-choice\fR\ 'u
\fBauto\-multiple\-choice\fR prepare \-\-mode\ s \-\-prefix\ \fIproject\-dir\fR \fImcq\-source\-file\fR
.HP \w'\fBauto\-multiple\-choice\fR\ 'u
\fBauto\-multiple\-choice\fR prepare \-\-mode\ b \-\-data\ \fIproject\-data\-dir\fR \fImcq\-source\-file\fR
.SH "DESCRIPTION"
.PP
The
\fBAMC\-prepare\&.pl\fR
command extracts working documents from the source file describing the multiple choice questionnaire\&. Information to be extracted depends on the
\fB\-\-mode\fR
argument value\&. In any mode, the source filename must be given as an argument\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
with "\fB\-\-mode s\fR",
\fBAMC\-prepare\&.pl\fR
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:
.PP
\fB\-\-out\-sujet \fR\fB\fIsubject\&.pdf\fR\fR
.RS 4
sets the subject file to build\&.
.RE
.PP
\fB\-\-out\-corrige \fR\fB\fIcorrected\&.pdf\fR\fR
.RS 4
sets the correction to build\&.
.RE
.PP
\fB\-\-out\-calage \fR\fB\fIcalage\&.xy\fR\fR
.RS 4
sets the positions file to build\&.
.RE
.PP
\fB\-\-prefix \fR\fB\fIdirectory\fR\fR
.RS 4
this directory is only necessary if one or more of the three previous options are not used: default values are then
\fIdirectory\fR/sujet\&.pdf,
\fIdirectory\fR/corrige\&.pdf
and
\fIdirectory\fR/calage\&.xy\&.
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
with "\fB\-\-mode b\fR",
\fBAMC\-prepare\&.pl\fR
extracts scoring data from the source file\&. In this mode, the
\fB\-\-data\fR
argument must be used (see below)\&.
.RE
.PP
The following optional arguments can be used in any mode:
.PP
\fB\-\-with \fR\fB\fIlatex\-engine\fR\fR
.RS 4
gives the LaTeX engine (command) to be used\&.
\fIlatex\-engine\fR
can be
\fBpdflatex\fR
or
\fBxelatex\fR
for example\&.
.RE
.PP
\fB\-\-filter \fR\fB\fIfilter\fR\fR
.RS 4
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)\&.
.RE
.PP
\fB\-\-filtered\-source \fR\fB\fImcq\-latex\-file\fR\fR
.RS 4
gives the LaTeX file to make from the source file using specified filter\&. If omitted, a filename derived from
\fImcq\-source\-file\fR
adding
_filtered\&.tex
is used\&.
.RE
.PP
\fB\-\-n\-copies \fR\fB\fIn\fR\fR
.RS 4
sets the number of copies to produce, overriding the number given in the LaTeX source file (first argument of the
\fB\eonecopy\fR
command)\&.
.RE
.PP
\fB\-\-debug \fR\fB\fIfile\&.log\fR\fR
.RS 4
gives a file to fill with debugging information\&.
.RE
.PP
\fB\-\-epoch \fR\fB\fIEPOCH\fR\fR
.RS 4
gives an epoch (number of seconds since january 1, 1970) to get a reproducible pdf output\&.
.RE
.PP
\fB\-\-data \fR\fB\fIproject\-data\-dir\fR\fR
.RS 4
sets the directory where the project\*(Aqs SQLite data files are\&.
.RE
.SH "AUTHORS"
.PP
\fBAlexis Bienven\(:ue\fR <\&paamc@passoire.fr\&>
.RS 4
Main author
.RE
.PP
\fBAnirvan Sarkar\fR
.RS 4
Author and Editor
.RE
.PP
\fBHiroto Kagotani\fR
.RS 4
Editor
.RE
.PP
\fBFr\('ed\('eric Br\('eal\fR
.RS 4
Author and Editor
.RE
.PP
\fBJean B\('erard\fR
.RS 4
Translation from French
.RE
.PP
\fBGeorges Khaznadar\fR
.RS 4
Translation from French
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2008-2021 Alexis Bienven\(:ue
.br
.PP
This document can be used according to the terms of the GNU General Public License, version 2 or later.
.sp