From zedwiki

Books

Explanation of Text Elements

(RNIB Book version 1.51)

[Main items which are optional are marked in this list with a ?. The question mark is not part of the tag. Specific items such as list which are obviously optional have not been so marked.]

book

This contains the whole book. The opening tag is required at the start of the book, and the closing tag at the end of the book. book consists of three elements: front, followed by body, followed by back. It can carry the lang attribute to mark it as being a specific foreign language, or English.

ver

This element states the version of the system used to create and process the document. Such information is required for archiving purposes, but is not part of the original document, and is not usually output.

comment ?

This is an optional comment which may be placed at the beginning of a document, for example it could be a note the author may make to him or herself. It is not usually output.

front

This contains all the items before the main sections in the book: a banner logo for the book (bannerlogo), the title information (titleinf), bibliographic information (bibinfo), extraneous text (extraneous), the contents, preface and dedication. One or more additional sections may be included in addition to the preface to allow for other prefatory items, such as a foreword, or media specific additions. A bibliography may also appear in front.

body

This contains all the main sections in the book.

back

This contains all the end matter in the book: one or more glossary, bibliography, booknotes and index. Additional sections may also be included to allow for other end items, such as appendices.

bannerlogo ?

This is an optional element which may occur as the first item in front, indicating the presence of a banner logo to be used in the outputs where appropriate. (E.g. it may be the RNIB print logo and/or the RNIB audio logo.) It has a required attribute, type, which may have the values "RNIB" or "other". There are also optional attributes: imgsrc, for the filename of the graphic file, and sndsrc, for the filename of the audio file. If "RNIB" is chosen as the value of type, imgsrc and sndsrc can be omitted, as default values are then inserted if empty.

titleinf

This is book's title information, and is the first item in front. It consists of the title, possibly one or more subtitles, the author, possibly one or more subauthors, possibly a series title, and the publication details (titledet).

title

This is the title of the book, and is the first item in titleinf.

subtitle ?

This is a subtitle of the book, and if present follows the title in titleinf. More than one subtitle may be present.

author ?

1. This is the author of the book, and is the second item in titleinf. It may be absent.

2. It may be used at the beginning or end of a poem to state its author.

3. It is used within a bibliography entry (bibentry) to state the author of the publication listed. Include any punctuation after the author within the author tags.

subauthor ?

This is information following the author in titleinf, referring to an editor or the author of an introduction, etc. Include any accompanying text such as "Edited by" within the tag, or in a separate subauthor tag. More than one subauthor element may be present, or it may be absent.

series ?

This is the title of a series to which the book belongs, and if present follows the author or subauthor in titleinf.

titledet ?

This contains the publishing details for the original book, and is the third item in titleinf. It may be absent. It can contain the publisher's address (pubaddress), previous edition dates (prevedition), the imprint date, the isbn number. Any of these items may be absent.

pubaddress ?

This is the publisher's address as given in the original book. It may be absent.

prevedition ?

This states the publication date of a previous edition. Each such item of information is enclosed in separate tags. E.g. <prevedition>First published 1988</prevedition> <prevedition>Reprinted 1990</prevedition>. It may be absent.

imprint ?

This states the date of the copy of the book being worked on. It may be absent.

isbn ?

This is the ISBN number (if present). Include the abbreviation ISBN.

bibinfo

This is an element which can contain additional bibliographic information for the book. [We do not expect to use this for the trial: although the tags must be present, there will be no text to be put between them.]

extraneous ?

This is any extraneous text found on the cover, or at the beginning or end of the book, and may be absent. It can contain a heading (head), followed by paragraphs (p), lists, etc., and subsections (extrsection). More than one extraneous section is allowed.

head

This element name is used for all the headings in the book, e.g. at the start of extraneous text (if present), at the start of the contents, at the start of sections, etc. It can carry the lang attribute to mark it as being a specific foreign language, or English.

subhead ?

This is a subheading, following a head at the beginning of a section or subsection. More than one may be present, or it may be absent.

extrsection ?

This is a sub-division within extraneous text. It can contain a heading (head), followed by one or more paragraphs (p), lists, etc. It may also contain a further level of sub-division, extrsubsect1.

extrsubsect1 ?

This is a sub-division within extrsection. It can contain a heading (head), followed by one or more paragraphs (p), lists, etc.

contents ?

This is the original book's contents, and contains the heading (head), which may be followed by an (fentries) element containing front matter entries, body entries (entry1, entry2, etc.), and a (bentries) element containing back matter entries, if present.

fentries ?

This can occur the contents, and contains entries (entry1, entry2, etc.) for items in the front of the book.

bentries ?

This can occur the contents, and contains entries (entry1, entry2, etc.) for items in the back of the book.

entry1 ?

This is a main entry in the contents corresponding to a section in the book. It can also occur within the fentries and bentries elements in the contents where it corresponds to main items within the front or back of the book. It consists of the name (secname) and the page number (pageno).

entry2 ?

This is a second-level entry in the contents. It can also occur within the fentries and bentries elements in the contents where it corresponds to second level items within the front or back of the book. It has the same structure as entry1.

entry3-6 ?

Four further levels of contents sub-entries are provided, and are similar to entry2.

entryp ?

This is a heading in the contents corresponding to major part in the book, and is typically centred in print without a page number. It consists of the name (secname) only.

secname

This is the name of any item (e.g. preface, section, index, etc.) used in the contents, and appears in its entry (entry1-entry6 or entryp) in the contents.

pageno

This is the starting page number of an item in the book, and appears after its name (secname) in its entry in the contents. This number will not be known when preparing the XML file, and so should be left blank.

preface ?

This is a preface, and appears (if present) after the contents in the front material. The preface is distinguished (along with the dedication) from other items which may appear after the contents, such as a foreword, which are tagged non-specifically as section. A preface and these other items may appear in any order, and more than one may be present. The preface may contain a heading (head) followed by paragraphs, etc. It may also contain sections.

dedication ?

This is a dedication, and appears (if present) after the contents in the front material. The dedication is distinguished (along with the preface) from other items which may appear after the contents, such as a foreword, which are tagged non-specifically as section. A dedication and these other items may appear in any order, and more than one may be present. A dedication may contain a heading (head) followed by one or more paragraphs (p), or poems.

epigraph ?

This is an epigraph, and can appear either after the contents in the front material, similarly to a dedication, or at the beginning of a section or subsection in the body, after the section headings. An epigraph may contain a heading (head) followed by one or more paragraphs (p), or poems, and may end with a source.

body

This follows front and contains all the main sections in the book.

section

This is a main section in the book (e.g. a chapter), and occurs in the front, body or back of the book. In the front of the book it may be used for a foreword or an author's note, etc.; at the back of the book it may be used for any appendices, etc. In either the front or the back of the book it should only be used if there is not a specific tag already defined for the item (e.g. as there are for preface, bibliography, index, etc.). A section contains a heading (head), possibly one or more subheadings (subhead), followed by the paragraphs, etc. which comprise the text of the section. It may contain subsections (subsect1). A section can have a medium attribute with values "braille", "print", "moon", "html" or "etext". Such an attribute should be used when the section is to appear in a particular medium only. For example it would be used for a Note to Braille Edition. It can carry the lang attribute to mark it as being a specific foreign language, or English.

subsect1 ?

This is a subsection within a section, and has the same structure as a section, except that a subsection within it is tagged as subsect2. It can carry the lang attribute. It can also carry the demote attribute with values 1 or 2 to mark that in certain outputs, e.g. braille, print and HTML, it will be formatted as if a subsection of 1 or 2 levels lower. This is useful for the situation where different sections in a book omit intermediate levels of headings and this feature needs to be retained in the outputs: rather than inserting extra layers of subsection with empty headings, you can use the normal hierarchy in the tagging but "demote" them with the attribute to achieve the desired output.

subsect 2-5 ?

Four further levels of subsection are provided. Just as for subsect1 they are contained in the higher level subsection to which they belong, and have a similar structure.

p

This is a paragraph. A paragraph can have a medium attribute with values "braille", "print", "moon", "html" or "etext". Such an attribute should be used when the paragraph is to appear in a particular medium only. For example it would be used for an explanatory note to be inserted into the braille only. It can carry the lang attribute to mark it as being a specific foreign language, or English.

list

This is a list, and contains one or more list items (litem), or further lists. A list can appear between paragraphs, etc., or within a paragraph. This tag should be used for lists which are normally specially displayed, e.g. on separate lines in print, but not for listed items occurring in the normal run of a sentence, such as "he saw: dogs, cats, geese". It can carry the lang attribute to mark it as being a specific foreign language, or English.

litem

This is an item within a list, and contains text (but not paragraphs). It can carry the lang attribute to mark it as being a specific foreign language, or English.

textbreak

This is a break in text between paragraphs, etc., typically shown in print a a line of asterisks or just a gap between paragraphs. (This is not used between paragraphs which are normally spaced.) This element should be left empty.

box

This is a boxed section of text, and can occur between paragraphs, etc. It can begin with a heading (head), followed by paragraphs, table, figure or graphic, and enddetails.

longquote

This a quoted extract of the kind which is usually displayed in print on separate lines as a block. It should not be used for ordinary speech as in a novel, nor for extracts which are included in the normal run of the text. It can occur within a paragraph when the extract is considered to be part of the current paragraph, or between paragraphs. It can itself contain paragraphs, which are tagged as lqpara rather than using the p tag. If the extract is considered to start mid-paragraph, that part-paragraph should be tagged as lqtext, rather than lqpara. A longquote may also contain lists, poems and plays, and may end with a source. It can carry the lang attribute to mark it as being a specific foreign language, or English.

lqpara

This is a paragraph within a longquote, and is used instead of the normal p. It may contain lists. It can also contain line numbers (lineno).

lqtext

This is a text within a longquote, which does not start as a new paragraph. It may contain lists. It can also contain line numbers (lineno).

source ?

This is a source, and may be used at the end of a longquote, poem or table to state its source. It can also be used within the element enddetails where a source is required after other items. It contains one or more elements (sourceelt).

sourceelt

This is an element within a source. It typically corresponds to an item set out on a separate line in print.

ppage

This is a print page indicator, used to mark page turns in the original document (if appropriate). It can appear within a stream of text (e.g. within a paragraph or heading), but not between paragraphs, etc. Where the model does not allow ppage between elements, insert it at the appropriate point at the beginning or end of an adjacent element. When inserting a ppage within a stream of text (e.g. within a paragraph) do not insert extra spaces. The single space usually present should come before the inserted ppage tag. ppage contains just the relevant page number, not any associated format, which will be added automatically according to the specific output medium.

poem

This is a poem or part of a poem. It can occur between paragraphs, etc., or within a paragraph. It can contain a heading (head), poetry lines (pline) and stanzas, and, if present, an author, notes (itemnotes) and source. This tag should be used for poems which may be specially displayed, e.g. on separate lines in print, but not for poetry occurring in the normal run of a sentence. A poem can have the attribute brlform with values "linebyline" or "linesign" which can be used to set the form of the braille output. The default (with no attribute set) is for line-by-line braille format.

pline

This is a poetry line. It may occur within a stanza, or directly within the poem tags. (The latter situation occurs when a poetry extract does not start at the beginning of a stanza.). It can also be used within a speech in a play, e.g. for Shakespeare plays. Any line breaks at runovers shown in the source text should be ignored; runovers are not tagged as separate poetry lines. This tag should only be used within the poem, stanza or speech tags, not for poetry lines occurring in the normal run of a sentence. When used in a speech in a play, the first pline follows the speaker, and plines may contain stage directions (stagedir), where they occur within that verse line. It can also contain line numbers (lineno).

stanza

This a stanza or verse of a poem. It is used within a poem or speechand contains poetry lines (pline). Within a speech it cannot be used at the start of a speech, directly after the speaker (where a stanza is already implied), but is used after other plines in the speech to indicate a new stanza. In a speech it is not necessary to start a stanza after a set out stage direction (stagedir), as a stanza is again implied; but if stanzas have been marked before the stage direction, there is no harm in starting a new stanza after the stage direction, for consistency.

itemnotes

This is a body of notes which may appear at the end of an item such as a poem, table, etc. It contains entries which consist of a note identifier (noteid) followed by the text of the note (notetext). Do not leave a space between the noteid and the notetext.

noteid

This is the number or other symbol used to identify a note within a list of notes at the end of a section or the whole book (in notelist), or at the end of some other item (in itemnotes), or within a footnote. It should correspond to a note reference in the text (noteref). Include the distinguishing feature of the mark, but not a regular feature. Thus for asterisked numbers only the number should be retained; for unnumbered asterisks leave the content empty, i.e. tag as <noteid></noteid>.

notetext

This is the text of a note. It appears after a note identifier (noteid) within a list of notes at the end of a section or the whole book (in notelist), or at the end of some other item (in itemnotes), or within a footnote. This tag should not be used for a comment or note which appears in the normal run of text in the original, but only where the note text is separated in some way from its point of reference. This applies even though the note may end up being inserted into the main text in one or more of the output media being produced. Besides direct text, notetext may also contain paragraphs (p). The paragraph tag is used where a new paragraph is started within a note, but not for the initial text.

secnotes

This is a body of notes at the end of a section or subsection in the book. It occurs within the section or subsection (subsect1, etc.) tags. It consists of an optional heading (head), possibly some paragraphs, lists of notes (notelist), and possibly subsections (notesection).

notelist

This is a list of notes, and occurs within secnotes, booknotes and notesection. It contains entries which consist of a note identifier (noteid) followed by the text of the note (notetext).

notesection

This is a subsection within a section of notes (i.e. in secnotes or booknotes). It has the same structure as secnotes, except that it cannot itself contain further notesections within it.

footnote

This is a footnote, and can appear within the normal stream of text, e.g. within a paragraph, but not between paragraphs. Typically one would insert the footnote into the text at the point of reference. It consists of a note identifier (noteid) followed by the text of the footnote (notetext). The corresponding note reference (noteref) is still required in the text, even though the footnote contains a note identifier (noteid). No space is required between the noteid and the notetext. When inserting a footnote within a stream of text (e.g. within a paragraph) do not insert extra spaces. The single space usually present should come after the inserted footnote.

noteref

This is a note reference mark occurring within the text, such as a number or asterisk. Include the distinguishing feature of the mark, not a regular feature. Thus for asterisked numbers only the number should be retained; for unnumbered asterisks leave the content empty, i.e. tag as <noteref></noteref>.

table

This is a table. It may occur between paragraphs, but not within a paragraph. It may contain a head, paragraphs, the main body of the table (tablebody), notes (itemnotes) and a source. A table can have the attribute brlform with values "para" or "table" which can be used to set the form of the braille output. The default (with no attribute set) is for paragraph braille format.

tablebody

This is the main body of a table, and occurs within a table. It may contain the element colheads which contains any column headings, and one or more rows.

colheads ?

This is the first item in the main body of a table (tablebody) and contains the column headings (chead). It will be absent if there are no column headings.

row

This is a row in the main body of a table (tablebody). Note that a row containing column headings is tagged as colheads, not row. A row may contain a row heading (rowhead) as the first item, followed by one or more data items (di) which contain the data in the table.

rowhead ?

This is a heading to a row in a table, and may be absent.

di

This is a data item (e.g. a number) in the main body of a table. It occurs within a row.

address

This is a postal address, and contains one or more address lines (addline). It can appear between paragraphs, etc., but not within a paragraph, and can occur at the beginning of a letter. This tag should be used for addresses which may be specially displayed, e.g. on separate lines in print, but not for addresses occurring in the normal run of a sentence, such as "write to: Mr Smith, 66 Park Road, Pinner".

addline

This is a line of an address. It may contain the addressee's name, an element of the postal address, or a phone number, etc.

figure

This is an illustration, and can occur between paragraphs, etc. It can contain a head, a caption, then either a graphic or a visual description (vdes).

caption

This is a caption to an illustration, and can occur in a figure element, after the head.

graphic

This element is used for an actual picture, and can occur within a figure, between paragraphs, or within a paragraph. It contains an image box (imgbox) which holds the picture, followed by a visual description (vdes).

imgbox

This element, "image box", contains a picture image (image). It occurs in a graphic element. imgbox has a position attribute which can be set to "centre" when it is required that the image is centred on a separate line, rather than appearing within a line of text.

image

This is a picture image, and occurs in a image box (imgbox). It has a source attribute which states the filename of the picture (e.g. source="c:\docs\house.bmp"), and a width attribute which sets the size of the picture.

vdes

This is a visual object description, i.e. usually a description of an image. It is used to give a description which will appear as a substitute for the image itself in media other than print. It can occur after an image box (imgbox) in a graphic (where it is used to describe that image); or directly in a figure where no actual graphic is present but a description only is required; or within a paragraph, again to add such a description without a graphic.

vdesp

This is similar to vdes as used without an actual image, except that it constitutes a whole paragraph. It can occur between normal paragraphs

display

This is a group of one or more lines of text which are specially displayed on separate lines in the original; for example, lines of a notice set out in facsimile, or a line showing text typed in on a computer. It can occur between paragraphs, etc., or within paragraphs. It contains one or more displayed lines (displine).

displine

This is a single displayed line within a display. Do not use paragraph tags (p) within it.

play

This is a section of play material. It can occur between paragraphs, etc., but not within a paragraph; however, when such material appears within ordinary text it will normally be placed within a longquote. It can contain stage directions (stagedir), and speeches (speech). For a complete play, the acts and scenes are typically sections and subsections (subsect1), and the play tags have to be opened and closed within each such section or subsection.

stagedir

This is a stage direction in a play. It can occur directly within the play tags (i.e. before or between speeches) when the stage direction is set out on separate lines between speeches in the original; within a speech when the stage direction appears on separate lines but within a speech; or within speech text (spchtext) or a verse line (pline) when it appears within the line of speech text or verse. Do not use formatting for the stage direction, such as square brackets, as this is added as required for the output medium. Do not use the paragraph tag (p) within stagedir. Characters within a stage direction should be tagged using the character tag. It can also contain line numbers (lineno).

character

This is a character's name cited in a stage direction (stagedir). Do not use this tag outside stagedir, e.g. within the normal text of a speech.

speech

This is a speech in a play. It starts with the speaker, followed by the text of the speech (spchtext) or verse lines (pline). It may contain a stage direction (stagedir), to be used for those appearing within the speech but on separate lines.

speaker

This is the name of a speaker, and is the first element in a speech within a play. Include punctuation after the speaker's name as required, but exclude the space before the text of the speech. It can contain a line number (lineno).

spchtext

This contains the words spoken by a speaker within a speech. It may also contain stage directions (stagedir) for those appearing within lines of speech text, and a line number (lineno).

lineno

This contains a line number, as in line-numbered text. It can appear in the text of play speeches (speaker and spchtext), stage directions (stagedir), quoted extracts (lqpara and lqtext), and poetry lines (pline). It should be placed before and unspaced from the first word of the line to which it refers.

letter

This is a letter, i.e. correspondence. It can occur between paragraphs, etc., but not within a paragraph; however, when such material appears within ordinary text it will normally be placed within a longquote. It can contain one or more address, phone or date at the beginning, followed by the recipient (if present); then paragraphs (p) or lists; then the valediction, sender, senderinfo, enclosure (all optional).

phone

This is the phone number of the sender within a letter. It can appear before or after an address or date, and is optional.

date

This is the date at the head of a letter. It can appear before or after an address or phone number, and is optional.

recipient

This is the name of a recipient before the main body of a letter, and appears after the address, phone number or date, if present. Include "Dear" or whatever is required here.

valediction

This is the closing phrase such as "Yours sincerely" which occurs after the main body of a letter.

sender

This is the name of the sender of a letter, which occurs after the main body of a letter, after the valediction if present.

senderinfo

This is information about the sender of a letter, e.g. job title, etc., and appears after the sender, if present. More than one is permissible.

enclosure

This is information about any items enclosed with a letter, and is the last element in the letter element. Include any standard text such as "Enc:", etc., as this will not be put in automatically by the output process. More than one is permissible.

glossary

This is used for glossaries and similar items. In the main text (body) it can occur between paragraphs, etc., but not within a paragraph. It can also occur as a separate section within the end matter of a book (back). It can contain a heading (head), introductory paragraphs, etc., followed by one or more glossary entries (glositem).

glositem

This is an entry in a glossary. It consists of the term being explained, followed by the explanation (glostext). Do not leave a space between the term and glostext elements.

term

This is a term being explained in a glossary. It occurs as the first element in a glossary entry (glositem).

glostext

This is the explanatory text belonging to an entry in a glossary. It follows the term within a glositem. It contains one or more paragraphs (p). Note that any text must be enclosed within the paragraph tags.

enddetails

This can contain notes (itemnotes), source, author, and address. It may be used between paragraphs, etc. within a section, subsection (subsect1, etc.) or box when it is required to insert one or more of these items. For example, a source may be required after a play. Note that poem automatically provides for the inclusion of an author, notes and source, and table automatically provides for the inclusion of notes and a source, without the use of the enddetails tag.

subp1

This is first level sub-paragraph, and can occur within a paragraph (p). In the original it is indicated as being subordinate to the main paragraph, for example by having a further indented start. It has the same structure as a paragraph, except that a subparagraph within it is tagged as subp2.

subp2

This is a second level sub-paragraph, and can occur within a first level sub-paragraph (subp1). In the original it is indicated as being subordinate to the first level sub-paragraph, for example by having a further indented start. It has the same structure as subp1, except that there is no provision for a subparagraph within it.

i

Italics. Use this for italicised words in the normal stream of text, not for headings, etc. For italicised paragraphs, the i tags should be within the paragraph tags.

b

Bold. Use this for bold words in the normal stream of text, not for headings, etc. For bold paragraphs, the b tags should be within the paragraph tags.

u

Underline. Use this for underlined words in the normal stream of text, not for headings, etc. For underlined paragraphs, the u tags should be within the paragraph tags.

sup

This is a superscript.

sub

This is a subscript.

computer

Computer text. Use this for e-mail addresses, computer filenames and the like.

email

E-mail address.

web

Internet web address.

acronym

Acronym. Use this for acronyms like BBC and RNIB, am and pm, but not abbreviations which are parts of words, such as Mr, Rd, St. Do not use for unit abbreviations. A plural "s" should be left outside the closing tag.

braille

This is text in braille font, as may appear in leaflets explaining or mentioning braille.

flang

This is foreign language text. The tag may be used within paragraphs, etc., but may not be used to contain paragraphs. flang has a lang attribute with values "english", "french", "german" or "spanish", by which the language may be specified, if one of these. Other languages should have no attribute assigned.

stext

This is special text which is marked in the file in order to give additional control of the outputs. (1) Applying the medium attribute to stext forces the text to appear in a specific medium only, such as an explanatory remark relating to that medium only. Values of the medium attribute are "braille", "print", "moon", "html", "etext" or "daisy", which indicates the target medium. (2) Applying the say attribute to stext controls the synthetic speech pronunciation. The values of the say attribute can be "number" to obtain the correct pronunciation of decimal numbers; "spell-out" which will force the text to be read out character by character; "date" to force a number to be read as a date rather than as an ordinary number (for the Rhetorical voice this seems to be necessary only for dates prior to 1700); "cardinal" to force a Roman number to be read as "first", "second", etc.; "ordinal" to force a Roman number to be read as "one", "two", etc. The use of this element to control synthetic speech only needs to be used in exceptional cases; items such as acronyms, phone numbers, email and web addresses, etc., are dealt with automatically by other means in the output process. Note also that the effect of this markup (e.g. whether it has any effect at all) is dependent on the facilities of the synthetic speech voice being used.

linkto

This gives a link to another location (e.g. as used for the HTML output). It can contain text (which typcally becomes highlighted in a browser indicating that there is a link on those words). It has an attribute "location", which should state the target of the link. The target can be the "name" of a bookmark in the same file (precede the bookmark name with #, e.g. #contents); a different file (the path is taken from the path of the current file - use / for subdirectories rather then \, e.g. docs/file2.htm); or locations on the web (the web name should start with http://). linkto also has an attribute "medium" which can be set to "html", in which case the text within it only appears in the HTML output. This is useful for links such as "Return to contents" which are only relevant for HTML.

bookmark

This is a bookmark, and can contain bookmarked text. It can be used to mark the target of a linkto element, and may also serve as a linking point from other sources (typically in the HTML output). The name of the bookmark is carried in its "name" attribute.

bibliography

This is a bibliography, and can occur within the front matter (front) or end matter (back). It starts with a heading (head), and then may contain paragraphs etc., lists of bibliographic entries (biblist), and subsections (bibsection).

biblist

This is a list of bibliographic entries in a bibliography. It contains bibentrys.

bibentry

This is bibliographic entry, and is contained in biblist in a bibliography. It consists of the author followed by one or more publication titles. Do not leave a space between the author and the publication, but include any punctuation after the author within the author tags.

publication

This is the title of a publication within a bibliography. It appears after the author within a bibentry.

bibsection ?

This is a subsection within a bibliography. It has the same structure as bibliography, except that there is no provision for a further level of subsection within it.

booknotes

This is a section of notes which appears collected together at the back of the book in the original. It is used within the end matter (back), and may be absent. It consists of a heading (head), possibly some paragraphs, lists of notes (notelist), and possibly subsections (notesection).

index

This is an index. It appears as the last item of end matter (back), and may be absent. It consists of a heading (head), possibly some paragraphs, then up to four levels of index entries, ientry1, ientry2, ientry3, ientry4; or index sections, isect.

isect

This is an alphabetic section in an index, and contains an optional head, then up to four levels of index entries, ientry1, ientry2, ientry3, ientry4.

ientry1

This is a first level index entry, and can occur directly in an index, or within an index section (isect). It contains the text of the entry (including the page number).

ientry2

This is a second level index entry, and is similar to ientry1.

ientry3-4

Two further levels of index sub-entries are provided.

SJP

31/5/07