OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: DocBook v5.1: No topic in appendix and chapter?


according to the TDG's topic[1] description, "appendix, book, chapter, part" 
are the parent elements of topic.

However, for the current 5.1 beta2 DocBook schema[2] this seems correct for 
book and part only, but not for appendix or chapter. Further investigation 
lead to the following definitions in the schema:

db.chapter =
    ## A chapter, as of a book
    element chapter {
      db.chapter.attlist, db.chapter.info, db.component.contentmodel

db.component.contentmodel =

db.navigation.components =
  notAllowed | db.glossary | db.bibliography | db.index | db.toc

db.toplevel.blocks.or.sections =
  (db.all.blocks+, db.toplevel.sections?) | db.toplevel.sections

Same for appendix. Futhermore, the RFC "add a topic element"[3] states:

 7. Allow topic as a child of chapter or appendix, but not
    as a sibling of section. [...]

Is this an oversight? Which one is correct, the documentation or the DocBook 


[1] http://www.docbook.org/tdg51/en/html/topic.html
[2] http://www.docbook.org/xml/5.1b2/rng/docbook.rnc

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]