[ https://issues.apache.org/jira/browse/DERBY-5136?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ] Kim Haase updated DERBY-5136: ----------------------------- Attachment: DERBY-5136-2.diff Attaching DERBY-5136-2.diff, with the change to the line in build.xml. I plan to commit this patch shortly. > 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 element lacks a lang attribute (lang="en" in this case). > 2) The element lacks a 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