Compliant FAQ

Noel D. Torres Taņo ndtt@ll.iac.es
Wed, 03 Sep 2003 14:29:16 +0100


My preferences are to patch the script, and to get ride of the XHTML
logo while the script is being worked (maybe some days?)
I think the original FAQ file doesn't need to be touched at all.

Noel

Lorenzo Cappelletti wrote:
> 
> 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/
> 
> _______________________________________________
> Gpgweb-devel mailing list
> Gpgweb-devel@gnupg.org
> http://lists.gnupg.org/mailman/listinfo/gpgweb-devel