List Info

Thread: RE: Undesirable whitespace after examples




RE: Undesirable whitespace after examples
user name
2007-05-30 06:18:29
Hi,

The newer version of the stylesheets produces extra
paragraph with br element and class
"example-break". This break is produced after
other similar elements as well.

The only thing you may need to do is to add .example-break
{display:none;} to your CSS stylesheet.

Greetings

Pavel Škopík

-----Original Message-----
From: techno_plume-mailboxyahoo.com
[mailto:techno_plume-mailboxyahoo.com] 
Sent: Wednesday, May 30, 2007 12:23 PM
To: docbook-appslists.oasis-open.org
Subject: [docbook-apps] Undesirable whitespace after
examples

Hi,

I'm working with a large existing manual that has a bunch of
formal
examples. The example element allows titles and easy listing
in the
TOC, so this has worked well. 

Part of my tinkering included updating the files to use the
Docbook XML
DTD v4.3 and more up-to-date XSL stylesheets; previously it
was set up
to use version 1.55.0 of the stylesheets. Unfortunately,
using XSL
stylesheets v1.71.0, the xsltproc-generated chunked HTML
pages have a
big chunk of whitespace underneath text which is surrounded
by an
example tag.

I'm not really familiar with XSL customizations. An example
page
generated using the old stylesheets - http://tinyurl.com/2gsc8w shows
the examples integrating neatly with the text underneath.
When
generated using v1.71.0 extra space displays underneath each
example
(same page w/minor content updates): http://tinyurl.com/265xf6.


What specific change(s) can I make so that examples render
as before,
without the extra spacing?  Plus, would those changes cause
problems
for anybody building the docs using their own installed XSL
stylesheets
if they're anything other than v1.7x.x?

Thank you,

Richard.

P.S. The docs have environment variables (like $KDEDIRS) in
them a lot.
These were marked up as <envar>$KDEDIRS</envar>.
Apparently that's
incorrect and should be
<parameter>$<envar>KDEDIRS</envar></par
ameter>.
The parameter tag causes the chunked HTML output to be
italicised,
which (IMO) is less pretty. Is there a quick fix so it does
not render
the environment variable in italics?

------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-apps-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-apps-helplists.oasis-open.org


------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-apps-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-apps-helplists.oasis-open.org


RE: Undesirable whitespace after examples
user name
2007-05-31 01:12:14
Pavel,

The CSS fix works great. Thanks!

-- Richard.

--- Skopik Pavel <Pavel.Skopik...> wrote:

> Hi,
> 
> The newer version of the stylesheets produces extra
paragraph with br
> element and class "example-break". This break
is produced after other
> similar elements as well.
> 
> The only thing you may need to do is to add
.example-break
> {display:none;} to your CSS stylesheet.
> 
> Greetings
> 
> Pavel Škopík
> 
> -----Original Message-----
> Sent: Wednesday, May 30, 2007 12:23 PM
> To: docbook-appslists.oasis-open.org
> Subject: [docbook-apps] Undesirable whitespace after
examples
> 
> Hi,
> 
> I'm working with a large existing manual that has a
bunch of formal
> examples. The example element allows titles and easy
listing in the
> TOC, so this has worked well. 
> 
> Part of my tinkering included updating the files to use
the Docbook
> XML
> DTD v4.3 and more up-to-date XSL stylesheets;
previously it was set
> up
> to use version 1.55.0 of the stylesheets.
Unfortunately, using XSL
> stylesheets v1.71.0, the xsltproc-generated chunked
HTML pages have a
> big chunk of whitespace underneath text which is
surrounded by an
> example tag.
> 
> I'm not really familiar with XSL customizations. An
example page
> generated using the old stylesheets - http://tinyurl.com/2gsc8w shows
> the examples integrating neatly with the text
underneath. When
> generated using v1.71.0 extra space displays underneath
each example
> (same page w/minor content updates): http://tinyurl.com/265xf6.

> 
> What specific change(s) can I make so that examples
render as before,
> without the extra spacing?  Plus, would those changes
cause problems
> for anybody building the docs using their own installed
XSL
> stylesheets
> if they're anything other than v1.7x.x?
> 
> Thank you,
> 
> Richard.
> 
> P.S. The docs have environment variables (like
$KDEDIRS) in them a
> lot.
> These were marked up as
<envar>$KDEDIRS</envar>. Apparently that's
> incorrect and should be
>
<parameter>$<envar>KDEDIRS</envar></par
ameter>.
> The parameter tag causes the chunked HTML output to be
italicised,
> which (IMO) is less pretty. Is there a quick fix so it
does not
> render
> the environment variable in italics?

------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-apps-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-apps-helplists.oasis-open.org


[1-2]

about | contact  Other archives ( Real Estate discussion Medical topics )