Section 40.1 Common Options
These are options that might affect several conversions, though the influence may vary from one conversion to the next.
Subsection 40.1.1 Common Chunking Option
Many outputs are produced as a collection of several files, others may only produce a single file. A chunk is a generic, informal term for a portion of an output, typically a single file. This is given as a level, see Section 26.2 for more about levels. The specification is in the attribute
/publication/common/chunking/@level
with a whole number as the value (generally 0 is allowed). This is critical for the construction of HTML output, and ignored for LaTeX output.
Subsection 40.1.2 Table of Contents Level Option
The depth of the entries in a Table of Contents is given as a level, see Section 26.2 for more about levels. The specification is in the attribute
/publication/common/tableofcontents/@level
with a whole number as the value. A value of 0 is used to indicate that no Table of Contents is desired. Absent this setting, reasonable defaults are supplied, which can vary by conversion and document type.
Subsection 40.1.3 Exercise Component Visibility
An <exercise>
can appear in four different locations: mixed in with paragraphs and blocks (“inline”), inside an <exercises>
specialized division (“divisional”), inside a <worksheet>
specialized division (“worksheet”), or inside a <reading-questions>
specialized division (“reading”). Also, a <project>
, and similar (“project”), behaves in many ways like an <exercise>
. All of these elements (or their <task>
) may have <statement>
, <hint>
, <answer>
, and <solution>
(“components”).
Where such exercises first appear (not, for example, in back-of-the-book solutions) publication switches can control the visibility of the components. There are five elements, each with four attributes, which can take on the values of yes
or no
. The default is yes
, which should be most useful in the early stages of a project. The element <exercise-project>
is a misnomer, but is used to avoid confusion with some other use of project
. See Section 26.5 for more explanation.
Publication File Entry | Attributes: yes or no values |
---|---|
common/exercise-inline |
@statement , @hint , @answer , @solution
|
common/exercise-divisional |
@statement , @hint , @answer , @solution
|
common/exercise-worksheet |
@statement , @hint , @answer , @solution
|
common/exercise-reading |
@statement , @hint , @answer , @solution
|
common/project |
@statement , @hint , @answer , @solution
|