Compliant FAQ

[Lorenzo Cappelletti]

Hi everyone,

I recently recieved a message from a user who pointed out that the FAQ
page available at http://www.gnupg.org/documentation/faqs.html is not
XHTML compliant as stated at the bottom of the page itself.  Errors are
related to undefined <br>, <P>, <menu>, <A>, and <LI> non-defined tags
and HREF attributes, which are actually wrong in XHTML.  If you want to
know what exactly the errors are, go to the page and click on the XHTML
logo.

The issue is due to the fact that the page contents are a cut-and-paste 
of David's FAQ which is the output of faqprog.pl script.  To fix the 
problem, we've got three ways ahead IMO.

The first one is to more or less autmatically post-proccess the FAQ file 
generated via faqprog.pl and correct the problem.

Another approch is to get rid of the XHTML compliant logo.

The last solution is to patch the script (and the source FAQ file, I 
guess) in order to produce a compliant output.


It's needless to say that the latter is the proposal that requires more 
effort, but that also would produce more benefits, for the web site and 
for David's work, as well.


If David could have a look at it, it'd save me some work: I know Perl, 
but I don't know the script.  Nonetheless, the fix seems to be quite 
easy.  It's just a matter of changing tag case and repleace <menu> tag 
with a <ul> one.

About the latter, the HTML 4.0 Specification from W3C states that MENU 
tag use is deprecated:

  The DIR element was designed to be used for creating multicolumn
  directory lists. The MENU element was designed to be used for single
  column menu lists. Both elements have the same structure as UL, just
  different rendering. In practice, a user agent will render a DIR or
  MENU list exactly as a UL list. 

  We strongly recommend using UL instead of these elements. 

-- 
email: lorenzo.cappelletti@email.it
Jabber: lolo@linux.it
Fingerprint: 8CDD 3408 53B2 6122 99DA EE37 1523 68FC D906 4C08

Vuoi aiutarci ad avere le descrizioni dei pacchetti Debian in italiano?
http://ddtp.debian.org/