6.1. Valid XHTML56.2. Headings (21/59)6.3. Examples

6.2. Headings

You may use headings (h1, h2, h3, etc) normally, without worrying about the role as a book division (chapter, section, etc) that will be given to your input HTML page.

By default, book attribute adjustuserheadings="true!article" specifies that the levels of your headings are to be automatically adjusted (except inside article elements, which are considered to be independent, self-contained content) to make them consistent with the level of the title of the book division.

Example, input HTML page contains:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta charset="UTF-8" />
    <title>Troubleshooting</title>
  </head>
  <body>
  <h1>Symptoms</h1>
  ...
  <h2>Intermittent symptoms</h2>
  ...
  <h1>Most common causes</h1>
  ...  
  </body>
</htm>

The above input HTML is referenced as a subsection of a chapter in the book. Therefore the title of the subsection is represented by an h3 element. The output HTML page containing the subsection then looks like:

1
2
3
4
5
6
7
8
<section class="role-section2">
  <h3 class="role-section2-title">Troubleshooting</h3>  
  <h4>Symptoms</h4>
  ...
  <h5>Intermittent symptoms</h5>
  ...
  <h4>Most common causes</h4>
  ...

If you want to prevent this from happening, please add attribute adjustuserheadings="false" to your root book element or add a class attribute to some or all of your headings. A heading having a class attribute is understood by XMLmind Ebook Compiler as being “not an ordinary heading which could be modified”.