Recent changes to UserGuide

UserGuide modified by Christophe Strobbe

Christophe Strobbe — Tue, 15 Jul 2014 10:38:50 -0000

--- v9
+++ v10
@@ -29,7 +29,7 @@

 **Warning:** If you get an error dialog with the words *com.sun.star.registry.CannotRegisterImplementationException* in it when installing the extension on **Ubuntu**, open a command line and enter the command 
 **sudo apt-get install libreoffice-java-common**. 
-This solution may also work for other Linux distributions.
+This solution may also work for other Linux distributions when you adapt the package installation command. For example, on Mageia 3, you need to run **urpmi libreoffice-java-common** (with administrative rights).

 3. Evaluate accessibility

WikiPage UserGuide modified by Christophe Strobbe

Christophe Strobbe — Wed, 11 Jul 2012 13:50:25 -0000

--- v8
+++ v9
@@ -40,7 +40,7 @@
 
 1. Open the document in Writer
 2. Go to Tools > Accessibility Evaluation...
-[[img src="https://sourceforge.net/p/accessodf/wiki/UserGuide/attachment/UserGuide2.png" alt="The Accessibility Evaluation item in the Tools menu" style="display:block;margin:10px"]]
+[[img src="../attachment/AccessODF_ToolsMenu.png" alt="The Accessibility Evaluation item in the Tools menu" style="display:block;margin:10px"]]
 3. Click Check
 [[img src="https://sourceforge.net/p/accessodf/wiki/UserGuide/attachment/UserGuide3.png" alt="The check button" style="display:block;margin:10px"]]
 4. Wait for the tool to scan the whole document

WikiPage UserGuide modified by Christophe Strobbe

Christophe Strobbe — Tue, 15 Nov 2011 11:43:29 -0000

--- v7 
+++ v8 
@@ -27,6 +27,11 @@
 5. Wait until the installation has finished, then click Close
 6. Finally, restart Writer
 
+**Warning:** If you get an error dialog with the words *com.sun.star.registry.CannotRegisterImplementationException* in it when installing the extension on **Ubuntu**, open a command line and enter the command 
+**sudo apt-get install libreoffice-java-common**. 
+This solution may also work for other Linux distributions.
+
+
 3. Evaluate accessibility
 -------------------------
 The accessibility checker is shown in the Accessibility section of the Task Pane in Writer.

WikiPage UserGuide modified by Bert

Bert — Mon, 07 Nov 2011 17:03:23 -0000

--- v6 
+++ v7 
@@ -19,6 +19,7 @@
 
 [[download_button]]
 
+
 1. Download the installation file (OXT)
 2. In Writer, go to Tools > Extension Manager...
 3. Click Add...

WikiPage UserGuide modified by Bert

Bert — Mon, 07 Nov 2011 17:02:26 -0000

--- v5 
+++ v6 
@@ -17,8 +17,9 @@
 ---------------
 AccessODF is available as an extension. The installation requires OpenOffice.org/LibreOffice 3.3. AccessODF runs on all platforms (Windows, Mac OS, Linux).
 
+[[download_button]]
+
 1. Download the installation file (OXT)
-[[download_button]]
 2. In Writer, go to Tools > Extension Manager...
 3. Click Add...
 4. Select the OXT file and click Open

WikiPage UserGuide modified by Bert

Bert — Sun, 06 Nov 2011 13:17:25 -0000

--- v4 
+++ v5 
@@ -28,9 +28,9 @@
 3. Evaluate accessibility
 -------------------------
 The accessibility checker is shown in the Accessibility section of the Task Pane in Writer.
-[[img src="https://sourceforge.net/p/accessodf/wiki/UserGuide/attachment/UserGuide1.png" alt="The Accessibility section of the Task Pane" width="100%" style="display:block;margin:10px"]]
+[[img src="https://sourceforge.net/p/accessodf/wiki/UserGuide/attachment/UserGuide1.png" alt="The Accessibility section of the Task Pane" width="95%" style="display:block;margin:10px"]]
 You might have seen this Task Pane before in Impress, where it is used for Master Pages, Layouts, Custom Animations and Transitions. It is usually located at the right side of the workspace, but it can also be placed at the left or even undocked. To check the document for possible issues, do the following:
- 
+
 1. Open the document in Writer
 2. Go to Tools > Accessibility Evaluation...
 [[img src="https://sourceforge.net/p/accessodf/wiki/UserGuide/attachment/UserGuide2.png" alt="The Accessibility Evaluation item in the Tools menu" style="display:block;margin:10px"]]

WikiPage UserGuide modified by Bert

Bert — Sun, 06 Nov 2011 13:04:14 -0000

--- v3 
+++ v4 
@@ -28,20 +28,20 @@
 3. Evaluate accessibility
 -------------------------
 The accessibility checker is shown in the Accessibility section of the Task Pane in Writer.
-[[img src="https://sourceforge.net/p/accessodf/wiki/Home/attachment/UserGuide1.png" alt="The Accessibility section of the Task Pane" width="100%" style="display:block;margin:10px"]]
+[[img src="https://sourceforge.net/p/accessodf/wiki/UserGuide/attachment/UserGuide1.png" alt="The Accessibility section of the Task Pane" width="100%" style="display:block;margin:10px"]]
 You might have seen this Task Pane before in Impress, where it is used for Master Pages, Layouts, Custom Animations and Transitions. It is usually located at the right side of the workspace, but it can also be placed at the left or even undocked. To check the document for possible issues, do the following:
  
 1. Open the document in Writer
 2. Go to Tools > Accessibility Evaluation...
-[[img src="https://sourceforge.net/p/accessodf/wiki/Home/attachment/UserGuide2.png" alt="The Accessibility Evaluation item in the Tools menu" style="display:block;margin:10px"]]
+[[img src="https://sourceforge.net/p/accessodf/wiki/UserGuide/attachment/UserGuide2.png" alt="The Accessibility Evaluation item in the Tools menu" style="display:block;margin:10px"]]
 3. Click Check
-[[img src="https://sourceforge.net/p/accessodf/wiki/Home/attachment/UserGuide3.png" alt="The check button" style="display:block;margin:10px"]]
+[[img src="https://sourceforge.net/p/accessodf/wiki/UserGuide/attachment/UserGuide3.png" alt="The check button" style="display:block;margin:10px"]]
 4. Wait for the tool to scan the whole document
 
 The task pane displays all issues in a 'tree' view. While navigating the issues, focus will move to the relevant location in the document. Each issue is classified as an error or a warning. Selecting an issue shows information about why something might be inaccessible, and instructions on how to fix it.
-[[img src="https://sourceforge.net/p/accessodf/wiki/Home/attachment/UserGuide4.png" alt="The accessibility checker gives an overview of all issues in a tree view" style="display:block;margin:10px"]]
+[[img src="https://sourceforge.net/p/accessodf/wiki/UserGuide/attachment/UserGuide4.png" alt="The accessibility checker gives an overview of all issues in a tree view" style="display:block;margin:10px"]]
 You can include or exclude certain checks specific to the export to DAISY and Braille. To show these options, go to Tools > Options... > OpenOffice.org/LibreOffice Writer > Accessibility Checker. In order to do Braille-specific checks, odt2braille version 1.1.0 or later must be installed.
-[[img src="https://sourceforge.net/p/accessodf/wiki/Home/attachment/UserGuide5.png" alt="The Options page" style="display:block;margin:10px"]]
+[[img src="https://sourceforge.net/p/accessodf/wiki/UserGuide/attachment/UserGuide5.png" alt="The Options page" style="display:block;margin:10px"]]
 
 4. Resolve accessibility issues
 -------------------------------

WikiPage UserGuide modified by Bert

Bert — Sun, 06 Nov 2011 13:03:26 -0000

--- v2 
+++ v3 
@@ -28,20 +28,20 @@
 3. Evaluate accessibility
 -------------------------
 The accessibility checker is shown in the Accessibility section of the Task Pane in Writer.
-[[img src=UserGuide1.png alt=The Accessibility section of the Task Pane]]
+[[img src="https://sourceforge.net/p/accessodf/wiki/Home/attachment/UserGuide1.png" alt="The Accessibility section of the Task Pane" width="100%" style="display:block;margin:10px"]]
 You might have seen this Task Pane before in Impress, where it is used for Master Pages, Layouts, Custom Animations and Transitions. It is usually located at the right side of the workspace, but it can also be placed at the left or even undocked. To check the document for possible issues, do the following:
  
 1. Open the document in Writer
 2. Go to Tools > Accessibility Evaluation...
-[[img src=UserGuide2.png alt=The Accessibility Evaluation item in the Tools menu]]
+[[img src="https://sourceforge.net/p/accessodf/wiki/Home/attachment/UserGuide2.png" alt="The Accessibility Evaluation item in the Tools menu" style="display:block;margin:10px"]]
 3. Click Check
-[[img src=UserGuide3.png alt=The check button]]
+[[img src="https://sourceforge.net/p/accessodf/wiki/Home/attachment/UserGuide3.png" alt="The check button" style="display:block;margin:10px"]]
 4. Wait for the tool to scan the whole document
 
 The task pane displays all issues in a 'tree' view. While navigating the issues, focus will move to the relevant location in the document. Each issue is classified as an error or a warning. Selecting an issue shows information about why something might be inaccessible, and instructions on how to fix it.
-[[img src=UserGuide4.png alt=The accessibility checker gives an overview of all issues in a tree view]]
+[[img src="https://sourceforge.net/p/accessodf/wiki/Home/attachment/UserGuide4.png" alt="The accessibility checker gives an overview of all issues in a tree view" style="display:block;margin:10px"]]
 You can include or exclude certain checks specific to the export to DAISY and Braille. To show these options, go to Tools > Options... > OpenOffice.org/LibreOffice Writer > Accessibility Checker. In order to do Braille-specific checks, odt2braille version 1.1.0 or later must be installed.
-[[img src=UserGuide5.png alt=The Options page]]
+[[img src="https://sourceforge.net/p/accessodf/wiki/Home/attachment/UserGuide5.png" alt="The Options page" style="display:block;margin:10px"]]
 
 4. Resolve accessibility issues
 -------------------------------

WikiPage Home modified by Bert

Bert — Sun, 06 Nov 2011 12:43:08 -0000

--- v1 
+++ v2 
@@ -1,5 +1,54 @@
-Welcome to your wiki!
-
-This is the default page, edit it as you see fit. To add a page simply reference it within brackets, e.g.: [SamplePage].
-
-The wiki uses [Markdown](/p/accessodf/wiki/markdown_syntax/) syntax.
+User Guide
+==========
+
+1. Introduction
+---------------
+AccessODF helps authors evaluate and improve the accessibility of their documents in OpenOffice.org or LibreOffice Writer. A document may contain many problems that the author is unaware of but that can keep someone with a disability from accessing the content. This is true whether documents are accessed in Writer itself, or exported to a more common format like HTML or PDF. Thanks to the extensions [odt2daisy](http://odt2daisy.sf.net) and [odt2braille](http://odt2braille.sf.net), Writer documents can be a suitable source for formats specifically aimed at persons with disabilities. But in order to create valid and usable Braille or DAISY books, the source document needs to be accessible.
+
+You can do several things to increase the accessibility of ODT documents. The following documents give you a number of guidelines:
+
+* [ODF Accessibility Guidelines](http://docs.oasis-open.org/office/office-accessibility/v1.0/cs01/ODF_Accessibility_Guidelines-v1.0.html) by the *Accessibility subcommittee of the OASIS Open Document Format for Office Applications (OpenDocument) TC*
+* [Authoring Techniques For Accessible Office Documents](http://adod.idrc.ocad.ca/oowriter) by the *Accessible Digital Office Document (ADOD) Project*
+* [OpenOffice.org and Accessibility](http://webaim.org/techniques/ooo/) by *Web Accessibility in Mind (WebAIM)*
+
+AccessODF helps you to keep these rules in mind and makes it very easy to write accessible documents. Checking the accessibility is now as straightforward as checking the spelling: similar to the spelling checker alerting you to potential spelling errors, the accessibility checker helps you identify and resolve potential accessibility issues.
+
+2. Installation
+---------------
+AccessODF is available as an extension. The installation requires OpenOffice.org/LibreOffice 3.3. AccessODF runs on all platforms (Windows, Mac OS, Linux).
+
+1. Download the installation file (OXT)
+[[download_button]]
+2. In Writer, go to Tools > Extension Manager...
+3. Click Add...
+4. Select the OXT file and click Open
+5. Wait until the installation has finished, then click Close
+6. Finally, restart Writer
+
+3. Evaluate accessibility
+-------------------------
+The accessibility checker is shown in the Accessibility section of the Task Pane in Writer.
+[[img src=UserGuide1.png alt=The Accessibility section of the Task Pane]]
+You might have seen this Task Pane before in Impress, where it is used for Master Pages, Layouts, Custom Animations and Transitions. It is usually located at the right side of the workspace, but it can also be placed at the left or even undocked. To check the document for possible issues, do the following:
+ 
+1. Open the document in Writer
+2. Go to Tools > Accessibility Evaluation...
+[[img src=UserGuide2.png alt=The Accessibility Evaluation item in the Tools menu]]
+3. Click Check
+[[img src=UserGuide3.png alt=The check button]]
+4. Wait for the tool to scan the whole document
+
+The task pane displays all issues in a 'tree' view. While navigating the issues, focus will move to the relevant location in the document. Each issue is classified as an error or a warning. Selecting an issue shows information about why something might be inaccessible, and instructions on how to fix it.
+[[img src=UserGuide4.png alt=The accessibility checker gives an overview of all issues in a tree view]]
+You can include or exclude certain checks specific to the export to DAISY and Braille. To show these options, go to Tools > Options... > OpenOffice.org/LibreOffice Writer > Accessibility Checker. In order to do Braille-specific checks, odt2braille version 1.1.0 or later must be installed.
+[[img src=UserGuide5.png alt=The Options page]]
+
+4. Resolve accessibility issues
+-------------------------------
+Each error or warning includes instructions on how to fix it manually. For some issues, you can also use the handy Repair button. This button either fixes the issue automatically, or it sends you in the right direction so that you can skip a few steps. It is also possible that the checker reports an issue where no problem exists. In this case, just ignore the issue with the Ignore button.
+
+1. Select an issue
+2. If this is not a real issue, click Ignore
+3. Else, if the Repair button is enabled, use it to fix the issue (semi-)automatically
+4. Else, fix the issue manually
+5. Repeat this until no issues are left

WikiPage Home modified by Bert

Bert — Sat, 05 Nov 2011 20:50:44 -0000

Welcome to your wiki! This is the default page, edit it as you see fit. To add a page simply reference it within brackets, e.g.: [SamplePage]. The wiki uses [Markdown](/p/accessodf/wiki/markdown_syntax/) syntax.