[
https://issues.apache.org/jira/browse/DERBY-5136?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Kim Haase updated DERBY-5136:
-----------------------------
Issue & fix info: [Patch Available]
> Simple accessibility fixes to frames HTML doc output
> ----------------------------------------------------
>
> Key: DERBY-5136
> URL: https://issues.apache.org/jira/browse/DERBY-5136
> Project: Derby
> Issue Type: Sub-task
> Components: Documentation
> Affects Versions: 10.7.1.1
> Reporter: Kim Haase
> Assignee: Kim Haase
> Fix For: 10.8.1.0
>
> Attachments: DERBY-5135.diff, DERBY-5135.stat, DERBY-5136-2.diff,
> index.html, rrefcopyright.html
>
>
> The frames versions of the HTML manuals have some accessibility errors that
> are quite easy to fix, involving the index.html file and section heads.
> The index.html file for the frames version has several errors:
> 1) The <html> element lacks a lang attribute (lang="en" in this case).
> 2) The <frameset> element lacks a <noframes> element telling people with
> browsers that don't support frames where to find an alternative version of
> the documentation. We can point them to the single-file HTML manual.
> 3) The <frameset> and <frame> elements require title attributes.
> It is possible to fix these issues fairly easily by providing a modified
> version of the DITA-OT1.1.2.1/resource/index.html file and then by making
> some additional edits to the init and html.dita tasks in the build.xml file.
> The documentation also violates the rule that heads must appear in order. The
> topics in the Derby documentation generate only two HTML head tags, <h1> for
> the topic title and <h4> for sections. Sections cannot be nested in DITA.
> It is possible to fix this problem by providing a modified version of the
> DITA-OT1.1.2.1/xsl/xslhtml/dita2htmlImpl.xsl file that specifies the use of
> <h2> tags instead of <h4>. Section heads are always generated with the
> "sectiontitle" class, which is specified in the .css files, so the output
> seems to look the same with either head in a browser that supports
> stylesheets.
> I plan to file a patch for this task tomorrow.
--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira
