RFEs item #3571149, was opened at 2012-09-24 02:31
Message generated for change (Tracker Item Submitted) made by tom_schr
You can respond by visiting:
https://sourceforge.net/tracker/?func=detail&atid=384107&aid=3571149&group_id=21935
Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: DocBook XML
Group: v5.1
Status: Open
Resolution: None
Priority: 5
Private: No
Submitted By: Thomas Schraitle (tom_schr)
Assigned to: Norman Walsh (nwalsh)
Summary: Allow Article inside Set
Initial Comment:
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
----------------------------------------------------------------------
You can respond by visiting:
https://sourceforge.net/tracker/?func=detail&atid=384107&aid=3571149&group_id=21935
|