This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Konqueror can't render docs because of malformed HTML
Type: Stage:
Components: Documentation Versions: Python 2.3
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: fdrake Nosy List: fdrake, felixwiemann, leogah, yanestra
Priority: low Keywords:

Created on 2004-05-28 20:39 by yanestra, last changed 2022-04-11 14:56 by admin. This issue is now closed.

Messages (5)
msg20910 - (view) Author: Yanestra (yanestra) Date: 2004-05-28 20:39
At least on page Python-Docs-2.3.3/lib/re-syntax.html 
Konqueror doesn't render the <DL> definition part 
correctly (the <DT> part is not being displayed). 
 
The reason appears to be malformed HTML, as to cite 
Stephan Kulow of KDE Project: 
 
"No, this is not correct HTML and you might want to 
report it to the python maintainers.  
  
I wonder why they use <dl compact> (which is correct 
HTML) when they put a <P> in there (which is not 
correct).  
  
Send your snippet through tidy to see how it looks as 
correct HTML (and as such it's rendered correctly by 
konqueror)" 
 
You might want to visit KDE's bugzilla: 
http://bugs.kde.org/show_bug.cgi?id=82335 
msg20911 - (view) Author: Felix Wiemann (felixwiemann) Date: 2004-07-28 15:20
Logged In: YES 
user_id=1014490

In fact, the HTML code is not valid. See, e.g.,
http://validator.w3.org/check?uri=http://www.python.org/dev/doc/devel/lib/boolean.html&charset=%28detect+automatically%29&doctype=Inline&ss=1&sp=1&outline=1&No200=1&verbose=1

And the link-tag which links to the next page appears twice.
E.g., there is
<LINK rel="next" href="comparisons.html">
twice on the page
http://www.python.org/dev/doc/devel/lib/boolean.html

This is very annoying when using the link toolbar for
Mozilla Firefox.
msg20912 - (view) Author: Richard Brodie (leogah) Date: 2004-10-22 20:11
Logged In: YES 
user_id=356893

Fixing up the HTML by hand didn't correct the rendering in
Konqueror, and the related KDE bug is now marked as fixed in
the KDE CVS repository. 

Bug 899423 covers the LINK issue. 

msg20913 - (view) Author: Fred Drake (fdrake) (Python committer) Date: 2004-11-10 18:48
Logged In: YES 
user_id=3066

Hmm.  The <DL COMPACT> in question is generated by the basic
LaTeX2HTML software, not our extensions.  I think we can
avoid it by changing the environment used for the lists that
cause this (all are bare "list" environments, which I
consider questionable in actual content).

This isn't a high priority since it means doing something
about the markup in the documents that's not obviously
necessary from a structural point of view, and since more
recent versions of Konqueror don't need the change.
msg20914 - (view) Author: Fred Drake (fdrake) (Python committer) Date: 2004-11-11 05:08
Logged In: YES 
user_id=3066

Fixed by removing changing the offending cases of <DL
COMPACT> to use different constructs.  The general state of
XHTML conformance is still poor, but is endemic to the
LaTeX-to-HTML conversion tool being used.

Doc/lib/libsys.tex  1.76
Doc/lib/libre.tex  1.112
History
Date User Action Args
2022-04-11 14:56:04adminsetgithub: 40301
2004-05-28 20:39:57yanestracreate