AUTO-MULTIPLE-CHOI(1)

💖 AUTO-MULTIPLE-CHOI(1) — the auto-multiple-choice-export page 💖

okay bestie, so this is the manual page for auto-multiple-choice-export, which lives inside the Auto Multiple Choice (AMC) world. If you've ever needed to yank marks out of a multiple choice exam and put them literally anywhere else, this is your girl. let's get into it 💅

---

✨ NAME ✨

auto-multiple-choice-export — exports marks for AMC multiple choice exams. no cap, that's the whole job. 📝

---

🦋 SYNOPSIS 🦋

auto-multiple-choice export --data project-data-dir --module module
                     --fich-noms students-list.csv
                     [--noms-encodage list-encoding] --o output-file

look at that little [--noms-encodage list-encoding] sitting there in brackets — that's the optional one, everything else is required. iykyk 🌸

---

💜 DESCRIPTION 💜

The auto-multiple-choice export command exports marks from an Auto Multiple Choice exam. that's it. that's the vibe. but here's every single knob you can turn, and bestie, we are turning all of them:

• --data project-data-dir — points at the directory where the data files live (peep auto-multiple-choice-prepare(1) if you're confused about where those came from).
• --module module — picks which module does the exporting. the modules that ship with the standard AMC distribution are listed below, keep scrolling 🫶
• --fich-noms students-list.csv — sets the students list file. this is who we're exporting for, periodt.
• --noms-encodage list-encoding — picks the encoding for the file students-list.csv. the default is utf-8.
• --o output-file — gives the output file name. where the goodies go.
• --option-out options — gives an option for the selected module, written in the form key=value (each module's possible options are listed below). and if you want more than one option? just use --option several times. stack 'em. 👑
• --sort sort-type — sorts the students names, and it depends on sort-type, so listen up:
  • if sort-type is l, it sorts using the line number from the students list file.
  • if sort-type is m, it sorts using the mark (and then the name if marks are equal).
  • if sort-type is i, it sorts using the student number.
  • if sort-type is n, it sorts using the name (or the line from the students list if those are equal).
• --useall all — if all is 0 or empty, only students with a scanned answer sheet show up in the output. if all is 1, then literally every student in the students list appears in the output. everyone gets a seat at the table 💖

---

🌈 MODULES 🌈

📄 OpenDocument

With --module ods, an OpenDocument gets produced (for use by OpenOffice or LibreOffice, for example). here are the options it recognizes:

• nom — gives a name for the exam, to be written on the beginning of the sheet.
• code — gives a 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 options it recognizes:

• 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 columns (default is a comma).
• entoure — sets the character used to enclose strings (default is a double quote).
• ticked — if not empty, additional columns (with the 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. obsessed with how specific that is 😭

📃 List

With --module List, a PDF file is produced with a list of marks for all students. the options it recognizes:

• 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 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 ⭐

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.

---

and that's the whole page, bestie! 💖 this was Auto Multiple Choice version 1.7.0, dated 2025-04-17 — go forth and export those marks, you absolute main character 🌟