Subsection 44.4.7 HTML Knowlization
In a conversion to HTML a wide variety of content can be “born” in a knowl. Publisher switches are specified via multiple attributes of a single
/publication/html/knowl
element, with values of
yes (do use a knowl) or no (do not use a knowl, present content normally). For example,<knowl remark="yes"/>
would make every “remark-like” element occur as a knowl where the content is first introduced. Note that these are distinctly different than cross-reference knowls. For more detail see Section 29.2.
This table gives the various attribute names, the default value, and an indication of the elements affected. Note that some items are automatically born knowled (e.g. footnotes) and so there is no option to control that behavior. Also, items such as
<figure>, when included in a <sidebyside> are not influenced by the relevant option and are not born knowled. There are four flavors of <exercise> and so four options. A <hint>, <answer>, or <solution> is automatically knowled as a plot-spoiler where the author is expecting the reader to do something. In contrast, an “example-like” is expository, so the knowlization is configurable.| Attribute | Default | Element(s) |
|---|---|---|
theorem |
no |
<theorem>, <lemma>, … |
proof |
yes |
<proof> |
definition |
no |
<definition> |
example |
yes |
<example>, <problem>, … |
example-solution |
yes |
<hint>, <answer>, <solution>
|
project |
no |
<project>, <activity>, … |
task |
no |
<task> |
remark |
no |
<remark>, <note>, … |
objectives |
no |
<objectives> |
outcomes |
no |
<outcomes> |
figure |
no |
<figure> |
table |
no |
<table> |
listing |
no |
<listing> |
list |
no |
<list> |
exercise-inline |
yes |
within narrative |
exercise-divisional |
no |
inside <exercises> division |
exercise-worksheet |
no |
inside <worksheet> division |
exercise-readingquestion |
no |
inside <readingquestions> division |
