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