#285 allow empty hierarchical elements


When modularizing documentation, it is sometimes necessary to create empty modular elements whose content will be supplied during the assembly process. For example, a chapter might not need any introductory paragraphs and so just begin with the first section. If the chapter and sections are all in modular files that are put together with the new assembly element, then the chapter should contain only a title (and other info elements). However, such a nearly empty chapter does not currently validate, because a chapter must have either block content or sections (or both). To better support modularity, a chapter should be permitted to be empty of content. The same is true of appendix, preface, section, and topic.

I propose that the content models be modified in 5.1 to allow for nearly empty elements.


  • Norman Walsh

    Norman Walsh - 2011-07-20
    • status: open --> open-accepted
  • Norman Walsh

    Norman Walsh - 2011-07-20

    We'll make block content optional in hierarchy elements

  • Norman Walsh

    Norman Walsh - 2012-04-23
    • status: open-accepted --> open-fixed
  • Norman Walsh

    Norman Walsh - 2012-04-23

    Fixed in 5.1b7 I believe.


Log in to post a comment.

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

JavaScript is required for this form.

No, thanks