![Fri Mar 20 14:50:02 2009 (52.6k) by era+rt=cpan [...] iki.fi](/Ticket/Attachment/581164/293635/Screenshot-Mozilla%20Firefox.png){kind=link}
| Subject: | Nested =over lists in HTML render without nesting in Firefox |
I noticed that Firefox renders multiple nested levels of =over as if
they were all a single list. This is a readability problem where the
author wanted them to render differently.
For example, some of the SpamAssassin documentation pages are hard to
read in Firefox --
http://spamassassin.apache.org/full/3.2.x/doc/Mail_SpamAssassin_Conf.html is
a good example; searching for "example@foo" should get you to a place
where a nested list of examples is displayed as if it were a new
definition in the topmost definition list, and there are multiple other
instances on that page which are really hard to interpret in the absence
of logical indentation.
I found that adding a <dd> tag before any nested <dl> in the generated
HTML would fix the problem, and allow Firefox to render the indentation
in the expected way. I am attaching an example input file
nested-over.pod, the generated output from pod2html in nested-over.out;
and a fixed, hand-edited version nested-over.html (this also has a CSS
style experiment which I left in for you to review, but I don't think
it's a good fix if you can put in a <dd> instead).
Pod::Htmp.pm on my system has $VERSION = 1.08; -- I hope that this is
the correct version number to report, and that it isn't too old. This
is stock Perl 5.10 on an up-to-date Ubuntu 8.10. If this is fixed in a
more recent version, I hope the repro steps are clear enough to allow
you to quickly close it.
| Subject: | nested-over.html |
| Subject: | nested-over.out |
Message body not shown because it is not plain text.
| Subject: | nested-over.pod |
=over
=item outer 1
=over
=item inner 1
Fnord
=item inner 2
Bar
=back
Back in outer
=item outer 2
Foo bar.
=back
End.