Re: [docbook-apps] epub transform bug? sidebar without title bolds everything? (bad rendering in Firefox?)

[Keith Fahlgren <abdelazer@gmail.com>]

On Wed, Aug 19, 2009 at 1:38 AM, Robert Nagle<idiotprogrammer@gmail.com> wrote:
>  I've been having issues with epub output of a docbook 5 project.

I am able to reproduce what you describe below.

> This
> problem does NOT occur when I use the HTML chunk XSL transform.

I disagree. The HTML output is (onechunk):

    <p>This is a test before sidebar. </p>
    <div class="sidebar"><p class="title"><b></b></p>


> I have 3 questions:
>
>  1. why does epub HTML  output for sidebar.title include a <b/> tag?

There is a bug in the HTML, XHTML, XHTML 1.1, and (therefore) EPUB
stylesheets that outputs an empty <p class="title"> containing a <b>
when a DocBook 5.0 (?) sidebar does not have a title. Please create a
new bug: http://sourceforge.net/tracker/?group_id=21935&atid=373747

>  2. why does  <b/> in Firefox and IE cause all remaining html
> paragraphs to render as bold when a title element in sidebar is empty?

IE has problems with "self-closing" tags in XHTML.  I can't reproduce
the problem with Firefox 3.5.2 on Mac with either xhtml/onechunk.xsl
or html/onechunk.xsl, but I do see it if I unzip the EPUB output.

>  3.is there a docbook way to suppress the display of the
> sidebar.title? (I know you could do it in css).

No, I think we just fix the stylesheets.

In the mean time, you could customize the xhtml-1_1/block.xsl template
for "abstract|sidebar" to make sure it checks for the title before
calling formal.object.heading.

> If sidebar.title is to be visible, it would seem odd for the html
> output to use <b> (instead of <strong> for example).

There's a lot of in the DocBook (X)HTML output that isn't as semantic
as it could be.

> Below is a version of
> it without xincludes to illustrate the problem.

Thank you for including a sample. This helps tremendously in locating
the problem.

> Looking at docbook reference
> http://www.docbook.org/tdg5/en/html/sidebar.html , I see that sidebar
> requires a title --even though my docbook validated just fine without
> one. Strange.

I don't think that's true. I think the title is optional for a sidebar.



Keith