#299 Allow Article inside Set

v5.1
closed-fixed
5
2013-02-19
2012-09-24
No

Hi,

according to the TDG[1], <set> allows another <set> or <book>, but no <article>. I would like to propose to include article as a possible child of <set> in the DocBook schema.

Documentation for software products often contains not only Reference Manuals, but also Whitepapers and Quick Starts. The latter two are
typically <article>s.

In order to bundle the complete product documentation into a <set> to allow cross-linking, it currently is necessary to bundle the <article>s
into a <book>. This is unfortunate, when
a) only having one article that needs to be added,
b) a number of articles covering not-related topics
c) generating HTML/ePUB for the whole set (see TOC)

For this reason, I think, an <article> would perfectly fit as a possible child of <set>. It avoids the need to create additional book structures
just for the sake of being able to add articles to a set.

Thanks!

--- References:
[1] http://www.docbook.org/tdg/en/html/set.html

Discussion

  • Norman Walsh

    Norman Walsh - 2012-11-14

    Fixed in 5.1

     
  • Norman Walsh

    Norman Walsh - 2012-11-14
    • status: open --> open-accepted
     
  • Norman Walsh

    Norman Walsh - 2012-11-14
    • status: open-accepted --> open-fixed
     
  • Robert Stayton

    Robert Stayton - 2013-02-19
    • status: open-fixed --> closed-fixed
     

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