You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Kim Haase (JIRA)" <ji...@apache.org> on 2011/03/15 22:02:29 UTC
[jira] Created: (DERBY-5136) Simple accessibility fixes to frames
HTML doc output
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
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
[jira] [Updated] (DERBY-5136) Simple accessibility fixes to frames
HTML doc output
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ 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 <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
[jira] Resolved: (DERBY-5136) Simple accessibility fixes to frames
HTML doc output
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-5136?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase resolved DERBY-5136.
------------------------------
Resolution: Fixed
Fix Version/s: 10.8.0.0
Issue & fix info: (was: [Patch Available])
Committed patch DERBY-5135.diff (wrong name) to documentation trunk at revision 1082984.
> 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.0.0
>
> Attachments: DERBY-5135.diff, DERBY-5135.stat, 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
[jira] [Closed] (DERBY-5136) Simple accessibility fixes to frames
HTML doc output
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-5136?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase closed DERBY-5136.
----------------------------
Changes have appeared in 10.8 and alpha docs.
> 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.2
>
> 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
[jira] Updated: (DERBY-5136) Simple accessibility fixes to frames
HTML doc output
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ 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
> Attachments: DERBY-5135.diff, DERBY-5135.stat, 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
[jira] [Resolved] (DERBY-5136) Simple accessibility fixes to frames
HTML doc output
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-5136?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase resolved DERBY-5136.
------------------------------
Resolution: Fixed
Issue & fix info: (was: [Patch Available])
Committed patch DERBY-5136-2.diff to documentation trunk at revision 1089207.
Merged to 10.8 doc branch at revision 1089210.
> 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
[jira] [Reopened] (DERBY-5136) Simple accessibility fixes to frames
HTML doc output
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-5136?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase reopened DERBY-5136:
------------------------------
Part of the build.xml init task, the dita.regex target, makes a change to the DITA-OT1.1.2.1/xsl/xslhtml/dita2htmlImpl.xsl file before the copy task copies the fixed version from lib. This means that by default, in a freshly checked out workspace, the copy is not done because the version in DITA-OT1.1.2.1/xsl/xslhtml is newer than the one in lib.
To fix this, the copy task needs to have the overwrite parameter set:
<copy file="${dita.lib.dir}/dita2htmlImpl.xsl" todir="${dita.dir}/xsl/xslhtml" overwrite="true"/>
> 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, 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
[jira] [Updated] (DERBY-5136) Simple accessibility fixes to frames
HTML doc output
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ 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
[jira] Updated: (DERBY-5136) Simple accessibility fixes to frames
HTML doc output
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-5136?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase updated DERBY-5136:
-----------------------------
Attachment: rrefcopyright.html
index.html
DERBY-5135.stat
DERBY-5135.diff
Attaching DERBY-5135.diff, DERBY-5135.stat, and two files that show the changes: out/ref/index.html and out/ref/rrefcopyright.html.
The patch involves adding two modified files to the lib directory to be copied into the DITA-OT1.1.2.1 area.
A changed index.html file is copied from lib into DITA-OT1.1.2.1/resource. This file differs from the previous version as follows:
< <html>
---
> <html lang="en">
7,9c7,15
< <frameset cols="40%,*">
< <frame name="navwin" src="toc.html" />
< <frame name="contentwin" src="about:blank" scrolling="auto" />
---
> <frameset title="Web Sample" cols="40%,*">
> <noframes>
> <body>
> <p><a href="SAMPLE-single.html">Go to a non-frames version of
> this content.</a></p>
> </body>
> </noframes>
> <frame title="Table of Contents" name="navwin" src="toc.html" />
> <frame title="Pages" name="contentwin" src="about:blank" scrolling="auto" />
A changed dita2htmlImpl.xsl is copied from lib into DITA-OT1.1.2.1/xsl/xslhtml. This file differs from the previous version as follows:
2798c2798
< <h4 class="sectiontitle"><xsl:value-of select="@spectitle"/></h4>
---
> <h2 class="sectiontitle"><xsl:value-of select="@spectitle"/></h2>
2802c2802
< <h4 class="sectiontitle"><xsl:value-of select="$defaulttitle"/></h4>
---
> <h2 class="sectiontitle"><xsl:value-of select="$defaulttitle"/></h2>
2809c2809
< <h4 class="sectiontitle">
---
> <h2 class="sectiontitle">
2812c2812
< </h4>
---
> </h2>
(Note: @spectitle is an attribute of the section element that is not used in documents but can be used by "architects of specialized types.")
The patch also makes three small changes to build.xml: two to copy these files to the appropriate locations, and one to edit index.html to provide the correct name for the one-page HTML book.
> 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
> Attachments: DERBY-5135.diff, DERBY-5135.stat, 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