<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>AMC-TXT syntax</title><link rel="stylesheet" type="text/css" href="../style.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="home" href="index.html" title="Auto Multiple Choice" /><link rel="up" href="index.html" title="Auto Multiple Choice" /><link rel="prev" href="usagenotes.html" title="Usage notes" /><link rel="next" href="latex.html" title="LaTeX source file" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">AMC-TXT syntax</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="usagenotes.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="latex.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="AMC-TXT"></a>AMC-TXT syntax</h2></div></div></div><p>For users who are not ready to learn LaTeX (if not already familiar
with this language), AMC includes a filter to process simple plain text
files in a particular format, named AMC-TXT. This section is devoted to
detail the syntax of AMC-TXT files. If you prefer use LaTeX to gain a
fine-control over your questionnaires, skip to next section.</p><p>Let us begin with a simple example:</p><a id="modeles-simple-txt.txt"></a><pre class="programlisting"># AMC-TXT source file
Title: My first AMC questionnaire
Presentation: Please answer the following questions
the best you can.
* What is the capital city of Cameroon?
+ Yaounde
- Douala
- Kribi
** From the following numbers, which are positive?
- -2
+ 2
+ 10</pre><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Important"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="../images/important.png" /></td><th align="left">Important</th></tr><tr><td align="left" valign="top"><p>The file that contains your questionnaire must be a plain text
file, UTF-8 encoded. This is the default encoding of several text
editors, like <span class="command"><strong>gedit</strong></span>. Don't use a text editor that can
format your text with bold, images, and so on, like
OpenOffice/LibreOffice, or equivalent: these save your text with a lot
of other data, and AMC won't be able to read it.</p></td></tr></table></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>The default font that will be used is <a class="ulink" href="http://www.linuxlibertine.org/" target="_top">libertine</a>, an open source
font that contains characters for a lot of languages. You have to
install this font or choose another one (see options below). If you
install AMC with a debian/ubuntu package, this font will be install
together as a recommended package.</p></td></tr></table></div><p>You already understand AMC-TXT structure: some general options
first, and then questions.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="txt.comments"></a>Comments</h3></div></div></div><p>You can write some comments inside your AMC-TXT source file in
lines <span class="emphasis"><em>beginning</em></span> with a `<code class="code">#</code>'. These
lines won't be considered by AMC.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="txt.opts"></a>General options</h3></div></div></div><p>Here are the options you can use (in any order):</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">Lang:</span></dt><dd><p>use it to specify a language the questionnaire is written
in. At present, only DE (German), ES (Spanish), FR (French), IT
(Italian), NL (Dutch), NO (Norwegian), PT (portuguese), JA
(Japanese, see <a class="xref" href="AMC-TXT.html#txt-japanese" title="Japanese language">the section called “Japanese language”</a>) and AR (Arabic, see
<a class="xref" href="AMC-TXT.html#txt-arabic" title="Arabic language">the section called “Arabic language”</a>) are supported. Without this option,
English will be selected. You can also define the localized string
used for another language (see the <code class="option">L-xxx</code>
options).</p></dd><dt><span class="term">PaperSize:</span></dt><dd><p>Sets the paper size. Possible values are <code class="code">A3</code>,
<code class="code">A4</code>, <code class="code">A5</code>, <code class="code">A6</code>,
<code class="code">B3</code>, <code class="code">B4</code>, <code class="code">B5</code>,
<code class="code">B6</code>, <code class="code">letter</code>, <code class="code">legal</code>,
<code class="code">ANSIA</code>, <code class="code">ANSIB</code>, <code class="code">ANSIC</code>,
<code class="code">ANSID</code>, <code class="code">ANSIE</code>.</p></dd><dt><span class="term">Title:</span></dt><dd><p>The exam title, written on top of the sheet.</p></dd><dt><span class="term">Presentation:</span></dt><dd><p>A text that presents the exam (length, rules...).</p></dd><dt><span class="term">ShuffleQuestions:</span></dt><dd><p>If 1 (default), questions will be shuffled so that their
order is different from one sheet to the other. If 0, the
questions will always show with the same order as in your
file.</p></dd><dt><span class="term">RandomSeed:</span></dt><dd><p>One can modify the seed of the random number generator used
to produce the shuffle, thanks to the option. If the value that is
assigned ( to be chosen between 1 and 4194303) is modified, then
the shuffling will differ. Of course, one must not modify this
value after the test sheets have been printed.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>The value is recorded in the xy file (as
<code class="code">\rngstate{1}{1527384}</code>). The default value is equal
to 1527384.</p></td></tr></table></div></dd><dt><span class="term">Code:</span></dt><dd><p>Give a positive integer value <em class="replaceable"><code>n</code></em>
to add boxes so that students will be able to code their student
number on their sheets, with <em class="replaceable"><code>n</code></em>
digits.</p></dd><dt><span class="term">CodeDigitsDirection:</span></dt><dd><p>Sets the direction for code's digits boxes (either
<code class="code">vertical</code> or <code class="code">horizontal</code>). If unset, AMC
will choose the direction from the number of digits (horizontal
for small number of digits, and vertical for high number of
digits).</p></dd><dt><span class="term">Columns:</span></dt><dd><p>Give a positive integer value <em class="replaceable"><code>n</code></em>
to get a subject with <em class="replaceable"><code>n</code></em> columns.</p></dd><dt><span class="term">CompleteMulti:</span></dt><dd><p>If 1 (default), for multiple questions (those for which
zero, one or several answers are correct), an answer "None of
these answers are correct" will be added. Without it, it should be
impossible to make a difference between "the student didn't answer
for this question" and "the student thinks no answer is correct
for this question". If you don't want this answer to be added, set
this option to 0.</p></dd><dt><span class="term">L-None:</span></dt><dd><p>Give a string to replace <span class="emphasis"><em>None of these answers are
correct</em></span> (see previous option).</p></dd><dt><span class="term">QuestionBlocks:</span></dt><dd><p>If 1 (default), all questions will be enclosed in a
invisible frame that prevents it to be split across several
columns or pages. If 0, questions are allowed to be split if
necessary: that can save pages at the cost of readability.</p></dd><dt><span class="term">L-Question:</span></dt><dd><p>Give a translation of <span class="emphasis"><em>Question</em></span> in your
questionnaire, if you need.</p></dd><dt><span class="term">L-Name:</span></dt><dd><p>Give a translation of <span class="emphasis"><em>Name and surname</em></span>,
a text written in the box where students are to write their
identity.</p></dd><dt><span class="term">L-Student:</span></dt><dd><p>Small text that asks students to code their student numbers
and write their name, when <code class="option">Code</code> option is
used.</p></dd><dt><span class="term">TitleWidth:</span></dt><dd><p>Width of the title zone, when <code class="option">Code:</code> is not
used. Default value is <code class="code">.47\linewidth</code>.</p></dd><dt><span class="term">NameFieldWidth:</span></dt><dd><p>Width of the name field part. Usual LaTeX dimensions can be
used. The default value is <code class="code">5.8cm</code> when
<code class="option">Code:</code> is used, and <code class="code">.47\linewidth</code>
without <code class="option">Code:</code>.</p></dd><dt><span class="term">NameFieldLines:</span></dt><dd><p>Number of lines in the name field box. Default is
<code class="code">2</code> when <code class="option">Code:</code> is used, and
<code class="code">1</code> otherwise.</p></dd><dt><span class="term">NameFieldLinespace:</span></dt><dd><p>Line space in the name field box. Defaut value is
<code class="code">.5em</code>.</p></dd><dt><span class="term">Pages:</span></dt><dd><p>Gives a minimal number of pages for each question sheet. If
a question has less pages, some white pages will be added. When
using a separate answer sheet, this option can be written
<code class="option"><em class="replaceable"><code>q</code></em>+<em class="replaceable"><code>a</code></em></code>
(eg. <code class="option">4+2</code>), where <em class="replaceable"><code>q</code></em>
will be the minimum number of pages for the question itself, and
<em class="replaceable"><code>q</code></em>+<em class="replaceable"><code>a</code></em> the
minimum number of pages for the whole sheet.</p></dd><dt><span class="term">ManualDuplex:</span></dt><dd><p>If 1 (this is not the default value), each subject will
consist of an even number of pages, so that the user can manually
print the PDF subject for all students in one go in duplex
mode.</p></dd><dt><span class="term">SingleSided:</span></dt><dd><p>If 1 (this is not the default value), no blank page will be
added between the question and the separate answer sheet, even if
the question has an odd number of pages. This mode can be useful
when the subjects are printed single-sided, or when it is not
necessary to separate question and answer sheet.</p></dd><dt><span class="term">BoxColor:</span></dt><dd><p>Color of the boxes to be filled by the students. This allows
to print the boxes with some color that won't disturb too much the
data capture (for example <span class="emphasis"><em>red</em></span>, but some light
gray can also be considered). The color has to be given as a valid
<span class="command"><strong>xcolor</strong></span> color (see <span class="command"><strong>xcolor</strong></span>
LaTeX package documentation for details), such as
<span class="emphasis"><em>red</em></span>, <span class="emphasis"><em>magenta</em></span>,
<span class="emphasis"><em>pink</em></span>, <span class="emphasis"><em>lightgray</em></span>,
<span class="emphasis"><em>cyan</em></span>, or in the form <code class="code">#RRGGBB</code>,
like <code class="code">#FFBEC8</code> for some light red.</p></dd><dt><span class="term">DefaultScoringS:</span></dt><dd><p>Default scoring strategy for simple questions (questions for
which one and only one answer is correct). See <a class="xref" href="graphical-interface.html#bareme" title="Scoring strategy">the section called “Scoring strategy”</a> for details. The default value gives one point
for the right answer, and zero for others.</p></dd><dt><span class="term">DefaultScoringM:</span></dt><dd><p>Default scoring strategy for multiple questions (questions
for which there can be zero, one or several correct answers). See
<a class="xref" href="graphical-interface.html#bareme" title="Scoring strategy">the section called “Scoring strategy”</a> for details. The default value is
<code class="code">haut=2</code>, so that a perfect answer gives 2 points, and
each error (ticking a box that should not be ticked, or leaving a
box that should be ticked unticked) takes one point off (keeping
the score non-negative).</p></dd><dt><span class="term">LaTeX:</span></dt><dd><p>Set this option to 1 if you want to use LaTeX commands in
your texts. This allows for example to insert mathematical
formulas, like <code class="code">$\sqrt{a+b}$</code>. If 0 (default), all your
texts will be written unmodified.</p></dd><dt><span class="term">LaTeX-Preambule:</span></dt><dd><p>Give commands you want to be added to the LaTeX preambule
(for example <span class="command"><strong>\usepackage</strong></span> commands).</p></dd><dt><span class="term">LaTeX-BeginDocument:</span></dt><dd><p>Give commands to be inserted at the beginning of the LaTeX
<span class="command"><strong>document</strong></span> environment (for example macro
definitions).</p></dd><dt><span class="term">Disable:</span></dt><dd><p>Gives a comma-separated list of features to disable. Current
implemented features are <code class="code">verbatim</code> (see <a class="xref" href="AMC-TXT.html#parse_verbatim" title="Verbatim content">the section called “Verbatim content”</a>), <code class="code">images</code> (see <a class="xref" href="AMC-TXT.html#parse_images" title="Images">the section called “Images”</a>), <code class="code">embf</code> (see <a class="xref" href="AMC-TXT.html#parse_embf" title="Bold, italic, typewriter, underlined">the section called “Bold, italic, typewriter, underlined”</a>) and <code class="code">local_latex</code> (see <a class="xref" href="AMC-TXT.html#parse_local_latex" title="Pieces of LaTeX code">the section called “Pieces of LaTeX code”</a>).</p></dd><dt><span class="term">PackageOptions:</span></dt><dd><p>Gives some more options to pass to the automultiplechoice
LaTeX package (see <a class="xref" href="latex.html#sec.package.options" title="Package options">the section called “Package options”</a>.</p></dd></dl></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="txt.separate"></a>Separate answer sheet</h4></div></div></div><p>To use separate answer sheets for your questionnaire, consider
the following options:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">SeparateAnswerSheet:</span></dt><dd><p>If 1, a separate answer sheet will be added.</p></dd><dt><span class="term">AnswerSheetTitle:</span></dt><dd><p>Title of the answer sheet.</p></dd><dt><span class="term">AnswerSheetPresentation:</span></dt><dd><p>Presentation of the answer sheet. For example, remind the
students that the answers are to be given on this sheet
<span class="emphasis"><em>only</em></span>.</p></dd><dt><span class="term">AnswerSheetColumns:</span></dt><dd><p>Number of columns for the answer sheet.</p></dd><dt><span class="term">AutoMarks:</span></dt><dd><p>If 1, uses <code class="option">automarks</code> option (see <a class="xref" href="latex.html#sec.package.options" title="Package options">the section called “Package options”</a>).</p></dd></dl></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="txt.questions"></a>Questions</h3></div></div></div><p>Simple questions (questions for which one and only one answer is
correct) begin with a <code class="code">*</code> at the beginning of the line, and
multiple questions (questions for which there can be zero, one or
several correct answers) begin with a <code class="code">**</code>. Insert then the
question itself, and the choices, introduced with a <code class="code">+</code> for
correct ones and with a <code class="code">-</code> for wrong ones.</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="txt.questions.opts"></a>Questions options</h4></div></div></div><p>Some options are available for questions. They must be separated
by commas and enclosed by square brackets just after the leading
<code class="code">*</code>'s, as in the following example:</p><pre class="programlisting">*[ordered,horiz,id=sum] How much are
one plus one?
- 0
- 1
+ 2</pre><p>Available options for questions:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">horiz</span></dt><dd><p>present choices horizontally, not on separated
lines.</p></dd><dt><span class="term">columns=<em class="replaceable"><code>n</code></em></span></dt><dd><p>make <em class="replaceable"><code>n</code></em> columns for the
choices.</p></dd><dt><span class="term">ordered</span></dt><dd><p>don't shuffle the choices, keep the same order as in the
description file.</p></dd><dt><span class="term">id=<em class="replaceable"><code>xxxx</code></em></span></dt><dd><p>Give a name to the question, so as to locate the
corresponding results easily in the exported spreadsheets. This
name must contain only simple characters, without accents and
LaTeX special characters such as <code class="code">_</code>, <code class="code">^</code>,
<code class="code">%</code>...</p><p><code class="option">name</code> can also be used instead of
<code class="option">id</code> for compatibility with old versions, but you
should prefer using <code class="option">id</code>.</p></dd><dt><span class="term">indicative</span></dt><dd><p>don't use this question score to compute the global
student's score.</p></dd><dt><span class="term">next</span></dt><dd><p>Use this option if you want the question to stay next to
the previous one, even when using questions shuffling with
<code class="option">ShuffleQuestions</code> general option.</p></dd><dt><span class="term">first</span></dt><dd><p>Use this option to place the question always at the
beginning of the group (see <a class="xref" href="AMC-TXT.html#sec.txt-groups" title="Questions groups">the section called “Questions groups”</a>).</p></dd><dt><span class="term">last</span></dt><dd><p>Use this option to place the question always at the end of
the group (see <a class="xref" href="AMC-TXT.html#sec.txt-groups" title="Questions groups">the section called “Questions groups”</a>).</p></dd></dl></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="txt.questions.scoring"></a>Scoring strategy</h4></div></div></div><p>You can set the scoring strategy for a particular question or
choice enclosing it with braces just after the leading characters
(<code class="code">*</code>, <code class="code">**</code>, <code class="code">+</code> or <code class="code">-</code>)
and the possible options, as in the following example. See <a class="xref" href="graphical-interface.html#bareme" title="Scoring strategy">the section called “Scoring strategy”</a> for details about the scoring strategy
syntax.</p><pre class="programlisting">*{b=2,m=-1} What is the capital city of France?
+ Paris
- Lille
- Marseille
- Ouagadougou
-{-2} New York
**[ordered,horiz,id=positive]{haut=1} From the following numbers, which are positive?
- -2
+ 2
+ 10
</pre></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="txt.questions.open"></a>Open questions</h4></div></div></div><p>You can define open question giving options (see <a class="xref" href="latex.html#openquestions" title="Open questions">the section called “Open questions”</a>) enclosed with <code class="code"><</code> and
<code class="code">></code>, as in the following example:</p><pre class="programlisting">*<lines=4> Describe the moon.
-[O]{0} O
-[P]{1} P
+[V]{2} V</pre><p>You should also consider using the following global
options:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">L-OpenText:</span></dt><dd><p>Text used to tell the student to write the answer on the
separate answer sheet (if relevant).</p></dd><dt><span class="term">L-OpenReserved:</span></dt><dd><p>Text to be written along the open questions boxes to tell
the student not to consider these boxes.</p></dd></dl></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="txt.multiline"></a>Multi-line</h3></div></div></div><p>You can always continue some text on the next lines (even if some
of them are empty), provided that these following lines cannot be
considered as the beginning of an option definition, of a question or of
a choice. As an example, consider the following question:</p><pre class="programlisting">* How much are 2
+ 2?
- 0
+ 4
- 10</pre><p>This is a correct AMC-TXT question. However, it won't be treated
as you'd like to, because here the second line is not considered as
being the following of the first one, but form the first choice of the
question!</p><p>A similar problem arises from the following AMC-TXT question,
where `<code class="code">Gershwin:</code>' is considered as a general option
definition...</p><pre class="programlisting">* You all know Georges
Gershwin: he is a composer.
When was he born?
+ in 1898
- in 1892
- in 1902</pre><p>This is a correct way to write it:</p><pre class="programlisting">* You all know Georges Gershwin:
he is a composer.
When was he born?
+ in 1898
- in 1892
- in 1902</pre><p>Note that line breaks can be inserted leaving an empty line,
as:</p><pre class="programlisting">Presentation: Title
Description of the exam.
** Difficult question.
How many stars in the sky?
- one
- two
- ten millions</pre></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="txt.title"></a>Title</h3></div></div></div><p>To get a title, enclose it between <code class="code">[==</code> and
<code class="code">==]</code>.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="parse_verbatim"></a>Verbatim content</h3></div></div></div><p>To get a <span class="emphasis"><em>verbatim</em></span> block (as computer code),
enclose it between <code class="code">[verbatim]</code> and
<code class="code">[/verbatim]</code>:</p><pre class="programlisting">* What does this program print?
[verbatim]
main( )
{
printf("hello, world\n");
}
[/verbatim]
+ [| hello, world |]
- [| hello |]
- [| world |]</pre></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="parse_embf"></a>Bold, italic, typewriter, underlined</h3></div></div></div><p>To get <span class="emphasis"><em>bold</em></span> text, enclose it between
<code class="code">[*</code> and <code class="code">*]</code>. To get <span class="emphasis"><em>italic</em></span>
text, enclose it between <code class="code">[_</code> and <code class="code">_]</code>. To get
<span class="emphasis"><em>typewriter</em></span> text, enclose it between <code class="code">[|</code>
and <code class="code">|]</code>. To get <span class="emphasis"><em>underlined</em></span> text,
enclose it between <code class="code">[/</code> and <code class="code">/]</code>.</p><pre class="programlisting">* What is the [*capital city*] of [_France_]?
+ Paris
- Lille
- Marseille</pre></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="parse_images"></a>Images</h3></div></div></div><p>You can add images in your document using the following
syntax:</p><pre class="programlisting">![height=2cm]images/bird.png!</pre><p>Here, the image <code class="filename">images/bird.png</code> that is
located in the project directory will be appended with 2cm height.
Options that can be used inside the square brackets are those from the
<span class="command"><strong>\includegraphics</strong></span> LaTeX command
(<em class="parameter"><code>width=3cm</code></em> or
<em class="parameter"><code>keepaspectratio</code></em> for example). To get a centered
image that is three quarters of the line width, use</p><pre class="programlisting">!{center}[width=.75\linewidth]images/map.pdf!</pre></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="parse_local_latex"></a>Pieces of LaTeX code</h3></div></div></div><p>You can include some small parts of LaTeX code in your document,
including it in double square brackets, as in:</p><pre class="programlisting">Questions with a [[\multiSymbole{}]] may have zero, one or more right answers.</pre></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sec.txt-groups"></a>Questions groups</h3></div></div></div><p>You can group some question so that they stay together even when
shuffling, with the following syntax:</p><pre class="programlisting">*( Questions about Martin Luther King.
* When was he born?
- in 1901
+ in 1929
- in 1968
* When did he die?
- in 1945
- in 1515
+ in 1968
- in 1999
* Where was he born?
+ Atlanta
- Memphis
- New York
*) End of questions on Martin Luther King. </pre><p>You can specify some options on groups, like:</p><pre class="programlisting">*([shuffle=false,columns=2] Questions about Martin Luther King.</pre><p>The following options are available:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">shuffle=<em class="replaceable"><code>xxx</code></em></span></dt><dd><p>Give <em class="replaceable"><code>true</code></em> or
<em class="replaceable"><code>false</code></em> to tell if you want to shuffle
the questions inside the group. The default value if the global
one, from the <code class="option">ShuffleQuestions</code> option.</p></dd><dt><span class="term">columns=<em class="replaceable"><code>n</code></em></span></dt><dd><p>Number of columns for the group's questions.</p></dd><dt><span class="term">group=<em class="replaceable"><code>nom</code></em></span></dt><dd><p>Give a name for the group (for internal matter).</p></dd><dt><span class="term">numquestions=<em class="replaceable"><code>n</code></em></span></dt><dd><p>With this option, only the first
<em class="replaceable"><code>n</code></em> questions of the group will be used.
If the questions are shuffled, this allows to get
<em class="replaceable"><code>n</code></em> questions chosen at random from the
group.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>Question with option <code class="option">first</code> or
<code class="option">last</code> are not affected (they are always
inserted). Moreover, questions stuck together with option
<code class="option">next</code> count as one single question.</p></td></tr></table></div></dd><dt><span class="term">needspace=<em class="replaceable"><code>dimen</code></em></span></dt><dd><p>Gives a height (dimension with unit, such as
<em class="replaceable"><code>4cm</code></em>) necessary to begin with the group.
If the remaining vertical space on the current page is lower than
this value, the group will begin on the next page.</p></dd></dl></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="txt-arabic"></a>Arabic language</h3></div></div></div><p>Writing a questionnaire in Arabic is a little special. Use of
course option</p><pre class="programlisting">Lang: AR</pre><p>You can also consider the following global options:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">ArabicFont:</span></dt><dd><p>This is the font used for Arabic text. Default value is
<span class="emphasis"><em>Rasheeq</em></span>, a font from the project <a class="ulink" href="http://arabeyes.org/" target="_top">ArabEyes</a> (you can find it on
debian/ubuntu in the ttf-arabeyes package).</p></dd></dl></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>To insert texts with non-Arabic characters, you must turn on
<code class="option">LaTeX</code> option and enclose these texts as a
<span class="command"><strong>\textLR</strong></span> LaTeX command argument, as in
<code class="code">\textLR{xelatex command}</code>.</p></td></tr></table></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="txt-japanese"></a>Japanese language</h3></div></div></div><p>Japanese language questionnaires can be produced with
option</p><pre class="programlisting">Lang: JA</pre><p>AMC will make some adjustments on the produced LaTeX source to
allow Japanese characters to be included.</p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.png" /></td><th align="left">Warning</th></tr><tr><td align="left" valign="top"><p>In this case, AMC will use <span class="command"><strong>pTex</strong></span> to process
the LaTeX file made from your AMC-TXT source file. AMC needs a
<span class="emphasis"><em>recent</em></span> version of <span class="command"><strong>pTex</strong></span> to
work. Versions of pTex from texlive 2009, that can be found on old
versions of some linux distributions, are <span class="emphasis"><em>not</em></span>
compatible.</p></td></tr></table></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="txt.includes"></a>Including other files</h3></div></div></div><p>You can include other files with:</p><pre class="programlisting">IncludeFile: <em class="replaceable"><code>file-to-include.txt</code></em></pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../images/warning.png" /></td><th align="left">Warning</th></tr><tr><td align="left" valign="top"><p>Be very careful when including a single file from different
projects! Suppose for example that
<code class="filename">/home/alexis/questions-a.txt</code> is included from
projects A and B. You already processed project A, and you are
currently working on project B. You update the scoring strategy of a
question in <code class="filename">/home/alexis/questions-a.txt</code>, and
also add another question. If you need to update the marks in project
A with this new scoring strategy, AMC will also see a new question for
which no data capture has been made, and this will spoil all your
marks in A...</p></td></tr></table></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="usagenotes.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="latex.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Usage notes </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> LaTeX source file</td></tr></table></div></body></html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-updates
>
by-pkgid
>
f505c4c5327c360be380fcb0f1cb2d94
>
files
>
108
