[Aptitude-devel] Bug#496724: aptitude-doc-en: html output fails validation

[Manuel A. Fernandez Montecelo]

2014-01-21 21:33 GMT+00:00 Manuel A. Fernandez Montecelo
<manuel.montezelo at gmail.com>:
>
> The "alt" part is not fixed yet, it seems.

This is implemented now, and the images elements have "alt" now.

However, the document still does not validate due to other reasons:

===================
*** Errors validating /usr/share/doc/aptitude/html/en/ch01s02.html: ***
Error at line 19, character 30:  document type does not allow element "DIV"
        here; missing one of "APPLET", "OBJECT", "MAP", "IFRAME", "BUTTON"
        start-tag
Error at line 25, character 30:  document type does not allow element "DIV"
        here; missing one of "APPLET", "OBJECT", "MAP", "IFRAME", "BUTTON"
        start-tag
Error at line 35, character 30:  document type does not allow element "DIV"
        here; missing one of "APPLET", "OBJECT", "MAP", "IFRAME", "BUTTON"
        start-tag
...
*** Errors validating /usr/share/doc/aptitude/html/en/ch02s05s01.html: ***
Error at line 214, character 103:  document type does not allow element
        "PRE" here; missing one of "APPLET", "OBJECT", "MAP", "IFRAME",
        "BUTTON" start-tag
Error at line 219, character 56:  document type does not allow element
        "PRE" here; missing one of "APPLET", "OBJECT", "MAP", "IFRAME",
        "BUTTON" start-tag
===================


I also converted to XHTML 1.0 to use something from this decade, or
century (HTML 4.01 is from 1999).  Now there are similar, but slightly
different, failures:

===================
*** Errors validating doc/en/output-html/ch01s02.html: ***
Error at line 19, character 30:  document type does not allow element "div"
        here; missing one of "object", "applet", "map", "iframe", "button",
        "ins", "del" start-tag
Error at line 25, character 30:  document type does not allow element "div"
        here; missing one of "object", "applet", "map", "iframe", "button",
        "ins", "del" start-tag
Error at line 35, character 30:  document type does not allow element "div"
        here; missing one of "object", "applet", "map", "iframe", "button",
        "ins", "del" start-tag
...
*** Errors validating doc/en/output-html/ch02s05s01.html: ***
Error at line 214, character 103:  document type does not allow element
        "pre" here; missing one of "object", "applet", "map", "iframe",
        "button", "ins", "del" start-tag
Error at line 219, character 56:  document type does not allow element
        "pre" here; missing one of "object", "applet", "map", "iframe",
        "button", "ins", "del" start-tag
===================

I was checking them and they seem to be related with commands/actions,
"<varlistentry><term><synopsis>" and the like.  Looks like valid
docbook, so I assume that the translation to HTML is the one at fault
there.

The DocBook packages are not in great shape neither in Debian nor
upstream, it seems, and they don't receive bugfixes.

Attention upstream seems to be in DocBook 5, draft since 2008 or so
but not actually published, and I think that spending more time
looking into this or trying to convert to docbook v5 to see if it
solves the issue, for so little gain, is not worth it at the time
being -- I already spent several hours looking into this now...


Cheers.
-- 
Manuel A. Fernandez Montecelo <manuel.montezelo at gmail.com>