AUTO-MULTIPLE-CHOI(1)

📦
version 1.7.0 · 3 versions
, in arch rolling, debian trixie, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

🌸 AUTO-MULTIPLE-CHOI(1) 🌸

okay bestie, welcome to the Auto Multiple Choice corner of the man pages 💖 this is page AUTO-MULTIPLE-CHOI(1) and today we're hyperfixating on one very specific little command, so grab a strawberry and let's go 🍓

✨ NAME ✨

auto-multiple-choice-prepare — she prepares working documents from a LaTeX source file. that's it, that's the job, and she eats every single time 💅

✨ 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

two moods, two modes, same icon energy 👑

✨ DESCRIPTION ✨

so the auto-multiple-choice prepare command extracts working documents out of the source file that describes your multiple choice questionnaire. what exactly she pulls out? depends on the value you give to the --mode argument. but in any mode, no cap, the source filename has to be given as an argument. literally non-negotiable 🫶

  • with "--mode s", auto-multiple-choice prepare makes three things: the subject file (that's the answer sheet you print and hand to the students), the correction (a single corrected answer sheet), and the positions file (the file holding the info about where all the boxes sit on the pages). these following arguments are available to you:
    • --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: the default values are then directory/sujet.pdf, directory/corrige.pdf and directory/calage.xy.
  • with "--mode b", auto-multiple-choice prepare extracts scoring data from the source file. in this mode you must use the --data argument (see below). no skipping it bestie 😭

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 example.
  • --filter filter — sets the filter name used to transform the MCQ source file into a LaTeX file. the native filters are latex (no change at all) and plain (the source is an AMC-TXT file).
  • --filtered-source mcq-latex-file — gives the LaTeX file to make from the source file using the specified filter. if you omit it, a filename derived from mcq-source-file with _filtered.tex added is used.
  • --n-copies n — sets the number of copies to produce, overriding the number given in the LaTeX source file (that's the first argument of the \onecopy command).
  • --debug file.log — gives a file to fill with debugging information.
  • --epoch EPOCH — gives an epoch (number of seconds since january 1, 1970) to get a reproducible pdf output. time travel but make it reproducible ✨
  • --data project-data-dir — sets the directory where the project's SQLite data files are.

✨ AUTHORS ✨

the whole group chat, assemble 🫶

  • Alexis Bienvenüe <paamc@passoire.fr> — Main author 👑
  • Anirvan Sarkar — Author and Editor
  • Hiroto Kagotani — Editor
  • Frédéric Bréal — Author and Editor
  • Jean Bérard — Translation from French
  • Georges Khaznadar — Translation from French

Copyright © 2008-2025 Alexis Bienvenüe

this document can be used according to the terms of the GNU General Public License, version 2 or later.

okay that's the whole page, you read all of it, I'm so proud of you 😭💖 go make some pretty answer sheets bestie, main character energy only.

Auto Multiple Choice 1.7.0 — 2025-04-17 — mwah, that's the version and the date, periodt 💅✨

📦 where this page comes from