[jira] Commented: (DERBY-4408) missing DOCTYPE and META tags in toc.html and index.html pages

["Kim Haase (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/DERBY-4408?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12934876#action_12934876 ] 

Kim Haase commented on DERBY-4408:
----------------------------------

I ran these files through another accessibility checker and got different errors:

INDEX.HTML
  A TITLE attribute is required for FRAME tag.
  FRAMESET element should have NOFRAMES sub-element for user agents that do not support frames.
  HTML tags require LANG attributes. Primary language not specified for document.
TOC.HTML
  HTML tags require LANG attributes. Primary language not specified for document.

Ideally we would fix all of these, but with our current toolkit we can't.

The rest of the frameset files are fine except for those with tables (mainly to do with empty summary attributes generated by our toolkit; it's complicated).

  Do not use TH for structural layout in layout tables.

The one-page HTML books generate a lot of errors because of the FOP processing:

  HTML tags require LANG attributes. Primary language not specified for document.
  An ALT attribute is required for IMG tag.
  No SUMMARY attribute found for TABLE tag.
  Table data cells are required to be associated with headers.

BTW, we would get the last one in the regular frameset files if we were able to put summaries in our table tags. Catch 22.

> 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
>
> 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.
-
You can reply to this email to add a comment to the issue online.