3
This user guide was taken from
4
http://sourceforge.net/p/accessodf/wiki/UserGuide/
5
please have a look there for an up-to-date version.
11
AccessODF helps authors evaluate and improve the accessibility of their documents in
12
OpenOffice.org or LibreOffice Writer. A document may contain many problems that the author
13
is unaware of but that can keep someone with a disability from accessing the content. This
14
is true whether documents are accessed in Writer itself, or exported to a more common format
15
like HTML or PDF. Thanks to the extensions odt2daisy and odt2braille, Writer documents can
16
be a suitable source for formats specifically aimed at persons with disabilities. But in
17
order to create valid and usable Braille or DAISY books, the source document needs to be
20
You can do several things to increase the accessibility of ODT documents. The following
21
documents give you a number of guidelines:
23
• ODF Accessibility Guidelines by the Accessibility subcommittee of the OASIS Open
24
Document Format for Office Applications (OpenDocument) TC
25
• Authoring Techniques For Accessible Office Documents by the Accessible Digital Office
26
Document (ADOD) Project
27
• OpenOffice.org and Accessibility by Web Accessibility in Mind (WebAIM)
29
AccessODF helps you to keep these rules in mind and makes it very easy to write accessible
30
documents. Checking the accessibility is now as straightforward as checking the spelling:
31
similar to the spelling checker alerting you to potential spelling errors, the accessibility
32
checker helps you identify and resolve potential accessibility issues.
36
AccessODF is available as an extension. The installation requires OpenOffice.org/LibreOffice
37
3.3. AccessODF runs on all platforms (Windows, Mac OS, Linux).
39
1. Download the installation file (OXT)
40
2. In Writer, go to Tools > Extension Manager...
42
4. Select the OXT file and click Open
43
5. Wait until the installation has finished, then click Close
44
6. Finally, restart Writer
46
Warning: If you get an error dialog with the words
47
com.sun.star.registry.CannotRegisterImplementationException in it when installing the
48
extension on Ubuntu, open a command line and enter the command sudo apt-get install
49
libreoffice-java-common. This solution may also work for other Linux distributions.
51
3. Evaluate accessibility
53
The accessibility checker is shown in the Accessibility section of the Task Pane in Writer.
54
The Accessibility section of the Task Pane
55
You might have seen this Task Pane before in Impress, where it is used for Master Pages,
56
Layouts, Custom Animations and Transitions. It is usually located at the right side of the
57
workspace, but it can also be placed at the left or even undocked. To check the document for
58
possible issues, do the following:
60
1. Open the document in Writer
61
2. Go to Tools > Accessibility Evaluation... The Accessibility Evaluation item in the Tools
63
3. Click Check The check button
64
4. Wait for the tool to scan the whole document
66
The task pane displays all issues in a 'tree' view. While navigating the issues, focus will
67
move to the relevant location in the document. Each issue is classified as an error or a
68
warning. Selecting an issue shows information about why something might be inaccessible, and
69
instructions on how to fix it.
70
The accessibility checker gives an overview of all issues in a tree view
71
You can include or exclude certain checks specific to the export to DAISY and Braille. To
72
show these options, go to Tools > Options... > OpenOffice.org/LibreOffice Writer >
73
Accessibility Checker. In order to do Braille-specific checks, odt2braille version 1.1.0 or
74
later must be installed.
77
4. Resolve accessibility issues
79
Each error or warning includes instructions on how to fix it manually. For some issues, you
80
can also use the handy Repair button. This button either fixes the issue automatically, or
81
it sends you in the right direction so that you can skip a few steps. It is also possible
82
that the checker reports an issue where no problem exists. In this case, just ignore the
83
issue with the Ignore button.
86
2. If this is not a real issue, click Ignore
87
3. Else, if the Repair button is enabled, use it to fix the issue (semi-)automatically
88
4. Else, fix the issue manually
89
5. Repeat this until no issues are left