DocBook Technical Committee Meeting Minutes: 20 April 2011
=============================================================
The DocBook Technical Committee met on Wednesday, 20 April 2011 at
01:00p EDT for 90 minutes.
1. Roll call
Present:
Dick Hamilton, Nancy Harrison, Scott Hudson,
Jirka Kosek, Larry Rowland, Bob Stayton
Regrets:
Paul Grosso, Norm Walsh
Absent:
Gershon Joseph
2. Accepted the minutes [1] of the previous meeting.
3. Next meeting: 18 May 2011
Dick has conflict.
4. Review of the agenda.
No new items.
5. Review of open action items
a. Larry to review the DocBook 5.1 schema to see if it reflects
his notion of the current state of play for assembly.
CONTINUED
b. Jirka to write the simplification proposal as a new appendix of
the transclusion document.
COMPLETED
c. Norm to ask what the submitter of RFE 3163121 intends to do with the
preface
if not print it as a book? (Completed 3/16)
COMPLETED
d. Norm to add dediction to article (RFE 3171553).
COMPLETED
e. Norm to add class="other" and otherclass attributes to systemitem.
(RFE 3174769)
COMPLETED
f. Norm to allow xi:include in set (RFE 3199793).
COMPLETED
6. Publishers Schema promotion
a. Add to docbook.org.
Scott wanted to create a flattened single-file version of
the Publishers schema, but was not successful.
Otherwise we will have to create a zip file for all the modules.
Jirka suggests that he can do it.
ACTION: Jirka to create single file Publishers schema.
b. Stylesheets.
Scott says some XSL stylesheets may be available for Publishers
from Nik Gibson.
c. Documentation
The Publishers Schema should be added to DocBook: The Definitive
Guide. Nancy wonders where it should appear and how it
should be presented. Maybe we should write a separate
article too.
ACTION: Bob to query Norm about adding Publishers Schema to TDG.
7. Simplified DocBook 5
Scott suggested we needed driver file to define it and
a means to create a flattened schema file.
Nancy: are there any changes in DocBook 5 that affect Simplified?
Bob: continue to only support article, not book?
Since we have Publishers for books, we can keep
Simplified with just article. We should keep
it close to the version based on DocBook 4.5.
ACTION: Bob to send note to Norm asking if he can create
a Simplified DocBook 5 schema. Scott said he could help.
8. DocBook assembly.
Bob: What steps are needed to complete this work?
Larry: need to finalize the schema. He needed the latest
version from SourceForge, but could not build assembly
from SVN. He will work with Norm to get the latest,
and the compare it to the minutes to make sure it
represents all the changes that have been discussed.
He will raise any issues that come up in email.
Question was asked about XSL support for processing
assembly.
ACTION: Bob to update his XSL stylesheet for building a
DocBook document from an assembly.
Larry suggested later also implementing an XSL to
generate DocBook website from an assembly.
Norm has written a chapter in the 5.1 TDG [2]
that needs reviewing for the latest updates.
Dick was wondering if assembly could be generalized
beyond DocBook for use by other schemas. Larry
said some DocBook specific elements would need
to be modified.
When the schema and stylesheets are available, Scott said
he could do some experimental work with converting content.
9. Transclusion in DocBook.
Jirka submitted an update [3] to this proposal adding
Appendix D describing a simpler alternative proposal
from Hussein Shafie.
Nancy was concerned that it did not allow overrides,
which has become important in DITA, even though it
complicates things.
Bob: we seem to be leaning toward a simplified
transclusion mechanism.
If we simplify, we need to remember that the
original motivation was to overcome the limitations
of XInclude, the primary one being ID duplication
for repeated content.
Larry: Also, different implmentations of XInclude support
different schemes, so not compatible between tools.
A DocBook implementation in XSL would be universal.
Dick: basic choice is using an empty element with
@ref attribute, or use a dedicated ref element.
ACTION: Jirka will write up a comparison of these
two approaches.
Nancy: has a DocBook transclusion processor
been implemented?
Jirka: yes, in XSLT 2.0. It could be ported to XSLT 1.0.
Nancy: is order of processing of conditional text and
transclusions important? Jirka thinks we can do
transclusions first and then conditional text.
ACTION: Nancy will review the DITA discussion of this
issue of processing order.
Dick: if we want support in XML editing tools, then being
unnecessarily different from DITA's conref will
limit that support.
Scott: do we want another meeting before 18 May?
The TC decided to wait to see how much progress we
can make in the next week before deciding through
email to have another meeting.
10. Review of Requests for Enhancement
To browse a specific RFE, enter the URL (on one line):
http://sourceforge.net/tracker/index.php?func=detail&;;
group_id=21935&atid=384107&aid=XXXX
RFEs to revisit for 6.0
1907003 biblioid content model too broad
RFEs under discussion
1679665 Add better support for modular documentation
2820190 add a topic element
2820947 Ability to transclude text
3035565 Allow sections at any level
3107140 aconym expansion inline
3146537 HTML forms elements are missing from DocBook 5 schemas
3156768 <result> tag
3163121 Add <preface> as a child of <set>
New RFEs
3227210 missing attributes for informaltable (html)
Approved.
3274136 Production markup is too limiting
3287339 Add ISTC to class attribute for biblioid
ACTION: Bob to investigate ISTC and report to the TC.
-----
[1] http://lists.oasis-open.org/archives/docbook-tc/201103/msg00010.html
[2] http://docbook.org/tdg51/en/html/ch06.html
[3] http://docbook.org/docs/transclusion/#d6e445
Bob Stayton
Sagehill Enterprises
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
