解説
auto-multiple-choice
annotateコマンドは、答案に各設問の採点と全体の採点を記入し、PDFファイル（受験者別の複数ファイルか全体の単一ファイル）を出力します。
全般オプション
--project project-dir
プロジェクト名かディレクトリを設定します。
--data project-data-dir
データファイルがあるディレクトリ（デフォルト値はproject-dir/data）を指定します。
--pdf-dir pdf-dir
プロジェクトのpdfディレクトリ（デフォルト値はproject-dir/cr/corrections/pdf）を設定します。
--names-file students-list.csv
受験者名簿ファイル名を設定します。
--names-encoding encoding
students-list.csvのエンコーディング（デフォルトはutf-8）を選択します。
--association-key key
受験者識別に使用するカラム（受験者名簿ファイル内のカラム名）を設定します。識別時に実際に使用した値がデータベースに格納され、これがデフォルト値となるので、このオプションは使用すべきでありません。
--subject subject.pdf
試験問題ファイル（デフォルト値はproject-dir/DOC-sujet.pdf）のパスを設定します。
--compose mode
マークするボックスのないページ（例えば答案用紙より前にある問題のみのページなど）を問題用紙からもってくる場合にこのオプションを使用します。modeが1のときは、問題用紙からページを取得し、受験者の答案と同じようにマークを記入し、同じ採点記号を答案用紙に記入します。modeが2のときは、採点済の答案用紙からページを取得し、（重複するので）採点記号は記入しません。
--corrected corrected.pdf
PDFの模範解答のパス（デフォルトはproject-dir/DOC-corrected.pdf。ファイルが存在しなければ、--n-copies,
--with, --filter,
--filtered-sourceの各オプションの値を用いて作成されます）を設定します。
--darkness-threshold t
黒ピクセル比率の閾値を設定します。採点時に実際に使用した値がデータベースに格納され、これがデフォルト値となるので、このオプションは使用すべきでありません。
--darkness-threshold-up upper_t
黒ピクセル比率の上限の閾値を設定します。採点時に実際に使用した値がデータベースに格納され、これがデフォルト値となるので、このオプションは使用すべきでありません。
--csv-build-name name-model
受験者名簿ファイルから受験者名を構成するためのモデルを設定します。デフォルト値は「(nom|surname)
(prenom|name)」で、この場合、氏名はnomカラム（なければsurnameカラム）の内容の後にprenomカラム（なければnameカラム）の内容を続けたものになり、したがって、フランス語か英語の単純なCSVファイルでたいていうまくいきます。
--id-file ids.txt
採点を記入する答案用紙のID一覧ファイル（個別答案用紙モードなら受験番号、コピー答案用紙モードならstudent:copyを各行に一つ）を指定します。ファイルが指定されない場合は、すべての答案用紙に採点が記入されます。
--debug file.log
デバッグ情報を記録するファイルを指定します。
--single-output
採点済答案を単一のPDFファイルにまとめるにはこのオプションを使用してください。デフォルトの動作は受験者一人につき一つのPDFファイルを作成します。
--sort s
以下のソートキーを設定します（
--single-outputを使用する場合のみ有効）:
l
受験者名簿ファイル順。
m
成績順。
i
試験問題ID順。
n
氏名順。
--filename-model model
採点記入済PDF用のファイル名モデルを設定します。このモデルでは特定のシーケンスが以下のように置換されます:
(N)
は受験者名（--csv-build-name参照）に置換されます。
(ID)
は受験番号に置換されます。
(COL)
は受験者名簿内のCOLカラムの値に置換されます。
デフォルト値は「(N)-(ID).pdf」です。
ソースファイルオプション
以下のオプションは--correctedで指定したファイルが存在せず、そのファイルを再構築するときに使用されます。
--src mcq-source-file --n-copies
n --with latex-engine --filter
filter-name --filtered-source
fs.tex
スキャン画像埋込み用オプション
スキャン画像が存在する場合、採点記入済PDFファイルに埋め込まれます。以下のオプションは埋め込むスキャン画像の品質を制御し、ファイルサイズを縮小できるようにします。
--embedded-max-size maxsize
スキャン画像の最大サイズをピクセル単位で（widthxheightの形式で）設定します。デフォルト値は空で、この場合は上限はありません。指定したサイズより大きいスキャン画像は採点記入済ファイルに埋め込む前に縮小されます。
--embedded-format format
埋込み形式をjpegかpngで設定します。
--embedded-jpeg-quality quality
JPEGで埋め込む場合のJPEG品質を（1から100で）設定します。
採点記入オプション
以下のオプションはどのような採点が記入されるかを制御します。
--font-size fs
フォントサイズをポイント値で設定します。
--text-color color
文字の色を設定します。デフォルト値はredです。
--verdict header
各受験者の答案用紙の先頭ページに表示するテキストヘッダを設定します。このテキストは複数行のヘッダ用に改行文字を含むことができます。以下の特定のシーケンスが置換されます:
%S
は受験者の素点合計に置換されます。
%M
は素点合計の満点に置換されます。
%s
は受験者の得点に置換されます。
%m
は満点に置換されます。
%(ID)
は受験者名に置換されます。
%(COL)
は受験者名簿内のCOLカラムの値に置換されます。
--position pos
各設問の採点記入位置を設定します:
marge
左マージンに記入
marges
（左右いずれかの）近い方のマージンに記入
case
マーク用ボックスの近くに記入
none
採点を記入しない
--verdict-question perl-expression
各設問の隣に印刷されるテキストをperlで評価される式として設定します（単純なテキストが必要なら"で囲んでください）。いくつかのシーケンスは評価の前に置換されます:
%S
はこの設問の素点に置換されます。
%M
はこの設問の満点に置換されます。
%s
は%Sと同じですが、nc桁（--ch-signオプション参照）に丸められます。
%m
は%Mと同じですが、nc桁（--ch-signオプション参照）に丸められます。
このオプションのデフォルト値は「"%s/%m"」です。条件式を（(
TEST ? IF-YES : IF-NO
)というperlの構文を用いて）書くこともできます。満点なら合格、そうでなければ不合格と書くには、次のようにします。
--verdict-question "(%S==%M ? \"合格\" : \"不合格\")"
--verdict-question-cancelled perl-expression
--verdict-questionと同じですが、キャンセルした設問（allowempty採点基準を参照）に適用されます。デフォルト値は「"X"」です。
--indicatives
採点対象外の設問にも採点を記入するにはこのオプションを使用します。（これらの設問の素点は全体の素点を計算する際にはカウントされません。正誤の状態はこれらの設問にたいてい無関係なので、対応するボックスへの正誤マークは記入しません）
--line-width width
採点時に記入する記号の線幅（ピクセル数）を設定します。デフォルト値は2です。
--symbols symbols-definition
はボックスにどのように記号をつけるかを定義します。symbols-definitionは、H-A:shape:colorの形式をカンマで区切ったリストで、Hは0か1でボックスがマークすべきでないかすべきかを表し、Aは0か1でボックスがマークされていないかされているかを表し、shapeはnone、circle、mark、boxのどれか一つであり、colorは色（名前または#RGBで、詳細はImageMagickかGraphicsMagickのドキュメントを参照）を表します。デフォルト値は「0-0:none,0-1:circle:red,1-0:mark:red,1-1:mark:blue」です。
長さ
以下の長さには単位を指定することができます（in,
ft, pt, cm, mm）。
--dist-to-box d
--position
caseを使用する場合に、記入位置のボックスからの距離を設定します。デフォルトは1cmです。
--dist-margin d
マージンのサイズを設定します。デフォルトは5mmです。
--dist-margin-global d
ヘッダーのマージンサイズを設定します。デフォルトは3mmです。
著者
Bienvenue Alexis[FAMILY Given]
<paamc@passoire.fr>
主な著者
Sarkar Anirvan[FAMILY Given]
著者・編集者
Kagotani Hiroto[FAMILY Given]
編集者
Bréal Frédéric[FAMILY Given]
著者・編集者
Bérard Jean[FAMILY Given]
フランス語版から英語版への翻訳
Khaznadar Georges[FAMILY Given]
フランス語版から英語版への翻訳
Kagotani Hiroto[FAMILY Given]
英語版から日本語版への翻訳