[
https://issues.apache.org/jira/browse/DERBY-4408?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13069007#comment-13069007
]
Kim Haase commented on DERBY-4408:
----------------------------------
Some of this is not so hard, but There are a couple of problems. First, the
Apache license is inserted after all the other processing, in the following
code within the html.dita target of the build.xml file.
<filterchain>
<concatfilter prepend="${basedir}/lib/apache-license-html.html"/>
</filterchain>
So I'll have to bring the license insertion into the XSL files somehow.
Also, getting the xmlns attribute into the html element is not trivial. If I
simply insert it into the html element in the stylesheet --
<html xmlns="http://www.w3.org/1999/xhtml";>
then in the toc frame, I get empty xmnls attributes in the meta and ul tags:
<html xmlns="http://www.w3.org/1999/xhtml"; lang="en-us" xml:lang="en-us">
<head>
<meta xmlns="" content="text/html; charset=utf-8" http-equiv="Content-Type" />
...
<ul xmlns="">
Whereas if I do the same thing in the stylesheet for the non-toc pages, I get
the empty attributes in the head and body elements only:
<html xmlns="http://www.w3.org/1999/xhtml"; lang="en-us" xml:lang="en-us">
<head xmlns="">
...
<body xmlns="" id="tgsactivity4"><a name="tgsactivity4"><!-- --></a>
However, if I try to create a template to set the attribute, it is completely
ignored.
<xsl:call-template name="setNamespace"/>
...
<xsl:template name="setNamespace">
<xsl:attribute name="xmlns">http://www.w3.org/1999/xhtml</xsl:attribute>
</xsl:template>
The "ant -verbose" command says,
Warning! Illegal value used for attribute name: name
Looks like the namespace attribute is the one attribute you can't set.
At http://www.w3schools.com/tags/tag_html.asp it says that "the HTML validator
at w3.org does not complain when the xmlns attribute is missing in an XHTML
document. This is because the namespace "xmlns=http://www.w3.org/1999/xhtml"; is
default, and will be added to the <html> tag even if you do not include it."
This suggests that we may not really need to add this after all?
> missing DOCTYPE and META tags in toc.html and index.html pages
> --------------------------------------------------------------
>
> Key: DERBY-4408
> URL: https://issues.apache.org/jira/browse/DERBY-4408
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.3.0
> Reporter: Myrna van Lunteren
> Assignee: Kim Haase
> Attachments: DERBY-4408.diff, DERBY-4408.diff, index.html, toc.html
>
>
> I found a tool that analyzes the documentation for possible accessibility
> issues, and it found that the index.html and toc.html files from all 6 books
> have issues:
> INDEX.HTML
> 977 Missing DOCTYPE tag. Required to define version of XHTML being
> used.
> 833 Missing META tag. Required CHARSET value must be defined in this
> file.
> TOC.HTML
> 831 Missing DOCTYPE tag. Required to define version of HTML being
> used. Line: 1
--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira
