From: Jonathan Nieder Date: Fri, 20 Aug 2010 05:04:02 GMT Subject: Re: user-manual.html invalid HTML Message-ID: <20100820050401.GC25013@burratino> In-Reply-To: <87hc5ahzy8.fsf@jidanni.org> Hi, Sorry for the long silence. Jeff King wrote: > On Fri, Dec 12, 2008 at 04:32:15AM +0800, jidanni@jidanni.org wrote: [user-manual.html lacks a !DOCTYPE declaration] > > The versions I build locally have: > > "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> > > in each HTML file, which is added by asciidoc. Maybe the package you > are looking at was built with an older version of asciidoc that doesn't > do this (I don't actually know the history of this feature, but it seems > to me that this is something asciidoc should be doing, not git). It looks like the HTML for user-manual.html (unlike the reference manual and other articles) is not generated by asciidoc after all; instead, the rule in Documentation/Makefile uses xsltproc directly to convert the asciidoc-generated XML to HTML. Apparently the caller is supposed to set the chunker.output.doctype-public parameter. http://www.sagehill.net/docbookxsl/Chunking.html#OutputDoctype Maybe something as simple as this would work. -- 8< -- Subject: Documentation: set a !DOCTYPE for user manual asciidoc already takes care of including a doctype for most of the HTML documentation, but the user manual which is processed with docbook-xsl directly lacks one (at least with Debian docbook-xsl 1.75.2+dfsg-5). This makes it harder to automatically validate the HTML. Reported-by: 積丹尼 Signed-off-by: Jonathan Nieder --- diff --git a/Documentation/docbook.xsl b/Documentation/docbook.xsl index 9a6912c..da8b05b 100644 --- a/Documentation/docbook.xsl +++ b/Documentation/docbook.xsl @@ -1,5 +1,8 @@ - + --