Bug 1053928
| Summary: | Add Build/XML Validation support for DocBook 5 | ||||||
|---|---|---|---|---|---|---|---|
| Product: | [Community] PressGang CCMS | Reporter: | Lee Newson <lnewson> | ||||
| Component: | CCMS-Core | Assignee: | Lee Newson <lnewson> | ||||
| Status: | CLOSED CURRENTRELEASE | QA Contact: | |||||
| Severity: | unspecified | Docs Contact: | |||||
| Priority: | unspecified | ||||||
| Version: | 1.3 | CC: | mcaspers | ||||
| Target Milestone: | --- | ||||||
| Target Release: | 1.4 | ||||||
| Hardware: | Unspecified | ||||||
| OS: | Unspecified | ||||||
| Whiteboard: | |||||||
| Fixed In Version: | Doc Type: | Bug Fix | |||||
| Doc Text: | Story Points: | --- | |||||
| Clone Of: | Environment: | ||||||
| Last Closed: | 2014-02-23 23:43:50 UTC | Type: | Bug | ||||
| Regression: | --- | Mount Type: | --- | ||||
| Documentation: | --- | CRM: | |||||
| Verified Versions: | Category: | --- | |||||
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |||||
| Cloudforms Team: | --- | Target Upstream Version: | |||||
| Embargoed: | |||||||
| Bug Depends On: | |||||||
| Bug Blocks: | 1051919 | ||||||
| Attachments: |
|
||||||
|
Description
Lee Newson
2014-01-16 01:57:07 UTC
Additional Note that isn't mentioned in the above links is that <revhistory> can no longer be a child of <simpara>. As such it should now be a direct child of <appendix> instead of being wrapped in the <simpara>. The <author> element also has changed, as <firstname> and <surname> now need to be a child of <personname>. ie:
<author>
<personname>
<firstname>Lee</firstname>
<surname>Newson</surname>
</personname>
<email>lnewson</email>
</author>
instead of:
<author>
<firstname>Lee</firstname>
<surname>Newson</surname>
<email>lnewson</email>
</author>
Created attachment 860374 [details]
Customised docbook.rng
Attaching a customised version of the docbook.rng schema which removes the IDREF check on xref linkend attributes. This is required for validation of single topics since the xref won't exist until the book is compiled when using injections.
Another thing to note is that <sectioninfo> elements used to have to be before the <title>. However in DocBook 5.0 they now need to be after the <title> element. Added in 1.4-SNAPSHOT build 201402101456 The validator will now validate against the DocBook 5.0 Relax NG schema when the Content Spec Format is set to DocBook 5.0. The builder will also produce DocBook 5.0 valid syntax taking all of the above into account. Additionally to make publican build, the dtdver: "5.0" publican.cfg value is added when building. Confirmed that a DocBook 5 spec with DocBook 5 topics is built by csprocessor and then built by Publican 4. Confirmed that topics that were valid under Docbook 4.5 are now being identified as invalid under docbook 5.0. Updated the builder to include the DocBook 5.0 namespaces and xlink namespace. Confirmed that the bugzilla links no longer break the Docbook 5 builds. I will test some more Docbook 5 content tomorrow. Fixed the build issue in 1.4-SNAPSHOT build 201402130848 The problem was caused by not adding the DocBook 5.0 namespaces to some of the error templates. This was then causing the validation pass to fail and show the error template in the "Error" chapter, instead of the normal topic XML. Looks like a wrapping issue, as the content has been wrapped in another <abstract>. Will look into it, thanks Matt. Confirmed that csprocessor 1.4-13 fixes the above issue. Confirmed that 1.4-14 fixes the entities issue. https://bugzilla.redhat.com/show_bug.cgi?id=1066235 is the only outstanding issue, and it is related more to the validation of topics than anything to do with docbook 5, so I'm going to call this one verified. |