db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Kim Haase (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (DERBY-4408) missing DOCTYPE and META tags in toc.html and index.html pages
Date Thu, 21 Jul 2011 14:43:58 GMT

    [ 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

        

Mime
View raw message