This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Bibliographys in RefEntry
- To: docbook at lists dot oasis-open dot org
- Subject: DOCBOOK: Bibliographys in RefEntry
- From: Norman Walsh <ndw at nwalsh dot com>
- Date: Fri, 24 Aug 2001 17:34:25 -0400
- List-Id: <docbook.lists.oasis-open.org>
RFE 435518[1] requests a bibliography in a refentry. At the most
recent TC meeting, we weren't able to come to consensus on the right
solution to this problem.
If we accept that Bibliography, Glossary, and perhaps Index (BG&I) go
together, closer inspection of the RFE reveals that the author wants
BG&I to appear at the end of a refentry, not at the end of each
refsect1.
It's possible to argue that adding BG&I to the end of RefEntry would
seriously disturb the content model of RefEntry. On the other hand,
authors are currently forced to markup bibliography entries in a
References section of a RefEntry with non-semantic markup (using para,
for example).
This is sub-optimal because then stylesheets have no markup to do
proper Bibliography formatting or proper cross-reference formatting.
The problem is less pressing for Glossary because there's a GlossList
element that allows a glossary to appear in a refesect1.
It seems we have four choices:
1. Add a BiblioList element, to allow bibliography entries parallel to
GlossList
2. Add BG&I to the end of the content model of RefEntry
3. Reject the request noting that (a) there are workarounds today that
are better than either of the preceding alternatives and (b)
bibliographic references are perhaps more appropriate in a
Reference than a RefEntry (if a dozen refentrys cited the same
source, you wouldn't necessarily want it repeated a dozen times).
4. We've overlooked the clever solution that doesn't have any of the
problems of 1-3.
Comments, please.
Be seeing you,
norm
[1] http://sourceforge.net/tracker/index.php?func=detail&aid=435518&group_id=21935&atid=384107
--
Norman Walsh <ndw@nwalsh.com> | In science, "fact" can only mean
http://www.oasis-open.org/docbook/ | "confirmed to such a degree that
Chair, DocBook Technical Committee | it would be perverse to withhold
| provisional assent." I suppose
| that apples might start to rise
| tomorrow, but the possibility does
| not merit equal time in physics
| classrooms.--Stephen J. Gould
----------------------------------------------------------------
To subscribe or unsubscribe from this elist use the subscription
manager: <http://lists.oasis-open.org/ob/adm.pl>