diff options
Diffstat (limited to 'test/accessibility/README')
| -rw-r--r-- | test/accessibility/README | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/test/accessibility/README b/test/accessibility/README new file mode 100644 index 000000000..cbe2879e1 --- /dev/null +++ b/test/accessibility/README @@ -0,0 +1,52 @@ +his directory contains sample FO files for testing the accessibility features of +FOP. + +To every FO file in this directory correspond two PDF files in the pdf/ +sub-directory: one generated by the painter, one by the renderer. For example, +the text_1.fo file has been rendered into pdf/text_1_painter_orig.pdf and +pdf/text_1_renderer_orig.pdf. The configuration file config-painter.xconf (resp. +config-renderer.xconf) was used. + +The PDF files have been checked with Adobe Acrobat Professional 9, using both +the full accessibility checker and the read-aloud feature. The checker reports +no error /and/ the entire document can be read aloud. + + +!! DO NOT MODIFY THOSE FILES, NEITHER THE FO NOR THE PDF !! + + +... Or at least, know what you are doing +If the FO files are modified, the resulting PDFs must be checked again, both +with the checker and the read-aloud feature. (Sometimes the checker reports no +problem yet part or all of the document cannot be read aloud.) + +The purpose of this infrastructure is to be able to quickly re-test the +accessibility processing chain when any change has been made to it. The +configuration files disable the compression of the PDF streams, so it is +possible to compare a re-generated PDF with the original one by using a simple +diff tool. The files will not be identical because of the different creation +dates (and the ID key in the trailer), but apart from that there should be no +difference. + +The rationale is that using a diff tool is much quicker and less tedious than +running Acrobat's accessibility checker and read-aloud feature every time. + + +To re-generate the PDF files using the painter: + ../../fop -c config-painter.xconf text_1.fo pdf/text_1_painter.pdf + diff pdf/text_1_painter_orig.pdf pdf/text_1_painter.pdf +Or, going through the intermediate format: + ../../fop -c config-painter.xconf text_1.fo -if application/pdf text_1_if.xml + ../../fop -c config-painter.xconf -ifin text_1_if.xml pdf/text_1_painter.pdf + diff pdf/text_1_painter_orig.pdf pdf/text_1_painter.pdf + +To re-generate the PDF files using the legacy renderer: + ../../fop -c config-renderer.xconf text_1.fo pdf/text_1_renderer.pdf + diff pdf/text_1_renderer_orig.pdf pdf/text_1_renderer.pdf +Or, going through the intermediate format: + ../../fop -c config-renderer.xconf text_1.fo -at application/pdf text_1_at.xml + ../../fop -c config-renderer.xconf -atin text_1_at.xml pdf/text_1_renderer.pdf + diff pdf/text_1_renderer_orig.pdf pdf/text_1_renderer.pdf + + +$Id$ |