Previous topic

LaTeX-a dokumentklaso “exam”

Next topic

Esperanto en LaTeX UTF-8 dosieroj

Ecoj aldonitaj de “oficiala” versio 2.3

Note

La dokumento estas ĉefe anglalingva - ĝia tradukado daŭras.


versio:2.316beta
dato:2010/12/22

Novaj komandoj:

\pointsinrange{amlpeksonomo}
\bonuspointsinrange{amlpeksonomo}

Se partonomo estas la nomo de prinotata parto definita uzante begingradingrange{partonomo}() kaj endgradingrange{partonomo}(), tiam pointsinrange{partonomo}() dosvolviĝas al la nombro da poentoj en la prinotata parto kaj bonuspointsinrange{partonomo}() desvolviĝas al la nombro da bonusaj poentoj en tiu ĉi prinotata parto.

Ni ankaŭ ŝanĝis la checkboxes() kaj oneparcheckboxes() medioj tiel, ke kiam solvoj estas presataj, CorrectChoice() estos presata kun CorrectChoiceEmphasis() (kun la checkedchar() kiu markas la CorrectChoice()). Ĝi aldonas sama konduton en linion kiel tiu de choices() kaj oneparchoices() medioj.


versio:2.315beta
dato:2010/12/21

Novaj komandoj:

\settabletotalpoints
\settabletotalbonuspoints

Each of those takes one argument. After giving the command settabletotalpoints{poentoj}(), any grade or point table (partial or full) will list the total points as poentoj instead of the actual total number of points in the table.

After giving the command settabletotalbonuspoints{bonuspoentoj}(), any grade or point table will list the total bonus points as bonuspoentoj instead of the actual total number of bonus points in the table.

These commands are intended for exams in which students are asked to do some subset of the problems, but not all of them, and so the total number of points possible is less than the sum of the points for all of the questions.

To have one of these commands affect only a single table, confine the command and the gradetable() command inside of a group, as in

\begingroup
\settabletotalpoints{100}
\gradetable[v][questions]
\endgroup

or even just

\begin{center}
\settabletotalpoints{100}
\gradetable[v][questions]
\end{center}

versio:2.314beta
dato:2010/12/01

New user command:

\addquestionobject

This is for when some of a question spills onto the next page, but that page doesn’t have any parts, subparts, subsubparts, or choices beginning on theat page (which means that the ifincomplete() command won’t know that any of that question is on that page). If you say addquestionobject() at the very end of the question, it will write a questionobject to the .aux file so that ifincomplete() will work correctly. Novaj komandoj used only internally:

\first@questionobject
\questionobject@pluspagecheck

These were just to clean up some of the internal code.


versio:2.313beta
dato:2010/02/18

Bug fix: When solutions are not being printed, the solution(), solutionorlines(), and solutionordottedlines() environments disallow pagebreaks before the environment, which can pull the last line of the question (or part, or etc.) preceding the environment onto the next page, even when leaving a rather large space before the pagebreak. We insert

\penalty 0

to allow a pagebreak before the environment. We make no change to the solutionorbox() environment, since it didn’t have this problem.


versio:2.312beta
dato:2010/01/17

Novaj komandoj:

\combinedgradetable
\combinedpointtable
\partialcombinedgradetable
\partialcombinedpointtable

These are similar to gradetable(), pointable(), bonusgradetable(), bonuspointtable(), partialgradetable(), partialpointtable(), partialbonusgradetable(), and partialbonuspointtable() except that these new commands list both the points and the bonus points.

partialcombinedgradetable() and partialcombinedpointtable() take one required argument, which is the name of the grading range. All four of these commands take two optional arguments, the first being either v or h and the second being either questions or pages. The possibilities are thus

\combinedgradetable[v][questions]
\combinedgradetable[v][pages]
\combinedgradetable[h][questions]
\combinedgradetable[h][pages]
\partialcombinedgradetable{partonomo}[v][questions]
\partialcombinedgradetable{partonomo}[v][pages]
\partialcombinedgradetable{partonomo}[h][questions]
\partialcombinedgradetable{partonomo}[h][pages]

The defaults are v and questions.

The horizontal tables have separate rows for the points and bonus points. The vertical tables have separate columns for the points and bonus points.

The default values for the words that appear in the tables are set by the commands

\chqword{Question:}
\chpgword{Page:}
\chpword{Points:}
\chbpword{Bonus Points:}
\chsword{Score:}
\chtword{Total}
\cvqword{Question}
\cvpgword{Page}
\cvpword{Points}
\cvbpword{Bonus Points}
\cvsword{Score}
\cvtword{Total:}

The words in the table can be changed by giving any of these commands with the desired word as argument.


versio:2.311beta
dato:2010/01/10

New environment:

oneparcheckboxes

The oneparcheckboxes() environment is to the checkboxes() environment as the oneparchoices() environment is to the choices() environment. That is, each choice is begun with either a choice() or a correctchoice() command, and these will all be printed as a single paragraph. When answers are not being printed, each choice will have a label consisting of a box that the student can check, created by the argument to the last checkboxchar() command. The default value is created by the command

\checkboxchar{$\bigcirc$}

(Note the dollar signs, since bigcirc() can appear only in math mode.) When answers are being printed, then any choice created using the correctchoice() command will be labelled by the argument to the last checkedchar() command, the default value of which is created by the command

\checkedchar{$\surd$}

versio:2.310beta
dato:2010/01/09

Nova komando:

\bonusqformat

The bonusqformat() command takes one argument, with the same description as for the argument of the qformat() command.

If the user gives a qformat() command, then the argument of that command is used to format both questions() and bonusquestions(). If, after giving the qformat() command, the user gives a bonusqformat() command, then the argument of the bonusqformat() command will be used to format bonus questions.

Note

If the user hasn’t given a qformat() command, then a bonusqformat() command will have no effect.

Note

If the user gives a qformat() command and a bonusqformat() command, and then later says noqformat(), then the arguments of both the qformat() and bonusqformat() commands are no longer usable. That is, if the user later on once again says qformat(), and wants the bonus questions to have a different format from the questions, then another bonusqformat() command must be given.


versio:2.309beta
dato:2009/11/30

New environment:

checkboxes

Novaj komandoj:

\checkboxeshook
\checkboxchar
\checkedchar

The checkboxes() environment is similar to the choices() environment, except that choices() are not numbered. Instead of numbers, each choice has a label consisting of a box that the student can check, created by the argument to the last checkboxchar() command. The default value is created by the command

\checkboxchar{$\bigcirc$}

(Note the dollar signs, since bigcirc() can appear only in math mode.) When answers are being printed, then any choice created using the correctchoice() command will be labelled by the argument to the last checkedchar() command, the default value of which is created by the command

\checkedchar{$\surd$}

The list parameters used in the checkboxes() environment can be customized by redefining checkboxeshook(), the default value of which is empty. (This is similar to using choiceshook() to alter the choices() environment.)


versio:2.308beta
dato:2009/11/26

We fixed a bug that caused bonussubpart() to act like subpart() and bonussubsubpart() to act like subsubpart().


versio:2.307beta
dato:2009/06/11

We fixed a bug that arose only when there were cover pages and the first page of the cover pages used a different extraheadheight() or extrafootheight() from that used on the first page of the regular pages. The bug caused the first page of the regular pages to use the extraheadheight() and extrafootheight() intended only for the first cover page.


versio:2.306beta
dato:2009/03/28

We fixed a bug that arose only when the user used a figure or table environment that floated to the top of a page. If that happened, then a full page’s worth of text was placed below the figure or table, making the text run over the footline and off the bottom of the page.


versio:2.305beta
dato:2009/01/30

We fixed a bug to keep page breaks from occurring inside of makeemptybox(). We also added begingroup() endgroup() for the off chance that someone was using box0 and didn’t want us to change it.

We also fixed a bug in the solutionorbox() environment that showed itself when the user used stretch() in the optional argument.


versio:2.304beta
dato:2009/01/22

We rewrote the definition of makeemptybox() and the solutionorbox() environment (created in version 2.303).

The argument to makeemptybox() can now be either a length, or fill(), or stretch{numero}().

The optional argument to the solutionorbox() environment can also be either a length, or fill(), or stretch{numero}(). If the optional argument is omitted, then no box is printed when printanswers() is false.

The minimum box height is minboxheight(), whose value is set by the command

\setlength\minboxheight{.1in}

This can be changed by giving a new setlength() command, but it’s not likely that anyone actually wants a box of height less than .1 inch.


versio:2.303beta
dato:2009/01/21

Nova komando:

\makeemptybox

New environment:

solutionorbox

makeemptybox() takes one argument, which is a length, and it creates an empty box of width the length of the current line and of height equal to the argument. That is, the box extends from the current left margin (which depends on whether we’re in a question, part, subpart, or subsubpart) to the right margin.

The solutionorbox() environment is similar to the solution() environment, except that if printanswers() is false and an optional argument is specified, then instead of leaving that much blank space we print an empty box of that height. The optional argument must be a dimension; it can not be fill(). If the optional argument is missing or equal to 0pt, then when printanswers() is false we print nothing at all.

Note

This is changed in version 2.304beta. As of that version, the argument can be either a length, or fill, or stretch{number}.


versio:2.302beta
dato:2008/10/18

Novaj komandoj:

\numcoverpages
\totalnumpages

numcoverpages() inserts the number of pages occupied by the coverpages() environment. If there is no coverpages() environment, it inserts 0.

totalnumpages() inserts the sum of numcoverpages() and numpages(). Note that if there are pages preceding a coverpages() environment, then those pages will not be counted by totalnumpages().

Also: Minor bugfix. We added relax() after some ifnum() comparisons and commented out some line endings to remove, e.g., an unwanted space inserted by ifcontinuation() when the page is a continuation.


versio:2.301beta
dato:2008/09/22

All solution, solutionorlines, and solutionordottedlines environments are now enclosed in a group, which is begun with the argument of the command

\SolutionEmphasis

the default value of which is determined by the command

\SolutionEmphasis{}

That is, the default is that nothing is inserted. For example, if the command

\SolutionEmphasis{\itshape\small}

is used, the solutions will be set in italics, in small type.

Nova komando: unframedsolutions()

This causes solutions to be printed as normal text, without any framing or shading. Anyone using this command should use the SolutionEmphasis command so that the solutions will be distinguishable from the rest of the exam.