Issue 103265

Summary:

a11y: use ODF conform hyperlinks in table of contents

Product:

Writer

Reporter:

Oliver-Rainer Wittmann <orw>

Component:

Assignee:

eric.savary

Status:

CLOSED FIXED

QA Contact:

issues@sw <issues>

Severity:

Trivial

Priority:

CC:

eric.savary, issues, malte_timmermann

Version:

OOo 3.0

Keywords:

accessibility

Target Milestone:

---

Hardware:

All

OS:

All

Issue Type:

ENHANCEMENT

Latest Confirmation in:

---

Developer Difficulty:

---

Attachments:

Description	Flags
TCS: ODF_Hyperlinks_in_TOCs.htm	none

Description Oliver-Rainer Wittmann 2009-07-02 09:49:42 UTC

Replace OpenOffice.org specific hyperlinks used in table of content (e.g.
"#1.1.Heading on outline level 2|outline") by ODF (versions: 1.0, 1.1 and 1.2
cd02) conforming ones - see definition of ODF attribute xlink:href for ODF
element <text:a>.
To achieve this each heading for which a corresponding entry in the table of
contents is created is bookmarked by an bookmark. This bookmark will be the
target of the table of content entry hyperlink.
Thus, accessibility tools by its own are able to resolve the hyperlinks given in
the actual content of the table of content.
The bookmarks which are used for this purpose are the same which are used for
direct cross referencing of headings - see issue 25072 and its specification
found at
http://specs.openoffice.org/writer/numbering/Direct_Cross_References_to_Headings_and_Numberings.odt

Comment 1 Oliver-Rainer Wittmann 2009-07-02 09:50:52 UTC

adding keyword accessibility

Comment 2 malte_timmermann 2009-07-17 18:12:18 UTC

Some background information on this task: 

The current implementation writes TOCs in ODF documents in a way that it's not
usable for other ODF applications.

This is problematic especially for assistive technologies, which would need to
implement OOo's logic to understand the links in the TOC.

It also hinders conversion tools to create useful output. 
TOCs in ODF documents converted to HTML don't work in a browser (inaccessible
HTML), and tools like an ODF to DAISY DTBOOK converter also can't make use of
the TOC.

This issues was discussed some time ago in the OASIS ODF Accessibility SC.

We will add some recommendations to the ODF Accessibility guidelines, that TOC's
should be done via standard hyperlinks or XML ids.

Comment 3 Oliver-Rainer Wittmann 2009-08-06 08:59:11 UTC

fixed in cws sw32a11y01 - changed file:
/sw/source/core/tox/txmsrt.cxx, rev. 274705

Comment 4 Oliver-Rainer Wittmann 2009-08-11 13:50:02 UTC

OD->ES: Checked in internal installation set of cws sw32a11y01 - please verify.

To test, if the hyperlinks in the table of content conform to ODF you can export
a corresponding text document to HTML, open this HTML document in a browser and
check, if the hyperlinks work.

Comment 5 eric.savary 2009-08-23 20:14:54 UTC

Created attachment 64326 [details]
TCS: ODF_Hyperlinks_in_TOCs.htm

Comment 6 eric.savary 2009-08-23 20:15:50 UTC

TCS added
Verified in CWS sw32a11y01

Comment 7 malte_timmermann 2010-01-08 09:18:16 UTC

Fixed and integrated => closing now..