From: Vincent Hennebert Date: Mon, 26 Oct 2009 12:35:44 +0000 (+0000) Subject: Improved and updated documentation about accessibility X-Git-Tag: fop-1_0~115^2~1 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=04cd4fd9439395fdf5250f0978b288d9003be6fd;p=xmlgraphics-fop.git Improved and updated documentation about accessibility git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/branches/Temp_Accessibility@829769 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/src/documentation/content/xdocs/trunk/accessibility.xml b/src/documentation/content/xdocs/trunk/accessibility.xml index e7e49d7c0..1eb78264b 100644 --- a/src/documentation/content/xdocs/trunk/accessibility.xml +++ b/src/documentation/content/xdocs/trunk/accessibility.xml @@ -29,13 +29,12 @@ accessibility features of Apache FOP. Section 508 defines accessibility in the context - of electronic documents for the US but it impacts also other countries. + of electronic documents for the USA but other countries have similar requirements.

- These features are concentrated exclusively on PDF output - (Tagged PDF). There are certain implementation limitations that need to be observed - and certain actions are necessary by the content creator to ensure that FOP can create - a truly accessible document. + Accessibility features are available only for the PDF output format and there are some + implementation limitations. Also, certain actions must be undertaken by the content creator + to ensure that FOP can create a truly accessible document.

@@ -43,7 +42,7 @@

There are 3 ways to enable accessibility:

  1. - Command line: The command line option -a turns on accessibility. + Command line: The command line option -a turns on accessibility: fop -a -fo mydocument.fo -pdf mydocument.pdf
  2. @@ -60,55 +59,55 @@

- As mentioned, enabling accessibility currently only changes the way PDFs are generated. - Internally, FOP maintains a reduced structure tree of the document so the target format - viewer can ultimately reconstruct the natural reading order of the document. This is - important for document readers that produce an aural representation of the content. + When accessibility is enabled, additional information relating to the logical structure of + the document is added to the PDF. That information allows the PDF viewer (or a + text-to-speech application) to retrieve the natural reading order of the document.

-

- Hint: You may need to adjust the Java heap size in order to process larger files. -

+ The processing of the logical structure is memory-hungry. You may need to adjust the + Java heap size in order to process larger files.
Changes to your XSL-FO input files

Apache FOP cannot automatically generate accessible PDFs. Some of the work can only be performed by the content provider. Following are some changes that may be necessary to - your XSL-FO content so the generate documents that are truly accessible. + your XSL-FO content in order to generate really accessible documents:

Testing

- Accessible PDFs can be tested, for example, using Adobe Acrobat Professional. Its - Accessibility Check creates a report indicating any deficiencies with a PDF document. - Alternatively, you can just let a screen reader read the document out aloud. + Accessible PDFs can be tested, for example, using Adobe Acrobat Professional. Its + Accessibility Check feature creates a report indicating any deficiencies with a PDF + document. Alternatively, you can just let a screen reader read the document aloud.

Limitations

- Accessibility support in Apache FOP is relatively new, so naturally, there are certain + Accessibility support in Apache FOP is relatively new, so there are certain limitations. Please help us identify and close any gaps.