'\" t
.\"     Title: AMC-annotate
.\"    Author: Bienven\(:ue Alexis[FAMILY Given] <paamc@passoire.fr>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 2018-12-29
.\"    Manual: Auto Multiple Choice
.\"    Source: Auto Multiple Choice 1.4.0
.\"  Language: Japanese
.\"
.TH "AMC\-ANNOTATE" "1" "2018-12-29" "Auto Multiple Choice 1\&.4\&.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 "名前"
AMC-annotate \- AMC選択式試験問題の答案に採点結果を記入する
.SH "概要"
.HP \w'\fBauto\-multiple\-choice\fR\ 'u
\fBauto\-multiple\-choice\fR annotate \-\-project\ \fIproject\-dir\fR \-\-names\-file\ \fIstudents\&.csv\fR [annotation\ options...]
.SH "解説"
.PP
\fBAMC\-annotate\&.pl\fRコマンドは、答案に各設問の採点と全体の採点を記入し、PDFファイル（受験者別の複数ファイルか全体の単一ファイル）を出力します。
.SS "全般オプション"
.PP
\fB\-\-project \fR\fB\fIproject\-dir\fR\fR
.RS 4
プロジェクト名かディレクトリを設定します。
.RE
.PP
\fB\-\-data \fR\fB\fIproject\-data\-dir\fR\fR
.RS 4
データファイルがあるディレクトリ（デフォルト値は\fIproject\-dir\fR/data）を指定します。
.RE
.PP
\fB\-\-pdf\-dir \fR\fB\fIpdf\-dir\fR\fR
.RS 4
プロジェクトのpdfディレクトリ（デフォルト値は\fIproject\-dir\fR/cr/corrections/pdf）を設定します。
.RE
.PP
\fB\-\-names\-file \fR\fB\fIstudents\-list\&.csv\fR\fR
.RS 4
受験者名簿ファイル名を設定します。
.RE
.PP
\fB\-\-names\-encoding \fR\fB\fIencoding\fR\fR
.RS 4
\fIstudents\-list\&.csv\fRのエンコーディング（デフォルトはutf\-8）を選択します。
.RE
.PP
\fB\-\-association\-key \fR\fB\fIkey\fR\fR
.RS 4
受験者識別に使用するカラム（受験者名簿ファイル内のカラム名）を設定します。識別時に実際に使用した値がデータベースに格納され、これがデフォルト値となるので、このオプションは使用すべきでありません。
.RE
.PP
\fB\-\-subject \fR\fB\fIsubject\&.pdf\fR\fR
.RS 4
試験問題ファイル（デフォルト値は\fIproject\-dir\fR/DOC\-sujet\&.pdf）のパスを設定します。
.RE
.PP
\fB\-\-compose \fR\fB\fImode\fR\fR
.RS 4
マークするボックスのないページ（例えば答案用紙より前にある問題のみのページなど）を問題用紙からもってくる場合にこのオプションを使用します。\fImode\fRが1のときは、問題用紙からページを取得し、受験者の答案と同じようにマークを記入し、同じ採点記号を答案用紙に記入します。\fImode\fRが2のときは、採点済の答案用紙からページを取得し、（重複するので）採点記号は記入しません。
.RE
.PP
\fB\-\-corrected \fR\fB\fIcorrected\&.pdf\fR\fR
.RS 4
PDFの模範解答のパス（デフォルトは\fIproject\-dir\fR/DOC\-corrected\&.pdf。ファイルが存在しなければ、\fB\-\-n\-copies\fR,
\fB\-\-with\fR,
\fB\-\-filter\fR,
\fB\-\-filtered\-source\fRの各オプションの値を用いて作成されます）を設定します。
.RE
.PP
\fB\-\-darkness\-threshold \fR\fB\fIt\fR\fR
.RS 4
黒ピクセル比率の閾値を設定します。採点時に実際に使用した値がデータベースに格納され、これがデフォルト値となるので、このオプションは使用すべきでありません。
.RE
.PP
\fB\-\-darkness\-threshold\-up \fR\fB\fIupper_t\fR\fR
.RS 4
黒ピクセル比率の上限の閾値を設定します。採点時に実際に使用した値がデータベースに格納され、これがデフォルト値となるので、このオプションは使用すべきでありません。
.RE
.PP
\fB\-\-csv\-build\-name \fR\fB\fIname\-model\fR\fR
.RS 4
受験者名簿ファイルから受験者名を構成するためのモデルを設定します。デフォルト値は「(nom|surname) (prenom|name)」で、この場合、氏名はnomカラム（なければsurnameカラム）の内容の後にprenomカラム（なければnameカラム）の内容を続けたものになり、したがって、フランス語か英語の単純なCSVファイルでたいていうまくいきます。
.RE
.PP
\fB\-\-id\-file \fR\fB\fIids\&.txt\fR\fR
.RS 4
採点を記入する答案用紙のID一覧ファイル（個別答案用紙モードなら受験番号、コピー答案用紙モードなら\fIstudent\fR:\fIcopy\fRを各行に一つ）を指定します。ファイルが指定されない場合は、すべての答案用紙に採点が記入されます。
.RE
.PP
\fB\-\-debug \fR\fB\fIfile\&.log\fR\fR
.RS 4
デバッグ情報を記録するファイルを指定します。
.RE
.SS "PDF出力オプション"
.PP
\fB\-\-single\-output\fR
.RS 4
採点済答案を単一のPDFファイルにまとめるにはこのオプションを使用してください。デフォルトの動作は受験者一人につき一つのPDFファイルを作成します。
.RE
.PP
\fB\-\-sort \fR\fB\fIs\fR\fR
.RS 4
以下のソートキーを設定します（\fB\-\-single\-output\fRを使用する場合のみ有効）:
.PP
l
.RS 4
受験者名簿ファイル順。
.RE
.PP
m
.RS 4
成績順。
.RE
.PP
i
.RS 4
試験問題ID順。
.RE
.PP
n
.RS 4
氏名順。
.RE
.RE
.PP
\fB\-\-filename\-model \fR\fB\fImodel\fR\fR
.RS 4
採点記入済PDF用のファイル名モデルを設定します。このモデルでは特定のシーケンスが以下のように置換されます:
.PP
(N)
.RS 4
は受験者名（\fB\-\-csv\-build\-name\fR参照）に置換されます。
.RE
.PP
(ID)
.RS 4
は受験番号に置換されます。
.RE
.PP
(\fICOL\fR)
.RS 4
は受験者名簿内の\fICOL\fRカラムの値に置換されます。
.RE
.sp
デフォルト値は「(N)\-(ID)\&.pdf」です。
.RE
.SS "ソースファイルオプション"
.PP
以下のオプションは\fB\-\-corrected\fRで指定したファイルが存在せず、そのファイルを再構築するときに使用されます。
.PP
\fB\-\-src \fR\fB\fImcq\-source\-file\fR\fR\fB \-\-n\-copies \fR\fB\fIn\fR\fR\fB \-\-with \fR\fB\fIlatex\-engine\fR\fR\fB \-\-filter \fR\fB\fIfilter\-name\fR\fR\fB \-\-filtered\-source \fR\fB\fIfs\&.tex\fR\fR
.RS 4
\fBAMC-prepare\fR(1)を参照してください。
.RE
.SS "スキャン画像埋込み用オプション"
.PP
スキャン画像が存在する場合、採点記入済PDFファイルに埋め込まれます。以下のオプションは埋め込むスキャン画像の品質を制御し、ファイルサイズを縮小できるようにします。
.PP
\fB\-\-embedded\-max\-size \fR\fB\fImaxsize\fR\fR
.RS 4
スキャン画像の最大サイズをピクセル単位で（\fIwidth\fRx\fIheight\fRの形式で）設定します。デフォルト値は空で、この場合は上限はありません。指定したサイズより大きいスキャン画像は採点記入済ファイルに埋め込む前に縮小されます。
.RE
.PP
\fB\-\-embedded\-format \fR\fB\fIformat\fR\fR
.RS 4
埋込み形式を\fIjpeg\fRか\fIpng\fRで設定します。
.RE
.PP
\fB\-\-embedded\-jpeg\-quality \fR\fB\fIquality\fR\fR
.RS 4
JPEGで埋め込む場合のJPEG品質を（1から100で）設定します。
.RE
.SS "採点記入オプション"
.PP
以下のオプションはどのような採点が記入されるかを制御します。
.PP
\fB\-\-font\-size \fR\fB\fIfs\fR\fR
.RS 4
フォントサイズをポイント値で設定します。
.RE
.PP
\fB\-\-text\-color \fR\fB\fIcolor\fR\fR
.RS 4
文字の色を設定します。デフォルト値は\fIred\fRです。
.RE
.PP
\fB\-\-verdict \fR\fB\fIheader\fR\fR
.RS 4
各受験者の答案用紙の先頭ページに表示するテキストヘッダを設定します。このテキストは複数行のヘッダ用に改行文字を含むことができます。以下の特定のシーケンスが置換されます:
.PP
%S
.RS 4
は受験者の素点合計に置換されます。
.RE
.PP
%M
.RS 4
は素点合計の満点に置換されます。
.RE
.PP
%s
.RS 4
は受験者の得点に置換されます。
.RE
.PP
%m
.RS 4
は満点に置換されます。
.RE
.PP
%(ID)
.RS 4
は受験者名に置換されます。
.RE
.PP
%(\fICOL\fR)
.RS 4
は受験者名簿内の\fICOL\fRカラムの値に置換されます。
.RE
.RE
.PP
\fB\-\-position \fR\fB\fIpos\fR\fR
.RS 4
各設問の採点記入位置を設定します:
.PP
marge
.RS 4
左マージンに記入
.RE
.PP
marges
.RS 4
（左右いずれかの）近い方のマージンに記入
.RE
.PP
case
.RS 4
マーク用ボックスの近くに記入
.RE
.PP
none
.RS 4
採点を記入しない
.RE
.RE
.PP
\-\-verdict\-question \fIperl\-expression\fR
.RS 4
各設問の隣に印刷されるテキストをperlで評価される式として設定します（単純なテキストが必要なら"で囲んでください）。いくつかのシーケンスは評価の前に置換されます:
.PP
%S
.RS 4
はこの設問の素点に置換されます。
.RE
.PP
%M
.RS 4
はこの設問の満点に置換されます。
.RE
.PP
%s
.RS 4
は%Sと同じですが、\fInc\fR桁（\fB\-\-ch\-sign\fRオプション参照）に丸められます。
.RE
.PP
%m
.RS 4
は%Mと同じですが、\fInc\fR桁（\fB\-\-ch\-sign\fRオプション参照）に丸められます。
.RE
.sp
このオプションのデフォルト値は「"%s/%m"」です。条件式を（( TEST ? IF\-YES : IF\-NO )というperlの構文を用いて）書くこともできます。満点なら\fI合格\fR、そうでなければ\fI不合格\fRと書くには、次のようにします。
.sp
.if n \{\
.RS 4
.\}
.nf
\-\-verdict\-question "(%S==%M ? \e"合格\e" : \e"不合格\e")"
.fi
.if n \{\
.RE
.\}
.RE
.PP
\-\-verdict\-question\-cancelled \fIperl\-expression\fR
.RS 4
\fB\-\-verdict\-question\fRと同じですが、キャンセルした設問（allowempty採点基準を参照）に適用されます。デフォルト値は「"X"」です。
.RE
.PP
\fB\-\-indicatives\fR
.RS 4
採点対象外の設問にも採点を記入するにはこのオプションを使用します。（これらの設問の素点は全体の素点を計算する際にはカウントされません。正誤の状態はこれらの設問にたいてい無関係なので、対応するボックスへの正誤マークは記入しません）
.RE
.PP
\fB\-\-line\-width \fR\fB\fIwidth\fR\fR
.RS 4
採点時に記入する記号の線幅（ピクセル数）を設定します。デフォルト値は2です。
.RE
.PP
\fB\-\-symbols \fR\fB\fIsymbols\-definition\fR\fR
.RS 4
はボックスにどのように記号をつけるかを定義します。\fIsymbols\-definition\fRは、\fIH\fR\-\fIA\fR:\fIshape\fR:\fIcolor\fRの形式をカンマで区切ったリストで、\fIH\fRは0か1でボックスがマークすべきでないかすべきかを表し、\fIA\fRは0か1でボックスがマークされていないかされているかを表し、\fIshape\fRはnone、circle、mark、boxのどれか一つであり、\fIcolor\fRは色（名前または#RGBで、詳細はImageMagickかGraphicsMagickのドキュメントを参照）を表します。デフォルト値は「0\-0:none,0\-1:circle:red,1\-0:mark:red,1\-1:mark:blue」です。
.RE
.SS "長さ"
.PP
以下の長さには単位を指定することができます（in,
ft,
pt,
cm,
mm）。
.PP
\fB\-\-dist\-to\-box \fR\fB\fId\fR\fR
.RS 4
\fB\-\-position case\fRを使用する場合に、記入位置のボックスからの距離を設定します。デフォルトは1cmです。
.RE
.PP
\fB\-\-dist\-margin \fR\fB\fId\fR\fR
.RS 4
マージンのサイズを設定します。デフォルトは5mmです。
.RE
.PP
\fB\-\-dist\-margin\-global \fR\fB\fId\fR\fR
.RS 4
ヘッダーのマージンサイズを設定します。デフォルトは3mmです。
.RE
.SH "著者"
.PP
\fBBienven\(:ue Alexis[FAMILY Given]\fR <\&paamc@passoire.fr\&>
.RS 4
主な著者
.RE
.PP
\fBSarkar Anirvan[FAMILY Given]\fR
.RS 4
著者・編集者
.RE
.PP
\fBKagotani Hiroto[FAMILY Given]\fR
.RS 4
編集者
.RE
.PP
\fBBr\('eal Fr\('ed\('eric[FAMILY Given]\fR
.RS 4
著者・編集者
.RE
.PP
\fBB\('erard Jean[FAMILY Given]\fR
.RS 4
フランス語版から英語版への翻訳
.RE
.PP
\fBKhaznadar Georges[FAMILY Given]\fR
.RS 4
フランス語版から英語版への翻訳
.RE
.PP
\fBKagotani Hiroto[FAMILY Given]\fR
.RS 4
英語版から日本語版への翻訳
.RE
.SH "製作著作"
.br
製作著作 \(co 2008-2018 Alexis Bienven\(:ue
.br
.PP
この文書はGNU一般公衆利用許諾書バージョン2またはそれ以降に従って利用することができます。
.sp