Bug 697366 - Include DocBook 5-compatible templates
Summary: Include DocBook 5-compatible templates
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Publican
Classification: Community
Component: publican
Version: 2.5
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
Assignee: Jeff Fearn 🐞
QA Contact: tools-bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-04-18 03:29 UTC by Ruediger Landmann
Modified: 2013-12-19 02:46 UTC (History)
3 users (show)

Fixed In Version: 4.0.0
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2013-12-19 02:46:44 UTC
Embargoed:


Attachments (Terms of Use)

Description Ruediger Landmann 2011-04-18 03:29:44 UTC
Publican's templates for <book>, <article>, and <set> are not DocBook 5 compatible.

Specifically:
* <bookinfo>, <articleinfo>, and <setinfo> are all just <info> in DocBook 5
* <pubsnumber> is <biblioid>
* <corpauthor> is <orgname>
* the id= attribute is now xml:id throughout
* <firstname> and <surname> must be wrapped in <personname> in DocBook 5
* <revhistory> can no longer be a child of <simpara> (<para> works fine though)

Comment 1 Stephen Gordon 2013-01-07 19:51:29 UTC
(In reply to comment #0)
> * <revhistory> can no longer be a child of <simpara> (<para> works fine
> though)

As it turns out the <revhistory> can actually be included directly in the <appendix>. I noticed another issue here though in that:

- <revhistory> cannot be included directly in the <book> (unlike an <article>) which is why we have it in an appendix.
- An <appendix> must have a title.
- A <revhistory> must also have a title.

The last of these appears to be new in DocBook 5 [1] (previously <revhistory> could only contain <revision> [2]). The result of this is we end up with redundant titling in our use case.

[1] http://www.docbook.org/tdg5/en/html/revhistory.html
[2] http://www.docbook.org/tdg/en/html/revhistory.html

Comment 2 Stephen Gordon 2013-01-07 19:56:03 UTC
(In reply to comment #1)

Interestingly even when I do add a <title> to both the <appendix> and the <revhistory> elements I still get this error:

Element title in namespace '' encountered in revhistory, but no template matches.

Comment 3 Stephen Gordon 2013-01-09 17:55:36 UTC
(In reply to comment #1)

> - A <revhistory> must also have a title.

Looking further this seems to be incorrect, the title is actually optional, though if you do choose to include it you do get the error I indicated in comment # 2.

Comment 4 HSS Product Manager 2013-09-10 23:57:32 UTC
HSS-QE has reviewed and declined this request. QE for this bug will be handled by IED.

Comment 5 Jeff Fearn 🐞 2013-09-11 02:35:21 UTC
The basic code is in place.

$ publican create --dtdver 5.0 --name Test_DB5_Book

"dtdver" is temporary, there will be a better named option after more splitting of hairs. But you can create and validate/build this DocBook5 book.

To ssh://git.fedorahosted.org/git/publican.git
   4be1028..7d23e61  HEAD -> devel

Comment 6 Jeff Fearn 🐞 2013-09-17 06:35:38 UTC
This is in place in devel branch and can be tested.

Suggestions on alternative names for --dtdver accepted.

Comment 7 Ruediger Landmann 2013-10-14 06:08:35 UTC
Working as advertised in publican-3.9.9-0.fc19.t6.noarch


Note You need to log in before you can comment on or make changes to this bug.