OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] Suggested Writing Style

You are referring to the empty <p> warnings reported by tidy?

Those are the result of a tricky piece of code that Norm wrote to unwrap 
HTML content to make it more valid.  As you probably know, putting a pre 
inside p is not valid HTML.  But that is what you would get if you just 
processed a programlisting inside a para.  So the code Norm wrote finds 
such blocks inside p, terminates the p, outputs the block, and starts a new 
p.  In the case of no content after the programlisting, you end up with an 
empty p element.

If you want to see what's going on, look at the template with match="para" 
in html/block.xsl. It calls "paragraph", which calls "unwrap.p" if 
$html.cleanup is not zero.  The templates to do the work are all in 
html/html-rtf.xsl.  This is a nontrivial process, as you can see.

I suppose the templates could test a generated p that has only text to see 
if it has only whitespace, and then not output such empty p elements.  Let 
me know if you find the right place to do that and I'll check it in.  8^)

Bob Stayton
Sagehill Enterprises
DocBook Consulting

----- Original Message ----- 
From: "Jeroen Ruigrok/asmodai" <asmodai@in-nomine.org>
To: "Bob Stayton" <bobs@sagehill.net>
Sent: Wednesday, August 16, 2006 9:36 AM
Subject: Re: [docbook-apps] Suggested Writing Style

> -On [20060816 17:43], Bob Stayton (bobs@sagehill.net) wrote:
>>I'm not clear what the stylesheet issue might be here?
> See my first email Bob, I think that ought to be descriptive enough?
> Let me know if it isn't.
> -- 
> Jeroen Ruigrok van der Werven <asmodai(-at-)in-nomine.org> / asmodai
> イェルーン ラウフロック ヴァン デル ウェルヴェン
> http://www.in-nomine.org/
> If you would thoroughly know anything, teach it to others...

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]