Bug 469286

Summary: screen inside para outputs invalid XHTML
Product: [Community] Publican Reporter: Jeff Fearn <jfearn>
Component: publicanAssignee: Jeff Fearn <jfearn>
Status: CLOSED CURRENTRELEASE QA Contact: Content Services Development <ecs-dev-list>
Severity: medium Docs Contact:
Priority: urgent    
Version: 2.0CC: mmcallis, publican-list
Target Milestone: ---Keywords: Documentation
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: 0.39 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2008-11-03 01:36:09 EST Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:

Description Jeff Fearn 2008-10-30 23:26:21 EDT
Description of problem:
All publican output should be XHTML 1.0 strict compliant.

Nesting a screen in a para, which is legal DocBook, outputs invalid XHTML.

Version-Release number of selected component (if applicable):
0.38

How reproducible:
Always

Steps to Reproduce:
1. Nest a screen in a para
2. make html-single-en-US
3. xmllint --valid --noout tmp/en-US/html-single/index.html
  
Actual results:
index.html:226: element p: validity error : Element pre is not declared in p list of possible children

Expected results:
no errors

Additional info:
In XHTML p is only permitted to include inline items. In DocBook para is permitted to contain block level tags. Consider switching p output to <div class="para"> as div is allowed to contain block level elements.

Consider running xmllint over Users_Guide when building publican-docs package.

It would be neat to have a big book of DocBook examples that we could use to test all possible combinations of DocBook tags.
Comment 1 Jeff Fearn 2008-11-03 01:36:09 EST
Changed para and simpara to output as div, modified CSS to display correctly.

validated XHTML output of Publican User Guide.
Comment 2 Fedora Update System 2008-12-01 00:39:44 EST
publican-0.39-0.fc9,publican-fedora-0.16-0.fc9 has been submitted as an update for Fedora 9.
http://admin.fedoraproject.org/updates/publican-0.39-0.fc9,publican-fedora-0.16-0.fc9
Comment 3 Fedora Update System 2009-01-14 21:56:24 EST
publican-0.39-0.fc9, publican-fedora-0.16-0.fc9 has been pushed to the Fedora 9 stable repository.  If problems still persist, please make note of it in this bug report.