Version 1.0
Last Revised: June 14, 2002
This section provides guidance on marking up the major structures of books. These structures are the items normally listed in the traditional printed table of contents. A table of contents may not show as many levels as are contained in the main body of the book, but it is a good place to start when identifying the major structures. It is important to think of the book as being made up of "front matter," "body matter," and "rear matter." It is also critical to understand the notion of nested levels in a book.
In this section, the major structures are addressed in the order in which they would normally be encountered when reading a book. Only the most commonly-occurring major structures (e.g., dedication, table of contents, part, chapter, section, appendix, etc.) are discussed here. However, the procedures described apply universally to major structures regardless of their name. For example, in a collection of letters grouped by year, each division by year would be equivalent to a part and each letter would be treated like a chapter. See the expanded table of contents for a list of the topics covered here.
IMPORTANT: It is suggested that at least the first level and the associated heading be identified for books produced with a Navigation Contol File (NCX). In addition, properly nested levels are a minimum requirement for correct XML markup.
Think of a very simple book that contains chapters, an appendix, and an index. Each chapter, the appendix, and the index would be identified as the highest level (level1). Sections within the chapters would be identified as the second highest level (level2) and sub-sections would be identified as the third level (level3) in the hierarchy. The index might be divided into the alphabetic divisions "A," "B," "C," etc. These alphabetic divisions would fall at level2 and, together with the other levels, would create a strict hierarchy. This hierarchy provides direct and easy navigation by the end user to the book's major structures and provides a detailed hierarchical road map of the book.
Many times there are structures that a producer will not want to tag as major navigation points. Generally, these are structures such as dedications, epigraphs, and such that are not identified by a heading. These objects can still be identified as major structures by calling them divisions (<div>), but they will not ordinarily be included in the NCX and would thus not be directly accessible by the end user. In other words these objects can be present and properly identified, but a user will not be able to navigate directly to them using the NCX.
NOTE: At least some of the major structures described in this section are needed for all six types of digital talking book (audio with title element only to full text with no audio). In DTBs that do not include the full text, only a few block and inline elements (prodnote, note, noteref, and sidebar) will be used. DTBs created with full text will use a wider range of tags described in the remainder of Part 2.
Definition: One of the three major divisions of the interior of a book, the front matter is comprised of preliminary pages which serve as a guide to the contents and nature of the book. Front Matter may include:
Overview: Within the frontmatter of a book, in most cases only objects with headings should be identified using a level tag and its associated heading tag. A preface would normally be a major structure that an end user would want to directly access so it should be marked as a level with the associated heading. Other items without a heading, such as the dedication, should be marked as divisions (<div>).
Markup: Frontmatter serves primarily as a container for a variety of structures and is commonly subdivided into a number of levels and divisions.
Elements: <frontmatter>...</frontmatter>
Definition: Identifies the title of this book.
Markup: Doctitle is often the first element inside the front matter and can be used to quickly identify the book. It thus serves the same function as does the title printed on the cover of the print book and should contain the same information. It is generally followed by opening announcements contained in a producer's note which would contain such information as author, publisher, copyright notice, etc. The information included in the producer's note and the order in which it is presented is generally specified by the producing agency. The exact contents of the title page are included separately, as indicated in the following section.
When a book contains a title which is abbreviated on the cover, with the full title presented on the title page, doctitle should be used to mark both versions, with the class attribute describing which is the full (class="full") and which is the abbreviated (class="short") version.
Elements:
<doctitle>...</doctitle>
Example:
<doctitle class="full">Reading for Success</doctitle>
Definition: Identifies each author, editor, etc. of this book.
Markup: As with doctitle, docauthor will ordinarily appear both at the very beginning of the book and on the title page.
Elements:
<docauthor>...</docauthor>
Example:
<docauthor>Roberta P. Stevenson</docauthor>
Definition: The title page presents the full title of the book, the name of the author, editor or translator and the name and location of the publishing house. If the book is a new edition of a work previously published, the number of the edition may also appear on the title page following the title. Additional items such as publishing year and colophon sometimes appear on the title page.
Markup: The title page is included in the front matter. Since it rarely contains a heading, it should generally be marked with a div tag. The title of the book should be marked with the doctitle tag and each author, editor, etc. with the docauthor tag. If the title of the book is abbreviated on the cover (e.g., a subtitle is omitted), the full title will be present on the title page and the class attribute on doctitle should be present with the value "full". The remaining contents of the title page are most easily managed by the end user if the separate items are marked up as paragraphs using <p> and </p>.
Elements:
<div class="title_page"> <doctitle>...</doctitle> <docauthor>...</docauthor> </div>
Example:
<div class="title_page">
<doctitle class="full">The Elements of Happiness: An Investigation of Life</doctitle>
<docauthor>Erin Pegeen</docauthor>
<p>The University of Chicago Press</p>
<p>Chicago and London</p>
</div>
Definition: A formal declaration of acknowledgment by the author in which persons and/or institutions are thanked for their part in the creation of the text. Acknowledgments can form a separate page or can be combined with the preface.
Markup: The acknowledgment page is included in the front matter (unless it falls at the back of the book, in which case it is included in the rear matter) and is marked with a level1 tag if there is a heading. Otherwise, it should be marked with a div tag.
Elements:
<div class="acknowledgments"> <p>...</p> </div>
Example 1:
<div class="acknowledgments">
<p>In any collection, the editors' first debt is to the contributors, without whose talent and cooperation the book could not exist. We thank them for their enthusiasm, conscientiousness, and in many cases, advice.</p >
<p>We are especially thankful to Jeanne Heifetz and Jonathan Rosen, who have been extraordinarily generous and helpful in their suggestions.</p>
</div>
If the acknowledgements had a heading, one would use the level1 instead of the div as shown below.
Example 2:
<level1 class="acknowledgments">
<h1 class="acknowledgements">ACKNOWLEDGEMENTS</h1>
<p>In any collection, the editor's first debt is to the contributors, without whose talent and cooperation the book could not exist. We thank them for their enthusiasm, conscientiousness, and in many cases, advice.</p >
<p>We are especially thankful to Jeanne Heifetz and Jonathan Rosen, who have been extraordinarily generous and helpful in their suggestions.</p>
</level1>
In example 2 the heading would appear in the NCX, but in the first example there would be no direct navigation to the item.
Definition: A formal offering or dedication of a text by the author to one or more persons or institutions.
Markup: The dedication page is included in the front matter and is marked with a level1 tag. If there is no heading associated with it, it should be marked with a div.
Elements:
<div class="dedication"> <p>...</p> </div>
Example:
<div class="dedication">
<p>For Digger, Magrath and Poppy - as always</p>
</div>
Definition: The preface is used by the author or publisher to explain the content, origin and/or purpose of the book to the reader.
Markup: The preface is to be included in the front matter and is marked with a level1 tag. Other prefatory material such as introductions, forewords, editor's notes, translator's notes, etc. should be marked up in the same manner as a preface.
Elements:
<level1 class="preface"> <h1 class="preface">Preface</h1> <p>...</p> </level1>
Example:
<level1 class="preface">
<h1 class ="preface">Preface</h1>
<p>Certain authors write with such vitality that literary coteries grow up around the characters of their imagination. The "Pickwickians", the Jane-ites", the "Dickensians"are typical of such groups. Lewis Carroll's "Alice" books have a world following and the devotees of "Pooh" recognize each other almost upon sight. Most of these enthusiasms are based upon two or more titles by the same author. There is one enthusiasm, however , the fellowship of Rat and Mole and Mr. Toad, that stems from one single book - The Wind in the Willows.</p>
</level1>
Definition: The table of contents is intended to record and provide access for the reader to the main sections of the book: front matter, text divisions and back matter including the index. It should include the title and the beginning page number of each section of the book. In a volume consisting of chapters by different authors, the name of each author is given in the table of contents with the title of the chapter.
Markup: The printed table of contents is to be included in the front matter and is marked with a level1 tag. The table of contents should be considered a nested list and each item in the table of contents should be marked as a list item. If page numbers are provided for the items listed, each item and each page number should be marked as separate "list item components" using the lic tag. The class attribute on lic specifies what type of list item component each one is ("entry" and "pagenum" in the example below).
Elements:
<level1 class="print_toc"> <h1 class="print_toc">Table of Contents</h1> <list> <li><lic class="entry">First Item</lic><lic class="pagenum">1</lic></li> <li><lic class="entry">Second Item</lic><lic class="pagenum">23</lic></li> </list> </level1>
Example:
<level1 class="print_toc">
<pagenum page="front">vi</pagenum>
<h1 class="print_toc">Table of Contents</h1>
<list class="toc">
<li ><lic class="entry">CHAPTER 1 Preparing to Read for Success</lic><lic class="pagenum">1</lic>
<list class="toc_chapter">
<li><lic class="entry">Getting Ready to Read This Book </lic><lic class="pagenum">1</lic></li>
<li><lic class="entry">Why Read a Book to Learn How to Read a Book? </lic><lic class="pagenum">2</lic></li>
<li><lic class="entry">The Three Steps of Reading </lic><lic class="pagenum">4</lic></li>
<li><lic class="entry">Practice Means Improvement </lic><lic class="pagenum">7</lic></li>
<li><lic class="entry">Foundation Skills for Life </lic><lic class="pagenum">7</lic></li>
<li><lic class="entry">Check Your Predictions </lic><lic class="pagenum">10</lic></li>
<li><lic class="entry">Summary </lic><lic class="pagenum">11</lic></li>
<li><lic class="entry">Writer's Workshop 1 </lic><lic class="pagenum">11</lic></li>
<li><lic class="entry">Writer's Workshop 2 </lic><lic class="pagenum">13</lic></li>
<li><lic class="entry">Final Check </lic><lic class="pagenum">14</lic></li>
</list></li>
<li><lic class="entry">CHAPTER 2 Previewing Reading Selections </lic><lic class="pagenum">15</lic>
<list class="toc_chapter">
<li><lic class="entry">Previewing Reading Selections </lic><lic class="pagenum">15</lic></li>
<li><lic class="entry">How to Preview </lic><lic class="pagenum">18</lic></li>
<li><lic class="entry">Using Quality Questions to Preview </lic><lic class="pagenum">27</lic></li>
<li><lic class="entry">Asking Wild and Wacky Questions </lic><lic class="pagenum">27</lic></li>
<li><lic class="entry">Your Textbook as a Tool </lic><lic class="pagenum">30</lic></li>
<li><lic class="entry">Summary </lic><lic class="pagenum">31</lic></li>
<li><lic class="entry">Writer's Workshop </lic><lic class="pagenum">31</lic></li>
<li><lic class="entry">Final Check </lic><lic class="pagenum">32</lic></li>
</list></li>
</list>
</level1>
Definition: Body Matter consists of the text proper of a book. It is the content per se that represents the author's thesis or story. The body of a book is most commonly subdivided into chapters and further into levels of subheadings such as sections and subsections if needed. Sometimes the text material is logically divided into sections larger than chapters with the chapters grouped into parts which are usually numbered. The body sometimes concludes with either epilogues, afterwords or conclusions.
Overview: In the body of the book all major structures should be marked as a strict hierarchy and should use the levels and their associated headings as identification.
Markup: bodymatter serves primarily as a container for a variety of structures and is commonly subdivided into a number of levels.
Element: <bodymatter>...</bodymatter>
Definition: A part is a logical division of text material; a section larger than chapters into which chapters are grouped. Each part is normally numbered and given a part title. The part number and title appear on the page preceding the first chapter. Chapters within parts are most commonly numbered consecutively through the book rather than starting anew with chapter one for each new part.
Markup: Parts, when present, are the structures at the highest level in the body of a book and are thus marked with level1 tags. If a book is divided into parts which are further divided into chapters, the chapters are marked with level2 tags.
Note: To ensure accurate navigation, the markup at the beginning of a part must follow a precise order. The order should always be: level1, pagenum (if used), heading. For example, a part might start on page 1 which contained only the part heading and a full page picture. The order of the markup would be: level1, pagenum 1, heading. The image (if included) would follow the heading.
Elements:
<level1 class="part"> <h1 class="part">Part 1</h1> <level2 class="chapter"> <h2 class="chapter">Chapter</h2> ... </level2> </level1>
Example:
<level1 class="part">
<pagenum id="page_1" page="normal">1</pagenum> <h1 class="part">Part 1 Perfection and Imperfection: A Trilogy on a Panda's Thumb</h1>
<level2 class="chapter">
<pagenum id="page_2" page="normal">2</pagenum>
<h2 class="chapter">1 The Panda's Thumb</h2>
<p>Few heroes lower their sights in the prime of their lives; triumph leads inexorably on, often to destruction. Alexander wept because he had no new worlds to conquer; Napoleon, overextended, sealed his doom in the depth of a Russian winter.</p>
...
</level2>
<level2 class="chapter">
<pagenum id="page_27" page="normal">27</pagenum>
<h2 class="chapter">2 Senseless Signs of History</h2>
<p>Words provide clues about their history when etymology does not match current meaning.</p>
...
</level2>
...
</level1>
<level1 class="part">
<pagenum id="page_46" page="normal">46</pagenum>
<h1 class="part">Part 2 Darwiniana</h1>
<level2 class="chapter">
<pagenum id="page_47" page="normal">47</pagenum>
<h2 class="chapter">4 Natural Selection and the Human Brain: Darwin vs. Wallace</h2>
<p>In the south transept of Chartres cathedral, the most stunning of all medieval windows depicts the four evangelists as dwarfs sitting upon the shoulders of four old testament prophets - Isaiah, Jeremiah, Ezekiel, and Daniel.</p>
...
</level2>
...
</level1>
Definition: The chapter is the most common division of most prose works. In a printed book, chapters customarily begin on a new page and the chapter display (heading) usually consists of a chapter number and chapter title which are generally listed in the book's table of contents. The chapter display can also contain an epigraph in addition to the chapter number and title. In books consisting of chapters contributed by different authors, chapter numbers are sometimes omitted; however, the author's name is always given in the display.
A chapter can be divided into smaller divisions most commonly called sections. This occurs most often in textbooks and technical and scholarly publications.
Markup: Chapters are included in the body matter of the book and are marked with a level1 tag unless the book is divided into parts in which the chapters are grouped. In the latter case the parts would be marked with level1 tags and the chapters with level2 tags. (see also: Information Object: Part)
Note: To ensure accurate navigation, the markup at the beginning of a chapter must follow a precise order. The order should always be: level, pagenum (if used), heading. That way, if an end user navigates to the chapter (i.e., the level tag) they will then hear the page number followed by the chapter heading. If they navigate to pagenum, they will still hear the page number and heading. For example, a chapter might start on page 1 which contained only the chapter heading and a full page picture. The order of the markup would be: level, pagenum 1, heading. The image (if included) would follow the heading.
Elements:
<level1 class="chapter"> <h1 class="chapter">Chapter</h1> </level1>
Example:
<level1 class="chapter">
<pagenum id="page_1" page="normal">1</pagenum>
<h1 class="chapter">Chapter 1 The River Bank</h1>
<p>The Mole had been working very hard all morning, spring cleaning his little home. First with brooms, then with dusters; then on ladders and steps and chairs with a brush and a pail of whitewash; till he had dust in his throat and eyes, and splashes of whitewash all over his black fur, and an aching back and weary arms. Spring was moving in the air above and in the earth below and around him, penetrating even his dark and lowly little house with its spirit of discontent and longing.</p>
</level1>
<level1 class ="chapter">
<pagenum id="page_22" page="normal">22</pagenum>
<h1 class="chapter"> Chapter 2 The Open Road</h1>
<p>...</p>
...
</level1>
Definition: Sections are inserted by the author or editor in prose works where the chapters are long and the material complex. Sections and/or subheadings in the text function as guides to the reader. Most scholarly works require only one level of subheading throughout. Scientific and technical works frequently require further subdivisions.
When a section of text is subdivided, there should be at least two subsections and in some works the number of sections will vary from chapter to chapter, and the levels of subdivision may vary as well.
Sections and subsections may be numbered or unnumbered. Especially in scientific and technical works, the numbering of sections and subsections provides an easy reference to the reader. In print books, unnumbered sections and further subdivisions are indicated by font size and various forms of emphasis such as bolding or the use of italics.
Markup: Sections and subsections of chapters are included in the bodymatter of the book and are marked with level2, level3, or level4 tags, etc., depending on where they fall in the hierarchy.
Note in the example below that the level and heading tags include a class attribute of the same name as the type of division being tagged (class="chapter", "section", or "subsection"). When books are divided below the subsection level, some creativity is required to find suitable names for those lower levels to distinguish among them.
Elements:
<level1 class="chapter"> <h1 class="chapter">Chapter 5</h1> <level2 class="section"> <h2 class="section">Metadata for Mary</h2> </level2> </level1>or:
<level1 class="part"> <h1 class="part">Part One: Standards</h1> <level2 class="chapter"> <h2 class="chapter">Chapter 3: Core Services</h2> <level3 class="section"> <h3 class="section">Circulation Systems</h3> <level4 class="subsection"> <h4 class="subsection">Loan Periods</h4> <level5> <h5>Overdue Notices</h5> ... </level5> ... </level4> ... </level3> ... </level2> ... </level1>
Example:
<level1 class="chapter">
<pagenum id="page_1" page="normal">1</pagenum>
<h1 class="chapter">Chapter 1 People as a Basic Resource</h1>
<level2 class="section">
<pagenum id="page_2" page="normal">2</pagenum>
<h2 class="section">Introduction</h2>
<p>Operating managers face unprecedented advances in technology, information and knowledge. Customers demand change constantly. Competition is no longer with someone across the street, but with someone around the world.</p>
<level3 class="subsection">
<h3 class="subsection">Demographic Trends</h3>
<p>America's population is changing dramatically. On average, an American woman gives birth to 1.8 children in her lifetime, down from 3.7 in the 1950's, at the height of the baby boom.</p.
...
</level3>
<level3 class="subsection">
<h3 class="subsection">Socioeconomic Changes</h3>
<p>Socioeconomic changes are also having tremendous impact on organizations. These changes are beyond management's control, but will require management's attention to cope with them productively.</p>
...
</level3>
</level2>
<level2 class="section">
<pagenum id="page_7" page="normal">7</pagenum>
<h2 class="section"><h2>The History of Human Resource management</h2>
<level3 class="subsection">
<h3 class="subsection">Early Organization</h3>
<p>Management of society and organizations in ancient Rome 2000 years ago is a good example of how early organizations managed people. Management of people was based on several assumptions.</p>
...
</level3>
<level3 class="subsection">
<h3 class="subsection">The Industrial Revolution</h3>
<p>In the early 1800's, Western Europe and North America began to change from agricultural to industrial societies.</p>
...
</level3>
</level2>
</level1>
Definition: One of the three main divisions of the interior of a print book, the rear matter (also referred to as back matter, end matter or reference matter) is the division of material that immediately follows the text. Rear matter is usually comprised of some or all of the following parts, generally in the following order:
Overview: The rear matter may contain many different major structures and these should be identified as levels with their associated headings.
Markup: Rear matter serves primarily as a container for a variety of structures and is commonly subdivided into a number of levels.
Elements: <rearmatter>..</rearmatter>
Definition: One or more appendices are provided in some books to provide the reader with further clarification or explanation of matters discussed in the text but which are not essential parts of the text. The content of appendices can include, for example, texts of source documents, surveys and/or questionnaires, and lists or tables of supplementary information.
An appendix is most commonly found as part of the rear matter of a book, although in some cases, an appendix may be placed at the end of a chapter if it is essential to the understanding of that chapter.
When there are two or more appendices in a book they are numbered like chapters (Appendix 1, Appendix 2, etc.) or they are designated by letters (Appendix A, Appendix B, etc.) Appendices are usually titled.
Markup: Appendices are included in rearmatter and are generally marked up with a level1 tag. If there is a separate section entitled "Appendices" within which a number of appendices are grouped, the section should be tagged as a level1 and the individual appendices as level2.
Element:
<level1 class="appendix"> <h1 class="appendix">Appendix A</h1> <p>...</p> </level1>
Example:
<level1 class="appendix">
<pagenum id="page_345" page="normal">345</pagenum>
<h1 class="appendix">Appendix 1, The Mails</h1>
<p>Between 1867 and 1869 a number of changes were made in British and Canadian contracts for the conveyance of transatlantic mail, and a knowledge of these changes is essential for a clear understanding of what JHE means when she refers to the American mail via New York and the Halifax mail.</p>
<level2 class="section">
<h2 class="section"> American Mail via New York</h2>
<p>The first regular transatlantic mail began in July 1840 in accordance with the provision of the 1839 contract between the British Admiralty and the British and North American Royal Mail Steam Packet Company (of which Samuel Cunard was part owner). The contract stipulated that the mail was to be conveyed monthly in winter and bi-monthly during the rest of the year from Liverpool to Boston via Halifax.</p>
...
</level2>
<level2 class="section">
<pagenum id="page_346" page="normal">346</pagenum>
<h2 class="section">Halifax Mail</h2>
<p>Halifax had served as a mail depot since 1840, when the Cunard Line began its transatlantic mail service between Liverpool and Boston via Halifax. In 1866, the British government decided to concentrate the mail exchanges between the United Kingdom and the United States upon New York beginning in January 1868.</p>
...
</level2>
</level1>
<level1 class="appendix">
<pagenum id="page_347" page="normal">347</pagenum>
<h1 class="appendix">Appendix 2, The Scheme</h1>
<p>During the 1860's, successive attempts were made to centralize control of the civil branches of the British Army.</p>
...
</level1>
Definition: Glossaries are usually found in technical works such as manuals and are intended for the use of the general reader who may be unfamiliar with some of the terminology in the body of the work. Words to be defined in a glossary are arranged in alphabetical order, each on a separate line, followed by its definition.
Markup: Glossaries form part of the rear matter of a work and are marked with a level1 tag. The glossary terms and their definitions follow the markup used for definition lists.
See Block Elements: Information Object: List for a more complete discussion of this topic.
The Glossary may be subdivided alphabetically in which case each alphabetic division would be marked with a lower level tag.Element:
<level1 class="glossary">
<h1 class="glossary">Glossary</h1>
definition list: <dl>
<dt>... first term</dt>
<dd>... definition of first term</dd>
<dt>... second term</dt>
<dd>... definition of second term</dd>
</dl>
</level1>
Example:
<level1 class="glossary">
<pagenum id="page_831" page="normal">831</pagenum>
<h1 class="glossary">Glossary</h1>
<p>For unfamiliar terms used in the definitions below, look for entries elsewhere in the glossary, or consult the index for text references.</p>
<level2 class="alphabetic_division ">
<h2 class="alphabetic_division">A</h2>
<dl>
<dt>AA, Aas.</dt>
<dd>Abbreviation for author's alterations(s) used in correcting proof.</dd>
<dt>access</dt>
<dd>In computer terminology, the ability to reach and make use of electronically stored data.</dd>
...
</dl>
...
</level2>
</level1>
Definition: A bibliography is a list of books and other references used by an author most commonly in scholarly works. It is usually placed in the rear matter of a book before the index. Some bibliographical lists are placed at the ends of chapters to which they apply, particularly in textbooks. A bibliography can also be a book component on its own.
Bibliographies can take a number of forms:
Markup: A bibliography occurring at the end of a book is included in rearmatter and is marked with a level1 tag. A bibliography may also occur at the end of a chapter, in which case it is regarded as one section of that chapter and is marked at the same level as a section. There may be alphabetic or other divisions which would be marked one level lower than the bibliography itself. The contents of a bibliography are generally marked up as a list and the individual entries are marked with the <cite> tag
Element:
<level1 class="bibliography"> <h1 class="bibliography">Bibliography</h1> <cite>...</cite> </level1>
Example 1: Bibliography as part of the rear matter at the end of a book.
<level1 class="bibliography">
<h1 class="bibliography">Works by Isak Dinesen</h1>
<level2 class="section">
<h2 class="section">Books</h2>
<list>
<li><cite>Dinesen, Isak. Syv fantastiske Forteollinger. Copenhagen:Reitzels, 1937.</cite></li>
<li><cite>Dinesen, Isak. Out of Africa. London:Putnam, 1937.</cite></li>
<li><cite>Blixen, Karen. Den afrikanske Farm. Copenhagen. Gyldendal. 1937.</cite></li>
</list>
</level2>
<level2 class="section">
<h2 class="section">Essays</h2>
<list>
<li><cite>Blixen, Karen,[Osceola}. "Eneboerne." Tilskueren, August 1907, pp.609-35.</cite></li>
<li><cite>[Osceola}. "Familien de Cats. Tilskueren, January 1909, pp. 1-19.</cite> </li>
</list>
</level2>
</level1>
Example 2: Bibliography at the end of a chapter in a textbook.
<level1 class="chapter">
<h1 class="chapter">Chapter 20 Human Development</h1>
<level2 class="section">
<h2 class="section">Human Embryo at 3 Weeks Postovulation</h2>
<p>The period of the embryo is characterized by rapid growth, differentiation of the major organ primordia, and the development of the main features of external form.</p>
...
</level2>
<level2 class="bibliography">
<h2 class="bibliography">Selected Readings</h2>
<list>
<li><cite>Arey, L 1965. Developmental Anatomy. 7th ed. Saunders. Philadelphia.</cite></li>
<li><cite>Boving. B.G. 1965. Anatomy of reproduction. In J.P. Greenhill (ed.), Obstetrics, 13th ed. Saunders, Philadelphia.</cite>
</li>
...
</list>
</level2>
</level1 >
Definition: An index is intended to record and provide access for the reader to every pertinent statement within the body of the text. (The subject matter and purpose of the book determine which statements are pertinent and which are peripheral.)
Indexes usually include both proper-name and subject entries at a minimum. If the material is complex two indices are prepared: one of persons only and one of subjects and other proper names. Some indices (e.g. poetry) may require a subject index, and index of titles and first lines.
Indexes are comprised of entries: the principal subdivision of an index. It consists of a heading which identifies the subject of the entry; and a locator which tells the reader where to find material pertaining to the subject. In most cases, it is a page number or sequence of page numbers but it may also be a section number, chapter or paragraph number.
Markup: Indices form part of the rear matter of a work and are marked with a level1 tag. The index may be subdivided alphabetically in which case each alphabetic division is marked with a lower level heading. The index entries follow the markup used for nested lists.
See Block Elements: Information Object: List
To make an index useful in a DTB, links must be included from each page reference in the index to the page specified.
Elements:
<level1 class="index"> <h1 class="index">Index</h1> <level2 class="alphabetic_division"> <h2 class="alphabetic_division">A</h2> <list> <li>Aardvark <a href="#p23">23</a>, <a href="#p45">45</a></li> <li>Avocado <a href="#p44">44</a>, <a href="#p67">67</a></li> </list> </level2> </level1>
Example:
<level1 class="index">
<pagenum page="normal" id="pp197">197</pagenum>
<h1 class="index" >Index</h1>
<level2 class="alphabetic-division">
<h2 class="alphabetic-division">A</h2>
<list class="index">
<li>About-Point technique, <a href="#p55">55</a></li>
<li>Acronym, <a href="#p116">116</a></li>
<li>Action plans for good reading, <a href="#p5">5</a></li>
<li>Affixes, <a href="#p132">132-134</a></li>
<li>Antonym, finding word meaning through context, <a href="#p126">126</a></li>
<li>Application level thinking, <a href="#p89">89-90</a></li>
<li>Association, for improved memory, <a href="#p117">117</a></li>
<li>Attack plan, word, <a href="#p134">134</a></li>
<li>Audience, communicating through good writing to, <a href="#p141">141</a>, <a href="#p155">155</a></li>
</list>
</level2>
<level2 class="alphabetic-division">
<h2 class="alphabetic-division">B</h2>
<list class="index">
<li>Bookmark, Question Mark, <a href="#p28">28</a></li>
<li>Brainstorming, for writing narrative, <a href="#p76">76-78</a></li>
...
</list>
</level2>
...
</level1>
In this section we have demonstrated the use of the level1-level6 tags to identify the major structures of a book and the h1-h6 tags to mark the headings of those structures. We have also recommended that the div tag be used in the front matter for structures without headings. An alternative to using this markup would be to use the "<level>" tag along with an attribute called "depth," which indicates the absolute level of the structure being tagged. A "<levelhd>" tag would be used to identify the heading inside each of these levels. Whereas the level1-level6 tags can only mark a total of six levels, the level tag can be used recursively; that is, it can be used to mark any number of levels.
This option is provided for future use when software becomes available that allows the effective use of the recursive structuring technique to mark up documents.
Markup: <Level> should be used recursively to identify all structural elements in the book.
Elements:
<level depth="n">...</level> <levelhd>...</levelhd>
Example:
<level depth="1" class="part">
<levelhd depth="1" class="part">Part 1...</levelhd>
<level depth="2" class="chapter">
<levelhd depth="2" class="chapter">Chapter 1...</levelhd>
<level depth="3" class="section">
<levelhd depth="3" class="section">Section 1...</levelhd>
</level>
</level>
</level>
Copyright © 2002 DAISY Consortium