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?


Hi,

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*,
  db.toplevel.blocks.or.sections,
  db.navigation.components*

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 
schema?


Thanks,
  Tom

------
[1] http://www.docbook.org/tdg51/en/html/topic.html
[2] http://www.docbook.org/xml/5.1b2/rng/docbook.rnc
[3] 
http://sourceforge.net/tracker/index.php?func=detail&group_id=21935&atid=384107&aid=2820190


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