Understanding criptic AMC compile error messages

Added by Paco Riviere 5 months ago

Even with the "comment \begin{examcopy} and \end{examcopy}" tip. I found quite difficult to troubleshoot messages like the following:

@! Undefined control sequence.
<argument> ...hspace *{\AMChorizBoxSep }F\bulletL

l.886 \insertgroup{all}

! Undefined control sequence.@

AMC seems an unvaluable personal tool, shared thanks to Alexis generosity.
But clearer error messages may bring many people life easier, and probably, also advanced users'.
I really miss, compared with less powerful platforms, a way to check questions syntax, one by one.
I also miss question examples on the documentation. Many useful features are only mentioned in some lines.
Including examples of all kind of questions, with images, and without, wrapped and not wrapped, labeled, referenced, and shared between questions...

Luckily, this forum covers all my gaps.

Any help with the previous message will be welcomed.


Replies (9)

RE: Understanding criptic AMC compile error messages - Added by Gérard Carpeaux 5 months ago

\setlength{\AMChorizBoxSep}{1em}

Waht is your version ?

I also miss question examples on the documentation. Many useful features are only mentioned in some lines.

Could you specify ? I could add some examples or commerts.
Feel free to add your examples and update the documentation : https://gitlab.com/jojo_boulix/auto-multiple-choice/

RE: Understanding criptic AMC compile error messages - Added by Paco Riviere 5 months ago

Here is an example of document including diferent question types, but not all, I managed to do after many hours of reading the doc, with its source.

DOC-catalog.pdf (132.7 kB)

simple.tex (7.8 kB)

RE: Understanding criptic AMC compile error messages - Added by Paco Riviere 5 months ago

Thanks Gèrard. I'll try to specify when I found next issue.

- Would be very useful examples about including images with questions and how to wrap them in text.
- I still don't understand how Title (4.5 in user guide) works after many tries. Just half a line in user guide.
- Same with /label and /AMClabel, even this is no so short.
- I cannot find a tex example with question groups. There is one with AMC-TXT. Took many readings and tries to understand.
- A heading logo example may also be useful.

A look to forum user questions may reveal needs better than me.

RE: Understanding criptic AMC compile error messages - Added by Alexis Bienvenüe 5 months ago

Would be very useful examples about including images with questions and how to wrap them in text.

The wiki can be used to build a samples gallery: feel free to start a new page.

RE: Understanding criptic AMC compile error messages - Added by Paco Riviere 5 months ago

Thanks for the offering, Alexis. I'll try to honour it. But not for the moment.

Unfortunately I will not be able to add anything to the doc/wiki untill I understand more what I do ;) Otherwise I would confuse everybody! ;)
I'm just starting and still have lots of problems in every run!

I can hardly understand AMC error messages and have a real pain to debugg them.

RE: Understanding criptic AMC compile error messages - Added by Alexis Bienvenüe 5 months ago

Error messages are LaTeX error messages. They can be quite confusing in the case of complex documents, such as AMC ones.
Try to test your questions in a minimal document before including them in more complex setups.

RE: Understanding criptic AMC compile error messages - Added by Gérard Carpeaux 5 months ago

I cannot find a tex example with question groups

Documentation 5.2 An example with groups of questions and shuffling

I still don't understand how Title (4.5 in user guide) works after many tries.

It's a AMC-txt code.

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.
Same with /label and /AMClabel

label is a latex primitive command and AMClabel is command programed by Alexis for AMC to add each number student to the argument.
I am not sur my sentence is correcly translated and writted.

A heading logo example may also be useful.

Maybe this https://project.auto-multiple-choice.net/boards/2/topics/9992?r=9993#message-9993

RE: Understanding criptic AMC compile error messages - Added by Paco Riviere 5 months ago

Thanks to both of you for help and useful suggestions.

Alexis Bienvenüe wrote:
...

Try to test your questions in a minimal document before including them in more complex setups.

I have a bunch of little projects to test every enhancement. It's a very useful tip. But when they come to the main project they always like to clash ;)

Gérard Carpeaux wrote:
...

Maybe this https://project.auto-multiple-choice.net/boards/2/topics/9992?r=9993#message-9993

In fact I finally succeeded with my heading thanks to this post. Just trying to give the examples you requested.

(1-9/9)