From a9ba0e20ba94e9580953e0527f4c1400b8191f5b Mon Sep 17 00:00:00 2001 From: Clay Leeds Date: Sun, 10 Feb 2013 17:42:26 +0000 Subject: [PATCH] Removing Forrest-based documentation files. git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@1444573 13f79535-47bb-0310-9956-ffa450edef68 --- build.xml | 17 +- forrest.properties | 110 - forrest.properties.xml | 22 - publish.xml | 58 - .../classes/CatalogManager.properties | 54 - src/documentation/content/.htaccess | 39 - src/documentation/content/calendar.rdf | 41 - src/documentation/content/doap.rdf | 104 - src/documentation/content/locationmap.xml | 34 - .../content/xdocs/0.95/anttask.xml | 200 - .../content/xdocs/0.95/compiling.xml | 140 - .../content/xdocs/0.95/configuration.xml | 393 - .../content/xdocs/0.95/embedding.xml | 688 -- .../content/xdocs/0.95/extensions.xml | 233 - .../content/xdocs/0.95/fonts.xml | 410 - .../xdocs/0.95/fotree/disabled-testcases.xml | 26 - .../content/xdocs/0.95/graphics.xml | 567 -- .../content/xdocs/0.95/hyphenation.xml | 237 - .../content/xdocs/0.95/index.xml | 54 - .../content/xdocs/0.95/intermediate.xml | 146 - .../content/xdocs/0.95/known-issues.xml | 70 - .../xdocs/0.95/knownissues_overview.xml | 69 - .../0.95/layoutengine/disabled-testcases.xml | 260 - .../content/xdocs/0.95/metadata.xml | 243 - .../content/xdocs/0.95/output.xml | 914 --- src/documentation/content/xdocs/0.95/pdfa.xml | 156 - .../content/xdocs/0.95/pdfencryption.xml | 225 - src/documentation/content/xdocs/0.95/pdfx.xml | 136 - .../content/xdocs/0.95/running.xml | 350 - .../content/xdocs/0.95/servlets.xml | 325 - .../content/xdocs/0.95/upgrading.xml | 126 - .../content/xdocs/1.0/accessibility.xml | 167 - .../content/xdocs/1.0/anttask.xml | 236 - .../content/xdocs/1.0/compiling.xml | 140 - .../content/xdocs/1.0/configuration.xml | 492 -- .../content/xdocs/1.0/embedding.xml | 701 -- .../content/xdocs/1.0/events.xml | 449 -- .../content/xdocs/1.0/extensions.xml | 339 - src/documentation/content/xdocs/1.0/fonts.xml | 564 -- .../xdocs/1.0/fotree/disabled-testcases.xml | 31 - .../content/xdocs/1.0/graphics.xml | 590 -- .../content/xdocs/1.0/hyphenation.xml | 237 - src/documentation/content/xdocs/1.0/index.xml | 67 - .../content/xdocs/1.0/intermediate.xml | 331 - .../content/xdocs/1.0/known-issues.xml | 91 - .../xdocs/1.0/knownissues_overview.xml | 69 - .../1.0/layoutengine/disabled-testcases.xml | 225 - .../content/xdocs/1.0/metadata.xml | 243 - .../content/xdocs/1.0/output.xml | 1265 --- src/documentation/content/xdocs/1.0/pdfa.xml | 168 - .../content/xdocs/1.0/pdfencryption.xml | 228 - src/documentation/content/xdocs/1.0/pdfx.xml | 136 - .../content/xdocs/1.0/running.xml | 362 - .../content/xdocs/1.0/servlets.xml | 325 - .../content/xdocs/1.0/upgrading.xml | 128 - .../content/xdocs/1.1/accessibility.xml | 167 - .../content/xdocs/1.1/anttask.xml | 236 - .../content/xdocs/1.1/compiling.xml | 147 - .../content/xdocs/1.1/complexscripts.xml | 694 -- .../content/xdocs/1.1/configuration.xml | 541 -- .../content/xdocs/1.1/embedding.xml | 752 -- .../content/xdocs/1.1/events.xml | 449 -- .../content/xdocs/1.1/extensions.xml | 339 - src/documentation/content/xdocs/1.1/fonts.xml | 579 -- .../xdocs/1.1/fotree/disabled-testcases.xml | 31 - .../content/xdocs/1.1/graphics.xml | 590 -- .../content/xdocs/1.1/hyphenation.xml | 237 - src/documentation/content/xdocs/1.1/index.xml | 55 - .../content/xdocs/1.1/intermediate.xml | 331 - .../content/xdocs/1.1/known-issues.xml | 54 - .../xdocs/1.1/knownissues_overview.xml | 74 - .../1.1/layoutengine/disabled-testcases.xml | 223 - .../content/xdocs/1.1/metadata.xml | 243 - .../content/xdocs/1.1/output.xml | 1401 ---- src/documentation/content/xdocs/1.1/pdfa.xml | 168 - .../content/xdocs/1.1/pdfencryption.xml | 301 - src/documentation/content/xdocs/1.1/pdfx.xml | 136 - .../content/xdocs/1.1/running.xml | 370 - .../content/xdocs/1.1/servlets.xml | 325 - .../content/xdocs/1.1/upgrading.xml | 181 - src/documentation/content/xdocs/bugs.xml | 113 - .../content/xdocs/compliance.ihtml | 4874 ----------- .../content/xdocs/dev/conventions.xml | 187 - .../content/xdocs/dev/design/areas.xml | 191 - .../content/xdocs/dev/design/breakpos.xml | 315 - .../xdocs/dev/design/configuration.xml | 205 - .../content/xdocs/dev/design/embedding.xml | 149 - .../content/xdocs/dev/design/extending.xml | 140 - .../content/xdocs/dev/design/fotree.xml | 143 - .../content/xdocs/dev/design/images.xml | 151 - .../content/xdocs/dev/design/index.xml | 160 - .../content/xdocs/dev/design/layout.xml | 407 - .../content/xdocs/dev/design/optimise.xml | 74 - .../content/xdocs/dev/design/parsing.xml | 76 - .../content/xdocs/dev/design/pdf-library.xml | 91 - .../content/xdocs/dev/design/properties.xml | 380 - .../content/xdocs/dev/design/renderers.xml | 229 - .../content/xdocs/dev/design/startup.xml | 56 - .../content/xdocs/dev/design/svg.xml | 90 - .../content/xdocs/dev/design/useragent.xml | 114 - src/documentation/content/xdocs/dev/doc.xml | 166 - .../content/xdocs/dev/extensions.xml | 64 - src/documentation/content/xdocs/dev/faq.xml | 65 - .../content/xdocs/dev/fo/embedding.fo | 1123 --- .../content/xdocs/dev/fo/embedding.fo.pdf | Bin 45694 -> 0 bytes src/documentation/content/xdocs/dev/fonts.xml | 90 - .../content/xdocs/dev/implement.xml | 110 - src/documentation/content/xdocs/dev/index.xml | 165 - .../content/xdocs/dev/release.xml | 132 - .../content/xdocs/dev/rtflib.xml | 327 - src/documentation/content/xdocs/dev/svg.xml | 136 - .../content/xdocs/dev/svg/images.pdf | Bin 482439 -> 0 bytes .../content/xdocs/dev/svg/images.png | Bin 60496 -> 0 bytes .../content/xdocs/dev/svg/images.svg | 58 - .../content/xdocs/dev/svg/link.pdf | 123 - .../content/xdocs/dev/svg/link.png | Bin 4963 -> 0 bytes .../content/xdocs/dev/svg/link.svg | 47 - .../content/xdocs/dev/svg/logo.jpg | Bin 2970 -> 0 bytes .../content/xdocs/dev/svg/paints.pdf | Bin 11671 -> 0 bytes .../content/xdocs/dev/svg/paints.png | Bin 25074 -> 0 bytes .../content/xdocs/dev/svg/paints.svg | 100 - .../content/xdocs/dev/svg/text.pdf | Bin 29437 -> 0 bytes .../content/xdocs/dev/svg/text.png | Bin 32069 -> 0 bytes .../content/xdocs/dev/svg/text.svg | 148 - .../content/xdocs/dev/svg/transparency.pdf | Bin 204742 -> 0 bytes .../content/xdocs/dev/svg/transparency.png | Bin 37709 -> 0 bytes .../content/xdocs/dev/svg/transparency.svg | 65 - .../content/xdocs/dev/testing.xml | 153 - src/documentation/content/xdocs/dev/tools.xml | 132 - src/documentation/content/xdocs/download.xml | 178 - src/documentation/content/xdocs/examples.xml | 141 - src/documentation/content/xdocs/faq.xml | 1355 ---- src/documentation/content/xdocs/favicon.ico | Bin 766 -> 0 bytes src/documentation/content/xdocs/fo.xml | 528 -- src/documentation/content/xdocs/fo/align.fo | 83 - src/documentation/content/xdocs/fo/align.pdf | Bin 9284 -> 0 bytes src/documentation/content/xdocs/fo/align2.fo | 83 - src/documentation/content/xdocs/fo/align2.pdf | Bin 8797 -> 0 bytes src/documentation/content/xdocs/fo/blocks.ent | 38 - src/documentation/content/xdocs/fo/build.xml | 70 - src/documentation/content/xdocs/fo/embed.fo | 110 - src/documentation/content/xdocs/fo/embed.pdf | Bin 8249 -> 0 bytes src/documentation/content/xdocs/fo/fonts.fo | 1320 --- src/documentation/content/xdocs/fo/fonts.pdf | Bin 20432 -> 0 bytes .../content/xdocs/fo/images/fop.jpg | Bin 2339 -> 0 bytes src/documentation/content/xdocs/fo/size.fo | 138 - src/documentation/content/xdocs/fo/size.pdf | Bin 9508 -> 0 bytes src/documentation/content/xdocs/gethelp.xml | 93 - src/documentation/content/xdocs/index.xml | 82 - .../content/xdocs/knownissues.xml | 80 - src/documentation/content/xdocs/license.xml | 47 - src/documentation/content/xdocs/maillist.xml | 130 - src/documentation/content/xdocs/news-data.xml | 226 - src/documentation/content/xdocs/news.xml | 39 - .../content/xdocs/quickstartguide.xml | 124 - src/documentation/content/xdocs/resources.xml | 264 - src/documentation/content/xdocs/site.xml | 297 - src/documentation/content/xdocs/status.xml | 135 - src/documentation/content/xdocs/tabs.xml | 28 - src/documentation/content/xdocs/team.xml | 128 - .../content/xdocs/trunk/accessibility.xml | 167 - .../content/xdocs/trunk/anttask.xml | 236 - .../content/xdocs/trunk/compiling.xml | 147 - .../content/xdocs/trunk/complexscripts.xml | 628 -- .../content/xdocs/trunk/configuration.xml | 559 -- .../content/xdocs/trunk/embedding.xml | 735 -- .../content/xdocs/trunk/events.xml | 449 -- .../content/xdocs/trunk/extensions.xml | 339 - .../content/xdocs/trunk/fonts.xml | 579 -- .../content/xdocs/trunk/graphics.xml | 593 -- .../content/xdocs/trunk/hyphenation.xml | 237 - .../content/xdocs/trunk/index.xml | 50 - .../content/xdocs/trunk/intermediate.xml | 331 - .../content/xdocs/trunk/metadata.xml | 243 - .../content/xdocs/trunk/output.xml | 1411 ---- .../content/xdocs/trunk/pdfa.xml | 168 - .../content/xdocs/trunk/pdfencryption.xml | 301 - .../content/xdocs/trunk/pdfx.xml | 136 - .../content/xdocs/trunk/running.xml | 370 - .../content/xdocs/trunk/servlets.xml | 325 - .../content/xdocs/trunk/upgrading.xml | 122 - .../intermediate-format-ng/README.txt | 7 - .../intermediate-format-ng/example1.xml | 73 - .../fop-intermediate-format-ng-content.xsd | 165 - .../fop-intermediate-format-ng-datatypes.xsd | 124 - .../fop-intermediate-format-ng-nav.xsd | 124 - .../fop-intermediate-format-ng.xsd | 102 - .../intermediate-format-ng/xmp-metadata.xsd | 35 - .../xmp-rdf-metadata.xsd | 36 - src/documentation/poster/README.txt | 12 - src/documentation/poster/cfg/fop.xconf | 30 - src/documentation/poster/go.bat | 3 - src/documentation/poster/svg/asf-logo.svg | 2050 ----- .../poster/svg/fop-logo-reconstructed.svg | 954 --- .../poster/svg/fop-transformation-chain.svg | 71 - .../poster/svg/pepe-business-card.svg | 33 - .../poster/xml/business-card-demo.xml | 110 - .../poster/xml/fop-foreign-xml-support.xml | 28 - .../poster/xml/fop-getting-help.xml | 30 - src/documentation/poster/xml/fop-history.xml | 50 - .../poster/xml/fop-image-support.xml | 32 - .../poster/xml/fop-output-formats.xml | 41 - src/documentation/poster/xml/fop-overview.xml | 42 - src/documentation/poster/xml/fop-poster.xml | 31 - .../poster/xml/fop-transformation-chain.xml | 33 - .../poster/xml/fop-use-cases.xml | 64 - .../poster/xml/hello-world-in-fo.xml | 41 - src/documentation/poster/xslt/common.xsl | 100 - src/documentation/poster/xslt/fop-poster.xsl | 159 - src/documentation/poster/xslt/poster.xsl | 41 - .../images/EmbeddingExampleFO2PDF.png | Bin 1311 -> 0 bytes .../images/EmbeddingExampleObj2PDF.png | Bin 2822 -> 0 bytes .../images/EmbeddingExampleObj2XML.png | Bin 1198 -> 0 bytes .../images/EmbeddingExampleXML2FO.png | Bin 1555 -> 0 bytes .../images/EmbeddingExampleXML2PDF.png | Bin 2148 -> 0 bytes .../acrobat-anti-aliasing-artifacts.png | Bin 8128 -> 0 bytes .../images/anti-aliasing-artifacts-demo.fo | 57 - .../resources/images/apache-xml-graphics.gif | Bin 7317 -> 0 bytes .../resources/images/apache-xml-graphics.jpg | Bin 5184 -> 0 bytes .../resources/images/apache-xml-graphics.png | Bin 20382 -> 0 bytes .../resources/images/apache-xml-graphics.svg | 580 -- .../design/alt.design/AbsolutePosition.png | Bin 4890 -> 0 bytes .../design/alt.design/BorderCommonStyle.png | Bin 4140 -> 0 bytes .../images/design/alt.design/PropNames.png | Bin 3428 -> 0 bytes .../images/design/alt.design/Properties.png | Bin 32437 -> 0 bytes .../design/alt.design/PropertyClasses.png | Bin 17581 -> 0 bytes .../design/alt.design/PropertyConsts.png | Bin 20379 -> 0 bytes .../alt.design/PropertyStaticsOverview.png | Bin 7503 -> 0 bytes .../images/design/alt.design/SAXParsing.png | Bin 24482 -> 0 bytes .../design/alt.design/VerticalAlign.png | Bin 7091 -> 0 bytes .../design/alt.design/XML-event-buffer.png | Bin 20415 -> 0 bytes .../design/alt.design/XMLEventQueue.png | Bin 11643 -> 0 bytes .../alt.design/block-stacking-constraints.png | Bin 5358 -> 0 bytes .../alt.design/block-stacking-keeps.png | Bin 10064 -> 0 bytes .../design/alt.design/block-stacking.png | Bin 5956 -> 0 bytes .../images/design/alt.design/coroutines.png | Bin 6025 -> 0 bytes .../alt.design/fo-layout-interaction.png | Bin 43795 -> 0 bytes .../alt.design/galley-preprocessing.png | Bin 20744 -> 0 bytes .../alt.design/initial-column-values.png | Bin 10965 -> 0 bytes .../images/design/alt.design/line-area-5.png | Bin 22400 -> 0 bytes .../images/design/alt.design/line-area-6.png | Bin 20801 -> 0 bytes .../design/alt.design/parserPersistence.png | Bin 8330 -> 0 bytes .../design/alt.design/processPlumbing.png | Bin 8689 -> 0 bytes .../property-super-classes-full.png | Bin 89360 -> 0 bytes .../images/design/alt.design/pull-parsing.png | Bin 55967 -> 0 bytes .../design/alt.design/xmlevent-queue.png | Bin 12326 -> 0 bytes .../resources/images/document.jpg | Bin 26138 -> 0 bytes .../resources/images/feed-icon-14x14.png | Bin 689 -> 0 bytes src/documentation/resources/images/fop.jpg | Bin 2339 -> 0 bytes .../resources/images/group-logo.gif | Bin 7317 -> 0 bytes .../resources/images/group-logo.jpg | Bin 5184 -> 0 bytes .../resources/images/group-logo.png | Bin 20382 -> 0 bytes .../resources/images/group-logo.svg | 580 -- .../images/if-architecture-overview.png | Bin 66886 -> 0 bytes src/documentation/resources/images/layout.jpg | Bin 21176 -> 0 bytes src/documentation/resources/images/logo.jpg | Bin 2970 -> 0 bytes src/documentation/resources/images/logo2.ai | 1970 ----- src/documentation/resources/images/logo2.svg | 7145 ----------------- .../images/svg/EmbeddingExampleFO2PDF.svg | 37 - .../images/svg/EmbeddingExampleObj2PDF.svg | 57 - .../images/svg/EmbeddingExampleObj2XML.svg | 37 - .../images/svg/EmbeddingExampleXML2FO.svg | 38 - .../images/svg/EmbeddingExampleXML2PDF.svg | 48 - .../images/svg/if-architecture-overview.svg | 973 --- src/documentation/resources/images/track.png | Bin 50481 -> 0 bytes src/documentation/resources/schema/catalog | 7 - .../resources/schema/catalog.fop.xcat | 29 - .../resources/schema/catalog.xcat | 27 - .../resources/schema/dtd/compliance-v10.dtd | 61 - .../stylesheets/changes2document.xsl | 174 - .../stylesheets/compliance2document.xsl | 247 - .../resources/stylesheets/compliance2fo.xsl | 396 - .../resources/stylesheets/compliance2html.xsl | 431 - .../disabled-testcases2document.xsl | 61 - .../resources/stylesheets/dotdots.xsl | 78 - .../stylesheets/known-issues2document.xsl | 55 - .../resources/stylesheets/news2document.xsl | 53 - .../resources/stylesheets/news2rss.xsl | 58 - .../stylesheets/releaseNotes2document.xsl | 131 - src/documentation/sitemap.xmap | 97 - src/documentation/skinconf.xml | 401 - 281 files changed, 16 insertions(+), 66280 deletions(-) delete mode 100644 forrest.properties delete mode 100644 forrest.properties.xml delete mode 100644 publish.xml delete mode 100644 src/documentation/classes/CatalogManager.properties delete mode 100644 src/documentation/content/.htaccess delete mode 100644 src/documentation/content/calendar.rdf delete mode 100644 src/documentation/content/doap.rdf delete mode 100644 src/documentation/content/locationmap.xml delete mode 100644 src/documentation/content/xdocs/0.95/anttask.xml delete mode 100644 src/documentation/content/xdocs/0.95/compiling.xml delete mode 100644 src/documentation/content/xdocs/0.95/configuration.xml delete mode 100644 src/documentation/content/xdocs/0.95/embedding.xml delete mode 100644 src/documentation/content/xdocs/0.95/extensions.xml delete mode 100644 src/documentation/content/xdocs/0.95/fonts.xml delete mode 100644 src/documentation/content/xdocs/0.95/fotree/disabled-testcases.xml delete mode 100644 src/documentation/content/xdocs/0.95/graphics.xml delete mode 100644 src/documentation/content/xdocs/0.95/hyphenation.xml delete mode 100644 src/documentation/content/xdocs/0.95/index.xml delete mode 100644 src/documentation/content/xdocs/0.95/intermediate.xml delete mode 100644 src/documentation/content/xdocs/0.95/known-issues.xml delete mode 100644 src/documentation/content/xdocs/0.95/knownissues_overview.xml delete mode 100644 src/documentation/content/xdocs/0.95/layoutengine/disabled-testcases.xml delete mode 100644 src/documentation/content/xdocs/0.95/metadata.xml delete mode 100644 src/documentation/content/xdocs/0.95/output.xml delete mode 100644 src/documentation/content/xdocs/0.95/pdfa.xml delete mode 100644 src/documentation/content/xdocs/0.95/pdfencryption.xml delete mode 100644 src/documentation/content/xdocs/0.95/pdfx.xml delete mode 100644 src/documentation/content/xdocs/0.95/running.xml delete mode 100644 src/documentation/content/xdocs/0.95/servlets.xml delete mode 100644 src/documentation/content/xdocs/0.95/upgrading.xml delete mode 100644 src/documentation/content/xdocs/1.0/accessibility.xml delete mode 100644 src/documentation/content/xdocs/1.0/anttask.xml delete mode 100644 src/documentation/content/xdocs/1.0/compiling.xml delete mode 100644 src/documentation/content/xdocs/1.0/configuration.xml delete mode 100644 src/documentation/content/xdocs/1.0/embedding.xml delete mode 100644 src/documentation/content/xdocs/1.0/events.xml delete mode 100644 src/documentation/content/xdocs/1.0/extensions.xml delete mode 100644 src/documentation/content/xdocs/1.0/fonts.xml delete mode 100644 src/documentation/content/xdocs/1.0/fotree/disabled-testcases.xml delete mode 100644 src/documentation/content/xdocs/1.0/graphics.xml delete mode 100644 src/documentation/content/xdocs/1.0/hyphenation.xml delete mode 100644 src/documentation/content/xdocs/1.0/index.xml delete mode 100644 src/documentation/content/xdocs/1.0/intermediate.xml delete mode 100644 src/documentation/content/xdocs/1.0/known-issues.xml delete mode 100644 src/documentation/content/xdocs/1.0/knownissues_overview.xml delete mode 100644 src/documentation/content/xdocs/1.0/layoutengine/disabled-testcases.xml delete mode 100644 src/documentation/content/xdocs/1.0/metadata.xml delete mode 100644 src/documentation/content/xdocs/1.0/output.xml delete mode 100644 src/documentation/content/xdocs/1.0/pdfa.xml delete mode 100644 src/documentation/content/xdocs/1.0/pdfencryption.xml delete mode 100644 src/documentation/content/xdocs/1.0/pdfx.xml delete mode 100644 src/documentation/content/xdocs/1.0/running.xml delete mode 100644 src/documentation/content/xdocs/1.0/servlets.xml delete mode 100644 src/documentation/content/xdocs/1.0/upgrading.xml delete mode 100644 src/documentation/content/xdocs/1.1/accessibility.xml delete mode 100644 src/documentation/content/xdocs/1.1/anttask.xml delete mode 100644 src/documentation/content/xdocs/1.1/compiling.xml delete mode 100644 src/documentation/content/xdocs/1.1/complexscripts.xml delete mode 100644 src/documentation/content/xdocs/1.1/configuration.xml delete mode 100644 src/documentation/content/xdocs/1.1/embedding.xml delete mode 100644 src/documentation/content/xdocs/1.1/events.xml delete mode 100644 src/documentation/content/xdocs/1.1/extensions.xml delete mode 100644 src/documentation/content/xdocs/1.1/fonts.xml delete mode 100644 src/documentation/content/xdocs/1.1/fotree/disabled-testcases.xml delete mode 100644 src/documentation/content/xdocs/1.1/graphics.xml delete mode 100644 src/documentation/content/xdocs/1.1/hyphenation.xml delete mode 100644 src/documentation/content/xdocs/1.1/index.xml delete mode 100644 src/documentation/content/xdocs/1.1/intermediate.xml delete mode 100644 src/documentation/content/xdocs/1.1/known-issues.xml delete mode 100644 src/documentation/content/xdocs/1.1/knownissues_overview.xml delete mode 100644 src/documentation/content/xdocs/1.1/layoutengine/disabled-testcases.xml delete mode 100644 src/documentation/content/xdocs/1.1/metadata.xml delete mode 100644 src/documentation/content/xdocs/1.1/output.xml delete mode 100644 src/documentation/content/xdocs/1.1/pdfa.xml delete mode 100644 src/documentation/content/xdocs/1.1/pdfencryption.xml delete mode 100644 src/documentation/content/xdocs/1.1/pdfx.xml delete mode 100644 src/documentation/content/xdocs/1.1/running.xml delete mode 100644 src/documentation/content/xdocs/1.1/servlets.xml delete mode 100644 src/documentation/content/xdocs/1.1/upgrading.xml delete mode 100644 src/documentation/content/xdocs/bugs.xml delete mode 100644 src/documentation/content/xdocs/compliance.ihtml delete mode 100644 src/documentation/content/xdocs/dev/conventions.xml delete mode 100644 src/documentation/content/xdocs/dev/design/areas.xml delete mode 100644 src/documentation/content/xdocs/dev/design/breakpos.xml delete mode 100644 src/documentation/content/xdocs/dev/design/configuration.xml delete mode 100644 src/documentation/content/xdocs/dev/design/embedding.xml delete mode 100644 src/documentation/content/xdocs/dev/design/extending.xml delete mode 100644 src/documentation/content/xdocs/dev/design/fotree.xml delete mode 100644 src/documentation/content/xdocs/dev/design/images.xml delete mode 100644 src/documentation/content/xdocs/dev/design/index.xml delete mode 100644 src/documentation/content/xdocs/dev/design/layout.xml delete mode 100644 src/documentation/content/xdocs/dev/design/optimise.xml delete mode 100644 src/documentation/content/xdocs/dev/design/parsing.xml delete mode 100644 src/documentation/content/xdocs/dev/design/pdf-library.xml delete mode 100644 src/documentation/content/xdocs/dev/design/properties.xml delete mode 100644 src/documentation/content/xdocs/dev/design/renderers.xml delete mode 100644 src/documentation/content/xdocs/dev/design/startup.xml delete mode 100644 src/documentation/content/xdocs/dev/design/svg.xml delete mode 100644 src/documentation/content/xdocs/dev/design/useragent.xml delete mode 100644 src/documentation/content/xdocs/dev/doc.xml delete mode 100644 src/documentation/content/xdocs/dev/extensions.xml delete mode 100644 src/documentation/content/xdocs/dev/faq.xml delete mode 100644 src/documentation/content/xdocs/dev/fo/embedding.fo delete mode 100644 src/documentation/content/xdocs/dev/fo/embedding.fo.pdf delete mode 100644 src/documentation/content/xdocs/dev/fonts.xml delete mode 100644 src/documentation/content/xdocs/dev/implement.xml delete mode 100644 src/documentation/content/xdocs/dev/index.xml delete mode 100644 src/documentation/content/xdocs/dev/release.xml delete mode 100644 src/documentation/content/xdocs/dev/rtflib.xml delete mode 100644 src/documentation/content/xdocs/dev/svg.xml delete mode 100644 src/documentation/content/xdocs/dev/svg/images.pdf delete mode 100644 src/documentation/content/xdocs/dev/svg/images.png delete mode 100644 src/documentation/content/xdocs/dev/svg/images.svg delete mode 100644 src/documentation/content/xdocs/dev/svg/link.pdf delete mode 100644 src/documentation/content/xdocs/dev/svg/link.png delete mode 100644 src/documentation/content/xdocs/dev/svg/link.svg delete mode 100644 src/documentation/content/xdocs/dev/svg/logo.jpg delete mode 100644 src/documentation/content/xdocs/dev/svg/paints.pdf delete mode 100644 src/documentation/content/xdocs/dev/svg/paints.png delete mode 100644 src/documentation/content/xdocs/dev/svg/paints.svg delete mode 100644 src/documentation/content/xdocs/dev/svg/text.pdf delete mode 100644 src/documentation/content/xdocs/dev/svg/text.png delete mode 100644 src/documentation/content/xdocs/dev/svg/text.svg delete mode 100644 src/documentation/content/xdocs/dev/svg/transparency.pdf delete mode 100644 src/documentation/content/xdocs/dev/svg/transparency.png delete mode 100644 src/documentation/content/xdocs/dev/svg/transparency.svg delete mode 100644 src/documentation/content/xdocs/dev/testing.xml delete mode 100644 src/documentation/content/xdocs/dev/tools.xml delete mode 100644 src/documentation/content/xdocs/download.xml delete mode 100644 src/documentation/content/xdocs/examples.xml delete mode 100644 src/documentation/content/xdocs/faq.xml delete mode 100644 src/documentation/content/xdocs/favicon.ico delete mode 100644 src/documentation/content/xdocs/fo.xml delete mode 100644 src/documentation/content/xdocs/fo/align.fo delete mode 100644 src/documentation/content/xdocs/fo/align.pdf delete mode 100644 src/documentation/content/xdocs/fo/align2.fo delete mode 100644 src/documentation/content/xdocs/fo/align2.pdf delete mode 100644 src/documentation/content/xdocs/fo/blocks.ent delete mode 100644 src/documentation/content/xdocs/fo/build.xml delete mode 100644 src/documentation/content/xdocs/fo/embed.fo delete mode 100644 src/documentation/content/xdocs/fo/embed.pdf delete mode 100644 src/documentation/content/xdocs/fo/fonts.fo delete mode 100644 src/documentation/content/xdocs/fo/fonts.pdf delete mode 100644 src/documentation/content/xdocs/fo/images/fop.jpg delete mode 100644 src/documentation/content/xdocs/fo/size.fo delete mode 100644 src/documentation/content/xdocs/fo/size.pdf delete mode 100644 src/documentation/content/xdocs/gethelp.xml delete mode 100644 src/documentation/content/xdocs/index.xml delete mode 100644 src/documentation/content/xdocs/knownissues.xml delete mode 100644 src/documentation/content/xdocs/license.xml delete mode 100644 src/documentation/content/xdocs/maillist.xml delete mode 100644 src/documentation/content/xdocs/news-data.xml delete mode 100644 src/documentation/content/xdocs/news.xml delete mode 100644 src/documentation/content/xdocs/quickstartguide.xml delete mode 100644 src/documentation/content/xdocs/resources.xml delete mode 100644 src/documentation/content/xdocs/site.xml delete mode 100644 src/documentation/content/xdocs/status.xml delete mode 100644 src/documentation/content/xdocs/tabs.xml delete mode 100644 src/documentation/content/xdocs/team.xml delete mode 100644 src/documentation/content/xdocs/trunk/accessibility.xml delete mode 100644 src/documentation/content/xdocs/trunk/anttask.xml delete mode 100644 src/documentation/content/xdocs/trunk/compiling.xml delete mode 100644 src/documentation/content/xdocs/trunk/complexscripts.xml delete mode 100644 src/documentation/content/xdocs/trunk/configuration.xml delete mode 100644 src/documentation/content/xdocs/trunk/embedding.xml delete mode 100644 src/documentation/content/xdocs/trunk/events.xml delete mode 100644 src/documentation/content/xdocs/trunk/extensions.xml delete mode 100644 src/documentation/content/xdocs/trunk/fonts.xml delete mode 100644 src/documentation/content/xdocs/trunk/graphics.xml delete mode 100644 src/documentation/content/xdocs/trunk/hyphenation.xml delete mode 100644 src/documentation/content/xdocs/trunk/index.xml delete mode 100644 src/documentation/content/xdocs/trunk/intermediate.xml delete mode 100644 src/documentation/content/xdocs/trunk/metadata.xml delete mode 100644 src/documentation/content/xdocs/trunk/output.xml delete mode 100644 src/documentation/content/xdocs/trunk/pdfa.xml delete mode 100644 src/documentation/content/xdocs/trunk/pdfencryption.xml delete mode 100644 src/documentation/content/xdocs/trunk/pdfx.xml delete mode 100644 src/documentation/content/xdocs/trunk/running.xml delete mode 100644 src/documentation/content/xdocs/trunk/servlets.xml delete mode 100644 src/documentation/content/xdocs/trunk/upgrading.xml delete mode 100644 src/documentation/intermediate-format-ng/README.txt delete mode 100644 src/documentation/intermediate-format-ng/example1.xml delete mode 100644 src/documentation/intermediate-format-ng/fop-intermediate-format-ng-content.xsd delete mode 100644 src/documentation/intermediate-format-ng/fop-intermediate-format-ng-datatypes.xsd delete mode 100644 src/documentation/intermediate-format-ng/fop-intermediate-format-ng-nav.xsd delete mode 100644 src/documentation/intermediate-format-ng/fop-intermediate-format-ng.xsd delete mode 100644 src/documentation/intermediate-format-ng/xmp-metadata.xsd delete mode 100644 src/documentation/intermediate-format-ng/xmp-rdf-metadata.xsd delete mode 100644 src/documentation/poster/README.txt delete mode 100644 src/documentation/poster/cfg/fop.xconf delete mode 100644 src/documentation/poster/go.bat delete mode 100644 src/documentation/poster/svg/asf-logo.svg delete mode 100644 src/documentation/poster/svg/fop-logo-reconstructed.svg delete mode 100644 src/documentation/poster/svg/fop-transformation-chain.svg delete mode 100644 src/documentation/poster/svg/pepe-business-card.svg delete mode 100644 src/documentation/poster/xml/business-card-demo.xml delete mode 100644 src/documentation/poster/xml/fop-foreign-xml-support.xml delete mode 100644 src/documentation/poster/xml/fop-getting-help.xml delete mode 100644 src/documentation/poster/xml/fop-history.xml delete mode 100644 src/documentation/poster/xml/fop-image-support.xml delete mode 100644 src/documentation/poster/xml/fop-output-formats.xml delete mode 100644 src/documentation/poster/xml/fop-overview.xml delete mode 100644 src/documentation/poster/xml/fop-poster.xml delete mode 100644 src/documentation/poster/xml/fop-transformation-chain.xml delete mode 100644 src/documentation/poster/xml/fop-use-cases.xml delete mode 100644 src/documentation/poster/xml/hello-world-in-fo.xml delete mode 100644 src/documentation/poster/xslt/common.xsl delete mode 100644 src/documentation/poster/xslt/fop-poster.xsl delete mode 100644 src/documentation/poster/xslt/poster.xsl delete mode 100644 src/documentation/resources/images/EmbeddingExampleFO2PDF.png delete mode 100644 src/documentation/resources/images/EmbeddingExampleObj2PDF.png delete mode 100644 src/documentation/resources/images/EmbeddingExampleObj2XML.png delete mode 100644 src/documentation/resources/images/EmbeddingExampleXML2FO.png delete mode 100644 src/documentation/resources/images/EmbeddingExampleXML2PDF.png delete mode 100644 src/documentation/resources/images/acrobat-anti-aliasing-artifacts.png delete mode 100644 src/documentation/resources/images/anti-aliasing-artifacts-demo.fo delete mode 100644 src/documentation/resources/images/apache-xml-graphics.gif delete mode 100755 src/documentation/resources/images/apache-xml-graphics.jpg delete mode 100644 src/documentation/resources/images/apache-xml-graphics.png delete mode 100755 src/documentation/resources/images/apache-xml-graphics.svg delete mode 100644 src/documentation/resources/images/design/alt.design/AbsolutePosition.png delete mode 100644 src/documentation/resources/images/design/alt.design/BorderCommonStyle.png delete mode 100644 src/documentation/resources/images/design/alt.design/PropNames.png delete mode 100644 src/documentation/resources/images/design/alt.design/Properties.png delete mode 100644 src/documentation/resources/images/design/alt.design/PropertyClasses.png delete mode 100644 src/documentation/resources/images/design/alt.design/PropertyConsts.png delete mode 100644 src/documentation/resources/images/design/alt.design/PropertyStaticsOverview.png delete mode 100644 src/documentation/resources/images/design/alt.design/SAXParsing.png delete mode 100644 src/documentation/resources/images/design/alt.design/VerticalAlign.png delete mode 100644 src/documentation/resources/images/design/alt.design/XML-event-buffer.png delete mode 100644 src/documentation/resources/images/design/alt.design/XMLEventQueue.png delete mode 100644 src/documentation/resources/images/design/alt.design/block-stacking-constraints.png delete mode 100644 src/documentation/resources/images/design/alt.design/block-stacking-keeps.png delete mode 100644 src/documentation/resources/images/design/alt.design/block-stacking.png delete mode 100644 src/documentation/resources/images/design/alt.design/coroutines.png delete mode 100644 src/documentation/resources/images/design/alt.design/fo-layout-interaction.png delete mode 100644 src/documentation/resources/images/design/alt.design/galley-preprocessing.png delete mode 100644 src/documentation/resources/images/design/alt.design/initial-column-values.png delete mode 100644 src/documentation/resources/images/design/alt.design/line-area-5.png delete mode 100644 src/documentation/resources/images/design/alt.design/line-area-6.png delete mode 100644 src/documentation/resources/images/design/alt.design/parserPersistence.png delete mode 100644 src/documentation/resources/images/design/alt.design/processPlumbing.png delete mode 100644 src/documentation/resources/images/design/alt.design/property-super-classes-full.png delete mode 100644 src/documentation/resources/images/design/alt.design/pull-parsing.png delete mode 100644 src/documentation/resources/images/design/alt.design/xmlevent-queue.png delete mode 100644 src/documentation/resources/images/document.jpg delete mode 100644 src/documentation/resources/images/feed-icon-14x14.png delete mode 100644 src/documentation/resources/images/fop.jpg delete mode 100644 src/documentation/resources/images/group-logo.gif delete mode 100755 src/documentation/resources/images/group-logo.jpg delete mode 100644 src/documentation/resources/images/group-logo.png delete mode 100755 src/documentation/resources/images/group-logo.svg delete mode 100644 src/documentation/resources/images/if-architecture-overview.png delete mode 100644 src/documentation/resources/images/layout.jpg delete mode 100644 src/documentation/resources/images/logo.jpg delete mode 100644 src/documentation/resources/images/logo2.ai delete mode 100644 src/documentation/resources/images/logo2.svg delete mode 100644 src/documentation/resources/images/svg/EmbeddingExampleFO2PDF.svg delete mode 100644 src/documentation/resources/images/svg/EmbeddingExampleObj2PDF.svg delete mode 100644 src/documentation/resources/images/svg/EmbeddingExampleObj2XML.svg delete mode 100644 src/documentation/resources/images/svg/EmbeddingExampleXML2FO.svg delete mode 100644 src/documentation/resources/images/svg/EmbeddingExampleXML2PDF.svg delete mode 100644 src/documentation/resources/images/svg/if-architecture-overview.svg delete mode 100644 src/documentation/resources/images/track.png delete mode 100644 src/documentation/resources/schema/catalog delete mode 100644 src/documentation/resources/schema/catalog.fop.xcat delete mode 100644 src/documentation/resources/schema/catalog.xcat delete mode 100644 src/documentation/resources/schema/dtd/compliance-v10.dtd delete mode 100644 src/documentation/resources/stylesheets/changes2document.xsl delete mode 100644 src/documentation/resources/stylesheets/compliance2document.xsl delete mode 100644 src/documentation/resources/stylesheets/compliance2fo.xsl delete mode 100644 src/documentation/resources/stylesheets/compliance2html.xsl delete mode 100644 src/documentation/resources/stylesheets/disabled-testcases2document.xsl delete mode 100644 src/documentation/resources/stylesheets/dotdots.xsl delete mode 100644 src/documentation/resources/stylesheets/known-issues2document.xsl delete mode 100644 src/documentation/resources/stylesheets/news2document.xsl delete mode 100644 src/documentation/resources/stylesheets/news2rss.xsl delete mode 100644 src/documentation/resources/stylesheets/releaseNotes2document.xsl delete mode 100644 src/documentation/sitemap.xmap delete mode 100644 src/documentation/skinconf.xml diff --git a/build.xml b/build.xml index bde57331d..58f75d581 100644 --- a/build.xml +++ b/build.xml @@ -169,7 +169,9 @@ list of possible build targets. + @@ -1177,6 +1179,9 @@ NOTE: + + + + + @@ -1209,16 +1217,20 @@ NOTE: - + + + + @@ -1544,6 +1556,8 @@ NOTE: + + diff --git a/forrest.properties b/forrest.properties deleted file mode 100644 index 6e9872d96..000000000 --- a/forrest.properties +++ /dev/null @@ -1,110 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one or more -# contributor license agreements. See the NOTICE file distributed with -# this work for additional information regarding copyright ownership. -# The ASF licenses this file to You under the Apache License, Version 2.0 -# (the "License"); you may not use this file except in compliance with -# the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. - -############## -# Properties used by forrest.build.xml for building the website -# These are the defaults, un-comment them if you need to change them. -############## - -# Prints out a summary of Forrest settings for this project -#forrest.echo=true - -# Project name (used to name .war file) -project.name=fop-project - -# Specifies name of Forrest skin to use -#project.skin=forrest-site -#project.skin=crust -project.skin=pelt - -# comma separated list, file:// is supported -#forrest.skins.descriptors=http://forrest.apache.org/skins/skins.xml,file:///c:/myskins/skins.xml - -############## -# behavioural properties -#project.menu-scheme=tab_attributes -#project.menu-scheme=directories - -############## -# layout properties - -# Properties that can be set to override the default locations -# -# Parent properties must be set. This usually means uncommenting -# project.content-dir if any other property using it is uncommented - -#project.status=status.xml -#project.content-dir=src/documentation -#project.raw-content-dir=${project.content-dir}/content -#project.conf-dir=${project.content-dir}/conf -#project.sitemap-dir=${project.content-dir} -#project.xdocs-dir=${project.content-dir}/content/xdocs -#project.resources-dir=${project.content-dir}/resources -#project.stylesheets-dir=${project.resources-dir}/stylesheets -#project.images-dir=${project.resources-dir}/images -#project.schema-dir=${project.resources-dir}/schema -#project.skins-dir=${project.content-dir}/skins -project.skinconf=${project.content-dir}/skinconf.xml -#project.lib-dir=${project.content-dir}/lib -#project.classes-dir=${project.content-dir}/classes -#project.translations-dir=${project.content-dir}/translations -project.knownissues=known-issues.xml - -############## -# validation properties - -#forrest.validate=true -#forrest.validate=false -forrest.validate.xdocs=${forrest.validate} -forrest.validate.skinconf=${forrest.validate} -forrest.validate.sitemap=${forrest.validate} -forrest.validate.stylesheets=${forrest.validate} -forrest.validate.skins=${forrest.validate} -forrest.validate.skins.stylesheets=${forrest.validate.skins} - -# *.failonerror=(true|false) - stop when an XML file is invalid -#forrest.validate.failonerror=true - -# *.excludes=(pattern) - comma-separated list of path patterns to not validate -# e.g. -#forrest.validate.xdocs.excludes=samples/subdir/**, samples/faq.xml -#forrest.validate.xdocs.excludes= - - -############## -# General Forrest properties - -# The URL to start crawling from -#project.start-uri=linkmap.html -# Set logging level for messages printed to the console -# (DEBUG, INFO, WARN, ERROR, FATAL_ERROR) -#project.debuglevel=ERROR -# Max memory to allocate to Java -forrest.maxmemory=128m -# Any other arguments to pass to the JVM. For example, to run on an X-less -# server, set to -Djava.awt.headless=true -#forrest.jvmargs= -# The bugtracking URL - the issue number will be appended -project.bugtracking-url=http://issues.apache.org/bugzilla/show_bug.cgi?id= -bugtracking-url=http://issues.apache.org/bugzilla/show_bug.cgi?id= -#project.bugtracking-url=http://issues.apache.org/jira/browse/ -# The issues list as rss -#project.issues-rss-url= -#I18n Property only works for the "forrest run" target. -#project.i18n=true -# The names of plugins that are required to build the project -# comma separated list (no spaces) -# project.required.plugins= -project.required.plugins=org.apache.forrest.plugin.input.projectInfo,org.apache.forrest.plugin.output.pdf diff --git a/forrest.properties.xml b/forrest.properties.xml deleted file mode 100644 index d0c01bf4a..000000000 --- a/forrest.properties.xml +++ /dev/null @@ -1,22 +0,0 @@ - - - - - - - diff --git a/publish.xml b/publish.xml deleted file mode 100644 index 32f2fda38..000000000 --- a/publish.xml +++ /dev/null @@ -1,58 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/src/documentation/classes/CatalogManager.properties b/src/documentation/classes/CatalogManager.properties deleted file mode 100644 index 66304d3f1..000000000 --- a/src/documentation/classes/CatalogManager.properties +++ /dev/null @@ -1,54 +0,0 @@ -# Licensed to the Apache Software Foundation (ASF) under one or more -# contributor license agreements. See the NOTICE file distributed with -# this work for additional information regarding copyright ownership. -# The ASF licenses this file to You under the Apache License, Version 2.0 -# (the "License"); you may not use this file except in compliance with -# the License. You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. - -#======================================================================= -# CatalogManager.properties for Catalog Entity Resolver. -# -# This is the default properties file for your project. -# This facilitates local configuration of application-specific catalogs. -# If you have defined any local catalogs, then they will be loaded -# before Forrest's core catalogs. -# -# See the Apache Forrest documentation: -# http://forrest.apache.org/docs/your-project.html -# http://forrest.apache.org/docs/validation.html - -# verbosity: -# The level of messages for status/debug (messages go to standard output). -# The setting here is for your own local catalogs. -# The verbosity of Forrest's core catalogs is controlled via -# forrestcore/src/core/context/WEB-INF/cocoon.xconf -# -# The following messages are provided ... -# 0 = none -# 1 = ? (... not sure yet) -# 2 = 1+, Loading catalog, Resolved public, Resolved system -# 3 = 2+, Catalog does not exist, resolvePublic, resolveSystem -# 10 = 3+, List all catalog entries when loading a catalog -# (Cocoon also logs the "Resolved public" messages.) -verbosity=0 - -# catalogs ... list of additional catalogs to load -# (Note that Apache Forrest will automatically load its own default catalog -# from src/core/context/resources/schema/catalog.xcat) -# use full pathnames -# pathname separator is always semi-colon (;) regardless of operating system -# directory separator is always slash (/) regardless of operating system -# -#catalogs=/home/me/forrest/my-site/src/documentation/resources/schema/catalog.xcat -#catalogs=/Users/Shared/_WebDLs/_repos/xml-fop/src/documentation/resources/schema/catalog.xcat -catalogs=../resources/schema/catalog.xcat -relative-catalogs=false - diff --git a/src/documentation/content/.htaccess b/src/documentation/content/.htaccess deleted file mode 100644 index 062708b4a..000000000 --- a/src/documentation/content/.htaccess +++ /dev/null @@ -1,39 +0,0 @@ -# redirect moved files -RedirectMatch Permanent ^/fop/anttask(.*) http://xmlgraphics.apache.org/fop/1.1/anttask$1 -RedirectMatch Permanent ^/fop/compiling(.*) http://xmlgraphics.apache.org/fop/1.1/compiling$1 -RedirectMatch Permanent ^/fop/configuration(.*) http://xmlgraphics.apache.org/fop/1.1/configuration$1 -RedirectMatch Permanent ^/fop/embedding(.*) http://xmlgraphics.apache.org/fop/1.1/embedding$1 -RedirectMatch Permanent ^/fop/extensions(.*) http://xmlgraphics.apache.org/fop/1.1/extensions$1 -RedirectMatch Permanent ^/fop/fonts(.*) http://xmlgraphics.apache.org/fop/1.1/fonts$1 -RedirectMatch Permanent ^/fop/graphics(.*) http://xmlgraphics.apache.org/fop/1.1/graphics$1 -RedirectMatch Permanent ^/fop/hyphenation(.*) http://xmlgraphics.apache.org/fop/1.1/hyphenation$1 -RedirectMatch Permanent ^/fop/intermediate(.*) http://xmlgraphics.apache.org/fop/1.1/intermediate$1 -RedirectMatch Permanent ^/fop/output(.*) http://xmlgraphics.apache.org/fop/1.1/output$1 -RedirectMatch Permanent ^/fop/pdfa(.*) http://xmlgraphics.apache.org/fop/1.1/pdfa$1 -RedirectMatch Permanent ^/fop/pdfencryption(.*) http://xmlgraphics.apache.org/fop/1.1/pdfencryption$1 -RedirectMatch Permanent ^/fop/pdfx(.*) http://xmlgraphics.apache.org/fop/1.1/pdfx$1 -RedirectMatch Permanent ^/fop/running(.*) http://xmlgraphics.apache.org/fop/1.1/running$1 -RedirectMatch Permanent ^/fop/servlets(.*) http://xmlgraphics.apache.org/fop/1.1/servlets$1 -RedirectMatch Permanent ^/fop/upgrading(.*) http://xmlgraphics.apache.org/fop/1.1/upgrading$1 - -# redirect to versioned documentation -# Current stable release -Redirect Temp /fop/stable http://xmlgraphics.apache.org/fop/1.1 - -# Current unstable release (or trunk if no beta is the latest release) -Redirect Temp /fop/unstable http://xmlgraphics.apache.org/fop/trunk - -# Latest release -Redirect Temp /fop/current http://xmlgraphics.apache.org/fop/1.1 -Redirect Temp /fop/latest http://xmlgraphics.apache.org/fop/1.1 - -# Previous stable release -Redirect Temp /fop/previous http://xmlgraphics.apache.org/fop/1.0 - -# Old releases -Redirect Temp /fop/maintenance http://xmlgraphics.apache.org/fop/0.95 -Redirect Temp /fop/0.90alpha1 http://xmlgraphics.apache.org/fop/0.95 -Redirect Temp /fop/0.91beta http://xmlgraphics.apache.org/fop/0.95 -Redirect Temp /fop/0.92beta http://xmlgraphics.apache.org/fop/0.95 -Redirect Temp /fop/0.93 http://xmlgraphics.apache.org/fop/0.95 -Redirect Temp /fop/0.94 http://xmlgraphics.apache.org/fop/0.95 diff --git a/src/documentation/content/calendar.rdf b/src/documentation/content/calendar.rdf deleted file mode 100644 index 254d07448..000000000 --- a/src/documentation/content/calendar.rdf +++ /dev/null @@ -1,41 +0,0 @@ - - - - - - 2.0 - - 2006-09-20 - 2006-09-21 - Apache FOP at the OpenExpo - Apache FOP is one of the open source projects presenting themselves at the OpenExpo which is some sort of successor to the lots.ch events. It is planned to provide FOP users the opportunity to ask questions and to have their problems looked at. - -The organizers are still looking for sponsors and open source projects which want to present themselves. The call for participation ends 2006-08-01. More info on their website. - Zürich, Switzerland - http://openexpo.org/index.php?id=19 - CONFIRMED - /ch/open - 0b5b6bf63fe835203494794f2b293d3ce3b0a12f43d6abe24f63a33445ade89f - PUBLIC - - diff --git a/src/documentation/content/doap.rdf b/src/documentation/content/doap.rdf deleted file mode 100644 index a55870a74..000000000 --- a/src/documentation/content/doap.rdf +++ /dev/null @@ -1,104 +0,0 @@ - - - - - 2006-03-25 - - Apache FOP - - - The Apache Foundation's XSL Formatting Objects (XSL-FO) implementation. - FOP (Formatting Objects Processor) is the world's first print formatter driven by XSL formatting objects (XSL-FO) and the world's first output independent formatter. It is a Java application that reads a formatting object (FO) tree and renders the resulting pages to a specified output. Output formats currently supported include PDF, PCL, PS, SVG, XML (area tree representation), Print, AWT, MIF and TXT. The primary output target is PDF. - - - - Java - - - - - Extensible Stylesheet Language - Formatting Objects (XSL-FO 1.0) - W3C - XSL 1.0 - - - - - - Extensible Stylesheet Language - Formatting Objects (XSL-FO 1.1) - W3C - XSL 1.1 - - - - - - Portable Document Format (PDF 1.4) - Adobe Systems Incorporated - PDF 1.4 - - - - - - PostScript - Adobe Systems Incorporated - PS - - - - - - Rich Text Format (RTF 1.6) - Microsoft - RTF 1.6 - - - - - - Current release (stable) - 2012-10-20 - 1.1 - - - - - Previous release (stable) - 2010-07-21 - 1.0 - - - - - Previous release (stable) - 2008-08-05 - 0.95 - - - - - - - - - - diff --git a/src/documentation/content/locationmap.xml b/src/documentation/content/locationmap.xml deleted file mode 100644 index 3a5ce410e..000000000 --- a/src/documentation/content/locationmap.xml +++ /dev/null @@ -1,34 +0,0 @@ - - - - - - - - - - - - diff --git a/src/documentation/content/xdocs/0.95/anttask.xml b/src/documentation/content/xdocs/0.95/anttask.xml deleted file mode 100644 index 9d01ed3ae..000000000 --- a/src/documentation/content/xdocs/0.95/anttask.xml +++ /dev/null @@ -1,200 +0,0 @@ - - - - - -
- Apache™ FOP: Ant task - $Revision$ -
- -

- Apache™ FOP provides an Ant task for automating the document build process. -

-
- Description -

- The FOP Ant task will convert XSL-FO documents to PDF, PS, PCL etc. output - (see Output formats for available formats). -

-

- To call FOP tasks within Ant, first add a FOP task definition to your Ant build file. - One method of defining the task is as follows: -

- - - - - - - - - - - - - - ]]> -

- Then create FOP tasks within your Ant build file, using the FOP task parameters listed below.

-
- -
Parameters for FOP Ant task - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Parameters specified as attributes
AttributeDescriptionRequired
fofileXSL-FO file to be renderedYes, if no fileset nested element is used
outfileOutput filenameYes, when fofile is used. (This attribute is not valid for filesets.)
formatPossible output formats:
- application/X-fop-awt-preview
- application/X-fop-print
- application/X-fop-areatree
- application/pdf
- application/postscript
- application/mif
- application/rtf, - text/richtext, - text/rtf
- application/x-pcl, - application/vnd.hp-PCL
- application/x-afp, - application/vnd.ibm.modcap
- text/plain
- image/svg+xml
- image/gif
- image/png
- image/tiff
- 		No, defaults to application/pdf
outdirOutput directoryRequired if a fileset is used to specify the files to render; optional for fofile. (Can alternatively specify the full path in the fofile value.)
forceRecreate target files, even if they are newer than their corresponding - source files. Note: This attribute is available in post-0.20.5 - versions (0.20.x nightly build and 1.0dev) only; target files are - always generated (i.e., force=true) in 0.20.5 release. - No, default is false
basedirBase directory to resolve relative references (e.g., graphics files) within the - FO document. - No, for single FO File entry, default is to use the location - of that FO file. -
relativebaseFor fileset usage only. A value of true specifies using the location - of each .fo file as the base directory for resolving relative file references located - within that .fo file. A value of false specifies using the value of - basedir for all files within the fileset, or just the current working directory - if basedir is not specified. - No, default is false. -
userconfigUser configuration file (same as the FOP "-c" command line option).No
messagelevelLogging level
- Possible values: error, warn, info, verbose, debug. Currently doesn't work in FOP Trunk!!!		No, defaults to verbose
logFilesControls whether the names of the files that are processed are logged - (true) or not (false). Currently doesn't work in FOP Trunk!!!No, default is true
-

- - - - - - - - - - - -
Parameters specified as nested elements
AttributeDescriptionRequired
filesetFileSets - are used to specify multiple XSL-FO files to be rendered.Yes, if no fofile attribute is supplied
-

-
- Examples -

- The following example converts a single XSL-FO file to a PDF document: -

- - - - - ]]> -

- This example converts all XSL-FO files within an entire directory to PostScript: -

- - - - - - - - ]]> -
- - - - - - diff --git a/src/documentation/content/xdocs/0.95/compiling.xml b/src/documentation/content/xdocs/0.95/compiling.xml deleted file mode 100644 index cf7b950ca..000000000 --- a/src/documentation/content/xdocs/0.95/compiling.xml +++ /dev/null @@ -1,140 +0,0 @@ - - - - - -
- Apache™ FOP: Building from Source Code - $Revision$ -
- -
- Do You Need To Build? -

- Apache™ FOP distributions are either pre-compiled binary or source. - If you are using a binary distribution, it is already built and there is no need to build it again. - See the Download Instructions for information about whether a - binary or source distribution is best for your needs. -

-

- If you got the source code from a repository snapshot or via Subversion you will need to build FOP - in any case. -

-
-
- Set Up Your Environment -
- JDK -

- Building FOP requires a minimum Java Development Kit (JDK/SDK) of 1.4 - (A Java Runtime Environment is not sufficient). -

-
-
- CLASSPATH -

- There is generally no need to setup a classpath. All libraries needed to compile FOP are included - in the source distribution and are referenced by the build script. - You will only need to adjust the classpath if you build FOP in some other way. See the build - script build.xml for details. -

-
-
- JAVA_HOME -

- The build script uses Apache Ant, a popular - Java-based build tool, which usually requires that the environment variable JAVA_HOME point to - your local JDK root directory. This is true even if you use JDK 1.4 or above, which normally - does not need this setting. -

-
-
- Apache Ant -

- Apache Ant (Version 1.7 or later) must be installed in order to - build FOP. Following best practices we don't include Ant with FOP anymore. You can find the - instructions to install Ant in the Ant manual on the web. -

-
-
-
- Run the Build Script -

- Change to the FOP root directory and build FOP by executing the build script (build.xml) - using the "ant" command. -

- - The "ant" command is only available on your system if you've properly - installed Apache Ant and added Ant's location to the PATH - environment variable. - -

- The file build.xml in the FOP root directory is the blueprint that Ant uses for the build. It - contains information for numerous build targets, many of which are building blocks to more - useful target, and others which are primarily used by the FOP developers. - You may benefit from looking through this file to learn more about the various build targets. - To obtain a complete list of useful build targets: -

- ant -projecthelp -

The most useful targets are:

-
    -
  • - package: Generates the JAR files (default). This is the normal build that - produces a jar file usable for running FOP. -
    • -
  • - clean : Cleans the build directory. This is useful for making sure that - any build errors are cleaned up before starting a new build. It should not ordinarily be - needed, but may be helpful if you are having problems with the build process itself. -
    • -
  • - javadocs: Creates the FOP API documentation. - A minimum JDK version of 1.4.2 is required for generating the javadocs. -
    • -
-

To run the build:

- ant [target ...] -

For example to do a normal build for the "all" target (which is the default):

- ant -

OR

- ant all -

To clean the build directory first:

- ant clean all - - If you want to shorten the build time you can just call the "package" target which - doesn't perform any automated tests during the build. - -
-
- Troubleshooting -

If you have problems building FOP, please try the following:

-
    -
  • Run the build with the target of "clean", then rerun the build.
    • -
  • Delete the build directory completely, then rerun the build.
    • -
  • - Make sure you do not have a non-FOP version of xerces.jar, xalan.jar, batik.jar, - or another dependency product somewhere in your CLASSPATH. -
    • -
  • - If the build still fails, see the Getting Help - page for further help. -
    • -
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/configuration.xml b/src/documentation/content/xdocs/0.95/configuration.xml deleted file mode 100644 index 981f079eb..000000000 --- a/src/documentation/content/xdocs/0.95/configuration.xml +++ /dev/null @@ -1,393 +0,0 @@ - - - - - -
- Apache™ FOP: Configuration - $Revision$ -
- - -
- Configuration File Basics -

- The FOP configuration file is an XML file containing a variety of settings that are useful - for controlling FOP's behavior, and for helping it find resources that you wish it to use. -

-

- The easiest way to get started using a FOP configuration file is to copy the sample found - at {fop-dir}/conf/fop.xconf to a location of your choice, and then to - edit it according to your needs. - It contains templates for the various configuration options, most of which are commented - out. Remove the comments and change the settings for entries that you wish to use. - Be sure to follow any instructions, including comments which specify the value range. - Also, since the configuration file is XML, be sure to keep it well-formed. -

-
- Making Configuration Available to FOP -

After creating your configuration file, you must tell FOP how to find it:

- -

- See Setting the Configuration Programmatically - for instructions on how to do so in an embedded environment. -

-
-
-
- Summary of the General Configuration Options - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ElementData Type (for the value)DescriptionDefault Value
baseURL or directorySpecifies the base URL based on which relative URL will be resolved.current directory
font-baseURL or directorySpecifies the base URL based on which relative font URLs will be resolved. - base URL/directory (above)
hyphenation-baseURL or directorySpecifies the base URL based on which relative URLs to hyphenation pattern - files will be resolved. If not specified, support for user-supplied hyphenation - patterns remains disabled. - disabled
source-resolutionInteger, dpi - Resolution in dpi (dots per inch) which is used internally to determine the pixel - size for SVG images and bitmap images without resolution information. - 72 dpi
target-resolutionInteger, dpi - Resolution in dpi (dots per inch) used to specify the output resolution for bitmap - images generated by bitmap renderers (such as the TIFF renderer) and by bitmaps - generated by Apache Batik for filter effects and such. - 72 dpi
strict-configurationBoolean (true, false) - Setting this option to 'true' will cause FOP to strictly verify the contents of the - FOP configuration file to ensure that defined resources (such as fonts and base - URLs/directories) are valid and available to FOP. Any errors found will cause FOP to - immediately raise an exception.false
strict-validationBoolean (true, false) - Setting this option to 'false' causes FOP to be more forgiving about XSL-FO validity, - for example, you're allowed to specify a border on a region-body which is supported - by some FO implementations but is non-standard. Note that such a border would - currently have no effect in Apache FOP.true
break-indent-inheritanceBoolean (true, false) - Setting this option to 'true' causes FOP to use an alternative rule set to determine - text indents specified through margins, start-indent and end-indent. Many commercial - FO implementations have chosen to break the XSL specification in this aspect. This - option tries to mimic their behaviour. Please note that Apache FOP may still not - behave exactly like those implementations either because FOP has not fully matched - the desired behaviour and because the behaviour among the commercial implementations - varies. The default for this option (i.e. false) is to behave exactly like the - specification describes.false
default-page-settingsn/a - Specifies the default width and height of a page if "auto" is specified - for either or both values. Use "height" and "width" attributes on the - default-page-settings element to specify the two values."height" 11 inches, "width" 8.26 inches
use-cacheboolean (true, false)All fonts information that has been gathered as a result of "directory" - or "auto-detect" font configurations will be cached for future rendering runs. - This setting should improve performance on systems where - fonts have been configured using the "directory" or "auto-detect" tag mechanisms. - By default this option is switched on.true
cache-fileStringThis options specifies the file/directory path of the fop cache file. - This option can also be specified on the command-line using the -cache option. - This file is currently only used to cache font triplet information for future reference.${base}/conf/fop.cache
renderers(see text below)Contains the configuration for each renderer. See below.N/A
-

- This is an excerpt from the example configuration file coming with FOP: -

- - - - true - - - true - - - ./ - - - ./ - - - 72 - - 72 - - - - - -]]> -
-
- Renderer configuration -

- Each Renderer has its own configuration section which is identified by the - MIME type the Renderer is written for, ex. "application/pdf" for the PDF Renderer. -

-

- The configuration for the PDF Renderer could look like this: -

- - - - - flate - - - - - - - - - - - - - - - ]]> -

- The details on the font configuration can be found on the separate Fonts page. - Note especially the section entitled Register Fonts with FOP. -

-
- Special Settings for the PDF Renderer -

- The configuration element for the PDF renderer contains two elements. One is for the font configuration - (please follow the link above) and one is for the "filter list". The filter list controls how the - individual objects in a PDF file are encoded. By default, all objects get "flate" encoded (i.e. simply - compressed with the same algorithm that is also used in ZIP files). Most users don't need to change that - setting. For debugging purposes, it may be desired not to compress the internal objects at all so the - generated PDF commands can be read. In that case, you can simply use the following filter list. The - second filter list (type="image") ensures that all images still get compressed but also ASCII-85 encoded - so the produced PDF file is still easily readable in a text editor. -

- - - null - - - flate - ascii-85 - - - ]]> -

- Another (optional) setting specific to the PDF Renderer is an output color profile, an ICC - color profile which indicates the target color space the PDF file is generated for. This - setting is mainly used in conjunction with the PDF/X feature. - An example: -

- - C:\FOP\Color\EuropeISOCoatedFOGRA27.icc - - ]]> -

- Some people don't have high requirements on color fidelity but instead want the smallest - PDF file sizes possible. In this case it's possible to disable the default sRGB color space - which XSL-FO requires. This will cause RGB colors to be generated as device-specific RGB. - Please note that this option is unavailable (and will cause an error) if you enable - PDF/A or PDF/X functionality or if you specify an output profile. This setting will make the - PDF about 4KB smaller. To disable the sRGB color space add the following setting: -

- - true - - ]]> -
-
- Special Settings for the PostScript Renderer -

- Besides the normal font configuration (the same "fonts" element as for the PDF renderer) the PostScript - renderer has an additional setting to force landscape pages to be rotated to fit on a page inserted into - the printer in portrait mode. Set the value to "true" to activate this feature. The default is "false". - Example: -

- - true - - - - - - - - - - - - ]]> -
-
- Special Settings for the PCL Renderer -

- Non-standard fonts for the PCL renderer are made available through the Java2D subsystem which means that - you don't have to do any custom font configuration in this case but you have to use the font names - offered by Java. -

-

- Additionally, there are certain settings that control how the renderer handles various elements. -

- - quality - bitmap -]]> -

- The default value for the "rendering" setting is "speed" which causes borders - to be painted as plain rectangles. In this mode, no special borders (dotted, - dashed etc.) are available. If you want support for all border modes, set the - value to "quality" as indicated above. This will cause the borders to be painted - as bitmaps. -

-

- The default value for the "text-rendering" setting is "auto" which paints the - base fonts using PCL fonts. Non-base fonts are painted as bitmaps through Java2D. - If the mix of painting methods results in unwelcome output, you can set this - to "bitmap" which causes all text to be rendered as bitmaps. -

-
-
- -
- When it does not work - -

FOP searches the configuration file for the information it -expects, at the position it expects. When that information is not -present, FOP will not complain, it will just continue. When there is -other information in the file, FOP will not complain, it will just -ignore it. That means that when your configuration information is in -the file but in a different XML element, or in a different XML path, -than FOP expects, it will be silently ignored.

- -

Check the following possibilities:

- -
    -
  • The format of the configuration file has changed -considerably between FOP 0.20.5 and FOP 1.0 and its beta versions. Did -you convert your file to the new format?
    • - -
  • The FOP distribution contains a schema for configuration -files, at src/foschema/fop-configuration.xsd. Did you validate your -configuration file against it? Add the following schema location to -the schema element: - -]]> - - -and run the configuration file through a validating schema -parser. Note that the schema cannot detect all errors, and that it is -stricter about the order of some elements than FOP itself is.
    • - -
  • Run FOP in debug mode (command line option --d). This makes FOP report which configuration -information it finds. Check if FOP finds what you expect.
    • - -
- -
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/embedding.xml b/src/documentation/content/xdocs/0.95/embedding.xml deleted file mode 100644 index a7c7ccaf8..000000000 --- a/src/documentation/content/xdocs/0.95/embedding.xml +++ /dev/null @@ -1,688 +0,0 @@ - - - - - - -
- Apache™ FOP: Embedding - How to Embed Apache™ FOP in a Java application - $Revision$ -
- - -
- Overview -

- Review Running Apache™ FOP for important information that applies - to embedded applications as well as command-line use, such as options and performance. -

-

- To embed Apache™ FOP in your application, first create a new - org.apache.fop.apps.FopFactory instance. This object can be used to launch multiple - rendering runs. For each run, create a new org.apache.fop.apps.Fop instance through - one of the factory methods of FopFactory. In the method call you specify which output - format (i.e. Renderer) to use and, if the selected renderer requires an OutputStream, - which OutputStream to use for the results of the rendering. You can customize FOP's - behaviour in a rendering run by supplying your own FOUserAgent instance. The - FOUserAgent can, for example, be used to set your own Renderer instance (details - below). Finally, you retrieve a SAX DefaultHandler instance from the Fop object and - use that as the SAXResult of your transformation. -

- - We recently changed FOP's outer API to what we consider the final API. This might require - some changes in your application. The main reasons for these changes were performance - improvements due to better reuse of reusable objects and reduced use of static variables - for added flexibility in complex environments. - -
-
- Basic Usage Pattern -

- Apache FOP relies heavily on JAXP. It uses SAX events exclusively to receive the XSL-FO - input document. It is therefore a good idea that you know a few things about JAXP (which - is a good skill anyway). Let's look at the basic usage pattern for FOP... -

-

Here is the basic pattern to render an XSL-FO file to PDF: -

- -

- Let's discuss these 5 steps in detail: -

-
    -
  • - Step 1: You create a new FopFactory instance. The FopFactory instance holds - references to configuration information and cached data. It's important to reuse this - instance if you plan to render multiple documents during a JVM's lifetime. -
    • -
  • - Step 2: You set up an OutputStream that the generated document - will be written to. It's a good idea to buffer the OutputStream as demonstrated - to improve performance. -
    • -
  • - Step 3: You create a new Fop instance through one of the factory - methods on the FopFactory. You tell the FopFactory what your desired output format - is. This is done by using the MIME type of the desired output format (ex. "application/pdf"). - You can use one of the MimeConstants.* constants. The second parameter is the - OutputStream you've setup up in step 2. -
    • -
  • - Step 4 We recommend that you use JAXP Transformers even - if you don't do XSLT transformations to generate the XSL-FO file. This way - you can always use the same basic pattern. The example here sets up an - "identity transformer" which just passes the input (Source) unchanged to the - output (Result). You don't have to work with a SAXParser if you don't do any - XSLT transformations. -
    • -
  • - Step 5: Here you set up the input and output for the XSLT - transformation. The Source object is set up to load the "myfile.fo" file. - The Result is set up so the output of the XSLT transformation is sent to FOP. - The FO file is sent to FOP in the form of SAX events which is the most efficient - way. Please always avoid saving intermediate results to a file or a memory buffer - because that affects performance negatively. -
    • -
  • - Step 6: Finally, we start the XSLT transformation by starting - the JAXP Transformer. As soon as the JAXP Transformer starts to send its output - to FOP, FOP itself starts its processing in the background. When the - transform() method returns FOP will also have finished converting - the FO file to a PDF file and you can close the OutputStream. - - It's a good idea to enclose the whole conversion in a try..finally statement. If - you close the OutputStream in the finally section, this will make sure that the - OutputStream is properly closed even if an exception occurs during the conversion. - -
    • -
-

- If you're not totally familiar with JAXP Transformers, please have a look at the - Embedding examples below. The section contains examples - for all sorts of use cases. If you look at all of them in turn you should be able - to see the patterns in use and the flexibility this approach offers without adding - too much complexity. -

-

- This may look complicated at first, but it's really just the combination of an - XSL transformation and a FOP run. It's also easy to comment out the FOP part - for debugging purposes, for example when you're tracking down a bug in your - stylesheet. You can easily write the XSL-FO output from the XSL transformation - to a file to check if that part generates the expected output. An example for that - can be found in the Embedding examples (See "ExampleXML2FO"). -

-
- Logging -

- Logging is now a little different than it was in FOP 0.20.5. We've switched from - Avalon Logging to Jakarta Commons Logging. - While with Avalon Logging the loggers were directly given to FOP, FOP now retrieves - its logger(s) through a statically available LogFactory. This is similar to the - general pattern that you use when you work with Apache Log4J directly, for example. - We call this "static logging" (Commons Logging, Log4J) as opposed to "instance logging" - (Avalon Logging). This has a consequence: You can't give FOP a logger for each - processing run anymore. The log output of multiple, simultaneously running FOP instances - is sent to the same logger. -

- - We know this may be an issue in multi-threaded server environments if you'd like to - know what's going on in every single FOP processing run. We're planning to add an - additional feedback facility to FOP which can be used to obtain all sorts of specific - feedback (validation messages, layout problems etc.). "Static logging" is mainly - interesting for a developer working on FOP and for advanced users who are debugging - FOP. We don't consider the logging output to be useful to normal FOP users. Please - have some patience until we can add this feature or jump in and help us build it. We've - set up a Wiki page - which documents what we're going to build. - -

- By default, Jakarta Commons Logging uses - JDK logging (available in JDKs 1.4 or higher) as its backend. You can configure Commons - Logging to use an alternative backend, for example Log4J. Please consult the - documentation for Jakarta Commons Logging on - how to configure alternative backends. -

-
- -
- Processing XSL-FO -

- Once the Fop instance is set up, call getDefaultHandler() to obtain a SAX - DefaultHandler instance to which you can send the SAX events making up the XSL-FO - document you'd like to render. FOP processing starts as soon as the DefaultHandler's - startDocument() method is called. Processing stops again when the - DefaultHandler's endDocument() method is called. Please refer to the basic - usage pattern shown above to render a simple XSL-FO document. -

-
- -
- Processing XSL-FO generated from XML+XSLT -

- If you want to process XSL-FO generated from XML using XSLT we recommend - again using standard JAXP to do the XSLT part and piping the generated SAX - events directly through to FOP. The only thing you'd change to do that - on the basic usage pattern above is to set up the Transformer differently: -

- -
-
-
- Input Sources -

- The input XSL-FO document is always received by FOP as a SAX stream (see the - Parsing Design Document for the rationale). -

-

- However, you may not always have your input document available as a SAX stream. - But with JAXP it's easy to convert different input sources to a SAX stream so you - can pipe it into FOP. That sounds more difficult than it is. You simply have - to set up the right Source instance as input for the JAXP transformation. - A few examples: -

-
    -
  • - URL: Source src = new StreamSource("http://localhost:8080/testfile.xml"); -
    • -
  • - File: Source src = new StreamSource(new File("C:/Temp/myinputfile.xml")); -
    • -
  • - String: Source src = new StreamSource(new StringReader(myString)); // myString is a String -
    • -
  • - InputStream: Source src = new StreamSource(new MyInputStream(something)); -
    • -
  • - Byte Array: Source src = new StreamSource(new ByteArrayInputStream(myBuffer)); // myBuffer is a byte[] here -
    • -
  • - DOM: Source src = new DOMSource(myDocument); // myDocument is a Document or a Node -
    • -
  • - Java Objects: Please have a look at the Embedding examples which contain an example for this. -
    • -
-

- There are a variety of upstream data manipulations possible. - For example, you may have a DOM and an XSL stylesheet; or you may want to - set variables in the stylesheet. Interface documentation and some cookbook - solutions to these situations are provided in - Xalan Basic Usage Patterns. -

-
-
- Configuring Apache FOP Programmatically -

- Apache FOP provides two levels on which you can customize FOP's - behaviour: the FopFactory and the user agent. -

-
- Customizing the FopFactory -

- The FopFactory holds configuration data and references to objects which are reusable over - multiple rendering runs. It's important to instantiate it only once (except in special - environments) and reuse it every time to create new FOUserAgent and Fop instances. -

-

- You can set all sorts of things on the FopFactory: -

-
    -
  • -

    - The font base URL to use when resolving relative URLs for fonts. Example: -

    - fopFactory.setFontBaseURL("file:///C:/Temp/fonts"); -
    • -
  • -

    - The hyphenation base URL to use when resolving relative URLs for - hyphenation patterns. Example: -

    - fopFactory.setHyphenBaseURL("file:///C:/Temp/hyph"); -
    • -
  • -

    - Disable strict validation. When disabled FOP is less strict about the rules - established by the XSL-FO specification. Example: -

    - fopFactory.setStrictValidation(false); -
    • -
  • -

    - Enable an alternative set of rules for text indents that tries to mimic the behaviour of many commercial - FO implementations, that chose to break the specification in this respect. The default of this option is - 'false', which causes Apache FOP to behave exactly as described in the specification. To enable the - alternative behaviour, call: -

    - fopFactory.setBreakIndentInheritanceOnReferenceAreaBoundary(true); -
    • -
  • -

    - Set the source resolution for the document. This is used internally to determine the pixel - size for SVG images and bitmap images without resolution information. Default: 72 dpi. Example: -

    - fopFactory.setSourceResolution(96); // =96dpi (dots/pixels per Inch) -
    • -
  • -

    - Manually add an ElementMapping instance. If you want to supply a special FOP extension - you can give the instance to the FOUserAgent. Normally, the FOP extensions can be automatically detected - (see the documentation on extension for more info). Example: -

    - fopFactory.addElementMapping(myElementMapping); // myElementMapping is a org.apache.fop.fo.ElementMapping -
    • -
  • -

    - Set a URIResolver for custom URI resolution. By supplying a JAXP URIResolver you can add - custom URI resolution functionality to FOP. For example, you can use - Apache XML Commons Resolver to make use of XCatalogs. Example: -

    - fopFactory.setURIResolver(myResolver); // myResolver is a javax.xml.transform.URIResolver - - Both the FopFactory and the FOUserAgent have a method to set a URIResolver. The URIResolver on the FopFactory - is primarily used to resolve URIs on factory-level (hyphenation patterns, for example) and it is always used - if no other URIResolver (for example on the FOUserAgent) resolved the URI first. - -
    • -
-
-
- Customizing the User Agent -

- The user agent is the entity that allows you to interact with a single rendering run, i.e. the processing of a single - document. If you wish to customize the user agent's behaviour, the first step is to create your own instance - of FOUserAgent using the appropriate factory method on FopFactory and pass that - to the factory method that will create a new Fop instance: -

- -

- You can do all sorts of things on the user agent: -

-
    -
  • -

    - The base URL to use when resolving relative URLs. Example: -

    - userAgent.setBaseURL("file:///C:/Temp/"); -
    • -
  • -

    - Set the producer of the document. This is metadata information that can be used for certain output formats such as PDF. The default producer is "Apache FOP". Example: -

    - userAgent.setProducer("MyKillerApplication"); -
    • -
  • -

    - Set the creating user of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setCreator("John Doe"); -
    • -
  • -

    - Set the author of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setAuthor("John Doe"); -
    • -
  • -

    - Override the creation date and time of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setCreationDate(new Date()); -
    • -
  • -

    - Set the title of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setTitle("Invoice No 138716847"); -
    • -
  • -

    - Set the keywords of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setKeywords("XML XSL-FO"); -
    • -
  • -

    - Set the target resolution for the document. This is used to - specify the output resolution for bitmap images generated by bitmap renderers - (such as the TIFF renderer) and by bitmaps generated by Apache Batik for filter - effects and such. Default: 72 dpi. Example: -

    - userAgent.setTargetResolution(300); // =300dpi (dots/pixels per Inch) -
    • -
  • -

    - Set your own Renderer instance. If you want to supply your own renderer or - configure a Renderer in a special way you can give the instance to the FOUserAgent. Normally, - the Renderer instance is created by FOP. Example: -

    - userAgent.setRendererOverride(myRenderer); // myRenderer is an org.apache.fop.render.Renderer -
    • -
  • -

    - Set your own FOEventHandler instance. If you want to supply your own FOEventHandler or - configure an FOEventHandler subclass in a special way you can give the instance to the FOUserAgent. Normally, - the FOEventHandler instance is created by FOP. Example: -

    - userAgent.setFOEventHandlerOverride(myFOEventHandler); // myFOEventHandler is an org.apache.fop.fo.FOEventHandler -
    • -
  • -

    - Set a URIResolver for custom URI resolution. By supplying a JAXP URIResolver you can add - custom URI resolution functionality to FOP. For example, you can use - Apache XML Commons Resolver to make use of XCatalogs. Example: -

    - userAgent.setURIResolver(myResolver); // myResolver is a javax.xml.transform.URIResolver - - Both the FopFactory and the FOUserAgent have a method to set a URIResolver. The URIResolver on the FOUserAgent is - used for resolving URIs which are document-related. If it's not set or cannot resolve a URI, the URIResolver - from the FopFactory is used. - -
    • -
- - You should not reuse an FOUserAgent instance between FOP rendering runs although you can. Especially - in multi-threaded environment, this is a bad idea. - -
-
-
- Using a Configuration File -

- Instead of setting the parameters manually in code as shown above you can also set - many values from an XML configuration file: -

- -

- The layout of the configuration file is described on the Configuration page. -

-
-
- Hints -
- Object reuse -

- Fop instances shouldn't (and can't) be reused. Please recreate - Fop and FOUserAgent instances for each rendering run using the FopFactory. - This is a cheap operation as all reusable information is held in the - FopFactory. That's why it's so important to reuse the FopFactory instance. -

-
-
- AWT issues -

- If your XSL-FO files contain SVG then Apache Batik will be used. When Batik is - initialised it uses certain classes in java.awt that - intialise the Java AWT classes. This means that a daemon thread - is created by the JVM and on Unix it will need to connect to a - DISPLAY. -

-

- The thread means that the Java application may not automatically quit - when finished, you will need to call System.exit(). These - issues should be fixed in the JDK 1.4. -

-

- If you run into trouble running FOP on a head-less server, please see the - notes on Batik. -

-
-
- Getting information on the rendering process -

- To get the number of pages that were rendered by FOP you can call - Fop.getResults(). This returns a FormattingResults object - where you can look up the number of pages produced. It also gives you the - page-sequences that were produced along with their id attribute and their - numbers of pages. This is particularly useful if you render multiple - documents (each enclosed by a page-sequence) and have to know the number of - pages of each document. -

-
-
-
- Improving performance -

- There are several options to consider: -

-
    -
  • - Whenever possible, try to use SAX to couple the individual components involved - (parser, XSL transformer, SQL datasource etc.). -
    • -
  • - Depending on the target OutputStream (in case of a FileOutputStream, but not - for a ByteArrayOutputStream, for example) it may improve performance considerably - if you buffer the OutputStream using a BufferedOutputStream: - out = new java.io.BufferedOutputStream(out); -
    - Make sure you properly close the OutputStream when FOP is finished. -
    • -
  • - Cache the stylesheet. If you use the same stylesheet multiple times - you can set up a JAXP Templates object and reuse it each time you do - the XSL transformation. (More information can be found - here.) -
    • -
  • - Use an XSLT compiler like XSLTC - that comes with Xalan-J. -
    • -
  • - Fine-tune your stylesheet to make the XSLT process more efficient and to create XSL-FO that can - be processed by FOP more efficiently. Less is more: Try to make use of property inheritance where possible. -
    • -
-
-
- Multithreading FOP -

- Apache FOP may currently not be completely thread safe. - The code has not been fully tested for multi-threading issues, yet. - If you encounter any suspicious behaviour, please notify us. -

-

- There is also a known issue with fonts being jumbled between threads when using - the Java2D/AWT renderer (which is used by the -awt and -print output options). - In general, you cannot safely run multiple threads through the AWT renderer. -

-
-
- Examples -

- The directory "{fop-dir}/examples/embedding" contains several working examples. -

-
- ExampleFO2PDF.java -

This - - example -demonstrates the basic usage pattern to transform an XSL-FO -file to PDF using FOP. -

-
-
-
- ExampleXML2FO.java -

This - - example -has nothing to do with FOP. It is there to show you how an XML -file can be converted to XSL-FO using XSLT. The JAXP API is used to do the -transformation. Make sure you've got a JAXP-compliant XSLT processor in your -classpath (ex. Xalan). -

-
-
-
- ExampleXML2PDF.java -

This - - example -demonstrates how you can convert an arbitrary XML file to PDF -using XSLT and XSL-FO/FOP. It is a combination of the first two examples -above. The example uses JAXP to transform the XML file to XSL-FO and FOP to -transform the XSL-FO to PDF. -

-
-

-The output (XSL-FO) from the XSL transformation is piped through to FOP using -SAX events. This is the most efficient way to do this because the -intermediate result doesn't have to be saved somewhere. Often, novice users -save the intermediate result in a file, a byte array or a DOM tree. We -strongly discourage you to do this if it isn't absolutely necessary. The -performance is significantly higher with SAX. -

-
-
- ExampleObj2XML.java -

This - - example -is a preparatory example for the next one. It's an example that -shows how an arbitrary Java object can be converted to XML. It's an often -needed task to do this. Often people create a DOM tree from a Java object and -use that. This is pretty straightforward. The example here, however, shows how -to do this using SAX, which will probably be faster and not even more -complicated once you know how this works. -

-
-

-For this example we've created two classes: ProjectTeam and ProjectMember -(found in xml-fop/examples/embedding/java/embedding/model). They represent -the same data structure found in -xml-fop/examples/embedding/xml/xml/projectteam.xml. We want to serialize to XML a -project team with several members which exist as Java objects. -Therefore we created the two classes: ProjectTeamInputSource and -ProjectTeamXMLReader (in the same place as ProjectTeam above). -

-

-The XMLReader implementation (regard it as a special kind of XML parser) is -responsible for creating SAX events from the Java object. The InputSource -class is only used to hold the ProjectTeam object to be used. -

-

-Have a look at the source of ExampleObj2XML.java to find out how this is -used. For more detailed information see other resources on JAXP (ex. -An older JAXP tutorial). -

-
-
- ExampleObj2PDF.java -

This - - example -combines the previous and the third to demonstrate -how you can transform a Java object to a PDF directly in one smooth run -by generating SAX events from the Java object that get fed to an XSL -transformation. The result of the transformation is then converted to PDF -using FOP as before. -

-
-
-
- ExampleDOM2PDF.java -

This - - example -has FOP use a DOMSource instead of a StreamSource in order to -use a DOM tree as input for an XSL transformation. -

-
-
- ExampleSVG2PDF.java (PDF Transcoder example) -

This - - example -shows the usage of the PDF Transcoder, a sub-application within FOP. -It is used to generate a PDF document from an SVG file. -

-
-
- Final notes -

-These examples should give you an idea of what's possible. It should be easy -to adjust these examples to your needs. Also, if you have other examples that you -think should be added here, please let us know via either the fop-users or fop-dev -mailing lists. Finally, for more help please send your questions to the fop-users -mailing list. -

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/extensions.xml b/src/documentation/content/xdocs/0.95/extensions.xml deleted file mode 100644 index e477ecc61..000000000 --- a/src/documentation/content/xdocs/0.95/extensions.xml +++ /dev/null @@ -1,233 +0,0 @@ - - - - - -
- Standard Apache™ FOP Extensions - $Revision$ -
- -

- By "extension", we mean any data that can be placed in the input XML document that - is not addressed by the XSL-FO standard. - By having a mechanism for supporting extensions, FOP is able to add features that - are not covered in the specification. -

-

- The extensions documented here are included with FOP, and are automatically available - to you. If you wish to add an extension of your own to FOP, please see the - Developers' Extension Page. -

- All extensions require the correct use of an appropriate namespace in your input document. -
- SVG -

- Please see the SVG documentation for more details. -

-
-
- FO Extensions -
- Namespace -

- By convention, FO extensions in FOP use the "fox" namespace prefix. - To use any of the FO extensions, add a namespace entry for - http://xmlgraphics.apache.org/fop/extensions to the root element: -

- ]]> -
-
- PDF Bookmarks -

- In previous versions of Apache FOP there was a fox:outline element - which was used to create outlines in PDF files. The redesigned code makes use - of the new bookmark feature defined in the latest XSL 1.1 working draft. -

-
-
- Anchors or Named Destinations -

Use the fox:destination element to define "named destinations" inside a PDF document. -These are useful as fragment identifiers, e.g. "http://server/document.pdf#anchor-name". -fox:destination elements can be placed almost anywhere in the fo document, including a child of -root, a block-level element, or an inline-level element. -For the destination to actually work, it must correspond to an "id" attribute on some fo element -within the document. In other words, the "id" attribute actually creates the "view" within the -PDF document. The fox:destination simply gives that view an independent name. -

- -... -Table of Contents]]> - It is possible that in some future release of FOP, all elements with -"id" attributes will generate named-destinations, which will eliminate the need for -fox:destination. -
-
- Table Continuation Label -

This extension element hasn't been reimplemented for the redesigned code, yet.

- -
-
- fox:orphan-content-limit and fox:widow-content-limit -

- The two proprietary extension properties, fox:orphan-content-limit and - fox:widow-content-limit, are used to improve the layout of list-blocks and tables. - If you have a table with many entries, you don't want a single row to be left over - on a page. You will want to make sure that at least two or three lines are kept - together. The properties take an absolute length which specifies the area at the - beginning (fox:widow-content-limit) or at the end (fox:orphan-content-limit) of a - table or list-block. The properties are inherited and only have an effect on fo:table - and fo:list-block. An example: fox:widow-content-limit="3 * 1.2em" would make sure - the you'll have at least three lines (assuming line-height="1.2") together on a table - or list-block. -

-
-
- fox:external-document - - This feature is incomplete. Support for multi-page documents will be added shortly. - At the moment, only single-page images will work. And this will not work with RTF output. - -

- This is a proprietary extension element which allows to add whole images as pages to - an FO document. For example, if you have a scanned document or a fax as multi-page TIFF - file, you can append or insert this document using the fox:external-document - element. Each page of the external document will create one full page in the target - format. -

-

- The fox:external-document element is structurally a peer to - fo:page-sequence, so wherever you can put an fo:page-sequence - you could also place a fox:external-document. - Therefore, the specified contents for fo:root change to: -

-

- - (layout-master-set, declarations?, bookmark-tree?, (page-sequence|page-sequence-wrapper|fox:external-document|fox:destination)+) - -

-
- Specification -

- The fox:external-document extension formatting object is used to specify - how to create a (sub-)sequence of pages within a document. The content of these pages - comes from the individual subimages/pages of an image or paged document (for example: - multi-page TIFF in the form of faxes or scanned documents, or PDF files). The - formatting object creates the necessary areas to display one image per page. -

-

- In terms of page numbers, the behaviour is the same as for - fo:page-sequence. The placement of the image inside the page is similar - to that of fo:external-graphic or fo:instream-foreign-object, - i.e. the viewport (and therefore the page size) is defined by either the intrinsic - size of the image or by the size properties that apply to this formatting object. -

-

Content: EMPTY

-

The following properties apply to this formatting object:

-
    -
  • (Common Accessibility Properties) (not implemented, yet)
    • -
  • (Common Aural Properties) (not implemented, yet)
    • -
  • block-progression-dimension
    • -
  • content-height
    • -
  • content-type
    • -
  • content-width
    • -
  • display-align
    • -
  • height
    • -
  • id
    • -
  • inline-progression-dimension
    • -
  • overflow
    • -
  • pages: <page-set> (see below) (not implemented, yet)
    • -
  • reference-orientation
    • -
  • scaling
    • -
  • scaling-method
    • -
  • src
    • -
  • text-align
    • -
  • width
    • -
-

- Datatype "page-set": Value: auto | <integer-range>, - Default: "auto" which means all pages/subimages of the document. - <integer-range> allows values such as "7" or "1-3" -

- - fox:external-document is not suitable for concatenating FO documents. - For this, XInclude is recommended. - -
-
-
- Free-form Transformation for fo:block-container -

- For fo:block-container elements whose absolute-position set to - "absolute" or "fixed" you can use the extension attribute fox:transform - to apply a free-form transformation to the whole block-container. The content of the - fox:transform attribute is the same as for - SVG's transform attribute. - The transformation specified here is performed in addition to other implicit - transformations of the block-container (resulting from top, left and other properties) - and after them. -

-

- Examples: fox:transform="rotate(45)" would rotate the block-container - by 45 degrees clock-wise around its upper-left corner. - fox:transform="translate(10000,0)" would move the block-container to the - right by 10 points (=10000 millipoints, FOP uses millipoints internally!). -

- - This extension attribute doesn't work for all output formats! It's currently only - supported for PDF, PS and Java2D-based renderers. - -
-
- Color functions -

- XSL-FO supports specifying color using the rgb(), rgb-icc() and system-color() functions. - Apache FOP provides additional color functions for special use cases. Please note that - using these functions compromises the interoperability of an FO document. -

-
- cmyk() -

color cmyk(numeric, numeric, numeric, numeric)

-

- This function will construct a color in device-specific CMYK color space. The numbers - must be between 0.0 and 1.0. For output formats that don't support device-specific - color space the CMYK value is converted to an sRGB value. -

-
-
- -
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/fonts.xml b/src/documentation/content/xdocs/0.95/fonts.xml deleted file mode 100644 index 976545c36..000000000 --- a/src/documentation/content/xdocs/0.95/fonts.xml +++ /dev/null @@ -1,410 +0,0 @@ - - - - - -
- Apache™ FOP: Fonts - $Revision$ - - - - - - -
- -
- Summary -

The following table summarizes the font capabilities of the various FOP renderers:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
RendererBase-14AWT/OSCustomCustom Embedding
PDFyesnoyesyes
PostScriptyesnoyesyes
PCLyes (modified)yes (painted as bitmaps)yes (painted as bitmaps)no
AFPnonoyesyes
Java2D/AWT/Bitmapif available from OSyesyesn/a (display only)
Printif available from OSyesyescontrolled by OS printer driver
RTFn/a (font metrics not needed)n/an/an/a
TXTyes (used for layout but not for output)noyes (used for layout but not for output)no
XMLyesnoyesn/a
-
-
- Base-14 Fonts -

- The Adobe PostScript and PDF Specification specify a set of 14 fonts that must be - available to every PostScript interpreter and PDF reader: - Helvetica (normal, bold, italic, bold italic), - Times (normal, bold, italic, bold italic), - Courier (normal, bold, italic, bold italic), - Symbol and ZapfDingbats. -

-

- Please note that recent versions of Adobe Acrobat Reader replace - "Helvetica" with "Arial" and "Times" with "Times New Roman" internally. - GhostScript replaces "Helvetica" with "Nimbus Sans L" and "Times" with - "Nimbus Roman No9 L". Other document viewers may do similar font - substitutions. If you need to make sure that there are no such - substitutions, you need to specify an explicit font and embed it in - the target document. -

-
-
- Missing Fonts -

- When FOP does not have a specific font at its disposal (because it's - not installed in the operating system or set up in FOP's configuration), - the font is replaced with "any". "any" is internally mapped to the - Base-14 font "Times" (see above). -

-
-
- Java2D/AWT/Operating System Fonts -

- The Java2D family of renderers (Java2D, AWT, Print, TIFF, PNG), use the - Java AWT subsystem for font metric information. Through operating system - registration, the AWT subsystem knows what fonts are available on the system, - and the font metrics for each one. -

-

- When working with one of these output formats and you're missing a font, just - install it in your operating system and they should be available for these - renderers. Please note that this is not true for other output formats such as - PDF or PostScript. -

-
- -
- Custom Fonts -

- Support for custom fonts is highly output format dependent (see above table). - This section shows how to add Type 1 and TrueType fonts to the PDF, PostScript and - Java2D-based renderers. Other renderers (like AFP) support other font formats. Details - in this case can be found on the page about output formats. -

-

- Prior to FOP version 0.94, it was always necessary to create an XML font metrics file - if you wanted to add a custom font. This unconvenient step has been removed and in - addition to that, FOP supports auto-registration of fonts, i.e. FOP can find fonts - installed in your operating system or can scan user-specified directories for fonts. - Font registration via XML font metrics file is still supported and is still necessary - if you want to use a TrueType Collection (*.ttc). Direct support for TrueType - collections may be added later. Furthermore, the XML font metrics files are still - required if you don't want to embed, but only reference a font. -

-

- Basic information about fonts can be found at: -

- -
- -
- Basic font configuration -

- If you want FOP to use custom fonts, you need to tell it where to find them. This - is done in the configuration file and once per renderer (because each output format - is a little different). In the basic form, you can either tell FOP to find your - operating system fonts or you can specify directories that it will search for - support fonts. These fonts will then automatically be registered. -

- - - C:\MyFonts1 - - - C:\MyFonts2 - - - -]]> - - Review the documentation for FOP Configuration - for instructions on making the FOP configuration available to FOP when it runs. - Otherwise, FOP has no way of finding your custom font information. It is currently - not possible to easily configure fonts from Java code. - -
- -
- Advanced font configuration -

- The instructions found above should be sufficient for most users. Below are some - additional instructions in case the basic font configuration doesn't lead to - the desired results. -

-
- Type 1 Font Metrics -

FOP includes PFMReader, which reads the PFM file that normally comes with a Type 1 font, and generates an appropriate font metrics file for it. - To use it, run the class org.apache.fop.fonts.apps.PFMReader:

-

Windows:

- java -cp build\fop.jar;lib\avalon-framework.jar;lib\commons-logging.jar;lib\commons-io.jar - org.apache.fop.fonts.apps.PFMReader [options] pfm-file xml-file -

Unix:

- java -cp build/fop.jar:lib/avalon-framework.jar:lib/commons-logging.jar:lib/commons-io.jar - org.apache.fop.fonts.apps.PFMReader [options] pfm-file xml-file -

PFMReader [options]:

-
    -
  • -fn <fontname> By default, FOP uses the fontname from the - .pfm file when embedding the font. Use the "-fn" option to override this name with one you have - chosen. This may be useful in some cases to ensure that applications using the output document - (Acrobat Reader for example) use the embedded font instead of a local font with the same - name.
    • -
- The classpath in the above example has been simplified for readability. - You will have to adjust the classpath to the names of the actual JAR files in the lib directory. - xml-apis.jar, xercesImpl.jar, xalan.jar and serializer.jar are not necessary for JDK version 1.4 or later. - The tool will construct some values (FontBBox, StemV and ItalicAngle) based on assumptions and calculations which are only an approximation to the real values. - FontBBox and Italic Angle can be found in the human-readable part of the PFB file or in the AFM file. - The PFMReader tool does not yet interpret PFB or AFM files, so if you want to be correct, you may have to adjust the values in the XML file manually. - The constructed values however appear to have no visible influence. -
-
- TrueType Font Metrics -

FOP includes TTFReader, which reads the TTF file and generates an appropriate font metrics file for it. - Use it in a similar manner to PFMReader. - For example, to create such a metrics file in Windows from the TrueType font at c:\myfonts\cmr10.ttf:

- java -cp build\fop.jar;lib\avalon-framework.jar;lib\commons-logging.jar;lib\commons-io.jar - org.apache.fop.fonts.apps.TTFReader [options] - C:\myfonts\cmr10.ttf ttfcm.xml -

TTFReader [options]:

-
    -
  • -d <DEBUG | INFO > Sets the debug level (default is - INFO).
    • -
  • -fn <fontname> Same as for PFMReader.
    • -
  • -ttcname <fontname> If you're reading data from a - TrueType Collection (.ttc file) you must specify which font from the collection you will read - metrics from. - If you read from a .ttc file without this option, the fontnames will be listed for you.
    • -
  • -enc ansi Creates a WinAnsi-encoded font metrics file. - Without this option, a CID-keyed font metrics file is created. - The table below summarizes the differences between these two encoding options as currently - used within FOP. - Please note that this information only applies to TrueType fonts and TrueType collections:
    • -
- - - - - - - - - - - - - - - - -
IssueWinAnsiCID-keyed
Usable Character SetLimited to WinAnsi character set, which is roughly equivalent to iso-8889-1.Limited only by the characters in the font itself.
Embedding the FontOptional.Mandatory. Not embedding the font produces invalid PDF documents.
- - You may experience failures with certain TrueType fonts, especially if they don't contain - the so-called Unicode "cmap" table. TTFReader can currently not deal with font like this. - -
-
- TrueType Collections Font Metrics -

TrueType collections (.ttc files) contain more than one font. - To create metrics files for these fonts, you must specify which font in the collection should be generated, by using the "-ttcname" option with the TTFReader.

-

To get a list of the fonts in a collection, just start the TTFReader as if it were a normal TrueType file (without the -ttcname option). - It will display all of the font names and exit with an Exception.

-

Here is an example of generating a metrics file for a .ttc file:

- java -cp build\fop.jar;lib\avalon-framework.jar;lib\commons-logging.jar;lib\commons-io.jar - org.apache.fop.fonts.apps.TTFReader -ttcname "MS Mincho" - msmincho.ttc msminch.xml -
-
- Register Fonts with FOP -

You must tell FOP how to find and use the font metrics files by registering them in the FOP Configuration. Add entries for your custom fonts, regardless of font type, to the configuration file in a manner similar to the following:

- - - - - - - - C:\MyFonts1 - - - C:\MyFonts2 - - - -]]> -
    -
  • - URLs are used to access the font metric and font files. - Relative URLs are resolved relative to the font-base property (or base) if available. - See FOP: Configuration for more information. -
    • -
  • The "metrics-url" attribute is generally not necessary except if you run into problems with certain fonts.
    • -
  • Either an "embed-url" or a "metrics-url" must be specified for font tag configurations.
    • -
  • The font "kerning" attribute is optional. Default is "true".
    • -
  • If embedding is off (i.e. embed-url is not set), the output will position the text correctly (from the metrics file), but it will not be displayed or printed correctly unless the viewer has the applicable font available to their local system.
    • -
  • When setting the "embed-url" attribute for Type 1 fonts, be sure to specify the PFB (actual font data), not PFM (font metrics) file that you used to generate the XML font metrics file.
    • -
  • The fonts "directory" tag can be used to register fonts contained within a single or list of directory paths. The "recursive" attribute can be specified to recursively add fonts from all sub directories.
    • -
  • The fonts "auto-detect" tag can be used to automatically register fonts that are found to be installed on the native operating system.
    • -
  • Fonts registered with "font" tag configurations override fonts found by means of "directory" tag definitions.
    • -
  • Fonts found as a result of a "directory" tag configuration override fonts found as a result of the "auto-detect" tag being specified.
    • -
  • - If relative URLs are specified, they are evaluated relative to the value of the - "font-base" setting. If there is no "font-base" setting, the fonts are evaluated - relative to the base directory. -
    • -
- -
-
- Auto-Detect and auto-embedd feature -

When the "auto-detect" flag is set in the configuration, FOP will automatically search for fonts in the default paths for your operating system.

-

FOP will also auto-detect fonts which are available in the classpath, if they are described as "application/x-font" in the MANIFEST.MF file. For example, if your .jar file contains font/myfont.ttf:

- Manifest-Version: 1.0 - - Name: font/myfont.ttf - Content-Type: application/x-font -

This feature allows you to create JAR files containing fonts. The JAR files can be added to fop by providem them in the classpath, e.g. copying them into the lib/ directory.

-
-
- Embedding - The PostScript renderer does not yet support TrueType fonts, but can embed Type 1 fonts. - The font is simply embedded into the PDF file, it is not converted. -

Font embedding is enabled in the userconfig.xml file and controlled by the embed-url attribute. - If you don't specify the embed-url attribute the font will not be embedded, but will only be referenced.

- - Omitting the embed-url attribute for CID-encoded TrueType fonts will currently produce invalid - PDF files! If you create the XML font metric file using the "-enc ansi" option, you can omit - the embed-url attribute for TrueType fonts but you're restricted to the WinAnsi character set. - -

When FOP embeds a font, it adds a prefix to the fontname to ensure that the name will not match the fontname of an installed font. - This is helpful with older versions of Acrobat Reader that preferred installed fonts over embedded fonts.

-

When embedding PostScript fonts, the entire font is always embedded.

-

When embedding TrueType fonts (ttf) or TrueType Collections (ttc), a subset of the - original font, containing only the glyphs used, is embedded in the output document.

-
- -
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/fotree/disabled-testcases.xml b/src/documentation/content/xdocs/0.95/fotree/disabled-testcases.xml deleted file mode 100644 index f6f78dcf7..000000000 --- a/src/documentation/content/xdocs/0.95/fotree/disabled-testcases.xml +++ /dev/null @@ -1,26 +0,0 @@ - - - - - - Markers and core function evaluation - from-table-column_marker.fo - The code currently evaluates this function according to the column in which the - marker appears in the source document, rather than the column it is retrieved in. - - diff --git a/src/documentation/content/xdocs/0.95/graphics.xml b/src/documentation/content/xdocs/0.95/graphics.xml deleted file mode 100644 index b82912ba6..000000000 --- a/src/documentation/content/xdocs/0.95/graphics.xml +++ /dev/null @@ -1,567 +0,0 @@ - - - - - -
- Apache™ FOP: Graphics Formats - $Revision$ -
- -
- Introduction -

- After the Apache™ FOP 0.94 release, the image handling subsystem has been rewritten in - order to improve the range of supported images and image subtypes, to lower the - overall memory consumption when handling images, to produce smaller output files and to - increase the performance in certain areas. Of course, this causes a few changes most of - which the user will probably not notice. The most important changes are: -

-
    -
  • - The image libraries Jimi and JAI are no longer supported. Instead, Apache FOP uses the - Image I/O API that was introduced with Java 1.4 for all bitmap codecs. -
    • -
  • - Some bitmap images are no longer converted to a standardized 24 bit RGB image but are - instead handled in their native format. -
    • -
  • - A plug-in mechanism offers a possibility to add support for new formats without changing - the FOP's source code. -
    • -
-

- The actual image loading framework - no longer resides in Apache FOP, but was instead placed in - XML Graphics Commons. -

-
-
- Overview of Graphics Support -

- The table below summarizes the theoretical support for graphical formats - within FOP. In other words, within the constraints of the limitations listed here, - these formats should work. However, many of them have not been tested, - and there may be limitations that have not yet been discovered or documented. - The packages needed to support some formats are not included in the FOP distribution - and must be installed separately. Follow the links in the "Support Through" columns - for more details. -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FormatTypeSupport Through
Apache FOP (native)Apache BatikImage I/O
BMP (Microsoft Windows Bitmap)bitmap - - X [1]
EMF (Windows Enhanced Metafile)vector (with embedded bitmaps)(X) - -
EPS (Encapsulated PostScript)metafile (both bitmap and vector), most frequently used for vector drawings(X) - -
GIF (Graphics Interchange Format)bitmap - - X
JPEG (Joint Photographic Experts Group)bitmap(X) - X
PNG (Portable Network Graphic)bitmap - - X
SVG (Scalable Vector Graphics)vector (with embedded bitmaps) - X -
TIFF (Tag Image Format File)bitmap(X) - X [1]
WMF (Windows Metafile)vector (with embedded bitmaps) - (X) -
-

- Legend: -

-
    -
  • "(X)" means restricted support. Please see the details below.
    • -
  • - [1]: Requires the presence of JAI Image I/O Tools - (or an equivalent Image I/O compatible codec) in the classpath. JAI Image I/O Tools also - adds support for JPEG 2000, WBMP, RAW and PNM. Other Image I/O codecs may provide - support for additional formats. -
    • -
- - JAI Image I/O Tools is not the same as the - JAI library! The - former simply exposes JAI's codecs using the Image&nbsp;I/O API but does not include all - the image manipulation functionality. - -
- Map of supported image formats by output format -

- Not all image formats are supported for all output formats! For example, while you can - use EPS (Encapsulated PostScript) files when you generate PostScript output, this format - will not be supported by any other output format. Here's an overview of which image - formats are supported by which output format: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Image FormatPDFPostScriptJava2D, PNG, TIFF, AWTPCLAFPRTF
BMP (Microsoft Windows Bitmap)XXXXXX
EMF (Windows Enhanced Metafile) - - - - - X [1]
EPS (Encapsulated PostScript) - X [1] - - - -
GIF (Graphics Interchange Format)XXXXXX
JPEG (Joint Photographic Experts Group)X [1]X [1]XXX [1]X
PNG (Portable Network Graphic)XXXXXX
SVG (Scalable Vector Graphics)XXXXXX
TIFF (Tag Image Format File)X [2]X [2]XXX [2]X
WMF (Windows Metafile)XXXXXX
-

- Legend: -

-
    -
  • - [1]: Supported without the need to decode the image. -
    • -
  • - [2]: Supported without the need to decode the image, but only for certain subtypes. -
    • -
-
-
-
- Graphics Packages -
- XML Graphics Commons Native -

- XML Graphics Commons supports a number - of graphic file formats natively as basic functionality: all bitmap formats for which - there are Image I/O codecs available (JPEG, PNG, GIF, TIFF, etc.), EPS and EMF. -

-
-
- FOP Native -

- FOP has no native image plug-ins for the image loading framework of its own but currently - hosts the Batik-dependent SVG and WMF plug-ins until they can be moved to - Apache Batik. -

-
-
- Apache Batik -

- Apache Batik will later receive the - SVG and WMF plug-ins for the image loading framework that are currently hosted inside - FOP. -

-

- Current FOP distributions include a distribution of the - Apache Batik. - Because Batik's API changes frequently, it is highly recommended that you use the - version that ships with FOP, at least when running FOP. -

- Batik must be run in a graphical environment. -

- Batik must be run in a graphical environment. - It uses AWT classes for rendering SVG, which in turn require an X server on Unixish - systems. If you run a server without X, or if you can't connect to the X server due to - security restrictions or policies (a so-called "headless" environment), SVG rendering - will fail. -

-

Here are some workarounds:

-
    -
  • - Start Java with the -Djava.awt.headless=true command line option. -
    • -
  • - Install an X server which provides an in-memory framebuffer without actually using a - screen device or any display hardware. One example is Xvfb. -
    • -
  • - Install a toolkit which emulates AWT without the need for an underlying X server. One - example is the PJA toolkit, which is free - and comes with detailed installation instructions. -
    • -
-
-
- Image I/O -

- The image loading framework in XML Graphics Commons - provides a wrapper to load images through the - JDK's Image I/O API (JSR 015). - Image I/O allows to dynamically add additional image codecs. An example of such an - add-on library are the - JAI Image I/O Tools - available from Sun. -

-
-
-
- Details on image formats -
- BMP -

- BMP images are supported through an Image I/O codec. There may be limitations of the - codec which are outside the control of Apache FOP. -

-
-
- EMF -

- Windows Enhanced Metafiles (EMF) are only supported in RTF output where they are - embedded without decoding. -

-
-
- EPS -

Apache FOP allows to use EPS files when generating PostScript output only.

-

- Other output targets can't be supported at the moment because - FOP lacks a PostScript interpreter. Furthermore, FOP is currently not able - to parse the preview bitmaps sometimes contained in EPS files. -

-
-
- GIF -

- GIF images are supported through an Image&nbsp;I/O codec. Transparency is supported but - not guaranteed to work with every output format. -

-
-
- JPEG -

- FOP native support (i.e. the handling of undecoded images) of JPEG does not include all - variants, especially those containing unusual color lookup tables and color profiles. - If you have trouble with a JPEG image in FOP, try opening it with an image processing - program (such as Photoshop or Gimp) and then saving it. Specifying 24-bit color output - may also help. For the PDF and PostScript renderers most JPEG images can be passed - through without decompression. User reports indicate that grayscale, RGB, and - CMYK color spaces are all rendered properly. However, for other output formats, the - JPEG images have to be decompressed. Tests have shown that there are some limitation - in some Image&nbsp;I/O codecs concerning images in the CMYK color space. Work-arounds are - in place but may not always work as expected. -

-
-
- PNG -

- PNG images are supported through an Image&nbsp;I/O codec. Transparency is supported but - not guaranteed to work with every output format. -

-
-
- SVG -
- Introduction -

FOP uses Apache Batik for SVG support. - This format can be handled as an fo:instream-foreign-object or in a separate - file referenced with fo:external-graphic.

- - Batik's SVG Rasterizer utility may also be used to convert standalone SVG - documents into PDF. For more information please see the - SVG Rasterizer documentation - on the Batik site. - -
-
- Placing SVG Graphics into PDF -

- The SVG is rendered into PDF by using PDF commands to draw and fill - lines and curves. This means that the graphical objects created with - this remain as vector graphics. The same applies to PostScript output. - For other output formats the SVG graphic may be converted to a bitmap - image. -

-

- There are a number of SVG things that cannot be converted directly into - PDF. Parts of the graphic such as effects, patterns and images are inserted - into the PDF as a raster graphic. The resolution of these raster images can - be controlled through the "target resolution" setting in the - configuration.

-

- Currently transparency is limited in PDF so many SVG images that - contain effects or graphics with transparent areas may not be displayed - correctly. -

-
-
- Placing SVG Text into PDF and PostScript -

If possible, Batik will use normal PDF or PostScript text when inserting text. It does - this by checking if the text can be drawn normally and the font is - supported. This example svg text.svg / - text.pdf - shows how various types and effects with text are handled. - Note that tspan and outlined text are not yet implemented.

-

- Otherwise, text is converted and drawn as a set of shapes by Batik, using the - stroking text painter. This means that a typical character will - have about 10 curves (each curve consists of at least 20 characters). - This can make the output files large and when it is viewed the - viewer may not normally draw those fine curves very well (In Adobe Acrobat, turning on - "Smooth Line Art" in the preferences will fix this). Copy/paste functionality - will not be supported in this case. - If the text is inserted into the output file using the inbuilt text commands - it will use a single character. -

-

- Note that because SVG text can be rendered as either text or a vector graphic, you - may need to consider settings in your viewer for both. The Acrobat viewer has both - "smooth line art" and "smooth text" settings that may need to be set for SVG images - to be displayed nicely on your screen (see Edit / Preferences / Display). - This setting will not affect the printing of your document, which should be OK in - any case, but will only affect the quality of the screen display.

-
-
- Scaling -

- Currently, SVG images are rendered with the dimensions specified in the SVG - file, within the viewport specified in the fo:external-graphic element. - For everything to work properly, the two should be equal. The SVG standard leaves - this issue as an implementation detail. Additional scaling options are available - through XSL-FO means. -

-

- If you use pixels to specify the size of an SVG graphic the "source resolution" setting - in the configuration will be used to determine the - size of a pixel. The use of pixels to specify sizes is discouraged as they may - be interpreted differently in different environments. -

-
-
- Known Problems -
    -
  • - Soft mask transparency is combined with white so that it looks better - on PDF 1.3 viewers but this causes the soft mask to be slightly lighter - or darker on PDF 1.4 viewers. -
    • -
  • - There is some problem with a gradient inside a pattern which may cause a PDF - error when viewed in Acrobat 5. -
    • -
  • - Text is not always handled correctly, it may select the wrong font - especially if characters have multiple fonts in the font list. -
    • -
  • - Uniform transparency for images and other SVG elements that are converted - into a raster graphic are not drawn properly in PDF. The image is opaque. -
    • -
-
-
-
- TIFF -

- FOP can embed TIFF images without decompression into PDF, PostScript and AFP if they - have either CCITT T.4, CCITT T.6, or JPEG compression. Otherwise, a TIFF-capable - Image&nbsp;I/O codec is necessary for decoding the image. -

-

- There may be some limitation concerning images in the CMYK color space. -

-
-
- WMF -

- Windows Metafiles (WMF) are supported through classes in - Apache Batik. At the moment, support - for this format is experimental and may not always work as expected. -

-
-
-
- Graphics Resolution -

- Some bitmapped image file formats store a dots-per-inch (dpi) or other resolution - values. FOP tries to use this resolution information whenever possible to determine - the image's intrinsic size. This size is used during the layout process when it is not - superseded by an explicit size on fo:external-graphic (content-width and content-height - properties). -

-

- Please note that not all images contain resolution information. If it's not available - the source resolution set on the FopFactory (or through the user configuration XML) is used. - The default here is 72 dpi. -

-

- Bitmap images are generally embedded into the output format at their original resolution - (as is). No resampling of the image is performed. Explicit resampling is on our wishlist, - but hasn't been implemented, yet. Bitmaps included in SVG graphics may be resampled to - the resolution specified in the "target resolution" setting in the - configuration if SVG filters are applied. This can be - used as a work-around to resample images in FO documents. -

-
-
- Page selection for multi-page formats -

- Some image formats such as TIFF support multiple pages/sub-images per file. You can - select a particular page using a special URI fragment in the form: - <uri>#page=<nr> - (for example: http://localhost/images/myimage.tiff#page=3) -

-
-
- Image caching -

- FOP caches images between runs. There is one cache per FopFactory instance. The URI is - used as a key to identify images which means that when a particular URI appears again, - the image is taken from the cache. If you have a servlet that generates a different - image each time it is called with the same URI you need to use a constantly - changing dummy parameter on the URI to avoid caching. -

-

- The image cache has been improved considerably in the redesigned code. Therefore, - resetting the image cache should be a thing of the past. If you - still experience OutOfMemoryErrors, please notify us. -

-

- If all else fails, the image cache can be cleared like this: - fopFactory.getImageManager().getCache().clearCache(); -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/hyphenation.xml b/src/documentation/content/xdocs/0.95/hyphenation.xml deleted file mode 100644 index 1d1c63d82..000000000 --- a/src/documentation/content/xdocs/0.95/hyphenation.xml +++ /dev/null @@ -1,237 +0,0 @@ - - - - - -
- Apache™ FOP: Hyphenation - $Revision$ -
- -
- Hyphenation Support -
- Introduction -

Apache™ FOP uses Liang's hyphenation algorithm, well known from TeX. It needs - language specific pattern and other data for operation.

-

Because of licensing issues (and for - convenience), all hyphenation patterns for FOP are made available through - the Objects For - Formatting Objects project.

- If you have made improvements to an existing FOP hyphenation pattern, - or if you have created one from scratch, please consider contributing these - to OFFO so that they can benefit other FOP users as well. - Please inquire on the FOP User - mailing list. -
-
- License Issues -

Many of the hyphenation files distributed with TeX and its offspring are - licenced under the LaTeX - Project Public License (LPPL), which prevents them from being - distributed with Apache software. The LPPL puts restrictions on file names - in redistributed derived works which we feel can't guarantee. Some - hyphenation pattern files have other or additional restrictions, for - example against use for commercial purposes.

-

Although Apache FOP cannot redistribute hyphenation pattern files that do - not conform with its license scheme, that does not necessarily prevent users - from using such hyphenation patterns with FOP. However, it does place on - the user the responsibility for determining whether the user can rightly use - such hyphenation patterns under the hyphenation pattern license.

- The user is responsible to settle license issues for hyphenation - pattern files that are obtained from non-Apache sources. -
-
- Sources of Custom Hyphenation Pattern Files -

The most important source of hyphenation pattern files is the - CTAN TeX - Archive.

-
-
- Installing Custom Hyphenation Patterns -

To install a custom hyphenation pattern for use with FOP:

-
    -
  1. Convert the TeX hyphenation pattern file to the FOP format. The FOP - format is an xml file conforming to the DTD found at - {fop-dir}/hyph/hyphenation.dtd.
    2. -
  2. Name this new file following this schema: - languageCode_countryCode.xml. The country code is - optional, and should be used only if needed. For example: -
      -
    • en_US.xml would be the file name for American - English hyphenation patterns.
      • -
    • it.xml would be the file name for Italian - hyphenation patterns.
      • -
    - The language and country codes must match the XSL-FO input, which - follows ISO - 639 (languages) and ISO - 3166 (countries). NOTE: The ISO 639/ISO 3166 convention is that - language names are written in lower case, while country codes are written - in upper case. FOP does not check whether the language and country specified - in the FO source are actually from the current standard, but it relies - on it being two letter strings in a few places. So you can make up your - own codes for custom hyphenation patterns, but they should be two - letter strings too (patches for proper handling extensions are welcome)
    3. -
  3. There are basically three ways to make the FOP-compatible hyphenation pattern - file(s) accessible to FOP: -
      -
    • Download the precompiled JAR from OFFO - and place it either in the {fop-dir}/lib directory, or - in a directory of your choice (and append the full path to the JAR to - the environment variable FOP_HYPHENATION_PATH).
      • -
    • Download the desired FOP-compatible hyphenation pattern file(s) from - OFFO, - and/or take your self created hyphenation pattern file(s), -
        -
      • place them in the directory {fop-dir}/hyph,
        • -
      • or place them in a directory of your choice and set the Ant variable - user.hyph.dir to point to that directory (in - build-local.properties),
        • -
      - and run Ant with build target - jar-hyphenation. This will create a JAR containing the - compiled patterns in {fop-dir}/build that will be added to the - classpath on the next run. - (When FOP is built from scratch, and there are pattern source file(s) - present in the directory pointed to by the - user.hyph.dir variable, this JAR will automatically - be created from the supplied pattern(s)).
      • -
    • Put the pattern source file(s) into a directory of your choice and - configure FOP to look for custom patterns in this directory, by setting the - <hyphenation-base> - configuration option.
      • -
    -
    4. -
- - Either of these three options will ensure hyphenation is working when using - FOP from the command-line. If FOP is being embedded, remember to add the location(s) - of the hyphenation JAR(s) to the CLASSPATH (option 1 and 2) or to set the - <hyphenation-dir> - configuration option programmatically (option 3). - -
-
-
- Hyphenation Patterns -

If you would like to build your own hyphenation pattern files, or modify - existing ones, this section will help you understand how to do so. Even - when creating a pattern file from scratch, it may be beneficial to start - with an existing file and modify it. See - OFFO's Hyphenation page for examples. - Here is a brief explanation of the contents of FOP's hyphenation patterns:

- The remaining content of this section should be considered "draft" - quality. It was drafted from theoretical literature, and has not been - tested against actual FOP behavior. It may contain errors or omissions. - Do not rely on these instructions without testing everything stated here. - If you use these instructions, please provide feedback on the - FOP User mailing list, either - confirming their accuracy, or raising specific problems that we can - address. -
    -
  • The root of the pattern file is the <hyphenation-info> element.
    • -
  • <hyphen-char>: its attribute "value" contains the character signalling - a hyphen in the <exceptions> section. It has nothing to do with the - hyphenation character used in FOP, use the XSLFO hyphenation-character - property for defining the hyphenation character there. At some points - a dash U+002D is hardwired in the code, so you'd better use this too - (patches to rectify the situation are welcome). There is no default, - if you declare exceptions with hyphenations, you must declare the - hyphen-char too.
    • -
  • <hyphen-min> contains two attributes: -
      -
    • before: the minimum number of characters in a word allowed to exist - on a line immediately preceding a hyphenated word-break.
      • -
    • after: the minimum number of characters in a word allowed to exist - on a line immediately after a hyphenated word-break.
      • -
    - This element is unused and not even read. It should be considered a - documentation for parameters used during pattern generation. -
    • -
  • <classes> contains whitespace-separated character sets. The members - of each set should be treated as equivalent for purposes of hyphenation, - usually upper and lower case of the same character. The first character - of the set is the canonical character, the patterns and exceptions - should only contain these canonical representation characters (except - digits for weight, the period (.) as word delimiter in the patterns and - the hyphen char in exceptions, of course).
    • -
  • <exceptions> contains whitespace-separated words, each of which - has either explicit hyphen characters to denote acceptable breakage - points, or no hyphen characters, to indicate that this word should - never be hyphenated, or contain explicit <hyp> elements for specifying - changes of spelling due to hyphenation (like backen -> bak-ken or - Stoffarbe -> Stoff-farbe in the old german spelling). Exceptions override - the patterns described below. Explicit <hyp> declarations don't work - yet (patches welcome). Exceptions are generally a bit brittle, test - carefully.
    • -
  • <patterns> includes whitespace-separated patterns, which are what - drive most hyphenation decisions. The characters in these patterns are - explained as follows: -
      -
    • non-numeric characters represent characters in a sub-word to be - evaluated
      • -
    • the period character (.) represents a word boundary, i.e. either - the beginning or ending of a word
      • -
    • numeric characters represent a scoring system for indicating the - acceptability of a hyphen in this location. Odd numbers represent an - acceptable location for a hyphen, with higher values overriding lower - inhibiting values. Even numbers indicate an unacceptable location, with - higher values overriding lower values indicating an acceptable position. - A value of zero (inhibiting) is implied when there is no number present. - Generally patterns are constructed so that valuse greater than 4 are rare. - Due to a bug currently patterns with values of 8 and greater don't - have an effect, so don't wonder.
      • -
    - Here are some examples from the English patterns file: -
      -
    • Knuth (The TeXBook, Appendix H) uses the example hach4, which indicates that it is extremely undesirable to place a hyphen after the substring "hach", for example in the word "toothach-es".
      • -
    • .leg5e indicates that "leg-e", when it occurs at the beginning of a word, is a very good place to place a hyphen, if one is needed. Words like "leg-end" and "leg-er-de-main" fit this pattern.
      • -
    - Note that the algorithm that uses this data searches for each of the word's substrings in the patterns, and chooses the highest value found for letter combination. -
    • -
-

If you want to convert a TeX hyphenation pattern file, you have to undo - the TeX encoding for non-ASCII text. FOP uses Unicode, and the patterns - must be proper Unicode too. You should be aware of the XML encoding issues, - preferably use a good Unicode editor.

-

Note that FOP does not do Unicode character normalization. If you use - combining chars for accents and other character decorations, you must - declare character classes for them, and use the same sequence of base character - and combining marks in the XSLFO source, otherwise the pattern wouldn't match. - Fortunately, Unicode provides precomposed characters for all important cases - in common languages, until now nobody run seriously into this issue. Some dead - languages and dialects, especially ancient ones, may pose a real problem - though.

-

If you want to generate your own patterns, an open-source utility called - patgen is available on many Unix/Linux distributions and every TeX - distribution which can be used to assist in - creating pattern files from dictionaries. Pattern creation for languages like - english or german is an art. If you can, read Frank Liang's original paper - "Word Hy-phen-a-tion by Com-pu-ter" (yes, with hyphens). It is not available - online. The original patgen.web source, included in the TeX source distributions, - contains valuable comments, unfortunately technical details obscure often the - high level issues. Another important source is - The - TeX Book, appendix H (either read the TeX source, or run it through - TeX to typeset it). Secondary articles, for example the works by Petr Sojka, - may also give some much needed insight into problems arising in automated - hyphenation.

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/index.xml b/src/documentation/content/xdocs/0.95/index.xml deleted file mode 100644 index 49d07332c..000000000 --- a/src/documentation/content/xdocs/0.95/index.xml +++ /dev/null @@ -1,54 +0,0 @@ - - - - - -
- Apache™ FOP Version 0.95 - $Revision$ -
- -
- Introduction -

- The Apache™ FOP team is proud to present to you this production quality release. - We're still in the process of adding new features. We welcome any feedback you - might have and even more, any other form of help to get the project forward. -

-

- This sixth release contains many bug fix release and new features compared - to 0.94. To see what has changed since the last release, please visit the - Changes Page and the - Release Notes. -

-
-
- Upgrading from an earlier version -

- If you're upgrading to this version from an earlier version of FOP, please read the - information contained on the Upgrading page! -

-
-
- Download -

- To download this version, please visit the download page. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/intermediate.xml b/src/documentation/content/xdocs/0.95/intermediate.xml deleted file mode 100644 index e46190276..000000000 --- a/src/documentation/content/xdocs/0.95/intermediate.xml +++ /dev/null @@ -1,146 +0,0 @@ - - - - - -
- Apache™ FOP: Intermediate Format - $Revision$ -
- - - Please note that the intermediate format is an advanced feature and can be ignored by most - users of Apache™ FOP. - -
- Introduction -

- The intermediate format (IF) is a proprietary XML format that represents the area tree - generated by the layout engine. The area tree is conceptually defined in the - XSL-FO specification in chapter 1.1.2. - The IF can be generated through the area tree XML Renderer (the XMLRenderer). -

-

- The intermediate format can be used to generate intermediate documents that are modified - before they are finally rendered to their ultimate output format. Modifications include - adjusting and changing trait values, adding or modifying area objects, inserting prefabricated - pages, overlays, imposition (n-up, rotation, scaling etc.). Multiple IF files can be combined - to a single output file. -

-
-
- Usage of the Intermediate Format -

- As already mentioned, the IF is generated by using the XMLRenderer (MIME type: - application/X-fop-areatree). So, you basically set the right MIME type for - the output format and process your FO files as if you would create a PDF file. However, there - is an important detail to consider: The various Renderers don't all use the same font sources. - To be able to create the right area tree for the ultimate output file, you need to create - the IF file using the right font setup. This is achieved by telling the XMLRenderer to mimic - another renderer. This is done by calling the XMLRenderer's mimicRenderer() method with an - instance of the ultimate target renderer as the single parameter. This has a consequence: An - IF file rendered with the Java2DRenderer may not look as expected when it was actually generated - for the PDF renderer. For renderers that use the same font setup, this restriction does not - apply (PDF and PS, for example). Generating the intermediate format file is the first step. -

-

- The second step is to reparse the IF file using the AreaTreeParser which is - found in the org.apache.fop.area package. The pages retrieved from the IF file are added to an - AreaTreeModel instance from where they are normally rendered using one of the available Renderer - implementations. You can find examples for the IF processing in the - examples/embedding - directory in the FOP distribution -

-

- The basic pattern to parse the IF format looks like this: -

- -

- This example simply reads an IF file and renders it to a PDF file. Please note, that in normal - FOP operation you're shielded from having to instantiate the FontInfo object yourself. This - is normally a task of the AreaTreeHandler which is not present in this scenario. The same - applies to the AreaTreeModel instance, in this case an instance of a subclass called - RenderPagesModel. RenderPagesModel is ideal in this case as it has very little overhead - processing the individual pages. An important line in the example is the call to - endDocument() on the AreaTreeModel. This lets the Renderer know that the processing - is now finished. -

-

- The intermediate format can also be used from the command-line - by using the "-atin" parameter for specifying the area tree XML as input file. You can also - specify a "mimic renderer" by inserting a MIME type between "-at" and the output file. -

-
- Concatenating Documents -

- This initial example is obviously not very useful. It would be faster to create the PDF file - directly. As the ExampleConcat.java - example shows you can easily parse multiple IF files in a row and add the parsed pages to the - same AreaTreeModel instance which essentially concatenates all the input document to one single - output document. -

-
-
- Modifying Documents -

- One of the most important use cases for the intermediate format is obviously modifying the area - tree XML before finally rendering it to the target format. You can easily use XSLT to process - the IF file according to your needs. Please note, that we will currently not formally describe - the intermediate format. You need to have a good understanding its structure so you don't - create any non-parseable files. We may add an XML Schema and more detailed documentation at a - later time. You're invited to help us with that. -

-
-
- Advanced Use -

- The generation of the intermediate format as well as it parsing process has been designed to allow - for maximum flexibility and optimization. Please note that you can call setTransformerHandler() on - XMLRenderer to give the XMLRenderer your own TransformerHandler instance in case you would like to - do custom serialization (to a W3C DOM, for example) and/or to directly modify the area tree using - XSLT. The AreaTreeParser on the other side allows you to retrieve a ContentHandler instance where - you can manually send SAX events to to start the parsing process (see getContentHandler()). -

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/known-issues.xml b/src/documentation/content/xdocs/0.95/known-issues.xml deleted file mode 100644 index 6e28e3fb7..000000000 --- a/src/documentation/content/xdocs/0.95/known-issues.xml +++ /dev/null @@ -1,70 +0,0 @@ - - - - - - MIF and SVG output support have not been restored, yet. - - - Auto table layout is not implemented, yet. - - - Footnotes may overlap with text of the region-body in multi-column - documents. - - - Space resolution does not work between footnote regions. - - - There's a problem involving nested block-containers and - reference-orientation 180/-180 (Bugzilla #36391) - - - block-containers with no height currently don't create a fence for - spaces as they should (they behave like a normal block). - - - Preserved linefeeds in fo:character are not handled correctly. - - - An empty block currently produces a fence for stacking constraints - which it shouldn't. - - - There are several small problems around white space handling. - - - leaders with leader-pattern="use-content" may not work as expected. - - - If two consecutive pages don't have the same available width, the - content currently isn't properly fit into the available space on - the new page. - - - background-images on page-number-citations are not placed correctly. - - - Not all FO elements can be referenced by their "id", most notably: - table-body, table-header, table-footer and table-row. - - - Column balancing in multi-column documents may not work as expected - (Bugzilla #36356) - - diff --git a/src/documentation/content/xdocs/0.95/knownissues_overview.xml b/src/documentation/content/xdocs/0.95/knownissues_overview.xml deleted file mode 100644 index 53d65a2ca..000000000 --- a/src/documentation/content/xdocs/0.95/knownissues_overview.xml +++ /dev/null @@ -1,69 +0,0 @@ - - - - - -
- Apache™ FOP: Known Issues - $Revision$ -
- -
- Known issues -

- This page lists currently known issues in the current release. -

- -

- For additional information on known issues in Apache™ FOP, please have a look at the following pages, too: -

- - -

- Apache FOP has an extensive automated testing infrastructure. Parts of this infrastructure are several - sets of test cases. When a test case is listed in disabled-testcases.xml it is disabled in the JUnit - tests during the normal build process. This indicates a problem in the current codebase. When a bug is - fixed or a missing feature is added the entry for the relevant test case(s) are removed. -

-
- FO Tree -

- This section lists disabled test cases in the test suite for the FO tree tests, at the time - of the release. -

- -
-
- Layout Engine -

- This section lists disabled test cases in the test suite for the layout engine tests, at the - time of the release. -

- -
-
- Other known issues -

This section lists other known issues.

- -
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/layoutengine/disabled-testcases.xml b/src/documentation/content/xdocs/0.95/layoutengine/disabled-testcases.xml deleted file mode 100644 index b4de16ef4..000000000 --- a/src/documentation/content/xdocs/0.95/layoutengine/disabled-testcases.xml +++ /dev/null @@ -1,260 +0,0 @@ - - - - - - - - External link around an SVG not properly sized - basic-link_external-destination_2.xml - The bpd trait of the inlineparent area for the basic-link - is not sized correctly if it wraps an image that is higher than the - nominal line. - - - Auto-height block-containers produce fences - block-container_space-before_space-after_3.xml - Block-containers with no height currently don't - create a fence for spaces as they should (they behave like a - normal block). - - - font-stretch NYI - block_font-stretch.xml - Font-stretch is not implemented, yet. - - - Hyphenation with preserved linefeeds - block_hyphenation_linefeed_preserve.xml - When hyphenation is enabled and linefeeds are preserved, - the text is output multiple times. - - - linefeed-treatment - block_linefeed-treatment.xml - Preserved linefeeds in a fo:character are not handled - correctly. - - - white-space-treatment - block_white-space-treatment_3.xml - White space handling incorrectly stops at fo:inline - boundaries when it comes to formatter generated line breaks. - - - Empty blocks produce fences - block_space-before_space-after_8.xml - An empty block currently produces a fence for - stacking constraints which it shouldn't. - - - block white-space nbsp 2 - block_white-space_nbsp_2.xml - The nbsp given as an fo:character is not adjustable and therefore - the justification does not work in this case. - - - block word-spacing - block_word-spacing.xml - Word-spacing may not work as expected. - - - block word-spacing text-align justify - block_word-spacing_text-align_justify.xml - Word-spacing may not work as expected. - - - external-graphic don't shrink - external-graphic_oversized.xml - Images currently don't shrink so they fit on a page - when they are too big and shrinking is allowed to - happen (min/opt/max). - - - Test case with HTTP URL - external-graphic_src_uri.xml - Doesn't work behind a proxy which requires - authorization. - - - Space Resolution in foot note area - footnote_space-resolution.xml - Space resolution does not work between footnote - regions. - - - Footnotes swallowed in lists - footnote_in_list.xml - Element lists for lists are created by combining the - element lists from list-item-label and list-item-body. The - footnotes contained in the KnuthBlockBoxes are not propagated to - the combined element list. - http://issues.apache.org/bugzilla/show_bug.cgi?id=37579 - - - Footnotes swallowed in tables - footnote_in_table.xml - Element lists for tables are created by combining the - element lists from the individual table-cells. The footnotes - contained in the KnuthBlockBoxes are not propagated to the combined - element list. - http://issues.apache.org/bugzilla/show_bug.cgi?id=37579 - - - NPE for table inside an inline - inline_block_nested_3.xml - Placing a table as a child of an fo:inline produces a - NullPointerException. - - - inline-container is not implemented, yet. - inline-container_block_nested.xml - inline-container is not implemented, yet. Content of an - inline-container will get swallowed. The test case contains no checks. - - - inline-container is not implemented, yet. - inline-container_border_padding.xml - inline-container is not implemented, yet. Content of an - inline-container will get swallowed. - - - inline letter-spacing - inline_letter-spacing.xml - Letter-spacing may not work as - expected within fo:inline. - - - inline word-spacing - inline_word-spacing.xml - Word-spacing may not work as expected within - fo:inline. - - - inline word-spacing text-align justify - inline_word-spacing_text-align_justify.xml - - - - leader-alignment NYI - leader-alignment.xml - Leader-alignment is not yet - implemented. - - - leader-pattern="use-content": Problem with line height - leader_leader-pattern_use-content_bug.xml - Line height is not correctly calculated for - use-content leaders whose height is larger than the rest of the - line. - http://www.nabble.com/leaders-with-leader-pattern%3D%22use-content%22-t546244.html - - - keep-with-previous doesn't work in lists - list-block_keep-with-previous.xml - Keep-with-previous doesn't work inside tables and - lists, yet. - - - keep-with-previous doesn't work in lists - list-item_block_keep-with-previous.xml - Keep-with-previous doesn't work inside tables and - lists, yet. - - - Page breaking doesn't deal with IPD changes - page-breaking_4.xml - Page breaking currently doesn't support changing available IPD - between pages of a single page-sequence. Element list generation has to be reset to - redetermine line breaks in this case. - - - Overflow handing is incomplete - page-breaking_6.xml - Line breaking is not 100% correct when there's too little space. - Overflows are not detected and warned. - - - Indefinite page height handling is imcomplete - page-height_indefinite_simple.xml - A RuntimeException is thrown for a page of indefinite height. Lots of warnings. - - - page-number-citation: Problem with background-image - page-number-citation_background-image.xml - Background-images on page-number-citations are not - placed correctly. - - - page-number-citation-last: FOs spanning multiple pages are not properly handled. - page-number-citation-last_basic.xml - Resolution of forward references does not wait until an FO is fully finished when an FO spans multiple pages. - - - IDs are not working on all FO elements - page-number-citation_complex_1.xml - The "id" attributes are not properly handled for all block-level FO elements. - - - IDs are not working on all FO elements - page-number-citation_complex_2.xml - The "id" attributes are not properly handled for all inline-level FO elements. - - - Footnotes in multi-column documents - region-body_column-count_footnote.xml - Footnotes may overlap with text of the region-body in - multi-column documents. - - - Column Balancing problems - region-body_column-count_balance_4col.xml - Situation in a 4-column document where the column balancing doesn't work and even causes some - content to disappear. - - - Column Balancing problems - region-body_column-count_bug36356.xml - Column balancing doesn't work as expected. - - - table-cell empty area with marker.xml - table-cell_empty_area_with_marker.xml - A table-cell producing an empty area does currently not add any markers to a page. - See TODO entry in AreaAdditionUtil. - - - Border conditionality on table - table_border-width_conditionality.xml - The code should be ok, but the test case uses shorthands and therefore - is probably not expressing the indended outcome according to the spec. The test - case should be revisited. - - - fo:wrapper around block-level content (with id) - wrapper_block_id.xml - "id" attributes on fo:wrapper around block-level content don't get - added to the area tree. - - - Soft hyphen with normal hyphenation enabled - block_shy_linebreaking_hyph.xml - A soft hyphen should be a preferred as break compared to a - normal hyphenation point but is not. - - diff --git a/src/documentation/content/xdocs/0.95/metadata.xml b/src/documentation/content/xdocs/0.95/metadata.xml deleted file mode 100644 index 5d4185533..000000000 --- a/src/documentation/content/xdocs/0.95/metadata.xml +++ /dev/null @@ -1,243 +0,0 @@ - - - - - -
- Apache™ FOP: Metadata -
- -
- Overview -

- Document metadata is an important tool for categorizing and finding documents. - Various formats support different kinds of metadata representation and to - different levels. One of the more popular and flexible means of representing - document or object metadata is - XMP (eXtensible Metadata Platform, specified by Adobe). - PDF 1.4 introduced the use of XMP. The XMP specification lists recommendation for - embedding XMP metdata in other document and image formats. Given its flexibility it makes - sense to make use this approach in the XSL-FO context. Unfortunately, unlike SVG which - also refers to XMP, XSL-FO doesn't recommend a preferred way of specifying document and - object metadata. Therefore, there's no portable way to represent metadata in XSL-FO - documents. Each implementation does it differently. -

-
-
- Embedding XMP in an XSL-FO document -

- As noted above, there's no officially recommended way to embed metadata in XSL-FO. - Apache™ FOP supports embedding XMP in XSL-FO. Currently, only support for document-level - metadata is implemented. Object-level metadata will be implemented when there's - interest. -

-

- Document-level metadata can be specified in the fo:declarations element. - XMP specification recommends to use x:xmpmeta, rdf:RDF, and - rdf:Description elements as shown in example below. Both - x:xmpmeta and rdf:RDF elements are recognized as the top-level - element introducing an XMP fragment (as per the XMP specification). -

-
- Example - - - - - - - Document title - Document author - Document subject - - - - Tool used to make the PDF - - - - - - - fo:declarations must be declared after - fo:layout-master-set and before the first page-sequence. - -
-
-
- Implementation in Apache FOP -

- Currently, XMP support is only available for PDF output. -

-

- Originally, you could set some metadata information through FOP's FOUserAgent by - using its set*() methods (like setTitle(String) or setAuthor(String). These values are - directly used to set value in the PDF Info object. Since PDF 1.4, adding metadata as an - XMP document to a PDF is possible. That means that there are now two mechanisms in PDF - that hold metadata. -

-

- Apache FOP now synchronizes the Info and the Metadata object in PDF, i.e. when you - set the title and the author through the FOUserAgent, the two values will end up in - the (old) Info object and in the new Metadata object as XMP content. If instead of - FOUserAgent, you embed XMP metadata in the XSL-FO document (as shown above), the - XMP metadata will be used as-is in the PDF Metadata object and some values from the - XMP metadata will be copied to the Info object to maintain backwards-compatibility - for PDF readers that don't support XMP metadata. -

-

- The mapping between the Info and the Metadata object used by Apache FOP comes from - the PDF/A-1 specification. - For convenience, here's the mapping table: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Document information dictionaryXMP
EntryPDF typePropertyXMP typeCategory
Titletext stringdc:titleTextExternal
Authortext stringdc:creatorseq TextExternal
Subjecttext stringdc:description["x-default"]TextExternal
Keywordstext stringpdf:KeywordsTextExternal
Creatortext stringxmp:CreatorToolTextExternal
Producertext stringpdf:ProducerTextInternal
CreationDatedatexmp:CreationDateDateInternal
ModDatedatexmp:ModifyDateDateInternal
- - "Internal" in the Category column means that the user should not set this value. - It is set by the application. - - - The "Subject" used to be mapped to dc:subject in the initial publication of - PDF/A-1 (ISO 19005-1). In the - Technical Corrigendum 1 - this was changed to map to dc:description["x-default"]. - -
- Namespaces -

- Metadata is made of property sets where each property set uses a different namespace URI. -

-

- The following is a listing of namespaces that Apache FOP recognizes and acts upon, - mostly to synchronize the XMP metadata with the PDF Info dictionary: -

- - - - - - - - - - - - - - - - - - - - - -
Set/SchemaNamespace PrefixNamespace URI
Dublin Coredchttp://purl.org/dc/elements/1.1/
XMP Basicxmphttp://ns.adobe.com/xap/1.0/
Adobe PDF Schemapdfhttp://ns.adobe.com/pdf/1.3/
-

- Please refer to the XMP Specification - for information on other metadata namespaces. -

-

- Property sets (Namespaces) not listed here are simply passed through to the final - document (if supported). That is useful if you want to specify a custom metadata - schema. -

-
-
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/output.xml b/src/documentation/content/xdocs/0.95/output.xml deleted file mode 100644 index 16130e8e6..000000000 --- a/src/documentation/content/xdocs/0.95/output.xml +++ /dev/null @@ -1,914 +0,0 @@ - - - - - - -
- Apache™ FOP Output Formats - $Revision$ - - - - -
- - -

- Apache™ FOP supports multiple output formats by using a different renderer for each format. - The renderers do not all have the same set of capabilities, sometimes because of - the output format itself, sometimes because some renderers get more development - attention than others. -

-
- General Information -
- Fonts -

- Most FOP renderers use a FOP-specific system for font registration. - However, the Java2D/AWT and print renderers use the Java AWT package, which gets its - font information from the operating system registration. - This can result in several differences, including actually using different fonts, - and having different font metrics for the same font. - The net effect is that the layout of a given FO document can be quite different between - renderers that do not use the same font information. -

-

- Theoretically, there's some potential to make the output of the PDF/PS renderers match - the output of the Java2D-based renderers. If FOP used the font metrics from its own - font subsystem but still used Java2D for text painting in the Java2D-based renderers, - this could probably be achieved. However, this approach hasn't been implemented, yet. -

-

- With a work-around, it is possible to match the PDF/PS output in a Java2D-based - renderer pretty closely. The clue is to use the - intermediate format. The trick is to layout the - document using FOP's own font subsystem but then render the document using Java2D. - Here are the necessary steps (using the command-line): -

-
    -
  1. - Produce an IF file: fop -fo myfile.fo -at application/pdf myfile.at.xml
    - Specifying "application/pdf" for the "-at" parameter causes FOP to use FOP's own - font subsystem (which is used by the PDF renderer). Note that no PDF file is created - in this step. -
    2. -
  2. Render to a PDF file: fop -atin myfile.at.xml -pdf myfile.pdf
    3. -
  3. Render to a Java2D-based renderer: -
      -
    • fop -atin myfile.at.xml -print
      • -
    • fop -atin myfile.at.xml -awt
      • -
    • fop -atin myfile.at.xml -tiff myfile.tiff
      • -
    -
    4. -
-
-
- Output to a Printer or Other Device -

- The most obvious way to print your document is to use the FOP - print renderer, which uses the Java2D API (AWT). - However, you can also send output from the Postscript renderer directly to a Postscript - device, or output from the PCL renderer directly to a PCL device. -

-

- Here are Windows command-line examples for Postscript and PCL: -

- - -

- Here is some Java code to accomplish the task in UNIX: -

- -

- Set the output MIME type to "application/x-pcl" (MimeConstants.MIME_PCL) and - it happily sends the PCL to the UNIX printer queue. -

-
-
-
- PDF -

- PDF is the best supported output format. It is also the most accurate - with text and layout. This creates a PDF document that is streamed out - as each page is rendered. This means that the internal page index - information is stored near the end of the document. - The PDF version supported is 1.4. PDF versions are forwards/backwards - compatible. -

-

- Note that FOP does not currently support "tagged PDF" or PDF/A-1a. - Support for PDF/A-1b and PDF/X has recently been added, however. -

-
- Fonts -

- PDF has a set of fonts that are always available to all PDF viewers; - to quote from the PDF Specification: - - "PDF prescribes a set of 14 standard fonts that can be used without prior - definition. - These include four faces each of three Latin text typefaces (Courier, - Helvetica, and Times), as well as two symbolic fonts (Symbol and ITC Zapf - Dingbats). These fonts, or suitable substitute fonts with the same metrics, are - guaranteed to be available in all PDF viewer applications." -

-
-
- Post-processing -

- FOP does not currently support several desirable PDF features: watermarks and signatures. - One workaround is to use Adobe Acrobat (the full version, not the Reader) to process - the file manually or with scripting that it supports. -

-

- Another popular post-processing tool is iText, - which has tools for adding security features, document properties, watermarks, and many - other features to PDF files. -

- - Caveat: iText may swallow PDF bookmarks. But - Jens Stavnstrup tells us - that this doesn't happen if you use iText's PDFStamper. - -

- Here is some sample code that uses iText to encrypt a FOP-generated PDF. (Note that FOP now - supports PDF encryption. However the principles for using - iText for other PDF features are similar.) -

- -

- Check the iText tutorial and documentation for setting access flags, password, - encryption strength and other parameters. -

-
-
- Watermarks -

- In addition to the PDF Post-processing options, consider the following workarounds: -

-
    -
  • - Use a background image for the body region. -
    • -
  • - (submitted by Trevor Campbell) Place an image in a - region that overlaps the flowing text. For example, make - region-before large enough to contain your image. Then include a - block (if necessary, use an absolutely positioned block-container) - containing the watermark image in the static-content for the - region-before. Note that the image will be drawn on top of the - normal content. -
    • -
-
-
-
- PostScript -

- The PostScript renderer has been brought up to a similar quality as the - PDF renderer, but may still be missing certain features. It provides good - support for most text and layout. - Images and SVG are not fully supported, yet. Currently, the PostScript - renderer generates PostScript Level 3 with most DSC comments. Actually, - the only Level 3 features used are the FlateDecode and DCTDecode - filter (the latter is used for 1:1 embedding of JPEG images), everything - else is Level 2. -

-
- Configuration -

- The PostScript renderer configuration currently allows the following settings: -

- - false - 3 - false - false - true -]]> -

- The default value for the "auto-rotate-landscape" setting is "false". Setting it - to "true" will automatically rotate landscape pages and will mark them as landscape. -

-

- The default value for the "language-level" setting is "3". This setting specifies - the PostScript language level which should be used by FOP. Set this to "2" - only if you don't have a Level 3 capable interpreter. -

-

- The default value for the "optimize-resources" setting is "false". Setting it - to "true" will produce the PostScript file in two steps. A temporary file will be - written first which will then be processed to add only the fonts which were really - used and images are added to the stream only once as PostScript forms. This will - reduce file size but can potentially increase the memory needed in the interpreter - to process. -

-

- The default value for the "safe-set-page-device" setting is "false". Setting it - to "true" will cause the renderer to invoke a postscript macro which guards against - the possibility of invalid/unsupported postscript key/values being issued to the - implementing postscript page device. -

-

- The default value for the "dsc-compliant" setting is "true". Setting it - to "false" will break DSC compliance by minimizing the number of setpagedevice - calls in the postscript document output. This feature may be useful when unwanted - blank pages are experienced in your postscript output. This problem is caused by - the particular postscript implementation issuing unwanted postscript subsystem - initgraphics/erasepage calls on each setpagedevice call. -

-
-
- Limitations -
    -
  • Images and SVG may not be displayed correctly. SVG support is far from being complete. No image transparency is available.
    • -
  • Only Type 1 fonts are supported.
    • -
  • Multibyte characters are not supported.
    • -
  • PPD support is still missing.
    • -
-
-
-
- PCL -

- This format is for the Hewlett-Packard PCL printers and other printers - supporting PCL. It should produce output as close to identical as possible - to the printed output of the PDFRenderer within the limitations of the - renderer, and output device. -

-

- The output created by the PCLRenderer is generic PCL 5, HP GL/2 and PJL. - This should allow any device fully supporting PCL 5 to be able to - print the output generated by the PCLRenderer. PJL is used to control the - print job and switch to the PCL language. PCL 5 is used for text, raster - graphics and rectangular fill graphics. HP GL/2 is used for more complex - painting operations. Certain painting operations are done off-screen and - rendered to PCL as bitmaps because of limitations in PCL 5. -

-
- References - -
-
- Limitations -
    -
  • - Text or graphics outside the left or top of the printable area are not - rendered properly. This is a limitation of PCL, not FOP. In general, - things that should print to the left of the printable area are shifted - to the right so that they start at the left edge of the printable area. -
    • -
  • - The Helvetica and Times fonts are not well supported among PCL printers - so Helvetica is mapped to Arial and Times is mapped to Times New. This - is done in the PCLRenderer, no changes are required in the FO's. The - metrics and appearance for Helvetica/Arial and Times/Times New are - nearly identical, so this has not been a problem so far. -
    • -
  • For the non-symbol fonts, the ISO 8859-1 symbol set is used (PCL set "0N").
    • -
  • - All fonts available to the Java2D subsystem are usable. The texts are - painted as bitmap much like the Windows PCL drivers do. -
    • -
  • Multibyte characters are not supported.
    • -
  • - At the moment, only monochrome output is supported. PCL5c color extensions - will only be implemented on demand. Color and grayscale images are converted - to monochrome bitmaps (1-bit). Dithering only occurs if the JAI image library - is available. -
    • -
  • - Images are scaled up to the next resolution level supported by PCL (75, - 100, 150, 200, 300, 600 dpi). For color and grayscale images an even - higher PCL resolution is selected to give the dithering algorithm a chance - to improve the bitmap quality. -
    • -
  • - Currently, there's no support for clipping and image transparency, largely - because PCL 5 has certain limitations. -
    • -
-
-
- Configuration -

- The PCL renderer configuration currently allows the following settings: -

- - quality - bitmap - false -]]> -

- The default value for the "rendering" setting is "speed" which causes borders - to be painted as plain rectangles. In this mode, no special borders (dotted, - dashed etc.) are available. If you want support for all border modes, set the - value to "quality" as indicated above. This will cause the borders to be painted - as bitmaps. -

-

- The default value for the "text-rendering" setting is "auto" which paints the - base fonts using PCL fonts. Non-base fonts are painted as bitmaps through Java2D. - If the mix of painting methods results in unwelcome output, you can set this - to "bitmap" which causes all text to be rendered as bitmaps. -

-

- The default value for the "disable-pjl" setting is "false". This means that - the PCL renderer usually generates PJL commands before and after the document - in order to switch a printer into PCL language. PJL commands can be disabled - if you set this value to "true". -

-

- You can control the output resolution for the PCL using the "target resolution" - setting on the FOUserAgent. The actual value will be rounded up to the next - supported PCL resolution. Currently, only 300 and 600 dpi are supported which - should be enough for most use cases. Note that this setting directly affects - the size of the output file and the print quality. -

-
-
- Extensions -

The PCL Renderer supports some PCL specific extensions which can be embedded - into the input FO document. To use the extensions the appropriate namespace must - be declared in the fo:root element like this:

- -]]> -
- Page Source (Tray selection) -

- The page-source extension attribute on fo:simple-page-master allows to - select the paper tray the sheet for a particular simple-page-master is - to be taken from. Example: -

- - - ... - - -]]> -

- Note: the tray number is a positive integer and the value depends on - the target printer. Not all PCL printers support the same paper trays. - Usually, - "1" is the default tray, - "2" is the manual paper feed, - "3" is the manual envelope feed, - "4" is the "lower" tray and - "7" is "auto-select". - Consult the technical reference for your printer for all available values. -

-
-
-
-
- AFP - The AFP Renderer is a new addition (27-Apr-2006) to the sandbox and as such not yet fully tested or feature complete. -

- The FOP AFP Renderer deals with creating documents conforming to the IBM AFP document architecture - also refered to as MO:DCA (Mixed Object Document Content Architecture). -

-
- References - -
-
- Limitations -

This list is most likely badly incomplete.

-
    -
  • - Clipping of text and graphics is not supported. -
    • -
  • - Only IBM outline and raster fonts and to a limited extend the original fonts built into FOP are supported. - Support for TrueType fonts may be added later. -
    • -
-
-
- Configuration -
- Fonts -

The AFP Renderer requires special configuration particularly related to fonts. - AFP Render configuration is done through the normal FOP configuration file. The MIME type - for the AFP Renderer is application/x-afp which means the AFP Renderer section in the FOP configuration file - looks like:

- - - ... -]]> -

There are 3 font configuration variants supported:

-
    -
  1. IBM Raster fonts
    2. -
  2. IBM Outline fonts
    3. -
  3. FOP built-in Base14 fonts
    4. -
-

A typical raster font configuration looks like:

- - - - - - - - - - - - - - - - - - - - - - - - ]]> -

An outline font configuration is simpler as the individual font size entries are not required. - However, the characterset definition is now required within the afp-font element.

- - - - - - -]]> -

Experimentation has shown that the font metrics for the FOP built-in Base14 fonts are actually - very similar to some of the IBM outline and raster fonts. In cases were the IBM font files are not - available the path attribute in the afp-font element can be replaced by a base14-font attribute - giving the name of the matching Base14 font. In this case the AFP Renderer will take the - font metrics from the built-in font.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ]]> -
-
- Output Resolution -

By default the AFP Renderer creates output with a resolution of 240 dpi. - This can be overridden by the <renderer-resolution/> configuration element. Example:

- 240]]> -
-
- Images -

By default the AFP Renderer converts all images to 8 bit grey level. - This can be overridden by the <images> configuration element. Example:

- -]]> -

This will put images as RGB images into the AFP output stream. The default setting is:

- -]]> -

Only the values "color" and "b+w" are allowed for the mode attribute. The bits-per-pixel - attribute is ignored if mode is "color". For "b+w" mode is must be 1, 4, or 8.

-
-
-
- Extensions -

The AFP Renderer supports some AFP specific extensions which can be embedded into the input - fo document. To use the extensions the appropriate namespace must be declared in the fo:root element like this:

- -]]> -
- Page Overlay Extension -

The include-page-overlay extension element allows to define on a per simple-page-master basis a page overlay resource. Example:

- - - - ... - - -]]> -

The mandatory name attribute must refer to an 8 character (space padded) resource name that - must be known in the AFP processing environment.

-
-
- Page Segment Extension -

The include-page-segment extension element allows to define resource substitution for fo:external-graphics elements. - Example:

- - - - - - - -]]> -

The include-page-segment extension element can only occur within a simple-page-master. - Multiple include-page-segment extension elements within a simple-page-master are allowed. - The mandatory name attribute must refer to an 8 character - (space padded) resource name that must be known in the AFP processing environment. - The value of the mandatory src attribute is compared against the value of the src attribute in - fo:external-graphic elements and if it is identical (string matching is used) in the generated - AFP the external graphic is replaced by a reference to the given resource. -

-
-
- Tag Logical Element Extension -

The tag-logical-element extension element allows to injects TLEs into the AFP output stream. Example:

- - - - - - - -]]> -

The tag-logical-element extension element can only occur within a simple-page-master. - Multiple tag-logical-element extension elements within a simple-page-master are allowed. - The name and value attributes are mandatory. -

-
-
- No Operation Extension -

The no-operation extension provides the ability to carry up to 32K of comments or any other type - of unarchitected data into the AFP output stream. Example:

- - - - insert up to 32k of character data here! - - -]]> -

The no-operation extension element can only occur within a simple-page-master. - Multiple no-operation extension elements within a simple-page-master are allowed. - The name attribute is mandatory. -

-
-
-
-
- RTF -

- JFOR, an open source XSL-FO to RTF converter has been integrated into Apache FOP. - This will create an RTF (rich text format) document that will - attempt to contain as much information from the XSL-FO document as - possible. It should be noted that is not possible (due to RTF's limitations) to map all - XSL-FO features to RTF. For complex documents, the RTF output will never reach the feature - level from PDF, for example. Thus, using RTF output is only recommended for simple documents - such as letters. -

-

- The RTF output follows Microsoft's RTF specifications - and produces best results on Microsoft Word. -

- RTF output is currently unmaintained and lacks many features compared to other output - formats. Using other editable formats like Open Document Format, instead of producing XSL-FO - then RTF through FOP, might give better results. -

- These are some known restrictions compared to other supported output formats (not a complete list): -

-
    -
  • - Not supported/implemented: -
      -
    • break-before/after (supported by the RTF library but not tied into the RTFHandler)
      • -
    • fo:page-number-citation-last
      • -
    • keeps (supported by the RTF library but not tied into the RTFHandler)
      • -
    • region-start/end (RTF limitation)
      • -
    • multiple columns
      • -
    -
    • -
  • Only a single page-master is supported
    • -
  • Not all variations of fo:leader are supported (RTF limitation)
    • -
  • percentages are not supported everywhere
    • -
-
-
- XML (Area Tree XML) -

- This is primarily for testing and verification. The XML created is simply - a representation of the internal area tree put into XML. We use that to verify - the functionality of FOP's layout engine. -

-

- The other use case of the Area Tree XML is as FOP's "intermediate format". More information - on that can be found on the page dedicated to the Intermediate Format. -

-
-
- Java2D/AWT -

- The Java2DRenderer provides the basic functionality for all - Java2D-based output formats (AWT viewer, direct print, PNG, TIFF). -

-

- The AWT viewer shows a window with the pages displayed inside a - Java graphic. It displays one page at a time. - The fonts used for the formatting and viewing depend on the fonts - available to your JRE. -

-
-
- Print -

- It is possible to directly print the document from the command line. - This is done with the same code that renders to the Java2D/AWT renderer. -

- -
-
- Bitmap (TIFF/PNG) -

- It is possible to directly create bitmap images from the individual - pages generated by the layout engine. - This is done with the same code that renders to the Java2D/AWT renderer. -

-

- Currently, two output formats are supported: PNG and TIFF. TIFF produces - one file with multiple pages, while PNG output produces one file per - page. The quality of the bitmap depends on the target resolution setting - on the FOUserAgent. -

-
- Configuration -

- The TIFF and PNG renderer configuration currently allows the following settings: -

- - true - -]]> -

- The default value for the "transparent-page-background" setting is "false" which - paints an opaque, white background for the whole image. If you set this to true, - no such background will be painted and you will get a transparent image if - an alpha channel is available in the output format. -

-
-
- TIFF-specific Configuration -

- In addition to the above values the TIFF renderer configuration allows some additional - settings: -

- - true - CCITT T.6 - -]]> -

- The default value for the "compression" setting is "PackBits" which - which is a widely supported RLE compression scheme for TIFF. The set of compression - names to be used here matches the set that the Image I/O API uses. Note that - not all compression schemes may be available during runtime. This depends on the - actual codecs being available. Here is a list of possible values: -

-
    -
  • NONE (no compression)
    • -
  • PackBits (RLE, run-length encoding)
    • -
  • JPEG
    • -
  • Deflate
    • -
  • LZW
    • -
  • ZLib
    • -
  • CCITT T.4 (Fax Group 3)
    • -
  • CCITT T.6 (Fax Group 4)
    • -
- - If you want to use CCITT compression, please make sure you've got a J2SE 1.4 or later and - - Java Advanced Imaging Image I/O Tools - - in your classpath. The Sun JRE doesn't come with a TIFF codec built in, so it has to be - added separately. The internal TIFF codec from XML Graphics Commons only supports PackBits, - Deflate and JPEG compression for writing. - -
-
-
- TXT -

- The text renderer produces plain ASCII text output - that attempts to match the output of the PDFRenderer as closely as - possible. This was originally developed to accommodate an archive system - that could only accept plain text files, and is primarily useful for getting - a quick-and-dirty view of the document text. The renderer is very limited, - so do not be surprised if it gives unsatisfactory results. -

-

- The Text renderer works with a fixed size page buffer. The size of this - buffer is controlled with the textCPI and textLPI public variables. - The textCPI is the effective horizontal characters per inch to use. - The textLPI is the vertical lines per inch to use. From these values - and the page width and height the size of the buffer is calculated. - The formatting objects to be rendered are then mapped to this grid. - Graphic elements (lines, borders, etc) are assigned a lower priority - than text, so text will overwrite any graphic element representations. -

-

- Because FOP lays the text onto a grid during layout, there are frequently - extra or missing spaces between characters and lines, which is generally - unsatisfactory. - Users have reported that the optimal settings to avoid such spacing problems are: -

-
    -
  • font-family="Courier"
    • -
  • font-size="7.3pt"
    • -
  • line-height="10.5pt"
    • -
-
-
- Output Formats in the Sandbox -

- Due to the state of certain renderers we moved some of them to a "sandbox" area until - they are ready for more serious use. The renderers and FOEventHandlers in the sandbox - can be found under src/sandbox and are compiled into build/fop-sandbox.jar during the - main build. The output formats in the sandbox are marked as such below. -

-
- MIF - The MIF handler is in the sandbox and not yet functional in FOP Trunk!!! Please help us ressurrect this feature. -

- This format is the Maker Interchange Format which is used by - Adobe Framemaker. -

-
-
- SVG - The SVG renderer is in the sandbox and may not work as expected in FOP Trunk!!! Please help us improve this feature. -

- This format creates an SVG document that has links between the pages. - This is primarily for slides and creating svg images of pages. - Large documents will create SVG files that are far too large for - an SVG viewer to handle. Since FO documents usually have text the - SVG document will have a large number of text elements. - The font information for the text is obtained from the JVM in the - same way as for the AWT viewer. If the SVG is viewed on a - system where the fonts are different, such as another platform, - then the page may look wrong. -

-
-
-
- Wish list -

- Apache FOP is easily extensible and allows you to add new output formats to enhance FOP's functionality. There's a number of output formats - which are on our wish list. We're looking for volunteers to help us implement them. -

- -
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/pdfa.xml b/src/documentation/content/xdocs/0.95/pdfa.xml deleted file mode 100644 index e1d3f3010..000000000 --- a/src/documentation/content/xdocs/0.95/pdfa.xml +++ /dev/null @@ -1,156 +0,0 @@ - - - - - -
- Apache™ FOP: PDF/A (ISO 19005) - $Revision$ - - - -
- -
- Overview -

- PDF/A is a standard which turns PDF into an "electronic document file - format for long-term preservation". PDF/A-1 is the first part of the - standard and is documented in - ISO 19005-1:2005(E). - Work on PDF/A-2 is in progress at - AIIM. -

-

- Design documentation on PDF/A can be found on FOP's Wiki on the - PDFA1ConformanceNotes page. -

-
-
- Implementation Status -

- PDF/A-1b is implemented to the degree that FOP supports - the creation of the elements described in ISO 19005-1. -

-

- Tests have been performed against jHove and Adobe Acrobat 7.0.7 (Preflight function). - FOP does not validate completely against Apago's PDF Appraiser. Reasons unknown due to - lack of a full license to get a detailed error protocol. -

-

- PDF/A-1a is not implemented, yet. This is mostly because of the requirement - for tagged PDF which is not available in FOP, yet. -

-
-
- Usage (command line) -

- To activate PDF/A-1b from the command-line, specify "-pdfprofile PDF/A-1b" - as a parameter. If there is a violation of one of the validation rules for - PDF/A, an error message is presented and the processing stops. -

-
-
- Usage (embedded) -

- When FOP is embedded in another Java application you can set a special option - on the renderer options in the user agent to activate the PDF/A-1b profile. - Here's an example: -

- -

- If one of the validation rules of PDF/A is violated, an PDFConformanceException - (descendant of RuntimeException) is thrown. -

-
-
- PDF/A in Action -

- There are a number of things that must be looked after if you activate a PDF/A - profile. If you receive a PDFConformanceException, have a look at the following - list (not necessarily comprehensive): -

-
    -
  • - Make sure all (!) fonts are embedded. If you use base 14 fonts (like Helvetica) - you need to obtain a license for them and embed them like any other font. -
    • -
  • - Don't use PDF encryption. PDF/A doesn't allow it. -
    • -
  • - Don't use CMYK images without an ICC color profile. PDF/A doesn't allow mixing - color spaces and FOP currently only properly supports the sRGB color space. Please - note that FOP embeds a standard sRGB ICC profile (sRGB IEC61966-2.1) as the - primary output intent for the PDF if no other output intent has been specified - in the configuration. -
    • -
  • - Don't use non-RGB colors in SVG images. Same issue as with CMYK images. -
    • -
  • - Don't use EPS graphics with fo:external-graphic. Embedding EPS graphics in PDF - is deprecated since PDF 1.4 and prohibited by PDF/A. -
    • -
  • - PDF is forced to version 1.4 if PDF/A-1 is activated. -
    • -
  • - No filter must be specified explicitely for metadata objects. Metadata must be - embedded in clear text so non-PDF-aware applications can extract the XMP metadata. -
    • -
-
-
- PDF profile compatibility -

- The PDF profiles "PDF/X-3:2003" and "PDF/A-1b" are compatible and can both be - activated at the same time. -

-
-
- Interoperability -

- There has been some confusion about the namespace for the PDF/A indicator in the XMP - metadata. At least three variants have been seen in the wild: -

- - - - - - - - - - - - - -
http://www.aiim.org/pdfa/ns/id.htmlobsolete, from an early draft of ISO-19005-1, used by Adobe Acrobat 7.x
http://www.aiim.org/pdfa/ns/idobsolete, found in the original ISO 19005-1:2005 document
http://www.aiim.org/pdfa/ns/id/correct, found in the technical corrigendum 1 of ISO 19005-1:2005
-

- If you get an error validating a PDF/A file in Adobe Acrobat 7.x it doesn't mean that - FOP did something wrong. It's Acrobat that is at fault. This is fixed in Adobe Acrobat 8.x - which uses the correct namespace as described in the technical corrigendum 1. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/pdfencryption.xml b/src/documentation/content/xdocs/0.95/pdfencryption.xml deleted file mode 100644 index e743f5fff..000000000 --- a/src/documentation/content/xdocs/0.95/pdfencryption.xml +++ /dev/null @@ -1,225 +0,0 @@ - - - - - -
- Apache™ FOP: PDF encryption. - $Revision$ - - - - -
- -
- Overview -

- Apache™ FOP supports encryption of PDF output, thanks to Patrick - C. Lankswert. This feature is commonly used to prevent - unauthorized viewing, printing, editing, copying text from the - document and doing annotations. It is also possible to ask the - user for a password in order to view the contents. Note that - there already exist third party applications which can decrypt - an encrypted PDF without effort and allow the aforementioned - operations, therefore the degree of protection is limited. -

-

- For further information about features and restrictions regarding PDF - encryption, look at the documentation coming with Adobe Acrobat or the - technical documentation on the Adobe web site. -

-
-
- Usage (command line) -

- Encryption is enabled by supplying any of the encryption related - options. -

-

- An owner password is set with the -o option. This - password is actually used as encryption key. Many tools for - PDF processing ask for this password to disregard any - restriction imposed on the PDF document. -

-

- If no owner password has been supplied but FOP was asked to apply some - restrictions, a random password is used. In this case it is obviously - impossiible to disregard restrictions in PDF processing tools. -

-

- A user password, supplied with the -u option, will - cause the PDF display software to ask the reader for this password in - order to view the contents of the document. If no user password was - supplied, viewing the content is not restricted. -

-

- Further restrictions can be imposed by using the -noprint, - -nocopy, -noedit and - -noannotations options, which disable printing, copying - text, editing in Adobe Acrobat and making annotations, respectively. -

-
-
- Usage (embedded) -

- When FOP is embedded in another Java application you need to set an - options map on the renderer. These are the supported options: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OptionDescriptionValuesDefault
ownerPasswordThe owner passwordString -
userPasswordThe user passwordString -
allowPrintAllows/disallows printing of the PDF"TRUE" or "FALSE""TRUE"
allowCopyContentAllows/disallows copy/paste of content"TRUE" or "FALSE""TRUE"
allowEditContentAllows/disallows editing of content"TRUE" or "FALSE""TRUE"
allowEditAnnotationsAllows/disallows editing of annotations"TRUE" or "FALSE""TRUE"
- - Encryption is enabled as soon as one of these options is set. - -

- An example to enable PDF encryption in Java code: -

- -

- The parameters for the constructor of PDFEncryptionParams are: -

-
    -
  1. userPassword: String, may be null
    2. -
  2. ownerPassword: String, may be null
    3. -
  3. allowPrint: true if printing is allowed
    4. -
  4. allowCopyContent: true if copying content is allowed
    5. -
  5. allowEditContent: true if editing content is allowed
    6. -
  6. allowEditAnnotations: true if editing annotations is allowed
    7. -
-

- Alternatively, you can set each value separately in the Map provided by - FOUserAgent.getRendererOptions() by using the following keys: -

-
    -
  1. user-password: String
    2. -
  2. owner-password: String
    3. -
  3. noprint: Boolean or "true"/"false"
    4. -
  4. nocopy: Boolean or "true"/"false"
    5. -
  5. noedit: Boolean or "true"/"false"
    6. -
  6. noannotations: Boolean or "true"/"false"
    7. -
-
-
- Environment -

- In order to use PDF encryption, FOP has to be compiled with - cryptography support. Currently, only JCE - is supported. JCE is part of JDK 1.4. For earlier JDKs, it can - be installed separately. The build process automatically - detects JCE presence and installs PDF encryption support if - possible, otherwise a stub is compiled in. -

-

- Cryptography support must also be present at run time. In particular, a - provider for the RC4 cipher is needed. Unfortunately, the sample JCE - provider in Sun's JDK 1.4 does not provide RC4. If you - get a message saying -

- "Cannot find any provider supporting RC4" -

- then you don't have the needed infrastructure. -

-

- There are several commercial and a few Open Source packages which - provide RC4. A pure Java implementation is produced by The Legion of the Bouncy - Castle. Mozilla - JSS is an interface to a native implementation. -

-
-
- Installing a crypto provider -

- The pure Java implementation from Bouncy Castle is easy to - install. -

-
    -
  1. - Unpack the distribution. Add the jar file to your classpath. A - convenient way to use the jar on Linux is to simply drop it into the - FOP lib directory, it will be automatically picked up by - fop.sh. -
    2. -
  2. - Open the java.security file and add
    - security.provider.6=org.bouncycastle.jce.provider.BouncyCastleProvider,
    - preferably at the end of the block defining the other crypto - providers. For JDK 1.4 this is detailed on Sun's web site. -
    3. -
-

- If you have any experience with Mozilla JSS or any other - cryptography provider, please post it to the fop-user list. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/pdfx.xml b/src/documentation/content/xdocs/0.95/pdfx.xml deleted file mode 100644 index bef2fce2a..000000000 --- a/src/documentation/content/xdocs/0.95/pdfx.xml +++ /dev/null @@ -1,136 +0,0 @@ - - - - - -
- Apache™ FOP: PDF/X (ISO 15930) - $Revision$ - - - -
- -
- Overview - - Support for PDF/X is available beginning with version 0.93. This feature is new and - may not be 100% complete, yet. Feedback is welcome. - -

- PDF/X is a standard which faciliates prepress digital data exchange using PDF. - Currently, only PDF/X-3:2003 is implemented out of the many different flavours of PDF/X - profiles. PDF/X-3:2003 is documented in - ISO 15930-6:2003(E). - More info on PDF/X can be found on the - PDF/X info site. -

-
-
- Implementation Status -

- PDF/X-3:2003 is implemented to the degree that FOP supports - the creation of the elements described in ISO 15930-6. -

-

- An important restriction of the current implementation is that all normal - RGB colors specified in XSL-FO and SVG are left unchanged in the sRGB color - space (XSL-FO and SVG both use sRGB as their default color space). - There's no conversion to a CMYK color space. Although sRGB is a - calibrated color space, its color space has a different size than a CMYK - color space which makes the conversion a lossy conversion and can lead to - unwanted results. Although the use of the calibrated sRGB has been promoted - for years, print shops usually prefer to convert an sRGB PDF to CMYK prior - to production. Until there's full CMYK support in FOP you will have to - work closely with your print service provider to make sure you get the - intended result. -

-

- Tests have been performed against Adobe Acrobat 7.0.7 (Preflight function). - Note that there are bugs in Adobe Acrobat which cause false alarms if both - PDF/A-1b and PDF/X-3:2003 are activated at the same time. -

-
-
- Usage (command line) -

- To activate PDF/X-3:2003 from the command-line, specify "-pdfprofile PDF/X-3:2003" - as a parameter. If there is a violation of one of the validation rules for - PDF/X, an error message is presented and the processing stops. -

-
-
- Usage (embedded) -

- When FOP is embedded in another Java application you can set a special option - on the renderer options in the user agent to activate the PDF/A-1b profile. - Here's an example: -

- -

- If one of the validation rules of PDF/X is violated, an PDFConformanceException - (descendant of RuntimeException) is thrown. -

-
-
- PDF/X in Action -

- There are a number of things that must be looked after if you activate a PDF/X - profile. If you receive a PDFConformanceException, have a look at the following - list (not necessarily comprehensive): -

-
    -
  • - Make sure all (!) fonts are embedded. If you use base 14 fonts (like Helvetica) - you need to obtain a license for them and embed them like any other font. -
    • -
  • - Don't use PDF encryption. PDF/X doesn't allow it. -
    • -
  • - Don't use CMYK images without an ICC color profile. PDF/X doesn't allow mixing - color spaces and FOP currently only properly supports the sRGB color space. However, - you will need to specify an - output device profile - (usually a CMYK profile) in the configuration. sRGB won't work here since it's a - display device profile, not an output device profile. -
    • -
  • - Don't use non-RGB colors in SVG images. Same issue as with CMYK images. -
    • -
  • - Don't use EPS graphics with fo:external-graphic. Embedding EPS graphics in PDF - is deprecated since PDF 1.4 and prohibited by PDF/X-3:2003. -
    • -
  • - PDF is forced to version 1.4 if PDF/X-3:2003 is activated. -
    • -
-
-
- PDF profile compatibility -

- The PDF profiles "PDF/X-3:2003" and "PDF/A-1b" are compatible and can both be - activated at the same time. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/running.xml b/src/documentation/content/xdocs/0.95/running.xml deleted file mode 100644 index 26a9596c0..000000000 --- a/src/documentation/content/xdocs/0.95/running.xml +++ /dev/null @@ -1,350 +0,0 @@ - - - - - -
- Running Apache™ FOP - $Revision$ -
- - -
- System Requirements -

The following software must be installed:

-
    -
  • - Java 1.4.x or later Runtime Environment. -
      -
    • - Many JREs >=1.4 contain older JAXP implementations (which often contain bugs). It's - usually a good idea to replace them with a current implementation. -
      • -
    -
    • -
  • - Apache™ FOP. The FOP distribution includes all libraries that you will - need to run a basic FOP installation. These can be found in the [fop-root]/lib directory. These - libraries include the following: - -
    • -
-

The following software is optional, depending on your needs:

-
    -
  • - Graphics libraries. Generally, FOP contains direct support for the most important - bitmap image formats (including PNG, JPEG and GIF). See - FOP: Graphics Formats for details. -
    • -
  • - PDF encryption. See FOP: PDF Encryption for details. -
    • -
-

In addition, the following system requirements apply:

-
    -
  • - If you will be using FOP to process SVG, you must do so in a graphical environment. - See FOP: Graphics (Batik) for details. -
    • -
-
-
- Installation -
- Instructions -

- Basic FOP installation consists of first unzipping the .gz file that is the - distribution medium, then unarchiving the resulting .tar file in a - directory/folder that is convenient on your system. Please consult your operating system - documentation or Zip application software documentation for instructions specific to your - site. -

-
-
- Problems -

- Some Mac OSX users have experienced filename truncation problems using Stuffit to unzip - and unarchive their distribution media. This is a legacy of older Mac operating systems, - which had a 31-character pathname limit. Several Mac OSX users have recommended that - Mac OSX users use the shell command tar -xzf instead. -

-
-
-
- Starting FOP as a Standalone Application -
- Using the fop script or batch file -

- The usual and recommended practice for starting FOP from the command line is to run the - batch file fop.bat (Windows) or the shell script fop (Unix/Linux). - These scripts require that the environment variable JAVA_HOME be - set to a path pointing to the appropriate Java installation on your system. Macintosh OSX - includes a Java environment as part of its distribution. We are told by Mac OSX users that - the path to use in this case is /Library/Java/Home. Caveat: - We suspect that, as Apple releases new Java environments and as FOP upgrades the minimum - Java requirements, the two will inevitably not match on some systems. Please see - Java on Mac OSX FAQ for information as - it becomes available. -

- - [OPTIONS] - -d debug mode - -x dump configuration settings - -q quiet mode - -c cfg.xml use additional configuration file cfg.xml - -l lang the language to use for user information - -r relaxed/less strict validation (where available) - -dpi xxx target resolution in dots per inch (dpi) where xxx is a number - -s for area tree XML, down to block areas only - -v to show FOP version being used - - -o [password] PDF file will be encrypted with option owner password - -u [password] PDF file will be encrypted with option user password - -noprint PDF file will be encrypted without printing permission - -nocopy PDF file will be encrypted without copy content permission - -noedit PDF file will be encrypted without edit content permission - -noannotations PDF file will be encrypted without edit annotation permission - -pdfprofile prof PDF file will be generated with the specified profile - (Examples for prof: PDF/A-1b or PDF/X-3:2003) - - [INPUT] - infile xsl:fo input file (the same as the next) - -fo infile xsl:fo input file - -xml infile xml input file, must be used together with -xsl - -atin infile area tree input file - -xsl stylesheet xslt stylesheet - - -param name value to use for parameter in xslt stylesheet - (repeat '-param name value' for each parameter) - - [OUTPUT] - outfile input will be rendered as PDF into outfile - -pdf outfile input will be rendered as PDF (outfile req'd) - -pdfa1b outfile input will be rendered as PDF/A-1b compliant PDF - (outfile req'd, same as "-pdf outfile -pdfprofile PDF/A-1b") - -awt input will be displayed on screen - -rtf outfile input will be rendered as RTF (outfile req'd) - -pcl outfile input will be rendered as PCL (outfile req'd) - -ps outfile input will be rendered as PostScript (outfile req'd) - -afp outfile input will be rendered as AFP (outfile req'd) - -tiff outfile input will be rendered as TIFF (outfile req'd) - -png outfile input will be rendered as PNG (outfile req'd) - -txt outfile input will be rendered as plain text (outfile req'd) - -at [mime] out representation of area tree as XML (outfile req'd) - specify optional mime output to allow AT to be converted - to final format later - -print input file will be rendered and sent to the printer - see options with "-print help" - -out mime outfile input will be rendered using the given MIME type - (outfile req'd) Example: "-out application/pdf D:\out.pdf" - (Tip: "-out list" prints the list of supported MIME types) - -mif outfile input will be rendered as MIF (FrameMaker) (outfile req'd) - Experimental feature - requires additional fop-sandbox.jar. - -svg outfile input will be rendered as an SVG slides file (outfile req'd) - Experimental feature - requires additional fop-sandbox.jar. - - -foout outfile input will only be XSL transformed. The intermediate - XSL-FO file is saved and no rendering is performed. - (Only available if you use -xml and -xsl parameters) - - - [Examples] - Fop foo.fo foo.pdf - Fop -fo foo.fo -pdf foo.pdf (does the same as the previous line) - Fop -xml foo.xml -xsl foo.xsl -pdf foo.pdf - Fop -xml foo.xml -xsl foo.xsl -foout foo.fo - Fop foo.fo -mif foo.mif - Fop foo.fo -rtf foo.rtf - Fop foo.fo -print or Fop -print foo.fo - Fop foo.fo -awt]]> -

- PDF encryption is only available if FOP was compiled with encryption support - and if compatible encryption support is available at run time. - Currently, only the JCE is supported. Check the Details. -

-
-
- Writing your own script -

FOP's entry point for your own scripts is the class -org.apache.fop.cli.Main. The general pattern for the - command line is: java -classpath <CLASSPATH> - org.apache.fop.cli.Main <arguments>. The arguments - consist of the options and infile and outfile specifications - as shown above for the standard scripts. You may wish to review - the standard scripts to make sure that - you get your environment properly configured. -

-
-
- Running with java's <code>-jar</code> option -

- As an alternative to the start scripts you can run java - -jar path/to/build/fop.jar <arguments>, relying on - FOP to build the classpath for running FOP dynamically, see below. If you use hyphenation, - you must put fop-hyph.jar in the lib - directory. -

- -

You can also run java -jar path/to/fop.jar - <arguments>, relying on the Class-Path - entry in the manifest file. This works if you put - fop.jar and all jar files from the lib - directory in a single directory. If you use hyphenation, you - must also put fop-hyph.jar in that directory.

- -

In both cases the arguments consist of the options and - infile and outfile specifications as shown above for the - standard scripts.

-
-
- FOP's dynamical classpath construction - -

If FOP is started without a proper classpath, it tries to - add its dependencies dynamically. If the system property - fop.home contains the name of a directory, then - FOP uses that directory as the base directory for its - search. Otherwise the current working directory is the base - directory. If the base directory is called build, - then its parent directory becomes the base directory.

- -

FOP expects to find fop.jar in the - build subdirectory of the base directory, and - adds it to the classpath. Subsequently FOP adds all - jar files in the lib directory to the - classpath. The lib directory is either the lib - subdirectory of the base directory, or, if that does not - exist, the base directory itself.

- -

If the system property fop.optional.lib - contains the name of a directory, then all jar - files in that directory are also added to the classpath. See - the methods getJARList and - checkDependencies in - org.apache.fop.cli.Main.

- -
-
-
- Using Xalan to Check XSL-FO Input -

- FOP sessions that use -xml and -xsl input instead of -fo input are actually - controlling two distinct conversions: Tranforming XML to XSL-FO, then formatting - the XSL-FO to PDF (or another FOP output format). - Although FOP controls both of these processes, the first is included merely as - a convenience and for performance reasons. - Only the second is part of FOP's core processing. - If a user has a problem running FOP, it is important to determine which of these - two processes is causing the problem. - If the problem is in the first process, the user's stylesheet is likely the cause. - The FOP development team does not have resources to help with stylesheet issues, - although we have included links to some useful - Specifications and - Books/Articles. - If the problem is in the second process, FOP may have a bug or an unimplemented - feature that does require attention from the FOP development team. -

- The user is always responsible to provide correct XSL-FO code to FOP. -

- In the case of using -xml and -xsl input, although the user is responsible for - the XSL-FO code that is FOP's input, it is not visible to the user. To make the - intermediate FO file visible, the FOP distribution includes the "-foout" option - which causes FOP to run only the first (transformation) step, and write the - results to a file. (See also the Xalan command-line below) -

- - When asking for help on the FOP mailing lists, never attach XML and - XSL to illustrate the issue. Always run the XSLT step (-foout) and send the - resulting XSL-FO file instead. Of course, be sure that the XSL-FO file is - correct before sending it. - -

- The -foout option works the same way as if you would call the - Xalan command-line: -

-

- java org.apache.xalan.xslt.Process -IN xmlfile -XSL file -OUT outfile -

-

- Note that there are some subtle differences between the FOP and Xalan command-lines. -

-
-
- Memory Usage -

- FOP can consume quite a bit of memory, even though this has been continually improved. - This is partly inherent to the formatting process and partly caused by implementation choices. - All FO processors currently on the market have memory problems with certain layouts. -

-

- If you are running out of memory when using FOP, here are some ideas that may help: -

-
    -
  • - Increase memory available to the JVM. See - the -Xmx option - for more information. - - It is usually unwise to increase the memory allocated to the JVM beyond the amount of - physical RAM, as this will generally cause significantly slower performance. - -
    • -
  • - Avoid forward references. - Forward references are references to some later part of a document. - Examples include page number citations which refer to pages which follow the citation, - tables of contents at the beginning of a document, and page numbering schemes that - include the total number of pages in the document - ("page N of TOTAL"). - Forward references cause all subsequent pages to be held in memory until the reference - can be resolved, i.e. until the page with the referenced element is encountered. - Forward references may be required by the task, but if you are getting a memory - overflow, at least consider the possibility of eliminating them. - A table of contents could be replaced by PDF bookmarks instead or moved to the end of - the document (reshuffle the paper could after printing). -
    • -
  • - Avoid large images, especially if they are scaled down. - If they need to be scaled, scale them in another application upstream from FOP. - For many image formats, memory consumption is driven mainly by the size of the image - file itself, not its dimensions (width*height), so increasing the compression rate - may help. -
    • -
  • - Use multiple page sequences. - FOP starts rendering after the end of a page sequence is encountered. - While the actual rendering is done page-by-page, some additional memory is - freed after the page sequence has been rendered. - This can be substantial if the page sequence contains lots of FO elements. -
    • -
-
-
- Problems -

If you have problems running FOP, please see the "How to get Help" page.

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/servlets.xml b/src/documentation/content/xdocs/0.95/servlets.xml deleted file mode 100644 index 807f19f98..000000000 --- a/src/documentation/content/xdocs/0.95/servlets.xml +++ /dev/null @@ -1,325 +0,0 @@ - - - - - -
- Apache™ FOP: Servlets - How to use Apache� FOP in a Servlet - $Revision$ -
- -
- Overview -

- This page discusses topic all around using Apache™ FOP in a servlet environment. -

-
-
- Example Servlets in the FOP distribution -

- In the directory {fop-dir}/src/java/org/apache/fop/servlet, you'll find a working example - of a FOP-enabled servlet. -

-

- The servlet is automatically built when you build Apache FOP using the supplied Ant script. After building - the servlet, drop fop.war into the webapps directory of Apache Tomcat (or any other web container). Then, you can use - URLs like the following to generate PDF files: -

-
    -
  • http://localhost:8080/fop/fop?fo=/home/path/to/fofile.fo
    • -
  • http://localhost:8080/fop/fop?xml=/home/path/to/xmlfile.xml&xsl=/home/path/to/xslfile.xsl
    • -
-

-

The source code for the servlet can be found under {fop-dir}/src/java/org/apache/fop/servlet/FopServlet.java.

- - This example servlet should not be used on a public web server connected to the Internet as it does not contain - any measures to prevent Denial-of-Service-Attacks. It is provided as an example and as a starting point for - your own servlet. - -
-
- Create your own Servlet - - This section assumes you are familiar with embedding FOP. - -
- A minimal Servlet -

- Here is a minimal code snippet to demonstrate the basics: -

- private FopFactory fopFactory = FopFactory.newInstance(); -private TransformerFactory tFactory = TransformerFactory.newInstance(); - -public void doGet(HttpServletRequest request, - HttpServletResponse response) throws ServletException { - try { - response.setContentType("application/pdf"); - Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, response.getOutputStream()); - Transformer transformer = tFactory.newTransformer(); - Source src = new StreamSource("foo.fo"); - Result res = new SAXResult(fop.getDefaultHandler()); - transformer.transform(src, res); - } catch (Exception ex) { - throw new ServletException(ex); - } -} - - There are numerous problems with the code snippet above. - Its purpose is only to demonstrate the basic concepts. - See below for details. - -
-
- Adding XSL tranformation (XSLT) -

- A common requirement is to transform an XML source to - XSL-FO using an XSL transformation. It is recommended to use - JAXP for this task. The following snippet shows the basic - code: -

- private FopFactory fopFactory = FopFactory.newInstance(); -private TransformerFactory tFactory = TransformerFactory.newInstance(); - -public void init() throws ServletException { - //Optionally customize the FopFactory and TransformerFactory here -} - -[..] - - //Setup a buffer to obtain the content length - ByteArrayOutputStream out = new ByteArrayOutputStream(); - - //Setup FOP - Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, out); - - //Setup Transformer - Source xsltSrc = new StreamSource(new File("foo-xml2fo.xsl")); - Transformer transformer = tFactory.newTransformer(xsltSrc); - - //Make sure the XSL transformation's result is piped through to FOP - Result res = new SAXResult(fop.getDefaultHandler()); - - //Setup input - Source src = new StreamSource(new File("foo.xml")); - - //Start the transformation and rendering process - transformer.transform(src, res); - - //Prepare response - response.setContentType("application/pdf"); - response.setContentLength(out.size()); - - //Send content to Browser - response.getOutputStream().write(out.toByteArray()); - response.getOutputStream().flush(); - - Buffering the generated PDF in a ByteArrayOutputStream is done to avoid potential - problems with the Acrobat Reader Plug-in in Microsoft Internet Explorer. - -

- The Source instance used above is simply an - example. If you have to read the XML from a string, supply - a new StreamSource(new - StringReader(xmlstring)). Constructing and reparsing - an XML string is generally less desirable than using a - SAXSource if you generate your XML. You can alternatively - supply a DOMSource as well. You may also use dynamically - generated XSL if you like. -

-

- Because you have an explicit Transformer object, you can also use it to - explicitely set parameters for the transformation run. -

-
-
- Custom configuration -

- You can easily set up your own FOUserAgent as demonstrated on the Embedding page. -

-
-
- Improving performance -

- There are several options to consider: -

-
    -
  • - Instead of java.io.ByteArrayOutputStream consider using the ByteArrayOutputStream - implementation from the Jakarta Commons IO project which allocates less memory. - The full class name is: org.apache.commons.io.output.ByteArrayOutputStream -
    • -
  • - In certain cases it can help to write the generated PDF to a temporary file so - you can quickly reuse the file. This is especially useful, if Internet Explorer - calls the servlet multiple times with the same request or if you often generate - equal PDFs. -
    • -
-

- Of course, the - performance hints from the Embedding page - apply here, too. -

-
-
- Accessing resources in your web application -

- Often, you will want to use resources (stylesheets, images etc.) which are bundled with - your web application. FOP provides a URIResolver implementation that lets you access - files via the Servlet's ServletContext. The class is called - org.apache.fop.servlet.ServletContextURIResolver. -

-

- Here's how to set it up in your servlet. Instantiate a new instance in the servlet's - init() method: -

- -

- The ServletContextURIResolver reacts on URIs beginning with "servlet-context:". If you - want to access an image in a subdirectory of your web application, you could, for - example, use: "servlet-context:/images/myimage.png". Don't forget the leading slash - after the colon! -

-

- Further down, you can use the URIResolver for various things: -

-
    -
  • - With the Transformer (JAXP/XSLT) so things like document() functions can resolver - "servlet-context:" URIs. -
    • -
  • - With the FopFactory so every resource FOP loads can be loaded using a "servlet-context:" - URI. -
    • -
  • - You can the ServletContextURIResolver yourself in your servlet code to access - stylesheets or XML files bundled with your web application. -
    • -
-

- Here are some example snippets: -

- -
-
-
- Notes on Microsoft Internet Explorer -

- Some versions of Internet Explorer will not automatically show the PDF or call the servlet multiple times. - These are well-known limitations of Internet Explorer and are not a problem of the servlet. - However, Internet Explorer can still be used to download the PDF so that it can be viewed later. - Here are some suggestions in this context: -

-
    -
  • - Use an URL ending in .pdf, like - http://myserver/servlet/stuff.pdf. Yes, the servlet can - be configured to handle this. If the URL has to contain parameters, - try to have both the base URL as well as the last parameter end in - .pdf, if necessary append a dummy parameter, like - http://myserver/servlet/stuff.pdf?par1=a&par2=b&d=.pdf. The - effect may depend on IEx version. -
    • -
  • - Give IEx the opportunity to cache. In particular, ensure the - server does not set any headers causing IEx not to cache the - content. This may be a real problem if the document is sent - over HTTPS, because most IEx installations will by default - not cache any content retrieved over HTTPS. - Setting the Expires header entry may help in - this case:
    response.setDateHeader("Expires", - System.currentTimeMillis() + cacheExpiringDuration * - 1000);
    Consult your server manual and the - relevant RFCs for further details on HTTP headers and - caching. -
    • -
  • - Cache in the server. It may help to include a parameter in - the URL which has a timestamp as the value min order to - decide whether a request is repeated. IEx is reported to - retrieve a document up to three times, but never more often. -
    • -
-
-
- Servlet Engines -

- When using a servlet engine, there are potential CLASSPATH issues, and potential conflicts - with existing XML/XSLT libraries. Servlet containers also often use their own classloaders - for loading webapps, which can cause bugs and security problems. -

-
- Tomcat -

- Check Tomcat's documentation for detailed instructions about installing FOP and Cocoon. - There are known bugs that must be addressed, particularly for Tomcat 4.0.3. -

-
-
- WebSphere 3.5 -

- Put a copy of a working parser in some directory where WebSphere can access it. - For example, if /usr/webapps/yourapp/servlets is the CLASSPATH for your servlets, - copy the Xerces jar into it (any other directory would also be fine). - Do not add the jar to the servlet CLASSPATH, but add it to the CLASSPATH of the - application server which contains your web application. - In the WebSphere administration console, click on the "environment" button in the - "general" tab. In the "variable name" box, enter "CLASSPATH". - In the "value" box, enter the correct path to the parser jar file - (/usr/webapps/yourapp/servlets/Xerces.jar in our example here). - Press "OK", then apply the change and restart the application server. -

-
-
-
- Handling complex use cases -

- Sometimes the requirements for a servlet get quite sophisticated: SQL data sources, - multiple XSL transformations, merging of several datasources etc. In such a case - consider using Apache Cocoon instead - of a custom servlet to accomplish your goal. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/0.95/upgrading.xml b/src/documentation/content/xdocs/0.95/upgrading.xml deleted file mode 100644 index 3ed062e9c..000000000 --- a/src/documentation/content/xdocs/0.95/upgrading.xml +++ /dev/null @@ -1,126 +0,0 @@ - - - - - -
- Upgrading from an Earlier Version of Apache™ FOP - $Revision$ -
- -
- Important! -

- If you're planning to upgrade to the latest Apache™ FOP version there are a few very important things - to consider: -

-
    -
  • - More than half of the codebase has been rewritten over the - last four years. With version 0.93 the code has reached - production level, and continues to improve with - version 0.94 and 0.95. -
    • -
  • - The API of FOP has changed considerably and is not - backwards-compatible with versions 0.20.5 and - 0.91beta. Version 0.92 introduced the new stable - API. -
    • -
  • - Since version 0.92 some deprecated methods which were part - of the old API have been removed. If you upgrade from 0.91 - beta, you will need to adjust your Java code. Similarly if - you upgrade from 0.92 and use deprecated methods. -
    • -
  • - If you are using a configuration file for version 0.20.5, you have to rebuild it in the new format. The format - of the configuration files has changed since version 0.20.5. See conf/fop.xconf for - an example configuration file. A XML Schema file can be found under - src/foschema/fop-configuration.xsd. -
    • -
  • - Beginning with version 0.94 you can skip the generation of - font metric files and remove the "font-metrics" attribute - in the font configuration. The font metrics files are, for - the moment, still required if you use a TrueType Collection (*.ttc) - and in that case you need to regenerate the font metrics file - if yours are from a FOP version before 0.93. -
    • -
  • -

    - The new code is much more strict about the interpretation of the XSL-FO 1.1 specification. - Things that worked fine in version 0.20.5 might start to produce warnings or even errors - now. FOP 0.20.5 contains many bugs which have been corrected in the new code. -

    - - While FOP 0.20.5 allowed you to have empty fo:table-cell elements, the new code - will complain about that (unless relaxed validation is enabled) because the specification - demands at least one block-level element ((%block;)+, see - XSL-FO 1.1, 6.7.10) - inside an fo:table-cell element. - -
    • -
  • - Extensions and Renderers written for version 0.20.5 will not work with the new code! The new FOP - extension for Barcode4J is available since - January 2007. -
    • -
  • - The SVG Renderer and the MIF Handler have not been resurrected, yet! They are currently non-functional - and hope for someone to step up and reimplement them. -
    • -
-
-
- What you need to know when you upgrade! -

- When you use your existing FO files or XML/XSL files which work fine with FOP version - 0.20.5 against this FOP version some things may not work as expected. The following - list will hopefully help you to identify and correct those problems. This does not mean - that the new FOP is at fault. Quite the opposite actually! See below: -

-
    -
  • - Check the Compliance page for the feature causing - trouble. It may contain the necessary information to understand and resolve the problem. -
    • -
  • - As stated above empty table cells <fo:table-cell></fo:table-cell> - are not allowed by the specification. The same applies to empty static-content - and block-container elements, for example. -
    • -
  • - 0.20.5 is not XSL-FO compliant with respect to sizing images (external-graphic) - or instream-foreign-object - objects. If images or SVGs are sized differently in your outputs with the new FOP version - check Bug 37136 - as it contains some hints on what to do. The file - - "examples/fo/basic/images.fo" has - a number of good examples that show the new, more correct behaviour. -
    • -
  • - The fox:outline extension is not implemented in this version anymore. - It has been superseded by the new bookmark elements from XSL-FO 1.1. So please - update your stylesheets accordingly. -
    • -
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/accessibility.xml b/src/documentation/content/xdocs/1.0/accessibility.xml deleted file mode 100644 index 412519d8b..000000000 --- a/src/documentation/content/xdocs/1.0/accessibility.xml +++ /dev/null @@ -1,167 +0,0 @@ - - - - - -
- Apache™ FOP: Accessibility -
- -
- Overview -

- This page describes the - accessibility - features of Apache™ FOP. - Section 508 defines accessibility in the context - of electronic documents for the USA but other countries have similar requirements. -

-

- 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. -

-
-
- Enabling accessibility -

There are 3 ways to enable accessibility:

-
    -
  1. - Command line: The command line option -a turns on accessibility: - fop -a -fo mydocument.fo -pdf mydocument.pdf -
    2. -
  2. - Embedding: userAgent.setAccessibility(true); -
    3. -
  3. - Optional setting in fop.xconf file: - 
    -          <fop version="1.0">
-              <accessibility>true</accessibility>
-              ...
-          </fop>
-
    -
    4. -
-

- 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. -

- 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 in order to generate really accessible documents: -

-
    -
  • Table cells must have a table row as their parent.
    • -
  • - Images must have an alternate text: use the fox:alt-text extension attribute - (in the fox namespace) on - fo:external-graphic and fo:instream-foreign-object to specify a - short text describing the image. -
    • -
  • - Ensure that the order of fo:block-container elements in a page corresponds to - the reading order. -
    • -
  • - Specify the natural language of the document using the language and country properties - (or via the xml:lang shorthand property). -
    • -
-
-
- Customized Tagging -

The PDF Reference defines a set of standard Structure Types to - tag content. For example, ‘P’ is used for identifying paragraphs, ‘H1’ to ‘H6’ for headers, - ‘L’ for lists, ‘Div’ for block-level groups of elements, etc. This standard set is aimed at - improving interoperability between applications producing or consuming PDF.

-

FOP provides a default mapping of Formatting Objects to elements from that standard set. - For example, fo:page-sequence is mapped to ‘Part’, fo:block is - mapped to ‘P’, fo:list-block to ‘L’, etc.

-

You may want to customize that mapping to improve the accuracy of the tagging or deal with - particular FO constructs. For example, you may want to make use of the ‘H1’ to ‘H6’ tags to - make the hierarchical structure of the document appear in the PDF. This is achieved by using - the role XSL-FO property:

- ... -<fo:block role="H1" font-weight="bold">I. A Level 1 Heading</fo:block> -<fo:block>This is the first paragraph of the first section...</fo:block> -... -

If a non-standard structure type is specified, FOP will issue a warning and fall back to - the default tag associated to the Formatting Object.

-
-
- Testing -

- 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 there are certain - limitations. Please help us identify and close any gaps. -

-
    -
  • - The natural language can currently only be specified at the page-sequence level. The - document language is derived from the language of the first page-sequence. It is - currently not possible to override the language inside the content below the - page-sequence level. -
    • -
  • - It's currently not possible to specify the expanded form of an abbreviation or acronym. -
    • -
  • - SVG graphics (or images in general) are treated as a single figure. Text contained in - SVGs is not accessible. It's only possible to work with fox:alt-text. -
    • -
  • - The side regions (region-before, region-after etc.) are currently not specially - identified. Screen readers may read their content at page changes. -
    • -
-
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/anttask.xml b/src/documentation/content/xdocs/1.0/anttask.xml deleted file mode 100644 index ba53fe7d1..000000000 --- a/src/documentation/content/xdocs/1.0/anttask.xml +++ /dev/null @@ -1,236 +0,0 @@ - - - - - -
- Apache™ FOP: Ant task - $Revision$ -
- -

- Apache™ FOP provides an Ant task for automating the document build process. -

-
- Description -

- The FOP Ant task will convert XSL-FO documents to PDF, PS, PCL etc. output - (see Output formats for available formats). -

-

- To call FOP tasks within Ant, first add a FOP task definition to your Ant build file. - One method of defining the task is as follows: -

- - - - - - - - - - - - - - ]]> -

- Then create FOP tasks within your Ant build file, using the FOP task parameters listed below.

-
- -
Parameters for FOP Ant task - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Parameters specified as attributes
AttributeDescriptionRequired
fofileXSL-FO file to be renderedYes, if no fileset nested element is used
xmlfileXML input fileYes, if no fofile is specified
xsltfileXSLT input fileYes, if no fofile is specified
outfileOutput filenameYes, when fofile is used. (This attribute is not valid for filesets.)
formatPossible output formats:
- application/X-fop-awt-preview
- application/X-fop-print
- application/X-fop-areatree
- application/pdf
- application/postscript
- application/mif
- application/rtf, - text/richtext, - text/rtf
- application/x-pcl, - application/vnd.hp-PCL
- application/x-afp, - application/vnd.ibm.modcap
- text/plain
- image/svg+xml
- image/gif
- image/png
- image/tiff
- 		No, defaults to application/pdf
outdirOutput directoryRequired if a fileset is used to specify the files to render; optional for fofile. (Can alternatively specify the full path in the fofile value.)
forceRecreate target files, even if they are newer than their corresponding - source files. Note: This attribute is available in post-0.20.5 - versions (0.20.x nightly build and 1.0dev) only; target files are - always generated (i.e., force=true) in 0.20.5 release. - No, default is false
basedirBase directory to resolve relative references (e.g., graphics files) within the - FO document. - No, for single FO File entry, default is to use the location - of that FO file. -
relativebaseFor fileset usage only. A value of true specifies using the location - of each .fo file as the base directory for resolving relative file references located - within that .fo file. A value of false specifies using the value of - basedir for all files within the fileset, or just the current working directory - if basedir is not specified. - No, default is false. -
userconfigUser configuration file (same as the FOP "-c" command line option).No
messagelevelLogging level
- Possible values: error, warn, info, verbose, debug. Currently doesn't work in FOP Trunk!!!		No, defaults to verbose
logFilesControls whether the names of the files that are processed are logged - (true) or not (false). Currently doesn't work in FOP Trunk!!!No, default is true
throwexceptionsControls whether or not an exception is thrown if an error occurs during rendering.Default is true
-

- - - - - - - - - - - -
Parameters specified as nested elements
AttributeDescriptionRequired
filesetFileSets - are used to specify multiple XSL-FO files to be rendered.Yes, if no fofile attribute is supplied
-

-
- Examples -

- The following example converts a single XSL-FO file to a PDF document: -

- - - - - ]]> -

- This example converts all XSL-FO files within an entire directory to PostScript: -

- - - - - - - - ]]> -

- The following example transforms and converts a single XML and XSLT file to an AFP document: -

- - - - ]]> -

- This example transforms and converts all XML files within an entire directory to PostScript: -

- - - - - - - - ]]> -
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/compiling.xml b/src/documentation/content/xdocs/1.0/compiling.xml deleted file mode 100644 index cf7b950ca..000000000 --- a/src/documentation/content/xdocs/1.0/compiling.xml +++ /dev/null @@ -1,140 +0,0 @@ - - - - - -
- Apache™ FOP: Building from Source Code - $Revision$ -
- -
- Do You Need To Build? -

- Apache™ FOP distributions are either pre-compiled binary or source. - If you are using a binary distribution, it is already built and there is no need to build it again. - See the Download Instructions for information about whether a - binary or source distribution is best for your needs. -

-

- If you got the source code from a repository snapshot or via Subversion you will need to build FOP - in any case. -

-
-
- Set Up Your Environment -
- JDK -

- Building FOP requires a minimum Java Development Kit (JDK/SDK) of 1.4 - (A Java Runtime Environment is not sufficient). -

-
-
- CLASSPATH -

- There is generally no need to setup a classpath. All libraries needed to compile FOP are included - in the source distribution and are referenced by the build script. - You will only need to adjust the classpath if you build FOP in some other way. See the build - script build.xml for details. -

-
-
- JAVA_HOME -

- The build script uses Apache Ant, a popular - Java-based build tool, which usually requires that the environment variable JAVA_HOME point to - your local JDK root directory. This is true even if you use JDK 1.4 or above, which normally - does not need this setting. -

-
-
- Apache Ant -

- Apache Ant (Version 1.7 or later) must be installed in order to - build FOP. Following best practices we don't include Ant with FOP anymore. You can find the - instructions to install Ant in the Ant manual on the web. -

-
-
-
- Run the Build Script -

- Change to the FOP root directory and build FOP by executing the build script (build.xml) - using the "ant" command. -

- - The "ant" command is only available on your system if you've properly - installed Apache Ant and added Ant's location to the PATH - environment variable. - -

- The file build.xml in the FOP root directory is the blueprint that Ant uses for the build. It - contains information for numerous build targets, many of which are building blocks to more - useful target, and others which are primarily used by the FOP developers. - You may benefit from looking through this file to learn more about the various build targets. - To obtain a complete list of useful build targets: -

- ant -projecthelp -

The most useful targets are:

-
    -
  • - package: Generates the JAR files (default). This is the normal build that - produces a jar file usable for running FOP. -
    • -
  • - clean : Cleans the build directory. This is useful for making sure that - any build errors are cleaned up before starting a new build. It should not ordinarily be - needed, but may be helpful if you are having problems with the build process itself. -
    • -
  • - javadocs: Creates the FOP API documentation. - A minimum JDK version of 1.4.2 is required for generating the javadocs. -
    • -
-

To run the build:

- ant [target ...] -

For example to do a normal build for the "all" target (which is the default):

- ant -

OR

- ant all -

To clean the build directory first:

- ant clean all - - If you want to shorten the build time you can just call the "package" target which - doesn't perform any automated tests during the build. - -
-
- Troubleshooting -

If you have problems building FOP, please try the following:

-
    -
  • Run the build with the target of "clean", then rerun the build.
    • -
  • Delete the build directory completely, then rerun the build.
    • -
  • - Make sure you do not have a non-FOP version of xerces.jar, xalan.jar, batik.jar, - or another dependency product somewhere in your CLASSPATH. -
    • -
  • - If the build still fails, see the Getting Help - page for further help. -
    • -
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/configuration.xml b/src/documentation/content/xdocs/1.0/configuration.xml deleted file mode 100644 index 9adf63c46..000000000 --- a/src/documentation/content/xdocs/1.0/configuration.xml +++ /dev/null @@ -1,492 +0,0 @@ - - - - - -
- Apache™ FOP: Configuration - $Revision$ -
- - -
- Configuration File Basics -

- The FOP configuration file is an XML file containing a variety of settings that are useful - for controlling FOP's behavior, and for helping it find resources that you wish it to use. -

-

- The easiest way to get started using a FOP configuration file is to copy the sample found - at {fop-dir}/conf/fop.xconf to a location of your choice, and then to - edit it according to your needs. - It contains templates for the various configuration options, most of which are commented - out. Remove the comments and change the settings for entries that you wish to use. - Be sure to follow any instructions, including comments which specify the value range. - Also, since the configuration file is XML, be sure to keep it well-formed. -

-
- Making Configuration Available to FOP -

After creating your configuration file, you must tell FOP how to find it:

- -

- See Setting the Configuration Programmatically - for instructions on how to do so in an embedded environment. -

-
-
-
- Summary of the General Configuration Options - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ElementData Type (for the value)DescriptionDefault Value
baseURL or directorySpecifies the base URL based on which relative URL will be resolved.current directory
font-baseURL or directorySpecifies the base URL based on which relative font URLs will be resolved. - base URL/directory (above)
hyphenation-baseURL or directorySpecifies the base URL based on which relative URLs to hyphenation pattern - files will be resolved. If not specified, support for user-supplied hyphenation - patterns remains disabled. - disabled
source-resolutionInteger, dpi - Resolution in dpi (dots per inch) which is used internally to determine the pixel - size for SVG images and bitmap images without resolution information. - 72 dpi
target-resolutionInteger, dpi - Resolution in dpi (dots per inch) used to specify the output resolution for bitmap - images generated by bitmap renderers (such as the TIFF renderer) and by bitmaps - generated by Apache Batik for filter effects and such. - 72 dpi
strict-configurationBoolean (true, false) - Setting this option to 'true' will cause FOP to strictly verify the contents of the - FOP configuration file to ensure that defined resources (such as fonts and base - URLs/directories) are valid and available to FOP. Any errors found will cause FOP to - immediately raise an exception.false
strict-validationBoolean (true, false) - Setting this option to 'false' causes FOP to be more forgiving about XSL-FO validity, - for example, you're allowed to specify a border on a region-body which is supported - by some FO implementations but is non-standard. Note that such a border would - currently have no effect in Apache FOP.true
break-indent-inheritanceBoolean (true, false) - Setting this option to 'true' causes FOP to use an alternative rule set to determine - text indents specified through margins, start-indent and end-indent. Many commercial - FO implementations have chosen to break the XSL specification in this aspect. This - option tries to mimic their behaviour. Please note that Apache FOP may still not - behave exactly like those implementations either because FOP has not fully matched - the desired behaviour and because the behaviour among the commercial implementations - varies. The default for this option (i.e. false) is to behave exactly like the - specification describes.false
default-page-settingsn/a - Specifies the default width and height of a page if "auto" is specified - for either or both values. Use "height" and "width" attributes on the - default-page-settings element to specify the two values."height" 11 inches, "width" 8.26 inches
prefer-rendererboolean (true, false) - By default, FOP prefers the newer output implementations based on the - IFDocumentHandler interface. If no such implementation can be found for - a given MIME type, it looks for an implementation of the Renderer interface. - If necessary, you can invert the lookup order to prefer the Renderer variant over the - IFDocumentHandler variant by setting this value to true. - false
use-cacheboolean (true, false)All fonts information that has been gathered as a result of "directory" - or "auto-detect" font configurations will be cached for future rendering runs. - This setting should improve performance on systems where - fonts have been configured using the "directory" or "auto-detect" tag mechanisms. - By default this option is switched on.true
cache-fileStringThis options specifies the file/directory path of the fop cache file. - This option can also be specified on the command-line using the -cache option. - This file is currently only used to cache font triplet information for future reference.${base}/conf/fop.cache
renderers(see text below)Contains the configuration for each renderer. See below.N/A
-

- This is an excerpt from the example configuration file coming with FOP: -

- - - - true - - - true - - - ./ - - - ./ - - - 72 - - 72 - - - - - -]]> -
-
- Image Loading Customization -

- Apache FOP uses the image loading framework from - Apache XML Graphics Commons to load - images using various plug-ins. Every image loader plug-in has a hard-coded usage penalty - that influences which solution is chosen if there are multiple possibilities to load an image. - Sometimes, though, these penalties need to be tweaked and this can be done in the FOP - configuration. An example: -

- - [..] - - - - - ]]> -

- The first penalty element increases the penalty for the raw CCITT loader. This practically - forces the decoding of CCITT compressed TIFF images except if there are no TIFF codecs - available. -

-

- The second penalty element sets an "infinite" penalty for the TIFF loader using the internal - TIFF codec. This practically disables that plug-in as it will never be chosen as a possible - solution. -

-

- Negative penalties are possible to promote a plug-in but a negative penalty sum will be - treated as zero penalty in most cases. For more details on the image loading framework, - please consult the documentation there. -

-
-
- Renderer configuration -

- Each Renderer has its own configuration section which is identified by the - MIME type the Renderer is written for, ex. "application/pdf" for the PDF Renderer. -

-

- The configuration for the PDF Renderer could look like this: -

- - - - - flate - - - - - - - - - - - - - - - ]]> -

- The details on the font configuration can be found on the separate Fonts page. - Note especially the section entitled Register Fonts with FOP. -

-
- Special Settings for the PDF Renderer -

- The configuration element for the PDF renderer contains two elements. One is for the font configuration - (please follow the link above) and one is for the "filter list". The filter list controls how the - individual objects in a PDF file are encoded. By default, all objects get "flate" encoded (i.e. simply - compressed with the same algorithm that is also used in ZIP files). Most users don't need to change that - setting. For debugging purposes, it may be desired not to compress the internal objects at all so the - generated PDF commands can be read. In that case, you can simply use the following filter list. The - second filter list (type="image") ensures that all images still get compressed but also ASCII-85 encoded - so the produced PDF file is still easily readable in a text editor. -

- - - null - - - flate - ascii-85 - - - ]]> -

- Another (optional) setting specific to the PDF Renderer is an output color profile, an ICC - color profile which indicates the target color space the PDF file is generated for. This - setting is mainly used in conjunction with the PDF/X feature. - An example: -

- - C:\FOP\Color\EuropeISOCoatedFOGRA27.icc - - ]]> -

- Some people don't have high requirements on color fidelity but instead want the smallest - PDF file sizes possible. In this case it's possible to disable the default sRGB color space - which XSL-FO requires. This will cause RGB colors to be generated as device-specific RGB. - Please note that this option is unavailable (and will cause an error) if you enable - PDF/A or PDF/X functionality or if you specify an output profile. This setting will make the - PDF about 4KB smaller. To disable the sRGB color space add the following setting: -

- - true - - ]]> - -

FOP supports encryption of PDF output, thanks to Patrick C. Lankswert. - This feature is commonly used to prevent unauthorized viewing, printing, editing, copying text - from the document and doing annotations. It is also possible to ask the user for a password in - order to view the contents. Note that there already exist third party applications which can - decrypt an encrypted PDF without effort and allow the aforementioned operations, therefore the - degree of protection is limited. For further information about features and restrictions - regarding PDF encryption, look at the documentation coming with Adobe Acrobat or the technical - documentation on the Adobe web site.

- - - testuserpass - testownerpass - - - - - - ]]> - -
-
- Special Settings for the PostScript Renderer -

- Besides the normal font configuration (the same "fonts" element as for the PDF renderer) the PostScript - renderer has an additional setting to force landscape pages to be rotated to fit on a page inserted into - the printer in portrait mode. Set the value to "true" to activate this feature. The default is "false". - Example: -

- - true - - - - - - - - - - - - ]]> -
-
- Special Settings for the PCL Renderer -

- Non-standard fonts for the PCL renderer are made available through the Java2D subsystem which means that - you don't have to do any custom font configuration in this case but you have to use the font names - offered by Java. -

-

- Additionally, there are certain settings that control how the renderer handles various elements. -

- - quality - bitmap -]]> -

- The default value for the "rendering" setting is "speed" which causes borders - to be painted as plain rectangles. In this mode, no special borders (dotted, - dashed etc.) are available. If you want support for all border modes, set the - value to "quality" as indicated above. This will cause the borders to be painted - as bitmaps. -

-

- The default value for the "text-rendering" setting is "auto" which paints the - base fonts using PCL fonts. Non-base fonts are painted as bitmaps through Java2D. - If the mix of painting methods results in unwelcome output, you can set this - to "bitmap" which causes all text to be rendered as bitmaps. -

-
-
- Special Settings for the AFP Renderer -

-

-

- Additionally, there are certain settings that control how the renderer handles various elements. -

- - - 240 - - - resources.afp -]]> -

- The default value for the images "mode" setting is "b+w" (black and white). When the images "mode" setting is "b+w" a "bits-per-pixel" setting can be provided to aid the grayscale conversion process. With this setting all images referenced in your source document are converted to an IOCA FS45 grayscale bitmap image form. - When the setting is "color" all images are converted to an IOCA FS45 color bitmap image form. When "native" setting is "true", all images encountered (TIFF, GIF, JPEG and Encapsulated Postscript etc.) will be embedded directly in the datastream in their native form using a MO:DCA Object Container. -

-

- The default value for the "renderer-resolution" is 240 dpi. -

- -

- By default if there is no configuration definition for "resource-group-file", external resources will be placed in a file called resources.afp. -

-
-
- -
- When it does not work - -

FOP searches the configuration file for the information it -expects, at the position it expects. When that information is not -present, FOP will not complain, it will just continue. When there is -other information in the file, FOP will not complain, it will just -ignore it. That means that when your configuration information is in -the file but in a different XML element, or in a different XML path, -than FOP expects, it will be silently ignored.

- -

Check the following possibilities:

- -
    -
  • The format of the configuration file has changed -considerably between FOP 0.20.5 and FOP 1.0 and its beta versions. Did -you convert your file to the new format?
    • - -
  • The FOP distribution contains a schema for configuration -files, at src/foschema/fop-configuration.xsd. Did you validate your -configuration file against it? Add the following schema location to -the schema element: - -]]> - - -and run the configuration file through a validating schema -parser. Note that the schema cannot detect all errors, and that it is -stricter about the order of some elements than FOP itself is.
    • - -
  • Run FOP in debug mode (command line option --d). This makes FOP report which configuration -information it finds. Check if FOP finds what you expect.
    • - -
- -
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/embedding.xml b/src/documentation/content/xdocs/1.0/embedding.xml deleted file mode 100644 index de2c6404c..000000000 --- a/src/documentation/content/xdocs/1.0/embedding.xml +++ /dev/null @@ -1,701 +0,0 @@ - - - - - - -
- Apache™ FOP: Embedding - How to Embed Apache� FOP in a Java application - $Revision$ -
- - -
- Overview -

- Review Running FOP for important information that applies - to embedded applications as well as command-line use, such as options and performance. -

-

- To embed Apache™ FOP in your application, first create a new - org.apache.fop.apps.FopFactory instance. This object can be used to launch multiple - rendering runs. For each run, create a new org.apache.fop.apps.Fop instance through - one of the factory methods of FopFactory. In the method call you specify which output - format (i.e. Renderer) to use and, if the selected renderer requires an OutputStream, - which OutputStream to use for the results of the rendering. You can customize FOP's - behaviour in a rendering run by supplying your own FOUserAgent instance. The - FOUserAgent can, for example, be used to set your own Renderer instance (details - below). Finally, you retrieve a SAX DefaultHandler instance from the Fop object and - use that as the SAXResult of your transformation. -

- - We recently changed FOP's outer API to what we consider the final API. This might require - some changes in your application. The main reasons for these changes were performance - improvements due to better reuse of reusable objects and reduced use of static variables - for added flexibility in complex environments. - -
-
- Basic Usage Pattern -

- Apache FOP relies heavily on JAXP. It uses SAX events exclusively to receive the XSL-FO - input document. It is therefore a good idea that you know a few things about JAXP (which - is a good skill anyway). Let's look at the basic usage pattern for FOP... -

-

Here is the basic pattern to render an XSL-FO file to PDF: -

- -

- Let's discuss these 5 steps in detail: -

-
    -
  • - Step 1: You create a new FopFactory instance. The FopFactory instance holds - references to configuration information and cached data. It's important to reuse this - instance if you plan to render multiple documents during a JVM's lifetime. -
    • -
  • - Step 2: You set up an OutputStream that the generated document - will be written to. It's a good idea to buffer the OutputStream as demonstrated - to improve performance. -
    • -
  • - Step 3: You create a new Fop instance through one of the factory - methods on the FopFactory. You tell the FopFactory what your desired output format - is. This is done by using the MIME type of the desired output format (ex. "application/pdf"). - You can use one of the MimeConstants.* constants. The second parameter is the - OutputStream you've setup up in step 2. -
    • -
  • - Step 4 We recommend that you use JAXP Transformers even - if you don't do XSLT transformations to generate the XSL-FO file. This way - you can always use the same basic pattern. The example here sets up an - "identity transformer" which just passes the input (Source) unchanged to the - output (Result). You don't have to work with a SAXParser if you don't do any - XSLT transformations. -
    • -
  • - Step 5: Here you set up the input and output for the XSLT - transformation. The Source object is set up to load the "myfile.fo" file. - The Result is set up so the output of the XSLT transformation is sent to FOP. - The FO file is sent to FOP in the form of SAX events which is the most efficient - way. Please always avoid saving intermediate results to a file or a memory buffer - because that affects performance negatively. -
    • -
  • - Step 6: Finally, we start the XSLT transformation by starting - the JAXP Transformer. As soon as the JAXP Transformer starts to send its output - to FOP, FOP itself starts its processing in the background. When the - transform() method returns FOP will also have finished converting - the FO file to a PDF file and you can close the OutputStream. - - It's a good idea to enclose the whole conversion in a try..finally statement. If - you close the OutputStream in the finally section, this will make sure that the - OutputStream is properly closed even if an exception occurs during the conversion. - -
    • -
-

- If you're not totally familiar with JAXP Transformers, please have a look at the - Embedding examples below. The section contains examples - for all sorts of use cases. If you look at all of them in turn you should be able - to see the patterns in use and the flexibility this approach offers without adding - too much complexity. -

-

- This may look complicated at first, but it's really just the combination of an - XSL transformation and a FOP run. It's also easy to comment out the FOP part - for debugging purposes, for example when you're tracking down a bug in your - stylesheet. You can easily write the XSL-FO output from the XSL transformation - to a file to check if that part generates the expected output. An example for that - can be found in the Embedding examples (See "ExampleXML2FO"). -

-
- Logging -

- Logging is now a little different than it was in FOP 0.20.5. We've switched from - Avalon Logging to Jakarta Commons Logging. - While with Avalon Logging the loggers were directly given to FOP, FOP now retrieves - its logger(s) through a statically available LogFactory. This is similar to the - general pattern that you use when you work with Apache Log4J directly, for example. - We call this "static logging" (Commons Logging, Log4J) as opposed to "instance logging" - (Avalon Logging). This has a consequence: You can't give FOP a logger for each - processing run anymore. The log output of multiple, simultaneously running FOP instances - is sent to the same logger. -

-

- By default, Jakarta Commons Logging uses - JDK logging (available in JDKs 1.4 or higher) as its backend. You can configure Commons - Logging to use an alternative backend, for example Log4J. Please consult the - documentation for Jakarta Commons Logging on - how to configure alternative backends. -

-

- As a result of the above we differentiate between two kinds of "logging": -

- -

- The use of "feedback" instead of "logging" is intentional. Most people were using - log output as a means to get feedback from events within FOP. Therefore, FOP now - includes an event package which can be used to receive feedback from - the layout engine and other components within FOP per rendering run. - This feedback is not just some - text but event objects with parameters so these events can be interpreted by code. - Of course, there is a facility to turn these events into normal human-readable - messages. For details, please read on on the Events page. - This leaves normal logging to be mostly a thing used by the FOP developers - although anyone can surely activate certain logging categories but the feedback - from the loggers won't be separated by processing runs. If this is required, - the Events subsystem is the right approach. -

-
- -
- Processing XSL-FO -

- Once the Fop instance is set up, call getDefaultHandler() to obtain a SAX - DefaultHandler instance to which you can send the SAX events making up the XSL-FO - document you'd like to render. FOP processing starts as soon as the DefaultHandler's - startDocument() method is called. Processing stops again when the - DefaultHandler's endDocument() method is called. Please refer to the basic - usage pattern shown above to render a simple XSL-FO document. -

-
- -
- Processing XSL-FO generated from XML+XSLT -

- If you want to process XSL-FO generated from XML using XSLT we recommend - again using standard JAXP to do the XSLT part and piping the generated SAX - events directly through to FOP. The only thing you'd change to do that - on the basic usage pattern above is to set up the Transformer differently: -

- -
-
-
- Input Sources -

- The input XSL-FO document is always received by FOP as a SAX stream (see the - Parsing Design Document for the rationale). -

-

- However, you may not always have your input document available as a SAX stream. - But with JAXP it's easy to convert different input sources to a SAX stream so you - can pipe it into FOP. That sounds more difficult than it is. You simply have - to set up the right Source instance as input for the JAXP transformation. - A few examples: -

-
    -
  • - URL: Source src = new StreamSource("http://localhost:8080/testfile.xml"); -
    • -
  • - File: Source src = new StreamSource(new File("C:/Temp/myinputfile.xml")); -
    • -
  • - String: Source src = new StreamSource(new StringReader(myString)); // myString is a String -
    • -
  • - InputStream: Source src = new StreamSource(new MyInputStream(something)); -
    • -
  • - Byte Array: Source src = new StreamSource(new ByteArrayInputStream(myBuffer)); // myBuffer is a byte[] here -
    • -
  • - DOM: Source src = new DOMSource(myDocument); // myDocument is a Document or a Node -
    • -
  • - Java Objects: Please have a look at the Embedding examples which contain an example for this. -
    • -
-

- There are a variety of upstream data manipulations possible. - For example, you may have a DOM and an XSL stylesheet; or you may want to - set variables in the stylesheet. Interface documentation and some cookbook - solutions to these situations are provided in - Xalan Basic Usage Patterns. -

-
-
- Configuring Apache FOP Programmatically -

- Apache FOP provides two levels on which you can customize FOP's - behaviour: the FopFactory and the user agent. -

-
- Customizing the FopFactory -

- The FopFactory holds configuration data and references to objects which are reusable over - multiple rendering runs. It's important to instantiate it only once (except in special - environments) and reuse it every time to create new FOUserAgent and Fop instances. -

-

- You can set all sorts of things on the FopFactory: -

-
    -
  • -

    - The font base URL to use when resolving relative URLs for fonts. Example: -

    - fopFactory.getFontManager().setFontBaseURL("file:///C:/Temp/fonts"); -
    • -
  • -

    - The hyphenation base URL to use when resolving relative URLs for - hyphenation patterns. Example: -

    - fopFactory.setHyphenBaseURL("file:///C:/Temp/hyph"); -
    • -
  • -

    - Disable strict validation. When disabled FOP is less strict about the rules - established by the XSL-FO specification. Example: -

    - fopFactory.setStrictValidation(false); -
    • -
  • -

    - Enable an alternative set of rules for text indents that tries to mimic the behaviour of many commercial - FO implementations, that chose to break the specification in this respect. The default of this option is - 'false', which causes Apache FOP to behave exactly as described in the specification. To enable the - alternative behaviour, call: -

    - fopFactory.setBreakIndentInheritanceOnReferenceAreaBoundary(true); -
    • -
  • -

    - Set the source resolution for the document. This is used internally to determine the pixel - size for SVG images and bitmap images without resolution information. Default: 72 dpi. Example: -

    - fopFactory.setSourceResolution(96); // =96dpi (dots/pixels per Inch) -
    • -
  • -

    - Manually add an ElementMapping instance. If you want to supply a special FOP extension - you can give the instance to the FOUserAgent. Normally, the FOP extensions can be automatically detected - (see the documentation on extension for more info). Example: -

    - fopFactory.addElementMapping(myElementMapping); // myElementMapping is a org.apache.fop.fo.ElementMapping -
    • -
  • -

    - Set a URIResolver for custom URI resolution. By supplying a JAXP URIResolver you can add - custom URI resolution functionality to FOP. For example, you can use - Apache XML Commons Resolver to make use of XCatalogs. Example: -

    - fopFactory.setURIResolver(myResolver); // myResolver is a javax.xml.transform.URIResolver - - Both the FopFactory and the FOUserAgent have a method to set a URIResolver. The URIResolver on the FopFactory - is primarily used to resolve URIs on factory-level (hyphenation patterns, for example) and it is always used - if no other URIResolver (for example on the FOUserAgent) resolved the URI first. - -
    • -
-
-
- Customizing the User Agent -

- The user agent is the entity that allows you to interact with a single rendering run, i.e. the processing of a single - document. If you wish to customize the user agent's behaviour, the first step is to create your own instance - of FOUserAgent using the appropriate factory method on FopFactory and pass that - to the factory method that will create a new Fop instance: -

- -

- You can do all sorts of things on the user agent: -

-
    -
  • -

    - The base URL to use when resolving relative URLs. Example: -

    - userAgent.setBaseURL("file:///C:/Temp/"); -
    • -
  • -

    - Set the producer of the document. This is metadata information that can be used for certain output formats such as PDF. The default producer is "Apache FOP". Example: -

    - userAgent.setProducer("MyKillerApplication"); -
    • -
  • -

    - Set the creating user of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setCreator("John Doe"); -
    • -
  • -

    - Set the author of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setAuthor("John Doe"); -
    • -
  • -

    - Override the creation date and time of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setCreationDate(new Date()); -
    • -
  • -

    - Set the title of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setTitle("Invoice No 138716847"); -
    • -
  • -

    - Set the keywords of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setKeywords("XML XSL-FO"); -
    • -
  • -

    - Set the target resolution for the document. This is used to - specify the output resolution for bitmap images generated by bitmap renderers - (such as the TIFF renderer) and by bitmaps generated by Apache Batik for filter - effects and such. Default: 72 dpi. Example: -

    - userAgent.setTargetResolution(300); // =300dpi (dots/pixels per Inch) -
    • -
  • -

    - Set your own Renderer instance. If you want to supply your own renderer or - configure a Renderer in a special way you can give the instance to the FOUserAgent. Normally, - the Renderer instance is created by FOP. Example: -

    - userAgent.setRendererOverride(myRenderer); // myRenderer is an org.apache.fop.render.Renderer -
    • -
  • -

    - Set your own FOEventHandler instance. If you want to supply your own FOEventHandler or - configure an FOEventHandler subclass in a special way you can give the instance to the FOUserAgent. Normally, - the FOEventHandler instance is created by FOP. Example: -

    - userAgent.setFOEventHandlerOverride(myFOEventHandler); // myFOEventHandler is an org.apache.fop.fo.FOEventHandler -
    • -
  • -

    - Set a URIResolver for custom URI resolution. By supplying a JAXP URIResolver you can add - custom URI resolution functionality to FOP. For example, you can use - Apache XML Commons Resolver to make use of XCatalogs. Example: -

    - userAgent.setURIResolver(myResolver); // myResolver is a javax.xml.transform.URIResolver - - Both the FopFactory and the FOUserAgent have a method to set a URIResolver. The URIResolver on the FOUserAgent is - used for resolving URIs which are document-related. If it's not set or cannot resolve a URI, the URIResolver - from the FopFactory is used. - -
    • -
- - You should not reuse an FOUserAgent instance between FOP rendering runs although you can. Especially - in multi-threaded environment, this is a bad idea. - -
-
-
- Using a Configuration File -

- Instead of setting the parameters manually in code as shown above you can also set - many values from an XML configuration file: -

- -

- The layout of the configuration file is described on the Configuration page. -

-
-
- Hints -
- Object reuse -

- Fop instances shouldn't (and can't) be reused. Please recreate - Fop and FOUserAgent instances for each rendering run using the FopFactory. - This is a cheap operation as all reusable information is held in the - FopFactory. That's why it's so important to reuse the FopFactory instance. -

-
-
- AWT issues -

- If your XSL-FO files contain SVG then Apache Batik will be used. When Batik is - initialised it uses certain classes in java.awt that - intialise the Java AWT classes. This means that a daemon thread - is created by the JVM and on Unix it will need to connect to a - DISPLAY. -

-

- The thread means that the Java application may not automatically quit - when finished, you will need to call System.exit(). These - issues should be fixed in the JDK 1.4. -

-

- If you run into trouble running FOP on a head-less server, please see the - notes on Batik. -

-
-
- Getting information on the rendering process -

- To get the number of pages that were rendered by FOP you can call - Fop.getResults(). This returns a FormattingResults object - where you can look up the number of pages produced. It also gives you the - page-sequences that were produced along with their id attribute and their - numbers of pages. This is particularly useful if you render multiple - documents (each enclosed by a page-sequence) and have to know the number of - pages of each document. -

-
-
-
- Improving performance -

- There are several options to consider: -

-
    -
  • - Whenever possible, try to use SAX to couple the individual components involved - (parser, XSL transformer, SQL datasource etc.). -
    • -
  • - Depending on the target OutputStream (in case of a FileOutputStream, but not - for a ByteArrayOutputStream, for example) it may improve performance considerably - if you buffer the OutputStream using a BufferedOutputStream: - out = new java.io.BufferedOutputStream(out); -
    - Make sure you properly close the OutputStream when FOP is finished. -
    • -
  • - Cache the stylesheet. If you use the same stylesheet multiple times - you can set up a JAXP Templates object and reuse it each time you do - the XSL transformation. (More information can be found - here.) -
    • -
  • - Use an XSLT compiler like XSLTC - that comes with Xalan-J. -
    • -
  • - Fine-tune your stylesheet to make the XSLT process more efficient and to create XSL-FO that can - be processed by FOP more efficiently. Less is more: Try to make use of property inheritance where possible. -
    • -
  • - You may also wish to consider trying to reduce memory usage. -
    • -
-
-
- Multithreading FOP -

- Apache FOP may currently not be completely thread safe. - The code has not been fully tested for multi-threading issues, yet. - If you encounter any suspicious behaviour, please notify us. -

-

- There is also a known issue with fonts being jumbled between threads when using - the Java2D/AWT renderer (which is used by the -awt and -print output options). - In general, you cannot safely run multiple threads through the AWT renderer. -

-
-
- Examples -

- The directory "{fop-dir}/examples/embedding" contains several working examples. -

-
- ExampleFO2PDF.java -

This - - example -demonstrates the basic usage pattern to transform an XSL-FO -file to PDF using FOP. -

-
-
-
- ExampleXML2FO.java -

This - - example -has nothing to do with FOP. It is there to show you how an XML -file can be converted to XSL-FO using XSLT. The JAXP API is used to do the -transformation. Make sure you've got a JAXP-compliant XSLT processor in your -classpath (ex. Xalan). -

-
-
-
- ExampleXML2PDF.java -

This - - example -demonstrates how you can convert an arbitrary XML file to PDF -using XSLT and XSL-FO/FOP. It is a combination of the first two examples -above. The example uses JAXP to transform the XML file to XSL-FO and FOP to -transform the XSL-FO to PDF. -

-
-

-The output (XSL-FO) from the XSL transformation is piped through to FOP using -SAX events. This is the most efficient way to do this because the -intermediate result doesn't have to be saved somewhere. Often, novice users -save the intermediate result in a file, a byte array or a DOM tree. We -strongly discourage you to do this if it isn't absolutely necessary. The -performance is significantly higher with SAX. -

-
-
- ExampleObj2XML.java -

This - - example -is a preparatory example for the next one. It's an example that -shows how an arbitrary Java object can be converted to XML. It's an often -needed task to do this. Often people create a DOM tree from a Java object and -use that. This is pretty straightforward. The example here, however, shows how -to do this using SAX, which will probably be faster and not even more -complicated once you know how this works. -

-
-

-For this example we've created two classes: ProjectTeam and ProjectMember -(found in xml-fop/examples/embedding/java/embedding/model). They represent -the same data structure found in -xml-fop/examples/embedding/xml/xml/projectteam.xml. We want to serialize to XML a -project team with several members which exist as Java objects. -Therefore we created the two classes: ProjectTeamInputSource and -ProjectTeamXMLReader (in the same place as ProjectTeam above). -

-

-The XMLReader implementation (regard it as a special kind of XML parser) is -responsible for creating SAX events from the Java object. The InputSource -class is only used to hold the ProjectTeam object to be used. -

-

-Have a look at the source of ExampleObj2XML.java to find out how this is -used. For more detailed information see other resources on JAXP (ex. -An older JAXP tutorial). -

-
-
- ExampleObj2PDF.java -

This - - example -combines the previous and the third to demonstrate -how you can transform a Java object to a PDF directly in one smooth run -by generating SAX events from the Java object that get fed to an XSL -transformation. The result of the transformation is then converted to PDF -using FOP as before. -

-
-
-
- ExampleDOM2PDF.java -

This - - example -has FOP use a DOMSource instead of a StreamSource in order to -use a DOM tree as input for an XSL transformation. -

-
-
- ExampleSVG2PDF.java (PDF Transcoder example) -

This - - example -shows the usage of the PDF Transcoder, a sub-application within FOP. -It is used to generate a PDF document from an SVG file. -

-
-
- Final notes -

-These examples should give you an idea of what's possible. It should be easy -to adjust these examples to your needs. Also, if you have other examples that you -think should be added here, please let us know via either the fop-users or fop-dev -mailing lists. Finally, for more help please send your questions to the fop-users -mailing list. -

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/events.xml b/src/documentation/content/xdocs/1.0/events.xml deleted file mode 100644 index 27daad59b..000000000 --- a/src/documentation/content/xdocs/1.0/events.xml +++ /dev/null @@ -1,449 +0,0 @@ - - - - - -
- Apache™ FOP: Events/Processing Feedback - $Revision$ -
- -
- Introduction -

- In versions until 0.20.5, Apache™ FOP used - Avalon-style Logging where - it was possible to supply a logger per processing run. During the redesign - the logging infrastructure was switched over to - Commons Logging which is (like Log4J or - java.util.logging) a "static" logging framework (the logger is accessed through static - variables). This made it very difficult in a multi-threaded system to retrieve information - for a single processing run. -

-

- With FOP's event subsystem, we'd like to close this gap again and even go further. The - first point is to realize that we have two kinds of "logging". Firstly, we have the logging - infrastructure for the (FOP) developer who needs to be able to enable finer log messages - for certain parts of FOP to track down a certain problem. Secondly, we have the user who - would like to be informed about missing images, overflowing lines or substituted fonts. - These messages (or events) are targeted at less technical people and may ideally be - localized (translated). Furthermore, tool and solution builders would like to integrate - FOP into their own solutions. For example, an FO editor should be able to point the user - to the right place where a particular problem occurred while developing a document template. - Finally, some integrators would like to abort processing if a resource (an image or a font) - has not been found, while others would simply continue. The event system allows to - react on these events. -

-

- On this page, we won't discuss logging as such. We will show how the event subsystem can - be used for various tasks. We'll first look at the event subsystem from the consumer side. - Finally, the production of events inside FOP will be discussed (this is mostly interesting - for FOP developers only). -

-
-
- The consumer side -

- The event subsystem is located in the org.apache.fop.events package and its - base is the Event class. An instance is created for each event and is sent - to a set of EventListener instances by the EventBroadcaster. - An Event contains: -

-
    -
  • an event ID,
    • -
  • a source object (which generated the event),
    • -
  • a severity level (Info, Warning, Error and Fatal Error) and
    • -
  • a map of named parameters.
    • -
-

- The EventFormatter class can be used to translate the events into - human-readable, localized messages. -

-

- A full example of what is shown here can be found in the - examples/embedding/java/embedding/events directory in the FOP distribution. - The example can also be accessed - via the web. -

-
- Writing an EventListener -

- The following code sample shows a very simple EventListener. It basically just sends - all events to System.out (stdout) or System.err (stderr) depending on the event severity. -

- -

- You can see that for every event the method processEvent of the - EventListener will be called. Inside this method you can do whatever - processing you would like including throwing a RuntimeException, if you want - to abort the current processing run. -

-

- The code above also shows how you can turn an event into a human-readable, localized - message that can be presented to a user. The EventFormatter class does - this for you. It provides additional methods if you'd like to explicitly specify - the locale. -

-

- It is possible to gather all events for a whole processing run so they can be - evaluated afterwards. However, care should be taken about memory consumption since - the events provide references to objects inside FOP which may themselves have - references to other objects. So holding on to these objects may mean that whole - object trees cannot be released! -

-
-
- Adding an EventListener -

- To register the event listener with FOP, get the EventBroadcaster which - is associated with the user agent (FOUserAgent) and add it there: -

- -

- Please note that this is done separately for each processing run, i.e. for each - new user agent. -

-
-
- An additional listener example -

- Here's an additional example of an event listener: -

-

- By default, FOP continues processing even if an image wasn't found. If you have - more strict requirements and want FOP to stop if an image is not available, you can - do something like the following in the simplest case: -

- -

- Increasing the event severity to FATAL will signal the event broadcaster to throw - an exception and stop further processing. In the above case, all resource-related - events will cause FOP to stop processing. -

-

- You can also customize the exception to throw (you can may throw a RuntimeException - or subclass yourself) and/or which event to respond to: -

- -

- This throws a RuntimeException with the FileNotFoundException - as the cause. Further processing effectively stops in FOP. You can catch the exception - in your code and react as you see necessary. -

-
-
-
- The producer side (for FOP developers) -

- This section is primarily for FOP and FOP plug-in developers. It describes how to use - the event subsystem for producing events. -

- - The event package has been designed in order to be theoretically useful for use cases - outside FOP. If you think this is interesting independently from FOP, please talk to - us. - -
- Producing and sending an event -

- The basics are very simple. Just instantiate an Event object and fill - it with the necessary parameters. Then pass it to the EventBroadcaster - which distributes the events to the interested listeneners. Here's a code example: -

- -

- The Event.paramsBuilder() is a - fluent interface - to help with the build-up of the parameters. You could just as well instantiate a - Map (Map<String, Object>) and fill it with values. -

-
-
- The EventProducer interface -

- To simplify event production, the event subsystem provides the EventProducer - interface. You can create interfaces which extend EventProducer. These - interfaces will contain one method per event to be generated. By contract, each event - method must have as its first parameter a parameter named "source" (Type Object) which - indicates the object that generated the event. After that come an arbitrary number of - parameters of any type as needed by the event. -

-

- The event producer interface does not need to have any implementation. The implementation - is produced at runtime by a dynamic proxy created by DefaultEventBroadcaster. - The dynamic proxy creates Event instances for each method call against - the event producer interface. Each parameter (except "source") is added to the event's - parameter map. -

-

- To simplify the code needed to get an instance of the event producer interface it is - suggested to create a public inner provider class inside the interface. -

-

- Here's an example of such an event producer interface: -

- -

- To produce the same event as in the first example above, you'd use the following code: -

- -
-
- The event model -

- Inside an invocation handler for a dynamic proxy, there's no information about - the names of each parameter. The JVM doesn't provide it. The only thing you know is - the interface and method name. In order to properly fill the Event's - parameter map we need to know the parameter names. These are retrieved from an - event object model. This is found in the org.apache.fop.events.model - package. The data for the object model is retrieved from an XML representation of the - event model that is loaded as a resource. The XML representation is generated using an - Ant task at build time (ant resourcegen). The Ant task (found in - src/codegen/java/org/apache/fop/tools/EventProducerCollectorTask.java) - scans FOP's sources for descendants of the EventProducer interface and - uses QDox to parse these interfaces. -

-

- The event model XML files are generated during build by the Ant task mentioned above when - running the "resourcegen" task. So just run "ant resourcegen" if you receive - a MissingResourceException at runtime indicating that - "event-model.xml" is missing. -

-

- Primarily, the QDox-based collector task records the parameters' names and types. - Furthermore, it extracts additional attributes embedded as Javadoc comments from - the methods. At the moment, the only such attribute is "@event.severity" which indicates - the default event severity (which can be changed by event listeners). The example event - producer above shows the Javadocs for an event method. -

-

- There's one more information that is extracted from the event producer information for - the event model: an optional primary exception. The first exception in the "throws" - declaration of an event method is noted. It is used to throw an exception from - the invocation handler if the event has an event severity of "FATAL" when all - listeners have been called (listeners can update the event severity). Please note - that an implementation of - org.apache.fop.events.EventExceptionManager$ExceptionFactory has to be - registered for the EventExceptionManager to be able to construct the - exception from an event. -

-

- For a given application, there can be multiple event models active at the same time. - In FOP, each renderer is considered to be a plug-in and provides its own specific - event model. The individual event models are provided through an - EventModelFactory. This interface is implemented for each event model - and registered through the service provider mechanism - (see the plug-ins section for details). -

-
-
- Event severity -

- Four different levels of severity for events has been defined: -

-
    -
  1. INFO: informational only
    2. -
  2. WARN: a Warning
    3. -
  3. ERROR: an error condition from which FOP can recover. FOP will continue processing.
    4. -
  4. FATAL: a fatal error which causes an exception in the end and FOP will stop processing.
    5. -
-

- Event listeners can choose to ignore certain events based on their event severity. - Please note that you may recieve an event "twice" in a specific case: if there is - a fatal error an event is generated and sent to the listeners. After that an exception - is thrown with the same information and processing stops. If the fatal event is - shown to the user and the following exception is equally presented to the user it - may appear that the event is duplicated. Of course, the same information is just - published through two different channels. -

-
-
- Plug-ins to the event subsystem -

- The event subsystem is extensible. There are a number of extension points: -

-
    -
  • - org.apache.fop.events.model.EventModelFactory: Provides - an event model to the event subsystem. -
    • -
  • - org.apache.fop.events.EventExceptionManager$ExceptionFactory: - Creates exceptions for events, i.e. turns an event into a specific exception. -
    • -
-

- The names in bold above are used as filenames for the service provider files that - are placed in the META-INF/services directory. That way, they are - automatically detected. This is a mechanism defined by the - JAR file specification. -

-
-
- Localization (L10n) -

- One goal of the event subsystem was to have localized (translated) event messages. - The EventFormatter class can be used to convert an event to a - human-readable message. Each EventProducer can provide its own XML-based - translation file. If there is none, a central translation file is used, called - "EventFormatter.xml" (found in the same directory as the EventFormatter - class). -

-

- The XML format used by the EventFormatter is the same as - Apache Cocoon's catalog format. Here's an example: -

- - - - [ (See position {loc})| (See {#gatherContextInfo})| (No context info available)] - - - RTF output requires that all table-columns for a table are defined. Output will be incorrect.{{locator}} - - - Ignored deferred event for {node} ({start,if,start,end}).{{locator}} - - -]]> -

- The example (extracted from the RTF handler's event producer) has message templates for - two event methods. The class used to do variable replacement in the templates is - org.apache.fop.util.text.AdvancedMessageFormat which is more powerful - than the MessageFormat classes provided by the Java class library - (java.util.text package). -

-

- "locator" is a template that is reused by the other message templates - by referencing it through "{{locator}}". This is some kind of include command. -

-

- Normal event parameters are accessed by name inside single curly braces, for example: - "{node}". For objects, this format just uses the toString() method to turn - the object into a string, unless there is an ObjectFormatter registered - for that type (there's an example for org.xml.sax.Locator). -

-

- The single curly braces pattern supports additional features. For example, it is possible - to do this: "{start,if,start,end}". "if" here is a special field modifier that evaluates - "start" as a boolean and if that is true returns the text right after the second comma - ("start"). Otherwise it returns the text after the third comma ("end"). The "equals" - modifier is similar to "if" but it takes as an additional (comma-separated) parameter - right after the "equals" modifier, a string that is compared to the value of the variable. - An example: {severity,equals,EventSeverity:FATAL,,some text} (this adds "some text" if - the severity is not FATAL). -

-

- Additional such modifiers can be added by implementing the - AdvancedMessageFormat$Part and AdvancedMessageFormat$PartFactory - interfaces. -

-

- Square braces can be used to specify optional template sections. The whole section will - be omitted if any of the variables used within are unavailable. Pipe (|) characters can - be used to specify alternative sub-templates (see "locator" above for an example). -

-

- Developers can also register a function (in the above example: - {#gatherContextInfo}) - to do more complex information rendering. These functions are implementations of the - AdvancedMessageFormat$Function interface. Please take care that this is - done in a locale-independent way as there is no locale information available, yet. -

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/extensions.xml b/src/documentation/content/xdocs/1.0/extensions.xml deleted file mode 100644 index f8156b9f0..000000000 --- a/src/documentation/content/xdocs/1.0/extensions.xml +++ /dev/null @@ -1,339 +0,0 @@ - - - - - -
- Standard Apache™ FOP Extensions - $Revision$ -
- -

- By "extension", we mean any data that can be placed in the input XML document that - is not addressed by the XSL-FO standard. - By having a mechanism for supporting extensions, Apache™ FOP is able to add features that - are not covered in the specification. -

-

- The extensions documented here are included with FOP, and are automatically available - to you. If you wish to add an extension of your own to FOP, please see the - Developers' Extension Page. -

- All extensions require the correct use of an appropriate namespace in your input document. -
- SVG -

- Please see the SVG documentation for more details. -

-
-
- FO Extensions -
- Namespace -

- By convention, FO extensions in FOP use the "fox" namespace prefix. - To use any of the FO extensions, add a namespace entry for - http://xmlgraphics.apache.org/fop/extensions to the root element: -

- ]]> -
-
- PDF Bookmarks -

- In previous versions of Apache FOP there was a fox:outline element - which was used to create outlines in PDF files. The redesigned code makes use - of the new bookmark feature defined in the latest XSL 1.1 working draft. -

-
-
- Anchors or Named Destinations -

Use the fox:destination element to define "named destinations" inside a PDF document. -These are useful as fragment identifiers, e.g. "http://server/document.pdf#anchor-name". -fox:destination elements can be placed almost anywhere in the fo document, including a child of -root, a block-level element, or an inline-level element. -For the destination to actually work, it must correspond to an "id" attribute on some fo element -within the document. In other words, the "id" attribute actually creates the "view" within the -PDF document. The fox:destination simply gives that view an independent name. -

- -... -Table of Contents]]> - It is possible that in some future release of FOP, all elements with -"id" attributes will generate named-destinations, which will eliminate the need for -fox:destination. -
-
- Table Continuation Label -

This extension element hasn't been reimplemented for the redesigned code, yet.

- -
-
- fox:orphan-content-limit and fox:widow-content-limit -

- The two proprietary extension properties, fox:orphan-content-limit and - fox:widow-content-limit, are used to improve the layout of list-blocks and tables. - If you have a table with many entries, you don't want a single row to be left over - on a page. You will want to make sure that at least two or three lines are kept - together. The properties take an absolute length which specifies the area at the - beginning (fox:widow-content-limit) or at the end (fox:orphan-content-limit) of a - table or list-block. The properties are inherited and only have an effect on fo:table - and fo:list-block. An example: fox:widow-content-limit="3 * 1.2em" would make sure - the you'll have at least three lines (assuming line-height="1.2") together on a table - or list-block. -

-
-
- fox:external-document - - This feature is incomplete. Support for multi-page documents will be added shortly. - At the moment, only single-page images will work. And this will not work with RTF output. - -

- This is a proprietary extension element which allows to add whole images as pages to - an FO document. For example, if you have a scanned document or a fax as multi-page TIFF - file, you can append or insert this document using the fox:external-document - element. Each page of the external document will create one full page in the target - format. -

-

- The fox:external-document element is structurally a peer to - fo:page-sequence, so wherever you can put an fo:page-sequence - you could also place a fox:external-document. - Therefore, the specified contents for fo:root change to: -

-

- - (layout-master-set, declarations?, bookmark-tree?, (page-sequence|page-sequence-wrapper|fox:external-document|fox:destination)+) - -

-
- Specification -

- The fox:external-document extension formatting object is used to specify - how to create a (sub-)sequence of pages within a document. The content of these pages - comes from the individual subimages/pages of an image or paged document (for example: - multi-page TIFF in the form of faxes or scanned documents, or PDF files). The - formatting object creates the necessary areas to display one image per page. -

-

- In terms of page numbers, the behaviour is the same as for - fo:page-sequence. The placement of the image inside the page is similar - to that of fo:external-graphic or fo:instream-foreign-object, - i.e. the viewport (and therefore the page size) is defined by either the intrinsic - size of the image or by the size properties that apply to this formatting object. -

-

Content: EMPTY

-

The following properties apply to this formatting object:

-
    -
  • (Common Accessibility Properties) (not implemented, yet)
    • -
  • (Common Aural Properties) (not implemented, yet)
    • -
  • block-progression-dimension
    • -
  • content-height
    • -
  • content-type
    • -
  • content-width
    • -
  • display-align
    • -
  • height
    • -
  • id
    • -
  • inline-progression-dimension
    • -
  • overflow
    • -
  • pages: <page-set> (see below) (not implemented, yet)
    • -
  • reference-orientation
    • -
  • scaling
    • -
  • scaling-method
    • -
  • src
    • -
  • text-align
    • -
  • width
    • -
-

- Datatype "page-set": Value: auto | <integer-range>, - Default: "auto" which means all pages/subimages of the document. - <integer-range> allows values such as "7" or "1-3" -

- - fox:external-document is not suitable for concatenating FO documents. - For this, XInclude is recommended. - -
-
-
- Free-form Transformation for fo:block-container -

- For fo:block-container elements whose absolute-position set to - "absolute" or "fixed" you can use the extension attribute fox:transform - to apply a free-form transformation to the whole block-container. The content of the - fox:transform attribute is the same as for - SVG's transform attribute. - The transformation specified here is performed in addition to other implicit - transformations of the block-container (resulting from top, left and other properties) - and after them. -

-

- Examples: fox:transform="rotate(45)" would rotate the block-container - by 45 degrees clock-wise around its upper-left corner. - fox:transform="translate(10000,0)" would move the block-container to the - right by 10 points (=10000 millipoints, FOP uses millipoints internally!). -

- - This extension attribute doesn't work for all output formats! It's currently only - supported for PDF, PS and Java2D-based renderers. - -
-
- Color functions -

- XSL-FO supports specifying color using the rgb(), rgb-icc() and system-color() functions. - Apache FOP provides additional color functions for special use cases. Please note that - using these functions compromises the interoperability of an FO document. -

-
- cmyk() -

color cmyk(numeric, numeric, numeric, numeric)

-

- This function will construct a color in device-specific CMYK color space. The numbers - must be between 0.0 and 1.0. For output formats that don't support device-specific - color space the CMYK value is converted to an sRGB value. -

-
-
- #CMYK pseudo-profile -

color rgb-icc(numeric, numeric, numeric, #CMYK, numeric, numeric, numeric, numeric)

-

- The rgb-icc function will respond to a pseudo-profile called "#CMYK" - which indicates a device-specific CMYK color space. The "#CMYK" profile is implicitely - available and doesn't have to be (and cannot be) defined through an - fo:color-profile element. It is provided for compatibility with certain - commercial XSL-FO implementations. Please note that this is not part of the official - specification but rather a convention. The following two color specifications are - equivalent: -

-
    -
  • cmyk(0%,0%,20%,40%)
    • -
  • rgb-icc(153, 153, 102, #CMYK, 0, 0, 0.2, 0.4)
    • -
-
-
-
- Prepress Support - -

- This section defines a number of extensions related to - prepress support. - fox:scale defines a general scale factor for the generated pages. - fox:bleed defines the - bleed area for a page. - fox:crop-offset defines the outer edges of the area in which crop marks, - registration marks, color bars and page information are placed. - For details, please read on below. -

- - Those extensions have been implemented in the PDF and Java2D renderers only. - - -
- fox:scale -

Value: <number>{1,2}

-

Initial: 1

-

Applies to: fo:simple-page-master

-

- This property specifies a scale factor along resp. the x and y axes. If only one number - is provided it is used for both the x and y scales. A scale factor smaller than 1 - shrinks the page. A scale factor greater than 1 enlarges the page. -

-
-
- fox:bleed -

- Value: <length>{1,4} -

-

- Initial: 0pt -

-

Applies to: fo:simple-page-master

-

- If there is only one value, it applies to all sides. If there are two values, the top and bottom - bleed widths are set to the first value and the right and left bleed widths are set to the second. - If there are three values, the top is set to the first value, the left and right are set to the second, - and the bottom is set to the third. If there are four values, they apply to the top, right, bottom, and - left, respectively. - (Corresponds to the definition of - padding). -

-

- This extension indirectly defines the BleedBox and is calculated by expanding the TrimBox by - the bleed widths. The lengths must be non-negative. -

-
-
- fox:crop-offset -

- Value: <length>{1,4} -

-

- Initial: bleed (see below) -

-

Applies to: fo:simple-page-master

-

- Same behaviour as with fox:bleed. The initial value is set to the same values as the - fox:bleed property. -

-

- This extension indirectly defines the MediaBox and is calculated by expanding - the TrimBox by the crop offsets. The lengths must be non-negative. -

-
-
- fox:crop-box -

- Value: [trim-box | bleed-box | media-box] -

-

- Initial: media-box -

-

Applies to: fo:simple-page-master

-

- The crop box controls how Acrobat displays the page (CropBox in PDF) or how the Java2DRenderer sizes - the output media. The PDF specification defines that the CropBox defaults to the MediaBox. This extension - follows that definition. To simplify usage and cover most use cases, the three supported enumeration - values "trim-box", "bleed-box" and "media-box" set the CropBox to one of those three other boxes. -

-

- If requested in the future, we could offer to specify the CropBox in absolute coordinates rather - than just by referencing another box. -

-
-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/fonts.xml b/src/documentation/content/xdocs/1.0/fonts.xml deleted file mode 100644 index b56f4b5e6..000000000 --- a/src/documentation/content/xdocs/1.0/fonts.xml +++ /dev/null @@ -1,564 +0,0 @@ - - - - - -
- Apache™ FOP: Fonts - $Revision$ - - - - - - -
- -
- Summary -

The following table summarizes the font capabilities of the various Apache� FOP renderers:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
RendererBase-14AWT/OSCustomCustom Embedding
PDFyesnoyesyes
PostScriptyesnoyesyes
PCLyes (modified)yes (painted as bitmaps)yes (painted as bitmaps)no
AFPnonoyesyes
Java2D/AWT/Bitmapif available from OSyesyesn/a (display only)
Printif available from OSyesyescontrolled by OS printer driver
RTFn/a (font metrics not needed)n/an/an/a
TXTyes (used for layout but not for output)noyes (used for layout but not for output)no
XMLyesnoyesn/a
-
-
- Base-14 Fonts -

- The Adobe PostScript and PDF Specification specify a set of 14 fonts that must be - available to every PostScript interpreter and PDF reader: - Helvetica (normal, bold, italic, bold italic), - Times (normal, bold, italic, bold italic), - Courier (normal, bold, italic, bold italic), - Symbol and ZapfDingbats. -

-

- The following font family names are hard-coded into FOP for the Base-14 font set: -

- - - - - - - - - - - - - - - - - - - - - - - - - -
Base-14 fontfont families
HelveticaHelvetica, sans-serif, SansSerif
TimesTimes, Times Roman, Times-Roman, serif, any
CourierCourier, monospace, Monospaced
SymbolSymbol
ZapfDingbatsZapfDingbats
-

- Please note that recent versions of Adobe Acrobat Reader replace - "Helvetica" with "Arial" and "Times" with "Times New Roman" internally. - GhostScript replaces "Helvetica" with "Nimbus Sans L" and "Times" with - "Nimbus Roman No9 L". Other document viewers may do similar font - substitutions. If you need to make sure that there are no such - substitutions, you need to specify an explicit font and embed it in - the target document. -

-
-
- Missing Fonts -

- When FOP does not have a specific font at its disposal (because it's - not installed in the operating system or set up in FOP's configuration), - the font is replaced with "any". "any" is internally mapped to the - Base-14 font "Times" (see above). -

-
-
- Missing Glyphs -

- Every font contains a particular set of - glyphs. If no glyph can be found for - a given character, FOP will issue a warning and use the glpyh for "#" (if available) - instead. Before it does that, it consults a (currently hard-coded) registry of - glyph substitution groups (see Glyphs.java in Apache XML Graphics Commons). - This registry can supply alternative glyphs in some cases (like using space when a no-break - space is requested). But there's no guarantee that the result will be as expected (for - example, in the case of hyphens and similar glyphs). A better way is to use a font that - has all the necessary glyphs. This glyph substitution is only a last resort. -

-
-
- Java2D/AWT/Operating System Fonts -

- The Java2D family of renderers (Java2D, AWT, Print, TIFF, PNG), use the - Java AWT subsystem for font metric information. Through operating system - registration, the AWT subsystem knows what fonts are available on the system, - and the font metrics for each one. -

-

- When working with one of these output formats and you're missing a font, just - install it in your operating system and they should be available for these - renderers. Please note that this is not true for other output formats such as - PDF or PostScript. -

-
-
- Custom Fonts -

- Support for custom fonts is highly output format dependent (see above table). - This section shows how to add Type 1 and TrueType fonts to the PDF, PostScript and - Java2D-based renderers. Other renderers (like AFP) support other font formats. Details - in this case can be found on the page about output formats. -

-

- In earlier FOP versions, it was always necessary to create an XML font metrics file - if you wanted to add a custom font. This unconvenient step has been removed and in - addition to that, FOP supports auto-registration of fonts, i.e. FOP can find fonts - installed in your operating system or can scan user-specified directories for fonts. - Font registration via XML font metrics file is still supported and may still be necessary - for some very special cases as fallback variant while we stabilize font auto-detection. -

-

- Basic information about fonts can be found at: -

- -
-
- Basic font configuration -

- If you want FOP to use custom fonts, you need to tell it where to find them. This - is done in the configuration file and once per renderer (because each output format - is a little different). In the basic form, you can either tell FOP to find your - operating system fonts or you can specify directories that it will search for - support fonts. These fonts will then automatically be registered. -

- - - - - C:\MyFonts1 - - - C:\MyFonts2 - - - - - -]]> - - Review the documentation for FOP Configuration - for instructions on making the FOP configuration available to FOP when it runs. - Otherwise, FOP has no way of finding your custom font information. It is currently - not possible to easily configure fonts from Java code. - -
-
- Advanced font configuration -

- The instructions found above should be sufficient for most users. Below are some - additional instructions in case the basic font configuration doesn't lead to - the desired results. -

-
- Type 1 Font Metrics -

FOP includes PFMReader, which reads the PFM file that normally comes with a Type 1 font, and generates an appropriate font metrics file for it. - To use it, run the class org.apache.fop.fonts.apps.PFMReader:

-

Windows:

- java -cp build\fop.jar;lib\avalon-framework.jar;lib\commons-logging.jar;lib\commons-io.jar - org.apache.fop.fonts.apps.PFMReader [options] pfm-file xml-file -

Unix:

- java -cp build/fop.jar:lib/avalon-framework.jar:lib/commons-logging.jar:lib/commons-io.jar - org.apache.fop.fonts.apps.PFMReader [options] pfm-file xml-file -

PFMReader [options]:

-
    -
  • -fn <fontname> By default, FOP uses the fontname from the - .pfm file when embedding the font. Use the "-fn" option to override this name with one you have - chosen. This may be useful in some cases to ensure that applications using the output document - (Acrobat Reader for example) use the embedded font instead of a local font with the same - name.
    • -
- The classpath in the above example has been simplified for readability. - You will have to adjust the classpath to the names of the actual JAR files in the lib directory. - xml-apis.jar, xercesImpl.jar, xalan.jar and serializer.jar are not necessary for JDK version 1.4 or later. - The tool will construct some values (FontBBox, StemV and ItalicAngle) based on assumptions and calculations which are only an approximation to the real values. - FontBBox and Italic Angle can be found in the human-readable part of the PFB file or in the AFM file. - The PFMReader tool does not yet interpret PFB or AFM files, so if you want to be correct, you may have to adjust the values in the XML file manually. - The constructed values however appear to have no visible influence. -
-
- TrueType Font Metrics -

FOP includes TTFReader, which reads the TTF file and generates an appropriate font metrics file for it. - Use it in a similar manner to PFMReader. - For example, to create such a metrics file in Windows from the TrueType font at c:\myfonts\cmr10.ttf:

- java -cp build\fop.jar;lib\avalon-framework.jar;lib\commons-logging.jar;lib\commons-io.jar - org.apache.fop.fonts.apps.TTFReader [options] - C:\myfonts\cmr10.ttf ttfcm.xml -

TTFReader [options]:

-
    -
  • -d <DEBUG | INFO > Sets the debug level (default is - INFO).
    • -
  • -fn <fontname> Same as for PFMReader.
    • -
  • -ttcname <fontname> If you're reading data from a - TrueType Collection (.ttc file) you must specify which font from the collection you will read - metrics from. - If you read from a .ttc file without this option, the fontnames will be listed for you.
    • -
  • -enc ansi Creates a WinAnsi-encoded font metrics file. - Without this option, a CID-keyed font metrics file is created. - The table below summarizes the differences between these two encoding options as currently - used within FOP. - Please note that this information only applies to TrueType fonts and TrueType collections:
    • -
- - - - - - - - - - - - - - - - -
IssueWinAnsiCID-keyed
Usable Character SetLimited to WinAnsi character set, which is roughly equivalent to iso-8889-1.Limited only by the characters in the font itself.
Embedding the FontOptional.Mandatory. Not embedding the font produces invalid PDF documents.
- - You may experience failures with certain TrueType fonts, especially if they don't contain - the so-called Unicode "cmap" table. TTFReader can currently not deal with font like this. - -
-
- TrueType Collections -

TrueType collections (.ttc files) contain more than one font. - To create metrics files for these fonts, you must specify which font in the collection should be generated, by using the "-ttcname" option with the TTFReader.

-

To get a list of the fonts in a collection, just start the TTFReader as if it were a normal TrueType file (without the -ttcname option). - It will display all of the font names and exit with an Exception.

-

Here is an example of generating a metrics file for a .ttc file:

- java -cp build\fop.jar;lib\avalon-framework.jar;lib\commons-logging.jar;lib\commons-io.jar - org.apache.fop.fonts.apps.TTFReader -ttcname "MS Mincho" - msmincho.ttc msminch.xml -

- Alternatively, the individual sub-fonts of a TrueType Collections can be selected - using the "sub-font" attribute on the "font" element. That means that generating - an XML font metrics file for TrueType collections is not necessary anymore. Example: -

- - -]]> -
-
- Register Fonts with FOP -

You must tell FOP how to find and use the font metrics files by registering them in the FOP Configuration. Add entries for your custom fonts, regardless of font type, to the configuration file in a manner similar to the following:

- - - - - - - - - - C:\MyFonts1 - - - C:\MyFonts2 - - - - - -]]> -
    -
  • - URLs are used to access the font metric and font files. - Relative URLs are resolved relative to the font-base property (or base) if available. - See FOP: Configuration for more information. -
    • -
  • The "metrics-url" attribute is generally not necessary except if you run into problems with certain fonts.
    • -
  • Either an "embed-url" or a "metrics-url" must be specified for font tag configurations.
    • -
  • The font "kerning" attribute is optional. Default is "true".
    • -
  • If embedding is off (i.e. embed-url is not set), the output will position the text correctly (from the metrics file), but it will not be displayed or printed correctly unless the viewer has the applicable font available to their local system.
    • -
  • When setting the "embed-url" attribute for Type 1 fonts, be sure to specify the PFB (actual font data), not PFM (font metrics) file that you used to generate the XML font metrics file.
    • -
  • The attribute "encoding-mode" is optional an may have the following values: -
      -
    • auto: default font encoding mode ("cid" for Truetype, "single-byte" for Type 1)
      • -
    • single-byte: use single-byte encodings in the target format (if applicable)
      • -
    • cid: encode as CID-keyed font (currently only supported for PDF output with TrueType fonts)
      • -
    -
    • -
  • The fonts "directory" tag can be used to register fonts contained within a single or list of directory paths. The "recursive" attribute can be specified to recursively add fonts from all sub directories.
    • -
  • The fonts "auto-detect" tag can be used to automatically register fonts that are found to be installed on the native operating system.
    • -
  • Fonts registered with "font" tag configurations override fonts found by means of "directory" tag definitions.
    • -
  • Fonts found as a result of a "directory" tag configuration override fonts found as a result of the "auto-detect" tag being specified.
    • -
  • - If relative URLs are specified, they are evaluated relative to the value of the - "font-base" setting. If there is no "font-base" setting, the fonts are evaluated - relative to the base directory. -
    • -
- -
-
- Auto-Detect and auto-embed feature -

When the "auto-detect" flag is set in the configuration, FOP will automatically search for fonts in the default paths for your operating system.

-

FOP will also auto-detect fonts which are available in the classpath, if they are described as "application/x-font" in the MANIFEST.MF file. For example, if your .jar file contains font/myfont.ttf:

- Manifest-Version: 1.0 - - Name: font/myfont.ttf - Content-Type: application/x-font -

This feature allows you to create JAR files containing fonts. The JAR files can be added to fop by providem them in the classpath, e.g. copying them into the lib/ directory.

-
-
- Embedding -

- By default, all fonts are embedded if an output format supports font embedding. In some - cases, however, it is preferred that some fonts are only referenced. When working - with referenced fonts it is important to be in control of the target environment where - the produced document is consumed, i.e. the necessary fonts have to be installed there. -

-

- There are two different ways how you can specify that a font should be referenced: -

-
    -
  1. - When using the old-style "font" element to configure a single font, font referencing - is controlled by the embed-url attribute. If you don't specify the embed-url attribute - the font will not be embedded, but will only be referenced. -
    2. -
  2. - For automatically configured fonts there's a different mechanism to specify which - fonts should be referenced rather than embedded. This is done in the "referenced-fonts" - element in the configuration. Here's an example: -
    3. -
- - - - - - - -]]> -

- At the moment, you can only match fonts against their font-family. It is possible to use - regular expressions as is shown in the second example above ("DejaVu.*"). The syntax for - the regular expressions used here are the one used by the - java.util.regex package. - So, in the above snippet "Helvetica" and all variants of the "DejaVu" font family are - referenced. If you want to reference all fonts, just specify font-family=".*". -

-

- The referenced-fonts element can be placed either inside the general - fonts element (right under the root) or in the fonts element - under the renderer configuration. In the first case, matches apply to all renderers. - In the second case, matches only apply to the renderer where the element was specified. - Both cases can be used at the same time. -

-

- Various notes related to embedded fonts: -

-
    -
  • The PostScript renderer does not yet support TrueType fonts, but can embed Type 1 fonts.
    • -
  • The font is simply embedded into the PDF file, it is not converted.
    • -
  • When FOP embeds a font, it adds a prefix to the fontname to ensure that the name will not match the fontname of an installed font. - This is helpful with older versions of Acrobat Reader that preferred installed fonts over embedded fonts.
    • -
  • When embedding PostScript fonts, the entire font is always embedded.
    • -
  • When embedding TrueType fonts (ttf) or TrueType Collections (ttc), a subset of the - original font, containing only the glyphs used, is embedded in the output document. - That's the default, but if you specify encoding-mode="single-byte" (see above), the - complete font is embedded.
    • -
-
-
- Substitution -

When a <substitutions/> section is defined in the configuration, FOP will re-map any font-family references found in your FO input to a given substitution font.

-
    -
  • If a <substitution/> is declared, it is mandatory that both a <from/> and <to/> child element is declared with a font-family attribute.
    • -
  • Both font-weight and font-style are optional attributes, if they are provided then a value of 'normal' is assumed.
    • -
-

For example you could make all FO font-family references to 'Arial' with weights between 700 and 900 reference the normal 'Arial Black' font.

- - - - - - - - - - - - - -]]> -
- -
-
- Font Selection Strategies -

- There are two font selection strategies: character-by-character or auto. The default is auto.

-

Auto selected the first font from the list which is able to display the most characters in a given word. This means (assume font A has characters for abclmn, font B for lnmxyz, fontlist is A,B):

-
    -
  • aaa lll xxx would be displayed in fonts A A B
    • -
  • aaaxx would be displayed in font A
    • -
  • aaaxxx would be displayed in font A
    • -
  • aaaxxxx would be displayed in font B
    • -
-

Character-by-Character is NOT yet supported!

-
-
- Font List Command-Line Tool -

- FOP contains a small command-line tool that lets you generate a list of all configured - fonts. Its class name is: org.apache.fop.tools.fontlist.FontListMain. - Run it with the "-?" parameter to get help for the various options. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/fotree/disabled-testcases.xml b/src/documentation/content/xdocs/1.0/fotree/disabled-testcases.xml deleted file mode 100644 index 196eafcc4..000000000 --- a/src/documentation/content/xdocs/1.0/fotree/disabled-testcases.xml +++ /dev/null @@ -1,31 +0,0 @@ - - - - - - demo test failure - demo-test-failure.fo - - - - Markers and core function evaluation - from-table-column_marker.fo - The code currently evaluates this function according to the column in which the - marker appears in the source document, rather than the column it is retrieved in. - - diff --git a/src/documentation/content/xdocs/1.0/graphics.xml b/src/documentation/content/xdocs/1.0/graphics.xml deleted file mode 100644 index b1653443a..000000000 --- a/src/documentation/content/xdocs/1.0/graphics.xml +++ /dev/null @@ -1,590 +0,0 @@ - - - - - -
- Apache™ FOP: Graphics Formats - $Revision$ -
- -
- Introduction -

- Some noteworthy features of the image handling subsystem are: -

-
    -
  • - The image libraries Jimi and JAI are not supported. Instead, Apache™ FOP uses the - Image I/O API that was introduced with Java 1.4 for all bitmap codecs. -
    • -
  • - Some bitmap images are not converted to a standardized 24 bit RGB image but are - instead handled in their native format. -
    • -
  • - A plug-in mechanism offers a possibility to add support for new formats without changing - the FOP's source code. -
    • -
-

- The actual image loading framework - does not reside in Apache FOP, but in - XML Graphics Commons. -

-
-
- Overview of Graphics Support -

- The table below summarizes the theoretical support for graphical formats - within FOP. In other words, within the constraints of the limitations listed here, - these formats should work. However, many of them have not been tested, - and there may be limitations that have not yet been discovered or documented. - The packages needed to support some formats are not included in the FOP distribution - and must be installed separately. Follow the links in the "Support Through" columns - for more details. -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FormatTypeSupport Through
Apache FOP (native)Apache BatikImage I/O
BMP (Microsoft Windows Bitmap)bitmap - - X [1]
EMF (Windows Enhanced Metafile)vector (with embedded bitmaps)(X) - -
EPS (Encapsulated PostScript)metafile (both bitmap and vector), most frequently used for vector drawings(X) - -
GIF (Graphics Interchange Format)bitmap - - X
JPEG (Joint Photographic Experts Group)bitmap(X) - X
PNG (Portable Network Graphic)bitmap - - X
SVG (Scalable Vector Graphics)vector (with embedded bitmaps) - X -
TIFF (Tag Image Format File)bitmap(X) - X [1]
WMF (Windows Metafile)vector (with embedded bitmaps) - (X) -
-

- Legend: -

-
    -
  • "(X)" means restricted support. Please see the details below.
    • -
  • - [1]: Requires the presence of JAI Image I/O Tools - (or an equivalent Image I/O compatible codec) in the classpath. JAI Image I/O Tools also - adds support for JPEG 2000, WBMP, RAW and PNM. Other Image I/O codecs may provide - support for additional formats. -
    • -
- - JAI Image I/O Tools is not the same as the - JAI library! The - former simply exposes JAI's codecs using the Image&nbsp;I/O API but does not include all - the image manipulation functionality. - -
- Map of supported image formats by output format -

- Not all image formats are supported for all output formats! For example, while you can - use EPS (Encapsulated PostScript) files when you generate PostScript output, this format - will not be supported by any other output format. Here's an overview of which image - formats are supported by which output format: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Image FormatPDFPostScriptJava2D, PNG, TIFF, AWTPCLAFPRTF
BMP (Microsoft Windows Bitmap)XXXXXX
EMF (Windows Enhanced Metafile) - - - - - X [1]
EPS (Encapsulated PostScript) - X [1] - - - -
GIF (Graphics Interchange Format)XXXXXX
JPEG (Joint Photographic Experts Group)X [1]X [1]XXX [1]X
PNG (Portable Network Graphic)XXXXXX
SVG (Scalable Vector Graphics)XXXXXX
TIFF (Tag Image Format File)X [2]X [2]XXX [2]X
WMF (Windows Metafile)XXXXXX
-

- Legend: -

-
    -
  • - [1]: Supported without the need to decode the image. -
    • -
  • - [2]: Supported without the need to decode the image, but only for certain subtypes. -
    • -
-
-
-
- Graphics Packages -
- XML Graphics Commons Native -

- XML Graphics Commons supports a number - of graphic file formats natively as basic functionality: all bitmap formats for which - there are Image I/O codecs available (JPEG, PNG, GIF, TIFF, etc.), EPS and EMF. -

-
-
- FOP Native -

- FOP has no native image plug-ins for the image loading framework of its own but currently - hosts the Batik-dependent SVG and WMF plug-ins until they can be moved to - Apache Batik. -

-
-
- Apache Batik -

- Apache Batik will later receive the - SVG and WMF plug-ins for the image loading framework that are currently hosted inside - FOP. -

-

- Current FOP distributions include a distribution of the - Apache Batik. - Because Batik's API changes frequently, it is highly recommended that you use the - version that ships with FOP, at least when running FOP. -

- Batik must be run in a graphical environment. -

- Batik must be run in a graphical environment. - It uses AWT classes for rendering SVG, which in turn require an X server on Unixish - systems. If you run a server without X, or if you can't connect to the X server due to - security restrictions or policies (a so-called "headless" environment), SVG rendering - will fail. -

-

Here are some workarounds:

-
    -
  • - Start Java with the -Djava.awt.headless=true command line option. -
    • -
  • - Install an X server which provides an in-memory framebuffer without actually using a - screen device or any display hardware. One example is Xvfb. -
    • -
  • - Install a toolkit which emulates AWT without the need for an underlying X server. One - example is the PJA toolkit, which is free - and comes with detailed installation instructions. -
    • -
-
-
- Image I/O -

- The image loading framework in XML Graphics Commons - provides a wrapper to load images through the - JDK's Image I/O API (JSR 015). - Image I/O allows to dynamically add additional image codecs. An example of such an - add-on library are the - JAI Image I/O Tools - available from Sun. -

-
-
-
- Details on image formats -
- BMP -

- BMP images are supported through an Image I/O codec. There may be limitations of the - codec which are outside the control of Apache FOP. -

-
-
- EMF -

- Windows Enhanced Metafiles (EMF) are only supported in RTF output where they are - embedded without decoding. -

-
-
- EPS -

Apache FOP allows to use EPS files when generating PostScript output only.

-

- Other output targets can't be supported at the moment because - FOP lacks a PostScript interpreter. Furthermore, FOP is currently not able - to parse the preview bitmaps sometimes contained in EPS files. -

-
-
- GIF -

- GIF images are supported through an Image&nbsp;I/O codec. Transparency is supported but - not guaranteed to work with every output format. -

-
-
- JPEG -

- FOP native support (i.e. the handling of undecoded images) of JPEG does not include all - variants, especially those containing unusual color lookup tables and color profiles. - If you have trouble with a JPEG image in FOP, try opening it with an image processing - program (such as Photoshop or Gimp) and then saving it. Specifying 24-bit color output - may also help. For the PDF and PostScript renderers most JPEG images can be passed - through without decompression. User reports indicate that grayscale, RGB, and - CMYK color spaces are all rendered properly. However, for other output formats, the - JPEG images have to be decompressed. Tests have shown that there are some limitation - in some Image&nbsp;I/O codecs concerning images in the CMYK color space. Work-arounds are - in place but may not always work as expected. -

-
-
- PNG -

- PNG images are supported through an Image&nbsp;I/O codec. Transparency is supported but - not guaranteed to work with every output format. -

-
-
- SVG -
- Introduction -

FOP uses Apache Batik for SVG support. - This format can be handled as an fo:instream-foreign-object or in a separate - file referenced with fo:external-graphic.

- - Batik's SVG Rasterizer utility may also be used to convert standalone SVG - documents into PDF. For more information please see the - SVG Rasterizer documentation - on the Batik site. - -
-
- Placing SVG Graphics into PDF -

- The SVG is rendered into PDF by using PDF commands to draw and fill - lines and curves. This means that the graphical objects created with - this remain as vector graphics. The same applies to PostScript output. - For other output formats the SVG graphic may be converted to a bitmap - image. -

-

- There are a number of SVG things that cannot be converted directly into - PDF. Parts of the graphic such as effects, patterns and images are inserted - into the PDF as a raster graphic. The resolution of these raster images can - be controlled through the "target resolution" setting in the - configuration.

-

- Currently transparency is limited in PDF so some SVG images that - contain effects or graphics with transparent areas may not be displayed - correctly. -

-
-
- Placing SVG Text into PDF and PostScript -

If possible, Batik will use normal PDF or PostScript text when inserting text. It does - this by checking if the text can be drawn normally and the font is - supported. This example svg text.svg / - text.pdf / text.png - shows how various types and effects with text are handled. - Note that SVG font support is not yet implemented. Furthermore, text handling in - PostScript output is inferior to PDF output - more text will be painted as shapes in - PS than in PDF. -

-

- When there's no support to paint text using native text operations, - text is converted and drawn as a set of shapes by Batik, using the - stroking text painter. This means that a typical character will - have about 10 curves (each curve consists of at least 20 characters). - This can make the output files large and when it is viewed the - viewer may not normally draw those fine curves very well (In Adobe Acrobat, turning on - "Smooth Line Art" in the preferences will fix this). Copy/paste functionality - will not be supported in this case. - If the text is inserted into the output file using the inbuilt text commands - it will use a single character. -

-

- Note that because SVG text can be rendered as either text or a vector graphic, you - may need to consider settings in your viewer for both. The Acrobat viewer has both - "smooth line art" and "smooth text" settings that may need to be set for SVG images - to be displayed nicely on your screen (see Edit / Preferences / Display). - This setting will not affect the printing of your document, which should be OK in - any case, but will only affect the quality of the screen display. -

-
-
- Font selection notes -

- Apache Batik uses the AWT/Java2D subsystem as font source while FOP has its own font - subsystem. Great care has been taken that font selection does the best possible choices. - But it must be noted when creating PDF or PostScript that a font used in SVG graphics - needs to be registered with the operating system as well as in FOP's configuration. - By using FOP's font auto-detection, you simply have to install the font in the operating - system and not care about anything else. This is less of an issue if you create - formats like TIFFs, PNGs or PCL because in these cases SVG graphics are usually rendered - to bitmaps which means that on both sides (Batik and FOP), AWT/Java2D is used as the - single font source. -

-

- Whenever an SVG is converted into a PDF or PostScript file, the font that has been used - inside Batik has to be mapped to a font used by the actual output format. Features like - font substitution in FOP may need to be taken into account but can also be an advantage - when working around font mapping issues. Like for XSL-FO content, you'll get a warning - if a particular font could not be found and had to be substituted, or if a particular - glyph is missing in a font. -

-
-
- Scaling -

- Currently, SVG images are rendered with the dimensions specified in the SVG - file, within the viewport specified in the fo:external-graphic element. - For everything to work properly, the two should be equal. The SVG standard leaves - this issue as an implementation detail. Additional scaling options are available - through XSL-FO means. -

-

- If you use pixels to specify the size of an SVG graphic the "source resolution" setting - in the configuration will be used to determine the - size of a pixel. The use of pixels to specify sizes is discouraged as they may - be interpreted differently in different environments. -

-
-
- Known Problems -
    -
  • - Soft mask transparency is combined with white so that it looks better - on PDF 1.3 viewers but this causes the soft mask to be slightly lighter - or darker on PDF 1.4 viewers. -
    • -
  • - There is some problem with a gradient inside a pattern which may cause a PDF - error when viewed in Acrobat 5. -
    • -
  • - Text is not always handled correctly, it may select the wrong font - especially if characters have multiple fonts in the font list. -
    • -
  • - Uniform transparency for images and other SVG elements that are converted - into a raster graphic are not drawn properly in PDF. The image is opaque. -
    • -
-
-
-
- TIFF -

- FOP can embed TIFF images without decompression into PDF, PostScript and AFP if they - have either CCITT T.4, CCITT T.6, or JPEG compression. Otherwise, a TIFF-capable - Image&nbsp;I/O codec is necessary for decoding the image. -

-

- There may be some limitation concerning images in the CMYK color space. -

-
-
- WMF -

- Windows Metafiles (WMF) are supported through classes in - Apache Batik. At the moment, support - for this format is experimental and may not always work as expected. -

-
-
-
- Graphics Resolution -

- Some bitmapped image file formats store a dots-per-inch (dpi) or other resolution - values. FOP tries to use this resolution information whenever possible to determine - the image's intrinsic size. This size is used during the layout process when it is not - superseded by an explicit size on fo:external-graphic (content-width and content-height - properties). -

-

- Please note that not all images contain resolution information. If it's not available - the source resolution set on the FopFactory (or through the user configuration XML) is used. - The default here is 72 dpi. -

-

- Bitmap images are generally embedded into the output format at their original resolution - (as is). No resampling of the image is performed. Explicit resampling is on our wishlist, - but hasn't been implemented, yet. Bitmaps included in SVG graphics may be resampled to - the resolution specified in the "target resolution" setting in the - configuration if SVG filters are applied. This can be - used as a work-around to resample images in FO documents. -

-
-
- Page selection for multi-page formats -

- Some image formats such as TIFF support multiple pages/sub-images per file. You can - select a particular page using a special URI fragment in the form: - <uri>#page=<nr> - (for example: http://localhost/images/myimage.tiff#page=3) -

-
-
- Image caching -

- FOP caches images between runs. There is one cache per FopFactory instance. The URI is - used as a key to identify images which means that when a particular URI appears again, - the image is taken from the cache. If you have a servlet that generates a different - image each time it is called with the same URI you need to use a constantly - changing dummy parameter on the URI to avoid caching. -

-

- The image cache has been improved considerably in the redesigned code. Therefore, - resetting the image cache should be a thing of the past. If you - still experience OutOfMemoryErrors, please notify us. -

-

- If all else fails, the image cache can be cleared like this: - fopFactory.getImageManager().getCache().clearCache(); -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/hyphenation.xml b/src/documentation/content/xdocs/1.0/hyphenation.xml deleted file mode 100644 index 1d1c63d82..000000000 --- a/src/documentation/content/xdocs/1.0/hyphenation.xml +++ /dev/null @@ -1,237 +0,0 @@ - - - - - -
- Apache™ FOP: Hyphenation - $Revision$ -
- -
- Hyphenation Support -
- Introduction -

Apache™ FOP uses Liang's hyphenation algorithm, well known from TeX. It needs - language specific pattern and other data for operation.

-

Because of licensing issues (and for - convenience), all hyphenation patterns for FOP are made available through - the Objects For - Formatting Objects project.

- If you have made improvements to an existing FOP hyphenation pattern, - or if you have created one from scratch, please consider contributing these - to OFFO so that they can benefit other FOP users as well. - Please inquire on the FOP User - mailing list. -
-
- License Issues -

Many of the hyphenation files distributed with TeX and its offspring are - licenced under the LaTeX - Project Public License (LPPL), which prevents them from being - distributed with Apache software. The LPPL puts restrictions on file names - in redistributed derived works which we feel can't guarantee. Some - hyphenation pattern files have other or additional restrictions, for - example against use for commercial purposes.

-

Although Apache FOP cannot redistribute hyphenation pattern files that do - not conform with its license scheme, that does not necessarily prevent users - from using such hyphenation patterns with FOP. However, it does place on - the user the responsibility for determining whether the user can rightly use - such hyphenation patterns under the hyphenation pattern license.

- The user is responsible to settle license issues for hyphenation - pattern files that are obtained from non-Apache sources. -
-
- Sources of Custom Hyphenation Pattern Files -

The most important source of hyphenation pattern files is the - CTAN TeX - Archive.

-
-
- Installing Custom Hyphenation Patterns -

To install a custom hyphenation pattern for use with FOP:

-
    -
  1. Convert the TeX hyphenation pattern file to the FOP format. The FOP - format is an xml file conforming to the DTD found at - {fop-dir}/hyph/hyphenation.dtd.
    2. -
  2. Name this new file following this schema: - languageCode_countryCode.xml. The country code is - optional, and should be used only if needed. For example: -
      -
    • en_US.xml would be the file name for American - English hyphenation patterns.
      • -
    • it.xml would be the file name for Italian - hyphenation patterns.
      • -
    - The language and country codes must match the XSL-FO input, which - follows ISO - 639 (languages) and ISO - 3166 (countries). NOTE: The ISO 639/ISO 3166 convention is that - language names are written in lower case, while country codes are written - in upper case. FOP does not check whether the language and country specified - in the FO source are actually from the current standard, but it relies - on it being two letter strings in a few places. So you can make up your - own codes for custom hyphenation patterns, but they should be two - letter strings too (patches for proper handling extensions are welcome)
    3. -
  3. There are basically three ways to make the FOP-compatible hyphenation pattern - file(s) accessible to FOP: -
      -
    • Download the precompiled JAR from OFFO - and place it either in the {fop-dir}/lib directory, or - in a directory of your choice (and append the full path to the JAR to - the environment variable FOP_HYPHENATION_PATH).
      • -
    • Download the desired FOP-compatible hyphenation pattern file(s) from - OFFO, - and/or take your self created hyphenation pattern file(s), -
        -
      • place them in the directory {fop-dir}/hyph,
        • -
      • or place them in a directory of your choice and set the Ant variable - user.hyph.dir to point to that directory (in - build-local.properties),
        • -
      - and run Ant with build target - jar-hyphenation. This will create a JAR containing the - compiled patterns in {fop-dir}/build that will be added to the - classpath on the next run. - (When FOP is built from scratch, and there are pattern source file(s) - present in the directory pointed to by the - user.hyph.dir variable, this JAR will automatically - be created from the supplied pattern(s)).
      • -
    • Put the pattern source file(s) into a directory of your choice and - configure FOP to look for custom patterns in this directory, by setting the - <hyphenation-base> - configuration option.
      • -
    -
    4. -
- - Either of these three options will ensure hyphenation is working when using - FOP from the command-line. If FOP is being embedded, remember to add the location(s) - of the hyphenation JAR(s) to the CLASSPATH (option 1 and 2) or to set the - <hyphenation-dir> - configuration option programmatically (option 3). - -
-
-
- Hyphenation Patterns -

If you would like to build your own hyphenation pattern files, or modify - existing ones, this section will help you understand how to do so. Even - when creating a pattern file from scratch, it may be beneficial to start - with an existing file and modify it. See - OFFO's Hyphenation page for examples. - Here is a brief explanation of the contents of FOP's hyphenation patterns:

- The remaining content of this section should be considered "draft" - quality. It was drafted from theoretical literature, and has not been - tested against actual FOP behavior. It may contain errors or omissions. - Do not rely on these instructions without testing everything stated here. - If you use these instructions, please provide feedback on the - FOP User mailing list, either - confirming their accuracy, or raising specific problems that we can - address. -
    -
  • The root of the pattern file is the <hyphenation-info> element.
    • -
  • <hyphen-char>: its attribute "value" contains the character signalling - a hyphen in the <exceptions> section. It has nothing to do with the - hyphenation character used in FOP, use the XSLFO hyphenation-character - property for defining the hyphenation character there. At some points - a dash U+002D is hardwired in the code, so you'd better use this too - (patches to rectify the situation are welcome). There is no default, - if you declare exceptions with hyphenations, you must declare the - hyphen-char too.
    • -
  • <hyphen-min> contains two attributes: -
      -
    • before: the minimum number of characters in a word allowed to exist - on a line immediately preceding a hyphenated word-break.
      • -
    • after: the minimum number of characters in a word allowed to exist - on a line immediately after a hyphenated word-break.
      • -
    - This element is unused and not even read. It should be considered a - documentation for parameters used during pattern generation. -
    • -
  • <classes> contains whitespace-separated character sets. The members - of each set should be treated as equivalent for purposes of hyphenation, - usually upper and lower case of the same character. The first character - of the set is the canonical character, the patterns and exceptions - should only contain these canonical representation characters (except - digits for weight, the period (.) as word delimiter in the patterns and - the hyphen char in exceptions, of course).
    • -
  • <exceptions> contains whitespace-separated words, each of which - has either explicit hyphen characters to denote acceptable breakage - points, or no hyphen characters, to indicate that this word should - never be hyphenated, or contain explicit <hyp> elements for specifying - changes of spelling due to hyphenation (like backen -> bak-ken or - Stoffarbe -> Stoff-farbe in the old german spelling). Exceptions override - the patterns described below. Explicit <hyp> declarations don't work - yet (patches welcome). Exceptions are generally a bit brittle, test - carefully.
    • -
  • <patterns> includes whitespace-separated patterns, which are what - drive most hyphenation decisions. The characters in these patterns are - explained as follows: -
      -
    • non-numeric characters represent characters in a sub-word to be - evaluated
      • -
    • the period character (.) represents a word boundary, i.e. either - the beginning or ending of a word
      • -
    • numeric characters represent a scoring system for indicating the - acceptability of a hyphen in this location. Odd numbers represent an - acceptable location for a hyphen, with higher values overriding lower - inhibiting values. Even numbers indicate an unacceptable location, with - higher values overriding lower values indicating an acceptable position. - A value of zero (inhibiting) is implied when there is no number present. - Generally patterns are constructed so that valuse greater than 4 are rare. - Due to a bug currently patterns with values of 8 and greater don't - have an effect, so don't wonder.
      • -
    - Here are some examples from the English patterns file: -
      -
    • Knuth (The TeXBook, Appendix H) uses the example hach4, which indicates that it is extremely undesirable to place a hyphen after the substring "hach", for example in the word "toothach-es".
      • -
    • .leg5e indicates that "leg-e", when it occurs at the beginning of a word, is a very good place to place a hyphen, if one is needed. Words like "leg-end" and "leg-er-de-main" fit this pattern.
      • -
    - Note that the algorithm that uses this data searches for each of the word's substrings in the patterns, and chooses the highest value found for letter combination. -
    • -
-

If you want to convert a TeX hyphenation pattern file, you have to undo - the TeX encoding for non-ASCII text. FOP uses Unicode, and the patterns - must be proper Unicode too. You should be aware of the XML encoding issues, - preferably use a good Unicode editor.

-

Note that FOP does not do Unicode character normalization. If you use - combining chars for accents and other character decorations, you must - declare character classes for them, and use the same sequence of base character - and combining marks in the XSLFO source, otherwise the pattern wouldn't match. - Fortunately, Unicode provides precomposed characters for all important cases - in common languages, until now nobody run seriously into this issue. Some dead - languages and dialects, especially ancient ones, may pose a real problem - though.

-

If you want to generate your own patterns, an open-source utility called - patgen is available on many Unix/Linux distributions and every TeX - distribution which can be used to assist in - creating pattern files from dictionaries. Pattern creation for languages like - english or german is an art. If you can, read Frank Liang's original paper - "Word Hy-phen-a-tion by Com-pu-ter" (yes, with hyphens). It is not available - online. The original patgen.web source, included in the TeX source distributions, - contains valuable comments, unfortunately technical details obscure often the - high level issues. Another important source is - The - TeX Book, appendix H (either read the TeX source, or run it through - TeX to typeset it). Secondary articles, for example the works by Petr Sojka, - may also give some much needed insight into problems arising in automated - hyphenation.

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/index.xml b/src/documentation/content/xdocs/1.0/index.xml deleted file mode 100644 index d05299d1e..000000000 --- a/src/documentation/content/xdocs/1.0/index.xml +++ /dev/null @@ -1,67 +0,0 @@ - - - - - -
- Apache™ FOP Version 1.0 - $Revision$ -
- -
- Introduction -

- The Apache™ FOP team is proud to present to you this production - quality codebase. FOP 1.0 provides a good subset of the W3C - XSL-FO 1.0 and 1.1 Standards. Its stable, 1.0 designation - provides added recognition as the productive tool it has been - for years. -

-

- We remain committed to improving the tool, and we continue to - add new features. We welcome any feedback you might have and - even more, any other form of help to get the project forward. -

-

- This release contains many bug fixes and new features compared - to the previous version. To see what has changed since the last release, please visit the - Changes Page and the - Release Notes. -

-

- This release implements a good subset of the W3C XSL-FO 1.0 - and 1.1 Standards. For a detailed overview of FOP's - compliance, visit the compliance - page. -

-
-
- Upgrading from an earlier version -

- If you're upgrading to this version from an earlier version of FOP, please read the - information contained on the Upgrading page! -

-
-
- Download -

- To download this version, please visit the download page. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/intermediate.xml b/src/documentation/content/xdocs/1.0/intermediate.xml deleted file mode 100644 index a154ce733..000000000 --- a/src/documentation/content/xdocs/1.0/intermediate.xml +++ /dev/null @@ -1,331 +0,0 @@ - - - - - -
- Apache™ FOP: Intermediate Format - $Revision$ -
- - - Please note that the intermediate formats described here are - advanced features and can be ignored by most users of Apache™ FOP. - -
- Introduction -

- Apache FOP now provides two different so-called intermediate formats. The first one - (let's call it the area tree XML format) is basically a 1:1 XML representation of FOP's - area tree as generated by the layout engine. The area tree is conceptually defined in the - XSL-FO specification in chapter 1.1.2. - Even though the area tree is mentioned in the XSL-FO specification, this part is not - standardized. Therefore, the area tree XML format is a FOP-proprietary XML file format. - The area tree XML can be generated through the area tree XML Renderer (the XMLRenderer). -

-

- The second intermediate format (which we shall name exactly like this: the intermediate - format) - is a recent addition which tries to meet a slightly different set of goals. It is highly - optimized for speed. -

-

- The intermediate format can be used to generate intermediate documents that are modified - before they are finally rendered to their ultimate output format. Modifications include - adjusting and changing trait values, adding or modifying area objects, inserting prefabricated - pages, overlays, imposition (n-up, rotation, scaling etc.). Multiple IF files can be combined - to a single output file. -

-
-
- Which Intermediate Format to choose? -

- Both formats have their use cases, so the choice you will make will depend on your - particular situation. Here is a list of strengths and use cases for both formats: -

-
- Area Tree XML (AT XML) -
    -
  • 1:1 representation of FOP's area tree in XML.
    • -
  • Contains more structure information than the new intermediate format.
    • -
  • Used in FOP's layout engine test suite for regression testing.
    • -
-
-
- Intermediate Format (IF) -
    -
  • Highly optimized for speed.
    • -
  • Smaller XML files.
    • -
  • Easier to post-process.
    • -
  • XML Schema is available.
    • -
  • - Recommended for use cases where documents are formatted concurrently and later - concatenated to a single print job. -
    • -
-
-

- More technical information about the two formats can be found on the - FOP Wiki. -

-
-
- Architectural Overview -
-
-
- Usage of the Area Tree XML format (AT XML) -

- As already mentioned, the area tree XML format is generated by using the - XMLRenderer (MIME type: application/X-fop-areatree). - So, you basically set the right MIME type for the output format and process your FO files - as if you would create a PDF file. -

-

- However, there is an important detail to consider: The - various Renderers don't all use the same font sources. To be able to create the right - area tree for the ultimate output format, you need to create the area tree XML file using - the right font setup. This is achieved by telling the XMLRenderer to mimic another - renderer. This is done by calling the XMLRenderer's mimicRenderer() method with an - instance of the ultimate target renderer as the single parameter. This has a consequence: - An area tree XML file rendered with the Java2DRenderer may not look as expected when it - was actually generated for the PDF renderer. For renderers that use the same font setup, - this restriction does not apply (PDF and PS, for example). Generating the area tree XML - format file is the first step. -

-

- The second step is to reparse the file using the AreaTreeParser which is - found in the org.apache.fop.area package. The pages retrieved from the area tree XML file - are added to an AreaTreeModel instance from where they are normally rendered using one of - the available Renderer implementations. You can find examples for the area tree XML - processing in the - examples/embedding - directory in the FOP distribution. -

-

- The basic pattern to parse the area tree XML format looks like this: -

- -

- This example simply reads an area tree file and renders it to a PDF file. Please note, that in normal - FOP operation you're shielded from having to instantiate the FontInfo object yourself. This - is normally a task of the AreaTreeHandler which is not present in this scenario. The same - applies to the AreaTreeModel instance, in this case an instance of a subclass called - RenderPagesModel. RenderPagesModel is ideal in this case as it has very little overhead - processing the individual pages. An important line in the example is the call to - endDocument() on the AreaTreeModel. This lets the Renderer know that the processing - is now finished. -

-

- The area tree XML format can also be used from the command-line - by using the "-atin" parameter for specifying the area tree XML as input file. You can also - specify a "mimic renderer" by inserting a MIME type between "-at" and the output file. -

-
- Concatenating Documents -

- This initial example is obviously not very useful. It would be faster to create the PDF file - directly. As the ExampleConcat.java - example shows you can easily parse multiple area tree files in a row and add the parsed pages to the - same AreaTreeModel instance which essentially concatenates all the input document to one single - output document. -

-
-
- Modifying Documents -

- One of the most important use cases for this format is obviously modifying the area - tree XML before finally rendering it to the target format. You can easily use XSLT to process - the AT XML file according to your needs. Please note, that we will currently not formally describe - the area tree XML format. You need to have a good understanding its structure so you don't - create any non-parseable files. We may add an XML Schema and more detailed documentation at a - later time. You're invited to help us with that. -

- - The area tree XML format is sensitive to changes in whitespace. If you're not careful, - the modified file may not render correctly. - -
-
- Advanced Use -

- The generation of the area tree format as well as it parsing process has been designed to allow - for maximum flexibility and optimization. Please note that you can call setTransformerHandler() on - XMLRenderer to give the XMLRenderer your own TransformerHandler instance in case you would like to - do custom serialization (to a W3C DOM, for example) and/or to directly modify the area tree using - XSLT. The AreaTreeParser on the other side allows you to retrieve a ContentHandler instance where - you can manually send SAX events to to start the parsing process (see getContentHandler()). -

-
-
-
- Usage of the Intermediate Format (IF) -

- The Intermediate Format (IF) is generated by the IFSerializer - (MIME type: application/X-fop-intermediate-format). - So, you basically set the right MIME type for the output format and process your FO files - as if you would create a PDF file. -

-

- The IFSerializer is an implementation of the IFDocumentHandler and - IFPainter interfaces. The IFRenderer class is responsible - for converting FOP's area tree into calls against these two interfaces. -

-
    -
  • - IFDocumentHandler: This interface is used on the document-level and defines the - overall structure of the Intermediate Format. -
    • -
  • - IFPainter: This interface is used to generate graphical page content like text, images - and borders. -
    • -
-

- As with the AT XML, there is an important detail to consider: The various output - implementations don't all use the same font sources. To be able - to create the right IF for the ultimate output file, you need to create the IF file using - the right font setup. This is achieved by telling the IFRenderer (responsible for - converting the area tree into calls to the IFDocumentHandler and IFPainter interfaces) - to mimic another renderer. This is done by calling the IFSerializer's - mimicDocumentHandler() method with an instance of the ultimate target document handler - as the single parameter. This has a consequence: An IF file rendered with the - Java2DDocumentHandler may not look as expected when it was actually generated for the PDF - implementation. For implementations that use the same font setup, - this restriction does not apply (PDF and PS, for example). Generating the Intermediate - Format file is the first step. -

-

- The second step is to reparse the file using the IFParser which is - found in the org.apache.fop.render.intermediate package. The IFParser simply takes an - IFDocumentHandler instance against which it generates the appropriate calls. The IFParser - is implemented as a SAX ContentHandler so you're free to choose the method for - post-processing the IF file(s). You can use XSLT or write SAX- or DOM-based code to - manipulate the contents. You can find examples for the Intermediate Format - processing in the - examples/embedding - directory in the FOP distribution. -

-

- The basic pattern to parse the intermediate format looks like this: -

- -

- This example simply reads an intermediate file and renders it to a PDF file. Here - IFParser.parse() is used, but you can also just get a SAX ContentHandler by using the - IFParser.getContentHandler() method. -

-
- Concatenating Documents -

- This initial example is obviously not very useful. It would be faster to create the PDF file - directly (without the intermediate step). As the - ExampleConcat.java - example shows you can easily parse multiple intermediate files in a row and use the - IFConcatenator class to concatenate page sequences from multiple source files to a single - output file. This particular example does the concatenation on the level of the - IFDocumentHandler interface. You could also do this in XSLT or using SAX on the XML level. - Whatever suits your process best. -

-
-
- Modifying Documents -

- One of the most important use cases for this format is obviously modifying the - intermediate format before finally rendering it to the target format. You can easily use - XSLT to process the IF file according to your needs. -

-

- There is an XML Schema (located under - src/documentation/intermediate-format-ng) - that helps you verify that your modified content is correct. -

-

- For certain output formats there's a caveat: Formats like AFP and PCL do not support - arbitrary transformations on the IF's "viewport" and "g" elements. Possible are - only rotations in 90 degree steps and translations. -

-
-
- Advanced Use -

- The generation of the intermediate format as well as it parsing process has been - designed to allow for maximum flexibility and optimization. So rather than just passing - in a StreamResult to IFSerializer's setResult() method, you can also use a SAXResult - or a DOMResult. And as you've already seen , the IFParser on the other side allows you - to retrieve a ContentHandler instance where you can manually send SAX events to - start the parsing process (see getContentHandler()). -

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/known-issues.xml b/src/documentation/content/xdocs/1.0/known-issues.xml deleted file mode 100644 index 2ef4b7102..000000000 --- a/src/documentation/content/xdocs/1.0/known-issues.xml +++ /dev/null @@ -1,91 +0,0 @@ - - - - - - MIF and SVG output support have not been restored, yet. - - - RTF output is inferior to other output formats supported by FOP. - For details, please see the "Output Targets" page of the release - you're using. - - - Auto table layout is not implemented, yet. - - - Footnotes may overlap with text of the region-body in multi-column - documents. - - - Space resolution does not work between footnote regions. - - - There's a problem involving nested block-containers and - reference-orientation 180/-180 (Bugzilla #36391) - - - block-containers with no height currently don't create a fence for - spaces as they should (they behave like a normal block). - - - Preserved linefeeds in fo:character are not handled correctly. - - - An empty block currently produces a fence for stacking constraints - which it shouldn't. - - - There are several small problems around white space handling. - - - Images currently don't shrink so they fit on a page when they are - too big and shrinking is allowed to happen. - - - inline-container may not work as expected. - - - letter-spacing and word-spacing properties may not work as expected. - - - leaders with leader-pattern="use-content" may not work as expected. - - - keep-with-previous doesn't work inside tables and lists, yet. - - - If two consecutive pages don't have the same available width, the - content currently isn't properly fit into the available space on - the new page. - - - background-images on page-number-citations are not placed correctly. - - - Not all FO elements can be referenced by their "id", most notably: - table-body, table-header, table-footer and table-row. - - - Border and padding conditionality are not supported on table-cells, yet. - - - Column balancing in multi-column documents may not work as expected - (Bugzilla #36356) - - diff --git a/src/documentation/content/xdocs/1.0/knownissues_overview.xml b/src/documentation/content/xdocs/1.0/knownissues_overview.xml deleted file mode 100644 index 8daa97490..000000000 --- a/src/documentation/content/xdocs/1.0/knownissues_overview.xml +++ /dev/null @@ -1,69 +0,0 @@ - - - - - -
- Apache™ FOP: Known Issues - $Revision$ -
- -
- Known issues -

- This page lists currently known issues in the current release. -

- -

- For additional information on known issues in Apache™ FOP, please have a look at the following pages, too: -

- - -

- Apache™ FOP has an extensive automated testing infrastructure. Parts of this infrastructure are several - sets of test cases. When a test case is listed in disabled-testcases.xml it is disabled in the JUnit - tests during the normal build process. This indicates a problem in the current codebase. When a bug is - fixed or a missing feature is added the entry for the relevant test case(s) are removed. -

-
- FO Tree -

- This section lists disabled test cases in the test suite for the FO tree tests, at the time - of the release. -

- -
-
- Layout Engine -

- This section lists disabled test cases in the test suite for the layout engine tests, at the - time of the release. -

- -
-
- Other known issues -

This section lists other known issues.

- -
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/layoutengine/disabled-testcases.xml b/src/documentation/content/xdocs/1.0/layoutengine/disabled-testcases.xml deleted file mode 100644 index 1fb4f2926..000000000 --- a/src/documentation/content/xdocs/1.0/layoutengine/disabled-testcases.xml +++ /dev/null @@ -1,225 +0,0 @@ - - - - - - - - External link around an SVG not properly sized - basic-link_external-destination_2.xml - The bpd trait of the inlineparent area for the basic-link - is not sized correctly if it wraps an image that is higher than the - nominal line. - - - Auto-height block-containers produce fences - block-container_space-before_space-after_3.xml - Block-containers with no height currently don't - create a fence for spaces as they should (they behave like a - normal block). - - - font-stretch NYI - block_font-stretch.xml - Font-stretch is not implemented, yet. - - - Hyphenation with preserved linefeeds - block_hyphenation_linefeed_preserve.xml - When hyphenation is enabled and linefeeds are preserved, - the text is output multiple times. - - - linefeed-treatment - block_linefeed-treatment.xml - Preserved linefeeds in a fo:character are not handled - correctly. - - - white-space-treatment - block_white-space-treatment_3.xml - White space handling incorrectly stops at fo:inline - boundaries when it comes to formatter generated line breaks. - - - Empty blocks produce fences - block_space-before_space-after_8.xml - An empty block currently produces a fence for - stacking constraints which it shouldn't. - - - block white-space nbsp 2 - block_white-space_nbsp_2.xml - The nbsp given as an fo:character is not adjustable and therefore - the justification does not work in this case. - - - block word-spacing - block_word-spacing.xml - Word-spacing may not work as expected. - - - block word-spacing text-align justify - block_word-spacing_text-align_justify.xml - Word-spacing may not work as expected. - - - external-graphic don't shrink - external-graphic_oversized.xml - Images currently don't shrink so they fit on a page - when they are too big and shrinking is allowed to - happen (min/opt/max). - - - Test case with HTTP URL - external-graphic_src_uri.xml - Doesn't work behind a proxy which requires - authorization. - - - Space Resolution in foot note area - footnote_space-resolution.xml - Space resolution does not work between footnote - regions. - - - NPE for table inside an inline - inline_block_nested_3.xml - Placing a table as a child of an fo:inline produces a - NullPointerException. - - - inline-container is not implemented, yet. - inline-container_block_nested.xml - inline-container is not implemented, yet. Content of an - inline-container will get swallowed. The test case contains no checks. - - - inline-container is not implemented, yet. - inline-container_border_padding.xml - inline-container is not implemented, yet. Content of an - inline-container will get swallowed. - - - inline letter-spacing - inline_letter-spacing.xml - Letter-spacing may not work as - expected within fo:inline. - - - inline word-spacing - inline_word-spacing.xml - Word-spacing may not work as expected within - fo:inline. - - - inline word-spacing text-align justify - inline_word-spacing_text-align_justify.xml - - - - leader-alignment NYI - leader-alignment.xml - Leader-alignment is not yet - implemented. - - - leader-pattern="use-content": Problem with line height - leader_leader-pattern_use-content_bug.xml - Line height is not correctly calculated for - use-content leaders whose height is larger than the rest of the - line. - http://www.nabble.com/leaders-with-leader-pattern%3D%22use-content%22-t546244.html - - - Page breaking doesn't deal with IPD changes - page-breaking_4.xml - Page breaking currently doesn't support changing available IPD - between pages of a single page-sequence. Element list generation has to be reset to - redetermine line breaks in this case. - - - Overflow handing is incomplete - page-breaking_6.xml - Line breaking is not 100% correct when there's too little space. - Overflows are not detected and warned. - - - Indefinite page height handling is imcomplete - page-height_indefinite_simple.xml - A RuntimeException is thrown for a page of indefinite height. Lots of warnings. - - - page-number-citation: Problem with background-image - page-number-citation_background-image.xml - Background-images on page-number-citations are not - placed correctly. - - - IDs are not working on all FO elements - page-number-citation_complex_1.xml - The "id" attributes are not properly handled for all block-level FO elements. - - - IDs are not working on all FO elements - page-number-citation_complex_2.xml - The "id" attributes are not properly handled for all inline-level FO elements. - - - Footnotes in multi-column documents - region-body_column-count_footnote.xml - Footnotes may overlap with text of the region-body in - multi-column documents. - - - Column Balancing problems - region-body_column-count_balance_4col.xml - Situation in a 4-column document where the column balancing doesn't work and even causes some - content to disappear. - - - Column Balancing problems - region-body_column-count_bug36356.xml - Column balancing doesn't work as expected. - - - table-cell empty area with marker.xml - table-cell_empty_area_with_marker.xml - A table-cell producing an empty area does currently not add any markers to a page. - See TODO entry in AreaAdditionUtil. - - - Border conditionality on table - table_border-width_conditionality.xml - The code should be ok, but the test case uses shorthands and therefore - is probably not expressing the indended outcome according to the spec. The test - case should be revisited. - - - Soft hyphen with normal hyphenation enabled - block_shy_linebreaking_hyph.xml - A soft hyphen should be a preferred as break compared to a - normal hyphenation point but is not. - - - Page-keep not respected in multi-column layout - keep_within-page_multi-column_overflow.xml - The block should cause overflow in the - last column on the page, rather than be broken. - - diff --git a/src/documentation/content/xdocs/1.0/metadata.xml b/src/documentation/content/xdocs/1.0/metadata.xml deleted file mode 100644 index 795177583..000000000 --- a/src/documentation/content/xdocs/1.0/metadata.xml +++ /dev/null @@ -1,243 +0,0 @@ - - - - - -
- Apache™ FOP: Metadata -
- -
- Overview -

- Document metadata is an important tool for categorizing and finding documents. - Various formats support different kinds of metadata representation and to - different levels. One of the more popular and flexible means of representing - document or object metadata is - XMP (eXtensible Metadata Platform, specified by Adobe). - PDF 1.4 introduced the use of XMP. The XMP specification lists recommendation for - embedding XMP metdata in other document and image formats. Given its flexibility it makes - sense to make use this approach in the XSL-FO context. Unfortunately, unlike SVG which - also refers to XMP, XSL-FO doesn't recommend a preferred way of specifying document and - object metadata. Therefore, there's no portable way to represent metadata in XSL-FO - documents. Each implementation does it differently. -

-
-
- Embedding XMP in an XSL-FO document -

- As noted above, there's no officially recommended way to embed metadata in XSL-FO. - Apache FOP supports embedding XMP in XSL-FO. Currently, only support for document-level - metadata is implemented. Object-level metadata will be implemented when there's - interest. -

-

- Document-level metadata can be specified in the fo:declarations element. - XMP specification recommends to use x:xmpmeta, rdf:RDF, and - rdf:Description elements as shown in example below. Both - x:xmpmeta and rdf:RDF elements are recognized as the top-level - element introducing an XMP fragment (as per the XMP specification). -

-
- Example - - - - - - - Document title - Document author - Document subject - - - - Tool used to make the PDF - - - - - - - fo:declarations must be declared after - fo:layout-master-set and before the first page-sequence. - -
-
-
- Implementation in Apache FOP -

- Currently, XMP support is only available for PDF output. -

-

- Originally, you could set some metadata information through FOP's FOUserAgent by - using its set*() methods (like setTitle(String) or setAuthor(String). These values are - directly used to set value in the PDF Info object. Since PDF 1.4, adding metadata as an - XMP document to a PDF is possible. That means that there are now two mechanisms in PDF - that hold metadata. -

-

- Apache FOP now synchronizes the Info and the Metadata object in PDF, i.e. when you - set the title and the author through the FOUserAgent, the two values will end up in - the (old) Info object and in the new Metadata object as XMP content. If instead of - FOUserAgent, you embed XMP metadata in the XSL-FO document (as shown above), the - XMP metadata will be used as-is in the PDF Metadata object and some values from the - XMP metadata will be copied to the Info object to maintain backwards-compatibility - for PDF readers that don't support XMP metadata. -

-

- The mapping between the Info and the Metadata object used by Apache FOP comes from - the PDF/A-1 specification. - For convenience, here's the mapping table: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Document information dictionaryXMP
EntryPDF typePropertyXMP typeCategory
Titletext stringdc:titleTextExternal
Authortext stringdc:creatorseq TextExternal
Subjecttext stringdc:description["x-default"]TextExternal
Keywordstext stringpdf:KeywordsTextExternal
Creatortext stringxmp:CreatorToolTextExternal
Producertext stringpdf:ProducerTextInternal
CreationDatedatexmp:CreationDateDateInternal
ModDatedatexmp:ModifyDateDateInternal
- - "Internal" in the Category column means that the user should not set this value. - It is set by the application. - - - The "Subject" used to be mapped to dc:subject in the initial publication of - PDF/A-1 (ISO 19005-1). In the - Technical Corrigendum 1 - this was changed to map to dc:description["x-default"]. - -
- Namespaces -

- Metadata is made of property sets where each property set uses a different namespace URI. -

-

- The following is a listing of namespaces that Apache FOP recognizes and acts upon, - mostly to synchronize the XMP metadata with the PDF Info dictionary: -

- - - - - - - - - - - - - - - - - - - - - -
Set/SchemaNamespace PrefixNamespace URI
Dublin Coredchttp://purl.org/dc/elements/1.1/
XMP Basicxmphttp://ns.adobe.com/xap/1.0/
Adobe PDF Schemapdfhttp://ns.adobe.com/pdf/1.3/
-

- Please refer to the XMP Specification - for information on other metadata namespaces. -

-

- Property sets (Namespaces) not listed here are simply passed through to the final - document (if supported). That is useful if you want to specify a custom metadata - schema. -

-
-
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/output.xml b/src/documentation/content/xdocs/1.0/output.xml deleted file mode 100644 index 65f808ae8..000000000 --- a/src/documentation/content/xdocs/1.0/output.xml +++ /dev/null @@ -1,1265 +0,0 @@ - - - - - - -
- Apache™ FOP Output Formats - $Revision$ - - - - -
- - -

- Apache™ FOP supports multiple output formats by using a different renderer for each format. - The renderers do not all have the same set of capabilities, sometimes because of - the output format itself, sometimes because some renderers get more development - attention than others. -

-
- General Information -
- Fonts -

- Most FOP renderers use a FOP-specific system for font registration. - However, the Java2D/AWT and print renderers use the Java AWT package, which gets its - font information from the operating system registration. - This can result in several differences, including actually using different fonts, - and having different font metrics for the same font. - The net effect is that the layout of a given FO document can be quite different between - renderers that do not use the same font information. -

-

- Theoretically, there's some potential to make the output of the PDF/PS renderers match - the output of the Java2D-based renderers. If FOP used the font metrics from its own - font subsystem but still used Java2D for text painting in the Java2D-based renderers, - this could probably be achieved. However, this approach hasn't been implemented, yet. -

-

- With a work-around, it is possible to match the PDF/PS output in a Java2D-based - renderer pretty closely. The clue is to use the - intermediate format. The trick is to layout the - document using FOP's own font subsystem but then render the document using Java2D. - Here are the necessary steps (using the command-line): -

-
    -
  1. - Produce an IF file: fop -fo myfile.fo -at application/pdf myfile.at.xml
    - Specifying "application/pdf" for the "-at" parameter causes FOP to use FOP's own - font subsystem (which is used by the PDF renderer). Note that no PDF file is created - in this step. -
    2. -
  2. Render to a PDF file: fop -atin myfile.at.xml -pdf myfile.pdf
    3. -
  3. Render to a Java2D-based renderer: -
      -
    • fop -atin myfile.at.xml -print
      • -
    • fop -atin myfile.at.xml -awt
      • -
    • fop -atin myfile.at.xml -tiff myfile.tiff
      • -
    -
    4. -
-
-
- Output to a Printer or Other Device -

- The most obvious way to print your document is to use the FOP - print renderer, which uses the Java2D API (AWT). - However, you can also send output from the Postscript renderer directly to a Postscript - device, or output from the PCL renderer directly to a PCL device. -

-

- Here are Windows command-line examples for Postscript and PCL: -

- - -

- Here is some Java code to accomplish the task in UNIX: -

- -

- Set the output MIME type to "application/x-pcl" (MimeConstants.MIME_PCL) and - it happily sends the PCL to the UNIX printer queue. -

-
-
-
- PDF -

- PDF is the best supported output format. It is also the most accurate - with text and layout. This creates a PDF document that is streamed out - as each page is rendered. This means that the internal page index - information is stored near the end of the document. - The PDF version supported is 1.4. PDF versions are forwards/backwards - compatible. -

-

- Note that FOP does not currently support PDF/A-1a. - Support for Tagged PDF, PDF/A-1b - and PDF/X has recently been added, however. -

-
- Fonts -

- PDF has a set of fonts that are always available to all PDF viewers; - to quote from the PDF Specification: - - "PDF prescribes a set of 14 standard fonts that can be used without prior - definition. - These include four faces each of three Latin text typefaces (Courier, - Helvetica, and Times), as well as two symbolic fonts (Symbol and ITC Zapf - Dingbats). These fonts, or suitable substitute fonts with the same metrics, are - guaranteed to be available in all PDF viewer applications." -

-
-
- Post-processing -

- FOP does not currently support several desirable PDF features: watermarks and signatures. - One workaround is to use Adobe Acrobat (the full version, not the Reader) to process - the file manually or with scripting that it supports. -

-

- Another popular post-processing tool is iText, - which has tools for adding security features, document properties, watermarks, and many - other features to PDF files. -

- - Caveat: iText may swallow PDF bookmarks. But - Jens Stavnstrup tells us - that this doesn't happen if you use iText's PDFStamper. - -

- Here is some sample code that uses iText to encrypt a FOP-generated PDF. (Note that FOP now - supports PDF encryption. However the principles for using - iText for other PDF features are similar.) -

- -

- Check the iText tutorial and documentation for setting access flags, password, - encryption strength and other parameters. -

-
-
- Watermarks -

- In addition to the PDF Post-processing options, consider the following workarounds: -

-
    -
  • - Use a background image for the body region. -
    • -
  • - (submitted by Trevor Campbell) Place an image in a - region that overlaps the flowing text. For example, make - region-before large enough to contain your image. Then include a - block (if necessary, use an absolutely positioned block-container) - containing the watermark image in the static-content for the - region-before. Note that the image will be drawn on top of the - normal content. -
    • -
-
-
-
- PostScript -

- The PostScript renderer has been brought up to a similar quality as the - PDF renderer, but may still be missing certain features. It provides good - support for most text and layout. - Images and SVG are not fully supported, yet. Currently, the PostScript - renderer generates PostScript Level 3 with most DSC comments. Actually, - the only Level 3 features used are the FlateDecode and DCTDecode - filter (the latter is used for 1:1 embedding of JPEG images), everything - else is Level 2. -

-
- Configuration -

- The PostScript renderer configuration currently allows the following settings: -

- - false - 3 - false - false - true -]]> -

- The default value for the "auto-rotate-landscape" setting is "false". Setting it - to "true" will automatically rotate landscape pages and will mark them as landscape. -

-

- The default value for the "language-level" setting is "3". This setting specifies - the PostScript language level which should be used by FOP. Set this to "2" - only if you don't have a Level 3 capable interpreter. -

-

- The default value for the "optimize-resources" setting is "false". Setting it - to "true" will produce the PostScript file in two steps. A temporary file will be - written first which will then be processed to add only the fonts which were really - used and images are added to the stream only once as PostScript forms. This will - reduce file size but can potentially increase the memory needed in the interpreter - to process. -

-

- The default value for the "safe-set-page-device" setting is "false". Setting it - to "true" will cause the renderer to invoke a postscript macro which guards against - the possibility of invalid/unsupported postscript key/values being issued to the - implementing postscript page device. -

-

- The default value for the "dsc-compliant" setting is "true". Setting it - to "false" will break DSC compliance by minimizing the number of setpagedevice - calls in the postscript document output. This feature may be useful when unwanted - blank pages are experienced in your postscript output. This problem is caused by - the particular postscript implementation issuing unwanted postscript subsystem - initgraphics/erasepage calls on each setpagedevice call. -

-
-
- Limitations -
    -
  • Images and SVG may not be displayed correctly. SVG support is far from being complete. No image transparency is available.
    • -
  • Only Type 1 fonts are supported.
    • -
  • Multibyte characters are not supported.
    • -
  • PPD support is still missing.
    • -
-
-
-
- PCL -

- This format is for the Hewlett-Packard PCL printers and other printers - supporting PCL. It should produce output as close to identical as possible - to the printed output of the PDFRenderer within the limitations of the - renderer, and output device. -

-

- The output created by the PCLRenderer is generic PCL 5, HP GL/2 and PJL. - This should allow any device fully supporting PCL 5 to be able to - print the output generated by the PCLRenderer. PJL is used to control the - print job and switch to the PCL language. PCL 5 is used for text, raster - graphics and rectangular fill graphics. HP GL/2 is used for more complex - painting operations. Certain painting operations are done off-screen and - rendered to PCL as bitmaps because of limitations in PCL 5. -

-
- References - -
-
- Limitations -
    -
  • - Text or graphics outside the left or top of the printable area are not - rendered properly. This is a limitation of PCL, not FOP. In general, - things that should print to the left of the printable area are shifted - to the right so that they start at the left edge of the printable area. -
    • -
  • - The Helvetica and Times fonts are not well supported among PCL printers - so Helvetica is mapped to Arial and Times is mapped to Times New. This - is done in the PCLRenderer, no changes are required in the FO's. The - metrics and appearance for Helvetica/Arial and Times/Times New are - nearly identical, so this has not been a problem so far. -
    • -
  • For the non-symbol fonts, the ISO 8859-1 symbol set is used (PCL set "0N").
    • -
  • - All fonts available to the Java2D subsystem are usable. The texts are - painted as bitmap much like the Windows PCL drivers do. -
    • -
  • Multibyte characters are not supported.
    • -
  • - At the moment, only monochrome output is supported. PCL5c color extensions - will only be implemented on demand. Color and grayscale images are converted - to monochrome bitmaps (1-bit). Dithering only occurs if the JAI image library - is available. -
    • -
  • - Images are scaled up to the next resolution level supported by PCL (75, - 100, 150, 200, 300, 600 dpi). For color and grayscale images an even - higher PCL resolution is selected to give the dithering algorithm a chance - to improve the bitmap quality. -
    • -
  • - Currently, there's no support for clipping and image transparency, largely - because PCL 5 has certain limitations. -
    • -
-
-
- Configuration -

- The PCL renderer configuration currently allows the following settings: -

- - quality - bitmap - false -]]> -

- The default value for the "rendering" setting is "speed" which causes borders - to be painted as plain rectangles. In this mode, no special borders (dotted, - dashed etc.) are available. If you want support for all border modes, set the - value to "quality" as indicated above. This will cause the borders to be painted - as bitmaps. -

-

- The default value for the "text-rendering" setting is "auto" which paints the - base fonts using PCL fonts. Non-base fonts are painted as bitmaps through Java2D. - If the mix of painting methods results in unwelcome output, you can set this - to "bitmap" which causes all text to be rendered as bitmaps. -

-

- The default value for the "disable-pjl" setting is "false". This means that - the PCL renderer usually generates PJL commands before and after the document - in order to switch a printer into PCL language. PJL commands can be disabled - if you set this value to "true". -

-

- You can control the output resolution for the PCL using the "target resolution" - setting on the FOUserAgent. The actual value will be rounded up to the next - supported PCL resolution. Currently, only 300 and 600 dpi are supported which - should be enough for most use cases. Note that this setting directly affects - the size of the output file and the print quality. -

-
-
- Extensions -

The PCL Renderer supports some PCL specific extensions which can be embedded - into the input FO document. To use the extensions the appropriate namespace must - be declared in the fo:root element like this:

- -]]> -
- Page Source (Tray selection) -

- The page-source extension attribute on fo:simple-page-master allows to - select the paper tray the sheet for a particular simple-page-master is - to be taken from. Example: -

- - - ... - - -]]> -

- Note: the tray number is a positive integer and the value depends on - the target printer. Not all PCL printers support the same paper trays. - Usually, - "1" is the default tray, - "2" is the manual paper feed, - "3" is the manual envelope feed, - "4" is the "lower" tray and - "7" is "auto-select". - Consult the technical reference for your printer for all available values. -

-
-
- Output Bin -

- The output-bin extension attribute on fo:simple-page-master allows to - select the output bin into which the printed output should be fed. Example: -

- - - ... - - -]]> -

- Note: the output bin number is a positive integer and the value depends on - the target printer. Not all PCL printers support the same output bins. - Usually, - "1" is the upper output bin, - "2" is the lower (rear) output bin. - Consult the technical reference for your printer for all available values. -

-
-
- Page Duplex Mode -

- The duplex-mode extension attribute on fo:simple-page-master allows to - select the duplex mode to be used for a particular simple-page-master. - Example: -

- - - ... - - -]]> -

- Note: the duplex is a positive integer and the value depends on - the target printer. Not all PCL printers support duplexing. - Usually, - "0" is simplex, - "1" is duplex (long-edge binding), - "2" is duplex (short-edge binding). - - Consult the technical reference for your printer for all available values. -

-
-
-
-
- AFP -

- The FOP AFP Renderer deals with creating documents conforming to the IBM AFP document architecture - also refered to as MO:DCA (Mixed Object Document Content Architecture). -

-

- The mapping of XSL-FO elements to the major MO:DCA structures is as follows: -

- - - - - - - - - - - - - - - - - -
XSL-FO elementMO:DCA-P object
fo:rootDocument
fo:page-sequencePage Group
fo:simple-page-masterPage
-

- FOP creates exactly one Document per Printfile with an optional Resource Group at the - beginning. FOP does not create document indices. -

-
- References - -
-
- Limitations -

This list is most likely badly incomplete.

-
    -
  • - Clipping of text and graphics is not supported. -
    • -
  • - Only IBM outline and raster fonts and to a limited extend the original fonts built into FOP are supported. - Support for TrueType fonts may be added later. -
    • -
-
-
- Deployment in older environments -

- There are still a big number of older (or limited) MO:DCA/IPDS environments in production - out there. AFP has grown in functionality over time and not every environment supports the - latest features. We're trying to make AFP output work in as many environments as possible. - However, to make AFP output work on older environments it is recommended to set to - configuration to 1 bit per pixel (see below on how to do this). In this case, all images - are converted to bi-level images using IOCA function set 10 (FS10) and are enclosed in - page-segments since some implementation cannot deal with IOCA objects directly. - If a higher number of bits per pixel is configured, FOP has to switch to at least FS11 - which may not work everywhere. -

-
-
- Configuration -
- Fonts -

The AFP Renderer requires special configuration particularly related to fonts. - AFP Render configuration is done through the normal FOP configuration file. The MIME type - for the AFP Renderer is application/x-afp which means the AFP Renderer section in the FOP configuration file - looks like:

- - - ... -]]> -

There are 4 font configuration variants supported:

-
    -
  1. IBM Raster fonts
    2. -
  2. IBM Outline fonts
    3. -
  3. IBM CID-keyed (Type 0) fonts
    4. -
  4. FOP built-in Base14 fonts
    5. -
-

A typical raster font configuration looks like:

- - - - - - - - - - - - - - - - - - - - - - - - ]]> -

An outline font configuration is simpler as the individual font size entries are not required. - However, the characterset definition is now required within the afp-font element.

- - - - - - -]]> -

- If "base-uri" is missing or a relative URI, the fonts are resolved relative to - the font base URI specified in the configuration (or on the FopFactory). -

- - Previously, the location of the font files was given by the "path" attribute. This is still - supported for the time being, but you should move to using the more flexible "base-uri" - attribute so you can profit from the power of URI resolvers. - -

A CID-keyed font (Type 0, double-byte outline font) configuration is much the same as an outline font. - However, the characterset definition is now required within the afp-font element.

- - - - -]]> -

-Note that the value of the encoding attribute in the example is the double-byte encoding 'UnicodeBigUnmarked' (UTF-16BE). -

-

Experimentation has shown that the font metrics for the FOP built-in Base14 fonts are actually - very similar to some of the IBM outline and raster fonts. In cases were the IBM font files are not - available the base-uri attribute in the afp-font element can be replaced by a base14-font attribute - giving the name of the matching Base14 font. In this case the AFP Renderer will take the - font metrics from the built-in font.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ]]> -

- By default, all manually configured fonts are embedded, unless they are matched in the - referenced-fonts section of the configuration file. - However, the default fonts shown above will not be embedded. -

-
-
- Output Resolution -

By default the AFP Renderer creates output with a resolution of 240 dpi. - This can be overridden by the <renderer-resolution/> configuration element. Example:

- 240]]> -
-
- Images -

By default the AFP Renderer converts all images to 8 bit grey level. - This can be overridden by the <images/> configuration element. Example:

- -]]> -

This will put images as RGB images into the AFP output stream. The default setting is:

- -]]> -

Only the values "color" and "b+w" are allowed for the mode attribute.

-

The bits-per-pixel attribute is ignored if mode is "color". For "b+w" mode is must be 1, 4, or 8.

- -]]> -

When the native attribute is specified and set to "true", all image resources will be natively injected - into the datastream using an object container rather than being converted into an IOCA FS45 image. - Support for native image formats (e.g. JPEG, TIFF, GIF) is not always available on printer implementations - so by default this configuration option is set to "false".

-

- Setting cmyk="true" on the images element will enable CMYK - colors. This will only have an effect if the color mode is set to "color". Example: -

- ]]> -

- When the color mode is set to 1 bit (bi-level), the "dithering-quality" attribute can - be used to select the level of quality to use when converting images to bi-level images. - Valid values for this attribute are floating point numbers from 0.0 (fastest) to - 1.0 (best), or special values: "minimum" (=0.0), "maximum" (1.0), - "medium" (0.5, the default). For the higher settings to work as expected, JAI needs to - be present in the classpath. If JAI is present, 0.0 results in a minimal darkness-level - switching between white and black. 0.5 does bayer-based dithering and 1.0 will use - error-diffusion dithering. The higher the value, the higher the quality and the slower - the processing of the images. -

- ]]> -
-
- Shading -

- By default, filled rectangles are painted using their given color using a PTOCA I-axis rule - (DIR). But not all environments handle these colors correctly. That's why a setting is - supported that paints the rectangles using an ordered dither pattern (bi-level) with - an inline IOCA FS10 image that is used together with the "replicate and trim" mapping. - The optional "shading" element can be used to control the shading mode. Its default value - is "color". To enable the dithered mode, use "dithered". Example: -

- dithered -]]> -
-
- Resource Group File -

By default the AFP Renderer will place all data resource objects such as images within - the document of the main output datastream. An external resource group file where document resources - may be specified with the <resource-group-file/> configuration element. Example:

- external_resources.afp -]]> - Be careful when using this option not to overwrite existing resource files from previous rendering runs. -
-
- Resource Level Defaults -

- By default, bitmap image objects (or page segments derived from them) are put in the - print-file-level resource group and GOCA graphics are inlined for compatibility with - the AFP Workbench tool. -

-

- It is possible to override these defaults, either per image (see the - afp:resource-level - extension attribute below) or by specifying different defaults in the configuration: -

- ]]> -

- "goca" refers to GOCA graphics and "bitmap" refers to IOCA images. The possible values - for the attributes are "inline" and "print-file". In the future, - additional possibilities may be added. -

-
-
-
- Extensions -

The AFP Renderer supports some AFP specific extensions which can be embedded into the input - fo document. To use the extensions the appropriate namespace must be declared in the fo:root element like this:

- -]]> -
- Page Overlay (IPO) Extension -

The include-page-overlay extension element allows to define on a per simple-page-master basis a page overlay resource. Example:

- - - - ... - - -]]> -

The mandatory name attribute must refer to an 8 character (space padded) resource name that - must be known in the AFP processing environment. Optional x and y attributes can be specified - to place the Overlay at an offset from the top left of the page.

-
-
- Page Segment (IPS) Extension -

The include-page-segment extension element allows to define resource substitution for fo:external-graphics elements. - Example:

- - - - - - - -]]> -

The include-page-segment extension element can only occur within a simple-page-master. - Multiple include-page-segment extension elements within a simple-page-master are allowed. - The mandatory name attribute must refer to an 8 character - (space padded) resource name that must be known in the AFP processing environment. - The value of the mandatory src attribute is compared against the value of the src attribute in - fo:external-graphic elements and if it is identical (string matching is used) in the generated - AFP the external graphic is replaced by a reference to the given resource. -

-

- The effect here is that whenever FOP encounters the URI specified in the extension, - it will effectively generate code to include the page segment with the given name - instead of embedding the image referenced by the URI. The URI is still required as - the underlying image serves as a provider for the intrinsic size of the image - (At the moment, FOP is unable to extract the intrinsic size of the page segment from - an AFP resource file). For the image to appear in an AFP viewer or to be printed, the - AFP resource must be available on the target device. FOP does not embed the page - segment in the generated file. Please also note that page segments cannot be scaled. - They are always rendered in their intrinsic size. -

-
-
- Tag Logical Element (TLE) Extension -

The tag-logical-element extension element allows to injects TLEs into the AFP output stream. Example:

- - - - - - - - [..] - - - - [..] -]]> -

- The tag-logical-element extension element can appear within a simple-page-master - (page level) or it can appear as child of page-sequence (page group level). - Multiple tag-logical-element extension elements within a simple-page-master or - page-sequence are allowed. The name and value attributes are mandatory. -

-
-
- No Operation (NOP) Extension -

The no-operation extension provides the ability to carry up to 32K of comments or any other type - of unarchitected data into the AFP output stream. Example:

- - - - insert up to 32k of character data here! - - -]]> -

The no-operation extension element can only occur within a simple-page-master. - Multiple no-operation extension elements within a simple-page-master are allowed. - The name attribute is mandatory. -

-
-
- Invoke Medium Map (IMM) Extension -

- The invoke-medium-map extension allows to generate IMM fields (Invoke Medium Map) in the - generated AFP output. Example: -

- - [..] - - - - [..] -]]> -

- The invoke-medium-map element is allowed as child of fo:page-sequence (page group - level) or fo:simple-page-master. It is NOT supported on document level (fo:root), yet. - FOP also doesn't support specifying medium maps inside XML (using BMM/EMM). It can - only reference an existing medium map by name. The medium map has to be constructed - through different means and available on the target platform. -

-
-
- Form Maps/Defs -

- Apache FOP supports embedding an external form map resource in the - generated AFP output. This is done using the afp:include-form-map - extension. An example: -

- - [..] - - - -]]> -

- The afp:include-form-map is to be placed as a direct child of - fo:declarations. The name is an AFP resource name - (max. 8 characters) and the src attribute is the URI identifying the - external form map resource. When such a form map is embedded, you can use the - afp:invoke-medium-map extension (described above) to invoke any medium - map included in the form map. -

- - Apache FOP doesn't support a way to define a form map or medium map using XML means - inside an XSL-FO document. You will have to build the form map with some third-party - tool. - -
-
-
- Foreign Attributes -
- Resource -

The resource foreign attributes provides the ability to name and control where data object resources - (e.g. images/scalable vector graphics) will reside in the AFP output. - The afp foreign attributes are only used in conjuntion with <fo:external-graphic/> and <instream-foreign-object/>. - Example:

- - ... - - - - - - - - - - - - - - -]]> -

The resource-level attribute where the resource object will reside in the AFP output datastream. - The possible values for this are "inline", "print-file" and "external". - When "external" is used a resource-group-file attribute must also be specified. - Please refer to the Resource Level Defaults - above to see what is used if the resource-level attribute is not specified. -

-

-

-
-
-
- RTF -

- JFOR, an open source XSL-FO to RTF converter has been integrated into Apache FOP. - This will create an RTF (rich text format) document that will - attempt to contain as much information from the XSL-FO document as - possible. It should be noted that is not possible (due to RTF's limitations) to map all - XSL-FO features to RTF. For complex documents, the RTF output will never reach the feature - level from PDF, for example. Thus, using RTF output is only recommended for simple documents - such as letters. -

-

- The RTF output follows Microsoft's RTF specifications - and produces best results on Microsoft Word. -

- RTF output is currently unmaintained and lacks many features compared to other output - formats. Using other editable formats like Open Document Format, instead of producing XSL-FO - then RTF through FOP, might give better results. -

- These are some known restrictions compared to other supported output formats (not a complete list): -

-
    -
  • - Not supported/implemented: -
      -
    • break-before/after (supported by the RTF library but not tied into the RTFHandler)
      • -
    • fo:page-number-citation-last
      • -
    • keeps (supported by the RTF library but not tied into the RTFHandler)
      • -
    • region-start/end (RTF limitation)
      • -
    • multiple columns
      • -
    -
    • -
  • Only a single page-master is supported
    • -
  • Not all variations of fo:leader are supported (RTF limitation)
    • -
  • percentages are not supported everywhere
    • -
-
-
- XML (Area Tree XML) -

- This is primarily for testing and verification. The XML created is simply - a representation of the internal area tree put into XML. We use that to verify - the functionality of FOP's layout engine. -

-

- The other use case of the Area Tree XML is as FOP's "intermediate format". More information - on that can be found on the page dedicated to the Intermediate Format. -

-
-
- Java2D/AWT -

- The Java2DRenderer provides the basic functionality for all - Java2D-based output formats (AWT viewer, direct print, PNG, TIFF). -

-

- The AWT viewer shows a window with the pages displayed inside a - Java graphic. It displays one page at a time. - The fonts used for the formatting and viewing depend on the fonts - available to your JRE. -

-
-
- Print -

- It is possible to directly print the document from the command line. - This is done with the same code that renders to the Java2D/AWT renderer. -

- -
-
- Bitmap (TIFF/PNG) -

- It is possible to directly create bitmap images from the individual - pages generated by the layout engine. - This is done with the same code that renders to the Java2D/AWT renderer. -

-

- Currently, two output formats are supported: PNG and TIFF. TIFF produces - one file with multiple pages, while PNG output produces one file per - page. Note: FOP can only produce multiple files (with PNG output) if - you can set a java.io.File indicating the primary PNG file - using the FOUserAgent.setOutputFile(File) method. -

-

- The quality of the bitmap depends on the target resolution setting - on the FOUserAgent and on further settings described below. -

-
- Configuration -

- The TIFF and PNG renderer configuration currently allows the following settings: -

- - rgba - true - white - true - quality - -]]> -

- The default value for the "color-mode" setting is "rgba" which - is equivalent to a 24bit RGB image with an 8bit alpha channel for transparency. - Valid values are: -

-
    -
  • rgba: RGB with alpha channel (24bit + 8bit = 32bit)
    • -
  • rgb: RGB (24bit)
    • -
  • gray: gray (8bit)
    • -
  • bi-level (or binary): bi-level (1bit)
    • -
-

- Please note that there is currently no dithering or error diffusion available for bi-level - bitmap output. -

-

- The default value for the "transparent-page-background" setting is - "false" which paints an opaque, white background for the whole image. - If you set this to "true", - no such background will be painted and you will get a transparent image if - an alpha channel is available in the output format. -

-

- The default value for the "background-color" setting is "white". - The color specifies in which color the page background is painted. It will only be - painted if "transparent-page-background" is not set to "true". - All XSL-FO colors (including color functions) can be used. -

-

- The default value for the "anti-aliasing" setting is "true". - You can set this value to "false" to disable anti-aliasing and - thus improve rendering speeds a bit at the loss of some image quality. -

-

- The default value for the "rendering" setting is "true". - You can set this value to "false" to improve rendering speeds a bit - at the loss of some image quality. If this setting has an actual effect depends - on the JVM's Java2D backend. -

-
-
- TIFF-specific Configuration -

- In addition to the above values the TIFF renderer configuration allows some additional - settings: -

- - true - CCITT T.6 - -]]> -

- The default value for the "compression" setting is "PackBits" which - which is a widely supported RLE compression scheme for TIFF. The set of compression - names to be used here matches the set that the Image I/O API uses. Note that - not all compression schemes may be available during runtime. This depends on the - actual codecs being available. Here is a list of possible values: -

-
    -
  • NONE (no compression)
    • -
  • PackBits (RLE, run-length encoding)
    • -
  • JPEG
    • -
  • Deflate
    • -
  • LZW
    • -
  • ZLib
    • -
  • CCITT T.4 (Fax Group 3)
    • -
  • CCITT T.6 (Fax Group 4)
    • -
-

- This setting may override any setting made using the "color-mode". For example, if - "CCITT T.6" is selected, the color mode is automatically forced to "bi-level" because - this compression format only supports bi-level images. -

- - If you want to use CCITT compression, please make sure you've got - - Java Advanced Imaging Image I/O Tools - - in your classpath. The Sun JRE doesn't come with a TIFF codec built in, so it has to be - added separately. The internal TIFF codec from XML Graphics Commons only supports PackBits, - Deflate and JPEG compression for writing. - -
-
- Runtime Rendering Options -

- The IF-based bitmap output implementations support a rendering option with the key - "target-bitmap-size" (value: java.awt.Dimension) that allows to force the pages to - be proportionally fit into a bitmap of a given size. This can be used to produce - thumbnails or little preview images of the individual pages. An example: -

- -
-
-
- TXT -

- The text renderer produces plain ASCII text output - that attempts to match the output of the PDFRenderer as closely as - possible. This was originally developed to accommodate an archive system - that could only accept plain text files, and is primarily useful for getting - a quick-and-dirty view of the document text. The renderer is very limited, - so do not be surprised if it gives unsatisfactory results. -

-

- The Text renderer works with a fixed size page buffer. The size of this - buffer is controlled with the textCPI and textLPI public variables. - The textCPI is the effective horizontal characters per inch to use. - The textLPI is the vertical lines per inch to use. From these values - and the page width and height the size of the buffer is calculated. - The formatting objects to be rendered are then mapped to this grid. - Graphic elements (lines, borders, etc) are assigned a lower priority - than text, so text will overwrite any graphic element representations. -

-

- Because FOP lays the text onto a grid during layout, there are frequently - extra or missing spaces between characters and lines, which is generally - unsatisfactory. - Users have reported that the optimal settings to avoid such spacing problems are: -

-
    -
  • font-family="Courier"
    • -
  • font-size="7.3pt"
    • -
  • line-height="10.5pt"
    • -
-
-
- Output Formats in the Sandbox -

- Due to the state of certain renderers we moved some of them to a "sandbox" area until - they are ready for more serious use. The renderers and FOEventHandlers in the sandbox - can be found under src/sandbox and are compiled into build/fop-sandbox.jar during the - main build. The output formats in the sandbox are marked as such below. -

-
- MIF - The MIF handler is in the sandbox and not yet functional in FOP Trunk!!! Please help us ressurrect this feature. -

- This format is the Maker Interchange Format which is used by - Adobe Framemaker. -

-
-
- SVG - The SVG renderer is in the sandbox and may not work as expected in FOP Trunk!!! Please help us improve this feature. -

- This format creates an SVG document that has links between the pages. - This is primarily for slides and creating svg images of pages. - Large documents will create SVG files that are far too large for - an SVG viewer to handle. Since FO documents usually have text the - SVG document will have a large number of text elements. - The font information for the text is obtained from the JVM in the - same way as for the AWT viewer. If the SVG is viewed on a - system where the fonts are different, such as another platform, - then the page may look wrong. -

-
-
-
- Wish list -

- Apache FOP is easily extensible and allows you to add new output formats to enhance FOP's functionality. There's a number of output formats - which are on our wish list. We're looking for volunteers to help us implement them. -

- -
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/pdfa.xml b/src/documentation/content/xdocs/1.0/pdfa.xml deleted file mode 100644 index 0b8399121..000000000 --- a/src/documentation/content/xdocs/1.0/pdfa.xml +++ /dev/null @@ -1,168 +0,0 @@ - - - - - -
- Apache™ FOP: PDF/A (ISO 19005) - $Revision$ - - - -
- -
- Overview -

- PDF/A is a standard which turns PDF into an "electronic document file - format for long-term preservation". PDF/A-1 is the first part of the - standard and is documented in - ISO 19005-1:2005(E). - Work on PDF/A-2 is in progress at - AIIM. -

-

- Design documentation on PDF/A can be found on FOP's Wiki on the - PDFA1ConformanceNotes page. -

-
-
- Implementation Status -

- PDF/A-1b is implemented to the degree that FOP supports - the creation of the elements described in ISO 19005-1. -

-

- Tests have been performed against jHove and Adobe Acrobat 7.0.7 (Preflight function). - FOP does not validate completely against Apago's PDF Appraiser. Reasons unknown due to - lack of a full license to get a detailed error protocol. -

-

- PDF/A-1a is based on PDF-A-1b and adds accessibility features - (such as Tagged PDF). This format is available within the limitation described on - the Accessibility page. -

-
-
- Usage (command line) -

- To activate PDF/A-1b from the command-line, specify "-pdfprofile PDF/A-1b" - as a parameter. If there is a violation of one of the validation rules for - PDF/A, an error message is presented and the processing stops. -

-

- PDF/A-1a is enabled by specifying "-pdfprofile PDF/A-1a". -

-
-
- Usage (embedded) -

- When FOP is embedded in another Java application you can set a special option - on the renderer options in the user agent to activate the PDF/A-1b profile. - Here's an example: -

- -

- If one of the validation rules of PDF/A is violated, an PDFConformanceException - (descendant of RuntimeException) is thrown. -

-

- For PDF/A-1a, just use the string "PDF/A-1a" instead of "PDF/A-1b". -

-
-
- PDF/A in Action -

- There are a number of things that must be looked after if you activate a PDF/A - profile. If you receive a PDFConformanceException, have a look at the following - list (not necessarily comprehensive): -

-
    -
  • - Make sure all (!) fonts are embedded. If you use base 14 fonts (like Helvetica) - you need to obtain a license for them and embed them like any other font. -
    • -
  • - Don't use PDF encryption. PDF/A doesn't allow it. -
    • -
  • - Don't use CMYK images without an ICC color profile. PDF/A doesn't allow mixing - color spaces and FOP currently only properly supports the sRGB color space. Please - note that FOP embeds a standard sRGB ICC profile (sRGB IEC61966-2.1) as the - primary output intent for the PDF if no other output intent has been specified - in the configuration. -
    • -
  • - Don't use non-RGB colors in SVG images. Same issue as with CMYK images. -
    • -
  • - Don't use EPS graphics with fo:external-graphic. Embedding EPS graphics in PDF - is deprecated since PDF 1.4 and prohibited by PDF/A. -
    • -
  • - PDF is forced to version 1.4 if PDF/A-1 is activated. -
    • -
  • - No filter must be specified explicitely for metadata objects. Metadata must be - embedded in clear text so non-PDF-aware applications can extract the XMP metadata. -
    • -
- - There are additional requirements if you want to enabled PDF/A-1a (Tagged PDF). This is - particularly the specification of the natural language and alternative descriptions for - images. Please refer to the Accessibility page for details. - -
-
- PDF profile compatibility -

- The PDF profiles "PDF/X-3:2003" and "PDF/A-1b" (or "PDF/A-1a") are compatible and can - both be activated at the same time. -

-
-
- Interoperability -

- There has been some confusion about the namespace for the PDF/A indicator in the XMP - metadata. At least three variants have been seen in the wild: -

- - - - - - - - - - - - - -
http://www.aiim.org/pdfa/ns/id.htmlobsolete, from an early draft of ISO-19005-1, used by Adobe Acrobat 7.x
http://www.aiim.org/pdfa/ns/idobsolete, found in the original ISO 19005-1:2005 document
http://www.aiim.org/pdfa/ns/id/correct, found in the technical corrigendum 1 of ISO 19005-1:2005
-

- If you get an error validating a PDF/A file in Adobe Acrobat 7.x it doesn't mean that - FOP did something wrong. It's Acrobat that is at fault. This is fixed in Adobe Acrobat 8.x - which uses the correct namespace as described in the technical corrigendum 1. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/pdfencryption.xml b/src/documentation/content/xdocs/1.0/pdfencryption.xml deleted file mode 100644 index 6b27d9857..000000000 --- a/src/documentation/content/xdocs/1.0/pdfencryption.xml +++ /dev/null @@ -1,228 +0,0 @@ - - - - - -
- Apache™ FOP: PDF encryption. - $Revision$ - - - - -
- -
- Overview -

- Apache™ FOP supports encryption of PDF output, thanks to Patrick - C. Lankswert. This feature is commonly used to prevent - unauthorized viewing, printing, editing, copying text from the - document and doing annotations. It is also possible to ask the - user for a password in order to view the contents. Note that - there already exist third party applications which can decrypt - an encrypted PDF without effort and allow the aforementioned - operations, therefore the degree of protection is limited. -

-

- For further information about features and restrictions regarding PDF - encryption, look at the documentation coming with Adobe Acrobat or the - technical documentation on the Adobe web site. -

-
-
- Usage (command line) -

- Encryption is enabled by supplying any of the encryption related - options. -

-

- An owner password is set with the -o option. This - password is actually used as encryption key. Many tools for - PDF processing ask for this password to disregard any - restriction imposed on the PDF document. -

-

- If no owner password has been supplied but FOP was asked to apply some - restrictions, a random password is used. In this case it is obviously - impossiible to disregard restrictions in PDF processing tools. -

-

- A user password, supplied with the -u option, will - cause the PDF display software to ask the reader for this password in - order to view the contents of the document. If no user password was - supplied, viewing the content is not restricted. -

-

- Further restrictions can be imposed by using the -noprint, - -nocopy, -noedit and - -noannotations options, which disable printing, copying - text, editing in Adobe Acrobat and making annotations, respectively. -

-
-
- Usage (embedded) -

- When FOP is embedded in another Java application you need to set an - options map on the renderer. These are the supported options: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OptionDescriptionValuesDefault
ownerPasswordThe owner passwordString -
userPasswordThe user passwordString -
allowPrintAllows/disallows printing of the PDF"TRUE" or "FALSE""TRUE"
allowCopyContentAllows/disallows copy/paste of content"TRUE" or "FALSE""TRUE"
allowEditContentAllows/disallows editing of content"TRUE" or "FALSE""TRUE"
allowEditAnnotationsAllows/disallows editing of annotations"TRUE" or "FALSE""TRUE"
- - Encryption is enabled as soon as one of these options is set. - -

- An example to enable PDF encryption in Java code: -

- -

- The parameters for the constructor of PDFEncryptionParams are: -

-
    -
  1. userPassword: String, may be null
    2. -
  2. ownerPassword: String, may be null
    3. -
  3. allowPrint: true if printing is allowed
    4. -
  4. allowCopyContent: true if copying content is allowed
    5. -
  5. allowEditContent: true if editing content is allowed
    6. -
  6. allowEditAnnotations: true if editing annotations is allowed
    7. -
-

- Alternatively, you can set each value separately in the Map provided by - FOUserAgent.getRendererOptions() by using the following keys: -

-
    -
  1. user-password: String
    2. -
  2. owner-password: String
    3. -
  3. noprint: Boolean or "true"/"false"
    4. -
  4. nocopy: Boolean or "true"/"false"
    5. -
  5. noedit: Boolean or "true"/"false"
    6. -
  6. noannotations: Boolean or "true"/"false"
    7. -
-
-
- Environment -

- In order to use PDF encryption, FOP has to be compiled with - cryptography support. Currently, only JCE - is supported. JCE is part of JDK 1.4. For earlier JDKs, it can - be installed separately. The build process automatically - detects JCE presence and installs PDF encryption support if - possible, otherwise a stub is compiled in. -

-

- Cryptography support must also be present at run time. In particular, a - provider for the RC4 cipher is needed. Unfortunately, the sample JCE - provider in Sun's JDK 1.4 does not provide RC4. If you - get a message saying -

- "Cannot find any provider supporting RC4" -

- then you don't have the needed infrastructure. -

-

- There are several commercial and a few Open Source packages which - provide RC4. A pure Java implementation is produced by The Legion of the Bouncy - Castle. Mozilla - JSS is an interface to a native implementation. -

-
-
- Installing a crypto provider -

- The pure Java implementation from Bouncy Castle is easy to - install. -

-
    -
  1. - Download the binary distribution for your JDK version. -
    2. -
  2. - Unpack the distribution. Add the jar file to your classpath. A - convenient way to use the jar on Linux is to simply drop it into the - FOP lib directory, it will be automatically picked up by - fop.sh. -
    3. -
  3. - Open the java.security file and add
    - security.provider.6=org.bouncycastle.jce.provider.BouncyCastleProvider,
    - preferably at the end of the block defining the other crypto - providers. For JDK 1.4 this is detailed on Sun's web site. -
    4. -
-

- If you have any experience with Mozilla JSS or any other - cryptography provider, please post it to the fop-user list. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/pdfx.xml b/src/documentation/content/xdocs/1.0/pdfx.xml deleted file mode 100644 index 8eced022c..000000000 --- a/src/documentation/content/xdocs/1.0/pdfx.xml +++ /dev/null @@ -1,136 +0,0 @@ - - - - - -
- Apache™ FOP: PDF/X (ISO 15930) - $Revision$ - - - -
- -
- Overview - - Support for PDF/X is available beginning with Apache™ FOP version 0.93. - This feature is new and may not be 100% complete, yet. Feedback is welcome. - -

- PDF/X is a standard which faciliates prepress digital data exchange using PDF. - Currently, only PDF/X-3:2003 is implemented out of the many different flavours of PDF/X - profiles. PDF/X-3:2003 is documented in - ISO 15930-6:2003(E). - More info on PDF/X can be found on the - PDF/X info site. -

-
-
- Implementation Status -

- PDF/X-3:2003 is implemented to the degree that FOP supports - the creation of the elements described in ISO 15930-6. -

-

- An important restriction of the current implementation is that all normal - RGB colors specified in XSL-FO and SVG are left unchanged in the sRGB color - space (XSL-FO and SVG both use sRGB as their default color space). - There's no conversion to a CMYK color space. Although sRGB is a - calibrated color space, its color space has a different size than a CMYK - color space which makes the conversion a lossy conversion and can lead to - unwanted results. Although the use of the calibrated sRGB has been promoted - for years, print shops usually prefer to convert an sRGB PDF to CMYK prior - to production. Until there's full CMYK support in FOP you will have to - work closely with your print service provider to make sure you get the - intended result. -

-

- Tests have been performed against Adobe Acrobat 7.0.7 (Preflight function). - Note that there are bugs in Adobe Acrobat which cause false alarms if both - PDF/A-1b and PDF/X-3:2003 are activated at the same time. -

-
-
- Usage (command line) -

- To activate PDF/X-3:2003 from the command-line, specify "-pdfprofile PDF/X-3:2003" - as a parameter. If there is a violation of one of the validation rules for - PDF/X, an error message is presented and the processing stops. -

-
-
- Usage (embedded) -

- When FOP is embedded in another Java application you can set a special option - on the renderer options in the user agent to activate the PDF/A-1b profile. - Here's an example: -

- -

- If one of the validation rules of PDF/X is violated, an PDFConformanceException - (descendant of RuntimeException) is thrown. -

-
-
- PDF/X in Action -

- There are a number of things that must be looked after if you activate a PDF/X - profile. If you receive a PDFConformanceException, have a look at the following - list (not necessarily comprehensive): -

-
    -
  • - Make sure all (!) fonts are embedded. If you use base 14 fonts (like Helvetica) - you need to obtain a license for them and embed them like any other font. -
    • -
  • - Don't use PDF encryption. PDF/X doesn't allow it. -
    • -
  • - Don't use CMYK images without an ICC color profile. PDF/X doesn't allow mixing - color spaces and FOP currently only properly supports the sRGB color space. However, - you will need to specify an - output device profile - (usually a CMYK profile) in the configuration. sRGB won't work here since it's a - display device profile, not an output device profile. -
    • -
  • - Don't use non-RGB colors in SVG images. Same issue as with CMYK images. -
    • -
  • - Don't use EPS graphics with fo:external-graphic. Embedding EPS graphics in PDF - is deprecated since PDF 1.4 and prohibited by PDF/X-3:2003. -
    • -
  • - PDF is forced to version 1.4 if PDF/X-3:2003 is activated. -
    • -
-
-
- PDF profile compatibility -

- The PDF profiles "PDF/X-3:2003" and "PDF/A-1b" are compatible and can both be - activated at the same time. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/running.xml b/src/documentation/content/xdocs/1.0/running.xml deleted file mode 100644 index aa0b9f9fc..000000000 --- a/src/documentation/content/xdocs/1.0/running.xml +++ /dev/null @@ -1,362 +0,0 @@ - - - - - -
- Running Apache™ FOP - $Revision$ -
- - -
- System Requirements -

The following software must be installed:

-
    -
  • - Java 1.4.x or later Runtime Environment. -
      -
    • - Many JREs >=1.4 contain older JAXP implementations (which often contain bugs). It's - usually a good idea to replace them with a current implementation. -
      • -
    -
    • -
  • - Apache™ FOP. The FOP distribution includes all libraries that you will - need to run a basic FOP installation. These can be found in the [fop-root]/lib directory. These - libraries include the following: - -
    • -
-

The following software is optional, depending on your needs:

-
    -
  • - Graphics libraries. Generally, FOP contains direct support for the most important - bitmap image formats (including PNG, JPEG and GIF). See - FOP: Graphics Formats for details. -
    • -
  • - PDF encryption. See FOP: PDF Encryption for details. -
    • -
-

In addition, the following system requirements apply:

-
    -
  • - If you will be using FOP to process SVG, you must do so in a graphical environment. - See FOP: Graphics (Batik) for details. -
    • -
-
-
- Installation -
- Instructions -

- Basic FOP installation consists of first unzipping the .gz file that is the - distribution medium, then unarchiving the resulting .tar file in a - directory/folder that is convenient on your system. Please consult your operating system - documentation or Zip application software documentation for instructions specific to your - site. -

-
-
- Problems -

- Some Mac OSX users have experienced filename truncation problems using Stuffit to unzip - and unarchive their distribution media. This is a legacy of older Mac operating systems, - which had a 31-character pathname limit. Several Mac OSX users have recommended that - Mac OSX users use the shell command tar -xzf instead. -

-
-
-
- Starting FOP as a Standalone Application -
- Using the fop script or batch file -

- The usual and recommended practice for starting FOP from the command line is to run the - batch file fop.bat (Windows) or the shell script fop (Unix/Linux). - These scripts require that the environment variable JAVA_HOME be - set to a path pointing to the appropriate Java installation on your system. Macintosh OSX - includes a Java environment as part of its distribution. We are told by Mac OSX users that - the path to use in this case is /Library/Java/Home. Caveat: - We suspect that, as Apple releases new Java environments and as FOP upgrades the minimum - Java requirements, the two will inevitably not match on some systems. Please see - Java on Mac OSX FAQ for information as - it becomes available. -

- - [OPTIONS] - -version print FOP version and exit - -d debug mode - -x dump configuration settings - -q quiet mode - -c cfg.xml use additional configuration file cfg.xml - -l lang the language to use for user information - -r relaxed/less strict validation (where available) - -dpi xxx target resolution in dots per inch (dpi) where xxx is a number - -s for area tree XML, down to block areas only - -v run in verbose mode (currently simply print FOP version and continue) - - -o [password] PDF file will be encrypted with option owner password - -u [password] PDF file will be encrypted with option user password - -noprint PDF file will be encrypted without printing permission - -nocopy PDF file will be encrypted without copy content permission - -noedit PDF file will be encrypted without edit content permission - -noannotations PDF file will be encrypted without edit annotation permission - -a enables accessibility features (Tagged PDF etc., default off) - -pdfprofile prof PDF file will be generated with the specified profile - (Examples for prof: PDF/A-1b or PDF/X-3:2003) - - -conserve Enable memory-conservation policy (trades memory-consumption for disk I/O) - (Note: currently only influences whether the area tree is serialized.) - - [INPUT] - infile xsl:fo input file (the same as the next) - (use '-' for infile to pipe input from stdin) - -fo infile xsl:fo input file - -xml infile xml input file, must be used together with -xsl - -atin infile area tree input file - -ifin infile intermediate format input file - -imagein infile image input file (piping through stdin not supported) - -xsl stylesheet xslt stylesheet - - -param name value to use for parameter in xslt stylesheet - (repeat '-param name value' for each parameter) - - -catalog use catalog resolver for input XML and XSLT files - [OUTPUT] - outfile input will be rendered as PDF into outfile - (use '-' for outfile to pipe output to stdout) - -pdf outfile input will be rendered as PDF (outfile req'd) - -pdfa1b outfile input will be rendered as PDF/A-1b compliant PDF - (outfile req'd, same as "-pdf outfile -pdfprofile PDF/A-1b") - -awt input will be displayed on screen - -rtf outfile input will be rendered as RTF (outfile req'd) - -pcl outfile input will be rendered as PCL (outfile req'd) - -ps outfile input will be rendered as PostScript (outfile req'd) - -afp outfile input will be rendered as AFP (outfile req'd) - -tiff outfile input will be rendered as TIFF (outfile req'd) - -png outfile input will be rendered as PNG (outfile req'd) - -txt outfile input will be rendered as plain text (outfile req'd) - -at [mime] out representation of area tree as XML (outfile req'd) - specify optional mime output to allow the AT to be converted - to final format later - -if [mime] out representation of document in intermediate format XML (outfile req'd) - specify optional mime output to allow the IF to be converted - to final format later - -print input file will be rendered and sent to the printer - see options with "-print help" - -out mime outfile input will be rendered using the given MIME type - (outfile req'd) Example: "-out application/pdf D:\out.pdf" - (Tip: "-out list" prints the list of supported MIME types) - -svg outfile input will be rendered as an SVG slides file (outfile req'd) - Experimental feature - requires additional fop-sandbox.jar. - - -foout outfile input will only be XSL transformed. The intermediate - XSL-FO file is saved and no rendering is performed. - (Only available if you use -xml and -xsl parameters) - - - [Examples] - fop foo.fo foo.pdf - fop -fo foo.fo -pdf foo.pdf (does the same as the previous line) - fop -xml foo.xml -xsl foo.xsl -pdf foo.pdf - fop -xml foo.xml -xsl foo.xsl -foout foo.fo - fop -xml - -xsl foo.xsl -pdf - - fop foo.fo -mif foo.mif - fop foo.fo -rtf foo.rtf - fop foo.fo -print - fop foo.fo -awt]]> -

- PDF encryption is only available if FOP was compiled with encryption support - and if compatible encryption support is available at run time. - Currently, only the JCE is supported. Check the Details. -

-
-
- Writing your own script -

FOP's entry point for your own scripts is the class -org.apache.fop.cli.Main. The general pattern for the - command line is: java -classpath <CLASSPATH> - org.apache.fop.cli.Main <arguments>. The arguments - consist of the options and infile and outfile specifications - as shown above for the standard scripts. You may wish to review - the standard scripts to make sure that - you get your environment properly configured. -

-
-
- Running with java's <code>-jar</code> option -

- As an alternative to the start scripts you can run java - -jar path/to/build/fop.jar <arguments>, relying on - FOP to build the classpath for running FOP dynamically, see below. If you use hyphenation, - you must put fop-hyph.jar in the lib - directory. -

- -

You can also run java -jar path/to/fop.jar - <arguments>, relying on the Class-Path - entry in the manifest file. This works if you put - fop.jar and all jar files from the lib - directory in a single directory. If you use hyphenation, you - must also put fop-hyph.jar in that directory.

- -

In both cases the arguments consist of the options and - infile and outfile specifications as shown above for the - standard scripts.

-
-
- FOP's dynamical classpath construction - -

If FOP is started without a proper classpath, it tries to - add its dependencies dynamically. If the system property - fop.home contains the name of a directory, then - FOP uses that directory as the base directory for its - search. Otherwise the current working directory is the base - directory. If the base directory is called build, - then its parent directory becomes the base directory.

- -

FOP expects to find fop.jar in the - build subdirectory of the base directory, and - adds it to the classpath. Subsequently FOP adds all - jar files in the lib directory to the - classpath. The lib directory is either the lib - subdirectory of the base directory, or, if that does not - exist, the base directory itself.

- -

If the system property fop.optional.lib - contains the name of a directory, then all jar - files in that directory are also added to the classpath. See - the methods getJARList and - checkDependencies in - org.apache.fop.cli.Main.

- -
-
-
- Using Xalan to Check XSL-FO Input -

- FOP sessions that use -xml and -xsl input instead of -fo input are actually - controlling two distinct conversions: Tranforming XML to XSL-FO, then formatting - the XSL-FO to PDF (or another FOP output format). - Although FOP controls both of these processes, the first is included merely as - a convenience and for performance reasons. - Only the second is part of FOP's core processing. - If a user has a problem running FOP, it is important to determine which of these - two processes is causing the problem. - If the problem is in the first process, the user's stylesheet is likely the cause. - The FOP development team does not have resources to help with stylesheet issues, - although we have included links to some useful - Specifications and - Books/Articles. - If the problem is in the second process, FOP may have a bug or an unimplemented - feature that does require attention from the FOP development team. -

- The user is always responsible to provide correct XSL-FO code to FOP. -

- In the case of using -xml and -xsl input, although the user is responsible for - the XSL-FO code that is FOP's input, it is not visible to the user. To make the - intermediate FO file visible, the FOP distribution includes the "-foout" option - which causes FOP to run only the first (transformation) step, and write the - results to a file. (See also the Xalan command-line below) -

- - When asking for help on the FOP mailing lists, never attach XML and - XSL to illustrate the issue. Always run the XSLT step (-foout) and send the - resulting XSL-FO file instead. Of course, be sure that the XSL-FO file is - correct before sending it. - -

- The -foout option works the same way as if you would call the - Xalan command-line: -

-

- java org.apache.xalan.xslt.Process -IN xmlfile -XSL file -OUT outfile -

-

- Note that there are some subtle differences between the FOP and Xalan command-lines. -

-
-
- Memory Usage -

- FOP can consume quite a bit of memory, even though this has been continually improved. - This is partly inherent to the formatting process and partly caused by implementation choices. - All FO processors currently on the market have memory problems with certain layouts. -

-

- If you are running out of memory when using FOP, here are some ideas that may help: -

-
    -
  • - Increase memory available to the JVM. See - the -Xmx option - for more information. - - It is usually unwise to increase the memory allocated to the JVM beyond the amount of - physical RAM, as this will generally cause significantly slower performance. - -
    • -
  • - Avoid forward references. - Forward references are references to some later part of a document. - Examples include page number citations which refer to pages which follow the citation, - tables of contents at the beginning of a document, and page numbering schemes that - include the total number of pages in the document - ("page N of TOTAL"). - Forward references cause all subsequent pages to be held in memory until the reference - can be resolved, i.e. until the page with the referenced element is encountered. - Forward references may be required by the task, but if you are getting a memory - overflow, at least consider the possibility of eliminating them. - A table of contents could be replaced by PDF bookmarks instead or moved to the end of - the document (reshuffle the paper could after printing). -
    • -
  • - Avoid large images, especially if they are scaled down. - If they need to be scaled, scale them in another application upstream from FOP. - For many image formats, memory consumption is driven mainly by the size of the image - file itself, not its dimensions (width*height), so increasing the compression rate - may help. -
    • -
  • - Use multiple page sequences. - FOP starts rendering after the end of a page sequence is encountered. - While the actual rendering is done page-by-page, some additional memory is - freed after the page sequence has been rendered. - This can be substantial if the page sequence contains lots of FO elements. -
    • -
-
-
- Problems -

If you have problems running FOP, please see the "How to get Help" page.

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/servlets.xml b/src/documentation/content/xdocs/1.0/servlets.xml deleted file mode 100644 index dd2df4351..000000000 --- a/src/documentation/content/xdocs/1.0/servlets.xml +++ /dev/null @@ -1,325 +0,0 @@ - - - - - -
- Apache™ FOP: Servlets - How to use Apache™ FOP in a Servlet - $Revision$ -
- -
- Overview -

- This page discusses topic all around using Apache™ FOP in a servlet environment. -

-
-
- Example Servlets in the FOP distribution -

- In the directory {fop-dir}/src/java/org/apache/fop/servlet, you'll find a working example - of a FOP-enabled servlet. -

-

- The servlet is automatically built when you build Apache FOP using the supplied Ant script. After building - the servlet, drop fop.war into the webapps directory of Apache Tomcat (or any other web container). Then, you can use - URLs like the following to generate PDF files: -

-
    -
  • http://localhost:8080/fop/fop?fo=/home/path/to/fofile.fo
    • -
  • http://localhost:8080/fop/fop?xml=/home/path/to/xmlfile.xml&xsl=/home/path/to/xslfile.xsl
    • -
-

-

The source code for the servlet can be found under {fop-dir}/src/java/org/apache/fop/servlet/FopServlet.java.

- - This example servlet should not be used on a public web server connected to the Internet as it does not contain - any measures to prevent Denial-of-Service-Attacks. It is provided as an example and as a starting point for - your own servlet. - -
-
- Create your own Servlet - - This section assumes you are familiar with embedding FOP. - -
- A minimal Servlet -

- Here is a minimal code snippet to demonstrate the basics: -

- private FopFactory fopFactory = FopFactory.newInstance(); -private TransformerFactory tFactory = TransformerFactory.newInstance(); - -public void doGet(HttpServletRequest request, - HttpServletResponse response) throws ServletException { - try { - response.setContentType("application/pdf"); - Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, response.getOutputStream()); - Transformer transformer = tFactory.newTransformer(); - Source src = new StreamSource("foo.fo"); - Result res = new SAXResult(fop.getDefaultHandler()); - transformer.transform(src, res); - } catch (Exception ex) { - throw new ServletException(ex); - } -} - - There are numerous problems with the code snippet above. - Its purpose is only to demonstrate the basic concepts. - See below for details. - -
-
- Adding XSL tranformation (XSLT) -

- A common requirement is to transform an XML source to - XSL-FO using an XSL transformation. It is recommended to use - JAXP for this task. The following snippet shows the basic - code: -

- private FopFactory fopFactory = FopFactory.newInstance(); -private TransformerFactory tFactory = TransformerFactory.newInstance(); - -public void init() throws ServletException { - //Optionally customize the FopFactory and TransformerFactory here -} - -[..] - - //Setup a buffer to obtain the content length - ByteArrayOutputStream out = new ByteArrayOutputStream(); - - //Setup FOP - Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, out); - - //Setup Transformer - Source xsltSrc = new StreamSource(new File("foo-xml2fo.xsl")); - Transformer transformer = tFactory.newTransformer(xsltSrc); - - //Make sure the XSL transformation's result is piped through to FOP - Result res = new SAXResult(fop.getDefaultHandler()); - - //Setup input - Source src = new StreamSource(new File("foo.xml")); - - //Start the transformation and rendering process - transformer.transform(src, res); - - //Prepare response - response.setContentType("application/pdf"); - response.setContentLength(out.size()); - - //Send content to Browser - response.getOutputStream().write(out.toByteArray()); - response.getOutputStream().flush(); - - Buffering the generated PDF in a ByteArrayOutputStream is done to avoid potential - problems with the Acrobat Reader Plug-in in Microsoft Internet Explorer. - -

- The Source instance used above is simply an - example. If you have to read the XML from a string, supply - a new StreamSource(new - StringReader(xmlstring)). Constructing and reparsing - an XML string is generally less desirable than using a - SAXSource if you generate your XML. You can alternatively - supply a DOMSource as well. You may also use dynamically - generated XSL if you like. -

-

- Because you have an explicit Transformer object, you can also use it to - explicitely set parameters for the transformation run. -

-
-
- Custom configuration -

- You can easily set up your own FOUserAgent as demonstrated on the Embedding page. -

-
-
- Improving performance -

- There are several options to consider: -

-
    -
  • - Instead of java.io.ByteArrayOutputStream consider using the ByteArrayOutputStream - implementation from the Jakarta Commons IO project which allocates less memory. - The full class name is: org.apache.commons.io.output.ByteArrayOutputStream -
    • -
  • - In certain cases it can help to write the generated PDF to a temporary file so - you can quickly reuse the file. This is especially useful, if Internet Explorer - calls the servlet multiple times with the same request or if you often generate - equal PDFs. -
    • -
-

- Of course, the - performance hints from the Embedding page - apply here, too. -

-
-
- Accessing resources in your web application -

- Often, you will want to use resources (stylesheets, images etc.) which are bundled with - your web application. FOP provides a URIResolver implementation that lets you access - files via the Servlet's ServletContext. The class is called - org.apache.fop.servlet.ServletContextURIResolver. -

-

- Here's how to set it up in your servlet. Instantiate a new instance in the servlet's - init() method: -

- -

- The ServletContextURIResolver reacts on URIs beginning with "servlet-context:". If you - want to access an image in a subdirectory of your web application, you could, for - example, use: "servlet-context:/images/myimage.png". Don't forget the leading slash - after the colon! -

-

- Further down, you can use the URIResolver for various things: -

-
    -
  • - With the Transformer (JAXP/XSLT) so things like document() functions can resolver - "servlet-context:" URIs. -
    • -
  • - With the FopFactory so every resource FOP loads can be loaded using a "servlet-context:" - URI. -
    • -
  • - You can the ServletContextURIResolver yourself in your servlet code to access - stylesheets or XML files bundled with your web application. -
    • -
-

- Here are some example snippets: -

- -
-
-
- Notes on Microsoft Internet Explorer -

- Some versions of Internet Explorer will not automatically show the PDF or call the servlet multiple times. - These are well-known limitations of Internet Explorer and are not a problem of the servlet. - However, Internet Explorer can still be used to download the PDF so that it can be viewed later. - Here are some suggestions in this context: -

-
    -
  • - Use an URL ending in .pdf, like - http://myserver/servlet/stuff.pdf. Yes, the servlet can - be configured to handle this. If the URL has to contain parameters, - try to have both the base URL as well as the last parameter end in - .pdf, if necessary append a dummy parameter, like - http://myserver/servlet/stuff.pdf?par1=a&par2=b&d=.pdf. The - effect may depend on IEx version. -
    • -
  • - Give IEx the opportunity to cache. In particular, ensure the - server does not set any headers causing IEx not to cache the - content. This may be a real problem if the document is sent - over HTTPS, because most IEx installations will by default - not cache any content retrieved over HTTPS. - Setting the Expires header entry may help in - this case:
    response.setDateHeader("Expires", - System.currentTimeMillis() + cacheExpiringDuration * - 1000);
    Consult your server manual and the - relevant RFCs for further details on HTTP headers and - caching. -
    • -
  • - Cache in the server. It may help to include a parameter in - the URL which has a timestamp as the value min order to - decide whether a request is repeated. IEx is reported to - retrieve a document up to three times, but never more often. -
    • -
-
-
- Servlet Engines -

- When using a servlet engine, there are potential CLASSPATH issues, and potential conflicts - with existing XML/XSLT libraries. Servlet containers also often use their own classloaders - for loading webapps, which can cause bugs and security problems. -

-
- Tomcat -

- Check Tomcat's documentation for detailed instructions about installing FOP and Cocoon. - There are known bugs that must be addressed, particularly for Tomcat 4.0.3. -

-
-
- WebSphere 3.5 -

- Put a copy of a working parser in some directory where WebSphere can access it. - For example, if /usr/webapps/yourapp/servlets is the CLASSPATH for your servlets, - copy the Xerces jar into it (any other directory would also be fine). - Do not add the jar to the servlet CLASSPATH, but add it to the CLASSPATH of the - application server which contains your web application. - In the WebSphere administration console, click on the "environment" button in the - "general" tab. In the "variable name" box, enter "CLASSPATH". - In the "value" box, enter the correct path to the parser jar file - (/usr/webapps/yourapp/servlets/Xerces.jar in our example here). - Press "OK", then apply the change and restart the application server. -

-
-
-
- Handling complex use cases -

- Sometimes the requirements for a servlet get quite sophisticated: SQL data sources, - multiple XSL transformations, merging of several datasources etc. In such a case - consider using Apache Cocoon instead - of a custom servlet to accomplish your goal. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.0/upgrading.xml b/src/documentation/content/xdocs/1.0/upgrading.xml deleted file mode 100644 index a4092c758..000000000 --- a/src/documentation/content/xdocs/1.0/upgrading.xml +++ /dev/null @@ -1,128 +0,0 @@ - - - - - -
- Upgrading from an Earlier Version of Apache™ FOP - $Revision$ -
- -
- Important! -

- If you're planning to upgrade to the latest Apache™ FOP version there are a few very important - things to consider: -

-
    -
  • - More than half of the codebase has been rewritten over the - last three years. With version 0.93 the code has reached - production level, and continues to improve with - version 0.94. -
    • -
  • - The API of FOP has changed considerably and is not - backwards-compatible with versions 0.20.5 and - 0.91beta. Version 0.92 introduced the new stable - API. -
    • -
  • - Since version 0.92 some deprecated methods which were part - of the old API have been removed. If you upgrade from 0.91 - beta, you will need to adjust your Java code. Similarly if - you upgrade from 0.92 and use deprecated methods. -
    • -
  • - If you are using a configuration file for version 0.20.5, you have to rebuild it in the new format. The format - of the configuration files has changed since version 0.20.5. See conf/fop.xconf for - an example configuration file. A XML Schema file can be found under - src/foschema/fop-configuration.xsd. -
    • -
  • - Beginning with version 0.94 you can skip the generation of - font metric files and remove the "font-metrics" attribute - in the font configuration. In the unlikely case that due to - a bug you still need to use font metrics files you will need - to regenerate the font metrics file if yours are from a FOP - version before 0.93. -
    • -
  • -

    - The new code is much more strict about the interpretation of the XSL-FO 1.1 specification. - Things that worked fine in version 0.20.5 might start to produce warnings or even errors - now. FOP 0.20.5 contains many bugs which have been corrected in the new code. -

    - - While FOP 0.20.5 allowed you to have empty fo:table-cell elements, the new code - will complain about that (unless relaxed validation is enabled) because the specification - demands at least one block-level element ((%block;)+, see - XSL-FO 1.1, 6.7.10) - inside an fo:table-cell element. - -
    • -
  • - Extensions and Renderers written for version 0.20.5 will not work with the new code! The new FOP - extension for Barcode4J is available since - January 2007. -
    • -
  • - The SVG Renderer and the MIF Handler have not been resurrected, yet! They are currently non-functional - and hope for someone to step up and reimplement them. -
    • -
-
-
- What you need to know when you upgrade! -

- When you use your existing FO files or XML/XSL files which work fine with FOP version - 0.20.5 against this FOP version some things may not work as expected. The following - list will hopefully help you to identify and correct those problems. -

-
    -
  • - Check the Compliance page for the feature causing - trouble. It may contain the necessary information to understand and resolve the problem. -
    • -
  • - Not all 0.20.5 output formats are supported. PDF and Postscript should be fully supported. - See Output Targets for a more complete description. -
    • -
  • - As stated above empty table cells <fo:table-cell></fo:table-cell> - are not allowed by the specification. The same applies to empty static-content - and block-container elements, for example. -
    • -
  • - 0.20.5 is not XSL-FO compliant with respect to sizing images (external-graphic) - or instream-foreign-object - objects. If images or SVGs are sized differently in your outputs with the new FOP version - check Bug 37136 - as it contains some hints on what to do. The file - - "examples/fo/basic/images.fo" has - a number of good examples that show the new, more correct behaviour. -
    • -
  • - The fox:outline extension is not implemented in this version anymore. - It has been superseded by the new bookmark elements from XSL-FO 1.1. -
    • -
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/accessibility.xml b/src/documentation/content/xdocs/1.1/accessibility.xml deleted file mode 100644 index 412519d8b..000000000 --- a/src/documentation/content/xdocs/1.1/accessibility.xml +++ /dev/null @@ -1,167 +0,0 @@ - - - - - -
- Apache™ FOP: Accessibility -
- -
- Overview -

- This page describes the - accessibility - features of Apache™ FOP. - Section 508 defines accessibility in the context - of electronic documents for the USA but other countries have similar requirements. -

-

- 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. -

-
-
- Enabling accessibility -

There are 3 ways to enable accessibility:

-
    -
  1. - Command line: The command line option -a turns on accessibility: - fop -a -fo mydocument.fo -pdf mydocument.pdf -
    2. -
  2. - Embedding: userAgent.setAccessibility(true); -
    3. -
  3. - Optional setting in fop.xconf file: - 
    -          <fop version="1.0">
-              <accessibility>true</accessibility>
-              ...
-          </fop>
-
    -
    4. -
-

- 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. -

- 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 in order to generate really accessible documents: -

-
    -
  • Table cells must have a table row as their parent.
    • -
  • - Images must have an alternate text: use the fox:alt-text extension attribute - (in the fox namespace) on - fo:external-graphic and fo:instream-foreign-object to specify a - short text describing the image. -
    • -
  • - Ensure that the order of fo:block-container elements in a page corresponds to - the reading order. -
    • -
  • - Specify the natural language of the document using the language and country properties - (or via the xml:lang shorthand property). -
    • -
-
-
- Customized Tagging -

The PDF Reference defines a set of standard Structure Types to - tag content. For example, ‘P’ is used for identifying paragraphs, ‘H1’ to ‘H6’ for headers, - ‘L’ for lists, ‘Div’ for block-level groups of elements, etc. This standard set is aimed at - improving interoperability between applications producing or consuming PDF.

-

FOP provides a default mapping of Formatting Objects to elements from that standard set. - For example, fo:page-sequence is mapped to ‘Part’, fo:block is - mapped to ‘P’, fo:list-block to ‘L’, etc.

-

You may want to customize that mapping to improve the accuracy of the tagging or deal with - particular FO constructs. For example, you may want to make use of the ‘H1’ to ‘H6’ tags to - make the hierarchical structure of the document appear in the PDF. This is achieved by using - the role XSL-FO property:

- ... -<fo:block role="H1" font-weight="bold">I. A Level 1 Heading</fo:block> -<fo:block>This is the first paragraph of the first section...</fo:block> -... -

If a non-standard structure type is specified, FOP will issue a warning and fall back to - the default tag associated to the Formatting Object.

-
-
- Testing -

- 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 there are certain - limitations. Please help us identify and close any gaps. -

-
    -
  • - The natural language can currently only be specified at the page-sequence level. The - document language is derived from the language of the first page-sequence. It is - currently not possible to override the language inside the content below the - page-sequence level. -
    • -
  • - It's currently not possible to specify the expanded form of an abbreviation or acronym. -
    • -
  • - SVG graphics (or images in general) are treated as a single figure. Text contained in - SVGs is not accessible. It's only possible to work with fox:alt-text. -
    • -
  • - The side regions (region-before, region-after etc.) are currently not specially - identified. Screen readers may read their content at page changes. -
    • -
-
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/anttask.xml b/src/documentation/content/xdocs/1.1/anttask.xml deleted file mode 100644 index ba53fe7d1..000000000 --- a/src/documentation/content/xdocs/1.1/anttask.xml +++ /dev/null @@ -1,236 +0,0 @@ - - - - - -
- Apache™ FOP: Ant task - $Revision$ -
- -

- Apache™ FOP provides an Ant task for automating the document build process. -

-
- Description -

- The FOP Ant task will convert XSL-FO documents to PDF, PS, PCL etc. output - (see Output formats for available formats). -

-

- To call FOP tasks within Ant, first add a FOP task definition to your Ant build file. - One method of defining the task is as follows: -

- - - - - - - - - - - - - - ]]> -

- Then create FOP tasks within your Ant build file, using the FOP task parameters listed below.

-
- -
Parameters for FOP Ant task - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Parameters specified as attributes
AttributeDescriptionRequired
fofileXSL-FO file to be renderedYes, if no fileset nested element is used
xmlfileXML input fileYes, if no fofile is specified
xsltfileXSLT input fileYes, if no fofile is specified
outfileOutput filenameYes, when fofile is used. (This attribute is not valid for filesets.)
formatPossible output formats:
- application/X-fop-awt-preview
- application/X-fop-print
- application/X-fop-areatree
- application/pdf
- application/postscript
- application/mif
- application/rtf, - text/richtext, - text/rtf
- application/x-pcl, - application/vnd.hp-PCL
- application/x-afp, - application/vnd.ibm.modcap
- text/plain
- image/svg+xml
- image/gif
- image/png
- image/tiff
- 		No, defaults to application/pdf
outdirOutput directoryRequired if a fileset is used to specify the files to render; optional for fofile. (Can alternatively specify the full path in the fofile value.)
forceRecreate target files, even if they are newer than their corresponding - source files. Note: This attribute is available in post-0.20.5 - versions (0.20.x nightly build and 1.0dev) only; target files are - always generated (i.e., force=true) in 0.20.5 release. - No, default is false
basedirBase directory to resolve relative references (e.g., graphics files) within the - FO document. - No, for single FO File entry, default is to use the location - of that FO file. -
relativebaseFor fileset usage only. A value of true specifies using the location - of each .fo file as the base directory for resolving relative file references located - within that .fo file. A value of false specifies using the value of - basedir for all files within the fileset, or just the current working directory - if basedir is not specified. - No, default is false. -
userconfigUser configuration file (same as the FOP "-c" command line option).No
messagelevelLogging level
- Possible values: error, warn, info, verbose, debug. Currently doesn't work in FOP Trunk!!!		No, defaults to verbose
logFilesControls whether the names of the files that are processed are logged - (true) or not (false). Currently doesn't work in FOP Trunk!!!No, default is true
throwexceptionsControls whether or not an exception is thrown if an error occurs during rendering.Default is true
-

- - - - - - - - - - - -
Parameters specified as nested elements
AttributeDescriptionRequired
filesetFileSets - are used to specify multiple XSL-FO files to be rendered.Yes, if no fofile attribute is supplied
-

-
- Examples -

- The following example converts a single XSL-FO file to a PDF document: -

- - - - - ]]> -

- This example converts all XSL-FO files within an entire directory to PostScript: -

- - - - - - - - ]]> -

- The following example transforms and converts a single XML and XSLT file to an AFP document: -

- - - - ]]> -

- This example transforms and converts all XML files within an entire directory to PostScript: -

- - - - - - - - ]]> -
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/compiling.xml b/src/documentation/content/xdocs/1.1/compiling.xml deleted file mode 100644 index 054f209b3..000000000 --- a/src/documentation/content/xdocs/1.1/compiling.xml +++ /dev/null @@ -1,147 +0,0 @@ - - - - - -
- Apache™ FOP: Building from Source Code - $Revision$ -
- -
- Do You Need To Build? - - - - -

- Apache™ FOP snapshots are either pre-compiled binary or source. - If you are using a binary snapshot, it is already built and there is no need to build it again. - If you got the source code from a repository snapshot or via Subversion you will need to build FOP. - See the Download Instructions for information about where to obtain binary or repository snapshots, and whether a - binary or source snapshot is best for your needs. -

- -
-
- Set Up Your Environment -
- JDK -

- Building FOP 1.1 requires a minimum Java Development Kit (JDK/SDK) of 1.5 - (A Java Runtime Environment is not sufficient). -

-
-
- CLASSPATH -

- There is generally no need to setup a classpath. All libraries needed to compile FOP are included - in the source distribution and are referenced by the build script. - You will only need to adjust the classpath if you build FOP in some other way. See the build - script build.xml for details. -

-
-
- JAVA_HOME -

- The build script uses Apache Ant, a popular - Java-based build tool, which usually requires that the environment variable JAVA_HOME point to - your local JDK root directory. This is true even if you use JDK 1.4 or above, which normally - does not need this setting. -

-
-
- Apache Ant -

- Apache Ant (Version 1.7 or later) must be installed in order to - build FOP. Following best practices we don't include Ant with FOP anymore. You can find the - instructions to install Ant in the Ant manual on the web. -

-
-
-
- Run the Build Script -

- Change to the FOP root directory and build FOP by executing the build script (build.xml) - using the "ant" command. -

- - The "ant" command is only available on your system if you've properly - installed Apache Ant and added Ant's location to the PATH - environment variable. - -

- The file build.xml in the FOP root directory is the blueprint that Ant uses for the build. It - contains information for numerous build targets, many of which are building blocks to more - useful target, and others which are primarily used by the FOP developers. - You may benefit from looking through this file to learn more about the various build targets. - To obtain a complete list of useful build targets: -

- ant -projecthelp -

The most useful targets are:

-
    -
  • - package: Generates the JAR files (default). This is the normal build that - produces a jar file usable for running FOP. -
    • -
  • - clean : Cleans the build directory. This is useful for making sure that - any build errors are cleaned up before starting a new build. It should not ordinarily be - needed, but may be helpful if you are having problems with the build process itself. -
    • -
  • - javadocs: Creates the FOP API documentation. - A minimum JDK version of 1.4.2 is required for generating the javadocs. -
    • -
-

To run the build:

- ant [target ...] -

For example to do a normal build for the "all" target (which is the default):

- ant -

OR

- ant all -

To clean the build directory first:

- ant clean all - - If you want to shorten the build time you can just call the "package" target which - doesn't perform any automated tests during the build. - -
-
- Troubleshooting -

If you have problems building FOP, please try the following:

-
    -
  • Run the build with the target of "clean", then rerun the build.
    • -
  • Delete the build directory completely, then rerun the build.
    • -
  • - Make sure you do not have a non-FOP version of xerces.jar, xalan.jar, batik.jar, - or another dependency product somewhere in your CLASSPATH. -
    • -
  • - If the build still fails, see the Getting Help - page for further help. -
    • -
-
- - diff --git a/src/documentation/content/xdocs/1.1/complexscripts.xml b/src/documentation/content/xdocs/1.1/complexscripts.xml deleted file mode 100644 index 697205531..000000000 --- a/src/documentation/content/xdocs/1.1/complexscripts.xml +++ /dev/null @@ -1,694 +0,0 @@ - - - - - -
- Apache™ FOP: Complex Scripts -
- -
- Overview -

- This page describes the - complex scripts - features of Apache™ FOP, which include: -

-
    -
  • Support for languages written with right-to-left scripts, such as Arabic and Hebrew scripts.
    • -
  • Support for languages written with South Asian and Southeast Asian scripts, such as Devanagari, - Khmer, Tamil, Thai, and others.
    • -
  • Support for advanced substitution, reordering, and positioning of glyphs according to language - and script sensitive rules.
    • -
  • Support for advanced number to string formatting.
    • -
-
-
- Disabling complex scripts -

Complex script features are enabled by default. If some application of FOP does not - require this support, then it can be disabled in three ways:

-
    -
  1. - Command line: The command line option -nocs turns off complex script - features: fop -nocs -fo mydocument.fo -pdf mydocument.pdf -
    2. -
  2. - Embedding: userAgent.setComplexScriptFeaturesEnabled(false); -
    3. -
  3. - Optional setting in fop.xconf file: - 
    -<fop version="1.0">
-  <complex-scripts disabled="true"/>
-  ...
-</fop>
-
    -
    4. -
-

- When complex scripts features are enabled, additional information related to bidirectional - level resolution, the association between characters and glyphs, and glyph position adjustments - are added to the internal, parsed representation of the XSL-FO tree and its corresponding - formatted area tree. This additional information will somewhat increase the memory requirements for - processing documents that use these features. -

- A document author need not make explicit use of any complex scripts feature in order - for this additional information to be created. For example, if the author makes use of a font - that contains OpenType GSUB and/or GPOS tables, then those tables will be automatically used - unless complex scripts features are disabled. -
-
- Changes to your XSL-FO input files -

- In most circumstances, XSL-FO content does not need to change in order to make use of - complex scripts features; however, in certain contexts, fully automatic processing is not - sufficient. In these cases, an author may make use of the following XSL-FO constructs: -

-
    -
  • The script property.
    • -
  • The language property.
    • -
  • The writing-mode property.
    • -
  • The number to string conversion properties: - format, - grouping-separator, - grouping-size, - letter-value, - and fox:number-conversion-features.
    • -
  • The fo:bidi-override element.
    • -
  • Explicit bidirectional control characters: U+200E LRM, U+200F RLM, U+202A LRE, - U+202B RLE, U+202C PDF, U+202D LRO, U+202E RLO.
    • -
  • Explicit join control characters: U+200C ZWNJ and U+200D ZWJ.
    • -
-
-
- Authoring Details -

The complex scripts related effects of the above enumerated XSL-FO constructs are more - fully described in the following sub-sections.

-
- Script Property -

In order to apply font specific complex script features, it is necessary to know - the script that applies to the text undergoing layout processing. This script is determined - using the following algorithm: -

-
    -
  1. If the FO element that governs the text specifies a - script - property and its value is not the empty string or "auto", then that script is used.
    2. -
  2. Otherwise, the dominant script of the text is determined automatically by finding the - script whose constituent characters appear most frequently in the text.
    3. -
-

In case the automatic algorithm does not produce the desired results, an author may - explicitly specify a script property with the desired script. If specified, - it must be one of the four-letter script code specified in - ISO 15924 Code List or - in the Extended Script Codes table. Comparison - of script codes is performed in a case-insensitive manner, so it does not matter what case - is used when specifying these codes in an XSL-FO document.

-
- Standard Script Codes -

The following table enumerates the standard ISO 15924 4-letter codes recognized by FOP.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
CodeScript
arabArabic
bengBengali
bopoBopomofo
cyrlCyrillic
devaDevanagari
ethiEthiopic
georGeorgian
grekGreek
gujrGujarati
guruGurmukhi
hangHangul
haniHan
hebrHebrew
hiraHiragana
kanaKatakana
kndaKannada
khmrKhmer
laooLao
latnLatin
mlymMalayalam
mymrBurmese
mongMongolian
oryaOriya
sinhSinhalese
tamlTamil
teluTelugu
thaiThai
tibtTibetan
zmthMath
zsymSymbol
zyyyUndetermined
zzzzUncoded
-
-
- Extended Script Codes -

The following table enumerates a number of non-standard extended script codes recognized by FOP.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
CodeScriptComments
bng2BengaliOpenType Indic Version 2 (May 2008 and following) behavior.
dev2DevanagariOpenType Indic Version 2 (May 2008 and following) behavior.
gur2GurmukhiOpenType Indic Version 2 (May 2008 and following) behavior.
gjr2GujaratiOpenType Indic Version 2 (May 2008 and following) behavior.
knd2KannadaOpenType Indic Version 2 (May 2008 and following) behavior.
mlm2MalayalamOpenType Indic Version 2 (May 2008 and following) behavior.
ory2OriyaOpenType Indic Version 2 (May 2008 and following) behavior.
tml2TamilOpenType Indic Version 2 (May 2008 and following) behavior.
tel2TeluguOpenType Indic Version 2 (May 2008 and following) behavior.
- - Explicit use of one of the above extended script codes is not portable, - and should be limited to use with FOP only. - - - When performing automatic script determination, FOP selects the OpenType Indic - Version 2 script codes by default. If the author requires Version 1 behavior, then - an explicit, non-extension script code should be specified in a governing script - property. - -
-
-
- Language Property -

Certain fonts that support complex script features can make use of language information in order for - language specific processing rules to be applied. For example, a font designed for the Arabic script may support - typographic variations according to whether the written language is Arabic, Farsi (Persian), Sindhi, Urdu, or - another language written with the Arabic script. In order to apply these language specific features, the author - may explicitly mark the text with a language - property.

-

When specifying the language property, the value of the property must be either an - ISO639-2 3-letter code or an - ISO639-1 2-letter code. Comparison of language - codes is performed in a case-insensitive manner, so it does not matter what case is used when specifying these - codes in an XSL-FO document.

-
-
- Writing Mode Property -

The writing-mode property is used to determine the axes and direction of the inline - progression direction, the block progression direction, the column progression direction (in tables - and flows), the shift direction, region placement, the resolution of writing-mode relative property - values (such as start, end, before, after), and the default block (paragraph) bidirectionality - level. -

-

The writing-mode property is inherited, so it can appear on any XSL-FO element type; however, - it applies (semantically) only to the following element types: -

-
    -
  • fo:page-sequence
    • -
  • fo:simple-page-master
    • -
  • fo:region-*
    • -
  • fo:block-container
    • -
  • fo:inline-container
    • -
  • fo:table
    • -
-

If it is not specified on one of these element types, but is specified on an ancestor element, then the value specified on that - ancestor element (the inherited value) is used; otherwise, the initial value lr-tb is used.

-

At present, only the following values of the writing-mode property are supported:

-
    -
  • lr-tb
    • -
  • rl-tb
    • -
  • lr
    • -
  • rl
    • -
-

Writing modes that employ a vertical inline progression direction are not yet supported.

-
- -
- Bidi Override Element -

The fo:bidi-override - element may be used to override default bidirectional processing behavior, - including default embedding levels and default character directionality. In the absence of either this element - or use of explicit Bidi Control Characters, the default behavior prescribed - by the Unicode Bidirectional Algorithm - applies. -

-
-
- Bidi Control Characters -

In addition to the use of the Bidi Override Element, an author - may make use of the following explicit Unicode Bidi Control Characters:

-
    -
  • U+200E - LEFT-TO-RIGHT MARK (LRM)
    • -
  • U+200F - RIGHT-TO-LEFT MARK (RLM)
    • -
  • U+202A - LEFT-TO-RIGHT EMBEDDING (LRE)
    • -
  • U+202B - RIGHT-TO-LEFT EMBEDDING (RLE)
    • -
  • U+202C - POP DIRECTIONAL FORMATTING (PDF)
    • -
  • U+202D - LEFT-TO-RIGHT OVERRIDE (LRO)
    • -
  • U+202E - RIGHT-TO-LEFT OVERRIDE (RLO)
    • -
-

If an embedding or override is not terminated (using U+202C PDF) prior to the end of a - delimited text range, - then it is automatically terminated by FOP. -

-
-
- Join Control Characters -

In order to prevent joining behavior in contexts where joining occurs by default, - for example, between U+0628 ARABIC LETTER BEH and U+0646 ARABIC LETTER NOON, - an author may used a U+200C ZERO WIDTH NON-JOINER (ZWNJ). -

-

Conversely, in order to force joining behavior in contexts where joining does not occur by default, - for example, between U+0628 ARABIC LETTER BEH and U+0020 SPACE, an author may used a U+200D ZERO WIDTH JOINER (ZWJ). -

-

The behavior of ZWNJ and ZWJ is script specific. See - The Unicode Standard, Chapter 8, - Middle Eastern Scripts for information on the use of these control characters with the Arabic - script. See - The Unicode Standard, Chapter 9, - South Asian Scripts - I for information on the use of these control characters with common - Indic scripts. -

-
-
-
- Supported Scripts -

Support for specific complex scripts is enumerated in the following table. Support - for those marked as not being supported is expected to be added in future revisions.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ScriptSupportTestedComments
Arabicfullfull
Bengalinonenone
Burmesenonenone
Devanagaripartialpartialjoin controls (ZWJ, ZWNJ) not yet supported
Khmernonenone
Gujaratipartialnonepre-alpha
Gurmukhipartialnonepre-alpha
Hebrewfullpartial
Kannadanonenone
Laononenone
Malayalamnonenone
Mongoliannonenone
Oriyanonenone
Tamilnonenone
Telugunonenone
Tibetannonenone
Thainonenone
-
-
- Supported Fonts -

Support for specific fonts is enumerated in the following sub-sections. If a given - font is not listed, then it has not been tested with these complex scripts features.

-
- Arabic Fonts - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FontVersionGlyphsComments
Arial Unicode MS1.0150377limited GPOS support
Lateef1.01147language features for Kurdish (KUR), Sindhi (SND), Urdu (URD)
Scheherazade1.01197language features for Kurdish (KUR), Sindhi (SND), Urdu (URD)
Simplified Arabic1.01 - contains invalid, out of order coverage table entries
Simplified Arabic5.00414lacks GPOS support
Simplified Arabic5.92473includes GPOS for advanced position adjustment
Traditional Arabic1.01530lacks GPOS support
Traditional Arabic5.00530lacks GPOS support
Traditional Arabic5.92589includes GPOS for advanced position adjustment
-
-
- Devanagari Fonts - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FontVersionGlyphsComments
Aparajita1.00706 -
Kokila1.00706 -
Mangal5.01885designed for use in user interfaces
Utsaah1.00706 -
-
-
-
- Other Limitations -

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

-
    -
  • Only the PDF output format fully supports complex scripts features at the present time.
    • -
  • Shaping context does not extend across an element boundary. This limitation prevents the use of - fo:character, fo:inline or fo:wrapper in order to colorize - individual Arabic letters without affecting shaping behavior across the element boundary.
    • -
-
- - - diff --git a/src/documentation/content/xdocs/1.1/configuration.xml b/src/documentation/content/xdocs/1.1/configuration.xml deleted file mode 100644 index b30a091a5..000000000 --- a/src/documentation/content/xdocs/1.1/configuration.xml +++ /dev/null @@ -1,541 +0,0 @@ - - - - - -
- Apache™ FOP: Configuration - $Revision$ -
- - -
- Configuration File Basics -

- The Apache™ FOP configuration file is an XML file containing a variety of settings that are useful - for controlling FOP's behavior, and for helping it find resources that you wish it to use. -

-

- The easiest way to get started using a FOP configuration file is to copy the sample found - at {fop-dir}/conf/fop.xconf to a location of your choice, and then to - edit it according to your needs. - It contains templates for the various configuration options, most of which are commented - out. Remove the comments and change the settings for entries that you wish to use. - Be sure to follow any instructions, including comments which specify the value range. - Also, since the configuration file is XML, be sure to keep it well-formed. -

-
- Making Configuration Available to FOP -

After creating your configuration file, you must tell FOP how to find it:

- -

- See Setting the Configuration Programmatically - for instructions on how to do so in an embedded environment. -

-
-
-
- Summary of the General Configuration Options - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ElementData Type (for the value)DescriptionDefault Value
baseURL or directorySpecifies the base URL based on which relative URL will be resolved.current directory
font-baseURL or directorySpecifies the base URL based on which relative font URLs will be resolved. - base URL/directory (above)
hyphenation-baseURL or directorySpecifies the base URL based on which relative URLs to hyphenation pattern - files will be resolved. If not specified, support for user-supplied hyphenation - patterns remains disabled. - disabled
Relative URIs for the above three properties are evaluated relative to the base URI of the configuration file. If the configuration is provided programmatically, the base URI can be set with FopFactory.setUserConfigBaseURI; default is the current working directory.
hyphenation-patternString, attribute lang, attribute country (optional)Register a file name for the hyphenation pattern for the mentioned language and country. Language ll and country CC must both consist of two letters.ll_CC
source-resolutionInteger, dpi - Resolution in dpi (dots per inch) which is used internally to determine the pixel - size for SVG images and bitmap images without resolution information. - 72 dpi
target-resolutionInteger, dpi - Resolution in dpi (dots per inch) used to specify the output resolution for bitmap - images generated by bitmap renderers (such as the TIFF renderer) and by bitmaps - generated by Apache Batik for filter effects and such. - 72 dpi
strict-configurationBoolean (true, false) - Setting this option to 'true' will cause FOP to strictly verify the contents of the - FOP configuration file to ensure that defined resources (such as fonts and base - URLs/directories) are valid and available to FOP. Any errors found will cause FOP to - immediately raise an exception.false
strict-validationBoolean (true, false) - Setting this option to 'false' causes FOP to be more forgiving about XSL-FO validity, - for example, you're allowed to specify a border on a region-body which is supported - by some FO implementations but is non-standard. Note that such a border would - currently have no effect in Apache FOP.true
break-indent-inheritanceBoolean (true, false) - Setting this option to 'true' causes FOP to use an alternative rule set to determine - text indents specified through margins, start-indent and end-indent. Many commercial - FO implementations have chosen to break the XSL specification in this aspect. This - option tries to mimic their behaviour. Please note that Apache FOP may still not - behave exactly like those implementations either because FOP has not fully matched - the desired behaviour and because the behaviour among the commercial implementations - varies. The default for this option (i.e. false) is to behave exactly like the - specification describes.false
complex-scriptsattribute disabled (optional) - If present and if an attribute 'disabled' is specified with the value 'false', then - complex script features are disabled. The same result can be obtained on an FOP - per-invocation basis by specifying a '-nocs' command line option when invoking FOP. - When complex script features are disabled, all bidirectional processing and complex - character to glyph mapping processing is disabled; in addition, the loading of - GDEF, GSUB, and GPOS advanced typographic tables is disabled for OpenType and - TrueType fonts. Unless disabled by this mechanism or by use of the '-nocs' command - line option, complex script features will be enabled by default. - n/a
default-page-settingsn/a - Specifies the default width and height of a page if "auto" is specified - for either or both values. Use "height" and "width" attributes on the - default-page-settings element to specify the two values."height" 11 inches, "width" 8.26 inches
use-cacheboolean (true, false)All fonts information that has been gathered as a result of "directory" - or "auto-detect" font configurations will be cached for future rendering runs. - This setting should improve performance on systems where - fonts have been configured using the "directory" or "auto-detect" tag mechanisms. - By default this option is switched on.true
cache-fileStringThis option specifies the file/directory path of the fop cache file. - This file is currently only used to cache font triplet information for future reference.${base}/conf/fop.cache
renderers(see text below)Contains the configuration for each renderer. See below.N/A
-

- This is an excerpt from the example configuration file coming with FOP: -

- - - - true - - - true - - - ./ - - - ./ - - - 72 - - 72 - - - - - - nl_Bel - - -]]> -
-
- Image Loading Customization -

- Apache FOP uses the image loading framework from - Apache XML Graphics Commons to load - images using various plug-ins. Every image loader plug-in has a hard-coded usage penalty - that influences which solution is chosen if there are multiple possibilities to load an image. - Sometimes, though, these penalties need to be tweaked and this can be done in the FOP - configuration. An example: -

- - [..] - - - - - ]]> -

- The first penalty element increases the penalty for the raw CCITT loader. This practically - forces the decoding of CCITT compressed TIFF images except if there are no TIFF codecs - available. -

-

- The second penalty element sets an "infinite" penalty for the TIFF loader using the internal - TIFF codec. This practically disables that plug-in as it will never be chosen as a possible - solution. -

-

- Negative penalties are possible to promote a plug-in but a negative penalty sum will be - treated as zero penalty in most cases. For more details on the image loading framework, - please consult the documentation there. -

-
-
- Renderer configuration -

- Each Renderer has its own configuration section which is identified by the - MIME type the Renderer is written for, ex. "application/pdf" for the PDF Renderer. -

-

- The configuration for the PDF Renderer could look like this: -

- - - - - flate - - - - - - - - - - - - - - - ]]> -

- The details on the font configuration can be found on the separate Fonts page. - Note especially the section entitled Register Fonts with FOP. -

-
- Special Settings for the PDF Renderer -

- The configuration element for the PDF renderer contains two elements. One is for the font configuration - (please follow the link above) and one is for the "filter list". The filter list controls how the - individual objects in a PDF file are encoded. By default, all objects get "flate" encoded (i.e. simply - compressed with the same algorithm that is also used in ZIP files). Most users don't need to change that - setting. For debugging purposes, it may be desired not to compress the internal objects at all so the - generated PDF commands can be read. In that case, you can simply use the following filter list. The - second filter list (type="image") ensures that all images still get compressed but also ASCII-85 encoded - so the produced PDF file is still easily readable in a text editor. -

- - - null - - - flate - ascii-85 - - - ]]> -

- Another (optional) setting specific to the PDF Renderer is an output color profile, an ICC - color profile which indicates the target color space the PDF file is generated for. This - setting is mainly used in conjunction with the PDF/X feature. - An example: -

- - C:\FOP\Color\EuropeISOCoatedFOGRA27.icc - - ]]> -

- Some people don't have high requirements on color fidelity but instead want the smallest - PDF file sizes possible. In this case it's possible to disable the default sRGB color space - which XSL-FO requires. This will cause RGB colors to be generated as device-specific RGB. - Please note that this option is unavailable (and will cause an error) if you enable - PDF/A or PDF/X functionality or if you specify an output profile. This setting will make the - PDF about 4KB smaller. To disable the sRGB color space add the following setting: -

- - true - - ]]> - -

FOP supports encryption of PDF output, thanks to Patrick C. Lankswert. - This feature is commonly used to prevent unauthorized viewing, printing, editing, copying text - from the document and doing annotations. It is also possible to ask the user for a password in - order to view the contents. Note that there already exist third party applications which can - decrypt an encrypted PDF without effort and allow the aforementioned operations, therefore the - degree of protection is limited. For further information about features and restrictions - regarding PDF encryption, look at the documentation coming with Adobe Acrobat or the technical - documentation on the Adobe web site.

- - - 128 - testuserpass - testownerpass - - - - - - - - - - ]]> -

- By default FOP produces PDF files of version 1.4, but this can be changed in order to benefit - from features that appeared in newer versions of PDF. At the moment, only a few features from - PDF 1.5 have been implemented, but the configuration element will accept any value between - 1.4 and 1.7. This is the value that will appear in the PDF header, although only features up - to 1.5 will actually be used. - - 1.5 - - ]]> -

- -
-
- Special Settings for the PostScript Renderer -

- Besides the normal font configuration (the same "fonts" element as for the PDF renderer) the PostScript - renderer has an additional setting to force landscape pages to be rotated to fit on a page inserted into - the printer in portrait mode. Set the value to "true" to activate this feature. The default is "false". - Example: -

- - true - - - - - - - - - - - - ]]> -
-
- Special Settings for the PCL Renderer -

- Non-standard fonts for the PCL renderer are made available through the Java2D subsystem which means that - you don't have to do any custom font configuration in this case but you have to use the font names - offered by Java. -

-

- Additionally, there are certain settings that control how the renderer handles various elements. -

- - quality - bitmap -]]> -

- The default value for the "rendering" setting is "speed" which causes borders - to be painted as plain rectangles. In this mode, no special borders (dotted, - dashed etc.) are available. If you want support for all border modes, set the - value to "quality" as indicated above. This will cause the borders to be painted - as bitmaps. -

-

- The default value for the "text-rendering" setting is "auto" which paints the - base fonts using PCL fonts. Non-base fonts are painted as bitmaps through Java2D. - If the mix of painting methods results in unwelcome output, you can set this - to "bitmap" which causes all text to be rendered as bitmaps. -

-
-
- Special Settings for the AFP Renderer -

-

-

- Additionally, there are certain settings that control how the renderer handles various elements. -

- - - 240 - 2.5 - - - resources.afp -]]> -

- The default value for the images "mode" setting is "b+w" (black and white). When the images "mode" setting is "b+w" a "bits-per-pixel" setting can be provided to aid the grayscale conversion process. With this setting all images referenced in your source document are converted to an IOCA FS45 grayscale bitmap image form. - When the setting is "color" all images are converted to an IOCA FS45 color bitmap image form. When "native" setting is "true", all images encountered (TIFF, GIF, JPEG and Encapsulated Postscript etc.) will be embedded directly in the datastream in their native form using a MO:DCA Object Container. -

-

- The default value for the "renderer-resolution" is 240 dpi. -

-

- The default line width is device dependent and may need to be fine tuned so that the output matches the expected result. The default correction value is 2.5. -

- -

- By default if there is no configuration definition for "resource-group-file", external resources will be placed in a file called resources.afp. -

-
-
- -
- When it does not work - -

FOP searches the configuration file for the information it -expects, at the position it expects. When that information is not -present, FOP will not complain, it will just continue. When there is -other information in the file, FOP will not complain, it will just -ignore it. That means that when your configuration information is in -the file but in a different XML element, or in a different XML path, -than FOP expects, it will be silently ignored.

- -

Check the following possibilities:

- -
    -
  • The format of the configuration file has changed -considerably between FOP 0.20.5 and FOP 1.0 and its beta versions. Did -you convert your file to the new format?
    • - -
  • The FOP distribution contains a schema for configuration -files, at src/foschema/fop-configuration.xsd. Did you validate your -configuration file against it? Add the following schema location to -the schema element: - -]]> - - -and run the configuration file through a validating schema -parser. Note that the schema cannot detect all errors, and that it is -stricter about the order of some elements than FOP itself is.
    • - -
  • Run FOP in debug mode (command line option --d). This makes FOP report which configuration -information it finds. Check if FOP finds what you expect.
    • - -
- -
- - diff --git a/src/documentation/content/xdocs/1.1/embedding.xml b/src/documentation/content/xdocs/1.1/embedding.xml deleted file mode 100644 index 24c74f970..000000000 --- a/src/documentation/content/xdocs/1.1/embedding.xml +++ /dev/null @@ -1,752 +0,0 @@ - - - - - - -
- Apache™ FOP: Embedding - How to Embed FOP in a Java application - $Revision$ -
- - -
- Overview -

- Review Running Apache™ FOP for important information that applies - to embedded applications as well as command-line use, such as options and performance. -

-

- To embed Apache™ FOP in your application, first create a new - org.apache.fop.apps.FopFactory instance. This object can be used to launch multiple - rendering runs. For each run, create a new org.apache.fop.apps.Fop instance through - one of the factory methods of FopFactory. In the method call you specify which output - format (i.e. MIME type) to use and, if the selected output format requires an - OutputStream, which OutputStream to use for the results of the rendering. You can - customize FOP's behaviour in a rendering run by supplying your own FOUserAgent - instance. The FOUserAgent can, for example, be used to set your own document handler - instance (details below). Finally, you retrieve a SAX DefaultHandler instance from - the Fop object and use that as the SAXResult of your transformation. -

-
-
- The API -

- FOP has many classes which express the "public" access modifier, however, this is not - indicative of their inclusion into the public API. Every attempt will be made to keep the - public API static, to minimize regressions for existing users, however, since the API is not - clearly defined, the list of classes below are the generally agreed public API: - -

-
-
- Basic Usage Pattern -

- Apache FOP relies heavily on JAXP. It uses SAX events exclusively to receive the XSL-FO - input document. It is therefore a good idea that you know a few things about JAXP (which - is a good skill anyway). Let's look at the basic usage pattern for FOP... -

-

Here is the basic pattern to render an XSL-FO file to PDF: -

- -

- Let's discuss these 5 steps in detail: -

-
    -
  • - Step 1: You create a new FopFactory instance. The FopFactory instance holds - references to configuration information and cached data. It's important to reuse this - instance if you plan to render multiple documents during a JVM's lifetime. -
    • -
  • - Step 2: You set up an OutputStream that the generated document - will be written to. It's a good idea to buffer the OutputStream as demonstrated - to improve performance. -
    • -
  • - Step 3: You create a new Fop instance through one of the factory - methods on the FopFactory. You tell the FopFactory what your desired output format - is. This is done by using the MIME type of the desired output format (ex. "application/pdf"). - You can use one of the MimeConstants.* constants. The second parameter is the - OutputStream you've setup up in step 2. -
    • -
  • - Step 4 We recommend that you use JAXP Transformers even - if you don't do XSLT transformations to generate the XSL-FO file. This way - you can always use the same basic pattern. The example here sets up an - "identity transformer" which just passes the input (Source) unchanged to the - output (Result). You don't have to work with a SAXParser if you don't do any - XSLT transformations. -
    • -
  • - Step 5: Here you set up the input and output for the XSLT - transformation. The Source object is set up to load the "myfile.fo" file. - The Result is set up so the output of the XSLT transformation is sent to FOP. - The FO file is sent to FOP in the form of SAX events which is the most efficient - way. Please always avoid saving intermediate results to a file or a memory buffer - because that affects performance negatively. -
    • -
  • - Step 6: Finally, we start the XSLT transformation by starting - the JAXP Transformer. As soon as the JAXP Transformer starts to send its output - to FOP, FOP itself starts its processing in the background. When the - transform() method returns FOP will also have finished converting - the FO file to a PDF file and you can close the OutputStream. - - It's a good idea to enclose the whole conversion in a try..finally statement. If - you close the OutputStream in the finally section, this will make sure that the - OutputStream is properly closed even if an exception occurs during the conversion. - -
    • -
-

- If you're not totally familiar with JAXP Transformers, please have a look at the - Embedding examples below. The section contains examples - for all sorts of use cases. If you look at all of them in turn you should be able - to see the patterns in use and the flexibility this approach offers without adding - too much complexity. -

-

- This may look complicated at first, but it's really just the combination of an - XSL transformation and a FOP run. It's also easy to comment out the FOP part - for debugging purposes, for example when you're tracking down a bug in your - stylesheet. You can easily write the XSL-FO output from the XSL transformation - to a file to check if that part generates the expected output. An example for that - can be found in the Embedding examples (See "ExampleXML2FO"). -

-
- Logging -

- Logging is now a little different than it was in FOP 0.20.5. We've switched from - Avalon Logging to Jakarta Commons Logging. - While with Avalon Logging the loggers were directly given to FOP, FOP now retrieves - its logger(s) through a statically available LogFactory. This is similar to the - general pattern that you use when you work with Apache Log4J directly, for example. - We call this "static logging" (Commons Logging, Log4J) as opposed to "instance logging" - (Avalon Logging). This has a consequence: You can't give FOP a logger for each - processing run anymore. The log output of multiple, simultaneously running FOP instances - is sent to the same logger. -

-

- By default, Jakarta Commons Logging uses - JDK logging (available in JDKs 1.4 or higher) as its backend. You can configure Commons - Logging to use an alternative backend, for example Log4J. Please consult the - documentation for Jakarta Commons Logging on - how to configure alternative backends. -

-

- As a result of the above we differentiate between two kinds of "logging": -

- -

- The use of "feedback" instead of "logging" is intentional. Most people were using - log output as a means to get feedback from events within FOP. Therefore, FOP now - includes an event package which can be used to receive feedback from - the layout engine and other components within FOP per rendering run. - This feedback is not just some - text but event objects with parameters so these events can be interpreted by code. - Of course, there is a facility to turn these events into normal human-readable - messages. For details, please read on on the Events page. - This leaves normal logging to be mostly a thing used by the FOP developers - although anyone can surely activate certain logging categories but the feedback - from the loggers won't be separated by processing runs. If this is required, - the Events subsystem is the right approach. -

-
- -
- Processing XSL-FO -

- Once the Fop instance is set up, call getDefaultHandler() to obtain a SAX - DefaultHandler instance to which you can send the SAX events making up the XSL-FO - document you'd like to render. FOP processing starts as soon as the DefaultHandler's - startDocument() method is called. Processing stops again when the - DefaultHandler's endDocument() method is called. Please refer to the basic - usage pattern shown above to render a simple XSL-FO document. -

-
- -
- Processing XSL-FO generated from XML+XSLT -

- If you want to process XSL-FO generated from XML using XSLT we recommend - again using standard JAXP to do the XSLT part and piping the generated SAX - events directly through to FOP. The only thing you'd change to do that - on the basic usage pattern above is to set up the Transformer differently: -

- -
-
-
- Input Sources -

- The input XSL-FO document is always received by FOP as a SAX stream (see the - Parsing Design Document for the rationale). -

-

- However, you may not always have your input document available as a SAX stream. - But with JAXP it's easy to convert different input sources to a SAX stream so you - can pipe it into FOP. That sounds more difficult than it is. You simply have - to set up the right Source instance as input for the JAXP transformation. - A few examples: -

-
    -
  • - URL: Source src = new StreamSource("http://localhost:8080/testfile.xml"); -
    • -
  • - File: Source src = new StreamSource(new File("C:/Temp/myinputfile.xml")); -
    • -
  • - String: Source src = new StreamSource(new StringReader(myString)); // myString is a String -
    • -
  • - InputStream: Source src = new StreamSource(new MyInputStream(something)); -
    • -
  • - Byte Array: Source src = new StreamSource(new ByteArrayInputStream(myBuffer)); // myBuffer is a byte[] here -
    • -
  • - DOM: Source src = new DOMSource(myDocument); // myDocument is a Document or a Node -
    • -
  • - Java Objects: Please have a look at the Embedding examples which contain an example for this. -
    • -
-

- There are a variety of upstream data manipulations possible. - For example, you may have a DOM and an XSL stylesheet; or you may want to - set variables in the stylesheet. Interface documentation and some cookbook - solutions to these situations are provided in - Xalan Basic Usage Patterns. -

-
-
- Configuring Apache FOP Programmatically -

- Apache FOP provides two levels on which you can customize FOP's - behaviour: the FopFactory and the user agent. -

-
- Customizing the FopFactory -

- The FopFactory holds configuration data and references to objects which are reusable over - multiple rendering runs. It's important to instantiate it only once (except in special - environments) and reuse it every time to create new FOUserAgent and Fop instances. -

-

- You can set all sorts of things on the FopFactory: -

-
    -
  • -

    - The font base URL to use when resolving relative URLs for fonts. Example: -

    - fopFactory.getFontManager().setFontBaseURL("file:///C:/Temp/fonts"); -
    • -
  • -

    - The hyphenation base URL to use when resolving relative URLs for - hyphenation patterns. Example: -

    - fopFactory.setHyphenBaseURL("file:///C:/Temp/hyph"); -
    • -
  • -

    - Disable strict validation. When disabled FOP is less strict about the rules - established by the XSL-FO specification. Example: -

    - fopFactory.setStrictValidation(false); -
    • -
  • -

    - Enable an alternative set of rules for text indents that tries to mimic the behaviour of many commercial - FO implementations, that chose to break the specification in this respect. The default of this option is - 'false', which causes Apache FOP to behave exactly as described in the specification. To enable the - alternative behaviour, call: -

    - fopFactory.setBreakIndentInheritanceOnReferenceAreaBoundary(true); -
    • -
  • -

    - Set the source resolution for the document. This is used internally to determine the pixel - size for SVG images and bitmap images without resolution information. Default: 72 dpi. Example: -

    - fopFactory.setSourceResolution(96); // =96dpi (dots/pixels per Inch) -
    • -
  • -

    - Manually add an ElementMapping instance. If you want to supply a special FOP extension - you can give the instance to the FOUserAgent. Normally, the FOP extensions can be automatically detected - (see the documentation on extension for more info). Example: -

    - fopFactory.addElementMapping(myElementMapping); // myElementMapping is a org.apache.fop.fo.ElementMapping -
    • -
  • -

    - Set a URIResolver for custom URI resolution. By supplying a JAXP URIResolver you can add - custom URI resolution functionality to FOP. For example, you can use - Apache XML Commons Resolver to make use of XCatalogs. Example: -

    - fopFactory.setURIResolver(myResolver); // myResolver is a javax.xml.transform.URIResolver - - Both the FopFactory and the FOUserAgent have a method to set a URIResolver. The URIResolver on the FopFactory - is primarily used to resolve URIs on factory-level (hyphenation patterns, for example) and it is always used - if no other URIResolver (for example on the FOUserAgent) resolved the URI first. - -
    • -
-
-
- Customizing the User Agent -

- The user agent is the entity that allows you to interact with a single rendering run, i.e. the processing of a single - document. If you wish to customize the user agent's behaviour, the first step is to create your own instance - of FOUserAgent using the appropriate factory method on FopFactory and pass that - to the factory method that will create a new Fop instance: -

- -

- You can do all sorts of things on the user agent: -

-
    -
  • -

    - The base URL to use when resolving relative URLs. Example: -

    - userAgent.setBaseURL("file:///C:/Temp/"); -
    • -
  • -

    - Set the producer of the document. This is metadata information that can be used for certain output formats such as PDF. The default producer is "Apache FOP". Example: -

    - userAgent.setProducer("MyKillerApplication"); -
    • -
  • -

    - Set the creating user of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setCreator("John Doe"); -
    • -
  • -

    - Set the author of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setAuthor("John Doe"); -
    • -
  • -

    - Override the creation date and time of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setCreationDate(new Date()); -
    • -
  • -

    - Set the title of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setTitle("Invoice No 138716847"); -
    • -
  • -

    - Set the keywords of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setKeywords("XML XSL-FO"); -
    • -
  • -

    - Set the target resolution for the document. This is used to - specify the output resolution for bitmap images generated by bitmap renderers - (such as the TIFF renderer) and by bitmaps generated by Apache Batik for filter - effects and such. Default: 72 dpi. Example: -

    - userAgent.setTargetResolution(300); // =300dpi (dots/pixels per Inch) -
    • -
  • -

    - Set your own Document Handler. This feature can be used for several purposes, the most likey usage of which would probably be - binding a MIME type when the output is Intermediate Format (see Document Handlers). This also allows advanced - users to create their own implementation of the document handler. -

    - userAgent.setDocumentHandlerOverride(documentHandler) // documentHandler is an instance of org.apache.fop.render.intermediate.IFDocumentHandler -
    • -
  • -

    - Set your own FOEventHandler instance. If you want to supply your own FOEventHandler or - configure an FOEventHandler subclass in a special way you can give the instance to the FOUserAgent. Normally, - the FOEventHandler instance is created by FOP. Example: -

    - userAgent.setFOEventHandlerOverride(myFOEventHandler); // myFOEventHandler is an org.apache.fop.fo.FOEventHandler -
    • -
  • -

    - Set a URIResolver for custom URI resolution. By supplying a JAXP URIResolver you can add - custom URI resolution functionality to FOP. For example, you can use - Apache XML Commons Resolver to make use of XCatalogs. Example: -

    - userAgent.setURIResolver(myResolver); // myResolver is a javax.xml.transform.URIResolver - - Both the FopFactory and the FOUserAgent have a method to set a URIResolver. The URIResolver on the FOUserAgent is - used for resolving URIs which are document-related. If it's not set or cannot resolve a URI, the URIResolver - from the FopFactory is used. - -
    • -
- - You should not reuse an FOUserAgent instance between FOP rendering runs although you can. Especially - in multi-threaded environment, this is a bad idea. - -
-
-
- Using a Configuration File -

- Instead of setting the parameters manually in code as shown above you can also set - many values from an XML configuration file: -

- -

- The layout of the configuration file is described on the Configuration page. -

-
-
- Document Handlers -

- The document handlers are classes that inherit from org.apache.fop.render.intermediate.IFDocumentHandler. This - is an interface for which a MIME type specific implementation can be created. This same handler is used either when XSL-FO - is used as the input or when Intermediate Format is used. Since IF is output format agnostic, if custom fonts or other - configuration information that affect layout (specific to a particular MIME type) are given then FOP needs that contextual - information. The document handler provides that context so that when the IF is rendered, it is more visually consistent with - FO rendering. The code below shows an example of how a document handler can be used to provide PDF configuration data to the - IFSerializer. - - The rest of the code is the same as in Basic Usage Patterns. -

-
-
- Hints -
- Object reuse -

- Fop instances shouldn't (and can't) be reused. Please recreate - Fop and FOUserAgent instances for each rendering run using the FopFactory. - This is a cheap operation as all reusable information is held in the - FopFactory. That's why it's so important to reuse the FopFactory instance. -

-
-
- AWT issues -

- If your XSL-FO files contain SVG then Apache Batik will be used. When Batik is - initialised it uses certain classes in java.awt that - intialise the Java AWT classes. This means that a daemon thread - is created by the JVM and on Unix it will need to connect to a - DISPLAY. -

-

- The thread means that the Java application may not automatically quit - when finished, you will need to call System.exit(). These - issues should be fixed in the JDK 1.4. -

-

- If you run into trouble running FOP on a head-less server, please see the - notes on Batik. -

-
-
- Getting information on the rendering process -

- To get the number of pages that were rendered by FOP you can call - Fop.getResults(). This returns a FormattingResults object - where you can look up the number of pages produced. It also gives you the - page-sequences that were produced along with their id attribute and their - numbers of pages. This is particularly useful if you render multiple - documents (each enclosed by a page-sequence) and have to know the number of - pages of each document. -

-
-
-
- Improving performance -

- There are several options to consider: -

-
    -
  • - Whenever possible, try to use SAX to couple the individual components involved - (parser, XSL transformer, SQL datasource etc.). -
    • -
  • - Depending on the target OutputStream (in case of a FileOutputStream, but not - for a ByteArrayOutputStream, for example) it may improve performance considerably - if you buffer the OutputStream using a BufferedOutputStream: - out = new java.io.BufferedOutputStream(out); -
    - Make sure you properly close the OutputStream when FOP is finished. -
    • -
  • - Cache the stylesheet. If you use the same stylesheet multiple times - you can set up a JAXP Templates object and reuse it each time you do - the XSL transformation. (More information can be found - here.) -
    • -
  • - Use an XSLT compiler like XSLTC - that comes with Xalan-J. -
    • -
  • - Fine-tune your stylesheet to make the XSLT process more efficient and to create XSL-FO that can - be processed by FOP more efficiently. Less is more: Try to make use of property inheritance where possible. -
    • -
  • - You may also wish to consider trying to reduce memory usage. -
    • -
-
-
- Multithreading FOP -

- Apache FOP may currently not be completely thread safe. - The code has not been fully tested for multi-threading issues, yet. - If you encounter any suspicious behaviour, please notify us. -

-

- There is also a known issue with fonts being jumbled between threads when using - the Java2D/AWT renderer (which is used by the -awt and -print output options). - In general, you cannot safely run multiple threads through the AWT renderer. -

-
-
- Examples -

- The directory "{fop-dir}/examples/embedding" contains several working examples. -

-
- ExampleFO2PDF.java -

This - - example -demonstrates the basic usage pattern to transform an XSL-FO -file to PDF using FOP. -

-
-
-
- ExampleXML2FO.java -

This - - example -has nothing to do with FOP. It is there to show you how an XML -file can be converted to XSL-FO using XSLT. The JAXP API is used to do the -transformation. Make sure you've got a JAXP-compliant XSLT processor in your -classpath (ex. Xalan). -

-
-
-
- ExampleXML2PDF.java -

This - - example -demonstrates how you can convert an arbitrary XML file to PDF -using XSLT and XSL-FO/FOP. It is a combination of the first two examples -above. The example uses JAXP to transform the XML file to XSL-FO and FOP to -transform the XSL-FO to PDF. -

-
-

-The output (XSL-FO) from the XSL transformation is piped through to FOP using -SAX events. This is the most efficient way to do this because the -intermediate result doesn't have to be saved somewhere. Often, novice users -save the intermediate result in a file, a byte array or a DOM tree. We -strongly discourage you to do this if it isn't absolutely necessary. The -performance is significantly higher with SAX. -

-
-
- ExampleObj2XML.java -

This - - example -is a preparatory example for the next one. It's an example that -shows how an arbitrary Java object can be converted to XML. It's an often -needed task to do this. Often people create a DOM tree from a Java object and -use that. This is pretty straightforward. The example here, however, shows how -to do this using SAX, which will probably be faster and not even more -complicated once you know how this works. -

-
-

-For this example we've created two classes: ProjectTeam and ProjectMember -(found in xml-fop/examples/embedding/java/embedding/model). They represent -the same data structure found in -xml-fop/examples/embedding/xml/xml/projectteam.xml. We want to serialize to XML a -project team with several members which exist as Java objects. -Therefore we created the two classes: ProjectTeamInputSource and -ProjectTeamXMLReader (in the same place as ProjectTeam above). -

-

-The XMLReader implementation (regard it as a special kind of XML parser) is -responsible for creating SAX events from the Java object. The InputSource -class is only used to hold the ProjectTeam object to be used. -

-

-Have a look at the source of ExampleObj2XML.java to find out how this is -used. For more detailed information see other resources on JAXP (ex. -An older JAXP tutorial). -

-
-
- ExampleObj2PDF.java -

This - - example -combines the previous and the third to demonstrate -how you can transform a Java object to a PDF directly in one smooth run -by generating SAX events from the Java object that get fed to an XSL -transformation. The result of the transformation is then converted to PDF -using FOP as before. -

-
-
-
- ExampleDOM2PDF.java -

This - - example -has FOP use a DOMSource instead of a StreamSource in order to -use a DOM tree as input for an XSL transformation. -

-
-
- ExampleSVG2PDF.java (PDF Transcoder example) -

This - - example -shows the usage of the PDF Transcoder, a sub-application within FOP. -It is used to generate a PDF document from an SVG file. -

-
-
- ExampleConcat.java (IF Concatenation example) -

-This can be found in the embedding.intermediate package within the -examples and describes how IF can be concatenated to produce a document. Because -IF has been through FOPs layout engine, it should be visually consistent with FO -rendered documents while allowing the user to merge numerous documents together. -

-
-
- Final notes -

-These examples should give you an idea of what's possible. It should be easy -to adjust these examples to your needs. Also, if you have other examples that you -think should be added here, please let us know via either the fop-users or fop-dev -mailing lists. Finally, for more help please send your questions to the fop-users -mailing list. -

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/events.xml b/src/documentation/content/xdocs/1.1/events.xml deleted file mode 100644 index 27daad59b..000000000 --- a/src/documentation/content/xdocs/1.1/events.xml +++ /dev/null @@ -1,449 +0,0 @@ - - - - - -
- Apache™ FOP: Events/Processing Feedback - $Revision$ -
- -
- Introduction -

- In versions until 0.20.5, Apache™ FOP used - Avalon-style Logging where - it was possible to supply a logger per processing run. During the redesign - the logging infrastructure was switched over to - Commons Logging which is (like Log4J or - java.util.logging) a "static" logging framework (the logger is accessed through static - variables). This made it very difficult in a multi-threaded system to retrieve information - for a single processing run. -

-

- With FOP's event subsystem, we'd like to close this gap again and even go further. The - first point is to realize that we have two kinds of "logging". Firstly, we have the logging - infrastructure for the (FOP) developer who needs to be able to enable finer log messages - for certain parts of FOP to track down a certain problem. Secondly, we have the user who - would like to be informed about missing images, overflowing lines or substituted fonts. - These messages (or events) are targeted at less technical people and may ideally be - localized (translated). Furthermore, tool and solution builders would like to integrate - FOP into their own solutions. For example, an FO editor should be able to point the user - to the right place where a particular problem occurred while developing a document template. - Finally, some integrators would like to abort processing if a resource (an image or a font) - has not been found, while others would simply continue. The event system allows to - react on these events. -

-

- On this page, we won't discuss logging as such. We will show how the event subsystem can - be used for various tasks. We'll first look at the event subsystem from the consumer side. - Finally, the production of events inside FOP will be discussed (this is mostly interesting - for FOP developers only). -

-
-
- The consumer side -

- The event subsystem is located in the org.apache.fop.events package and its - base is the Event class. An instance is created for each event and is sent - to a set of EventListener instances by the EventBroadcaster. - An Event contains: -

-
    -
  • an event ID,
    • -
  • a source object (which generated the event),
    • -
  • a severity level (Info, Warning, Error and Fatal Error) and
    • -
  • a map of named parameters.
    • -
-

- The EventFormatter class can be used to translate the events into - human-readable, localized messages. -

-

- A full example of what is shown here can be found in the - examples/embedding/java/embedding/events directory in the FOP distribution. - The example can also be accessed - via the web. -

-
- Writing an EventListener -

- The following code sample shows a very simple EventListener. It basically just sends - all events to System.out (stdout) or System.err (stderr) depending on the event severity. -

- -

- You can see that for every event the method processEvent of the - EventListener will be called. Inside this method you can do whatever - processing you would like including throwing a RuntimeException, if you want - to abort the current processing run. -

-

- The code above also shows how you can turn an event into a human-readable, localized - message that can be presented to a user. The EventFormatter class does - this for you. It provides additional methods if you'd like to explicitly specify - the locale. -

-

- It is possible to gather all events for a whole processing run so they can be - evaluated afterwards. However, care should be taken about memory consumption since - the events provide references to objects inside FOP which may themselves have - references to other objects. So holding on to these objects may mean that whole - object trees cannot be released! -

-
-
- Adding an EventListener -

- To register the event listener with FOP, get the EventBroadcaster which - is associated with the user agent (FOUserAgent) and add it there: -

- -

- Please note that this is done separately for each processing run, i.e. for each - new user agent. -

-
-
- An additional listener example -

- Here's an additional example of an event listener: -

-

- By default, FOP continues processing even if an image wasn't found. If you have - more strict requirements and want FOP to stop if an image is not available, you can - do something like the following in the simplest case: -

- -

- Increasing the event severity to FATAL will signal the event broadcaster to throw - an exception and stop further processing. In the above case, all resource-related - events will cause FOP to stop processing. -

-

- You can also customize the exception to throw (you can may throw a RuntimeException - or subclass yourself) and/or which event to respond to: -

- -

- This throws a RuntimeException with the FileNotFoundException - as the cause. Further processing effectively stops in FOP. You can catch the exception - in your code and react as you see necessary. -

-
-
-
- The producer side (for FOP developers) -

- This section is primarily for FOP and FOP plug-in developers. It describes how to use - the event subsystem for producing events. -

- - The event package has been designed in order to be theoretically useful for use cases - outside FOP. If you think this is interesting independently from FOP, please talk to - us. - -
- Producing and sending an event -

- The basics are very simple. Just instantiate an Event object and fill - it with the necessary parameters. Then pass it to the EventBroadcaster - which distributes the events to the interested listeneners. Here's a code example: -

- -

- The Event.paramsBuilder() is a - fluent interface - to help with the build-up of the parameters. You could just as well instantiate a - Map (Map<String, Object>) and fill it with values. -

-
-
- The EventProducer interface -

- To simplify event production, the event subsystem provides the EventProducer - interface. You can create interfaces which extend EventProducer. These - interfaces will contain one method per event to be generated. By contract, each event - method must have as its first parameter a parameter named "source" (Type Object) which - indicates the object that generated the event. After that come an arbitrary number of - parameters of any type as needed by the event. -

-

- The event producer interface does not need to have any implementation. The implementation - is produced at runtime by a dynamic proxy created by DefaultEventBroadcaster. - The dynamic proxy creates Event instances for each method call against - the event producer interface. Each parameter (except "source") is added to the event's - parameter map. -

-

- To simplify the code needed to get an instance of the event producer interface it is - suggested to create a public inner provider class inside the interface. -

-

- Here's an example of such an event producer interface: -

- -

- To produce the same event as in the first example above, you'd use the following code: -

- -
-
- The event model -

- Inside an invocation handler for a dynamic proxy, there's no information about - the names of each parameter. The JVM doesn't provide it. The only thing you know is - the interface and method name. In order to properly fill the Event's - parameter map we need to know the parameter names. These are retrieved from an - event object model. This is found in the org.apache.fop.events.model - package. The data for the object model is retrieved from an XML representation of the - event model that is loaded as a resource. The XML representation is generated using an - Ant task at build time (ant resourcegen). The Ant task (found in - src/codegen/java/org/apache/fop/tools/EventProducerCollectorTask.java) - scans FOP's sources for descendants of the EventProducer interface and - uses QDox to parse these interfaces. -

-

- The event model XML files are generated during build by the Ant task mentioned above when - running the "resourcegen" task. So just run "ant resourcegen" if you receive - a MissingResourceException at runtime indicating that - "event-model.xml" is missing. -

-

- Primarily, the QDox-based collector task records the parameters' names and types. - Furthermore, it extracts additional attributes embedded as Javadoc comments from - the methods. At the moment, the only such attribute is "@event.severity" which indicates - the default event severity (which can be changed by event listeners). The example event - producer above shows the Javadocs for an event method. -

-

- There's one more information that is extracted from the event producer information for - the event model: an optional primary exception. The first exception in the "throws" - declaration of an event method is noted. It is used to throw an exception from - the invocation handler if the event has an event severity of "FATAL" when all - listeners have been called (listeners can update the event severity). Please note - that an implementation of - org.apache.fop.events.EventExceptionManager$ExceptionFactory has to be - registered for the EventExceptionManager to be able to construct the - exception from an event. -

-

- For a given application, there can be multiple event models active at the same time. - In FOP, each renderer is considered to be a plug-in and provides its own specific - event model. The individual event models are provided through an - EventModelFactory. This interface is implemented for each event model - and registered through the service provider mechanism - (see the plug-ins section for details). -

-
-
- Event severity -

- Four different levels of severity for events has been defined: -

-
    -
  1. INFO: informational only
    2. -
  2. WARN: a Warning
    3. -
  3. ERROR: an error condition from which FOP can recover. FOP will continue processing.
    4. -
  4. FATAL: a fatal error which causes an exception in the end and FOP will stop processing.
    5. -
-

- Event listeners can choose to ignore certain events based on their event severity. - Please note that you may recieve an event "twice" in a specific case: if there is - a fatal error an event is generated and sent to the listeners. After that an exception - is thrown with the same information and processing stops. If the fatal event is - shown to the user and the following exception is equally presented to the user it - may appear that the event is duplicated. Of course, the same information is just - published through two different channels. -

-
-
- Plug-ins to the event subsystem -

- The event subsystem is extensible. There are a number of extension points: -

-
    -
  • - org.apache.fop.events.model.EventModelFactory: Provides - an event model to the event subsystem. -
    • -
  • - org.apache.fop.events.EventExceptionManager$ExceptionFactory: - Creates exceptions for events, i.e. turns an event into a specific exception. -
    • -
-

- The names in bold above are used as filenames for the service provider files that - are placed in the META-INF/services directory. That way, they are - automatically detected. This is a mechanism defined by the - JAR file specification. -

-
-
- Localization (L10n) -

- One goal of the event subsystem was to have localized (translated) event messages. - The EventFormatter class can be used to convert an event to a - human-readable message. Each EventProducer can provide its own XML-based - translation file. If there is none, a central translation file is used, called - "EventFormatter.xml" (found in the same directory as the EventFormatter - class). -

-

- The XML format used by the EventFormatter is the same as - Apache Cocoon's catalog format. Here's an example: -

- - - - [ (See position {loc})| (See {#gatherContextInfo})| (No context info available)] - - - RTF output requires that all table-columns for a table are defined. Output will be incorrect.{{locator}} - - - Ignored deferred event for {node} ({start,if,start,end}).{{locator}} - - -]]> -

- The example (extracted from the RTF handler's event producer) has message templates for - two event methods. The class used to do variable replacement in the templates is - org.apache.fop.util.text.AdvancedMessageFormat which is more powerful - than the MessageFormat classes provided by the Java class library - (java.util.text package). -

-

- "locator" is a template that is reused by the other message templates - by referencing it through "{{locator}}". This is some kind of include command. -

-

- Normal event parameters are accessed by name inside single curly braces, for example: - "{node}". For objects, this format just uses the toString() method to turn - the object into a string, unless there is an ObjectFormatter registered - for that type (there's an example for org.xml.sax.Locator). -

-

- The single curly braces pattern supports additional features. For example, it is possible - to do this: "{start,if,start,end}". "if" here is a special field modifier that evaluates - "start" as a boolean and if that is true returns the text right after the second comma - ("start"). Otherwise it returns the text after the third comma ("end"). The "equals" - modifier is similar to "if" but it takes as an additional (comma-separated) parameter - right after the "equals" modifier, a string that is compared to the value of the variable. - An example: {severity,equals,EventSeverity:FATAL,,some text} (this adds "some text" if - the severity is not FATAL). -

-

- Additional such modifiers can be added by implementing the - AdvancedMessageFormat$Part and AdvancedMessageFormat$PartFactory - interfaces. -

-

- Square braces can be used to specify optional template sections. The whole section will - be omitted if any of the variables used within are unavailable. Pipe (|) characters can - be used to specify alternative sub-templates (see "locator" above for an example). -

-

- Developers can also register a function (in the above example: - {#gatherContextInfo}) - to do more complex information rendering. These functions are implementations of the - AdvancedMessageFormat$Function interface. Please take care that this is - done in a locale-independent way as there is no locale information available, yet. -

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/extensions.xml b/src/documentation/content/xdocs/1.1/extensions.xml deleted file mode 100644 index 02d83db96..000000000 --- a/src/documentation/content/xdocs/1.1/extensions.xml +++ /dev/null @@ -1,339 +0,0 @@ - - - - - -
- Standard Apache™ FOP Extensions - $Revision$ -
- -

- By "extension", we mean any data that can be placed in the input XML document that - is not addressed by the XSL-FO standard. - By having a mechanism for supporting extensions, Apache™ FOP is able to add features that - are not covered in the specification. -

-

- The extensions documented here are included with FOP, and are automatically available - to you. If you wish to add an extension of your own to FOP, please see the - Developers' Extension Page. -

- All extensions require the correct use of an appropriate namespace in your input document. -
- SVG -

- Please see the SVG documentation for more details. -

-
-
- FO Extensions -
- Namespace -

- By convention, FO extensions in FOP use the "fox" namespace prefix. - To use any of the FO extensions, add a namespace entry for - http://xmlgraphics.apache.org/fop/extensions to the root element: -

- ]]> -
-
- PDF Bookmarks -

- In old versions of Apache FOP there was a fox:outline element - which was used to create outlines in PDF files. The redesigned code makes use - of the bookmark feature defined in the W3C XSL 1.1 standard. -

-
-
- Anchors or Named Destinations -

Use the fox:destination element to define "named destinations" inside a PDF document. -These are useful as fragment identifiers, e.g. "http://server/document.pdf#anchor-name". -fox:destination elements can be placed almost anywhere in the fo document, including a child of -root, a block-level element, or an inline-level element. -For the destination to actually work, it must correspond to an "id" attribute on some fo element -within the document. In other words, the "id" attribute actually creates the "view" within the -PDF document. The fox:destination simply gives that view an independent name. -

- -... -Table of Contents]]> - It is possible that in some future release of FOP, all elements with -"id" attributes will generate named-destinations, which will eliminate the need for -fox:destination. -
-
- Table Continuation Label -

This extension element hasn't been reimplemented for the redesigned code, yet.

- -
-
- fox:orphan-content-limit and fox:widow-content-limit -

- The two proprietary extension properties, fox:orphan-content-limit and - fox:widow-content-limit, are used to improve the layout of list-blocks and tables. - If you have a table with many entries, you don't want a single row to be left over - on a page. You will want to make sure that at least two or three lines are kept - together. The properties take an absolute length which specifies the area at the - beginning (fox:widow-content-limit) or at the end (fox:orphan-content-limit) of a - table or list-block. The properties are inherited and only have an effect on fo:table - and fo:list-block. An example: fox:widow-content-limit="3 * 1.2em" would make sure - the you'll have at least three lines (assuming line-height="1.2") together on a table - or list-block. -

-
-
- fox:external-document - - This feature is incomplete. Support for multi-page documents will be added shortly. - At the moment, only single-page images will work. And this will not work with RTF output. - -

- This is a proprietary extension element which allows to add whole images as pages to - an FO document. For example, if you have a scanned document or a fax as multi-page TIFF - file, you can append or insert this document using the fox:external-document - element. Each page of the external document will create one full page in the target - format. -

-

- The fox:external-document element is structurally a peer to - fo:page-sequence, so wherever you can put an fo:page-sequence - you could also place a fox:external-document. - Therefore, the specified contents for fo:root change to: -

-

- - (layout-master-set, declarations?, bookmark-tree?, (page-sequence|page-sequence-wrapper|fox:external-document|fox:destination)+) - -

-
- Specification -

- The fox:external-document extension formatting object is used to specify - how to create a (sub-)sequence of pages within a document. The content of these pages - comes from the individual subimages/pages of an image or paged document (for example: - multi-page TIFF in the form of faxes or scanned documents, or PDF files). The - formatting object creates the necessary areas to display one image per page. -

-

- In terms of page numbers, the behaviour is the same as for - fo:page-sequence. The placement of the image inside the page is similar - to that of fo:external-graphic or fo:instream-foreign-object, - i.e. the viewport (and therefore the page size) is defined by either the intrinsic - size of the image or by the size properties that apply to this formatting object. -

-

Content: EMPTY

-

The following properties apply to this formatting object:

-
    -
  • (Common Accessibility Properties) (not implemented, yet)
    • -
  • (Common Aural Properties) (not implemented, yet)
    • -
  • block-progression-dimension
    • -
  • content-height
    • -
  • content-type
    • -
  • content-width
    • -
  • display-align
    • -
  • height
    • -
  • id
    • -
  • inline-progression-dimension
    • -
  • overflow
    • -
  • pages: <page-set> (see below) (not implemented, yet)
    • -
  • reference-orientation
    • -
  • scaling
    • -
  • scaling-method
    • -
  • src
    • -
  • text-align
    • -
  • width
    • -
-

- Datatype "page-set": Value: auto | <integer-range>, - Default: "auto" which means all pages/subimages of the document. - <integer-range> allows values such as "7" or "1-3" -

- - fox:external-document is not suitable for concatenating FO documents. - For this, XInclude is recommended. - -
-
-
- Free-form Transformation for fo:block-container -

- For fo:block-container elements whose absolute-position set to - "absolute" or "fixed" you can use the extension attribute fox:transform - to apply a free-form transformation to the whole block-container. The content of the - fox:transform attribute is the same as for - SVG's transform attribute. - The transformation specified here is performed in addition to other implicit - transformations of the block-container (resulting from top, left and other properties) - and after them. -

-

- Examples: fox:transform="rotate(45)" would rotate the block-container - by 45 degrees clock-wise around its upper-left corner. - fox:transform="translate(10000,0)" would move the block-container to the - right by 10 points (=10000 millipoints, FOP uses millipoints internally!). -

- - This extension attribute doesn't work for all output formats! It's currently only - supported for PDF, PS and Java2D-based renderers. - -
-
- Color functions -

- XSL-FO supports specifying color using the rgb(), rgb-icc() and system-color() functions. - Apache FOP provides additional color functions for special use cases. Please note that - using these functions compromises the interoperability of an FO document. -

-
- cmyk() -

color cmyk(numeric, numeric, numeric, numeric)

-

- This function will construct a color in device-specific CMYK color space. The numbers - must be between 0.0 and 1.0. For output formats that don't support device-specific - color space the CMYK value is converted to an sRGB value. -

-
-
- #CMYK pseudo-profile -

color rgb-icc(numeric, numeric, numeric, #CMYK, numeric, numeric, numeric, numeric)

-

- The rgb-icc function will respond to a pseudo-profile called "#CMYK" - which indicates a device-specific CMYK color space. The "#CMYK" profile is implicitely - available and doesn't have to be (and cannot be) defined through an - fo:color-profile element. It is provided for compatibility with certain - commercial XSL-FO implementations. Please note that this is not part of the official - specification but rather a convention. The following two color specifications are - equivalent: -

-
    -
  • cmyk(0%,0%,20%,40%)
    • -
  • rgb-icc(153, 153, 102, #CMYK, 0, 0, 0.2, 0.4)
    • -
-
-
-
- Prepress Support - -

- This section defines a number of extensions related to - prepress support. - fox:scale defines a general scale factor for the generated pages. - fox:bleed defines the - bleed area for a page. - fox:crop-offset defines the outer edges of the area in which crop marks, - registration marks, color bars and page information are placed. - For details, please read on below. -

- - Those extensions have been implemented in the PDF and Java2D renderers only. - - -
- fox:scale -

Value: <number>{1,2}

-

Initial: 1

-

Applies to: fo:simple-page-master

-

- This property specifies a scale factor along resp. the x and y axes. If only one number - is provided it is used for both the x and y scales. A scale factor smaller than 1 - shrinks the page. A scale factor greater than 1 enlarges the page. -

-
-
- fox:bleed -

- Value: <length>{1,4} -

-

- Initial: 0pt -

-

Applies to: fo:simple-page-master

-

- If there is only one value, it applies to all sides. If there are two values, the top and bottom - bleed widths are set to the first value and the right and left bleed widths are set to the second. - If there are three values, the top is set to the first value, the left and right are set to the second, - and the bottom is set to the third. If there are four values, they apply to the top, right, bottom, and - left, respectively. - (Corresponds to the definition of - padding). -

-

- This extension indirectly defines the BleedBox and is calculated by expanding the TrimBox by - the bleed widths. The lengths must be non-negative. -

-
-
- fox:crop-offset -

- Value: <length>{1,4} -

-

- Initial: bleed (see below) -

-

Applies to: fo:simple-page-master

-

- Same behaviour as with fox:bleed. The initial value is set to the same values as the - fox:bleed property. -

-

- This extension indirectly defines the MediaBox and is calculated by expanding - the TrimBox by the crop offsets. The lengths must be non-negative. -

-
-
- fox:crop-box -

- Value: [trim-box | bleed-box | media-box] -

-

- Initial: media-box -

-

Applies to: fo:simple-page-master

-

- The crop box controls how Acrobat displays the page (CropBox in PDF) or how the Java2DRenderer sizes - the output media. The PDF specification defines that the CropBox defaults to the MediaBox. This extension - follows that definition. To simplify usage and cover most use cases, the three supported enumeration - values "trim-box", "bleed-box" and "media-box" set the CropBox to one of those three other boxes. -

-

- If requested in the future, we could offer to specify the CropBox in absolute coordinates rather - than just by referencing another box. -

-
-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/fonts.xml b/src/documentation/content/xdocs/1.1/fonts.xml deleted file mode 100644 index f3481607d..000000000 --- a/src/documentation/content/xdocs/1.1/fonts.xml +++ /dev/null @@ -1,579 +0,0 @@ - - - - - -
- Apache™ FOP: Fonts - $Revision$ - - - - - - -
- -
- Summary -

The following table summarizes the font capabilities of the various Apache� FOP renderers:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
RendererBase-14AWT/OSCustomCustom Embedding
PDFyesnoyesyes
PostScriptyesnoyesyes
PCLyes (modified)yes (painted as bitmaps)yes (painted as bitmaps)no
AFPnonoyesyes
Java2D/AWT/Bitmapif available from OSyesyesn/a (display only)
Printif available from OSyesyescontrolled by OS printer driver
RTFn/a (font metrics not needed)n/an/an/a
TXTyes (used for layout but not for output)noyes (used for layout but not for output)no
XMLyesnoyesn/a
-
-
- Base-14 Fonts -

- The Adobe PostScript and PDF Specification specify a set of 14 fonts that must be - available to every PostScript interpreter and PDF reader: - Helvetica (normal, bold, italic, bold italic), - Times (normal, bold, italic, bold italic), - Courier (normal, bold, italic, bold italic), - Symbol and ZapfDingbats. -

-

- The following font family names are hard-coded into FOP for the Base-14 font set: -

- - - - - - - - - - - - - - - - - - - - - - - - - -
Base-14 fontfont families
HelveticaHelvetica, sans-serif, SansSerif
TimesTimes, Times Roman, Times-Roman, serif, any
CourierCourier, monospace, Monospaced
SymbolSymbol
ZapfDingbatsZapfDingbats
-

- Please note that recent versions of Adobe Acrobat Reader replace - "Helvetica" with "Arial" and "Times" with "Times New Roman" internally. - GhostScript replaces "Helvetica" with "Nimbus Sans L" and "Times" with - "Nimbus Roman No9 L". Other document viewers may do similar font - substitutions. If you need to make sure that there are no such - substitutions, you need to specify an explicit font and embed it in - the target document. -

-
-
- Missing Fonts -

- When FOP does not have a specific font at its disposal (because it's - not installed in the operating system or set up in FOP's configuration), - the font is replaced with "any". "any" is internally mapped to the - Base-14 font "Times" (see above). -

-
-
- Missing Glyphs -

- Every font contains a particular set of - glyphs. If no glyph can be found for - a given character, FOP will issue a warning and use the glpyh for "#" (if available) - instead. Before it does that, it consults a (currently hard-coded) registry of - glyph substitution groups (see Glyphs.java in Apache XML Graphics Commons). - This registry can supply alternative glyphs in some cases (like using space when a no-break - space is requested). But there's no guarantee that the result will be as expected (for - example, in the case of hyphens and similar glyphs). A better way is to use a font that - has all the necessary glyphs. This glyph substitution is only a last resort. -

-
-
- Java2D/AWT/Operating System Fonts -

- The Java2D family of renderers (Java2D, AWT, Print, TIFF, PNG), use the - Java AWT subsystem for font metric information. Through operating system - registration, the AWT subsystem knows what fonts are available on the system, - and the font metrics for each one. -

-

- When working with one of these output formats and you're missing a font, just - install it in your operating system and they should be available for these - renderers. Please note that this is not true for other output formats such as - PDF or PostScript. -

-
-
- Custom Fonts -

- Support for custom fonts is highly output format dependent (see above table). - This section shows how to add Type 1 and TrueType fonts to the PDF, PostScript and - Java2D-based renderers. Other renderers (like AFP) support other font formats. Details - in this case can be found on the page about output formats. -

-

- In earlier FOP versions, it was always necessary to create an XML font metrics file - if you wanted to add a custom font. This unconvenient step has been removed and in - addition to that, FOP supports auto-registration of fonts, i.e. FOP can find fonts - installed in your operating system or can scan user-specified directories for fonts. - Font registration via XML font metrics file is still supported and may still be necessary - for some very special cases as fallback variant while we stabilize font auto-detection. -

-

- Basic information about fonts can be found at: -

- -
-
- Basic font configuration -

- If you want FOP to use custom fonts, you need to tell it where to find them. This - is done in the configuration file and once per renderer (because each output format - is a little different). In the basic form, you can either tell FOP to find your - operating system fonts or you can specify directories that it will search for - support fonts. These fonts will then automatically be registered. -

- - - - - C:\MyFonts1 - - - C:\MyFonts2 - - - - - -]]> - - Review the documentation for FOP Configuration - for instructions on making the FOP configuration available to FOP when it runs. - Otherwise, FOP has no way of finding your custom font information. It is currently - not possible to easily configure fonts from Java code. - -
-
- Advanced font configuration -

- The instructions found above should be sufficient for most users. Below are some - additional instructions in case the basic font configuration doesn't lead to - the desired results. -

-
- Type 1 Font Metrics -

FOP includes PFMReader, which reads the PFM file that normally comes with a Type 1 font, and generates an appropriate font metrics file for it. - To use it, run the class org.apache.fop.fonts.apps.PFMReader:

-

Windows:

- java -cp build\fop.jar;lib\avalon-framework.jar;lib\commons-logging.jar;lib\commons-io.jar - org.apache.fop.fonts.apps.PFMReader [options] pfm-file xml-file -

Unix:

- java -cp build/fop.jar:lib/avalon-framework.jar:lib/commons-logging.jar:lib/commons-io.jar - org.apache.fop.fonts.apps.PFMReader [options] pfm-file xml-file -

PFMReader [options]:

-
    -
  • -fn <fontname> By default, FOP uses the fontname from the - .pfm file when embedding the font. Use the "-fn" option to override this name with one you have - chosen. This may be useful in some cases to ensure that applications using the output document - (Acrobat Reader for example) use the embedded font instead of a local font with the same - name.
    • -
- The classpath in the above example has been simplified for readability. - You will have to adjust the classpath to the names of the actual JAR files in the lib directory. - xml-apis.jar, xercesImpl.jar, xalan.jar and serializer.jar are not necessary for JDK version 1.4 or later. - The tool will construct some values (FontBBox, StemV and ItalicAngle) based on assumptions and calculations which are only an approximation to the real values. - FontBBox and Italic Angle can be found in the human-readable part of the PFB file or in the AFM file. - The PFMReader tool does not yet interpret PFB or AFM files, so if you want to be correct, you may have to adjust the values in the XML file manually. - The constructed values however appear to have no visible influence. -
-
- TrueType Font Metrics -

FOP includes TTFReader, which reads the TTF file and generates an appropriate font metrics file for it. - Use it in a similar manner to PFMReader. - For example, to create such a metrics file in Windows from the TrueType font at c:\myfonts\cmr10.ttf:

- java -cp build\fop.jar;lib\avalon-framework.jar;lib\commons-logging.jar;lib\commons-io.jar - org.apache.fop.fonts.apps.TTFReader [options] - C:\myfonts\cmr10.ttf ttfcm.xml -

TTFReader [options]:

-
    -
  • -d <DEBUG | INFO > Sets the debug level (default is - INFO).
    • -
  • -fn <fontname> Same as for PFMReader.
    • -
  • -ttcname <fontname> If you're reading data from a - TrueType Collection (.ttc file) you must specify which font from the collection you will read - metrics from. - If you read from a .ttc file without this option, the fontnames will be listed for you.
    • -
  • -enc ansi Creates a WinAnsi-encoded font metrics file. - Without this option, a CID-keyed font metrics file is created. - The table below summarizes the differences between these two encoding options as currently - used within FOP. - Please note that this information only applies to TrueType fonts and TrueType collections:
    • -
- - - - - - - - - - - - - - - - -
IssueWinAnsiCID-keyed
Usable Character SetLimited to WinAnsi character set, which is roughly equivalent to iso-8889-1.Limited only by the characters in the font itself.
Embedding the FontOptional.Mandatory. Not embedding the font produces invalid PDF documents.
- - You may experience failures with certain TrueType fonts, especially if they don't contain - the so-called Unicode "cmap" table. TTFReader can currently not deal with font like this. - -
-
- TrueType Collections -

TrueType collections (.ttc files) contain more than one font. - To create metrics files for these fonts, you must specify which font in the collection should be generated, by using the "-ttcname" option with the TTFReader.

-

To get a list of the fonts in a collection, just start the TTFReader as if it were a normal TrueType file (without the -ttcname option). - It will display all of the font names and exit with an Exception.

-

Here is an example of generating a metrics file for a .ttc file:

- java -cp build\fop.jar;lib\avalon-framework.jar;lib\commons-logging.jar;lib\commons-io.jar - org.apache.fop.fonts.apps.TTFReader -ttcname "MS Mincho" - msmincho.ttc msminch.xml -

- Alternatively, the individual sub-fonts of a TrueType Collections can be selected - using the "sub-font" attribute on the "font" element. That means that generating - an XML font metrics file for TrueType collections is not necessary anymore. Example: -

- - -]]> -
-
- Register Fonts with FOP -

You must tell FOP how to find and use the font metrics files by registering them in the FOP Configuration. Add entries for your custom fonts, regardless of font type, to the configuration file in a manner similar to the following:

- - - - - - - - - - C:\MyFonts1 - - - C:\MyFonts2 - - - - - -]]> -
    -
  • - URLs are used to access the font metric and font files. - Relative URLs are resolved relative to the font-base property (or base) if available. - See FOP: Configuration for more information. -
    • -
  • The "metrics-url" attribute is generally not necessary except if you run into problems with certain fonts.
    • -
  • Either an "embed-url" or a "metrics-url" must be specified for font tag configurations.
    • -
  • The font "kerning" attribute is optional. Default is "true".
    • -
  • If embedding is off (i.e. embed-url is not set), the output will position the text correctly (from the metrics file), but it will not be displayed or printed correctly unless the viewer has the applicable font available to their local system.
    • -
  • When setting the "embed-url" attribute for Type 1 fonts, be sure to specify the PFB (actual font data), not PFM (font metrics) file that you used to generate the XML font metrics file.
    • -
  • The attribute "encoding-mode" is optional an may have the following values: -
      -
    • auto: default font encoding mode ("cid" for Truetype, "single-byte" for Type 1)
      • -
    • single-byte: use single-byte encodings in the target format (if applicable)
      • -
    • cid: encode as CID-keyed font (currently only supported for PDF output with TrueType fonts)
      • -
    -
    • -
  • The fonts "directory" tag can be used to register fonts contained within a single or list of directory paths. The "recursive" attribute can be specified to recursively add fonts from all sub directories.
    • -
  • The fonts "auto-detect" tag can be used to automatically register fonts that are found to be installed on the native operating system.
    • -
  • Fonts registered with "font" tag configurations override fonts found by means of "directory" tag definitions.
    • -
  • Fonts found as a result of a "directory" tag configuration override fonts found as a result of the "auto-detect" tag being specified.
    • -
  • - If relative URLs are specified, they are evaluated relative to the value of the - "font-base" setting. If there is no "font-base" setting, the fonts are evaluated - relative to the base directory. -
    • -
- -
-
- Auto-Detect and auto-embed feature -

When the "auto-detect" flag is set in the configuration, FOP will automatically search for fonts in the default paths for your operating system.

-

FOP will also auto-detect fonts which are available in the classpath, if they are described as "application/x-font" in the MANIFEST.MF file. For example, if your .jar file contains font/myfont.ttf:

- Manifest-Version: 1.0 - - Name: font/myfont.ttf - Content-Type: application/x-font -

This feature allows you to create JAR files containing fonts. The JAR files can be added to fop by providem them in the classpath, e.g. copying them into the lib/ directory.

-
- The font cache -

- Apache FOP maintains a cache file that is used to speed up auto-detection. This file - is usually found in the ".fop" directory under the user's home directory. It's called - "fop-fonts.cache". When the user's home directory is not writable, the font cache file - is put in the directory for temporary files. -

-

- If there was a problem loading a particular font, it is flagged in the cache file so - it is not loaded anymore. So, if a font is actually around but is still not found - by Apache FOP, it's worth a try to delete the font cache file which forces Apache FOP - to reparse all fonts. -

-
-
-
- Embedding -

- By default, all fonts are embedded if an output format supports font embedding. In some - cases, however, it is preferred that some fonts are only referenced. When working - with referenced fonts it is important to be in control of the target environment where - the produced document is consumed, i.e. the necessary fonts have to be installed there. -

-

- There are two different ways how you can specify that a font should be referenced: -

-
    -
  1. - When using the old-style "font" element to configure a single font, font referencing - is controlled by the embed-url attribute. If you don't specify the embed-url attribute - the font will not be embedded, but will only be referenced. -
    2. -
  2. - For automatically configured fonts there's a different mechanism to specify which - fonts should be referenced rather than embedded. This is done in the "referenced-fonts" - element in the configuration. Here's an example: -
    3. -
- - - - - - - -]]> -

- At the moment, you can only match fonts against their font-family. It is possible to use - regular expressions as is shown in the second example above ("DejaVu.*"). The syntax for - the regular expressions used here are the one used by the - java.util.regex package. - So, in the above snippet "Helvetica" and all variants of the "DejaVu" font family are - referenced. If you want to reference all fonts, just specify font-family=".*". -

-

- The referenced-fonts element can be placed either inside the general - fonts element (right under the root) or in the fonts element - under the renderer configuration. In the first case, matches apply to all renderers. - In the second case, matches only apply to the renderer where the element was specified. - Both cases can be used at the same time. -

-

- Various notes related to embedded fonts: -

-
    -
  • The PostScript renderer does not yet support TrueType fonts, but can embed Type 1 fonts.
    • -
  • The font is simply embedded into the PDF file, it is not converted.
    • -
  • When FOP embeds a font, it adds a prefix to the fontname to ensure that the name will not match the fontname of an installed font. - This is helpful with older versions of Acrobat Reader that preferred installed fonts over embedded fonts.
    • -
  • When embedding PostScript fonts, the entire font is always embedded.
    • -
  • When embedding TrueType fonts (ttf) or TrueType Collections (ttc), a subset of the - original font, containing only the glyphs used, is embedded in the output document. - That's the default, but if you specify encoding-mode="single-byte" (see above), the - complete font is embedded.
    • -
-
-
- Substitution -

When a <substitutions/> section is defined in the configuration, FOP will re-map any font-family references found in your FO input to a given substitution font.

-
    -
  • If a <substitution/> is declared, it is mandatory that both a <from/> and <to/> child element is declared with a font-family attribute.
    • -
  • Both font-weight and font-style are optional attributes, if they are provided then a value of 'normal' is assumed.
    • -
-

For example you could make all FO font-family references to 'Arial' with weights between 700 and 900 reference the normal 'Arial Black' font.

- - - - - - - - - - - - - -]]> -
- -
-
- Font Selection Strategies -

- There are two font selection strategies: character-by-character or auto. The default is auto.

-

Auto selected the first font from the list which is able to display the most characters in a given word. This means (assume font A has characters for abclmn, font B for lnmxyz, fontlist is A,B):

-
    -
  • aaa lll xxx would be displayed in fonts A A B
    • -
  • aaaxx would be displayed in font A
    • -
  • aaaxxx would be displayed in font A
    • -
  • aaaxxxx would be displayed in font B
    • -
-

Character-by-Character is NOT yet supported!

-
-
- Font List Command-Line Tool -

- FOP contains a small command-line tool that lets you generate a list of all configured - fonts. Its class name is: org.apache.fop.tools.fontlist.FontListMain. - Run it with the "-?" parameter to get help for the various options. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/fotree/disabled-testcases.xml b/src/documentation/content/xdocs/1.1/fotree/disabled-testcases.xml deleted file mode 100644 index 196eafcc4..000000000 --- a/src/documentation/content/xdocs/1.1/fotree/disabled-testcases.xml +++ /dev/null @@ -1,31 +0,0 @@ - - - - - - demo test failure - demo-test-failure.fo - - - - Markers and core function evaluation - from-table-column_marker.fo - The code currently evaluates this function according to the column in which the - marker appears in the source document, rather than the column it is retrieved in. - - diff --git a/src/documentation/content/xdocs/1.1/graphics.xml b/src/documentation/content/xdocs/1.1/graphics.xml deleted file mode 100644 index b1653443a..000000000 --- a/src/documentation/content/xdocs/1.1/graphics.xml +++ /dev/null @@ -1,590 +0,0 @@ - - - - - -
- Apache™ FOP: Graphics Formats - $Revision$ -
- -
- Introduction -

- Some noteworthy features of the image handling subsystem are: -

-
    -
  • - The image libraries Jimi and JAI are not supported. Instead, Apache™ FOP uses the - Image I/O API that was introduced with Java 1.4 for all bitmap codecs. -
    • -
  • - Some bitmap images are not converted to a standardized 24 bit RGB image but are - instead handled in their native format. -
    • -
  • - A plug-in mechanism offers a possibility to add support for new formats without changing - the FOP's source code. -
    • -
-

- The actual image loading framework - does not reside in Apache FOP, but in - XML Graphics Commons. -

-
-
- Overview of Graphics Support -

- The table below summarizes the theoretical support for graphical formats - within FOP. In other words, within the constraints of the limitations listed here, - these formats should work. However, many of them have not been tested, - and there may be limitations that have not yet been discovered or documented. - The packages needed to support some formats are not included in the FOP distribution - and must be installed separately. Follow the links in the "Support Through" columns - for more details. -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FormatTypeSupport Through
Apache FOP (native)Apache BatikImage I/O
BMP (Microsoft Windows Bitmap)bitmap - - X [1]
EMF (Windows Enhanced Metafile)vector (with embedded bitmaps)(X) - -
EPS (Encapsulated PostScript)metafile (both bitmap and vector), most frequently used for vector drawings(X) - -
GIF (Graphics Interchange Format)bitmap - - X
JPEG (Joint Photographic Experts Group)bitmap(X) - X
PNG (Portable Network Graphic)bitmap - - X
SVG (Scalable Vector Graphics)vector (with embedded bitmaps) - X -
TIFF (Tag Image Format File)bitmap(X) - X [1]
WMF (Windows Metafile)vector (with embedded bitmaps) - (X) -
-

- Legend: -

-
    -
  • "(X)" means restricted support. Please see the details below.
    • -
  • - [1]: Requires the presence of JAI Image I/O Tools - (or an equivalent Image I/O compatible codec) in the classpath. JAI Image I/O Tools also - adds support for JPEG 2000, WBMP, RAW and PNM. Other Image I/O codecs may provide - support for additional formats. -
    • -
- - JAI Image I/O Tools is not the same as the - JAI library! The - former simply exposes JAI's codecs using the Image&nbsp;I/O API but does not include all - the image manipulation functionality. - -
- Map of supported image formats by output format -

- Not all image formats are supported for all output formats! For example, while you can - use EPS (Encapsulated PostScript) files when you generate PostScript output, this format - will not be supported by any other output format. Here's an overview of which image - formats are supported by which output format: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Image FormatPDFPostScriptJava2D, PNG, TIFF, AWTPCLAFPRTF
BMP (Microsoft Windows Bitmap)XXXXXX
EMF (Windows Enhanced Metafile) - - - - - X [1]
EPS (Encapsulated PostScript) - X [1] - - - -
GIF (Graphics Interchange Format)XXXXXX
JPEG (Joint Photographic Experts Group)X [1]X [1]XXX [1]X
PNG (Portable Network Graphic)XXXXXX
SVG (Scalable Vector Graphics)XXXXXX
TIFF (Tag Image Format File)X [2]X [2]XXX [2]X
WMF (Windows Metafile)XXXXXX
-

- Legend: -

-
    -
  • - [1]: Supported without the need to decode the image. -
    • -
  • - [2]: Supported without the need to decode the image, but only for certain subtypes. -
    • -
-
-
-
- Graphics Packages -
- XML Graphics Commons Native -

- XML Graphics Commons supports a number - of graphic file formats natively as basic functionality: all bitmap formats for which - there are Image I/O codecs available (JPEG, PNG, GIF, TIFF, etc.), EPS and EMF. -

-
-
- FOP Native -

- FOP has no native image plug-ins for the image loading framework of its own but currently - hosts the Batik-dependent SVG and WMF plug-ins until they can be moved to - Apache Batik. -

-
-
- Apache Batik -

- Apache Batik will later receive the - SVG and WMF plug-ins for the image loading framework that are currently hosted inside - FOP. -

-

- Current FOP distributions include a distribution of the - Apache Batik. - Because Batik's API changes frequently, it is highly recommended that you use the - version that ships with FOP, at least when running FOP. -

- Batik must be run in a graphical environment. -

- Batik must be run in a graphical environment. - It uses AWT classes for rendering SVG, which in turn require an X server on Unixish - systems. If you run a server without X, or if you can't connect to the X server due to - security restrictions or policies (a so-called "headless" environment), SVG rendering - will fail. -

-

Here are some workarounds:

-
    -
  • - Start Java with the -Djava.awt.headless=true command line option. -
    • -
  • - Install an X server which provides an in-memory framebuffer without actually using a - screen device or any display hardware. One example is Xvfb. -
    • -
  • - Install a toolkit which emulates AWT without the need for an underlying X server. One - example is the PJA toolkit, which is free - and comes with detailed installation instructions. -
    • -
-
-
- Image I/O -

- The image loading framework in XML Graphics Commons - provides a wrapper to load images through the - JDK's Image I/O API (JSR 015). - Image I/O allows to dynamically add additional image codecs. An example of such an - add-on library are the - JAI Image I/O Tools - available from Sun. -

-
-
-
- Details on image formats -
- BMP -

- BMP images are supported through an Image I/O codec. There may be limitations of the - codec which are outside the control of Apache FOP. -

-
-
- EMF -

- Windows Enhanced Metafiles (EMF) are only supported in RTF output where they are - embedded without decoding. -

-
-
- EPS -

Apache FOP allows to use EPS files when generating PostScript output only.

-

- Other output targets can't be supported at the moment because - FOP lacks a PostScript interpreter. Furthermore, FOP is currently not able - to parse the preview bitmaps sometimes contained in EPS files. -

-
-
- GIF -

- GIF images are supported through an Image&nbsp;I/O codec. Transparency is supported but - not guaranteed to work with every output format. -

-
-
- JPEG -

- FOP native support (i.e. the handling of undecoded images) of JPEG does not include all - variants, especially those containing unusual color lookup tables and color profiles. - If you have trouble with a JPEG image in FOP, try opening it with an image processing - program (such as Photoshop or Gimp) and then saving it. Specifying 24-bit color output - may also help. For the PDF and PostScript renderers most JPEG images can be passed - through without decompression. User reports indicate that grayscale, RGB, and - CMYK color spaces are all rendered properly. However, for other output formats, the - JPEG images have to be decompressed. Tests have shown that there are some limitation - in some Image&nbsp;I/O codecs concerning images in the CMYK color space. Work-arounds are - in place but may not always work as expected. -

-
-
- PNG -

- PNG images are supported through an Image&nbsp;I/O codec. Transparency is supported but - not guaranteed to work with every output format. -

-
-
- SVG -
- Introduction -

FOP uses Apache Batik for SVG support. - This format can be handled as an fo:instream-foreign-object or in a separate - file referenced with fo:external-graphic.

- - Batik's SVG Rasterizer utility may also be used to convert standalone SVG - documents into PDF. For more information please see the - SVG Rasterizer documentation - on the Batik site. - -
-
- Placing SVG Graphics into PDF -

- The SVG is rendered into PDF by using PDF commands to draw and fill - lines and curves. This means that the graphical objects created with - this remain as vector graphics. The same applies to PostScript output. - For other output formats the SVG graphic may be converted to a bitmap - image. -

-

- There are a number of SVG things that cannot be converted directly into - PDF. Parts of the graphic such as effects, patterns and images are inserted - into the PDF as a raster graphic. The resolution of these raster images can - be controlled through the "target resolution" setting in the - configuration.

-

- Currently transparency is limited in PDF so some SVG images that - contain effects or graphics with transparent areas may not be displayed - correctly. -

-
-
- Placing SVG Text into PDF and PostScript -

If possible, Batik will use normal PDF or PostScript text when inserting text. It does - this by checking if the text can be drawn normally and the font is - supported. This example svg text.svg / - text.pdf / text.png - shows how various types and effects with text are handled. - Note that SVG font support is not yet implemented. Furthermore, text handling in - PostScript output is inferior to PDF output - more text will be painted as shapes in - PS than in PDF. -

-

- When there's no support to paint text using native text operations, - text is converted and drawn as a set of shapes by Batik, using the - stroking text painter. This means that a typical character will - have about 10 curves (each curve consists of at least 20 characters). - This can make the output files large and when it is viewed the - viewer may not normally draw those fine curves very well (In Adobe Acrobat, turning on - "Smooth Line Art" in the preferences will fix this). Copy/paste functionality - will not be supported in this case. - If the text is inserted into the output file using the inbuilt text commands - it will use a single character. -

-

- Note that because SVG text can be rendered as either text or a vector graphic, you - may need to consider settings in your viewer for both. The Acrobat viewer has both - "smooth line art" and "smooth text" settings that may need to be set for SVG images - to be displayed nicely on your screen (see Edit / Preferences / Display). - This setting will not affect the printing of your document, which should be OK in - any case, but will only affect the quality of the screen display. -

-
-
- Font selection notes -

- Apache Batik uses the AWT/Java2D subsystem as font source while FOP has its own font - subsystem. Great care has been taken that font selection does the best possible choices. - But it must be noted when creating PDF or PostScript that a font used in SVG graphics - needs to be registered with the operating system as well as in FOP's configuration. - By using FOP's font auto-detection, you simply have to install the font in the operating - system and not care about anything else. This is less of an issue if you create - formats like TIFFs, PNGs or PCL because in these cases SVG graphics are usually rendered - to bitmaps which means that on both sides (Batik and FOP), AWT/Java2D is used as the - single font source. -

-

- Whenever an SVG is converted into a PDF or PostScript file, the font that has been used - inside Batik has to be mapped to a font used by the actual output format. Features like - font substitution in FOP may need to be taken into account but can also be an advantage - when working around font mapping issues. Like for XSL-FO content, you'll get a warning - if a particular font could not be found and had to be substituted, or if a particular - glyph is missing in a font. -

-
-
- Scaling -

- Currently, SVG images are rendered with the dimensions specified in the SVG - file, within the viewport specified in the fo:external-graphic element. - For everything to work properly, the two should be equal. The SVG standard leaves - this issue as an implementation detail. Additional scaling options are available - through XSL-FO means. -

-

- If you use pixels to specify the size of an SVG graphic the "source resolution" setting - in the configuration will be used to determine the - size of a pixel. The use of pixels to specify sizes is discouraged as they may - be interpreted differently in different environments. -

-
-
- Known Problems -
    -
  • - Soft mask transparency is combined with white so that it looks better - on PDF 1.3 viewers but this causes the soft mask to be slightly lighter - or darker on PDF 1.4 viewers. -
    • -
  • - There is some problem with a gradient inside a pattern which may cause a PDF - error when viewed in Acrobat 5. -
    • -
  • - Text is not always handled correctly, it may select the wrong font - especially if characters have multiple fonts in the font list. -
    • -
  • - Uniform transparency for images and other SVG elements that are converted - into a raster graphic are not drawn properly in PDF. The image is opaque. -
    • -
-
-
-
- TIFF -

- FOP can embed TIFF images without decompression into PDF, PostScript and AFP if they - have either CCITT T.4, CCITT T.6, or JPEG compression. Otherwise, a TIFF-capable - Image&nbsp;I/O codec is necessary for decoding the image. -

-

- There may be some limitation concerning images in the CMYK color space. -

-
-
- WMF -

- Windows Metafiles (WMF) are supported through classes in - Apache Batik. At the moment, support - for this format is experimental and may not always work as expected. -

-
-
-
- Graphics Resolution -

- Some bitmapped image file formats store a dots-per-inch (dpi) or other resolution - values. FOP tries to use this resolution information whenever possible to determine - the image's intrinsic size. This size is used during the layout process when it is not - superseded by an explicit size on fo:external-graphic (content-width and content-height - properties). -

-

- Please note that not all images contain resolution information. If it's not available - the source resolution set on the FopFactory (or through the user configuration XML) is used. - The default here is 72 dpi. -

-

- Bitmap images are generally embedded into the output format at their original resolution - (as is). No resampling of the image is performed. Explicit resampling is on our wishlist, - but hasn't been implemented, yet. Bitmaps included in SVG graphics may be resampled to - the resolution specified in the "target resolution" setting in the - configuration if SVG filters are applied. This can be - used as a work-around to resample images in FO documents. -

-
-
- Page selection for multi-page formats -

- Some image formats such as TIFF support multiple pages/sub-images per file. You can - select a particular page using a special URI fragment in the form: - <uri>#page=<nr> - (for example: http://localhost/images/myimage.tiff#page=3) -

-
-
- Image caching -

- FOP caches images between runs. There is one cache per FopFactory instance. The URI is - used as a key to identify images which means that when a particular URI appears again, - the image is taken from the cache. If you have a servlet that generates a different - image each time it is called with the same URI you need to use a constantly - changing dummy parameter on the URI to avoid caching. -

-

- The image cache has been improved considerably in the redesigned code. Therefore, - resetting the image cache should be a thing of the past. If you - still experience OutOfMemoryErrors, please notify us. -

-

- If all else fails, the image cache can be cleared like this: - fopFactory.getImageManager().getCache().clearCache(); -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/hyphenation.xml b/src/documentation/content/xdocs/1.1/hyphenation.xml deleted file mode 100644 index e6f666826..000000000 --- a/src/documentation/content/xdocs/1.1/hyphenation.xml +++ /dev/null @@ -1,237 +0,0 @@ - - - - - -
- Apache™ FOP: Hyphenation - $Revision$ -
- -
- Hyphenation Support -
- Introduction -

Apache™ FOP uses Liang's hyphenation algorithm, well known from TeX. It needs - language specific pattern and other data for operation.

-

Because of licensing issues (and for - convenience), all hyphenation patterns for FOP are made available through - the Objects For - Formatting Objects project.

- If you have made improvements to an existing Apache™ FOP hyphenation pattern, - or if you have created one from scratch, please consider contributing these - to OFFO so that they can benefit other FOP users as well. - Please inquire on the FOP User - mailing list. -
-
- License Issues -

Many of the hyphenation files distributed with TeX and its offspring are - licenced under the LaTeX - Project Public License (LPPL), which prevents them from being - distributed with Apache software. The LPPL puts restrictions on file names - in redistributed derived works which we feel can't guarantee. Some - hyphenation pattern files have other or additional restrictions, for - example against use for commercial purposes.

-

Although Apache FOP cannot redistribute hyphenation pattern files that do - not conform with its license scheme, that does not necessarily prevent users - from using such hyphenation patterns with FOP. However, it does place on - the user the responsibility for determining whether the user can rightly use - such hyphenation patterns under the hyphenation pattern license.

- The user is responsible to settle license issues for hyphenation - pattern files that are obtained from non-Apache sources. -
-
- Sources of Custom Hyphenation Pattern Files -

The most important source of hyphenation pattern files is the - CTAN TeX - Archive.

-
-
- Installing Custom Hyphenation Patterns -

To install a custom hyphenation pattern for use with FOP:

-
    -
  1. Convert the TeX hyphenation pattern file to the FOP format. The FOP - format is an xml file conforming to the DTD found at - {fop-dir}/hyph/hyphenation.dtd.
    2. -
  2. Name this new file following this schema: - languageCode_countryCode.xml. The country code is - optional, and should be used only if needed. For example: -
      -
    • en_US.xml would be the file name for American - English hyphenation patterns.
      • -
    • it.xml would be the file name for Italian - hyphenation patterns.
      • -
    - The language and country codes must match the XSL-FO input, which - follows ISO - 639 (languages) and ISO - 3166 (countries). NOTE: The ISO 639/ISO 3166 convention is that - language names are written in lower case, while country codes are written - in upper case. FOP does not check whether the language and country specified - in the FO source are actually from the current standard, but it relies - on it being two letter strings in a few places. So you can make up your - own codes for custom hyphenation patterns, but they should be two - letter strings too (patches for proper handling extensions are welcome)
    3. -
  3. There are basically three ways to make the FOP-compatible hyphenation pattern - file(s) accessible to FOP: -
      -
    • Download the precompiled JAR from OFFO - and place it either in the {fop-dir}/lib directory, or - in a directory of your choice (and append the full path to the JAR to - the environment variable FOP_HYPHENATION_PATH).
      • -
    • Download the desired FOP-compatible hyphenation pattern file(s) from - OFFO, - and/or take your self created hyphenation pattern file(s), -
        -
      • place them in the directory {fop-dir}/hyph,
        • -
      • or place them in a directory of your choice and set the Ant variable - user.hyph.dir to point to that directory (in - build-local.properties),
        • -
      - and run Ant with build target - jar-hyphenation. This will create a JAR containing the - compiled patterns in {fop-dir}/build that will be added to the - classpath on the next run. - (When FOP is built from scratch, and there are pattern source file(s) - present in the directory pointed to by the - user.hyph.dir variable, this JAR will automatically - be created from the supplied pattern(s)).
      • -
    • Put the pattern source file(s) into a directory of your choice and - configure FOP to look for custom patterns in this directory, by setting the - <hyphenation-base> - configuration option.
      • -
    -
    4. -
- - Either of these three options will ensure hyphenation is working when using - FOP from the command-line. If FOP is being embedded, remember to add the location(s) - of the hyphenation JAR(s) to the CLASSPATH (option 1 and 2) or to set the - <hyphenation-dir> - configuration option programmatically (option 3). - -
-
-
- Hyphenation Patterns -

If you would like to build your own hyphenation pattern files, or modify - existing ones, this section will help you understand how to do so. Even - when creating a pattern file from scratch, it may be beneficial to start - with an existing file and modify it. See - OFFO's Hyphenation page for examples. - Here is a brief explanation of the contents of FOP's hyphenation patterns:

- The remaining content of this section should be considered "draft" - quality. It was drafted from theoretical literature, and has not been - tested against actual FOP behavior. It may contain errors or omissions. - Do not rely on these instructions without testing everything stated here. - If you use these instructions, please provide feedback on the - FOP User mailing list, either - confirming their accuracy, or raising specific problems that we can - address. -
    -
  • The root of the pattern file is the <hyphenation-info> element.
    • -
  • <hyphen-char>: its attribute "value" contains the character signalling - a hyphen in the <exceptions> section. It has nothing to do with the - hyphenation character used in FOP, use the XSLFO hyphenation-character - property for defining the hyphenation character there. At some points - a dash U+002D is hardwired in the code, so you'd better use this too - (patches to rectify the situation are welcome). There is no default, - if you declare exceptions with hyphenations, you must declare the - hyphen-char too.
    • -
  • <hyphen-min> contains two attributes: -
      -
    • before: the minimum number of characters in a word allowed to exist - on a line immediately preceding a hyphenated word-break.
      • -
    • after: the minimum number of characters in a word allowed to exist - on a line immediately after a hyphenated word-break.
      • -
    - This element is unused and not even read. It should be considered a - documentation for parameters used during pattern generation. -
    • -
  • <classes> contains whitespace-separated character sets. The members - of each set should be treated as equivalent for purposes of hyphenation, - usually upper and lower case of the same character. The first character - of the set is the canonical character, the patterns and exceptions - should only contain these canonical representation characters (except - digits for weight, the period (.) as word delimiter in the patterns and - the hyphen char in exceptions, of course).
    • -
  • <exceptions> contains whitespace-separated words, each of which - has either explicit hyphen characters to denote acceptable breakage - points, or no hyphen characters, to indicate that this word should - never be hyphenated, or contain explicit <hyp> elements for specifying - changes of spelling due to hyphenation (like backen -> bak-ken or - Stoffarbe -> Stoff-farbe in the old german spelling). Exceptions override - the patterns described below. Explicit <hyp> declarations don't work - yet (patches welcome). Exceptions are generally a bit brittle, test - carefully.
    • -
  • <patterns> includes whitespace-separated patterns, which are what - drive most hyphenation decisions. The characters in these patterns are - explained as follows: -
      -
    • non-numeric characters represent characters in a sub-word to be - evaluated
      • -
    • the period character (.) represents a word boundary, i.e. either - the beginning or ending of a word
      • -
    • numeric characters represent a scoring system for indicating the - acceptability of a hyphen in this location. Odd numbers represent an - acceptable location for a hyphen, with higher values overriding lower - inhibiting values. Even numbers indicate an unacceptable location, with - higher values overriding lower values indicating an acceptable position. - A value of zero (inhibiting) is implied when there is no number present. - Generally patterns are constructed so that valuse greater than 4 are rare. - Due to a bug currently patterns with values of 8 and greater don't - have an effect, so don't wonder.
      • -
    - Here are some examples from the English patterns file: -
      -
    • Knuth (The TeXBook, Appendix H) uses the example hach4, which indicates that it is extremely undesirable to place a hyphen after the substring "hach", for example in the word "toothach-es".
      • -
    • .leg5e indicates that "leg-e", when it occurs at the beginning of a word, is a very good place to place a hyphen, if one is needed. Words like "leg-end" and "leg-er-de-main" fit this pattern.
      • -
    - Note that the algorithm that uses this data searches for each of the word's substrings in the patterns, and chooses the highest value found for letter combination. -
    • -
-

If you want to convert a TeX hyphenation pattern file, you have to undo - the TeX encoding for non-ASCII text. FOP uses Unicode, and the patterns - must be proper Unicode too. You should be aware of the XML encoding issues, - preferably use a good Unicode editor.

-

Note that FOP does not do Unicode character normalization. If you use - combining chars for accents and other character decorations, you must - declare character classes for them, and use the same sequence of base character - and combining marks in the XSLFO source, otherwise the pattern wouldn't match. - Fortunately, Unicode provides precomposed characters for all important cases - in common languages, until now nobody run seriously into this issue. Some dead - languages and dialects, especially ancient ones, may pose a real problem - though.

-

If you want to generate your own patterns, an open-source utility called - patgen can be used to assist in creating pattern files from dictionaries. - It is available in many Unix/Linux distributions and every TeX distribution. - Pattern creation for languages like english or german is an art. Read - Frank Liang's original paper "Word - Hy-phen-a-tion by Com-pu-ter" (yes, with hyphens) for details. - The original patgen.web source, included in the TeX source distributions, - contains valuable comments, unfortunately technical details often obscure the - high level issues. Another important source of information is - The - TeX Book, appendix H (either read the TeX source, or run it through - TeX to typeset it). Secondary articles, for example the works by Petr Sojka, - may also give some much needed insight into problems arising in automated - hyphenation.

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/index.xml b/src/documentation/content/xdocs/1.1/index.xml deleted file mode 100644 index 737203aa9..000000000 --- a/src/documentation/content/xdocs/1.1/index.xml +++ /dev/null @@ -1,55 +0,0 @@ - - - - - -
- Apache™ FOP Version 1.1 - $Revision$ -
- -
- Introduction -

- This is Version 1.1 of Apache FOP. FOP 1.1 contains many bug - fixes and a number of improvements, including - important features such as support for Complex Scripts - (e.g., Arabic, Hebrew, Indic, and Southeast Asian scripts). To see what has changed since the last release, - please visit Release Notes. -

-

- This release implements a substantial subset of the W3C XSL-FO 1.1 - Recommendation. For a detailed overview of FOP's - compliance with this recommendation, see Compliance. -

-
-
- Upgrading from an earlier version -

- If you're upgrading to this version from an earlier version of FOP, please read the - information on Upgrading! -

-
-
- Download -

- To download this version, please visit Downloading. -

-
- - diff --git a/src/documentation/content/xdocs/1.1/intermediate.xml b/src/documentation/content/xdocs/1.1/intermediate.xml deleted file mode 100644 index 171ae4e6a..000000000 --- a/src/documentation/content/xdocs/1.1/intermediate.xml +++ /dev/null @@ -1,331 +0,0 @@ - - - - - -
- Apache™ FOP: Intermediate Format - $Revision$ -
- - - Please note that the intermediate formats described here are - advanced features and can be ignored by most users of Apache FOP. - -
- Introduction -

- Apache™ FOP now provides two different so-called intermediate formats. The first one - (let's call it the area tree XML format) is basically a 1:1 XML representation of FOP's - area tree as generated by the layout engine. The area tree is conceptually defined in the - XSL-FO specification in chapter 1.1.2. - Even though the area tree is mentioned in the XSL-FO specification, this part is not - standardized. Therefore, the area tree XML format is a FOP-proprietary XML file format. - The area tree XML can be generated through the area tree XML Renderer (the XMLRenderer). -

-

- The second intermediate format (which we shall name exactly like this: the intermediate - format) - is a recent addition which tries to meet a slightly different set of goals. It is highly - optimized for speed. -

-

- The intermediate format can be used to generate intermediate documents that are modified - before they are finally rendered to their ultimate output format. Modifications include - adjusting and changing trait values, adding or modifying area objects, inserting prefabricated - pages, overlays, imposition (n-up, rotation, scaling etc.). Multiple IF files can be combined - to a single output file. -

-
-
- Which Intermediate Format to choose? -

- Both formats have their use cases, so the choice you will make will depend on your - particular situation. Here is a list of strengths and use cases for both formats: -

-
- Area Tree XML (AT XML) -
    -
  • 1:1 representation of FOP's area tree in XML.
    • -
  • Contains more structure information than the new intermediate format.
    • -
  • Used in FOP's layout engine test suite for regression testing.
    • -
-
-
- Intermediate Format (IF) -
    -
  • Highly optimized for speed.
    • -
  • Smaller XML files.
    • -
  • Easier to post-process.
    • -
  • XML Schema is available.
    • -
  • - Recommended for use cases where documents are formatted concurrently and later - concatenated to a single print job. -
    • -
-
-

- More technical information about the two formats can be found on the - FOP Wiki. -

-
-
- Architectural Overview -
-
-
- Usage of the Area Tree XML format (AT XML) -

- As already mentioned, the area tree XML format is generated by using the - XMLRenderer (MIME type: application/X-fop-areatree). - So, you basically set the right MIME type for the output format and process your FO files - as if you would create a PDF file. -

-

- However, there is an important detail to consider: The - various Renderers don't all use the same font sources. To be able to create the right - area tree for the ultimate output format, you need to create the area tree XML file using - the right font setup. This is achieved by telling the XMLRenderer to mimic another - renderer. This is done by calling the XMLRenderer's mimicRenderer() method with an - instance of the ultimate target renderer as the single parameter. This has a consequence: - An area tree XML file rendered with the Java2DRenderer may not look as expected when it - was actually generated for the PDF renderer. For renderers that use the same font setup, - this restriction does not apply (PDF and PS, for example). Generating the area tree XML - format file is the first step. -

-

- The second step is to reparse the file using the AreaTreeParser which is - found in the org.apache.fop.area package. The pages retrieved from the area tree XML file - are added to an AreaTreeModel instance from where they are normally rendered using one of - the available Renderer implementations. You can find examples for the area tree XML - processing in the - examples/embedding - directory in the FOP distribution. -

-

- The basic pattern to parse the area tree XML format looks like this: -

- -

- This example simply reads an area tree file and renders it to a PDF file. Please note, that in normal - FOP operation you're shielded from having to instantiate the FontInfo object yourself. This - is normally a task of the AreaTreeHandler which is not present in this scenario. The same - applies to the AreaTreeModel instance, in this case an instance of a subclass called - RenderPagesModel. RenderPagesModel is ideal in this case as it has very little overhead - processing the individual pages. An important line in the example is the call to - endDocument() on the AreaTreeModel. This lets the Renderer know that the processing - is now finished. -

-

- The area tree XML format can also be used from the command-line - by using the "-atin" parameter for specifying the area tree XML as input file. You can also - specify a "mimic renderer" by inserting a MIME type between "-at" and the output file. -

-
- Concatenating Documents -

- This initial example is obviously not very useful. It would be faster to create the PDF file - directly. As the ExampleConcat.java - example shows you can easily parse multiple area tree files in a row and add the parsed pages to the - same AreaTreeModel instance which essentially concatenates all the input document to one single - output document. -

-
-
- Modifying Documents -

- One of the most important use cases for this format is obviously modifying the area - tree XML before finally rendering it to the target format. You can easily use XSLT to process - the AT XML file according to your needs. Please note, that we will currently not formally describe - the area tree XML format. You need to have a good understanding its structure so you don't - create any non-parseable files. We may add an XML Schema and more detailed documentation at a - later time. You're invited to help us with that. -

- - The area tree XML format is sensitive to changes in whitespace. If you're not careful, - the modified file may not render correctly. - -
-
- Advanced Use -

- The generation of the area tree format as well as it parsing process has been designed to allow - for maximum flexibility and optimization. Please note that you can call setTransformerHandler() on - XMLRenderer to give the XMLRenderer your own TransformerHandler instance in case you would like to - do custom serialization (to a W3C DOM, for example) and/or to directly modify the area tree using - XSLT. The AreaTreeParser on the other side allows you to retrieve a ContentHandler instance where - you can manually send SAX events to to start the parsing process (see getContentHandler()). -

-
-
-
- Usage of the Intermediate Format (IF) -

- The Intermediate Format (IF) is generated by the IFSerializer - (MIME type: application/X-fop-intermediate-format). - So, you basically set the right MIME type for the output format and process your FO files - as if you would create a PDF file. -

-

- The IFSerializer is an implementation of the IFDocumentHandler and - IFPainter interfaces. The IFRenderer class is responsible - for converting FOP's area tree into calls against these two interfaces. -

-
    -
  • - IFDocumentHandler: This interface is used on the document-level and defines the - overall structure of the Intermediate Format. -
    • -
  • - IFPainter: This interface is used to generate graphical page content like text, images - and borders. -
    • -
-

- As with the AT XML, there is an important detail to consider: The various output - implementations don't all use the same font sources. To be able - to create the right IF for the ultimate output file, you need to create the IF file using - the right font setup. This is achieved by telling the IFRenderer (responsible for - converting the area tree into calls to the IFDocumentHandler and IFPainter interfaces) - to mimic another renderer. This is done by calling the IFSerializer's - mimicDocumentHandler() method with an instance of the ultimate target document handler - as the single parameter. This has a consequence: An IF file rendered with the - Java2DDocumentHandler may not look as expected when it was actually generated for the PDF - implementation. For implementations that use the same font setup, - this restriction does not apply (PDF and PS, for example). Generating the Intermediate - Format file is the first step. -

-

- The second step is to reparse the file using the IFParser which is - found in the org.apache.fop.render.intermediate package. The IFParser simply takes an - IFDocumentHandler instance against which it generates the appropriate calls. The IFParser - is implemented as a SAX ContentHandler so you're free to choose the method for - post-processing the IF file(s). You can use XSLT or write SAX- or DOM-based code to - manipulate the contents. You can find examples for the Intermediate Format - processing in the - examples/embedding - directory in the FOP distribution. -

-

- The basic pattern to parse the intermediate format looks like this: -

- -

- This example simply reads an intermediate file and renders it to a PDF file. Here - IFParser.parse() is used, but you can also just get a SAX ContentHandler by using the - IFParser.getContentHandler() method. -

-
- Concatenating Documents -

- This initial example is obviously not very useful. It would be faster to create the PDF file - directly (without the intermediate step). As the - ExampleConcat.java - example shows you can easily parse multiple intermediate files in a row and use the - IFConcatenator class to concatenate page sequences from multiple source files to a single - output file. This particular example does the concatenation on the level of the - IFDocumentHandler interface. You could also do this in XSLT or using SAX on the XML level. - Whatever suits your process best. -

-
-
- Modifying Documents -

- One of the most important use cases for this format is obviously modifying the - intermediate format before finally rendering it to the target format. You can easily use - XSLT to process the IF file according to your needs. -

-

- There is an XML Schema (located under - src/documentation/intermediate-format-ng) - that helps you verify that your modified content is correct. -

-

- For certain output formats there's a caveat: Formats like AFP and PCL do not support - arbitrary transformations on the IF's "viewport" and "g" elements. Possible are - only rotations in 90 degree steps and translations. -

-
-
- Advanced Use -

- The generation of the intermediate format as well as it parsing process has been - designed to allow for maximum flexibility and optimization. So rather than just passing - in a StreamResult to IFSerializer's setResult() method, you can also use a SAXResult - or a DOMResult. And as you've already seen , the IFParser on the other side allows you - to retrieve a ContentHandler instance where you can manually send SAX events to - start the parsing process (see getContentHandler()). -

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/known-issues.xml b/src/documentation/content/xdocs/1.1/known-issues.xml deleted file mode 100644 index c0107317d..000000000 --- a/src/documentation/content/xdocs/1.1/known-issues.xml +++ /dev/null @@ -1,54 +0,0 @@ - - - - - - Support for Unicode characters outside of the Base Multilingual Plane (BMP), i.e., characters - whose code points are greater than 65535, is not yet implemented. - See bug 51843. - - - The writing-mode property does not produce the expected behavior when specified on - fo:simple-page-master or fo:region-* elements. - See bug 53276. - - - Support for Devanagari and other Indic scripts is not yet complete. - - - Use of Unicode U+200C ZERO WIDTH NON-JOINER (ZWNJ) or U+200D ZERO WIDTH JOINER (ZWJ) - does not prevent or force contextual substitution, respectively, when used with Arabic script. - - - Use of Unicode U+200C ZERO WIDTH NON-JOINER (ZWNJ) or U+200D ZERO WIDTH JOINER (ZWJ) - does not affect conjunct formation or other special behavior prescribed when used with Indic scripts. - - - Support for automatic line breaking at orthographic syllable segment boundaries in Indic - or Southeast Asian scripts is not yet available. In the mean time, use U+200B ZERO WIDTH SPACE (ZWSP). - - - Complex script content is presently supported only with AT, IF, and PDF output formats. - - - When complex script text encounters an fo:inline or fo:character boundary, - contextual substitution and ligature formation will not occur across the boundary. This prevents, - for example, applying a different color to an Arabic Letter within an Arabic word, unless that letter - is a non-joining letter (on both sides). - - diff --git a/src/documentation/content/xdocs/1.1/knownissues_overview.xml b/src/documentation/content/xdocs/1.1/knownissues_overview.xml deleted file mode 100644 index a8b9e9b94..000000000 --- a/src/documentation/content/xdocs/1.1/knownissues_overview.xml +++ /dev/null @@ -1,74 +0,0 @@ - - - - - -
- Apache™ FOP: Known Issues - $Revision$ -
- -
- Known issues -

- This page lists currently known issues in the current release. -

- -

- For additional information on known issues in Apache™ FOP, please have a look at the following pages, too: -

- - -

- Apache™ FOP has an extensive automated testing infrastructure. Parts of this infrastructure are several - sets of test cases. When a test case is listed in disabled-testcases.xml it is disabled in the JUnit - tests during the normal build process. This indicates a problem in the current codebase. When a bug is - fixed or a missing feature is added the entry for the relevant test case(s) are removed. -

-
- FO Tree -

- This section lists disabled test cases in the test suite for the FO tree tests, at the time - of the release. -

- -
-
- Layout Engine -

- This section lists disabled test cases in the test suite for the layout engine tests, at the - time of the release. -

- -
-
- Other known issues -

This section lists some other issues that post-date the release of FOP 1.0. For known issues that pre-date FOP 1.0, see - older bugs that remain open. - For all open issues that post-date FOP 1.0, see - newer bugs that remain open. -

- - -
-
- - diff --git a/src/documentation/content/xdocs/1.1/layoutengine/disabled-testcases.xml b/src/documentation/content/xdocs/1.1/layoutengine/disabled-testcases.xml deleted file mode 100644 index 5208fa91d..000000000 --- a/src/documentation/content/xdocs/1.1/layoutengine/disabled-testcases.xml +++ /dev/null @@ -1,223 +0,0 @@ - - - - - - - - Auto-height block-containers produce fences - block-container_space-before_space-after_3.xml - Block-containers with no height currently don't - create a fence for spaces as they should (they behave like a - normal block). - - - font-stretch NYI - block_font-stretch.xml - Font-stretch is not implemented, yet. - - - linefeed-treatment - block_linefeed-treatment.xml - Preserved linefeeds in a fo:character are not handled - correctly. - - - white-space-treatment - block_white-space-treatment_3.xml - White space handling incorrectly stops at fo:inline - boundaries when it comes to formatter generated line breaks. - - - Empty blocks produce fences - block_space-before_space-after_8.xml - An empty block currently produces a fence for - stacking constraints which it shouldn't. - - - block white-space nbsp 2 - block_white-space_nbsp_2.xml - The nbsp given as an fo:character is not adjustable and therefore - the justification does not work in this case. - - - block word-spacing - block_word-spacing.xml - Word-spacing may not work as expected. - - - block word-spacing text-align justify - block_word-spacing_text-align_justify.xml - Word-spacing may not work as expected. - - - external-graphic don't shrink - external-graphic_oversized.xml - Images currently don't shrink so they fit on a page - when they are too big and shrinking is allowed to - happen (min/opt/max). - - - Test case with HTTP URL - external-graphic_src_uri.xml - Doesn't work behind a proxy which requires - authorization. - - - Space Resolution in foot note area - footnote_space-resolution.xml - Space resolution does not work between footnote - regions. - - - NPE for table inside an inline - inline_block_nested_3.xml - Placing a table as a child of an fo:inline produces a - NullPointerException. - - - inline-container is not implemented, yet. - inline-container_block_nested.xml - inline-container is not implemented, yet. Content of an - inline-container will get swallowed. The test case contains no checks. - - - inline-container is not implemented, yet. - inline-container_border_padding.xml - inline-container is not implemented, yet. Content of an - inline-container will get swallowed. - - - inline letter-spacing - inline_letter-spacing.xml - Letter-spacing may not work as - expected within fo:inline. - - - inline word-spacing - inline_word-spacing.xml - Word-spacing may not work as expected within - fo:inline. - - - inline word-spacing text-align justify - inline_word-spacing_text-align_justify.xml - - - - leader-alignment NYI - leader-alignment.xml - Leader-alignment is not yet - implemented. - - - leader-pattern="use-content": Problem with line height - leader_leader-pattern_use-content_bug.xml - Line height is not correctly calculated for - use-content leaders whose height is larger than the rest of the - line. - http://www.nabble.com/leaders-with-leader-pattern%3D%22use-content%22-t546244.html - - - Page breaking doesn't deal with IPD changes - page-breaking_4.xml - Page breaking currently doesn't support changing available IPD - between pages of a single page-sequence. Element list generation has to be reset to - redetermine line breaks in this case. - - - Overflow handing is incomplete - page-breaking_6.xml - Line breaking is not 100% correct when there's too little space. - Overflows are not detected and warned. - - - Indefinite page height handling is imcomplete - page-height_indefinite_simple.xml - A RuntimeException is thrown for a page of indefinite height. Lots of warnings. - - - page-number-citation: Problem with background-image - page-number-citation_background-image.xml - Background-images on page-number-citations are not - placed correctly. - - - IDs are not working on all FO elements - page-number-citation_complex_1.xml - The "id" attributes are not properly handled for all block-level FO elements. - - - IDs are not working on all FO elements - page-number-citation_complex_2.xml - The "id" attributes are not properly handled for all inline-level FO elements. - - - Footnotes in multi-column documents - region-body_column-count_footnote.xml - Footnotes may overlap with text of the region-body in - multi-column documents. - - - Column Balancing problems - region-body_column-count_balance_4col.xml - Situation in a 4-column document where the column balancing doesn't work and even causes some - content to disappear. - - - Column Balancing problems - region-body_column-count_bug36356.xml - Column balancing doesn't work as expected. - - - table-cell empty area with marker.xml - table-cell_empty_area_with_marker.xml - A table-cell producing an empty area does currently not add any markers to a page. - See TODO entry in AreaAdditionUtil. - - - Border conditionality on table - table_border-width_conditionality.xml - The code should be ok, but the test case uses shorthands and therefore - is probably not expressing the indended outcome according to the spec. The test - case should be revisited. - - - Soft hyphen with normal hyphenation enabled - block_shy_linebreaking_hyph.xml - A soft hyphen should be a preferred as break compared to a - normal hyphenation point but is not. - - - Page-keep not respected in multi-column layout - keep_within-page_multi-column_overflow.xml - The block should cause overflow in the - last column on the page, rather than be broken. - - - Block Container Reference Orientation Bug - block-container_reference-orientation_bug36391.xml - An assert is failing - - - Writing mode problems - simple-page-master_writing-mode_rl_region-body_writing-mode-lr.xml - Test erroneously depends upon incorrect implementation of writing-mode trait - derivation on fo:region-*. - - diff --git a/src/documentation/content/xdocs/1.1/metadata.xml b/src/documentation/content/xdocs/1.1/metadata.xml deleted file mode 100644 index 5d4185533..000000000 --- a/src/documentation/content/xdocs/1.1/metadata.xml +++ /dev/null @@ -1,243 +0,0 @@ - - - - - -
- Apache™ FOP: Metadata -
- -
- Overview -

- Document metadata is an important tool for categorizing and finding documents. - Various formats support different kinds of metadata representation and to - different levels. One of the more popular and flexible means of representing - document or object metadata is - XMP (eXtensible Metadata Platform, specified by Adobe). - PDF 1.4 introduced the use of XMP. The XMP specification lists recommendation for - embedding XMP metdata in other document and image formats. Given its flexibility it makes - sense to make use this approach in the XSL-FO context. Unfortunately, unlike SVG which - also refers to XMP, XSL-FO doesn't recommend a preferred way of specifying document and - object metadata. Therefore, there's no portable way to represent metadata in XSL-FO - documents. Each implementation does it differently. -

-
-
- Embedding XMP in an XSL-FO document -

- As noted above, there's no officially recommended way to embed metadata in XSL-FO. - Apache™ FOP supports embedding XMP in XSL-FO. Currently, only support for document-level - metadata is implemented. Object-level metadata will be implemented when there's - interest. -

-

- Document-level metadata can be specified in the fo:declarations element. - XMP specification recommends to use x:xmpmeta, rdf:RDF, and - rdf:Description elements as shown in example below. Both - x:xmpmeta and rdf:RDF elements are recognized as the top-level - element introducing an XMP fragment (as per the XMP specification). -

-
- Example - - - - - - - Document title - Document author - Document subject - - - - Tool used to make the PDF - - - - - - - fo:declarations must be declared after - fo:layout-master-set and before the first page-sequence. - -
-
-
- Implementation in Apache FOP -

- Currently, XMP support is only available for PDF output. -

-

- Originally, you could set some metadata information through FOP's FOUserAgent by - using its set*() methods (like setTitle(String) or setAuthor(String). These values are - directly used to set value in the PDF Info object. Since PDF 1.4, adding metadata as an - XMP document to a PDF is possible. That means that there are now two mechanisms in PDF - that hold metadata. -

-

- Apache FOP now synchronizes the Info and the Metadata object in PDF, i.e. when you - set the title and the author through the FOUserAgent, the two values will end up in - the (old) Info object and in the new Metadata object as XMP content. If instead of - FOUserAgent, you embed XMP metadata in the XSL-FO document (as shown above), the - XMP metadata will be used as-is in the PDF Metadata object and some values from the - XMP metadata will be copied to the Info object to maintain backwards-compatibility - for PDF readers that don't support XMP metadata. -

-

- The mapping between the Info and the Metadata object used by Apache FOP comes from - the PDF/A-1 specification. - For convenience, here's the mapping table: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Document information dictionaryXMP
EntryPDF typePropertyXMP typeCategory
Titletext stringdc:titleTextExternal
Authortext stringdc:creatorseq TextExternal
Subjecttext stringdc:description["x-default"]TextExternal
Keywordstext stringpdf:KeywordsTextExternal
Creatortext stringxmp:CreatorToolTextExternal
Producertext stringpdf:ProducerTextInternal
CreationDatedatexmp:CreationDateDateInternal
ModDatedatexmp:ModifyDateDateInternal
- - "Internal" in the Category column means that the user should not set this value. - It is set by the application. - - - The "Subject" used to be mapped to dc:subject in the initial publication of - PDF/A-1 (ISO 19005-1). In the - Technical Corrigendum 1 - this was changed to map to dc:description["x-default"]. - -
- Namespaces -

- Metadata is made of property sets where each property set uses a different namespace URI. -

-

- The following is a listing of namespaces that Apache FOP recognizes and acts upon, - mostly to synchronize the XMP metadata with the PDF Info dictionary: -

- - - - - - - - - - - - - - - - - - - - - -
Set/SchemaNamespace PrefixNamespace URI
Dublin Coredchttp://purl.org/dc/elements/1.1/
XMP Basicxmphttp://ns.adobe.com/xap/1.0/
Adobe PDF Schemapdfhttp://ns.adobe.com/pdf/1.3/
-

- Please refer to the XMP Specification - for information on other metadata namespaces. -

-

- Property sets (Namespaces) not listed here are simply passed through to the final - document (if supported). That is useful if you want to specify a custom metadata - schema. -

-
-
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/output.xml b/src/documentation/content/xdocs/1.1/output.xml deleted file mode 100644 index cabbbb0fa..000000000 --- a/src/documentation/content/xdocs/1.1/output.xml +++ /dev/null @@ -1,1401 +0,0 @@ - - - - - - -
- Apache™ FOP Output Formats - $Revision$ - - - - -
- - -

- Apache™ FOP supports multiple output formats by using a different renderer for each format. - The renderers do not all have the same set of capabilities, sometimes because of - the output format itself, sometimes because some renderers get more development - attention than others. -

-
- General Information -
- Fonts -

- Most FOP renderers use a FOP-specific system for font registration. - However, the Java2D/AWT and print renderers use the Java AWT package, which gets its - font information from the operating system registration. - This can result in several differences, including actually using different fonts, - and having different font metrics for the same font. - The net effect is that the layout of a given FO document can be quite different between - renderers that do not use the same font information. -

-

- Theoretically, there's some potential to make the output of the PDF/PS renderers match - the output of the Java2D-based renderers. If FOP used the font metrics from its own - font subsystem but still used Java2D for text painting in the Java2D-based renderers, - this could probably be achieved. However, this approach hasn't been implemented, yet. -

-

- With a work-around, it is possible to match the PDF/PS output in a Java2D-based - renderer pretty closely. The clue is to use the - intermediate format. The trick is to layout the - document using FOP's own font subsystem but then render the document using Java2D. - Here are the necessary steps (using the command-line): -

-
    -
  1. - Produce an IF file: fop -fo myfile.fo -at application/pdf myfile.at.xml
    - Specifying "application/pdf" for the "-at" parameter causes FOP to use FOP's own - font subsystem (which is used by the PDF renderer). Note that no PDF file is created - in this step. -
    2. -
  2. Render to a PDF file: fop -atin myfile.at.xml -pdf myfile.pdf
    3. -
  3. Render to a Java2D-based renderer: -
      -
    • fop -atin myfile.at.xml -print
      • -
    • fop -atin myfile.at.xml -awt
      • -
    • fop -atin myfile.at.xml -tiff myfile.tiff
      • -
    -
    4. -
-
-
- Output to a Printer or Other Device -

- The most obvious way to print your document is to use the FOP - print renderer, which uses the Java2D API (AWT). - However, you can also send output from the Postscript renderer directly to a Postscript - device, or output from the PCL renderer directly to a PCL device. -

-

- Here are Windows command-line examples for Postscript and PCL: -

- - -

- Here is some Java code to accomplish the task in UNIX: -

- -

- Set the output MIME type to "application/x-pcl" (MimeConstants.MIME_PCL) and - it happily sends the PCL to the UNIX printer queue. -

-
-
-
- PDF -

- PDF is the best supported output format. It is also the most accurate - with text and layout. This creates a PDF document that is streamed out - as each page is rendered. This means that the internal page index - information is stored near the end of the document. - The PDF version supported is 1.4. PDF versions are forwards/backwards - compatible. -

-

- Note that FOP does not currently support PDF/A-1a. - Support for Tagged PDF, PDF/A-1b - and PDF/X has recently been added, however. -

-
- Fonts -

- PDF has a set of fonts that are always available to all PDF viewers; - to quote from the PDF Specification: - - "PDF prescribes a set of 14 standard fonts that can be used without prior - definition. - These include four faces each of three Latin text typefaces (Courier, - Helvetica, and Times), as well as two symbolic fonts (Symbol and ITC Zapf - Dingbats). These fonts, or suitable substitute fonts with the same metrics, are - guaranteed to be available in all PDF viewer applications." -

-
-
- Post-processing -

- FOP does not currently support several desirable PDF features: watermarks and signatures. - One workaround is to use Adobe Acrobat (the full version, not the Reader) to process - the file manually or with scripting that it supports. -

-

- Another popular post-processing tool is iText, - which has tools for adding security features, document properties, watermarks, and many - other features to PDF files. -

- - Caveat: iText may swallow PDF bookmarks. But - Jens Stavnstrup tells us - that this doesn't happen if you use iText's PDFStamper. - -

- Here is some sample code that uses iText to encrypt a FOP-generated PDF. (Note that FOP now - supports PDF encryption. However the principles for using - iText for other PDF features are similar.) -

- -

- Check the iText tutorial and documentation for setting access flags, password, - encryption strength and other parameters. -

-
-
- Watermarks -

- In addition to the PDF Post-processing options, consider the following workarounds: -

-
    -
  • - Use a background image for the body region. -
    • -
  • - (submitted by Trevor Campbell) Place an image in a - region that overlaps the flowing text. For example, make - region-before large enough to contain your image. Then include a - block (if necessary, use an absolutely positioned block-container) - containing the watermark image in the static-content for the - region-before. Note that the image will be drawn on top of the - normal content. -
    • -
-
-
- Extensions -

The PDF Renderer supports some PDF specific extensions which can be embedded - into the input FO document. To use the extensions the appropriate namespace must - be declared in the fo:root element like this:

- - ]]> -
- Embedded Files -

- It is possible to attach/embed arbitrary files into a PDF file. You can give a name and - a description of the file. Example: -

- - - - - ]]> -

- pdf:embedded-file must be a child of fo:declarations. - The "src" property is used to reference the file that is to be embedded. This property - uses the "uri-specification" datatype from the XSL-FO specification. - The "filename" property is optional. If it is missing the filename is automatically set - from the URI/IRI of the "src" property. An optional description can also be added to - further describe the file attachment. -

-

- It is also possible to reference an embedded file from an fo:basic-link. - Use the special "embedded-file:" URI scheme with the filename as single argument after - the URI scheme. Example: -

- Attached Image -]]> -

- Note: Not all PDF Viewers (including some Acrobat Versions) will open the embedded file - when clicking on the link. In that case, the user will have to open he attachment via - the separate list of file attachments. -

-
-
-
-
- PostScript -

- The PostScript renderer has been brought up to a similar quality as the - PDF renderer, but may still be missing certain features. It provides good - support for most text and layout. - Images and SVG are not fully supported, yet. Currently, the PostScript - renderer generates PostScript Level 3 with most DSC comments. Actually, - the only Level 3 features used are the FlateDecode and DCTDecode - filter (the latter is used for 1:1 embedding of JPEG images), everything - else is Level 2. -

-
- Configuration -

- The PostScript renderer configuration currently allows the following settings: -

- - false - 3 - false - false - true - quality -]]> -

- The default value for the "auto-rotate-landscape" setting is "false". Setting it - to "true" will automatically rotate landscape pages and will mark them as landscape. -

-

- The default value for the "language-level" setting is "3". This setting specifies - the PostScript language level which should be used by FOP. Set this to "2" - only if you don't have a Level 3 capable interpreter. -

-

- The default value for the "optimize-resources" setting is "false". Setting it - to "true" will produce the PostScript file in two steps. A temporary file will be - written first which will then be processed to add only the fonts which were really - used and images are added to the stream only once as PostScript forms. This will - reduce file size but can potentially increase the memory needed in the interpreter - to process. -

-

- The default value for the "safe-set-page-device" setting is "false". Setting it - to "true" will cause the renderer to invoke a postscript macro which guards against - the possibility of invalid/unsupported postscript key/values being issued to the - implementing postscript page device. -

-

- The default value for the "dsc-compliant" setting is "true". Setting it - to "false" will break DSC compliance by minimizing the number of setpagedevice - calls in the postscript document output. This feature may be useful when unwanted - blank pages are experienced in your postscript output. This problem is caused by - the particular postscript implementation issuing unwanted postscript subsystem - initgraphics/erasepage calls on each setpagedevice call. -

-

- The default value for the "rendering" setting is "quality". Setting it to "size" - optimizes rendering for smaller file sizes which can involve minor compromises in - rendering quality. For example, solid borders are then painted as plain rectangles - instead of the elaborate painting instructions required for mixed-color borders. -

-
-
- Limitations -
    -
  • Images and SVG may not be displayed correctly. SVG support is far from being complete. No image transparency is available.
    • -
  • Only Type 1 fonts are supported.
    • -
  • Multibyte characters are not supported.
    • -
  • PPD support is still missing.
    • -
-
-
-
- PCL -

- This format is for the Hewlett-Packard PCL printers and other printers - supporting PCL. It should produce output as close to identical as possible - to the printed output of the PDFRenderer within the limitations of the - renderer, and output device. -

-

- The output created by the PCLRenderer is generic PCL 5, HP GL/2 and PJL. - This should allow any device fully supporting PCL 5 to be able to - print the output generated by the PCLRenderer. PJL is used to control the - print job and switch to the PCL language. PCL 5 is used for text, raster - graphics and rectangular fill graphics. HP GL/2 is used for more complex - painting operations. Certain painting operations are done off-screen and - rendered to PCL as bitmaps because of limitations in PCL 5. -

-
- References - -
-
- Limitations -
    -
  • - Text or graphics outside the left or top of the printable area are not - rendered properly. This is a limitation of PCL, not FOP. In general, - things that should print to the left of the printable area are shifted - to the right so that they start at the left edge of the printable area. -
    • -
  • - The Helvetica and Times fonts are not well supported among PCL printers - so Helvetica is mapped to Arial and Times is mapped to Times New. This - is done in the PCLRenderer, no changes are required in the FO's. The - metrics and appearance for Helvetica/Arial and Times/Times New are - nearly identical, so this has not been a problem so far. -
    • -
  • For the non-symbol fonts, the ISO 8859-1 symbol set is used (PCL set "0N").
    • -
  • - All fonts available to the Java2D subsystem are usable. The texts are - painted as bitmap much like the Windows PCL drivers do. -
    • -
  • Multibyte characters are not supported.
    • -
  • - At the moment, only monochrome output is supported. PCL5c color extensions - will only be implemented on demand. Color and grayscale images are converted - to monochrome bitmaps (1-bit). Dithering only occurs if the JAI image library - is available. -
    • -
  • - Images are scaled up to the next resolution level supported by PCL (75, - 100, 150, 200, 300, 600 dpi). For color and grayscale images an even - higher PCL resolution is selected to give the dithering algorithm a chance - to improve the bitmap quality. -
    • -
  • - Currently, there's no support for clipping and image transparency, largely - because PCL 5 has certain limitations. -
    • -
-
-
- Configuration -

- The PCL renderer configuration currently allows the following settings: -

- - quality - bitmap - false -]]> -

- The default value for the "rendering" setting is "speed" which causes borders - to be painted as plain rectangles. In this mode, no special borders (dotted, - dashed etc.) are available. If you want support for all border modes, set the - value to "quality" as indicated above. This will cause the borders to be painted - as bitmaps. -

-

- The default value for the "text-rendering" setting is "auto" which paints the - base fonts using PCL fonts. Non-base fonts are painted as bitmaps through Java2D. - If the mix of painting methods results in unwelcome output, you can set this - to "bitmap" which causes all text to be rendered as bitmaps. -

-

- The default value for the "disable-pjl" setting is "false". This means that - the PCL renderer usually generates PJL commands before and after the document - in order to switch a printer into PCL language. PJL commands can be disabled - if you set this value to "true". -

-

- You can control the output resolution for the PCL using the "target resolution" - setting on the FOUserAgent. The actual value will be rounded up to the next - supported PCL resolution. Currently, only 300 and 600 dpi are supported which - should be enough for most use cases. Note that this setting directly affects - the size of the output file and the print quality. -

-
-
- Extensions -

The PCL Renderer supports some PCL specific extensions which can be embedded - into the input FO document. To use the extensions the appropriate namespace must - be declared in the fo:root element like this:

- -]]> -
- Page Source (Tray selection) -

- The page-source extension attribute on fo:simple-page-master allows to - select the paper tray the sheet for a particular simple-page-master is - to be taken from. Example: -

- - - ... - - -]]> -

- Note: the tray number is a positive integer and the value depends on - the target printer. Not all PCL printers support the same paper trays. - Usually, - "1" is the default tray, - "2" is the manual paper feed, - "3" is the manual envelope feed, - "4" is the "lower" tray and - "7" is "auto-select". - Consult the technical reference for your printer for all available values. -

-
-
- Output Bin -

- The output-bin extension attribute on fo:simple-page-master allows to - select the output bin into which the printed output should be fed. Example: -

- - - ... - - -]]> -

- Note: the output bin number is a positive integer and the value depends on - the target printer. Not all PCL printers support the same output bins. - Usually, - "1" is the upper output bin, - "2" is the lower (rear) output bin. - Consult the technical reference for your printer for all available values. -

-
-
- Page Duplex Mode -

- The duplex-mode extension attribute on fo:simple-page-master allows to - select the duplex mode to be used for a particular simple-page-master. - Example: -

- - - ... - - -]]> -

- Note: the duplex is a positive integer and the value depends on - the target printer. Not all PCL printers support duplexing. - Usually, - "0" is simplex, - "1" is duplex (long-edge binding), - "2" is duplex (short-edge binding). - - Consult the technical reference for your printer for all available values. -

-
-
-
-
- AFP -

- The FOP AFP Renderer deals with creating documents conforming to the IBM AFP document architecture - also refered to as MO:DCA (Mixed Object Document Content Architecture). -

-

- The mapping of XSL-FO elements to the major MO:DCA structures is as follows: -

- - - - - - - - - - - - - - - - - -
XSL-FO elementMO:DCA-P object
fo:rootDocument
fo:page-sequencePage Group
fo:simple-page-masterPage
-

- FOP creates exactly one Document per Printfile with an optional Resource Group at the - beginning. FOP does not create document indices. -

-
- References - -
-
- Limitations -

This list is most likely badly incomplete.

-
    -
  • - Clipping of text and graphics is not supported. -
    • -
  • - Only IBM outline and raster fonts and to a limited extend the original fonts built into FOP are supported. - Support for TrueType fonts may be added later. -
    • -
-
-
- Deployment in older environments -

- There are still a big number of older (or limited) MO:DCA/IPDS environments in production - out there. AFP has grown in functionality over time and not every environment supports the - latest features. We're trying to make AFP output work in as many environments as possible. - However, to make AFP output work on older environments it is recommended to set to - configuration to 1 bit per pixel (see below on how to do this). In this case, all images - are converted to bi-level images using IOCA function set 10 (FS10) and are enclosed in - page-segments since some implementation cannot deal with IOCA objects directly. - If a higher number of bits per pixel is configured, FOP has to switch to at least FS11 - which may not work everywhere. -

-
-
- Configuration -
- Fonts -

The AFP Renderer requires special configuration particularly related to fonts. - AFP Render configuration is done through the normal FOP configuration file. The MIME type - for the AFP Renderer is application/x-afp which means the AFP Renderer section in the FOP configuration file - looks like:

- - - ... -]]> -

There are 4 font configuration variants supported:

-
    -
  1. IBM Raster fonts
    2. -
  2. IBM Outline fonts
    3. -
  3. IBM CID-keyed (Type 0) fonts
    4. -
  4. FOP built-in Base14 fonts
    5. -
-

A typical raster font configuration looks like:

- - - - - - - - - - - - - - - - - - - - - - - - ]]> -

An outline font configuration is simpler as the individual font size entries are not required. - However, the characterset definition is now required within the afp-font element.

- - - - - - -]]> -

- If "base-uri" is missing or a relative URI, the fonts are resolved relative to - the font base URI specified in the configuration (or on the FopFactory). -

- - Previously, the location of the font files was given by the "path" attribute. This is still - supported for the time being, but you should move to using the more flexible "base-uri" - attribute so you can profit from the power of URI resolvers. - -

A CID-keyed font (Type 0, double-byte outline font) configuration is much the same as an outline font. - However, the characterset definition is now required within the afp-font element.

- - - - -]]> -

-Note that the value of the encoding attribute in the example is the double-byte encoding 'UnicodeBigUnmarked' (UTF-16BE). -

-

Experimentation has shown that the font metrics for the FOP built-in Base14 fonts are actually - very similar to some of the IBM outline and raster fonts. In cases were the IBM font files are not - available the base-uri attribute in the afp-font element can be replaced by a base14-font attribute - giving the name of the matching Base14 font. In this case the AFP Renderer will take the - font metrics from the built-in font.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ]]> -

- By default, all manually configured fonts are embedded, unless they are matched in the - referenced-fonts section of the configuration file. - However, the default fonts shown above will not be embedded. -

-

- For double byte EBCDIC encoded character sets, there is an optional tag that must be set to prevent - characters from being miscoded. This defaults to "false" if not specified.

- ]]> - -
-
- Output Resolution -

By default the AFP Renderer creates output with a resolution of 240 dpi. - This can be overridden by the <renderer-resolution/> configuration element. Example:

- 240]]> -
-
- Line Width Correction -

The default line width in AFP is device dependent. This means that a line width specified in, say, - a SVG source file may not render the way it was intended. The output AFP line with can be corrected - by the <line-width-correction/> configuration element. Example:

- 2.5]]> -
-
- Images -

By default the AFP Renderer converts all images to 8 bit grey level. - This can be overridden by the <images/> configuration element. Example:

- -]]> -

This will put images as RGB images into the AFP output stream. The default setting is:

- -]]> -

Only the values "color" and "b+w" are allowed for the mode attribute.

-

The bits-per-pixel attribute is ignored if mode is "color". For "b+w" mode is must be 1, 4, or 8.

- -]]> -

When the native attribute is specified and set to "true", all image resources will be natively injected - into the datastream using an object container rather than being converted into an IOCA FS45 image. - Support for native image formats (e.g. JPEG, TIFF, GIF) is not always available on printer implementations - so by default this configuration option is set to "false".

-

- Setting cmyk="true" on the images element will enable CMYK - colors. This will only have an effect if the color mode is set to "color". Example: -

- ]]> -

- When the color mode is set to 1 bit (bi-level), the "dithering-quality" attribute can - be used to select the level of quality to use when converting images to bi-level images. - Valid values for this attribute are floating point numbers from 0.0 (fastest) to - 1.0 (best), or special values: "minimum" (=0.0), "maximum" (1.0), - "medium" (0.5, the default). For the higher settings to work as expected, JAI needs to - be present in the classpath. If JAI is present, 0.0 results in a minimal darkness-level - switching between white and black. 0.5 does bayer-based dithering and 1.0 will use - error-diffusion dithering. The higher the value, the higher the quality and the slower - the processing of the images. -

- ]]> -

- When the boolean attribute pseg (default false) is set to true, non-inline FS11 and FS45 IOCA images are wrapped in page segment. - This option is provided to support printers/print servers that require this MO:DCA structure. -

- ]]> -

- Setting the boolean attribute fs45 to true (default false) will force all images to FS45. -

- ]]> -

- By default, JPEG images are rasterized to a bitmap and the bitmap is included in the AFP doc. - However it is possible to encode in a lossless way to maintain maximum quality. But due - to lack of support for compression schemes like LZW (patent concerns), bitmap data is currently - not compressed resulting in large AFP files. Using the "allow-embedding" attribute on jpeg child - element allows the user to pass the JPEG as is in the document. The default is set to "false" since - there are compatibility concerns as some AFP printers don't support JPEG decoding. Using the - "bitmap-encoding-quality" attribute it is possible to enable lossy compression (JPEG baseline - DCT). The default is "1.0" which means lossless encoding. Setting a value lower than 1.0, JPEG - compression is enabled and the setting is used as the quality setting when encoding bitmap data. - Note that this setting does not always have an effect. Bi-level (1 bit) bitmaps are not compressed - using JPEG. Example: -

- - - ]]> -
-
- GOCA (Vector Graphics) -

- Not all AFP implementations support GOCA. Some also have bugs related to GOCA. Therefore, - it is desirable to have some control over the generation of GOCA graphics. -

-

- GOCA is enabled by default. You can disable GOCA entirely in which case the AFP support - falls back to generating bitmaps for vector graphics. Example: -

- ]]> -

- Some AFP implementations have trouble rendering text in GOCA. You can instruct the AFP - support to render text as shapes (i.e. use vector graphics to paint text). Example: -

- ]]> -

- If you disable GOCA or let text render as shapes, the size of the generated AFP usually - increases considerably. -

-
-
- Shading -

- By default, filled rectangles are painted using their given color using a PTOCA I-axis rule - (DIR). But not all environments handle these colors correctly. That's why a setting is - supported that paints the rectangles using an ordered dither pattern (bi-level) with - an inline IOCA FS10 image that is used together with the "replicate and trim" mapping. - The optional "shading" element can be used to control the shading mode. Its default value - is "color". To enable the dithered mode, use "dithered". Example: -

- dithered -]]> -
-
- Resource Group File -

By default the AFP Renderer will place all data resource objects such as images within - the document of the main output datastream. An external resource group file where document resources - may be specified with the <resource-group-file/> configuration element. Example:

- external_resources.afp -]]> - Be careful when using this option not to overwrite existing resource files from previous rendering runs. -
-
- Resource Level Defaults -

- By default, bitmap image objects (or page segments derived from them) are put in the - print-file-level resource group and GOCA graphics are inlined for compatibility with - the AFP Workbench tool. -

-

- It is possible to override these defaults, either per image (see the - afp:resource-level - extension attribute below) or by specifying different defaults in the configuration: -

- ]]> -

- "goca" refers to GOCA graphics and "bitmap" refers to IOCA images. The possible values - for the attributes are "inline" and "print-file". In the future, - additional possibilities may be added. -

-
-
-
- Extensions -

The AFP Renderer supports some AFP specific extensions which can be embedded into the input - fo document. To use the extensions the appropriate namespace must be declared in the fo:root element like this:

- -]]> -
- Page Overlay (IPO) Extension -

The include-page-overlay extension element allows to define on a per simple-page-master basis a page overlay resource. Example:

- - - - ... - - -]]> -

The mandatory name attribute must refer to an 8 character (space padded) resource name that - must be known in the AFP processing environment. Optional x and y attributes can be specified - to place the Overlay at an offset from the top left of the page.

-
-
- Page Segment (IPS) Extension -

The include-page-segment extension element allows to define resource substitution for fo:external-graphics elements. - Example:

- - - - - - - -]]> -

The include-page-segment extension element can only occur within a simple-page-master. - Multiple include-page-segment extension elements within a simple-page-master are allowed. - The mandatory name attribute must refer to an 8 character - (space padded) resource name that must be known in the AFP processing environment. - The value of the mandatory src attribute is compared against the value of the src attribute in - fo:external-graphic elements and if it is identical (string matching is used) in the generated - AFP the external graphic is replaced by a reference to the given resource. -

-

- The effect here is that whenever FOP encounters the URI specified in the extension, - it will effectively generate code to include the page segment with the given name - instead of embedding the image referenced by the URI. The URI is still required as - the underlying image serves as a provider for the intrinsic size of the image - (At the moment, FOP is unable to extract the intrinsic size of the page segment from - an AFP resource file). For the image to appear in an AFP viewer or to be printed, the - AFP resource must be available on the target device. FOP does not embed the page - segment in the generated file. Please also note that page segments cannot be scaled. - They are always rendered in their intrinsic size. -

-

- The include-page-segment extension element has the optional attribute - resource-file. The value of this is a URI to a resource containing a page - segment with the declared name. In this case FOP embeds the page segment into the - generated document so that the external resource does not have to be supplied in the - print job. -

-
-
- Tag Logical Element (TLE) Extension -

The tag-logical-element extension element allows to injects TLEs into the AFP output stream. Example:

- - - - - - - - [..] - - - - [..] -]]> -

- The tag-logical-element extension element can appear within a simple-page-master - (page level) or it can appear as child of page-sequence (page group level). - Multiple tag-logical-element extension elements within a simple-page-master or - page-sequence are allowed. The name and value attributes are mandatory. -

-
-
- No Operation (NOP) Extension -

The no-operation extension provides the ability to carry up to 32K of comments or any other type - of unarchitected data into the AFP output stream. Example:

- - - - insert up to 32k of character data here! - - -]]> -

The no-operation extension element can appear as child of - simple-page-master (appears after "Begin Page" BPG), - page-sequence (appears after "Begin Named Page Group" BNG - and declarations (appears after "Begin Document" BDT). - Multiple no-operation extension elements inside the same formatting object are allowed. - Each NOP will appear right after the respective "Begin" field indicated above even if it - is specified as the last child under its parent. The order inside the parent - will be maintained. - The "placement" attribute can be used to have the NOP appear before - the "End" field of the object rather than after the "Begin" field. Specify - placement="before-end" to do that. Please note that, at the moment, this only - has an effect for NOPs that are children of the page-sequence formatting - object. - The "name" attribute is mandatory but will not appear inside the AFP stream. -

-
-
- Invoke Medium Map (IMM) Extension -

- The invoke-medium-map extension allows to generate IMM fields (Invoke Medium Map) in the - generated AFP output. Example: -

- - [..] - - - - [..] -]]> -

- The invoke-medium-map element is allowed as child of fo:page-sequence (page group - level) or fo:simple-page-master. It is NOT supported on document level (fo:root), yet. - FOP also doesn't support specifying medium maps inside XML (using BMM/EMM). It can - only reference an existing medium map by name. The medium map has to be constructed - through different means and available on the target platform. -

-
-
- Form Maps/Defs -

- Apache FOP supports embedding an external form map resource in the - generated AFP output. This is done using the afp:include-form-map - extension. An example: -

- - [..] - - - -]]> -

- The afp:include-form-map is to be placed as a direct child of - fo:declarations. The name is an AFP resource name - (max. 8 characters) and the src attribute is the URI identifying the - external form map resource. When such a form map is embedded, you can use the - afp:invoke-medium-map extension (described above) to invoke any medium - map included in the form map. -

- - Apache FOP doesn't support a way to define a form map or medium map using XML means - inside an XSL-FO document. You will have to build the form map with some third-party - tool. - -
-
-
- Foreign Attributes -
- Resource -

The resource foreign attributes provides the ability to name and control where data object resources - (e.g. images/scalable vector graphics) will reside in the AFP output. - The afp foreign attributes are only used in conjuntion with <fo:external-graphic/> and <instream-foreign-object/>. - Example:

- - ... - - - - - - - - - - - - - - -]]> -

The resource-level attribute where the resource object will reside in the AFP output datastream. - The possible values for this are "inline", "print-file" and "external". - When "external" is used a resource-group-file attribute must also be specified. - Please refer to the Resource Level Defaults - above to see what is used if the resource-level attribute is not specified. -

-

-

-
-
-
- RTF -

- JFOR, an open source XSL-FO to RTF converter has been integrated into Apache FOP. - This will create an RTF (rich text format) document that will - attempt to contain as much information from the XSL-FO document as - possible. It should be noted that is not possible (due to RTF's limitations) to map all - XSL-FO features to RTF. For complex documents, the RTF output will never reach the feature - level from PDF, for example. Thus, using RTF output is only recommended for simple documents - such as letters. -

-

- The RTF output follows Microsoft's RTF specifications - and produces best results on Microsoft Word. -

- RTF output is currently unmaintained and lacks many features compared to other output - formats. Using other editable formats like Open Document Format, instead of producing XSL-FO - then RTF through FOP, might give better results. -

- These are some known restrictions compared to other supported output formats (not a complete list): -

-
    -
  • - Not supported/implemented: -
      -
    • break-before/after (supported by the RTF library but not tied into the RTFHandler)
      • -
    • fo:page-number-citation-last
      • -
    • keeps (supported by the RTF library but not tied into the RTFHandler)
      • -
    • region-start/end (RTF limitation)
      • -
    • multiple columns
      • -
    -
    • -
  • Only a single page-master is supported
    • -
  • Not all variations of fo:leader are supported (RTF limitation)
    • -
  • percentages are not supported everywhere
    • -
-
-
- XML (Area Tree XML) -

- This is primarily for testing and verification. The XML created is simply - a representation of the internal area tree put into XML. We use that to verify - the functionality of FOP's layout engine. -

-

- The other use case of the Area Tree XML is as FOP's "intermediate format". More information - on that can be found on the page dedicated to the Intermediate Format. -

-
-
- Java2D/AWT -

- The Java2DRenderer provides the basic functionality for all - Java2D-based output formats (AWT viewer, direct print, PNG, TIFF). -

-

- The AWT viewer shows a window with the pages displayed inside a - Java graphic. It displays one page at a time. - The fonts used for the formatting and viewing depend on the fonts - available to your JRE. -

-
-
- Print -

- It is possible to directly print the document from the command line. - This is done with the same code that renders to the Java2D/AWT renderer. -

- -
-
- Bitmap (TIFF/PNG) -

- It is possible to directly create bitmap images from the individual - pages generated by the layout engine. - This is done with the same code that renders to the Java2D/AWT renderer. -

-

- Currently, two output formats are supported: PNG and TIFF. TIFF produces - one file with multiple pages, while PNG output produces one file per - page. Note: FOP can only produce multiple files (with PNG output) if - you can set a java.io.File indicating the primary PNG file - using the FOUserAgent.setOutputFile(File) method. -

-

- The quality of the bitmap depends on the target resolution setting - on the FOUserAgent and on further settings described below. -

-
- Configuration -

- The TIFF and PNG renderer configuration currently allows the following settings: -

- - rgba - true - white - true - quality - -]]> -

- The default value for the "color-mode" setting is "rgba" which - is equivalent to a 24bit RGB image with an 8bit alpha channel for transparency. - Valid values are: -

-
    -
  • rgba: RGB with alpha channel (24bit + 8bit = 32bit)
    • -
  • rgb: RGB (24bit)
    • -
  • gray: gray (8bit)
    • -
  • bi-level (or binary): bi-level (1bit)
    • -
-

- Please note that there is currently no dithering or error diffusion available for bi-level - bitmap output. -

-

- The default value for the "transparent-page-background" setting is - "false" which paints an opaque, white background for the whole image. - If you set this to "true", - no such background will be painted and you will get a transparent image if - an alpha channel is available in the output format. -

-

- The default value for the "background-color" setting is "white". - The color specifies in which color the page background is painted. It will only be - painted if "transparent-page-background" is not set to "true". - All XSL-FO colors (including color functions) can be used. -

-

- The default value for the "anti-aliasing" setting is "true". - You can set this value to "false" to disable anti-aliasing and - thus improve rendering speeds a bit at the loss of some image quality. -

-

- The default value for the "rendering" setting is "true". - You can set this value to "false" to improve rendering speeds a bit - at the loss of some image quality. If this setting has an actual effect depends - on the JVM's Java2D backend. -

-
-
- TIFF-specific Configuration -

- In addition to the above values the TIFF renderer configuration allows some additional - settings: -

- - true - CCITT T.6 - -]]> -

- The default value for the "compression" setting is "PackBits" which - which is a widely supported RLE compression scheme for TIFF. The set of compression - names to be used here matches the set that the Image I/O API uses. Note that - not all compression schemes may be available during runtime. This depends on the - actual codecs being available. Here is a list of possible values: -

-
    -
  • NONE (no compression)
    • -
  • PackBits (RLE, run-length encoding)
    • -
  • JPEG
    • -
  • Deflate
    • -
  • LZW
    • -
  • ZLib
    • -
  • CCITT T.4 (Fax Group 3)
    • -
  • CCITT T.6 (Fax Group 4)
    • -
-

- This setting may override any setting made using the "color-mode". For example, if - "CCITT T.6" is selected, the color mode is automatically forced to "bi-level" because - this compression format only supports bi-level images. -

- - If you want to use CCITT compression, please make sure you've got - - Java Advanced Imaging Image I/O Tools - - in your classpath. The Sun JRE doesn't come with a TIFF codec built in, so it has to be - added separately. The internal TIFF codec from XML Graphics Commons only supports PackBits, - Deflate and JPEG compression for writing. - -
-
- Runtime Rendering Options -

- The IF-based bitmap output implementations support a rendering option with the key - "target-bitmap-size" (value: java.awt.Dimension) that allows to force the pages to - be proportionally fit into a bitmap of a given size. This can be used to produce - thumbnails or little preview images of the individual pages. An example: -

- -
-
-
- TXT -

- The text renderer produces plain ASCII text output - that attempts to match the output of the PDFRenderer as closely as - possible. This was originally developed to accommodate an archive system - that could only accept plain text files, and is primarily useful for getting - a quick-and-dirty view of the document text. The renderer is very limited, - so do not be surprised if it gives unsatisfactory results. -

- -

- Because FOP lays the text onto a grid during layout, there are frequently - extra or missing spaces between characters and lines, which is generally - unsatisfactory. - Users have reported that the optimal settings to avoid such spacing problems are: -

-
    -
  • font-family="Courier"
    • -
  • font-size="10pt"
    • -
  • line-height="10pt"
    • -
-
-
- Output Formats in the Sandbox -

- Due to the state of certain renderers we moved some of them to a "sandbox" area until - they are ready for more serious use. The renderers and FOEventHandlers in the sandbox - can be found under src/sandbox and are compiled into build/fop-sandbox.jar during the - main build. The output formats in the sandbox are marked as such below. -

-
- MIF - The MIF handler is in the sandbox and not yet functional in FOP Trunk!!! Please help us ressurrect this feature. -

- This format is the Maker Interchange Format which is used by - Adobe Framemaker. -

-
-
- SVG - The SVG renderer is in the sandbox and may not work as expected in FOP Trunk!!! Please help us improve this feature. -

- This format creates an SVG document that has links between the pages. - This is primarily for slides and creating svg images of pages. - Large documents will create SVG files that are far too large for - an SVG viewer to handle. Since FO documents usually have text the - SVG document will have a large number of text elements. - The font information for the text is obtained from the JVM in the - same way as for the AWT viewer. If the SVG is viewed on a - system where the fonts are different, such as another platform, - then the page may look wrong. -

-
-
-
- Wish list -

- Apache FOP is easily extensible and allows you to add new output formats to enhance FOP's functionality. There's a number of output formats - which are on our wish list. We're looking for volunteers to help us implement them. -

- -
- - - diff --git a/src/documentation/content/xdocs/1.1/pdfa.xml b/src/documentation/content/xdocs/1.1/pdfa.xml deleted file mode 100644 index 0b8399121..000000000 --- a/src/documentation/content/xdocs/1.1/pdfa.xml +++ /dev/null @@ -1,168 +0,0 @@ - - - - - -
- Apache™ FOP: PDF/A (ISO 19005) - $Revision$ - - - -
- -
- Overview -

- PDF/A is a standard which turns PDF into an "electronic document file - format for long-term preservation". PDF/A-1 is the first part of the - standard and is documented in - ISO 19005-1:2005(E). - Work on PDF/A-2 is in progress at - AIIM. -

-

- Design documentation on PDF/A can be found on FOP's Wiki on the - PDFA1ConformanceNotes page. -

-
-
- Implementation Status -

- PDF/A-1b is implemented to the degree that FOP supports - the creation of the elements described in ISO 19005-1. -

-

- Tests have been performed against jHove and Adobe Acrobat 7.0.7 (Preflight function). - FOP does not validate completely against Apago's PDF Appraiser. Reasons unknown due to - lack of a full license to get a detailed error protocol. -

-

- PDF/A-1a is based on PDF-A-1b and adds accessibility features - (such as Tagged PDF). This format is available within the limitation described on - the Accessibility page. -

-
-
- Usage (command line) -

- To activate PDF/A-1b from the command-line, specify "-pdfprofile PDF/A-1b" - as a parameter. If there is a violation of one of the validation rules for - PDF/A, an error message is presented and the processing stops. -

-

- PDF/A-1a is enabled by specifying "-pdfprofile PDF/A-1a". -

-
-
- Usage (embedded) -

- When FOP is embedded in another Java application you can set a special option - on the renderer options in the user agent to activate the PDF/A-1b profile. - Here's an example: -

- -

- If one of the validation rules of PDF/A is violated, an PDFConformanceException - (descendant of RuntimeException) is thrown. -

-

- For PDF/A-1a, just use the string "PDF/A-1a" instead of "PDF/A-1b". -

-
-
- PDF/A in Action -

- There are a number of things that must be looked after if you activate a PDF/A - profile. If you receive a PDFConformanceException, have a look at the following - list (not necessarily comprehensive): -

-
    -
  • - Make sure all (!) fonts are embedded. If you use base 14 fonts (like Helvetica) - you need to obtain a license for them and embed them like any other font. -
    • -
  • - Don't use PDF encryption. PDF/A doesn't allow it. -
    • -
  • - Don't use CMYK images without an ICC color profile. PDF/A doesn't allow mixing - color spaces and FOP currently only properly supports the sRGB color space. Please - note that FOP embeds a standard sRGB ICC profile (sRGB IEC61966-2.1) as the - primary output intent for the PDF if no other output intent has been specified - in the configuration. -
    • -
  • - Don't use non-RGB colors in SVG images. Same issue as with CMYK images. -
    • -
  • - Don't use EPS graphics with fo:external-graphic. Embedding EPS graphics in PDF - is deprecated since PDF 1.4 and prohibited by PDF/A. -
    • -
  • - PDF is forced to version 1.4 if PDF/A-1 is activated. -
    • -
  • - No filter must be specified explicitely for metadata objects. Metadata must be - embedded in clear text so non-PDF-aware applications can extract the XMP metadata. -
    • -
- - There are additional requirements if you want to enabled PDF/A-1a (Tagged PDF). This is - particularly the specification of the natural language and alternative descriptions for - images. Please refer to the Accessibility page for details. - -
-
- PDF profile compatibility -

- The PDF profiles "PDF/X-3:2003" and "PDF/A-1b" (or "PDF/A-1a") are compatible and can - both be activated at the same time. -

-
-
- Interoperability -

- There has been some confusion about the namespace for the PDF/A indicator in the XMP - metadata. At least three variants have been seen in the wild: -

- - - - - - - - - - - - - -
http://www.aiim.org/pdfa/ns/id.htmlobsolete, from an early draft of ISO-19005-1, used by Adobe Acrobat 7.x
http://www.aiim.org/pdfa/ns/idobsolete, found in the original ISO 19005-1:2005 document
http://www.aiim.org/pdfa/ns/id/correct, found in the technical corrigendum 1 of ISO 19005-1:2005
-

- If you get an error validating a PDF/A file in Adobe Acrobat 7.x it doesn't mean that - FOP did something wrong. It's Acrobat that is at fault. This is fixed in Adobe Acrobat 8.x - which uses the correct namespace as described in the technical corrigendum 1. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/pdfencryption.xml b/src/documentation/content/xdocs/1.1/pdfencryption.xml deleted file mode 100644 index 2d8fdfb10..000000000 --- a/src/documentation/content/xdocs/1.1/pdfencryption.xml +++ /dev/null @@ -1,301 +0,0 @@ - - - - - -
- Apache™ FOP: PDF encryption. - $Revision$ - - - - -
- -
- Overview -

- Apache™ FOP supports encryption of PDF output, thanks to Patrick - C. Lankswert. This feature is commonly used to prevent - unauthorized viewing, printing, editing, copying text from the - document and doing annotations. It is also possible to ask the - user for a password in order to view the contents. Note that - there already exist third party applications which can decrypt - an encrypted PDF without effort and allow the aforementioned - operations, therefore the degree of protection is limited. -

-

- For further information about features and restrictions regarding PDF - encryption, look at the documentation coming with Adobe Acrobat or the - technical documentation on the Adobe web site. -

-
-
- Usage (command line) -

- Encryption is enabled by supplying any of the encryption related - options. -

-

- An owner password is set with the -o option. This - password is actually used as encryption key. Many tools for - PDF processing ask for this password to disregard any - restriction imposed on the PDF document. -

-

- If no owner password has been supplied but FOP was asked to apply some - restrictions, a random password is used. In this case it is obviously - impossiible to disregard restrictions in PDF processing tools. -

-

- A user password, supplied with the -u option, will - cause the PDF display software to ask the reader for this password in - order to view the contents of the document. If no user password was - supplied, viewing the content is not restricted. -

-

- Further restrictions can be imposed by using the following command-line options: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OptionDescription
-noprintdisable printing
-nocopydisable copy/paste of content
-noeditdisable editing in Adobe Acrobat
-noannotationsdisable editing of annotations
-nofillinformsdisable filling in forms
-noaccesscontentdisable text and graphics extraction for accessibility purposes
-noassembledocdisable assembling documents
-noprinthqdisable high quality printing
-

-
-
- Usage (embedded) -

- When FOP is embedded in another Java application you need to set an - options map on the renderer. These are the supported options: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OptionDescriptionValuesDefault
encryption-lengthThe encryption length in bitAny multiple of 8 between 40 and 12840
ownerPasswordThe owner passwordString -
userPasswordThe user passwordString -
allowPrintAllows/disallows printing of the PDF"TRUE" or "FALSE""TRUE"
allowCopyContentAllows/disallows copy/paste of content"TRUE" or "FALSE""TRUE"
allowEditContentAllows/disallows editing in Adobe Acrobat"TRUE" or "FALSE""TRUE"
allowEditAnnotationsAllows/disallows editing of annotations"TRUE" or "FALSE""TRUE"
allowFillInFormsAllows/disallows filling in forms"TRUE" or "FALSE""TRUE"
allowAccessContentAllows/disallows text and graphics extraction for accessibility purposes"TRUE" or "FALSE""TRUE"
allowAssembleDocumentAllows/disallows assembling document"TRUE" or "FALSE""TRUE"
allowPrintHqAllows/disallows high quality printing"TRUE" or "FALSE""TRUE"
- - Encryption is enabled as soon as one of these options is set. - -

- An example to enable PDF encryption in Java code: -

- -

- The parameters for the constructor of PDFEncryptionParams are: -

-
    -
  1. userPassword: String, may be null
    2. -
  2. ownerPassword: String, may be null
    3. -
  3. allowPrint: true if printing is allowed
    4. -
  4. allowCopyContent: true if copying content is allowed
    5. -
  5. allowEditContent: true if editing content is allowed
    6. -
  6. allowEditAnnotations: true if editing annotations is allowed
    7. -
  7. allowFillInForms: true if filling in forms is allowed.
    8. -
  8. allowAccessContent: true if extracting text and graphics is allowed
    9. -
  9. allowAssembleDocument: true if assembling document is allowed
    10. -
  10. allowPrintHq: true if printing to high quality is allowed
    11. -
-

- Alternatively, you can set each value separately in the Map provided by - FOUserAgent.getRendererOptions() by using the following keys: -

-
    -
  1. user-password: String
    2. -
  2. owner-password: String
    3. -
  3. noprint: Boolean or "true"/"false"
    4. -
  4. nocopy: Boolean or "true"/"false"
    5. -
  5. noedit: Boolean or "true"/"false"
    6. -
  6. noannotations: Boolean or "true"/"false"
    7. -
  7. nofillinforms: Boolean or "true"/"false"
    8. -
  8. noaccesscontent: Boolean or "true"/"false"
    9. -
  9. noassembledoc: Boolean or "true"/"false"
    10. -
  10. noprinthq: Boolean or "true"/"false"
    11. -
-
-
- Environment -

- In order to use PDF encryption, FOP has to be compiled with - cryptography support. Currently, only JCE - is supported. JCE is part of JDK 1.4. For earlier JDKs, it can - be installed separately. The build process automatically - detects JCE presence and installs PDF encryption support if - possible, otherwise a stub is compiled in. -

-

- Cryptography support must also be present at run time. In particular, a - provider for the RC4 cipher is needed. Unfortunately, the sample JCE - provider in Sun's JDK 1.4 does not provide RC4. If you - get a message saying -

- "Cannot find any provider supporting RC4" -

- then you don't have the needed infrastructure. -

-

- There are several commercial and a few Open Source packages which - provide RC4. A pure Java implementation is produced by The Legion of the Bouncy - Castle. Mozilla - JSS is an interface to a native implementation. -

-
-
- Installing a crypto provider -

- The pure Java implementation from Bouncy Castle is easy to - install. -

-
    -
  1. - Download the binary distribution for your JDK version. -
    2. -
  2. - Unpack the distribution. Add the jar file to your classpath. A - convenient way to use the jar on Linux is to simply drop it into the - FOP lib directory, it will be automatically picked up by - fop.sh. -
    3. -
  3. - Open the java.security file and add
    - security.provider.6=org.bouncycastle.jce.provider.BouncyCastleProvider,
    - preferably at the end of the block defining the other crypto - providers. For JDK 1.4 this is detailed on Sun's web site. -
    4. -
-

- If you have any experience with Mozilla JSS or any other - cryptography provider, please post it to the fop-user list. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/pdfx.xml b/src/documentation/content/xdocs/1.1/pdfx.xml deleted file mode 100644 index bef2fce2a..000000000 --- a/src/documentation/content/xdocs/1.1/pdfx.xml +++ /dev/null @@ -1,136 +0,0 @@ - - - - - -
- Apache™ FOP: PDF/X (ISO 15930) - $Revision$ - - - -
- -
- Overview - - Support for PDF/X is available beginning with version 0.93. This feature is new and - may not be 100% complete, yet. Feedback is welcome. - -

- PDF/X is a standard which faciliates prepress digital data exchange using PDF. - Currently, only PDF/X-3:2003 is implemented out of the many different flavours of PDF/X - profiles. PDF/X-3:2003 is documented in - ISO 15930-6:2003(E). - More info on PDF/X can be found on the - PDF/X info site. -

-
-
- Implementation Status -

- PDF/X-3:2003 is implemented to the degree that FOP supports - the creation of the elements described in ISO 15930-6. -

-

- An important restriction of the current implementation is that all normal - RGB colors specified in XSL-FO and SVG are left unchanged in the sRGB color - space (XSL-FO and SVG both use sRGB as their default color space). - There's no conversion to a CMYK color space. Although sRGB is a - calibrated color space, its color space has a different size than a CMYK - color space which makes the conversion a lossy conversion and can lead to - unwanted results. Although the use of the calibrated sRGB has been promoted - for years, print shops usually prefer to convert an sRGB PDF to CMYK prior - to production. Until there's full CMYK support in FOP you will have to - work closely with your print service provider to make sure you get the - intended result. -

-

- Tests have been performed against Adobe Acrobat 7.0.7 (Preflight function). - Note that there are bugs in Adobe Acrobat which cause false alarms if both - PDF/A-1b and PDF/X-3:2003 are activated at the same time. -

-
-
- Usage (command line) -

- To activate PDF/X-3:2003 from the command-line, specify "-pdfprofile PDF/X-3:2003" - as a parameter. If there is a violation of one of the validation rules for - PDF/X, an error message is presented and the processing stops. -

-
-
- Usage (embedded) -

- When FOP is embedded in another Java application you can set a special option - on the renderer options in the user agent to activate the PDF/A-1b profile. - Here's an example: -

- -

- If one of the validation rules of PDF/X is violated, an PDFConformanceException - (descendant of RuntimeException) is thrown. -

-
-
- PDF/X in Action -

- There are a number of things that must be looked after if you activate a PDF/X - profile. If you receive a PDFConformanceException, have a look at the following - list (not necessarily comprehensive): -

-
    -
  • - Make sure all (!) fonts are embedded. If you use base 14 fonts (like Helvetica) - you need to obtain a license for them and embed them like any other font. -
    • -
  • - Don't use PDF encryption. PDF/X doesn't allow it. -
    • -
  • - Don't use CMYK images without an ICC color profile. PDF/X doesn't allow mixing - color spaces and FOP currently only properly supports the sRGB color space. However, - you will need to specify an - output device profile - (usually a CMYK profile) in the configuration. sRGB won't work here since it's a - display device profile, not an output device profile. -
    • -
  • - Don't use non-RGB colors in SVG images. Same issue as with CMYK images. -
    • -
  • - Don't use EPS graphics with fo:external-graphic. Embedding EPS graphics in PDF - is deprecated since PDF 1.4 and prohibited by PDF/X-3:2003. -
    • -
  • - PDF is forced to version 1.4 if PDF/X-3:2003 is activated. -
    • -
-
-
- PDF profile compatibility -

- The PDF profiles "PDF/X-3:2003" and "PDF/A-1b" are compatible and can both be - activated at the same time. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/running.xml b/src/documentation/content/xdocs/1.1/running.xml deleted file mode 100644 index 5e30bb25e..000000000 --- a/src/documentation/content/xdocs/1.1/running.xml +++ /dev/null @@ -1,370 +0,0 @@ - - - - - -
- Running Apache™ FOP - $Revision$ -
- - -
- System Requirements -

The following software must be installed:

-
    -
  • - Java 1.4.x or later Runtime Environment. -
      -
    • - Many JREs >=1.4 contain older JAXP implementations (which often contain bugs). It's - usually a good idea to replace them with a current implementation. -
      • -
    -
    • -
  • - Apache™ FOP. The FOP distribution includes all libraries that you will - need to run a basic FOP installation. These can be found in the [fop-root]/lib directory. These - libraries include the following: - -
    • -
-

The following software is optional, depending on your needs:

-
    -
  • - Graphics libraries. Generally, FOP contains direct support for the most important - bitmap image formats (including PNG, JPEG and GIF). See - FOP: Graphics Formats for details. -
    • -
  • - PDF encryption. See FOP: PDF Encryption for details. -
    • -
-

In addition, the following system requirements apply:

-
    -
  • - If you will be using FOP to process SVG, you must do so in a graphical environment. - See FOP: Graphics (Batik) for details. -
    • -
-
-
- Installation -
- Instructions -

- Basic FOP installation consists of first unzipping the .gz file that is the - distribution medium, then unarchiving the resulting .tar file in a - directory/folder that is convenient on your system. Please consult your operating system - documentation or Zip application software documentation for instructions specific to your - site. -

-
-
- Problems -

- Some Mac OSX users have experienced filename truncation problems using Stuffit to unzip - and unarchive their distribution media. This is a legacy of older Mac operating systems, - which had a 31-character pathname limit. Several Mac OSX users have recommended that - Mac OSX users use the shell command tar -xzf instead. -

-
-
-
- Starting FOP as a Standalone Application -
- Using the fop script or batch file -

- The usual and recommended practice for starting FOP from the command line is to run the - batch file fop.bat (Windows) or the shell script fop (Unix/Linux). - These scripts require that the environment variable JAVA_HOME be - set to a path pointing to the appropriate Java installation on your system. Macintosh OSX - includes a Java environment as part of its distribution. We are told by Mac OSX users that - the path to use in this case is /Library/Java/Home. Caveat: - We suspect that, as Apple releases new Java environments and as FOP upgrades the minimum - Java requirements, the two will inevitably not match on some systems. Please see - Java on Mac OSX FAQ for information as - it becomes available. -

- - [OPTIONS] - -version print FOP version and exit - -d debug mode - -x dump configuration settings - -q quiet mode - -c cfg.xml use additional configuration file cfg.xml - -l lang the language to use for user information - -nocs disable complex script features - -r relaxed/less strict validation (where available) - -dpi xxx target resolution in dots per inch (dpi) where xxx is a number - -s for area tree XML, down to block areas only - -v run in verbose mode (currently simply print FOP version and continue) - - -o [password] PDF file will be encrypted with option owner password - -u [password] PDF file will be encrypted with option user password - -noprint PDF file will be encrypted without printing permission - -nocopy PDF file will be encrypted without copy content permission - -noedit PDF file will be encrypted without edit content permission - -noannotations PDF file will be encrypted without edit annotation permission - -nofillinforms PDF file will be encrypted without fill in forms permission - -noaccesscontent PDF file will be encrypted without extract text and graphics permission - -noassembledoc PDF file will be encrypted without assemble the document permission - -noprinthq PDF file will be encrypted without print high quality permission - -a enables accessibility features (Tagged PDF etc., default off) - -pdfprofile prof PDF file will be generated with the specified profile - (Examples for prof: PDF/A-1b or PDF/X-3:2003) - - -conserve enable memory-conservation policy (trades memory-consumption for disk I/O) - (Note: currently only influences whether the area tree is serialized.) - - -cache specifies a file/directory path location - -flush flushes the current font cache file - - [INPUT] - infile xsl:fo input file (the same as the next) - (use '-' for infile to pipe input from stdin) - -fo infile xsl:fo input file - -xml infile xml input file, must be used together with -xsl - -atin infile area tree input file - -ifin infile intermediate format input file - -imagein infile image input file (piping through stdin not supported) - -xsl stylesheet xslt stylesheet - - -param name value to use for parameter in xslt stylesheet - (repeat '-param name value' for each parameter) - - -catalog use catalog resolver for input XML and XSLT files - [OUTPUT] - outfile input will be rendered as PDF into outfile - (use '-' for outfile to pipe output to stdout) - -pdf outfile input will be rendered as PDF (outfile req'd) - -pdfa1b outfile input will be rendered as PDF/A-1b compliant PDF - (outfile req'd, same as "-pdf outfile -pdfprofile PDF/A-1b") - -awt input will be displayed on screen - -rtf outfile input will be rendered as RTF (outfile req'd) - -pcl outfile input will be rendered as PCL (outfile req'd) - -ps outfile input will be rendered as PostScript (outfile req'd) - -afp outfile input will be rendered as AFP (outfile req'd) - -tiff outfile input will be rendered as TIFF (outfile req'd) - -png outfile input will be rendered as PNG (outfile req'd) - -txt outfile input will be rendered as plain text (outfile req'd) - -at [mime] out representation of area tree as XML (outfile req'd) - specify optional mime output to allow the AT to be converted - to final format later - -if [mime] out representation of document in intermediate format XML (outfile req'd) - specify optional mime output to allow the IF to be converted - to final format later - -print input file will be rendered and sent to the printer - see options with "-print help" - -out mime outfile input will be rendered using the given MIME type - (outfile req'd) Example: "-out application/pdf D:\out.pdf" - (Tip: "-out list" prints the list of supported MIME types) - -svg outfile input will be rendered as an SVG slides file (outfile req'd) - Experimental feature - requires additional fop-sandbox.jar. - - -foout outfile input will only be XSL transformed. The intermediate - XSL-FO file is saved and no rendering is performed. - (Only available if you use -xml and -xsl parameters) - - - [Examples] - fop foo.fo foo.pdf - fop -fo foo.fo -pdf foo.pdf (does the same as the previous line) - fop -xml foo.xml -xsl foo.xsl -pdf foo.pdf - fop -xml foo.xml -xsl foo.xsl -foout foo.fo - fop -xml - -xsl foo.xsl -pdf - - fop foo.fo -mif foo.mif - fop foo.fo -rtf foo.rtf - fop foo.fo -print - fop foo.fo -awt]]> -

- PDF encryption is only available if FOP was compiled with encryption support - and if compatible encryption support is available at run time. - Currently, only the JCE is supported. Check the Details. -

-
-
- Writing your own script -

FOP's entry point for your own scripts is the class -org.apache.fop.cli.Main. The general pattern for the - command line is: java -classpath <CLASSPATH> - org.apache.fop.cli.Main <arguments>. The arguments - consist of the options and infile and outfile specifications - as shown above for the standard scripts. You may wish to review - the standard scripts to make sure that - you get your environment properly configured. -

-
-
- Running with java's <code>-jar</code> option -

- As an alternative to the start scripts you can run java - -jar path/to/build/fop.jar <arguments>, relying on - FOP to build the classpath for running FOP dynamically, see below. If you use hyphenation, - you must put fop-hyph.jar in the lib - directory. -

- -

You can also run java -jar path/to/fop.jar - <arguments>, relying on the Class-Path - entry in the manifest file. This works if you put - fop.jar and all jar files from the lib - directory in a single directory. If you use hyphenation, you - must also put fop-hyph.jar in that directory.

- -

In both cases the arguments consist of the options and - infile and outfile specifications as shown above for the - standard scripts.

-
-
- FOP's dynamical classpath construction - -

If FOP is started without a proper classpath, it tries to - add its dependencies dynamically. If the system property - fop.home contains the name of a directory, then - FOP uses that directory as the base directory for its - search. Otherwise the current working directory is the base - directory. If the base directory is called build, - then its parent directory becomes the base directory.

- -

FOP expects to find fop.jar in the - build subdirectory of the base directory, and - adds it to the classpath. Subsequently FOP adds all - jar files in the lib directory to the - classpath. The lib directory is either the lib - subdirectory of the base directory, or, if that does not - exist, the base directory itself.

- -

If the system property fop.optional.lib - contains the name of a directory, then all jar - files in that directory are also added to the classpath. See - the methods getJARList and - checkDependencies in - org.apache.fop.cli.Main.

- -
-
-
- Using Xalan to Check XSL-FO Input -

- FOP sessions that use -xml and -xsl input instead of -fo input are actually - controlling two distinct conversions: Tranforming XML to XSL-FO, then formatting - the XSL-FO to PDF (or another FOP output format). - Although FOP controls both of these processes, the first is included merely as - a convenience and for performance reasons. - Only the second is part of FOP's core processing. - If a user has a problem running FOP, it is important to determine which of these - two processes is causing the problem. - If the problem is in the first process, the user's stylesheet is likely the cause. - The FOP development team does not have resources to help with stylesheet issues, - although we have included links to some useful - Specifications and - Books/Articles. - If the problem is in the second process, FOP may have a bug or an unimplemented - feature that does require attention from the FOP development team. -

- The user is always responsible to provide correct XSL-FO code to FOP. -

- In the case of using -xml and -xsl input, although the user is responsible for - the XSL-FO code that is FOP's input, it is not visible to the user. To make the - intermediate FO file visible, the FOP distribution includes the "-foout" option - which causes FOP to run only the first (transformation) step, and write the - results to a file. (See also the Xalan command-line below) -

- - When asking for help on the FOP mailing lists, never attach XML and - XSL to illustrate the issue. Always run the XSLT step (-foout) and send the - resulting XSL-FO file instead. Of course, be sure that the XSL-FO file is - correct before sending it. - -

- The -foout option works the same way as if you would call the - Xalan command-line: -

-

- java org.apache.xalan.xslt.Process -IN xmlfile -XSL file -OUT outfile -

-

- Note that there are some subtle differences between the FOP and Xalan command-lines. -

-
-
- Memory Usage -

- FOP can consume quite a bit of memory, even though this has been continually improved. - This is partly inherent to the formatting process and partly caused by implementation choices. - All FO processors currently on the market have memory problems with certain layouts. -

-

- If you are running out of memory when using FOP, here are some ideas that may help: -

-
    -
  • - Increase memory available to the JVM. See - the -Xmx option - for more information. - - It is usually unwise to increase the memory allocated to the JVM beyond the amount of - physical RAM, as this will generally cause significantly slower performance. - -
    • -
  • - Avoid forward references. - Forward references are references to some later part of a document. - Examples include page number citations which refer to pages which follow the citation, - tables of contents at the beginning of a document, and page numbering schemes that - include the total number of pages in the document - ("page N of TOTAL"). - Forward references cause all subsequent pages to be held in memory until the reference - can be resolved, i.e. until the page with the referenced element is encountered. - Forward references may be required by the task, but if you are getting a memory - overflow, at least consider the possibility of eliminating them. - A table of contents could be replaced by PDF bookmarks instead or moved to the end of - the document (reshuffle the paper could after printing). -
    • -
  • - Avoid large images, especially if they are scaled down. - If they need to be scaled, scale them in another application upstream from FOP. - For many image formats, memory consumption is driven mainly by the size of the image - file itself, not its dimensions (width*height), so increasing the compression rate - may help. -
    • -
  • - Use multiple page sequences. - FOP starts rendering after the end of a page sequence is encountered. - While the actual rendering is done page-by-page, some additional memory is - freed after the page sequence has been rendered. - This can be substantial if the page sequence contains lots of FO elements. -
    • -
-
-
- Problems -

If you have problems running FOP, please see the "How to get Help" page.

-
- - diff --git a/src/documentation/content/xdocs/1.1/servlets.xml b/src/documentation/content/xdocs/1.1/servlets.xml deleted file mode 100644 index dd2df4351..000000000 --- a/src/documentation/content/xdocs/1.1/servlets.xml +++ /dev/null @@ -1,325 +0,0 @@ - - - - - -
- Apache™ FOP: Servlets - How to use Apache™ FOP in a Servlet - $Revision$ -
- -
- Overview -

- This page discusses topic all around using Apache™ FOP in a servlet environment. -

-
-
- Example Servlets in the FOP distribution -

- In the directory {fop-dir}/src/java/org/apache/fop/servlet, you'll find a working example - of a FOP-enabled servlet. -

-

- The servlet is automatically built when you build Apache FOP using the supplied Ant script. After building - the servlet, drop fop.war into the webapps directory of Apache Tomcat (or any other web container). Then, you can use - URLs like the following to generate PDF files: -

-
    -
  • http://localhost:8080/fop/fop?fo=/home/path/to/fofile.fo
    • -
  • http://localhost:8080/fop/fop?xml=/home/path/to/xmlfile.xml&xsl=/home/path/to/xslfile.xsl
    • -
-

-

The source code for the servlet can be found under {fop-dir}/src/java/org/apache/fop/servlet/FopServlet.java.

- - This example servlet should not be used on a public web server connected to the Internet as it does not contain - any measures to prevent Denial-of-Service-Attacks. It is provided as an example and as a starting point for - your own servlet. - -
-
- Create your own Servlet - - This section assumes you are familiar with embedding FOP. - -
- A minimal Servlet -

- Here is a minimal code snippet to demonstrate the basics: -

- private FopFactory fopFactory = FopFactory.newInstance(); -private TransformerFactory tFactory = TransformerFactory.newInstance(); - -public void doGet(HttpServletRequest request, - HttpServletResponse response) throws ServletException { - try { - response.setContentType("application/pdf"); - Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, response.getOutputStream()); - Transformer transformer = tFactory.newTransformer(); - Source src = new StreamSource("foo.fo"); - Result res = new SAXResult(fop.getDefaultHandler()); - transformer.transform(src, res); - } catch (Exception ex) { - throw new ServletException(ex); - } -} - - There are numerous problems with the code snippet above. - Its purpose is only to demonstrate the basic concepts. - See below for details. - -
-
- Adding XSL tranformation (XSLT) -

- A common requirement is to transform an XML source to - XSL-FO using an XSL transformation. It is recommended to use - JAXP for this task. The following snippet shows the basic - code: -

- private FopFactory fopFactory = FopFactory.newInstance(); -private TransformerFactory tFactory = TransformerFactory.newInstance(); - -public void init() throws ServletException { - //Optionally customize the FopFactory and TransformerFactory here -} - -[..] - - //Setup a buffer to obtain the content length - ByteArrayOutputStream out = new ByteArrayOutputStream(); - - //Setup FOP - Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, out); - - //Setup Transformer - Source xsltSrc = new StreamSource(new File("foo-xml2fo.xsl")); - Transformer transformer = tFactory.newTransformer(xsltSrc); - - //Make sure the XSL transformation's result is piped through to FOP - Result res = new SAXResult(fop.getDefaultHandler()); - - //Setup input - Source src = new StreamSource(new File("foo.xml")); - - //Start the transformation and rendering process - transformer.transform(src, res); - - //Prepare response - response.setContentType("application/pdf"); - response.setContentLength(out.size()); - - //Send content to Browser - response.getOutputStream().write(out.toByteArray()); - response.getOutputStream().flush(); - - Buffering the generated PDF in a ByteArrayOutputStream is done to avoid potential - problems with the Acrobat Reader Plug-in in Microsoft Internet Explorer. - -

- The Source instance used above is simply an - example. If you have to read the XML from a string, supply - a new StreamSource(new - StringReader(xmlstring)). Constructing and reparsing - an XML string is generally less desirable than using a - SAXSource if you generate your XML. You can alternatively - supply a DOMSource as well. You may also use dynamically - generated XSL if you like. -

-

- Because you have an explicit Transformer object, you can also use it to - explicitely set parameters for the transformation run. -

-
-
- Custom configuration -

- You can easily set up your own FOUserAgent as demonstrated on the Embedding page. -

-
-
- Improving performance -

- There are several options to consider: -

-
    -
  • - Instead of java.io.ByteArrayOutputStream consider using the ByteArrayOutputStream - implementation from the Jakarta Commons IO project which allocates less memory. - The full class name is: org.apache.commons.io.output.ByteArrayOutputStream -
    • -
  • - In certain cases it can help to write the generated PDF to a temporary file so - you can quickly reuse the file. This is especially useful, if Internet Explorer - calls the servlet multiple times with the same request or if you often generate - equal PDFs. -
    • -
-

- Of course, the - performance hints from the Embedding page - apply here, too. -

-
-
- Accessing resources in your web application -

- Often, you will want to use resources (stylesheets, images etc.) which are bundled with - your web application. FOP provides a URIResolver implementation that lets you access - files via the Servlet's ServletContext. The class is called - org.apache.fop.servlet.ServletContextURIResolver. -

-

- Here's how to set it up in your servlet. Instantiate a new instance in the servlet's - init() method: -

- -

- The ServletContextURIResolver reacts on URIs beginning with "servlet-context:". If you - want to access an image in a subdirectory of your web application, you could, for - example, use: "servlet-context:/images/myimage.png". Don't forget the leading slash - after the colon! -

-

- Further down, you can use the URIResolver for various things: -

-
    -
  • - With the Transformer (JAXP/XSLT) so things like document() functions can resolver - "servlet-context:" URIs. -
    • -
  • - With the FopFactory so every resource FOP loads can be loaded using a "servlet-context:" - URI. -
    • -
  • - You can the ServletContextURIResolver yourself in your servlet code to access - stylesheets or XML files bundled with your web application. -
    • -
-

- Here are some example snippets: -

- -
-
-
- Notes on Microsoft Internet Explorer -

- Some versions of Internet Explorer will not automatically show the PDF or call the servlet multiple times. - These are well-known limitations of Internet Explorer and are not a problem of the servlet. - However, Internet Explorer can still be used to download the PDF so that it can be viewed later. - Here are some suggestions in this context: -

-
    -
  • - Use an URL ending in .pdf, like - http://myserver/servlet/stuff.pdf. Yes, the servlet can - be configured to handle this. If the URL has to contain parameters, - try to have both the base URL as well as the last parameter end in - .pdf, if necessary append a dummy parameter, like - http://myserver/servlet/stuff.pdf?par1=a&par2=b&d=.pdf. The - effect may depend on IEx version. -
    • -
  • - Give IEx the opportunity to cache. In particular, ensure the - server does not set any headers causing IEx not to cache the - content. This may be a real problem if the document is sent - over HTTPS, because most IEx installations will by default - not cache any content retrieved over HTTPS. - Setting the Expires header entry may help in - this case:
    response.setDateHeader("Expires", - System.currentTimeMillis() + cacheExpiringDuration * - 1000);
    Consult your server manual and the - relevant RFCs for further details on HTTP headers and - caching. -
    • -
  • - Cache in the server. It may help to include a parameter in - the URL which has a timestamp as the value min order to - decide whether a request is repeated. IEx is reported to - retrieve a document up to three times, but never more often. -
    • -
-
-
- Servlet Engines -

- When using a servlet engine, there are potential CLASSPATH issues, and potential conflicts - with existing XML/XSLT libraries. Servlet containers also often use their own classloaders - for loading webapps, which can cause bugs and security problems. -

-
- Tomcat -

- Check Tomcat's documentation for detailed instructions about installing FOP and Cocoon. - There are known bugs that must be addressed, particularly for Tomcat 4.0.3. -

-
-
- WebSphere 3.5 -

- Put a copy of a working parser in some directory where WebSphere can access it. - For example, if /usr/webapps/yourapp/servlets is the CLASSPATH for your servlets, - copy the Xerces jar into it (any other directory would also be fine). - Do not add the jar to the servlet CLASSPATH, but add it to the CLASSPATH of the - application server which contains your web application. - In the WebSphere administration console, click on the "environment" button in the - "general" tab. In the "variable name" box, enter "CLASSPATH". - In the "value" box, enter the correct path to the parser jar file - (/usr/webapps/yourapp/servlets/Xerces.jar in our example here). - Press "OK", then apply the change and restart the application server. -

-
-
-
- Handling complex use cases -

- Sometimes the requirements for a servlet get quite sophisticated: SQL data sources, - multiple XSL transformations, merging of several datasources etc. In such a case - consider using Apache Cocoon instead - of a custom servlet to accomplish your goal. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/1.1/upgrading.xml b/src/documentation/content/xdocs/1.1/upgrading.xml deleted file mode 100644 index 1e2136a06..000000000 --- a/src/documentation/content/xdocs/1.1/upgrading.xml +++ /dev/null @@ -1,181 +0,0 @@ - - - - - -
- Upgrading from an Earlier Version of Apache™ FOP - $Revision$ -
- -
- Upgrading from Version 1.0 -

- You should encounter very few issues in upgrading from FOP 1.0, except as noted in the following: -

-
    -
  • - The intermediate format (IF) output format has underwent minor modification as follows: -
      -
    • - In order to track changes to the IF format, a version attribute has been added to the root - document element. Since no version information was provided previously, the initial - value of this attribute is 2.0. Future backward compatible changes will update the minor - version number, while future non-backward compatible changes will update the major version number. -
      • -
    • - On the text element, a new alternate representation is used for adjustments to glyph positions as expressed by a dp - attribute instead of the dx attribute. For further information, see - complex - script patch - intermediate format changes. -
      • -
    • - On the border-rect element, the attributes {before, after, start, end} - have been renamed to {top, bottom, left, right}, respectively. - For further information, see - complex - script patch - intermediate format changes. -
      • -
    -
    • -
  • - The IFPainter interface (of package org.apache.fop.render.intermediate), specifically the - drawText and drawBorderRect method signatures, have been modified to express the semantics of the above changes to the IF output format. -
    • -
  • - The area tree (AT) output format has underwent minor modification as follows: -
      -
    • - In order to track changes to the AT format, a version attribute has been added to the root - areaTree element. Since no version information was provided previously, the initial - value of this attribute is 2.0. Future backward compatible changes will update the minor - version number, while future non-backward compatible changes will update the major version number. -
      • -
    • - An optional level attribute has been added to a number of element types to express resolved bidirectional level. -
      • -
    • - An optional reversed attribute has been added to the word element type to express that the glyphs that - correspond to the character content of the element should be reversed (in order) in the inline progression dimension when rendering. -
      • -
    -
    • -
  • - Because complex script features are now enabled by default, it is possible that different font specific data will be used for - kerning than was previously used. This may be the case if a font supports a traditional TrueType kern table and - also supports the advanced typographic kern feature with a GPOS table. In FOP 1.0, the former is used for kerning, - while in FOP 1.1 with complex script features enabled, the latter is used. If it is desired to explicitly use the kern table (rather - than the GPOS table) in such a case, then the -nocs command line option may be used when invoking FOP - in order to disable complex script features. -
    • -
-
-
- Upgrading from Pre-1.0 Versions -

- If you're planning to upgrade to the latest Apache™ FOP version from a pre-1.0 version, - there are a few very important things to consider: -

-
    -
  • - The API of FOP has changed considerably and is not - backwards-compatible with versions 0.20.5 and - 0.91beta. Version 0.92 introduced the new stable - API. -
    • -
  • - Since version 0.92 some deprecated methods which were part - of the old API have been removed. If you upgrade from 0.91 - beta, you will need to adjust your Java code. Similarly if - you upgrade from 0.92 and use deprecated methods. -
    • -
  • - If you are using a configuration file for version 0.20.5, you have to rebuild it in the new format. The format - of the configuration files has changed since version 0.20.5. See conf/fop.xconf for - an example configuration file. A XML Schema file can be found under - src/foschema/fop-configuration.xsd. -
    • -
  • - Beginning with version 0.94 you can skip the generation of - font metric files and remove the "font-metrics" attribute - in the font configuration. In the unlikely case that due to - a bug you still need to use font metrics files you will need - to regenerate the font metrics file if yours are from a FOP - version before 0.93. -
    • -
  • -

    - The new code is much more strict about the interpretation of the XSL-FO specification. - Things that worked fine in version 0.20.5 might start to produce warnings or even errors - now. FOP 0.20.5 contains many bugs which have been corrected in the new code. -

    - - While FOP 0.20.5 allowed you to have empty fo:table-cell elements, the new code - will complain about that (unless relaxed validation is enabled) because the specification - demands at least one block-level element ((%block;)+, see - XSL-FO 1.1, 6.7.10) - inside an fo:table-cell element. - -
    • -
  • - Extensions and Renderers written for version 0.20.5 will not work with the new code! The new FOP - extension for Barcode4J is available since - January 2007. -
    • -
  • - The SVG Renderer and the MIF Handler have not yet been resurrected! They are currently non-functional - and hope for someone to step up and reimplement them. -
    • -
-

- When you use your existing FO files or XML/XSL files which work fine with FOP version - 0.20.5 against this FOP version some things may not work as expected. The following - list will hopefully help you to identify and correct those problems. -

-
    -
  • - Check the Compliance page for the feature causing - trouble. It may contain the necessary information to understand and resolve the problem. -
    • -
  • - Not all 0.20.5 output formats are supported. PDF and Postscript should be fully supported. - See Output Targets for a more complete description. -
    • -
  • - As stated above, empty table cells <fo:table-cell></fo:table-cell> - are not allowed by the specification. The same applies to empty fo:static-content - and fo:block-container elements, for example. -
    • -
  • - Version 0.20.5 is not XSL-FO compliant with respect to sizing images (external-graphic) - or instream-foreign-object - objects. If images or SVGs are sized differently in your outputs with the new FOP version - check Bug 37136 - as it contains some hints on what to do. The file - - "examples/fo/basic/images.fo" has - a number of good examples that show the correct behaviour. -
    • -
  • - The fox:outline extension is not implemented in the current version: - it has been superseded by the new bookmark elements from XSL-FO 1.1. -
    • -
-
- - diff --git a/src/documentation/content/xdocs/bugs.xml b/src/documentation/content/xdocs/bugs.xml deleted file mode 100644 index 100789c54..000000000 --- a/src/documentation/content/xdocs/bugs.xml +++ /dev/null @@ -1,113 +0,0 @@ - - - - - -
- Apache™ FOP: Bugs and Other Trackable Issues - $Revision$ -
- -

- Information on this page applies to enhancement requests and other trackable -issues as well as bugs. -

-
- Reported Issues -

A list of unresolved reported bugs can be found at -FOP -Open Bugs (Bugzilla). If you have an interest in an issue already -reported, please consider the following: -

-
    -
  • If you have insight that may help developers solve an existing problem, -please add comments and/or file attachments to the existing issue.
    • -
  • If you would like to track the status of the issue, consider adding -your email address to the list of "CC" recipients, so that you will receive -an email as changes are made to the issue.
    • -
-
-
- Unreported Issues (Reporting New Issues) -

- User reports of bugs and requests for enhancements are extremely - important parts of FOP development, and we appreciate the time you take to help - us track these issues down. -

-
    -
  • - To help us ensure that the bug database is as useful as it should be, please - use the Getting Help checklist to determine whether a bug report should be entered. -
    • -
  • - Review the Apache Bug - Writing Guidelines before submitting your report. -
    • -
  • - Enter a new issue report at The - FOP issue database (Bugzilla). You will be asked to login to an existing Bugzilla account or to - create a new one. When entering the bug report, please make your description complete and concise. - If the issue involves a specific input or output file, then you MUST include the - following information in the bug report (preferably as one or more attachments): -
      -
    • - an input XSL-FO file (an input XML plus XSLT file is not acceptable, unless and only if the - issue being reported is related to the built-in XSLT transform processing convenience function provided - by FOP); this input SHOULD be maximally minimal, which means that it should - contain nothing more than the minimum needed to demonstrate the problem; if you do not take the effort - to provide a maximally minimal input FO file, then you will be subsequently asked to do so before the - bug is processed; -
      • -
    • - a resulting output file, preferably in PDF format; if the issue being reported involves a different output - format, then provide both a PDF output file and the output file for the output format for which the report - applies; -
      • -
    • - a copy of the FOP configuration file you used (e.g., fop.xconf); -
      • -
    • - if FOP was invoked using the command line (or an equivalent), then a dump of both the input - command line and any console output (stderr or stdout) produced; if the report involves an - exception, then this MUST include the full stack back trace; -
      • -
    • - information describing the version of FOP you are using and the platform (and OS) on which - you are invoking FOP; -
      • -
    • - if the report applies to the use of a specific font other than one of the built-in, base 14 - fonts, then information that describes where to obtain the font. -
      • -
    -
    • -
  • - After submission, a copy of your bug report will be automatically - sent to the FOP developer discussion list. If additional information is needed to - process the bug, then the bug will be set to the NEEDSINFO state, and - you will be asked to provide the additional information. You can avoid this extra - step by being diligent about providing all of the information - indicated above. -
    • -
-
- - - - - diff --git a/src/documentation/content/xdocs/compliance.ihtml b/src/documentation/content/xdocs/compliance.ihtml deleted file mode 100644 index 454131915..000000000 --- a/src/documentation/content/xdocs/compliance.ihtml +++ /dev/null @@ -1,4874 +0,0 @@ - - - - - - Apache™ FOP Compliance Page - - - -

W3C XSL-FO 1.1 Standard

- -

One of Apache™ FOP's design goals is conformance to the W3C XSL-FO 1.1 standard, which specifies three - levels of "conformance": basic, extended, and complete. Although FOP does not currently conform - to any of these levels, it is nevertheless a useful work-in-progress for many applications. The - information presented here demonstrates FOP's progress toward the goal of conformance, which - progress consists of implementation of specific objects and properties in the standard. The - information presented is useful not only to the developers as a sort of "to do" list, but also - for setting proper expectations for users and potential users.

- -

The following table shows the legend used for the tables below:

- - - - - - - - - - - - - - - - - - -
yesindicates conformance
partialindicates partial conformance
noindicates a lack of conformance
naindicates that the item is "not applicable" to FOP usually because FOP supports only - visual media
- -

XSL-FO Object Support

- - - -

XSL-FO Property Support

- - - -

XSL-FO Core Function Library Support

- - - -

XSL-FO Object Support Table (§6)

- -

The following is a summary of FOP's current support for the standard XSL-FO objects.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
CitationObject NameXSL-FO Conformance LevelSupport in FOPComments
1.0 (stable)1.1 (stable)development
§6.4Declarations and Pagination and Layout Formatting Objects
§6.4.2rootBasicyesyesyes 
§6.4.3declarationsBasicyesyesyes 
§6.4.4color-profileExtendedyesyesyes 
§6.4.5page-sequenceBasicyesyesyes 
§6.4.6page-sequence-wrapperBasicnonono 
§6.4.7layout-master-setBasicyesyesyes 
§6.4.8page-sequence-masterBasicyesyesyes 
§6.4.9single-page-master-referenceBasicyesyesyes 
§6.4.10repeatable-page-master-referenceBasicyesyesyes 
- §6.4.11repeatable-page-master-alternativesExtendedyesyesyes 
- §6.4.12conditional-page-master-referenceExtendedyesyesyes 
§6.4.13simple-page-masterBasicpartialpartialpartialThe page width may not change among pages of the same page-sequence - unless a forced break is inserted.
§6.4.14region-bodyBasicyesyesyes
§6.4.15region-beforeExtendedyesyesyes 
§6.4.16region-afterExtendedyesyesyes 
§6.4.17region-startExtendedyesyesyes 
§6.4.18region-endExtendedyesyesyes 
§6.4.19flowBasicyesyesyes 
§6.4.20static-contentExtendedyesyesyes 
§6.4.21titleExtendedyesyesyes 
§6.4.22flow-mapExtendednonono 
§6.4.23flow-assignmentExtendednonono 
§6.4.24flow-source-listExtendednonono 
§6.4.25flow-name-specifierExtendednonono 
§6.4.26flow-target-listExtendednonono 
§6.4.27region-name-specifierExtendednonono 
§6.5Block Formatting Objects
§6.5.2blockBasicyesyesyes 
§6.5.3block-containerExtendedpartialpartialpartial 
§6.6Inline Formatting Objects
§6.6.2bidi-overrideExtendednoyesyes 
§6.6.3characterBasicyesyesyes 
§6.6.4initial-property-setExtendednonono 
§6.6.5external-graphicBasicyesyesyes 
§6.6.6instream-foreign-objectExtendedyesyesyesBuilt-in support for SVG only, additional namespaces through optional - extensions.
§6.6.7inlineBasicyesyesyes 
§6.6.8inline-containerExtendednonono 
§6.6.9leaderBasicyesyesyes 
§6.6.10page-numberBasicyesyesyes 
§6.6.11page-number-citationExtendedpartialpartialpartialAfter the page number is known, no relayout is performed. The - appearance may be suboptimal depending on the use case.
§6.6.12page-number-citation-lastExtendedpartialpartialpartial -
    -
  • Works only for page-sequence so far.
    • -
  • After the page number is known, no relayout is performed. The - appearance may be suboptimal depending on the use case.
    • -
-
§6.6.13folio-prefixExtendednonono 
§6.6.14folio-suffixExtendednonono 
§6.6.15scaling-value-citationExtendednonono 
§6.7Table Formatting Objects
§6.7.2table-and-captionBasicnonono 
§6.7.3tableBasicpartialpartialpartialNo support for auto layout yet
§6.7.4table-columnBasicyesyesyes 
§6.7.5table-captionExtendednonono 
§6.7.6table-headerBasicyesyesyes 
§6.7.7table-footerExtendedyesyesyes 
§6.7.8table-bodyBasicyesyesyes 
§6.7.9table-rowBasicyesyesyes 
§6.7.10table-cellBasicyesyesyes 
§6.8List Formatting Objects
§6.8.2list-blockBasicyesyesyes 
§6.8.3list-itemBasicyesyesyes 
§6.8.4list-item-bodyBasicyesyesyes 
§6.8.5list-item-labelExtendedyesyesyes 
§6.9Link and Multi Formatting Objects
§6.9.2basic-linkExtendedyesyesyesboth internal and external supported
§6.9.3multi-switchExtendednonono 
§6.9.4multi-caseBasicnonono 
§6.9.5multi-toggleExtendednonono 
§6.9.6multi-propertiesExtendednonono 
§6.9.7multi-property-setExtendednonono 
§6.10Formatting Objects for Indexing
§6.10.2index-page-number-prefixExtendednonono 
§6.10.3index-page-number-suffixExtendednonono 
§6.10.4index-range-beginExtendednonono 
§6.10.5index-range-endExtendednonono 
§6.10.6index-key-referenceExtendednonono 
§6.10.7index-page-citation-listExtendednonono 
§6.10.8index-page-citation-list-separatorExtendednonono 
§6.10.9index-page-citation-range-separatorExtendednonono 
§6.11Formatting Objects for Bookmarks
§6.11.1bookmark-treeExtendedyesyesyes 
§6.11.2bookmarkExtendedpartialpartialpartialexternal-destination is not yet supported.
§6.11.3bookmark-titleExtendedpartialpartialpartialcolor, font-style and font-weight are not supported, yet.
§6.12Out-of-line Formatting Objects
§6.12.2floatExtendednonono 
§6.12.3footnoteExtendedpartialpartialpartialRestrictions with multi-column documents.
§6.12.4footnote-bodyExtendedyesyesyes 
§6.13Other Formatting Objects
§6.13.2change-bar-beginExtendednonono 
§6.13.3change-bar-endExtendednonono 
§6.13.4wrapperBasicyesyesyesOnly works as expected with inline-level content.
§6.13.5markerExtendedyesyesyes 
§6.13.6retrieve-markerExtendedyesyesyes 
§6.13.7retrieve-table-markerExtendednonono 
- -

XSL-FO Property Support Table - (§7)

- -

The following is a summary of FOP's current support for the standard XSL-FO properties.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
CitationProperty NameXSL-FO Conformance LevelSupport in FOPComments
1.0 (stable)1.1 (stable)develop- ment
§7.5Common Accessibility Properties
§7.5.1source-documentBasicnonono 
§7.5.2roleBasicnonono 
§7.6Common Absolute Position Properties
§7.6.1absolute-positionCompleteyesyesyes 
§7.6.2topExtendedyesyesyes 
§7.6.3rightExtendedyesyesyes 
§7.6.4bottomExtendedyesyesyes 
§7.6.5leftExtendedyesyesyes 
§7.7Common Aural Properties
§7.7.1azimuthBasicnanana 
§7.7.2cue-afterBasicnanana 
§7.7.3cue-beforeBasicnanana 
§7.7.4elevationBasicnanana 
§7.7.5pause-afterBasicnanana 
§7.7.6pause-beforeBasicnanana 
§7.7.7pitchBasicnanana 
§7.7.8pitch-rangeBasicnanana 
§7.7.9play-duringBasicnanana 
§7.7.10richnessBasicnanana 
§7.7.11speakBasicnanana 
§7.7.12speak-headerBasicnanana 
§7.7.13speak-numeralBasicnanana 
§7.7.14speak-punctuationBasicnanana 
§7.7.15speech-rateBasicnanana 
§7.7.16stressBasicnanana 
§7.7.17voice-familyBasicnanana 
§7.7.18volumeBasicnanana 
§7.8Common Border, Padding, and Background Properties
§7.8.1background-attachmentExtendednonono 
§7.8.2background-colorBasicyesyesyes 
§7.8.3background-imageExtendedyesyesyes 
§7.8.4background-repeatExtendedyesyesyes 
§7.8.5background-position-horizontalExtendedpartialpartialpartialIgnored when background-repeat set to - "repeat" or "repeat-x"
§7.8.6background-position-verticalExtendedpartialpartialpartialIgnored when background-repeat set to - "repeat" or "repeat-y"
§7.8.7border-before-colorBasicyesyesyes 
§7.8.8border-before-styleBasicyesyesyes 
§7.8.9border-before-widthBasicyesyesyes 
§7.8.10border-after-colorBasicyesyesyes 
§7.8.11border-after-styleBasicyesyesyes 
§7.8.12border-after-widthBasicyesyesyes 
§7.8.13border-start-colorBasicyesyesyes 
§7.8.14border-start-styleBasicyesyesyes 
§7.8.15border-start-widthBasicyesyesyes 
§7.8.16border-end-colorBasicyesyesyes 
§7.8.17border-end-styleBasicyesyesyes 
§7.8.18border-end-widthBasicyesyesyes 
§7.8.19border-top-colorBasicyesyesyes 
§7.8.20border-top-styleBasicyesyesyes 
§7.8.21border-top-widthBasicyesyesyes 
§7.8.22border-bottom-colorBasicyesyesyes 
§7.8.23border-bottom-styleBasicyesyesyes 
§7.8.24border-bottom-widthBasicyesyesyes 
§7.8.25border-left-colorBasicyesyesyes 
§7.8.26border-left-styleBasicyesyesyes 
§7.8.27border-left-widthBasicyesyesyes 
§7.8.28border-right-colorBasicyesyesyes 
§7.8.29border-right-styleBasicyesyesyes 
§7.8.30border-right-widthBasicyesyesyes 
§7.8.31padding-beforeBasicyesyesyes 
§7.8.32padding-afterBasicyesyesyes 
§7.8.33padding-startBasicyesyesyes 
§7.8.34padding-endBasicyesyesyes 
§7.8.35padding-topBasicyesyesyes 
§7.8.36padding-bottomBasicyesyesyes 
§7.8.37padding-leftBasicyesyesyes 
§7.8.38padding-rightBasicyesyesyes 
§7.9Common Font Properties
§7.9.2font-familyBasicpartialpartialpartialfont-family lists are allowed but glyph based font selection is not - supported
§7.9.3font-selection-strategyCompletenonono 
§7.9.4font-sizeBasicyesyesyes 
§7.9.5font-stretchExtendednonono 
§7.9.6font-size-adjustExtendednonono 
§7.9.7font-styleBasicyesyesyes 
§7.9.8font-variantBasicnonono 
§7.9.9font-weightBasicpartialpartialpartialTODO <relative> font weights
§7.10Common Hyphenation Properties
§7.10.1countryExtendedyesyesyesFor PDF output: Only 2-letter codes from ISO 3166 are supported properly to - identify the natural language!
§7.10.2languageExtendedyesyesyesFor PDF output: Only 2-letter codes from ISO 639 are supported properly to - identify the natural language! Also used with complex scripts features.
§7.10.3scriptExtendednoyesyesUsed with complex scripts features to override default script heuristics.
§7.10.4hyphenateExtendedyesyesyes 
§7.10.5hyphenation-characterExtendedyesyesyes 
§7.10.6hyphenation-push-character-countExtendedyesyesyes 
§7.10.7hyphenation-remain-character-countExtendedyesyesyes 
§7.11Common Margin Properties - Block
§7.11.1margin-topBasicyesyesyes 
§7.11.2margin-bottomBasicyesyesyes 
§7.11.3margin-leftBasicyesyesyes 
§7.11.4margin-rightBasicyesyesyes 
§7.11.5space-beforeBasicpartialpartialpartialSpace adjustment may not fully work everywhere, yet.
§7.11.6space-afterBasicpartialpartialpartialSpace adjustment may not fully work everywhere, yet.
§7.11.7start-indentBasicyesyesyes 
§7.11.8end-indentBasicyesyesyes 
§7.12Common Margin Properties - Inline
§7.12.1margin-topBasicnonono 
§7.12.2margin-bottomBasicnonono 
§7.12.3margin-leftBasicnonono 
§7.12.4margin-rightBasicnonono 
§7.12.5space-endBasicnonono 
§7.12.6space-startBasicnonono 
§7.13Common Relative Position Properties
§7.13.1topExtendednonono 
§7.13.2rightExtendednonono 
§7.13.3bottomExtendednonono 
§7.13.4leftExtendednonono 
§7.13.5relative-positionExtendednonono 
§7.14Area Alignment Properties
§7.14.1alignment-adjustBasicyesyesyes 
§7.14.2alignment-baselineBasicyesyesyes 
§7.14.3baseline-shiftBasicyesyesyes 
§7.14.4display-alignExtendedpartialpartialpartialTODO Check e-g, i-f-o.
§7.14.5dominant-baselineBasicyesyesyes 
§7.14.6relative-alignExtendednonono 
§7.15Area Dimension Properties
§7.15.1allowed-height-scaleExtendednonono 
§7.15.2allowed-width-scaleExtendednonono 
§7.15.3block-progression-dimensionBasicyesyesyes 
§7.15.4content-heightExtendedyesyesyes 
§7.15.5content-widthExtendedyesyesyes 
§7.15.6heightBasicyesyesyes 
§7.15.7inline-progression-dimensionBasicyesyesyes 
§7.15.8max-heightCompleteyesyesyes 
§7.15.9max-widthCompleteyesyesyes 
§7.15.10min-heightCompleteyesyesyes 
§7.15.11min-widthCompleteyesyesyes 
§7.15.12scalingExtendedyesyesyes 
§7.15.13scaling-methodExtendednonono 
§7.15.14widthBasicyesyesyes 
§7.16Block and Line-related Properties
§7.16.1hyphenation-keepExtendednonono 
§7.16.2hyphenation-ladder-countExtendedyesyesyes 
§7.16.3last-line-end-indentExtendedyesyesyes 
§7.16.4line-heightBasicyesyesyes 
§7.16.5line-height-shift-adjustmentExtendedyesyesyes 
§7.16.6line-stacking-strategyBasicpartialpartialpartialvalue "line-height" not supported
§7.16.7linefeed-treatmentExtendedyesyesyes 
§7.16.8white-space-treatmentExtendedpartialpartialpartialinline elements may interfere with correct handling of this property - in some cases
§7.16.9text-alignBasicpartialpartialpartialOnly start, end, center and justify are supported
§7.16.10text-align-lastExtendedpartialpartialpartialOnly start, end, center and justify are supported
§7.16.11text-indentBasicyesyesyes 
§7.16.12white-space-collapseExtendedyesyesyes 
§7.16.13wrap-optionBasicpartialpartialpartialOnly supported on fo:block.
§7.17Character Properties
§7.17.1characterBasicyesyesyes 
§7.17.2letter-spacingExtendedyesyesyes 
§7.17.3suppress-at-line-breakExtendednonono 
§7.17.4text-decorationExtendedyesyesyes 
§7.17.5text-shadowExtendednonono 
§7.17.6text-transformExtendedyesyesyes 
§7.17.7treat-as-word-spaceExtendednonono 
§7.17.8word-spacingExtendedyesyesyes 
§7.18Color-related Properties
§7.18.1colorBasicyesyesyes 
§7.18.2color-profile-nameExtendednonono 
§7.18.3rendering-intentExtendednonono 
§7.19Float-related Properties
§7.19.1clearExtendednonono 
§7.19.2floatExtendednonono 
§7.19.3intrusion-displaceExtendednonono 
§7.20Keeps and Breaks Properties
§7.20.1break-afterBasicyesyesyes 
§7.20.2break-beforeBasicyesyesyes 
§7.20.3keep-togetherExtendedpartialpartialpartial -
    -
  • [1.0 and later] minimal support for <integer> value.
    • -
-
§7.20.4keep-with-nextBasicpartialpartialpartial -
    -
  • works on all implemented block-level FOs, but not on inline-level - FOs.
    • -
  • [1.0 and later] minimal support for <integer> value.
    • -
-
§7.20.5keep-with-previousBasicpartialpartialpartial -
    -
  • [1.0 and later] works on all implemented block-level - FOs, but not on inline-level FOs.
    • -
  • [1.0 and later] minimal support for <integer> value.
    • -
-
§7.20.6orphansBasicyesyesyes 
§7.20.7widowsBasicyesyesyes 
§7.21Layout-related Properties
§7.21.1clipExtendednonono 
§7.21.2overflowBasicyesyesyes 
§7.21.3reference-orientationExtendedyesyesyes 
§7.21.4spanExtendedyesyesyes 
§7.22Leader and Rule Properties
§7.22.1leader-alignmentExtendednononoNot supported
§7.22.2leader-patternBasicyesyesyesValue "use-content" does not work in all circumstances.
§7.22.3leader-pattern-widthExtendedyesyesyes 
§7.22.4leader-lengthBasicyesyesyes 
§7.22.5rule-styleBasicyesyesyes 
§7.22.6rule-thicknessBasicyesyesyes 
§7.23Properties for Dynamic Effects Formatting Objects
§7.23.1active-stateExtendednonono 
§7.23.2auto-restoreExtendednonono 
§7.23.3case-nameExtendednonono 
§7.23.4case-titleExtendednonono 
§7.23.5destination-placement-offsetExtendednonono 
§7.23.6external-destinationExtendedyesyesyes 
§7.23.7indicate-destinationExtendednonono 
§7.23.8internal-destinationExtendedyesyesyes 
§7.23.9show-destinationExtendedpartialpartialpartial[1.0 and later] only has effect in PDF output, for external PDF destinations (links pointing to destinations - in another PDF), and only works reliably when the PDF is viewed in a standalone PDF viewer. -

Adobe's browser plugin, for example, ignores the /NewWindow flag.

§7.23.10starting-stateExtendedpartialpartialpartialsupport for starting-state on fo:bookmark
§7.23.11switch-toExtendednonono 
§7.23.12target-presentation-contextExtendednonono 
§7.23.13target-processing-contextExtendednonono 
§7.23.14target-stylesheetExtendednonono 
§7.24Properties for Indexing
§7.24.1index-classExtendednonono 
§7.24.2index-keyExtendednonono 
§7.24.3page-number-treatmentExtendednonono 
§7.24.4 - merge-ranges-across-index-key-referencesExtendednonono 
§7.24.5 - merge-sequential-page-numbersExtendednonono 
§7.24.6 - merge-pages-across-index-key-referencesExtendednonono 
§7.24.7ref-index-keyExtendednonono 
§7.25Properties for Markers
§7.25.1marker-class-nameExtendedyesyesyes 
§7.25.2 - retrieve-boundary-within-tableExtendednonono 
§7.25.3retrieve-class-nameExtendedyesyesyes 
§7.53.4retrieve-positionExtendedyesyesyes 
§7.25.5retrieve-boundaryExtendedyesyesyes 
§7.25.6 - retrieve-position-within-tableExtendednonono 
§7.26Properties for Number to String Conversion
§7.26.1formatBasicpartialyesyes[1.0 and earlier] only values '0*1', 'a', 'A', 'i', 'I' supported
§7.26.2grouping-separatorExtendednoyesyes 
§7.26.3grouping-sizeExtendednoyesyes 
§7.26.4letter-valueBasicnoyesyes 
§7.27Pagination and Layout Properties
§7.27.1blank-or-not-blankExtendedyesyesyes 
§7.27.2column-countExtendedyesyesyes 
§7.27.3column-gapExtendedyesyesyes 
§7.27.4extentExtendedyesyesyes 
§7.27.5flow-nameBasicyesyesyes 
§7.27.6force-page-countExtendedyesyesyes 
§7.27.7initial-page-numberBasicyesyesyes 
§7.27.8master-nameBasicyesyesyes 
§7.27.9master-referenceBasicyesyesyes 
§7.27.10maximum-repeatsExtendedyesyesyes 
§7.27.11media-usageExtendednonono 
§7.27.12odd-or-evenExtendedyesyesyes 
§7.27.13page-heightBasicpartialpartialpartialvalue "indefinite" not yet supported
§7.27.14page-positionExtendedyesyesyesvalue "only" not supported
§7.27.15page-widthBasicpartialpartialpartialvalue "indefinite" not yet supported
§7.27.16precedenceExtendedyesyesyes 
§7.27.17region-nameBasicyesyesyes 
§7.27.18flow-map-nameExtendednonono 
§7.27.19flow-map-referenceExtendednonono 
§7.27.20flow-name-referenceExtendednonono 
§7.27.21region-name-referenceExtendednonono 
§7.28Table Properties
§7.28.1border-after-precedenceBasicnonono 
§7.28.2border-before-precedenceBasicnonono 
§7.28.3border-collapseExtendedpartialpartialpartialvalue "collapse-with-precedence" not yet supported
§7.28.4border-end-precedenceBasicnonono 
§7.28.5border-separationExtendedyesyesyes 
§7.28.6border-start-precedenceBasicnonono 
§7.28.7caption-sideCompletenonono 
§7.28.8column-numberBasicyesyesyes 
§7.28.9column-widthBasicyesyesyes 
§7.28.10empty-cellsExtendednonono 
§7.28.11ends-rowExtendedyesyesyes 
§7.28.12number-columns-repeatedBasicyesyesyes 
§7.28.13number-columns-spannedBasicyesyesyes 
§7.28.14number-rows-spannedBasicyesyesyes 
§7.28.15starts-rowExtendedyesyesyes 
§7.28.16table-layoutExtendednonono 
§7.28.17table-omit-footer-at-breakExtendedyesyesyes 
§7.28.18table-omit-header-at-breakExtendedyesyesyes 
§7.29Writing-mode-related Properties
§7.29.1directionBasicnonono 
§7.29.2glyph-orientation-horizontalExtendednonono 
§7.29.3glyph-orientation-verticalExtendednonono 
§7.29.4text-altitudeExtendednonono 
§7.29.5text-depthExtendednonono 
§7.29.6unicode-bidiExtendednonono 
§7.29.7writing-modeBasicnoyesyes[1.1 and later] only horizontal left-to-right and right-to-left modes
§7.30Miscellaneous Properties
§7.30.1change-bar-classExtendednonono 
§7.30.2change-bar-colorExtendednonono 
§7.30.3change-bar-offsetExtendednonono 
§7.30.4change-bar-placementExtendednonono 
§7.30.5change-bar-styleExtendednonono 
§7.30.6change-bar-widthExtendednonono 
§7.30.7content-typeExtendednonono 
§7.30.8idBasicpartialpartialpartialIDs on table-header, table-footer, table-body, table-row, - table-and-caption, table-caption, inline-container and bidi-override are not available, - yet.
§7.30.9intrinsic-scale-valueExtendednonono 
§7.30.10page-citation-strategyExtendednonono 
§7.30.11provisional-label-separationBasicyesyesyes 
§7.30.12provisional-distance-between-startsBasicyesyesyes 
§7.30.13ref-idExtendedyesyesyes 
§7.30.14scale-optionExtendednonono 
§7.30.15score-spacesExtendednonono 
§7.30.16srcBasicyesyesyes 
§7.30.17visibilityExtendednonono 
§7.30.18z-indexExtendednonono 
§7.31Shorthand Properties
§7.31.1backgroundCompletenonono 
§7.31.2background-positionCompleteyesyesyes 
§7.31.3borderCompleteyesyesyes 
§7.31.4border-bottomCompleteyesyesyes 
§7.31.5border-colorCompleteyesyesyes 
§7.31.6border-leftCompleteyesyesyes 
§7.31.7border-rightCompleteyesyesyes 
§7.31.8border-styleCompleteyesyesyes 
§7.31.9border-spacingCompleteyesyesyes 
§7.31.10border-topCompleteyesyesyes 
§7.31.11border-widthCompleteyesyesyes 
§7.31.12cueCompletenanana 
§7.31.13fontCompletepartialpartialpartialEnum values other than "inherit" not yet supported.
§7.31.14marginCompleteyesyesyes 
§7.31.15paddingCompleteyesyesyes 
§7.31.16page-break-afterCompleteyesyesyes 
§7.31.17page-break-beforeCompleteyesyesyes 
§7.31.18page-break-insideCompleteyesyesyes 
§7.31.19pauseCompletenanana 
§7.31.20positionCompleteyesyesyes 
§7.31.21sizeCompletenonono 
§7.31.22vertical-alignCompletepartialpartialpartialPercentages are not supported, yet.
§7.31.23white-spaceCompleteyesyesyes 
§7.31.24xml:langCompleteyesyesyesVery basic parsing; no validation of the specified value.
- -

XSL-FO Core - Function Library Support Table (§5.10)

- -

The following is a summary of FOP's current support for the XSL-FO Core Function Library.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
CitationFunction NameXSL-FO Conformance LevelSupport in FOPComments
1.0 (stable)1.1 (stable)development
§5.10.1Number Functions
§5.10.1floorBasicyesyesyes 
§5.10.1ceilingBasicyesyesyes 
§5.10.1roundBasicyesyesyes 
§5.10.1minBasicyesyesyes 
§5.10.1maxBasicyesyesyes 
§5.10.1absBasicyesyesyes 
§5.10.2Color Functions
§5.10.2rgbBasicyesyesyes 
§5.10.2rgb-iccBasicyesyesyes 
§5.10.2system-colorBasicyesyesyes 
§5.10.3Font Functions
§5.10.3system-fontBasicnonono 
§5.10.4Property Value Functions
§5.10.4inherited-property-valueBasicyesyesyes 
§5.10.4label-endBasicyesyesyes 
§5.10.4body-startBasicyesyesyes 
§5.10.4from-parentBasicyesyesyes 
§5.10.4from-nearest-specified-valueBasicyesyesyes 
§5.10.4from-page-master-regionBasicnonono 
§5.10.4from-table-columnBasicyesyesyes 
§5.10.4proportional-column-widthBasicyesyesyes 
§5.10.4merge-property-valuesBasicnonono 
- - diff --git a/src/documentation/content/xdocs/dev/conventions.xml b/src/documentation/content/xdocs/dev/conventions.xml deleted file mode 100644 index e0771a928..000000000 --- a/src/documentation/content/xdocs/dev/conventions.xml +++ /dev/null @@ -1,187 +0,0 @@ - - - - - -
- Apache™ FOP Development: Coding Conventions - $Revision$ -
- -

Acknowledgement: Some content in this guide was adapted from other Apache™ projects such as Avalon, Cactus, Turbine and Velocity.

-
- Subversion Repository -

Conventions in this section apply to Repository content, regardless of type:

-
    -
  • Files checked in must conform to the code conventions for that type of file (java files must conform to java requirements, xml to xml requirements, etc.). If a submitted patch does not conform, it is the responsibility of the committer to bring it into conformance before checking it in. Developers submitting patches are encouraged to follow the code conventions to reduce the work load on the committers.
    • -
  • To reduce the amount of spurious deltas, all text (non-binary) files checked into SVN must have Unix-style line endings (LF only). Many IDEs and editors (even on non-Unix platforms) have settings that can facilitate this convention.
    • -
  • In order to be able to discern commits from a committer from those where a committer applied a patch from a contributor, the commit message must contain a separate line following this pattern: "Submitted by: [contributor's name] <[contributor's obfuscated e-mail address]>". This also helps doing audits on the repository.
    • -
-
-
- Java -
- Java Style -

- In order to facilitate the human reading of FOP source code, - reduce churning in code, and prevent disputes, the FOP developers - have agreed on a set of coding conventions. The basis of these coding - conventions is documented in the - Apache XML Project Guidelines, - which requires that all Java Language source code in the repository - must be written in conformance to Sun's - Code Conventions for the Java Programming Language. - In addition, the FOP developers have agreed to other conventions, - which are summarized in the following table:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ConventionRationaleEnforced By
Every Java source file starts with the Apache licence header.Required by Apache.checkstyle
No tabs in content.Programmers should not have to adjust the tab settings in their editor to be able to read the source code.checkstyle
Indentation of 4 spaces per level.Maximize readability.Not enforced
Comments, identifiers, and project documentation must be in English. -In general, other languages must not be used, except in translated documentation and language-specific i10n files. - To avoid the need for everyone to learn all languages, English has become the standard language for many technology projects, and is the only human language that all FOP developers are expected to know.Not enforced
American English spelling should be used. Alternative spelling and idioms are tolerated, but may be changed by anyone to American.Some standard is useful, and American English is widely used and accepted for technology standards and projects.Not enforced.
Fully qualify all import statements (no "import java.util.*")Claritycheckstyle
No underscores in variable names except for static finals.Upper/lower case distinctions can be made in all other variable names, eliminating the need for artificial word boundaries.checkstyle
Opening brace for a block should be on the same line as its control statement (if, while, etc.).Standardization, general preference.checkstyle
Write appropriate javadoc entries for all public and protected classes, methods, and variables.Basic API documentation is needed.checkstyle
By ASF policy, @author tags are officially discouraged. -However it is permissible to indicate the original author(s) of an entire file or package in a comment provided it follows the copyright and license header.Attribution of subsequent contributions are recorded by the SVN commit history logs, so should not be included.checkstyle
-

For developers that dislike these conventions, one workaround is to develop using their own style, then use a formatting tool like astyle (Artistic Style) before committing.

-
-
- Checkstyle -

The java syntax checker "Checkstyle" is used to enforce many of the FOP coding standards. -The standards enforced through Checkstyle are documented in its configuration file (xml-fop/checkstyle.cfg). -The conventions defined in the configuration file are an integral part of FOP's coding conventions, and should not be changed without common consent. -In other words, the configuration file contains additional conventions that are not documented on this page, but are generally accepted as good style within the java community (i.e. they are the default behavior of checkstyle, which the FOP developers have decided to adopt de facto). -Any apparent contradiction between the configuration file and this document should be raised on the fop-dev mailing list so that it can be clarified.

-

To use the "checkstyle" target in FOP's build process, download the source from the Checkstyle web site, place checkstyle-all-*.jar in the lib directory and call "build checkstyle". Output (in the build directory) includes checkstyle_report.txt and checkstyle_report.xml. If you copy the file contrib/checkstyle-noframes.xsl from Checkstyle into FOP's root directory, you will also get an HTML report.

-

Checkstyle is probably most useful when integrated into your IDE. See the Checkstyle web site for more information about IDE plugins.

-
-
- Java Best Practices -

The following general principles are a distillation of best practice expectations on the FOP project.

-
    -
  • Apply common sense when coding. When coding keep in mind that others will read your code and have to understand it.
    • -
  • Readability comes before performance, at least initially.
    • -
  • If you can refactor some code to make it more understandable, please do so.
    • -
  • Properly document code, especially where it's important.
    • -
  • Use interfaces instead of implementations where possible. -This favors a clearer design and makes switching between implementations easier (Examples: List instead of ArrayList/Vector, Map instead of HashMap/Hashtable).
    • - - -
  • Avoid using exceptions for flow control.
    • -
  • Try to catch exceptions as much as possible and rethrow higher level exceptions (meaning hiding the low level detailed and putting a message that is more related to the function of your code).
    • -
  • It is important not to lose the stack trace which contains important information. -Use chained exception for that. Avalon Framework provides CascadingException (and similar) for this. -Exception class names and stack traces must be treated like gold. -Do whatever is required so that this information is not lost. -Printing error messages to System.err or System.out is useless in a server-side environment where this info is usually lost.
    • -
  • Always log the exception at the higher level (i.e. where it is handled and not rethrown).
    • -
  • Try to avoid catching Throwable or Exception and catch specific exceptions instead.
    • -
-
-
- Resources -
    -
  • [book on code style] Code Complete by Steve McConnell.
    • -
  • [code formatting software] JRefactory.
    • -
-
- -
-
- XML - - - - - - - - - - - - - - - - - - - - - -
ConventionRationaleEnforced By
XML files must always be well-formed. Validation is optional.Document integrityNot enforced
No tabs in content.Users should not have to adjust tab settings in their editor to be able to read the content.Not enforced
Indentation of 2 spaces per levelMaximize readabilityNot enforced
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/areas.xml b/src/documentation/content/xdocs/dev/design/areas.xml deleted file mode 100644 index 6548179de..000000000 --- a/src/documentation/content/xdocs/dev/design/areas.xml +++ /dev/null @@ -1,191 +0,0 @@ - - - - - -
- Apache™ FOP Design: Area Tree - $Revision$ - - - -
- -
- Introduction -

The Area Tree is an internal representation of the result document, representing pages and their contents. -To make the concepts clearer and easier to understand, the code to implement the area tree matches the areas defined in the XSL-FO specification.

-

The area tree is created by the layout managers once the layout is decided for a page. -Once a completed page is finished it can then be added to the area tree. -From that point forward, the area tree model can then handle the new page. -The data in the area tree must be minimal and independant. -This means that the data uses less memory and can be serialized to an output stream if needed.

-

The Area Tree consists of a set of pages, which the actual implemenation places in a set of page sequences.

-
-
- Structure -

The area tree is a root element that has a list of page-viewport-areas. -Each page viewport has a page-reference-area which holds the contents of the page. -To handle the processing better FOP does not maintain a list at the root level but lets the area tree model handle each page as it is added.

-
-
- Page -

A page consists of a page+viewport pair.

-

The PageViewPort and Page with the regions is created by the -LayoutMasterSet. -The contents are then placed by the layout managers. -Once the layout of a page is complete then it is added to the Area Tree.

-

Inside the page is a set of RegionViewport+Region pairs for each region on -the page.

-

A page is made up of five area regions. -These are before, start, body, end and after. -Each region has a viewport and contains the areas produced from the children in the FO object heirarchy.

-

For the body area there are more subdivisions for before floats, footnotes and the main reference area. -The main reference area is made from span areas which have normal flow reference areas as children. -The flow areas are then created inside these normal flow reference areas.

-

Since the layout is done inside a page, the page is created from the pagemaster with all the appropriate areas. -The layout manager then uses the page to add areas into the normal flow reference areas and floats and footnotes. -After adding the areas for the body region then the other regions can be done layed out and added.

-
-
- Block Areas -

Block level areas contain either other blocks or line areas (which is a -special block area).

-

A block is either positoned or stacked with other block areas.

-

Block areas are created and/or returned by all top level elements in the flow. -The spacing between block areas is handled by an empty block area. -A block area is stacked with other block areas in a particular direction, it has a size and it contains line areas made from a group of inline areas and/or block areas.

-
-
- Line Areas -

A line areas is simply a collection of inline areas that are stacked in the inline progression direction. -A line area has a height and a start position. -The line area is rendered by handling each inline area.

-

A line area gets a set of inline areas added until complete then it is justified and vertically alignedi when adding the areas. -If the line area contains unresolved areas then there will be a line resolver that retains the justification information until all areas in the line are resolved.

-
-
- Inline Areas -

There are a few different types of inline areas. -All inline areas have a height and width.

-

Unresolved areas can reserve some space to allow for possible sizes once it is resolved. -Then the line can be re-justified and finalised.

-

Inline areas are stacked in a line area. -Inline areas are objects such as character, viewport, inline-container, leader and space. -A special inline area Word is also used for a group of consecutive characters.

-

The image and instream foreign object areas are placed inside a viewport. -The leader (with use content) and unresolved page number areas are resolved to other inline areas.

-

Once a LineArea is filled with inline areas then the inline areas need to be aligned and adjusted to fill the line properly.

-
-
- Repeated Areas -

There are cases where the same subtree could be repeated in the area tree. -These areas will be returned by the same layout managers. -So it is possible to put a flag on the created areas so that the subtree data can be cached in the output. -Examples of this are: static areas, table header/footer, svg.

-
-
- Traits -

A trait is information associated with an area. -This could be information such as text colour or is-first.

-

Traits provide information about an area. -The traits are derived from properties on the formatting object or are generated during the layout -process. -Many of the layout traits do not have actual values but can be derived from the Area Tree. -Other traits that apply when rendering the areas are set on the area. -Since setting the same value on every area would use a lot of memory then the traits are derived from default or parent values.

-

A dominant trait on a block area is set, for example font colour, so that -every line area with the same dominant value can derive it. -The text inline areas then get the font colour set on the inline area or from the line area or from the block area.

-
-
- Classes -

The following class structure will be used to represent the area tree.

-
- Page Area Classes -

The page area classes hold the top level layout of a page. -The areas are created by the page master and should be ready to have flow areas added.

-
-
- Block Area Classes -

The block areas hold other block areas and/or line areas. -The child areas are stacked in a particular direction.

-

Areas for tables, lists and block container have their child block areas stacked in different ways. -These areas a placed with an absolute positioning. -The absolute positioning is where the blocks are placed with an offset from the parent reference area.

-
-
- Inline Area Classes -

The inline areas are used to make up a line area. -An inline area typically has a height, width and some content. -The inline area is offset from the baseline of the current line area. -The content of the inline area can be other inline areas or a simple atomic object.

-
-
-
- Forward References -

The Area Tree maintains a set of mappings from the reference to pages.

-

The PageViewPort holds the list of forward references that need resolving so that if a references is resolved during layout the page can be easily found and then fixed. -Once all the forward references are resolved then the page is ready to be rendered.

-

To layout a page any areas that cannot be resolved need to reserve space. -Once the inline area is resolved then the complete line should be adjusted to accomodate any change in space used by the area.

-
-
- Caching -

We may need to cache pages due to forward references or when keeping all -pages.

-

This is done by serializing the Page. -The PageViewport is retained to be used as a key for page references and backward references. -The Page is serialized to an object stream and then all of the page contents are released. -The Page is then recoved by reading from the object stream.

-

The PageViewport retains information about id areas for easy access.

-
-
- Extensions -

The Area Tree holds the Output Document extensions. -This is information such as pdf bookmarks or other output document specific information that -is not handled by XSL:FO.

-

It is also possible to create custom areas that extend a normal area. -The actual data that is rendered could be set in a different way or depend on resolving a forward reference.

-
-
- Area Tree Handlers -

To handle different situations the handler for the Area Tree handles each -page as it is added.

-

The RenderPagesModel sends the page directly to the renderer if the page is ready to be rendered. Once a page is rendered it is discarded. The StorePagesModel stores all the pages so that any page can be later accessed.

-

The Area Tree retains the concept of page sequences (this is not in the area tree in the spec) so that this information can be passed to the renderer. -This is useful for setting the title and organising the groups of page sequences.

-
-
- Status -
- To Do -
-
- Work in Progress -
-
- Completed -
    -
  • new area tree model
    • -
  • changed area tree xml format to match the area tree hierarchy
    • -
-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/breakpos.xml b/src/documentation/content/xdocs/dev/design/breakpos.xml deleted file mode 100644 index bf426bbd3..000000000 --- a/src/documentation/content/xdocs/dev/design/breakpos.xml +++ /dev/null @@ -1,315 +0,0 @@ - - - - - - -
- Apache™ FOP Design: Layout Managers - Break Possibility Proposal - $Revision$ - - - -
- - -
- Introduction -

-As explained in Layout, -the hierarchy of Layout Managers is responsible for building and placing -areas. Each Layout Manager is responsible for creating and filling -areas of a particular type, either inline or block. This document -explains one potential algorithm for this process. It is based on the -the generation of break possibilities (BP for short). The -Layout Managers (LM for short), will generate one or more BP and -choose the best one. The BP is then used to generate the corresponding -areas. -

-
-
- Anatomy of a Break Possibility -

A break possibility is represented by the BreakPoss class. A -BreakPoss contains size information in the stacking direction and in -the -non-stacking direction (at least for inline areas, it must have both). Flags -indicating various conditions (ISFIRST, ISLAST, CAN_BREAK_AFTER, -FORCE_BREAK_AFTER, ANCHORS etc). A BreakPoss contains a reference to -the top-level LayoutManager which generated it. -

-

A BreakPoss contains an object implementing -the BreakPoss.Position interface. This object is specific to the layout -manager which created the BreakPoss. It should indicate where the -break occurs and allow the LM to -create an area corresponding to the BP. A higher level LM Position -must somehow reference or wrap the Position returned by its child LM in its -BreakPoss object. The layout manager modifies the flags and dimension -information in the BP to reflect its own requirements. For example an -inline FO layout manager might add space-start, space-end, border and -padding values to the stacking or non-stacking dimensions. It might also -modify the flags based its on keep properties.

-
-
- Turning Break Possibilities into Areas -

Once break possibilities have been generated, the galley-level -layout manager selects the best one -and passes it back to the LayoutManager which generated it to create -the area. A LayoutManager is responsible for -storing enough information in its Position objects to be able to -create the corresponding areas.

-
-
- A walk-through -

Layout Managers are created from the top down. First the -page sequence creates a PageLM and a FlowLM. The PageLM will manage -finding the right page model (with help from the PageSequenceMaster) -and managing the balancing act between before-floats, footnotes and -the normal text flow. The FlowLM will -manage the normal content in the main flow. We can think of it as a -galley manager. -

-

In general, each LM asks its child LMs to return sucessive -break possibilities. It passes some -information to the child in a flags object and it gets back -a break possibility which contains the size in -the stacking direction as well as information about such things as -anchors, break conditions and span conditions which can change the -reference area environment. This process continues down to the lowest -level of the layout manager hierarchy which corresponds to atomic -inline-level FOs such as characters or graphics. -

-

-Each layout manager will repeatedly call getNextBreakPoss on its current -child LM until the child returns a BP with the ISLAST -flag set. Then the layout manager moves on to its next child LM (ie, -it asks the next child FO to generate a layout manager.) Galley level -layout managers which are Line and Flow will return to their parent -layout managers either when they have finished their content or when -they encounter a a BP which will fill one of their areas. -

-

The break possibilities are generated from the bottom up. -All inline content must first be broken into -lines which are then stacked into block areas. This is done by the -LineLayoutManager, which creates line areas. -The LineLM asks its child LM to generate a break possibility, which -represents a place where the line can end. This -initially means each potential line-end (primarily spaces or forced -linefeeds and a few other potential line-end characters such as hard -hyphens.) The text LM returns an object which stores the size in the -stacking direction as a MinOptMax triplet -and a cost, which is based on how well this break -would satisfy the constraints. The Text LM keeps track of its position in -the text content and returns the total size of the text area it would -create if it were to break at a given point. The returned BP -object also contains information about whether the break is forced -(linefeed) or whether this is the last area which can be generated by -the LM (ISLAST flag). If a textFO ends on a non-break character, the -ISLAST flag is set, but the CAN_BREAK_AFTER flag isn't, since we don't -know if there is any following text in another inline object for -example. -

-

Variable size content is taken into account from -the bottom up. Each LM returns a range of sizes in the stacking -direction, based on property values. For text, this comes from -variable word-space values or letter-space values. For other inline -objects, it may include variable space-start and space-end values -(after calculation of the entire sequence of space specifiers at a -particular break possibility.)

-

The main constraint for laying out -lines is the available inline-progression-dimension (IPD) for the line -area to be created. This -depends on the IPD of the reference area ancestor, on the indents of the -containing fo:block, and on any side-floats which may be intruding on -this line.

-See below Getting the Reference -IPD -for discussion of how the reference area IPD is -transmitted to the Line LM. -

For now, let's assume that only the LineLM knows about the IPD -available to it. Therefore only it can make a decision about which BP -is the best one; the lower level inline layout managers can only -return potential break points.

-There are certainly optimizations to this model which can be -examined later. -

So the Line LM will ask its child LM(s) for break possibilities until -it gets back a BP whose stacking dimension could fill the -line. This means that the BP.stackdim.max >= LineIPD.min. It can look -for further BP, perhaps one whose stackdim.opt is closer to the -LineIPD.opt. If it isn't happy with the choice of break possibilities, -it can go past the end of the line to the next one, and then try to -find a hyphenation point between the last one which fits and the first -one which doesn't. If no possibility is found whose min/max values -enclose the available IPD, some constraint will be violated (and -reported in the log.) The actual strategy is up to the Line LM and -should be able to be easily replaced without changing the architecture -(Strategy pattern). -

-

The definition of a good break possibility depends on the -properties at the block and inline level which govern things such as -wrapping behavior and justification mode. For example, if lines are -not to be wrapped, only an explicit linefeed can serve as a BP. If -lines are wrapped but not justified then there is no requirement to -completely fill the IPD on each line, but a sophisticated layout -manager will try to achieve "aesthetic rag". -

-

Note that no areas have actually been created yet. Once the LineLM -has found a potential break point for the inline content, it can -calculate the total size of the line area which would be created. The -size in the IPD is determined by the Line LM based on the chosen BP. -The size of the line area in the the block-progression-dimension -depends on the size of the text (or other inline content). These -values are set by the inline-level LM -in their returned BP (in terms of ascender and descender heights with -respect to the baseline). The LineLM adds spacing implied by the -current line-stacking strategy and line-height property values. It -stores a reference to the chosen inline BP and "wraps" that in its own -Position object which it stores in the BP it returns to its parent LM -(the block layout manager). -

The block LM now has a potential break position after its -first line. It assigns that possibility a cost, based on widow, orphan -and keep properties. It can also calculate the total size of the block -area it would create, were it to end the area after this line. It does -this by adding any padding and border (taking into account -conditionality). It also calculates space-before and space-after -values, or contributes to building up a sequence of such values. -With this information, the block LM creates a new BP (or -updates the existing one). It stores a Position object in this -BP which wraps the returned BP from its child Line LM. -It returns the new BP to its parent and so on, back up to the -FlowLM.

-

Obviously there is more complicated logic involved when dealing -with lists and tables. These cases need to be walked through in detail.

-

The FlowLM sees if the returned stacking dimension will still -fit in its available block-progression-dimension (BPD). It repeatedly calls -getNextBreakPoss on its -child LMs until it reaches the maximum BPD for the flow reference area -or until there is no more content to lay out. If one child LM is -finished, it moves on to the next until the last child LM has returned -a BP with the ISLAST flag set. If any child LM returns a -BP with a FORCE_BREAK_BEFORE or SPAN flag set, the FlowLM will -force layout of any pending break possibilities and return to its -parent (the PageLM) in order to handle the break or span condition.

-

If the returned BP has any new before-float or footnote anchors in -it (ANCHOR flag in the -BP), the FlowLM will also return to the PageLM. The PageLM must then -try to find space to place the floats, possibly asking the FlowLM for -help if the body contains multiple columns.

-
-
- Some issues -

Following are a few remarks on specific issues.

-
- Where Line Layout Managers are created -

If the first child FO in a block FO is an inline-level FO -such as text, the block LM creates an intermediate level LineLM -to layout the -sequence of inline content into Lines. Note that the whole sequence of -inline FOs is managed by a single instance of LineLM. The LineLM -becomes the parent to the various inline-level LM created by each -individual inline FO. -Since an fo:block can have both block and inline content, its LM -may create a sequence of intermixed BlockLM and LineLM.

-
-
- Getting the reference IPD -

When the layout process starts, with the FlowLM asking its first -child LM for a break possibility, the IPD isn't known, since we don't -know whether -the first FO might be spanning, or on which page it might start. (Of -course, if all page masters in the sequence have the same region-body IPD -and all have only a single column, the IPD will never change -and could already be calculated before starting layout.) -The FlowLM gets its -first child LM and calls its getNextBreakPoss method. That is a child LM for -some block-level FO. For now, suppose it's an fo:block. The BlockLM -will create its first child LM, which may be another block-level LM in -the case of nested blocks or a LineLM as explained above. (Question: -do we need a START flag for layout status?) -

-

We keep calling getNextBreakPoss on lower level layout managers until we -get down to the inline level or to a level which cannot have break-before -properties, such as a list-item-label. At that point, we assume we are -going to have to layout some actual content. But we can't do that yet -since we don't know the inline-progression-dimension. So we return a -BP object which has 0 size in the stacking dimension, but which -has flags set to signal to -higher-level layout managers what needs to be done. If it has a break-before -property or a span property, it stores these in the BP. If -no reference IPD is yet defined, it sets a flag to get that. It then -returns to its parent. The parent LM will inspect the BP object -returned. In general, it "wraps" it with information about its own -needs. If the returned BP is not actually returning any potential -areas, the LM can still add information about its own break or span -requirements. This return path continues back up to the PageLM. It -will then check break and span requirements and create a new page -if necessary using the appropriate page-master. At that point, the -reference IPD for the main -flow is known and is set in the flags object used for -the next getNextBreakPoss call to the lower level LM. -

Using this information, the BlockLM parent can now calculate -the available IPD for its LineLM child, based on its indents. -(If there are any -side-floats information about the intrusion must be passed down by the -FlowLM to lower level managers.) The LineLM can now generate a series -of BreakPoss objects, which it passes back to its parent LM. -

-
-
- Hyphenation -

-The LineLM is responsible for initiating hyphenation if it is allowed -by the properties and if no satisfactory BP can be found without -hyphenating. The hyphenation manager is passed two break -possibilities, one whose IPD is less than the desired line area IPD -and one whose IPD is greater. These break possibilities might have -been generated by different inline-level layout managers (text + a -wrapper with a color change for example), though -frequently they represent two positions in a single text run. -If hyphenation is successful, a new BP is -returned. The LineLM may look for several intermediate BP -based on the "cost" of the returned possibilities. If no intermediate -BP is found, the line will be "short", the white-space stretch will be -exceeded, or perhaps the content will be overflowed or clipped, -depending on various property settings.

-
-
- Optimizing -

It obviously seems inefficient to go down to the lowest level -LM and back up to the FlowLM for every possible line-break -decision. It seems like it would be possible to optimize by letting -the lower level layout managers run until they had exceeded the -current limit in -the stacking direction. They would then return control to the "galley" -level (LineLM or FlowLM) which would fine-tune the break decision by -asking the lower level LM to find a previous BP which would fit. At -the inline level, this means hyphenation as described above.

-

Another interesting question is at what point pending break -possibilities can be turned into areas.The idea is to wait until we -are sure we won't have to redo the breaking. This depends on the -sophistication of the layout strategy. For example, if a -linebreak can be considered final if the line is full and there are no -anchors on the line, we could create the LineArea at that point. But -if we are willing to change a previous line-end decision to get a -better overall composition of a whole group of lines (to prevent multiple -hyphens for example), we might wait until the LineLM had finished -laying out all its material and then make all the Lines at once.

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/configuration.xml b/src/documentation/content/xdocs/dev/design/configuration.xml deleted file mode 100644 index 64ba74813..000000000 --- a/src/documentation/content/xdocs/dev/design/configuration.xml +++ /dev/null @@ -1,205 +0,0 @@ - - - - - - - -]> - - -
- Apache™ FOP: Configuration and Logging - $Revision$ -
- - - -
- Configuration File Basics -

The Apache™ FOP configuration file is an XML file containing a -variety of settings that are useful for controlling FOP's -behavior, and for helping it find resources that you wish it to -use.

-

The easiest way to get started using a FOP configuration file -is to copy the sample found at {fop-dir}/conf/fop.xconf -to a location of your choice, and then to edit it according to your -needs. It contains templates for the various configuration options, -most of which are commented out. Remove the comments and change the -settings for entries that you wish to use. Be sure to follow any -instructions, including comments which specify the value range. Also, -since the configuration file is XML, be sure to keep it -well-formed.

-
- -
- Making Configuration Available to FOP -

After creating your configuration file, you must tell FOP how -to find it.

- -
- From the Command Line -

When you run FOP from the command-line, use the -&ldquo;-c&rdquo; command-line option with the path to the -configuration file as the option value.

-
- -
- A Configuration File in an Embedded Application -

FOP uses the Avalon framework configuration package -org.apache.avalon.framework.configuration. For detailed -information, see the documentation of the package.

-

If you want to use a user configuration file with your -embedded program, you need to build an Avalon configuration -object from it, and register that with the user agent:

- - FOUserAgent foUserAgent; -XMLReader parser; -DefaultConfigurationBuilder configBuilder; -File userConfigFile; -Configuration userConfig; - -configBuilder = new DefaultConfigurationBuilder(parser); -userConfigFile = new File("YourConfigFile.xml"); -userConfig = configBuilder.buildFromFile(userConfigFile); -foUserAgent.setUserConfig(userConfig); - -

You can find example code in FOP's -apps.CommandLine class, method -createUserConfig.

-
- -
- Programmatically Building the Configuration -

You can also build the configuration object programmatically, -instead of building it from an external file. Make sure that the -configuration object is equivalent to a configuration object that -would be obtained from a correct configuration file. Register the -configuration object with the user agent as described above.

-
- -
- -
- The Configuration File -

The top-level element is arbitrary. You may give it any name -that is useful for you, e.g. <fop-configuration -version="2">.

-

Inside the top-level element the configuration may contain -three sections: userAgent, renderers, -and hyphenation. At the moment of this writing the -userAgent and hyphenation sections are -not used by FOP.

-

The renderers section has subsections called -renderer. There may be one subsection for each type -of renderer. The renderers are identified by their MIME type, -which is given in the mime attribute. For example: -<renderer mime="application/pdf">. The content -of each renderer subsection depends on the type of -renderer.

-

The PDF renderer (MIME type application/pdf) has -several options:

-
-
filterList
-
Contains a number of value elements, whose -content specify a filter which should be applied. Possible -filters are: flate, ascii-85, -ascii-hex. The flate filter is on by -default.
-
fonts
-
Contains a number of font elements. Each -font element represents a font file, -e.g. arial.ttf. It contains a number of -font-triplet elements, defining the font triplets -which are provided by this font file. See the example -configuration file for details.
-
-

The example configuration file provides for details about the -other renderers.

-
- -
- Hyphenation -

When FOP needs to load a hyphenation file for a certain -language and country combination, it follows these steps.

-
    -
  1. FOP searches for the compiled hyphenation file (extension -hyp in the directory hyph in the -class path.
    2. -
  2. FOP searches for the compiled or the XML hyphenation file -in a user directory. At the time of this writing FOP does not -read the configuration file for the user directory. It always -uses the directory /hyph.
    3. -
-

It is possible to add user hyphenation files to FOP's -hyphenation directory when FOP is built. The directory -containing user hyphenation files must be specified in the -variable user.hyph.dir in the local build -properties file. All hyphenation files in the directory are -compiled, and the compiled files are added to the hyphenation -directory in the build directory.

-

See FOP: Hyphenation for -more information on creating and modifying hyphenation within FOP.

-
- -
- Fonts -

Font configuration information is included in the FOP -configuration file as describe above. It is documented in more -detail at FOP: Fonts. Note -especially the section entitled Register Fonts with FOP.

-
- -
- Logging -

FOP uses the Jakarta Commons logging package -org.apache.commons.logging. For detailed information, see -the documentation of the package.

-

Commons logging is entirely configured by the user, using -Java system properties. Configuration happens in two stages.

-

First you configure which logging implementation you want -to use. For example:

- org.apache.commons.logging.Log - =org.apache.commons.logging.impl.SimpleLog -

SimpleLog is the default logging package on most Java -systems. On Java 1.4 systems JDK 1.4 is the default.

-

Secondly, you configure the selected logging package. How -this is done depends on the logging package. The most important -feature is the log level. The default is level &ldquo;info&rdquo;. An -example configuration file for SimpleLog is:

- -# logging level for all loggers, default info -org.apache.commons.logging.simplelog.defaultlog=info - -# logging level for named loggers -org.apache.commons.logging.simplelog.log.xxxxx=debug -org.apache.commons.logging.simplelog.log.org.apache.fop.pdf=trace - -

FOP uses several named loggers. When you set the logging level -for all loggers to &ldquo;info&rdquo;, you get a decent small amount -of information -about application progress. The debugging and especially the trace -levels produce a lot of output. If you need these logging levels, -it is wise to switch them on for one or several specific loggers. The -names of the loggers can be found in the source files. Many loggers -bear the name of their package, their class or of a superclass.

-
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/embedding.xml b/src/documentation/content/xdocs/dev/design/embedding.xml deleted file mode 100644 index 075e4b152..000000000 --- a/src/documentation/content/xdocs/dev/design/embedding.xml +++ /dev/null @@ -1,149 +0,0 @@ - - - - - - -
- Apache™ FOP Design: Embedding Apache� FOP in Other Applications - $Revision$ - - - -
- - -
- Introduction -

-This is the design for the external interface when Apache™ FOP is to be embedded -inside another java application. -

-

-Common places where FOP is embedded is in a report production application -of a server side application such as Cocoon. -

-
-
- Settings -
- User Agent -

-Possible meanings for a user agent: -

-
    -
  • something that makes decisions where the specifiction indicates -that the user agent should decide
    • -
  • FOP as the user agent, represented by a class that handles -various setup and decision values
    • -
  • an class that handles context for a particular FOP conversion -that can be configured/overridden when embedding
    • -
- -

-The user agent is responsible for supplying user or context -specific information. The list of user agent values can be found on the -User Agent page. -

-
-
- Logging -
    -
  • logging level
    • -
  • logging messages of various levels
    • -
  • error handling
    • -
  • Logging setup (LogKit, Log4J, JDK14Logging)
    • -
-
-
- XML input -
    -
  • various ways to supply FOP with the xsl:fo file, fo, xml+xsl
    • -
  • sax handler
    • -
-
-
- general options -
    -
  • base url
    • -
  • uri resolvers
    • -
  • which implementation of a particular LayoutManager to use
    • -
-
-
- Rendering Options -
    -
  • embedding fonts
    • -
  • compression in pdf
    • -
  • image embedding
    • -
-

-for the PS renderer (eventually): -

-
    -
  • PostScript Level
    • -
  • PPD to use
    • -
  • binary/ascii switch
    • -
-
-
- Render Results -

-Generate Output statistics from FOP: -

-
    -
  • Number of pages total
    • -
  • Number of pages of each page-sequence
    • -
  • page-master used for each page (could be used to control -the paper bin to get paper from, important for me in conjunction -with PS Renderer)
    • -
  • recoverable errors such as overflow
    • -
-
-
- Setting Up -

-The Driver handles the XML input. -The user agent information is through the FOUserAgent. -Handle logging through the user agent. -Options could also be handled through the user agent, using mime type -selection for renderer options. -

-
-
- Others -

-Render to more than one renderer at once (maybe not from the command line). -For example you could generate a PDF for the archive -and the PS for the printer in one run. It would probably be faster than -converting the PDF to PostScript afterwards. -Make the fo tree reuseable. -If the fonts are the same then use the -same area tree to output to different renderers. -

-

-Several code pieces for resolving URLs and/or -file locations are scattered all over FOP and Batik. These should -be replaced with an URIResolver invocation to unify behaviour and -remove redundancies. -

-
-
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/extending.xml b/src/documentation/content/xdocs/dev/design/extending.xml deleted file mode 100644 index f383ee186..000000000 --- a/src/documentation/content/xdocs/dev/design/extending.xml +++ /dev/null @@ -1,140 +0,0 @@ - - - - - - -
- Apache™ FOP Design: Extensions - $Revision$ - - - -
- - -
- Introduction -

-Apache™ FOP provides an extension mechanism to add extra functionality. There -are a number of different types of extensions that apply to different -steps when converting FO into the rendered output. -

-
-
- Extensions -

-SVG Graphic - This applies to svg and any other xml document that -can be converted into svg in the output. All that is required is -the element mapping for the xml and a converter that changes the -document into svg. This conversion is done in the FO Tree. The -conversion is done by the top level element of the namespace -or in the case of an external image a Converter. -

-

-XML Document - Instead of converting the document into svg it -can be passed directly to the renderer. The renderer will need -to have a handler for the xml document. This handler can add -information directly to the output document. -

-

-Output Document - This is used to add document level information -to the output result. Such an extension will set information that -is passed to the output document. The area tree handles these -extensions and passs along the information to the renderer. -The extension may contain resolveable objects. The extension -can be passed to the renderer once resolve either immediately, -after the next page or at the end of the document. This is so that -the extension can be handled according to other associated data. -

-

-FO Area - This is where an extension creates an normal or extended -area in the Area Tree. This is useful when the normal FO objects -cannot create the area in the way that is needed. -

-

-Resolveable - In some cases it may require information to be -resolved for information such as page numbers. This can apply -to the XML Document, FO Area or output document extensions. -

-
    -
  • Add a string ['(Continued)'] to a table header if the table spans -multiple pages. These tables are part of the content and can start -anywhere in the page.
    • -
  • Separate page number display for a subsection. ie. - master document -is page 4 of 7, but subsection is page 2 of 3.
    • -
-
-
- Examples -

-Plan - The plan extension is a simple SVG graphic extension. -Given a plan document either inside an InstreamForeignObject -or as an external graphic, it converts the plan document into -an svg graphic. The svg graphic is then passed through the -Area Tree to the Renderer. The Renderer then renders the svg -graphic as normal. -

-

-PDF Outline - This is output document extension. If rendering to -pdf and this extensionis used then the bookmark information is -passed to the pdf document. This information is then set on the -document. -

-

-PDF Additions - This can be done with an XML Document extension. -A simple xml document is defined that provides the appropriate -information. When the document is rendered a handler converts the -document into PDF markup. -

-

-For example:

- -Search -]]> -

-to result in a text box referencing the following PDF action:

->]]> - -
-
- Status -
- To Do -
-
- Work In Progress -
    -
  • mathml extension
    • -
  • another xml -> svg extension
    • -
  • svg text normal text if that can be handled otherwise stroked this is done automatically
    • -
-
-
- Completed -
    -
  • svg now in an xml handler, FOP can be used without batik
    • -
  • bookmark extension improved a bit - changed bookmark extension, now requires a wrapping element bookmark
    • -
-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/fotree.xml b/src/documentation/content/xdocs/dev/design/fotree.xml deleted file mode 100644 index 03f98d830..000000000 --- a/src/documentation/content/xdocs/dev/design/fotree.xml +++ /dev/null @@ -1,143 +0,0 @@ - - - - - -
- Apache™ FOP Design: FO Tree - $Revision$ - - - -
- -
- Introduction -

The FO Tree is an internal hierarchical representation (java objects and properties) of the input XSL-FO document, and is created from the parsing of that XSL-FO document. -The process of building the FO Tree corresponds to the Objectify step in the XSL-FO spec. -The FO Tree is an intermediate structure which will later be converted into the area tree.

-
-
- Processing -

The SAX Events that are fired by the parsing process are caught by the FO Tree system. -Events for starting an element, ending an element, and text data are assembled by the FO Tree system into a set of objects that represent the input FO document. -A class exists for each element in the XSL-FO set, and an object in the appropriate class is created for each element in the input XSL-FO.

-

For attributes attached to an XSL-FO element, a property list mapping is used to convert the attribute into properties of the object related to the element.

-

To the extent possible, validation is checked as the FO Tree is built. An appropriate error message is returned to the user, and processing continues if possible.

-

Elements from foreign namespaces that are recognized by FOP fall into the following categories:

-
    -
  • Pass-thru: These are placed into a DOM object, which is then passed through FOP directly to the renderer. SVG is an example.
    • -
  • FOP Internal: These are placed into objects that can then be used by FOP. An example of this would be an element that the layout process will use to create an area. Another example would be an element that contains setup information for the renderer.
    • -
-

For unrecognized namespaces, a dummy object or a generic DOM is created.

-

While the tree building is mainly about creating the FO Tree, some FO Tree events trigger processes in other parts of FOP. -The end of a page-sequence element triggers the layout process for that page-sequence (see discussion of Recycling). -Also, the end of the XML document tells the renderer that it can finalize the output document.

-
-
- Recycling FO Tree Memory -

To minimize the amount of memory used by FOP, we wish to recycle FO Tree memory as much as possible. -There are at least three possible places that FO Tree fragments could be passed to the Layout process, so that their memory can be reused:

-
    -
  • - fo:block It might be tempting to start laying out pages as soon as the first fo:block object is finished. However, there are many downstream things that can affect the placement of that block on a page, such as graphics and footnotes. So, in order to maintain conformance to the XSL-FO specification, and create high-quality output, we must see more of the document.
    • -
  • - fo:root The other extreme is to wait until the entire document is read in before processing any of it. This essentially means that there is no memory recycling. Processing the document correctly is more important than saving memory, so this option would be used if there were no better alternative.
    • -
  • - fo:page-sequence The page-sequence object provides a nice clean break in the document. Content from one page-sequence will never interfere with nor affect the placement of the content of another. FOP uses this option as the optimum way to maintain compliance with the standard and to minimize memory consumption.
    • -
-
-
- FO Tree Serialization -

This issue is implied by the requirement to process documents of arbitrary size. Unless some arbitrary limit is placed on the size of page-sequence objects, FOP must be able to serialize FO tree fragments as necessary.

-
-
- Notes About Specific Elements -
- page-master -

The first elements in a document are the elements for the page master setup. -This is usually only a small number and will be used throughout the document to create new pages. -The root element keeps these objects as a factory to create the page and appropriate regions whenever a new page is requested by the layout. -The objects in the FO Tree that represent these elements are themselves the factory.

-
-
- flow -

The elements within the flow of a page-sequence are those that are needed for the layout process. -These element will later be used to create areas in the layout process.

-
-
- Other Elements -

The remaining FO Objects are things like page-sequence, title and color-profile. -Each is handled by its parent element. -The root handles declarations, and declarations maintains a list of colour profiles. -The page-sequences are direct descendants of root.

-
-
-
- Implementation Notes -
- FONode -

The base class for all objects in the tree is FONode. The base class for -all FO Objects is FObj (which is a subclass of FONode). Other FONode subclasses are for foreign and unknown XML.

-

Each FO in FOP has a parent (except root) and a Vector of children. Java inheritance (superclasses and subclasses) is used to enforce constraints required by the FO hierarchy.

-

FONode, among other things, ensures that each FO has a parent, and provides the mechanism for keeping track of its children.

-

Each xml element is represented by a java object. -The classes for these objects are grouped into packages for convenience:

-
    -
  • pagination: org.apache.fop.fo.pagination.*
    • -
  • flow: org.apache.fop.fo.flow.*
    • -
  • other: org.apache.fop.fo.*.
    • -
-
-
- Creating FO Objects -

The process of creating an FO Object is as follows (see FOTreeBuilder.startElement() for details):

-
    -
  • An FO maker is selected from a hashmap lookup using the namespace and -element name.
    • -
  • This maker is then used to create the new object that represents the FO element.
    • -
  • The new object is given its element name, an FOUserAgent (for resolving properties, etc.), a logger and its attributes.
    • -
  • The new object is added to the FO tree as a child of the current parent.
    • -
  • Child elements are then processed. This is an iterative process: the child elements go through the same process here documented for their parent.
    • -
-
-
- Foreign XML -

For SVG, the DOM needs to be created with Batik, so an element mapping is used to read all elements in the SVG namespace and pass them into the Batik DOM.

-

The base class for foreign XML is XMLObj. This class handles creating a -DOM Element and the setting of attributes. It also can create a DOM -Document if it is a top level element, class XMLElement. -This class must be extended for the namespace of the XML elements. For -unknown namespaces the class is UnknowXMLObj.

-

If some special processing is needed, then the top level element can extend -the XMLObj. For example the SVGElement makes the special DOM required for -batik and gets the size of the svg.

-

Foreign XML will usually be in an fo:instream-foreign-object. -The XML will be passed to the renderer as a DOM, which is expected to know how to handle it. -XML from an unknown namespace will be ignored.

-

See Input Parsing Namespaces for more discussion and links to information about using foreign XML in FOP.

-
-
- Unknown Elements -

If an element is in a known namespace but the element is unknown within that namespace, then an Unknown object is created. -This generally indicates an input error: perhaps an element from an older version of the XSL-FO standard, or a misspelling. -The Unknown object is mainly used to provide information to the user.

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/images.xml b/src/documentation/content/xdocs/dev/design/images.xml deleted file mode 100644 index ee6b3dc6f..000000000 --- a/src/documentation/content/xdocs/dev/design/images.xml +++ /dev/null @@ -1,151 +0,0 @@ - - - - - - -
- Apache™ FOP Design: Images - $Revision$ -
- - -
- Introduction - -

Images may only be needed to be loaded when the image is rendered to the -output or to find the dimensions.
-An image url may be invalid, this can be costly to find out so we need to -keep a list of invalid image urls.

-

We have a number of different caching schemes that are possible.

-

All images are referred to using the url given in the XSL:FO after -removing "url('')" wrapping. This does -not include any sort of resolving such as relative -> absolute. The -external graphic in the FO Tree and the image area in the Area Tree only -have the url as a reference. -The images are handled through a static interface in ImageFactory.

-
- -
- Threading - -

In a single threaded case with one document the image should be released -as soon as the renderer caches it. If there are multiple documents then -the images could be held in a weak cache in case another document needs to -load the same image.

- -

In a multi threaded case many threads could be attempting to get the same -image. We need to make sure an image will only be loaded once at a -particular time. Once a particular document is finished then we can move -all the images to a common weak cache.

-
- -
- Caches -
- LRU -

All images are in a common cache regardless of context. To limit the size -of the cache the LRU image is removed to keep the amount of memory used -low. Each image can supply the amount of data held in memory.

-
- -
- Context -

Images are cached according to the context, using the FOUserAgent as a key. -Once the context is finished the images are added to a common weak hashmap -so that other contexts can load these images or the data will be garbage -collected if required.

-

If images are to be used commonly then we cannot dispose of data in the -FopImage when cached by the renderer. Also if different contexts have -different base directories for resolving relative url's then the loading -and caching must be separate. We can have a cache that shares images among -all contexts or only loads an image for a context.

-
- -

The cache uses an image loader so that it can synchronize the image -loading on an image by image basis. Finding and adding an image loader to -the cache is also synchronized to prevent thread problems.

-
- -
- Invalid Images - -

-If an image cannot be loaded for some reason, for example the url is -invalid or the image data is corrupt or an unknown type. Then it should -only attempt to load the image once. All other attempts to get the image -should return null so that it can be easily handled.
-This will prevent any extra processing or waiting.

-
- -
- Reading -

Once a stream is opened for the image url then a set of image readers is -used to determine what type of image it is. The reader can peek at the -image header or if necessary load the image. The reader can also get the -image size at this stage. -The reader then can provide the mime type to create the image object to -load the rest of the information.

-
- -
- Data - -

The data usually need for an image is the size and either a bitmap or the -original data. Images such as jpeg and eps can be embedded into the -document with the original data. SVG images are converted into a DOM which -needs to be rendered to the PDF. Other images such as gif, tiff etc. are -converted into a bitmap. -Data is loaded by the FopImage by calling load(type) where type is the type of data to load.

-
- - -
- Rendering - -

Different renderers need to have the information in different forms.

- - -
- PDF -
original data
JPG, EPS
-
bitmap
gif, tiff, bmp, png
-
other
SVG
-
- -
- PS -
bitmap
JPG, gif, tiff, bmp, png
-
other
SVG
-
- -
- awt -
bitmap
JPG, gif, tiff, bmp, png
-
other
SVG
-
- -

The renderer uses the url to retrieve the image from the ImageFactory and -then load the required data depending on the image mime type. If the -renderer can insert the image into the document and use that data for all -future references of the same image then it can cache the reference in the -renderer and the image can be released from the image cache.

-
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/index.xml b/src/documentation/content/xdocs/dev/design/index.xml deleted file mode 100644 index 2ea9ee201..000000000 --- a/src/documentation/content/xdocs/dev/design/index.xml +++ /dev/null @@ -1,160 +0,0 @@ - - - - - -
- Apache™ FOP Design: Introduction - $Revision$ - - - -
- - The articles in this section pertain mainly to the redesign or trunk line of development. -The redesign is mainly focusing on parts of the layout process (converting the FO tree into the Area Tree). -Therefore other (non-layout) sections in this document are probably largely accurate for the maintenance branch, but should be used with care in that context. -
- The Black Box View -

From a user's standpoint, Apache™ FOP is a black box that an xml file as input, performs some magic, then creates the desired output:

- - - - - - - - - - - - - - -
Apache� FOP from a User's Standpoint
ProcessResult
.XSL-FO document
FOPOutput: PDF, Postscript, Print, etc.
-

Although this is simple, it is useful in defining the outer limits of FOP's core processing. -There may be other things going on under FOP's control that are not really part of FOP. -For example, FOP provides a convenience mechanism that takes semantic XML + an XSLT transformation as input, instead of XSL-FO. -This is done outside of FOP's core processing (by Xalan), and it is therefore outside the scope of FOP's design, and outside the scope of the FOP design documents.

-
-
- Primary Design Goals -

A discussion of project design properly begins with a list of the goals of the project. -Out of these goals will flow the design issues and details, and eventually, the implementation.

-
- Conformance to the XSL-FO Specification -

The current design goal is to reach the "basic" level of conformance, and to have enough flexibility in the design to reach "complete" conformance without major rewriting. -After "basic" conformance is achieved, it is probable that higher levels of conformance will be sought.

-
-
- Process Files of Arbitrary Size -

Except for user storage limitations, the design goal is to be able to process files of any size. In a separate but related issue, the design goal is to be able to process page-sequence elements of any size. (See Recycling FO Tree Memory for a discussion of the use of page-sequence as a logical subdivided "chunk" on an FO document).

-
-
-
- Secondary Design Goals -
- Minimize Memory Use -

Many FOP design decisions revolve around trying to minimize the use of memory. -The primary purpose here is to reduce the amount of data that must be serialized to storage during processing. -Since our primary design goals include the ability to process files of arbitrary size, there is no way to avoid the need to serialize. -However, many FOP users provide web access to documents that are created in real time. -Performance is therefore an important issue in these real-world applications. -To the extent that it can be done so without jeopardizing the primary design goals, FOP developers have identified keeping a small memory footprint as being an important secondary goal.

-
-
-
- The Big Picture View -

With our design goals outlined, we'll now open the Black Box and look at the major processes inside. -FOP has adopted the basic structure of the XSL-FO standard itself as a convenient model for the major processes in FOP. The Result in each row is the input for the next.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FOP's Big Picture Design
ProcessProcess Result/Input for NextNotes
.XSL-FO document.
ParsingFO Tree.
RefinementRefined FO Tree.
LayoutArea TreeLayout and Area Tree are not needed or used for the structural outputs (MIF and RTF), as they are not paginated.
RendererOutput: PDF, Postscript, Print, etc..
-

In general, each piece of data will be processed in the same way. -However, some information may be used more than once, and some may be used out of order. -To reduce memory, one process may start before the previous process is completed.

-

For a detailed discussion of the design of any component, follow its link in the table above. -Each component outlines the design issues which have already been addressed. -These resolution of these design issues is in support of the primary and secondary goals, so they are not necessarily written in stone. -However, most of them have been discussed at length among the developers, and are reasonably well settled.

-
- - -
- Vocabulary -

This section will attempt to provide information about any jargon used in the design documentation.

-

There is a rough relationship between terms used to describe the various trees in XSL-FO processing, all of which come from the XML and XSL-FO standards. In the table below, the terms (but not the actual items) in each column are roughly equivalent to each other:

- - - - - - - - - - - - - - - - - - - - - -
Tree ConceptThing (Noun)Descriptive Item (Adjective)
XMLElementAttribute
FO TreeObjectProperty
Area TreeAreaTrait
-
    -
  • LM: Layout Manager.
    • -
  • PLB: PropertyListBuilder.
    • -
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/layout.xml b/src/documentation/content/xdocs/dev/design/layout.xml deleted file mode 100644 index 394fa4763..000000000 --- a/src/documentation/content/xdocs/dev/design/layout.xml +++ /dev/null @@ -1,407 +0,0 @@ - - - - - -
- Apache™ FOP Design: Layout - $Revision$ - - - -
- -
- Introduction -

The role of the layout managers is to build the Area Tree by using the information from the FO Tree. -The layout managers decide where information is placed in the area tree.

-

A layout manager is typically associated with an FO Object but not always.

-

The layout managers are in between the FO Tree and the Area Tree. -They get information from the FO Tree and create areas and build the pages. -They hold the state of the layout process as it builds up the areas and pages. -They also manage the handling of breaks and spacing between areas.

-

FO Objects can have two types of properties, ones that relate to the layout and ones that relate to the rendering. -The layout related properties area used by the layout managers to determine how and where to create the areas. -The render related properties should be passed through to the renderer in the most efficient way possible.

-

The aim of the layout system is to be self contained and allow for easy changes or extensions for future development. -For example the line breaking should be decided at a particular point in the process that makes it easier to handle other languages.

-

The layout begins once the hierarchy of FO objects has been constructed. -Note: it may be possible to start immediately after a block formatting object has been added to the flow but this is not currently in the scope of the layout. -It is also possible to layout all pages in a page sequence after each page sequence has been added from the xml.

-

The layout process is handled by a set of layout managers. -The block level layout managers are used to create the block areas which are added to the region area of a page.

-

The traversal is done by the layout or structure process only in the flow elements.

-
-
- Design Issues -
- Keep Layouts Simple -

Layout should handle floats, footnotes and keeps in a simple, straightforward way.

-
-
- Keep ID References Simple -
-
- Render Pages ASAP -

The issue here is that we wish to recycle the Area Tree memory as much as possible. The problem is that forward references prevent pages from being resolved until the forward references are resolved. If memory is insufficient to store unresolved pages, Area Tree fragments must be serialized until resolved.

-

FOP developers have discussed adding the capability of using an Area Tree to render to more than one output target in the same run, which would be a complicating factor in disposal of pages as they are rendered.

-
-
-
- Layout Managers -

The layout managers are set up from the hierarchy of the formatting object tree. -A manager represents a hierachy of area producing objects. -A manager is able to handle the block area(s) that it creates and organise or split areas for page breaks.

-

Normally any object that creates a block area will have an associated layout manager. -Other cases are tables and lists, these objects will also have layout managers that will manager the group of layout managers that make up the object.

-

A layout manager is also able to determine height (min/max/optimum) and keep status. -This will be used when organising the layout on a page. -The manager will be able to determine the next place a break can be made and then be able to organise the height.

-

A layout manager is essentially a bridge between the formatting objects and the area tree. -It will keep a list of line areas inside block areas. -Each line area will contain a list of inline areas that is able to be adjusted if the need arises.

-

The objects in the area tree that are organised by the manager will mostly contain the information about there layout such as spacing and keeps, this information will be thrown away once the layout for a page is finalised.

-
-
- Creating Managers -

The managers are created by the page sequence. -The top level manager is the Page manager. -This asks the flow to add all managers in this page sequence.

-

For block level objects they have a layout manager. -Neutral objects don't represent any areas but are used to contain a block level area and as such these objects will ask the appropriate child to create a layout manager.

-

Any nested block areas or inline areas may be handled by the layout manager at a later stage.

-
-
- Using Managers -

Block area layout managers are used to create a block area, other block level managers may ask their child layout managers to create block areas which are then added to the area tree(subset).

-

A manager is used to add areas to a page until the page is full, then the manages contain all the information necessary to make the decision about page break and spacing. -A manager can split an area that it has created will keep a status about what has been added to the current area tree.

-
-
- Page Layout -

Once the Page layout manager, belonging to the page sequence, is ready then we can start laying out each page. -The page sequence will create the current page to put the page data, the next page and if it exists -a last page.

-

The current page will have the areas added to it from the block layout -managers. -The next page will be used when splitting a block that goes over the page break. -Note: any page break overrides the layout decided here. -The last page will be necessary if the last block area is added to this page. -The size of the last page will be considered and the areas will be added to the last page instead.

-

The first step is to add areas to the current page until the area is full and the lines of the last block area contain at least n(orphans) and at least n(orphans) + n(widows) in total. -This will only be relevant for areas at the start or end of a particular reference area.

- -

The spacing between the areas (including spacing in block areas inside an inline-container) will be set to the minimum values. -This will allow the page to have at least all the information it needs to organise the page properly.

-

This should handle the situation where there are keeps on some block areas that go over the end of the page better. -It is possible that fitting the blocks on the page using a spacing between min and optimum would give a closer value to the optimum than putting the blocks on the next page and the spacing being between optimum and max. -So if the objects are placed first at optimum then you will need to keep going to see if there is a lower keep further on that has a spacing that is closer to the optimum.

-

The spacing and keep information is stored so that the area positions -and sizes can be adjusted.

-
-
- Balancing Page -

The page is vertically justified so that it distributes the areas on the page for the best result when considering keeps and spacing.

-
-
- Finding Break -

First the keeps are checked. -The available space on the page may have changed due to the presence of before floats or footnotes. -The page break will need to be at a height <= the available space on the page.

-

A page break should be made at the first available position that has the lowest keep value when searching from the bottom. -Once the first possible break is found then the next possible break, with equally low keep value, is considered. -If the height of the page is closer to the optimal spacing then this break will be used instead.

-

Keep values include implicit and explicit values when trying to split a block area into more than one area. -Implicit keeps may be such things as widows/orphans.

-

If the page contains before floats or footnotes then as each area or line area is removed the float/footnote should also be removed. -This will change the available space and is a one way operation. -The footnote should be removed first as a footnote may be placed on the next page. -The lowest keep value may need to be reassessed as each conditional area is removed.

-

The before float and footnote regions are managed so that the separator -regions will be present if it contains at least one area.

-
-
- Optimising -

Once the areas for the page are finalised then the spacing will need to be adjusted. -The available height on the page is compared with the min and max spacing. -All of the spacing in all the areas on the page is then adjusted by the appropriate percentage value.

-
-
- Multi-Column Pages -

In the case of multi-column pages the column breaks and eventually the page break must be found in a slightly different way.

-

The columns need to be layed out completely from first to last but this can only be done after a rough estimate of all the elements on the page in case of before floats or footnotes.

-

So first the complete page is layed out with all columns filled with areas and the spacing at a minimum. -Then if there are any before floats or footnotes then the availabe space is adjusted. -Then each the best break is found for each column starting from the first column. -If any before floats or footnotes are removed as a result of the new breaks and optimised spacing then all the columns should still be layed out for the same column height.

-
-
- Completing Page -

After the region body has been finished the static areas can be layed out. -The width of the static area is set and the height is inifinite, that is all block areas should be placed in the area and their visibility is controlled be other factors.

-

The area tree for the region body will contain the information about markers that may be necessary for the retrieve marker.

-

The ordering of the area tree must be adjusted so that the areas are before, start, body, end and after in that order. -The body region should be in the order before float, main then footnote.

-
-
- Line Areas -

Creating a line areas uses a similair concept. -Each inline area is placed across the available space until there is no room left. -The line is then split by considering all keeps and spacing.

-

Each word (group of adjacent character inline areas) will have keeps based on hyphenation. -The line break is at the lowest keep value starting from the end of the line.

-

Once a line has been layed out for a particular width then that line is fixed for the page (except for unresolved page references).

-
-
- Before Floats and Footnotes -

The before float region and footnote region are handled by the page layoutmanger. -These regions will handle the addition and removal of the separator regions when before floats/footnotes area added and removed.

-

Footnotes and Before Floats are placed in special areas in the body region -of the page. -The size of these areas is determined by the content. -This in turn effects the available size of the main reference area that contains the flow.

-

A layout manager handles the adding and removing of footnotes/floats, this in turn effects the available space in the main reference area.

-
-
- Side Floats -

If a float anchor is present in a particular line area then the available space for that line (and other in the block) will be reduced. -The side float adds to the height of the block area and this height also depends on the clear value of subsequent blocks. -The keep status of the block is also effected as there must be enough space on the page to fit the -side float.

-

Side floats alter the length of the inline progression dimension for the -current line and following lines for the size of the float.

-

This means that the float needs to be handled by the block layout manager -so that it can adjust the available inline progression dimension for the -relevant line areas.

- -
-
- Unresolved Areas -

Once the layout of the page is complete there may be unresolved areas.

-

Page number citations and links may require following pages to be layed out before they can be resolved. -These will remain in the area tree as unresolved areas.

-

As each page is completed the list of unresolved id's will be checked and if the id can be resolved it will be. -Once all id's are resolved then the page can be rendered.

-

Each page contains a map of all unresolved id's and the corresponding areas.

-

In the case of page number citations, the areas reserves the equivalent of 3 number nines in the current font. -When the area is resolved then the area is adjusted to its proper size and the line area is -re-aligned to accomodate the change.

-
- -
- Inline Areas -

This is the definition of all inline areas that will exist in the area.

-
-
- Fixed Areas -

instream-foreign-object, external-graphic, inline-container

-

These areas have a fixed width and height. They also have a viewport.

-
-
- Stretch Areas -

leader, inline space

-

These areas have a fixed height but the width may vary.

-
-
- Character Areas -

character

-

This is an simple character that has fixed properties according to the current font. -There are implicit keeps with adjacent characters.

-
-
- Anchor Areas -

float anchor, footnote anchor

-

This area has no size. -It keeps the position for footnotes and floats and has a keep with the associated inline area.

-
-
- Unresolved Page Numbers -

page-number-citation

-

A page number area that needs resolving, behaves as a character and has the space of 3 normal characters reserved. -The size will adjust when the value is resolved.

-
-
- Block Areas -

When a block creating element is complete then it is possible to build the -block area and add it to the paprent.

-

A block area will contain either more block areas or line areas, which are -special block areas. -The line areas are created by the LineLayoutManager in which the inline areas flow into.

-

So a block area manager handles the lines or blocks as its children and determines things like spacing and breaks.

-

In the case of tables and lists the blocks are stacked in a specific way that needs to be handled by the layout manager.

-

The block area has info about the following:

-
    -
  • all anchors including which lines they are on
    • -
  • unresolved page references with line info
    • -
  • id and link areas
    • -
  • height (min/max/optimum) or area including floats
    • -
  • holds space before/after and keep information
    • -
  • widows and orphans
    • -
-

Once the layout has been finalised then this information can be discarded.

-
-
- Page Areas -

Contains inforamtion about all the block areas in the body, before area and footer area.

-

Has a list of the unresolved page references and a list of id refences that can be used to obtain the area associated with that id.

-
-
- Test Cases -

Here a few layout possibilities areas explored to determine how the layout process will handle these situations.

-
- Simple Pages -

All blocks (including nested) are placed on the page with minimum spacing and the last block has the minimum number of lines past the page end. -The lowest keep value is then found within the body area limits. -Then the next equally low keep is found to determine if the spacing will be closer to the optimum values.

-
-
- Before Floats/Footnotes -

After filling the page with the block areas then the new body height is used to find the best position to break. -Before each line area or block area is remove any associated before floats and footnotes are removed. -This will then adjust the available space on the page and may allow for a different breaking point. -Areas are removed towards the new breaking point until the areas fit on the page. -When finding the optimum spacing the removal of before floats and footnotes must also be onsidered.

-
-
- Multicolumn -

First the page is filled with all columns for the intial page area. -Then each column is adjusted for the new height starting from the first column. -The best break for the column is found then the next column is considered, any left over areas a pre-pended to the next column. -Once all the columns are finished then all the columns are adjusted to fit in the same height columns. -This handles the situation where before floats or footnotes may have been removed.

-
-
- Last Page -

If in the process of adding areas to a page it is found that there are no more areas in the flow then this page will need to be changed to the last page (if applicable). -The areas are then placed on a last page.

-
-
-
- Status -
- To Do - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
TaskPriorityNotes
Keep PropertiesHighNeed to get keep-* properties working on block level constructs
Justified TextHighThis has been completed, thanks largely to Luca Furini. Although there is still issue 28706 -that requires further analysis.
Multi-column layoutHigh -
Get Markers WorkingHighMain Problem is markers can be added to wrong page. LEWP is returning first on Next page!
Absolutely positioned block containersHigh -
Background ImagesHigh -
Conditional space suppressionHigh -
Fix break-* propertiesHigh -
FootnotesMedium -
Relative positioned block containersMedium -
Fine-tuning line breaking and hypenationMedium -
Last page layoutMedium -
Aligned leaders, especially in justified textMedium -
Floats of all kindLow -
Border collapsing on tablesLowRenderX hasnt implemented this (17/03/04)
Fine-tuning all other bordersLowNot sure what Joerg means by this, border collapse priorties? -Dashed and dotted borders have been implemented in PDF
BIDI supportLow -
-
-
- Work in Progress -
-
- Completed -
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/optimise.xml b/src/documentation/content/xdocs/dev/design/optimise.xml deleted file mode 100644 index 9b23e931d..000000000 --- a/src/documentation/content/xdocs/dev/design/optimise.xml +++ /dev/null @@ -1,74 +0,0 @@ - - - - - - -
- Apache™ FOP Design: Optimisations - $Revision$ - - - -
- - -
- Introduction -

-Apache™ FOP should be able to handle very large documents. A document can be -supplied using SAX and the information should be passed entirely through -the system, from fo elements to rendered output as soon as possible. -

-

-A top level block area, immediately below the flow, can be added to the -page layout as soon as the element is complete. -

-

-The fo elements used to construct a page can be discarded as soon as the -layout for the page is complete. Some information may be stored in the -area tree of the page in order to handle unresolved page references -and links. -

-

-Once the layout of a page has been completed, all elements are fully -resolved, then the page can be rendered. Some renderers may support -out of order rendering of pages. -

-

-The main problem that will remain is that any page with forward -references will need to be stored until the refence is resolved. -This means that the information contained in the page should be -as minimal as possible. -

-

-Line areas can be optimised once the layout for the line has -been finalised. Consecutive characters with the same properties -can be combined into a "word" to hold the information with -limited overhead. -

-

-If there are a large number of pages where forward references -cannot be resolved the a method of writing a page onto disk -could be used to save memory. The easiest way to achieve this -is to make the page and all children serializable. -

-
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/parsing.xml b/src/documentation/content/xdocs/dev/design/parsing.xml deleted file mode 100644 index f3b4a383c..000000000 --- a/src/documentation/content/xdocs/dev/design/parsing.xml +++ /dev/null @@ -1,76 +0,0 @@ - - - - - -
- Apache™ FOP Design: Input Parsing - $Revision$ -
- -
- Introduction -

Parsing is the process of reading the XSL-FO input and making the information in it available to Apache™ FOP.

-
-
- SAX for Input -

The two standard ways of dealing with XML input are SAX and DOM. -SAX basically creates events as it parses an XML document in a serial fashion; a program using SAX (and not storing anything internally) will only see a small window of the document at any point in time, and can never look forward in the document. -DOM creates and stores a tree representation of the document, allowing a view of the entire document as an integrated whole. -One issue that may seem counter-intuitive to some new FOP developers, and which has from time to time been contentious, is that FOP uses SAX for input. -(DOM can be used as input as well, but it is converted into SAX events before entering FOP, effectively negating its advantages).

-

Since FOP essentially needs a tree representation of the FO input, at first glance it seems to make sense to use DOM. -Instead, FOP takes SAX events and builds its own tree-like structure. Why?

-
    -
  • DOM has a relatively large memory footprint. FOP's FO Tree is a lighter-weight structure.
    • -
  • DOM contains an entire document. FOP is able to process individual fo:page-sequence objects discretely, without the need to have the entire document in memory. For documents that have only one fo:page-sequence object, FOP's approach is no advantage, but in other cases it is a huge advantage. A 500-page book that is broken into 100 5-page chapters, each in its own fo:page-sequence, essentially needs only 1% of the document memory that would be required if using DOM as input.
    • -
-

See the Input Section of the User Embedding Document for a discussion of input usage patterns and some implementation details.

-

FOP's FO Tree Mechanism is responsible for catching the SAX events and processing them.

-
-
- Validation -

If the input XML is not well-formed, that will be reported.

-

There is no DTD for XSL-FO, so no formal validation is possible at the parser level.

-

The SAX handler will report an error for unrecognized namespaces.

-
-
- Namespaces -

To allow for extensions to the XSL-FO language, FOP provides a mechanism for handling foreign namespaces.

-

See User Extensions for a discussion of standard extensions shipped with FOP, and their related namespaces.

-

See Developer Extensions for a discussion of the mechanisms in place to allow developers to add their own extensions, including how to tell FOP about the foreign namespace.

-
-
- Status -
- To Do -
-
- Work In Progress -
-
- Completed -
    -
  • better handling of unknown xml and xml from an unknown namespace
    • -
  • Changed extensions to allow for external xml
    • -
  • Can have a default element mapping for extensions
    • -
-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/pdf-library.xml b/src/documentation/content/xdocs/dev/design/pdf-library.xml deleted file mode 100644 index f6562cc83..000000000 --- a/src/documentation/content/xdocs/dev/design/pdf-library.xml +++ /dev/null @@ -1,91 +0,0 @@ - - - - - - -
- Apache™ FOP Design: PDF Library - $Revision$ -
- - -
- Introduction - -

The PDF Library is an independant package of classes in Apache™ FOP. These class -provide a simple way to construct documents and add the contents. The -classes are found in org.apache.fop.pdf.*.

-
- -
- PDF Document -

This is where most of the document is created and put together.

-

It sets up the header, trailer and resources. Each page is made and added to the document. -There are a number of methods that can be used to create/add certain PDF objects to the document.

-
- -
- Building PDF -

The PDF Document is built by creating a page for each page in the Area Tree.

-

This page then has all the contents added. - The page is then added to the document and available objects can be written to the output stream.

-

The contents of the page are things such as text, lines, images etc. -The PDFRenderer inserts the text directly into a pdf stream. -The text consists of markup to set fonts, set text position and add text.

-

Most of the simple pdf markup is inserted directly into a pdf stream. -Other more complex objects or commonly used objects are added through java classes. -Some pdf objects such as an image consists of two parts.

-

It has a separate object for the image data and another bit of markup to display the image in a certain position on the page. -

The java objects that represent a pdf object implement a method that returns the markup for inserting into a stream. -The method is: byte[] toPDF().

- -
-
- Features - -
- Fonts -

Support for embedding fonts and using the default Acrobat fonts. -

- -
- Images -

Images can be inserted into a page. The image can either be inserted as a pixel map or directly insert a jpeg image. -

- -
- Stream Filters -

A number of filters are available to encode the pdf streams. These filters can compress the data or change it such as converting to hex. -

- -
- Links -

A pdf link can be added for an area on the page. This link can then point to an external destination or a position on any page in the document. -

- -
- Patterns -

The fill and stroke of graphical objects can be set with a colour, pattern or gradient. -

- -

The are a number of other features for handling pdf markup relevent to creating PDF files for FOP.

-
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/properties.xml b/src/documentation/content/xdocs/dev/design/properties.xml deleted file mode 100644 index 769ab608a..000000000 --- a/src/documentation/content/xdocs/dev/design/properties.xml +++ /dev/null @@ -1,380 +0,0 @@ - - - - - -
- Apache™ FOP Design: Properties - $Revision$ - - - -
- -
- Introduction -

As the input XSL-FO is being parsed and the FO Tree is being built, the attributes of the FO elements are passed by the parser to the related FO object. -The java object that represent the FO object then converts the attributes into properties that are stored in the FO Tree.

-
-
- Issues -

The following are some issues when dealing with properties:

-
    -
  • Initial Property Set
    • -
  • Inheritance: Some properties can be inherited from parent objects.
    • -
  • Adoption: The parentage for some elements can move around. -Markers are one example.
    • -
  • Multiple Namespaces: The properties for foreign namespaces must be handled.
    • -
  • Expressions: XSL-FO expressions can be included in properties.
    • -
-
-
- Overview of Processing -

The general flow of property processing is as follows:

-
    -
  • As part of FOTreeBuilder.startElement(), FObj.handleAttrs is passed a list of attributes to be processed for the new FObj.
    • -
  • FObj.handleAttrs gets a PropertyListBuilder and asks it to create a Property List from the list of attributes. There is currently only one static PropertyListBuilder, which handles the fo: namespace.
    • -
  • FObj.handleAttrs then cross-references the returned PropertyList with the FObj, creates a PropertyManager to facilitate downstream processing of the PropertyList, and handles the special case of the writing-mode property.
    • -
-
-
- PropertyListBuilder -

Each plb object contains a hash of -property names and their respective Makers. It may also -contain element-specific property maker hashes; these are based on the -local name of the flow object, ie. table-row, not -fo:table-row. If an element-specific property mapping exists, -it is preferred to the generic mapping.

-

The PLB loops through each attribute in the list, finds an appropriate "Maker" for it, then calls the Maker to convert the attribute value into a Property object of the correct type, and stores that Property in the PropertyList.

-
-
- Property datatypes -

The property datatypes are defined in the -org.apache.fop.datatypes package, except Number and String which are java -primitives. The FOP datatypes are:

-
    -
  • Number
    • -
  • String
    • -
  • ColorType
    • -
  • Length (has several subclasses)
    • -
  • CondLength (compound)
    • -
  • LengthRange (compound)
    • -
  • Space (compound)
    • -
  • Keep (compound)
    • -
-

The org.apache.fop.fo.Property class is the superclass for all -Property subclasses. There is a subclass for each kind of property -datatype. These are named using the datatype name plus the word -Property, resulting in NumberProperty, StringProperty, and so -on. There is also a class EnumProperty which uses an int -primitive to hold enumerated values. There is no corresponding Enum -datatype class.

-

The Property class provides a "wrapper" around any possible -property value. Code manipulating property values (in layout for -example) usually knows what kind (or kinds) of datatypes are -acceptable for a given property and will use the appropriate accessor.

-

The base Property class defines accessor methods for all FO property -datatypes, such as getNumber(), getColorType(), getSpace(), getEnum(), -etc. It doesn't define -accessors for SVG types, since these are handled separately (at least -for now.) In the base Property class, all of these methods return -null, except getEnum which returns 0. Individual subclasses return a value of the appropriate type, -such as Length or ColorType. A subclass may also choose to return a -reasonable value for other accessor types. For example, a -SpaceProperty will return the optimum value if asked for a Length.

-
-
- Property Makers -

The Property class contains a nested class called -Maker. This is the base class for all other property Makers. It -provides basic framework functionality which is overridden by the -code generated by properties.xsl from the *properties.xml files. In -particular it provides basic expression evaluation, using -PropertyParser class in the org.apache.fop.fo.expr package.

-

Other Property subclasses such as LengthProperty define their own -nested Maker classes (subclasses of Property.Maker). These handle -conversion from the Property subclass returned from expression -evaluation into the appropriate subclass for the property.

-

For each generic or specific property definition in the -properties.xml files, a new subclass of one of the Maker classes is -created. Note that no new Property subclasses are created, only new -PropertyMaker subclasses. Once the property value has been parsed and -stored, it has no specific functionality. Only the Maker code is -specific. Maker subclasses define such aspects as keyword -substitutions, whether the property can be inherited or not, which -enumerated values are legal, default values, corresponding properties -and specific datatype conversions.

-

The PLB finds a "Maker" for the property based on the attribute name and -the element name. Most Makers are generic and handle the attribute on -any element, but it's possible to set up an element-specific property -Maker. The attribute name to Maker mappings are automatically created -during the code generation phase by processing the XML property -description files.

-
-
- Processing the attribute list -

The PLB first looks to see if the font-size property is specified, since -it sets up relative units which can be used in other property -specifications. Each attribute is then handled in turn. If the attribute -specifies part of a compound property such as space-before.optimum, the -PLB looks to see if the attribute list also contains the "base" property -(space-before in this case) and processes that first.

-
-
- How the Property Maker works -

There is a family of Maker objects for each of the property datatypes, -such as Length, Number, Enumerated, Space, etc. But since each Property -has specific aspects such as whether it's inherited, its default value, -its corresponding properties, etc. there is usually a specific Maker for -each Property. All these Maker classes are created during the code -generation phase by processing (using XSLT) the XML property description -files to create Java classes.

-

The Maker first checks for "keyword" values for a property. These are -things like "thin, medium, thick" for the border-width property. The -datatype is really a Length but it can be specified using these keywords -whose actual value is determined by the "User Agent" rather than being -specified in the XSL standard. For FOP, these values are currently -defined in foproperties.xml. The keyword value is just a string, so it -still needs to be parsed as described next.

-

The Maker also checks to see if the property is an Enumerated type and -then checks whether the value matches one of the specified enumeration -values.

-

Otherwise the Maker uses the property parser in the fo.expr package to -evaluate the attribute value and return a Property object. The parser -interprets the expression language and performs numeric operations and -function call evaluations.

-

If the returned Property value is of the correct type (specificed in -foproperties.xml, where else?), the Maker returns it. Otherwise, it may -be able to convert the returned type into the correct type.

-

Some kinds of property values can't be fully resolved during FO tree -building because they depend on layout information. This is the case of -length values specified as percentages and of the special -proportional-column-width(x) specification for table-column widths. -These are stored as special kinds of Length objects which are evaluated -during layout. Expressions involving "em" units which are relative to -font-size _are_ resolved during the FO tree building however.

-
-
- Structure of the PropertyList -

The PropertyList extends HashMap and its basic function is to associate -Property value objects with Property names. The Property objects are all -subclasses of the base Property class. Each one simply contains a -reference to one of the property datatype objects. Property provides -accessors for all known datatypes and various subclasses override the -accessor(s) which are reasonable for the datatype they store.

-

The PropertyList itself provides various ways of looking up Property -values to handle such issues as inheritance and corresponding -properties.

-

The main logic is:
If the property is a writing-mode relative property (using start, end, -before or after in its name), the corresponding absolute property value -is returned if it's explicitly set on this FO.
Otherwise, the -writing-mode relative value is returned if it's explicitly set. If the -property is inherited, the process repeats using the PropertyList of the -FO's parent object. (This is easy because each PropertyList points to -the PropertyList of the nearest ancestor FO.) If the property isn't -inherited or no value is found at any level, the initial value is -returned.

-
-
- Implementing Standard Properties -

Because the properties defined in the standard are basically static, FOP currently builds the source code for the related Property classes from an XML data file. -All properties are specified in src/codegen/foproperties.xml. -The related classes are created automatically during the build process by applying an XSLT stylesheet to the foproperties.xml file.

-
- Generic properties -

In the properties xml files, one can define generic property -definitions which can serve as a basis for individual property -definitions. There are currently several generic properties defined in -foproperties.xml. An example is GenericColor, which defines basic properties -for all ColorType properties. Since the generic specification doesn't include -the inherited or default elements, these should be set in each property -which is based on GenericColor. Here is an example:

-

- <property type='generic'> - <name>background-color</name> - <use-generic>GenericColor</use-generic> - <inherited>false</inherited> - <default>transparent</default> - </property> -

-

A generic property specification can include all of the elements -defined for the property element in the DTD, including the description -of components for compound properties, and the specification of -keyword shorthands.

-

Generic property specifications can be based on other generic -specifications. -An example is GenericCondPadding template which is based on the -GenericCondLength definition but which extends it by adding an inherited -element and a default value for the length component.

-

Generic properties can specify enumerated values, as in the -GenericBorderStyle template. This means that the list of values, which -is used by 8 properties (the "absolute" and "writing-mode-relative" -variants for each BorderStyle property) is only specified one time.

-

When a property includes a "use-generic" element and includes no other -elements (except the "name" element), then no class is generated for the -property. Instead the generated mapping will associate this -property directly with an instance of the generic Maker.

-

A generic class may also be hand-coded, rather than generated from the -properties file. -Properties based on such a generic class are indicated by the -attribute ispropclass='true' on the -use-generic element.

-

This is illustrated by the SVG properties, most of -which use one of the Property subclasses defined in the -org.apache.fop.svg -package. Although all of these properties are now declared in -svgproperties.xml, no specific classes are generated. Classes are only -generated for those SVG properties which are not based on generic -classes defined in svg.

-
-
- Element-specific properties -

Properties may be defined for all flow objects or only for -particular flow objects. A PropertyListBuilder object will always look -first for a Property.Maker for the flow object before looking in the -general list. These are specified in the -element-property-list section of the properties.xml -files. The localname element children of this element specify for -which flow-object elements the property should be registered.

-

- NOTE: All the properties for an object or set of objects -must be specified in a single element-property-list element. If the -same localname appears in several element lists, the later set of -properties will hide the earlier ones! Use the ref -functionality if the same property is to be used in different sets of -element-specific mappings.

-
-
- Reference properties -

A property element may have a type attribute with the value - ref. The - content of the name child element is the name of the referenced - property (not its class-name!). This indicates that the property - specification has - already been given, either in this same specification file or in a - different one (indicated by the family attribute). The - value of the family attribute is XX where the file - XXproperties.xml defines the referenced property. For - example, some SVG objects may have properties defined for FO. Rather - than defining them again with a new name, the SVG properties simply - reference the defined FO properties. The generating mapping for the - SVG properties will use the FO Maker classes.

-
-
- Corresponding properties -

Some properties have both absolute and -writing-mode-relative forms. In general, the absolute forms -are equivalent to CSS properties, and the writing-mode-relative forms -are based on DSSSL. FO files may use either or both forms. In -FOP code, a request for an absolute form will retrieve that value if it -was specified on the FO; otherwise the corresponding relative property -will be used if it was specified. However, a request for a relative -form will only use the specified relative value if the corresponding -absolute value was not specified for that FO.

-

Corresponding properties are specified in the properties.xml files -using the element corresponding, which has at least one -propval child and may have a propexpr child, -if the corresponding -value is calculated based on several other properties, as for -start-indent.

-

- NOTE: most current FOP code accesses the absolute variants -of these properties, notably for padding, border, height and width -attributes. However it does use start-indent and end-indent, rather -than the "absolute" margin properties.

-
-
-
- Mapping -

The XSL script propmap.xsl is used to generate -property mappings based on -both foproperties.xml and svgproperties.xml. The mapping classes -in the main fop packages simply load these automatically generated -mappings. The mapping code still uses the static -"maker" function of the generated object to obtain a Maker -object. However, for all generated classes, this method returns an -instance of the class itself (which is a subclass of Property.Maker) -and not an instance of a separate nested Maker class.

-

For most SVG properties which use the SVG Property classes directly, -the generated mapper code calls the "maker" method of the SVG Property -class, which returns an instance of its nested Maker class.

-

The property generation also handles element-specific property -mappings as specified in the properties XML files.

-
-
- Enumerated values -

For any property whose datatype is Enum or which -contains possible enumerated values, FOP code may need to access -enumeration constants. These are defined in the interfaces whose name -is the same as the generated class name for the property, -for example BorderBeforeStyle.NONE. These interface classes -are generated by the XSL script enumgen.xsl. A separate -interface defining the enumeration constants is always generated for -every property which uses the constants, even if the constants -themselves are defined in a generic class, as in BorderStyle.

-

If a subproperty or component of a compound property has enumerated -values, the constants are defined in a nested interface whose name is -the name of the subproperty (using appropriate capitalization -rules). For example, -the keep properties may have values of AUTO or FORCE or an integer -value. These are defined for each kind of keep property. For example, -the keep-together property is a compound property with the components -within-line, within-column and within-page. Since each component may -have the values AUTO or FORCE, the KeepTogether interface defines -three nested interfaces, one for each component, and each defines -these two constants. An example of a reference in code to the constant -is KeepTogether.WithinPage.AUTO.

-
-
- Compound property types -

Some XSL FO properties are specified by compound datatypes. In the FO file, -these are defined by a group of attributes, each having a name of the -form property.component, for example -space-before.minimum. These are several compound -datatypes:

-
    -
  • LengthConditional, with components length and conditionality
    • -
  • LengthRange, with components minimum, optimum, and maximum
    • -
  • Space, with components minimum, optimum, maximum, precedence and -conditionality
    • -
  • Keep, with components within-line, within-column and within-page
    • -
-

These are described in the properties.xml files using the element -compound which has subproperty children. A subproperty element is much -like a property element, although it may not have an inherited child -element, as only a complete property object may be inherited.

-

Specific datatype classes exist for each compound property. Each -component of a compound datatype is itself stored as a Property -object. Individual components may be accessed either by directly -performing a get operation on the name, using the "dot" notation, -eg. get("space-before.optimum"); or by using an accessor on the compound -property, eg. get("space-before").getOptimum(). -In either case, -the result is a Property object, and the actual value may be accessed -(in this example) by using the "getLength()" accessor.

-
-
- Refinement -

The Refinement step is part of reading and using the properties which may happen immediately or during the layout process. FOP does not currently use a separate Refinement process, but tends to handle refining steps as the FO Tree is built.

-
-
- Refined FO Tree -

The Refined FO Tree is the result of the Refinement process.

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/renderers.xml b/src/documentation/content/xdocs/dev/design/renderers.xml deleted file mode 100644 index 2e21db864..000000000 --- a/src/documentation/content/xdocs/dev/design/renderers.xml +++ /dev/null @@ -1,229 +0,0 @@ - - - - - -
- Apache™ FOP Design: Renderers - $Revision$ - - - -
- -
- Introduction -

A renderer is primarily designed to convert a given area tree into the output -document format. It should be able to produce pages and fill the pages -with the text and graphical content. Usually the output is sent to -an output stream.

-

Some output formats may support extra information that is not available -from the area tree or depends on the destination of the document.

-

Each renderer is given an area tree to render to its output format. -The area tree is simply a representation of the pages and the placement -of text and graphical objects on those pages.

-

The renderer will be given each page as it is ready and an output stream -to write the data out. -All pages are supplied in the order they appear in the document. -In order to save memory it is -possble to render the pages out of order. Any page that is not ready to -be rendered is setup by the renderer first so that it can reserve a space -or reference for when the page is ready to be rendered.The renderer is responsible for managing the -output format and associated data and flow.

-
-
- Design Issues -
- Renderers are Responsible -

Each renderer is totally responsible for its output format.

-
-
- Send Output to a Stream -
-
-
- Fonts -

Because font metrics (and therefore layout) are obtained in two different ways depending on the renderer, the renderer actually sets up the fonts being used. The font metrics are used -during the layout process to determine the size of characters.

-
-
- Render Context -

The render context is used by handlers. -It contains information about the current state of the renderer, such as the page, the position, and any other miscellanous objects that are required to draw into the page.

-
-
- XML Handling -

A document may contain information in the form of XML for an image or instream foreign object. -This XML is handled through the user agent. -A standard extension for PDF is the SVG handler.

-

If there is XML in the SVG namespace it is given to the handler which renders the SVG into the pdf document at the given location. -This separation means that other XML handlers can easily be added.

-
-
- Extensions -

Document level extensions are handled with an extension handler. -This handles the information from the AreaTree and adds renders it to the document. -An example is the pdf bookmarks. This information first needs to have all references resolved. -Then the extension handler is ready to put the information into the pdf document.

-
-
- Renderer Implementations - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
NameTypeFont SourceFont Embedding?Out of Order Rendering?Notes
PDFPaginatedFOPYesYesUses the PDFDocument classes to create a PDF document. Most of the work is to insert text or create lines. SVG is handled by the XML handler that uses the PDFGraphics2D and batik to -draw the svg into the pdf page.
PostScriptPaginatedFOPNot implemented?Similar to PDF.
PCLPaginatedFOP??Similar to PDF.
SVGPaginated???Creates a single svg document that contains all the pages rendered -with page sequences horizontally and pages vertically. Adds -links between the pages so that it can be viewed by clicking on the page -to go to the next page.
TXTPaginatedN/AN/ANoOutputs to a text document.
AWTPaginatedAWTN/A?This draws the pages into an AWT graphic.
XMLPaginatedFOPNoNoCreates an XML file that represents the AreaTree.
PrintPaginatedAWT?NoPrints the document using the java printing facitlities. The AWT -rendering is used to draw the pages onto the printjob.
RTFStructuralN/AN/ANoStructural format uses a different rendering mechanism.
MIFStructuralN/AN/ANoStructural format uses a different rendering mechanism.
-
-
- Adding a Renderer -

You can add other renderers by implementing the Renderer interface. -However, the AbstractRenderer does most of what is needed, including iterating through the tree parts, so it is probably better to extend this. -This means that you only need to implement the basic functionality such as text, images, and lines. -AbstractRenderer's methods can easily be overridden to handle things in a different way or do some extra processing.

-

The relevent AreaTree structures that will need to be rendered are:

-
    -
  • Page
    • -
  • Viewport
    • -
  • Region
    • -
  • Span
    • -
  • Block
    • -
  • Line
    • -
  • Inline
    • -
-

A renderer implementation does the following:

-
    -
  • render each individual page
    • -
  • clip and align child areas to a viewport
    • -
  • handle all types of inline area, text, image etc.
    • -
  • draw various lines and rectangles
    • -
-
-
- Multiple Renderers -

The layout of the document depends mainly on the font being used. -If two renderers have the same font metrics then it is possible to use the same Area Tree to render both. This can be handled by the AreaTree Handler.

-
-
- Status -
- To Do -
-
- Work In Progress -
-
- Completed -
    -
  • new renderer model
    • -
  • new interface for structured documents, rtf and mif
    • -
  • added handlers for xml in renderer
    • -
-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/startup.xml b/src/documentation/content/xdocs/dev/design/startup.xml deleted file mode 100644 index db1742135..000000000 --- a/src/documentation/content/xdocs/dev/design/startup.xml +++ /dev/null @@ -1,56 +0,0 @@ - - - - - -
- Apache™ FOP Design: Startup, Environment, Control - $Revision$ -
- -
- Introduction -

Startup is the process of getting Apache™ FOP bootstrapped and creating basic objects. Environment includes acquiring user options, instantiating any frameworks, setting up logging, etc. Control includes the basic logic for tieing the various subsystems together properly.

-
-
- Status -
- To Do -
    -
  • avalon integration - logging, configuration, component management, caching, uri resolver
    • -
  • improved interfaces -
      -
    • no threading/static problems
      • -
    • simpler to use
      • -
    -
    • -
  • better commandline handling
    • -
-
-
- Work In Progress -
-
- Completed -
    -
  • better image handling - redone so it can use a cache and synchronizes properly only on the current image while loading
    • -
-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/svg.xml b/src/documentation/content/xdocs/dev/design/svg.xml deleted file mode 100644 index 1d4f72d04..000000000 --- a/src/documentation/content/xdocs/dev/design/svg.xml +++ /dev/null @@ -1,90 +0,0 @@ - - - - - - -
- Apache™ FOP Design: SVG - $Revision$ -
- -
- Introduction -

SVG is rendered through Apache™ Batik.

The XML from the XSL:FO document - is converted into an SVG DOM with batik. This DOM is then set as the Document - on the Foreign Object area in the Area Tree.

This DOM is then available to - be rendered by the renderer.

SVG is rendered in the renderers via an - XMLHandler in the FOUserAgent. This XML handler is used to render the SVG. The - SVG is rendered by using batik. Batik converts the SVG DOM into an internal - structure that can be drawn into a Graphics2D. So for PDF we use a - PDFGraphics2D to draw into.

This creates the necessary PDF information to - create the SVG image in the PDF document.

Most of the work is done in the - PDFGraphics2D class. There are also a few bridges that are plugged into batik - to provide different behaviour for some SVG elements.

-
-
- Text Drawing -

Normally batik converts text into a set of curved - shapes.

This is handled as any other shapes when rendering to the output. This - is not always desirable as the shapes have very fine curves. This can cause the - output to look a bit bad in PDF and PS (it can be drawn properly but is not by - default). These curves also require much more data than the original - text.

To handle this there is a PDFTextElementBridge that is set when - using the bridge in batik. If the text is simple enough for the text to be - drawn in the PDF as with all other text then this sets the TextPainter to use - the PDFTextPainter. This inserts the text directly into the PDF using the drawString method on the PDFGraphics2D.

Text is considered simple if the - font is available, the font size is useable and there are no tspans or other - complications. This can make the resulting PDF significantly - smaller.

-
-
- PDF Links -

To support links in PDF another batik - element bridge is used. The PDFAElementBridge creates a PDFANode which inserts - a link into the PDF document via the PDFGraphics2D.

Since links are positioned on the page without any transforms then we need to transform the - coordinates of the link area so that they match the current position of the a - element area. This transform may also need to account for the svg being - positioned on the page.

-
-
- Images -

Images are normally drawn - into the PDFGraphics2D. This then creates a bitmap of the image data that can - be inserted into the PDF document.

As PDF can support jpeg images then another - element bridge is used so that the jpeg can be directly inserted into the PDF.

-
-
- PDF Transcoder -

Batik provides a mechanism to - convert SVG into various formats. Through FOP we can convert an SVG document - into a single paged PDF document. The page contains the SVG drawn as best as - possible on the page. There is a PDFDocumentGraphics2D that creates a - standalone PDF document with a single page. This is then drawn into by batik in - the same way as with the PDFGraphics2D.

-
-
- Other Outputs -

When rendering to AWT the SVG is simply drawn onto the - awt canvas using batik.

The PS Renderer uses a similar technique as the - PDF Renderer.

The SVG Renderer simply embeds the SVG inside an svg - element.

-
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/design/useragent.xml b/src/documentation/content/xdocs/dev/design/useragent.xml deleted file mode 100644 index 5ee7f29e2..000000000 --- a/src/documentation/content/xdocs/dev/design/useragent.xml +++ /dev/null @@ -1,114 +0,0 @@ - - - - - - -
- Apache™ FOP Design: User Agent - $Revision$ - - - -
- - -
- Introduction -

-Technically the user agent is Apache™ FOP in the role of determining the -output format and when resolving various attributes. The user -agent is represented by a class that is available to others to -specify how FOP should behave. -

-

-The user agent is used by the formatting process to determine -certain user definable values. -

-

-It will enable the customisation of values for generating and -rendering the document. -

-

-The user agent must be available to the layout processor and -the renderer. Users can supply their own user agent or use -the default one for a particular renderer. -

-

-The user agent needs to be made available to the property -resolution layout process and the renderer. -

- -

-Standard Features: -

-
    -
  • error handling, what to do if fo markup is invalid
    • -
  • auto overflow value and handling error-if-overflow
    • -
  • adjusting length values (eg. for borders) to renderable values
    • -
  • available fonts
    • -
  • converting cm/in to pt (dpi)
    • -
  • active state for multi properties
    • -
  • title, used to identify a set of pages (in a page sequence)
    • -
  • the width (in inline-progression-dimension) of a character with -treat-word-as-space true
    • -
  • maximum space used by conditional areas from region-reference-area
    • -
  • if there should be "hot links" to before floats or footnotes
    • -
  • when to clear side floats if space in inline-progression-dimension -is not enough
    • -
  • placement of left over footnotes on a page with a region-body
    • -
  • using color property as border colour
    • -
  • interpretting all border styles (except outset) as solid
    • -
  • thin, medium and thick values for border width
    • -
  • initial font-family value
    • -
  • absolute font sizes (eg, xx-small, x-small etc.)
    • -
  • relative font sizes (eg. larger, smaller)
    • -
  • small caps simulation
    • -
  • font weight mapping
    • -
  • baseline info for a font if not available
    • -
  • determining sub/superscript when another baseline is dominant
    • -
  • scaling method for external-graphic and instream-foreign-object
    • -
  • the width of a replaced element
    • -
  • "normal" line height value
    • -
  • text alignment (stretching the line with letter and word spacing)
    • -
  • text transform
    • -
  • initial color
    • -
  • rendering intent of auto
    • -
  • dot character for leader
    • -
  • line breaking with leaders, use optimum length when breaking the line
    • -
  • page height/width of auto
    • -
  • left and right caption widths
    • -
  • glyph orientation vertical of auto
    • -
  • rendering processor of content-type (mime type)
    • -
- -

-Interactive Features: -

-
    -
  • inline and block scroll amount
    • -
  • dynamic effects, links and property sets
    • -
  • initial "pause-after", "pause-before" and "voice-family" value
    • -
  • treating fixed as scroll on background attachement
    • -
  • media usage of auto
    • -
- -
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/doc.xml b/src/documentation/content/xdocs/dev/doc.xml deleted file mode 100644 index fe9e656ed..000000000 --- a/src/documentation/content/xdocs/dev/doc.xml +++ /dev/null @@ -1,166 +0,0 @@ - - - - - -
- Apache™ FOP Development: Managing Documentation - $Revision$ -
- -
- General Information -

All raw documentation content is managed in the Apache™ FOP SVN repository. -Updates should be committed to the repository, then the repository files are used to generate usable output. -The remaining discussions on this page assume that the SVN repository is the starting place for processing. -The path to the documentation is src/documentation/content/xdocs.

- All documentation is maintained on the trunk. -

Basic documents are stored in XML files, and use DTDs provided by Apache Forrest.

-
-
- Design Principles -

These principles are not written in stone, but reflect the current philosophy, and are documented here primarily to help achieve consistency. These principles should be changed if better or more practical ones are found, but they should probably be discussed and changed by common consent.

-
- Where -
    -
  • To the extent possible, keep user content separate from developer content, primarily so the user doesn't have to filter out technical information.
    • -
  • To the extent possible, try to document a topic exactly once, in the place the user is most likely to look for it, then link to that from other locations as appropriate. This is somewhat contrary to the principle above, which should be applied as a higher priority.
    • -
-
-
- When -

The documentation and the product are in a constant state of change, and there is some difficulty in deciding what product state the website content should reflect. The current thinking is that the website should reflect the current state of the repository code branch from which releases are made. Features or other documentation that applies to unreleased code should be marked in such a way within the content that the user can determine whether and how it applies to the version they are using. For example, "Feature xyz is first available in Release n.nn.n".

-

Other approaches were considered, but all seemed to have significantly higher costs both to the users and the developers. From the user's standpoint, the choice is either that they potentially have to look multiple places to get the information they need (which was rejected), or they have to filter out an occasional feature that is in code available subsequent to their release (which was accepted).

-
-
-
- Website -
- Background -

The FOP web site and documentation are generated using Apache Forrest.

-

The following table summarizes the flow of data to the FOP website in chronological order:

- - - - - - - - - - - - - - - - - - - - - - - - - -
ProcessOutputStateView(s)
Developer commits code to FOP repository.FOP repository (SVN)Raw XML and other contentin SVN
Developer builds and uploads documentation using ForrestBot./www/xmlgraphics.apache.org/fop on people.apache.orgsync-readyn/a
Cron job runs rsync to synchronize the website with the real web server (runs every few hours).Infrastructure knows. :-)web-readyFOP Web Site
- Server-side ForrestBot is currently not available for website publishing. We use it locally and with manual invocation. -
-
- ForrestBot "publish" Step-by-Step -

- We're using ForrestBot for build and deploy the FOP website. ForrestBot comes with Apache Forrest 0.8. - The root directory of your FOP checkout contains the file "publish.xml" which is an Ant build file - that manages the build and the deployment of the FOP website. Please look into this file for - further instructions to set up ForrestBot on your machine. Basically, we're simply running ForrestBot - manually by typing "ant -f publish.xml" once we're happy with our changes to the site. - Step-by-step instructions for the deployment process again: -

- - Please make sure you use Forrest from the Trunk (revision 632959 or later) for the time being. You will need - to download it directly from SVN: - http://svn.apache.org/repos/asf/forrest/trunk - -
    -
  • Modify the sources of the website and check locally with Forrest (run "forrest run" or just "forrest").
    • -
  • - Once you're satisfied, run "ant -f publish.xml" to do a clean build of the website. If the build - runs without problems, the website will be uploaded as a whole using SVN to the - website staging directory in SVN. -
    • -
  • - Then log into people.apache.org using SSH, go to the /www/xmlgraphics.apache.org - directory and run "svn up". -
    • -
  • - Wait for the next rsync cycle and check your changes in the live site. - (Sorry, no manual rsync available ATM) -
    • -
-

- The reason for putting the generated website in the SVN repository: The infrastructure - people want to be able to restore the websites themselves in case of a crash. -

-
-
- Using a Local Forrest -

To use a local Forrest (during website development, not for deployment):

-
    -
  • download latest the Forrest release (currently Forrest 0.8)
    • -
  • set environment variable FORREST_HOME=~/apache-forrest-0.8 where ~ is the directory where Forrest is installed - (see http://forrest.apache.org/docs/your-project.html for details)
    • -
  • set environment variable PATH=$PATH:$FORREST_HOME/bin
    • -
  • cd to your local FOP checkout
    • -
  • update your local FOP checkout (svn update)
    • -
  • run forrest(.bat), which will build the web-site documents in xml-fop/build/site.
    • -
- - You can use "forrest run" to start a local web server. That improves development speed as you - can simply refresh in the browser after a change. - -
-
- Updating Distribution Files -

- The Apache distribution system mirrors distributions around the world. Since it uses - Apache httpd Module - mod_autoindex - you also need to manually update the HEADER.html & READER.html files on - people.apache.org in - /www/www.apache.org/dist/xmlgraphics/fop/. -

-

- Please be careful when doing stuff like that. -

-
-
- Deleting Documentation Files -

- ForrestBot simply uploads the whole generated site. It doesn't delete obsolete files. You - can do that manually in the /www/xmlgraphics.apache.org/fop folder on cvs.apache.org. Be careful - when doing stuff like that. -

- - Please make sure you always have group rw permissions on all files under the /www directory! - -
- -
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/extensions.xml b/src/documentation/content/xdocs/dev/extensions.xml deleted file mode 100644 index 3a5f499d5..000000000 --- a/src/documentation/content/xdocs/dev/extensions.xml +++ /dev/null @@ -1,64 +0,0 @@ - - - - - - -
- Apache™ FOP Development: Adding an Extension - $Revision$ -
- -
- Overview -

For documentation of standard Apache™ FOP extensions, see the User FOP Extensions document.

-

-If the default funtionality of FOP needs to be extended for -some reason then you can write an extension. -

-

There are three types of extensions possible:

-
    -
  • An output document extension such as the PDF bookmarks
    • -
  • an instream-foreign-object extensions such as SVG
    • -
  • an fo extension that creates an area in the area tree where normal xsl:fo is not possible
    • -
-
-
- Adding Your Own -

-To add your own extension you need to do the following things. -

-
    -
  1. Write code that implements your extension functionality. The easiest place to -start is by looking at the code in org.apache.fop.fo.extensions, and by looking at the examples in the examples directory.
    2. -
  2. Create a class that extends the abstract org.apache.fop.fo.ElementMapping class. ElementMapping is a hashmap of all of the elements in a particular namespace, which makes it easier for FOP to create a different object for each element. -ElementMapping objects are static to save on memory. -They are loaded by FOP when parsing starts to validate input.
    3. -
  3. Create the following file: "/META-INF/services/org.apache.fop.fo.ElementMapping", which should contain the fully qualified classname of your ElementMapping implementation class.
    4. -
  4. Create a jar file containing all of the above files.
    5. -
  5. Create your XSL-FO file with the extra XML data embedded in the file with the -correct name space. -The examples for SVG and pdfoutline.fo show how this can be done. -The pdf documents on the FOP site use this extension. -See also Examples for more examples.
    6. -
  6. Put your jar file in the classpath
    7. -
  7. Run FOP using your XSL-FO file as input.
    8. -
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/faq.xml b/src/documentation/content/xdocs/dev/faq.xml deleted file mode 100644 index ae15eaabd..000000000 --- a/src/documentation/content/xdocs/dev/faq.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - - - General Questions - - How can I contribute? - -

There are many ways that you can help:

-
    -
  • You can help us implement missing features that are needed in order to comply with the standard. See the Standards Compliance for more details.
    • -
  • You can help us address bug reports. See bugzilla for more information.
    • -
  • You can help support our user base by answering questions on the fop-user mailing list.
    • -
  • You can help us document FOP better.
    • -
- - - - - Documentation - - How do I get the javadocs for FOP? - -

Currently, the only way to get FOP javadocs is to - Download the source code and then Build - FOP using the ant build task "javadocs".

- - - - Where can I learn how the FOP docs and web site are built? - -

- See FOP Doc Management. ;-) -

- - - - - Further Help - - I don't see my question addressed here. Are there other FAQs? - -

Yes. See also the FOP General FAQs.

- - - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/fo/embedding.fo b/src/documentation/content/xdocs/dev/fo/embedding.fo deleted file mode 100644 index c3503d6a6..000000000 --- a/src/documentation/content/xdocs/dev/fo/embedding.fo +++ /dev/null @@ -1,1123 +0,0 @@ - - - - - - - - - - - - - - - Embedding SVG examples - - - Page - - - - - - Embedding SVG - - - - - - -A less cute tiger - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Some examples of how to embed an SVG image inside your FO documents - - - -Introduction - - - -This document shows some examples of how an SVG document can be embedded directly in -an fo document and how FOP will render it. - - - -There are a couple of ways to specify the XML for embedding. -There are a number of factors which specify exactly how the SVG image will be rendered, such as size, clipping etc. - - - -Note: if you want to know about SVG itself you should consult the appropriate SVG resource. The Batik Project is a good resource for information about SVG and samples etc. - - - -XML Syntax - - - -Here we have some examples of how the XML can be specified in the fo document. - - - - - - - - -This first example specifies the name space on the instream-foreign-object using the xmlns:svg attribute. -Then all the svg elements start with the svg: namespace prefix. It can be specified on any element -above where the svg:svg tag appears (eg. fo:root). - - - - - - - - - - - - - - - -]]> - - - - - - - - - - - - - - - - - - - - -This example specifies the name space on the svg:svg element using the xmlns:svg attribute. -Then all the svg elements start with the svg: namespace prefix. -It is able to determine the namespace for the current element. - - - - - - - - - - - - - - - -]]> - - - - - - - - - - - - - - - - - - - - -This example specifies the namespace for the current element, rather than for the svg: prefix. -This means that all elements under this one are assumed to have the same namespace. - - - - - - - - - - - - - - - -]]> - - - - - - - - - - - - - - - - - - - - - - - - - -Sizing - - - - The size of the instream-foreign-object is obtained in a number of ways. - - - - - - - - - -Specify the size on the instream-foreign-object element. - - - - - - - - - - - - - - - -]]> - - - - - - - - - - - - - - - - - - - - - - -Specify the size on the svg document element. - - - - - - - - - - - - - - - -]]> - - - - - - - - - - - - - - - - - - - - -Specify the size on the svg document element and for the content size on the instream-foreign-object. - - - - - - - - - - - - - - - -]]> - - - - - - - - - - - - - - - - - - - - - - - - - - -Clipping - - - - - - - -Interesting Functionality - - - - - - - - - - diff --git a/src/documentation/content/xdocs/dev/fo/embedding.fo.pdf b/src/documentation/content/xdocs/dev/fo/embedding.fo.pdf deleted file mode 100644 index 6dd1b2f2a7e7ac7541f07659f6b05cd400499bb3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 45694 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 `3&AurgEn06jLVP2`jXX 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 diff --git a/src/documentation/content/xdocs/dev/fonts.xml b/src/documentation/content/xdocs/dev/fonts.xml deleted file mode 100644 index 9d2f63905..000000000 --- a/src/documentation/content/xdocs/dev/fonts.xml +++ /dev/null @@ -1,90 +0,0 @@ - - - - - - -
- Apache™ FOP Development: Fonts - $Revision$ -
- -
- Goals -
    -
  • refactor existing font logic for better clarity and to reduce duplication
    • -
  • parse registered font metric information on-the-fly (to make sure most up-to-date parsing is used??)
    • -
  • resolve whether the FontBBox, StemV, and ItalicAngle font metric information is important or not -- if so, parse the .pfb file to extract it when building the Apache� FOP xml metric file
    • -
  • handle fonts registered at the operating system (through AWT)
    • -
  • add support for parsing OpenType fonts
    • -
-
-
- Issues -
    -
  • Why are we using our own font metric parsing and registration system, instead of the AWT system provided as part of Java? -
      -
    • Answer 1: Many of our customers use FOP in a so-called "headless" server environment -- that is, the operating system is operating in character mode, with no concept of a graphical environment. We need some mechanism of allowing these environments to get font information. Java 1.4 has a mechanism for dealing with headless environments, and this issue may be resolved when we require that as a minimum platform. However, there may be an issue then of how to get fonts registered at the operating system in these environments. That will probably at least require some documentation for users.
      • -
    • Answer 2: At some level, we don't yet fully trust AWT to handle fonts correctly. There are still unresolved discrepancies between the two systems.
      • -
    • Answer 3: In the AWT mechanism, there does not appear to be a way to find the physical font file associated with an AWT font, or to otherwise get access to its contents so that it can be embedded in FOP output.
      • -
    • Answer 4: The Java 1.4 javadocs state (in java.awt.Font): "All implementations of the Java 2 platform must support TrueType fonts; support for other font technologies is implementation dependent." We wish to provide a greater base of font technologies for our users.
      • -
    -
    • -
-
-
- Implementation -

There are two main font functions needed within FOP:

-
    -
  • provision of a font object to be used in layout
    • -
  • embedding of a font file in output (such as PDF)
    • -
-

For the first of these, we will implement something along the lines of a "Facade" Structural Pattern to hide the differences between the various font types and font sources from the rest of the system. -Public classes will consist of TypeFaceFamily, TypeFace, and Font. (TypeFace roughly corresponds to the contents of a normal font file, while Font is a general typeface implemented at a specific point size, and perhaps with other specific parameters). -When another part of FOP requests a font object, existing font objects will be checked first, and an appropriate one returned if possible. -If not, the Font logic should resolve the TypeFace and TypeFaceFamily if possible, create a Font object, and return it.

-
-
- Resources -
- Type 1 Fonts -
    -
  • Adobe Type 1 Font Format
    • -
  • According to the Adobe web site, the documentation for the font metrics files (.pfm = printer font metrics) is written and controlled by Microsoft, since it is actually a workaround to allow Type 1 fonts to be used on a GUI screen in Windows. However, the document does not appear to be on the Microsoft web site. The best resource for this information is Adobe Technical Note #5178: Building PFM Files for Postscript-Language CJK Fonts
    • -
  • FOP does not currently use the Adobe Font Metrics file, but the specification can be found in Adobe Technical Note #5004: Adobe Font Metrics File Format Specification
    • -
  • Adobe Technical Note #5040: Supporting Downloadable Postscript Language Fonts may also include some useful information.
    • -
-
-
- TrueType Fonts -
    -
  • The TrueType specification
    • -
-
-
- OpenType Fonts -
    -
  • The OpenType specification
    • -
  • The Adobe Introduction to OpenType fonts page has some useful general information and links.
    • -
-
-
- - - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/implement.xml b/src/documentation/content/xdocs/dev/implement.xml deleted file mode 100644 index 6f8a4a05c..000000000 --- a/src/documentation/content/xdocs/dev/implement.xml +++ /dev/null @@ -1,110 +0,0 @@ - - - - - -
- Apache™ FOP Development: Implementation Overview - Following a Document Through Apache� FOP - $Revision$ - - - -
- -

The purpose of this document is to tie together the Apache™ FOP design (interface) with some of the key points where control is passed within FOP (implementation), so that developers can quickly find the section of code that is relevant to their needs. The process described is for a "typical" command-line document. All classes are in org.apache.fop unless otherwise designated.

-
- Overview -

The input FO document is sent to the FO tree builder via SAX events. Fragments of an FO Tree are built from this process. As each page-sequence element is completed, it is passed to a layout processor, which in turn converts it into an Area Tree. The Area Tree is then given to the Renderer, which converts it into a stream of data containing the output document. The sections below will provide additional details. Where needed differences between the trunk and maintenance branches are shown in tabular format.

-
-
- Startup -
    -
  • The job starts in apps.Fop.main().
    • -
  • Control is passed to apps.CommandLineStarter.run().
    • -
  • Control is passed to apps.Driver.render(). This class fires up a SAX parser, the events from which indirectly control the remaining processing, including building the FO Tree, building the Area Tree, rendering, output and logging.
    • -
-
-
- Formatting Object Tree - - - - - - - - - - - - - - - - - - - - - - - -
TrunkMaintenance
The SAX events that the parser creates are handled by fo.FOTreeBuilder, which uses startElement(), endElement(), and characters() methods to build the FO Tree.
fo.FOTreeBuilder.endElement() runs the end() method for each node as it is created. The fo.pagination.PageSequence class overrides this end() method to run apps.LayoutHandler.endPageSequence(), which in turn runs fo.pagination.PageSequence.format().the end of a PageSequence element causes the PageSequence object to be passed to apps.StreamRenderer.render(), which in turn runs fo.pagination.PageSequence.format().
fo.pagination.PageSequence.format() creates a layoutmgr.PageLayoutManager, passing the AreaTree and PageSequence objects to it, then calls its run() method.fo.pagination.PageSequence.addFlow() programatically adds a Flow object to the page sequence.
.fo.pagination.PageSequence.makePage() creates a BodyArea and passes it to fo.Flow.layout
.the layout process is then driven from fo.pagination.PageSequence.format().
-
-
- Layout -

There are layout managers for each type of layout decision. -They take an FO Tree as input and build a laid-out Area Tree from it. -The layout process involves finding out where line breaks and page breaks should be made, then creating the areas on the page. -Static areas can then be added for any static regions. -As pages are completed, they are added to the Area Tree.

-
-
- Area Tree -

The area tree is a data structure designed to hold the page areas. -These pages are then filled with the page regions and various areas. -The area tree is used primarily as a minimal structure that can be rendered -by the renderers.

-

The area tree is supported by an area tree model. This model -handles the adding of pages to the area tree. It also handles -page sequence starts, document level extensions, id references -and unresolved id areas. This model allows the pages to be handled -directly by a renderer or to store the pages for later use. -

-
-
- Rendering -

-The renderer receives pages from the area tree and renders those pages. -If a renderer supports out of order rendering then it will either -render or prepare a page in the correct order. Otherwise the -pages are rendered in order. -The task of the renderer is to take the pages and output them to -the requested type. -In the case of the AWTRenderer it needs to be able to view any page. -

-

-When rendering a page it takes the page and renders each page region. -The main work for a renderer implementation is to handle the viewports -and inline areas. The inline areas need to be drawn on the page in the -correct place. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/index.xml b/src/documentation/content/xdocs/dev/index.xml deleted file mode 100644 index 27f1b2cd9..000000000 --- a/src/documentation/content/xdocs/dev/index.xml +++ /dev/null @@ -1,165 +0,0 @@ - - - - - -
- Apache™ FOP Development: General Information - $Revision$ -
- -
- Introduction -

These pages contain information that should be helpful for those developing Apache™ FOP. -This certainly includes programmers, but may also include those contributing to the project in other ways.

-

For basic and user information on FOP, please visit the Apache™ FOP homepage.

-
-
- Development -

- The main development happens on "FOP Trunk". -

- - The SVN repository URL for the trunk is:
- http://svn.apache.org/repos/asf/xmlgraphics/fop/trunk/ - -
-
- Getting Involved -
- Understand Apache Roles -

Review the Apache Project Roles and Responsibilities document for an understanding of the various roles of contributors within the community.

-
-
- How you can help -

There are many different ways that you can help with FOP development. The following is a non-exhaustive list of ways that non-programmers can help. Remember that an hour spent on the tasks below is an hour that a programmer can devote to fixing bugs or adding features instead:

-
    -
  • Answer questions on the fop-user mailing list.
    • -
  • Contribute examples that are useful to other users.
    • -
  • Contribute test cases.
    • -
  • Submit well-written feature requests.
    • -
  • Submit well-written bug reports.
    • -
  • Review open issues to see if you have any insight into them that might help a programmer solve the problem faster. Add comments and test cases as appropriate.
    • -
  • Test newly-closed issues to make sure they are truly closed.
    • -
  • Submit patches to the documentation.
    • -
-

Of course, we're glad to have programmers help as well. Here are some additional tasks that would require programming ability:

-
    -
  • Fixing bugs.
    • -
  • Implementing new features.
    • -
-
-
- Understand FOP-related standards -

At the moment FOP is mainly a tool to render XSL-FO files to pdf. Therefore if you want to contribute to FOP you should become familiar with these standards. You can find links at Specifications.

-
-
- Review the Developer Documentation -
-
- Understand FOP's Design -

The design for FOP is specified under the Design section. This is where the information on how FOP is developed and designed -internally will be kept. -

-

- Another place where we write design documentation is the FOP Wiki. -

- - Our design documentation may not always be up to date! - -
-
- Subscribe to the fop-dev Mailing List -

Use this forum to discuss topics related to FOP development, including patch submissions, bug reports, and design issues. Please do not use it for XML support, XSLT support, XSL-FO support, or even FOP support. -Appropriate mailing lists for these topics can be found on the FOP Mailing List page. -

-
    -
  • -To review the archives, you have several options: -
      -
    • The Apache Mailing List archive (mod_mbox).
      • -
    • The Apache Mailing List archive (gzipped mbox files).
      • -
    • The Mailing list ARChives (MARC) at the AIMS group (search).
      • -
    • The Mail Archive.
      • -
    • The GMANE archive.
      • -
    • The Nabble archive.
      • -
    • The MarkMail archive.
      • -
    -
    • -
  • Before posting questions to any list, see "General Information".
    • -
  • -See Apache XML Graphics Mailing Lists -for detailed subscription information. -
    • -
  • -To subscribe (digest only): Send email to fop-dev-digest-subscribe@xmlgraphics.apache.org. -
    • -
  • -To subscribe fully: Send email to fop-dev-subscribe@xmlgraphics.apache.org. -
    • -
  • -For standard help: Send email to fop-dev-help@xmlgraphics.apache.org. -
    • -
  • -To unsubscribe: Send email to fop-dev-unsubscribe@xmlgraphics.apache.org. -
    • -
-
-
- Subscribe to the fop-commits Mailing List -

When changes are committed to the code repository, a record of the diffs is emailed to the fop-cvs mailing list. FOP developers are encouraged to subscribe to this list because it helps in following the progress of the project. -

-
    -
  • - To review the archives, you have several options: -
      -
    • The Apache Mailing List archive (mod_mbox).
      • -
    • The Apache Mailing List archive (gzipped mbox files).
      • -
    • The Mailing list ARChives (MARC) at the AIMS group (search).
      • -
    • The Mail Archive.
      • -
    • The GMANE archive.
      • -
    • The MarkMail archive.
      • -
    -
    • -
  • Subscribe by sending an email to fop-commits-subscribe@xmlgraphics.apache.org.
    • -
-
-
- Download and Use the Developers' Code Using Subversion -

- Between releases the newest code can be accessed via SVN. To do this - you need to install a SVN client on your computer, if it is not already - there. An explanation how to connect to the FOP source repository can - be found at http://xmlgraphics.apache.org/repo.html. - More information can be found on the Tools page. -

-
-
- Submitting Patches -

If you have useful changes to source code (bugfixes or enhancements), test files, or documentation that you would like to contribute to the project, please do the following:

-
    -
  • If your changes include source code, make sure that it does not break FOP (i.e. make sure that FOP still compiles with your changes).
    • -
  • If your changes include test files, review the Testing page.
    • -
  • Create a patch file for the differences to be applied to the existing code.
    • -
  • Create a new bugzilla issue for the patch. Include the text "[PATCH]" at the beginning of the description. Attach the patch file to the issue.
    • -
-

One of the committers will test your patch and consider its implications for the project. They will then either commit it to the repository or explain on the issue why they did not. Depending on the work load and skill-sets of the various committers, it may take some time before a a submitted patch is addressed.

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/release.xml b/src/documentation/content/xdocs/dev/release.xml deleted file mode 100644 index 77280a7eb..000000000 --- a/src/documentation/content/xdocs/dev/release.xml +++ /dev/null @@ -1,132 +0,0 @@ - - - - - -
- Apache™ FOP Development: Release Mechanics - $Revision$ -
- -
- Introduction -

This page documents the process of creating a Apache™ FOP release. FOP releases are coordinated by some designated member of the team. - The purpose of documenting it here is to facilitate consistency, ensure that the process is captured, and to allow others to comment on the process.

-

The checklist below is based on a combination of input from from Christian Geisert and Simon Pepping.

-
-
- Checklist -
    -
  • Determine which open bugs must be solved before a release can take place (release critical bugs). - Make this bug depend on each release critical bug and write a short argument why the bug is release critical.
    • -
  • Determine whether this is a Release Candidate or a Release.
    • -
  • Determine whether further testing is required.
    • -
  • Commit any outstanding changes
    • -
  • Create a branch called branches/fop-v_vv
    • -
  • Edit release notes (README and status.xml in the root).
    • -
  • Add the release to news-data.xml; - remove links to release notes of older versions from this file.
    • -
  • Update the FAQ (faq.xml) to the new release, e.g., update the answer for "When is the next release planned?".
    • -
  • Check and update the copyright year in NOTICE and build.xml.
    • -
  • Update the file doap.rdf, and the files - index.xml, site.xml, - download.xml, fo.xml, - maillist.xml, and quickstartguide.xml - in directory xdocs for the new version.
    • -
  • Update the version numbers in the release column on the - compliance page (compliance.xml); update the compliance in the release column - to the current state (development column).
    • -
  • Update version number in build.xml (not to be merged back - into trunk).
    • -
  • Copy trunk documentation directory to a new directory with the new version number, and update the .htaccess file for - redirections.
    • -
  • Copy test/fotree/disabled-testcases.xml and test/layoutengine/disabled-testcases.xml to the - new version directory <version>/fotree/disabled-testcases.xml and <version>/layoutengine/disabled-testcases.xml. - Copy known-issues.xml to the new version directory. Copy knownissues-overview.xml from the - current to the new version directory, and update the xi:include links in it.
    • -
  • Update the tab names and directories in tabs.xml
    • -
  • Delete the previous version directory.
    • -
  • Update index.xml in the new version directory.
    • -
  • Update compiling.xml in the new version directory: change the introduction for trunk to that for a release.
    • -
  • Build the dist files (build[.sh] dist) and upload them to your web directory on people.apache.org
    • -
  • Ask on fop-dev ML to check the branch and the generated dist files for errors.
    • -
  • Tag the source tree with the release ID. For example, if the release is 1.0: - svn copy https://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-1_0 https://svn.apache.org/repos/asf/xmlgraphics/fop/tags/fop-1_0
    • -
  • Make a fresh checkout with the just created tag: svn co https://svn.apache.org/repos/asf/xmlgraphics/fop/tags/fop-1_0
    • -
  • Copy the jai_core.jar and jai_codec.jar to lib.
    • -
  • Copy the hyphenation patterns jar file fop-hyph.jar to lib (e.g. from http://sourceforge.net/projects/offo
    • -
  • Alternatively, create a build-local.properties file that points to the above libraries.
    • -
  • Run build[.sh] dist. Do this using Sun JDK 1.5 or later. A Forrest installation is needed.
    • -
  • Create signatures. Don't forget to upload your KEY: gpg -a -b --force-v3-sigs fop-1.0-src.tar.gz etc.
    • -
  • Upload the dist and signature files to your web directory on people.apache.org (An account on minotaur is needed): - scp fop-1.0*.tar.gz* chrisg@people.apache.org:public_html/
    • -
  • Check permissions: chmod 664 ... ; chgrp xmlgraphics ...
    • -
  • Add MD5 sums: md5 fop-1.0-src.tar.gz > fop-1.0-src.tar.gz.md5 etc.
    • -
  • Make a test download.
    • -
  • Start a vote for the release on general@xmlgraphics.apache.org. The message should point - to the release files and list the MD5 sums (cat *.md5). The vote should remain open for 72hrs.
    • -
  • When the release is accepted, copy the release files, their md5 sum files and the signature files to - /www/www.apache.org/dist/xmlgraphics/fop/ in the subdirectories source and - binaries. Create links to all files in the fop directory. Remove the links to the files of - the previous version.
    • -
  • Update HEADER.html and README.html in people.apache.org:/www/www.apache.org/dist/xmlgraphics/fop/.
    • -
  • Wait 24 hours (for the mirrors to catch up).
    • -
  • Merge the changes of the subversion release branch back into trunk (not the version number in the build file) and - delete the branch.
    • -
  • Deploy the updated documentation to the FOP website.
    • -
  • Post announcements on fop-dev and fop-user and other related mailing lists.
    • -
  • Ask an FOP bugzilla admin to add a bugzilla entry for the new release id, or create an issue at https://issues.apache.org/jira/browse/INFRA.
    • -
  • Deploy the maven bundle.
    • -
-
-
- Resources -

The following is a sample of some other project release checklists, which might be consulted for ideas:

-
    -
  • Apache Batik
    • -
  • Apache Ant
    • -
  • Apache Cactus
    • -
-

-

Following are links with information about mirroring:

-
    -
  • Apache Mirroring
    • -
  • Stefan Bodewig's Making your Downloads Mirrorable
    • -
-
-
- Announcing the release -

Here's a suggested list of places where to announce new FOP releases:

-
    -
  • fop-dev@xmlgraphics.apache.org
    • -
  • fop-users@xmlgraphics.apache.org
    • -
  • general@xmlgraphics.apache.org
    • -
  • general@xml.apache.org
    • -
  • announce@apache.org (from your apache.org address)
    • -
  • xsl-list@lists.mulberrytech.com (subscriber-only)
    • -
  • xsl-fo@yahoogroups.com (subscriber-only)
    • -
  • www-xsl-fo@w3.org
    • -
  • docbook-apps@lists.oasis-open.org (subscriber-only)
    • -
  • dita-users@yahoogroups.com (subscriber-only) (http://dita-ot.sourceforge.net/)
    • -
  • http://xslfo-zone.com/news/index.jsp
    • -
  • http://www.w3.org/Style/XSL/
    • -
  • http://freshmeat.net/projects/fop/
    • -
-
- - diff --git a/src/documentation/content/xdocs/dev/rtflib.xml b/src/documentation/content/xdocs/dev/rtflib.xml deleted file mode 100644 index c61f486bf..000000000 --- a/src/documentation/content/xdocs/dev/rtflib.xml +++ /dev/null @@ -1,327 +0,0 @@ - - - - - -
- Apache™ FOP Development: RTFLib (jfor) - $Revision$ -
- -
- General Information -
- Introduction -

The RTFLib package is an open-source, independent package suitable for writing RTF files in a java environment. -By independent we mean:

-
    -
  • Although it is used by Apache™ FOP to generate FOP's RTF output, it is not dependent on FOP for any of its functionality.
    • -
  • It does not require FOP as a front-end, nor does it even require XSL-FO for input. -It essentially exposes an API of relatively high-level RTF construction routines to a host program. -This means it can be used anywhere RTF output is required and java is available.
    • -
-

The FOP development team intends to keep the RTFLib package independent so that it can be used for other purposes.

-
-
- History -

RTFLib was originally developed by Bertrand Delacrétaz and the jfor team. jfor was written under an Apache-style license, and the jfor team contributed the code to the Apache Software Foundation in June, 2003. RTFLib is a subset of the original jfor project, which also includes an XSL-FO parsing mechanism for a complete XSL-FO to RTF solution.

-
-
- Status -

Although FOP's implementation of the RTFLib package is very incomplete, the RTFLib package itself is relatively mature. RTFLib is only available in the trunk line of FOP development.

- This documentation is a work in progress. If you see errors or omissions, please report them to the fop-dev mailing list. -
-
-
- User Documentation -
- Overview -

Perhaps the easiest way to see how to use RTFLib is by looking at an example. A set of test documents is part of the package, and can be viewed online. -A quick look at the Abstract TestDocument class, and one of the Concrete subclasses, SimpleDocument will provide the basics of how to use the package.

-

There are two basic concepts you will need to understand in order to use RTFLib:

-
    -
  • Documents are created by filling bigger containers with successively smaller containers, and eventually with content.
    • -
  • Attributes may be set for each container or content as it is created
    • -
-

RTFLib handles the process of converting to and writing the RTF content as the document is created. All you need to do is flush the document at the end to make sure that the last pieces get written.

-
-
- Document Structure - This section is very incomplete. -

The documentation in this section is intended to provide a high-level view of the process of building an RTF document. For more detailed API documentation of the various methods, be sure to consult the Javadocs for RTFLib.

-

The following table summarizes the various containers that can be created:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
NameClass.Method where createdAttribute Set(s)Valid children
Document AreaRtfFile.startDocumentArea()Information Group, Document FormattingSection
SectionRtfDocumentArea.newSection()Section FormattingParagraph, ParagraphKeepTogether, Image, List, Before (Page Heading), After (Page Footer), JforCmd
ParagraphRtfSection.newParagraph()Paragraph Formatting, Character FormattingText
ParagraphKeepTogetherRtfSection.newParagraphKeepTogether..
ImageRtfSection.newImage..
TableRtfSection.newTable..
ListRtfSection.newList..
Before (Page Heading)RtfSection.newBefore..
After (Page Footer)RtfSection.newAfter..
JforCmdRtfSection.newJforCmd..
TextRtfParagraph.newText()Character FormattingN/A
-
-
- Attributes - This section is very incomplete. -

Attributes can be set for each container and piece of content in the document. The general approach is to build an RtfAttributes object containing the various attributes, then pass that RtfAttributes object to the method that creates the new container or content. See the Javadoc API documentation for RtfAttributes for details on the syntax for creating an RtfAttributes object. The following information lists the various attributes that can be set for each type of container.

-
- Information Group -

These attributes are set when creating a Document.

-
-
- Document Formatting -

These attributes are set when creating a Document.

-
-
- Section Formatting -

These attributes are set when creating a Section.

-
-
- Paragraph Formatting -

These attributes are set when creating a Paragraph.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
DescriptionAttribute NameAttribute ValueRTF Control Word
.
Alignment.
Align LeftRtfText.ALIGN_LEFTN/A (boolean)\ql
Align RightRtfText.ALIGN_RIGHTN/A (boolean)\qr
Align CenteredRtfText.ALIGN_CENTERN/A (boolean)\qc
Align JustifiedRtfText.ALIGN_JUSTIFIEDN/A (boolean)\qj
Align DistributedRtfText.ALIGN_DISTRIBUTEDN/A (boolean)\qd
Kashida justificationnot implemented0-20 (integer)\qkN
Thai Distributed justificationnot implementedN/A (boolean)\qt
Indentation.
Left indent bodyRtfText.LEFT_INDENT_BODY(int) "hundredths of a character unit" (?)\li
Left indent firstRtfText.LEFT_INDENT_FIRST(int) "hundredths of a character unit" (?)\fi
Borders.
Bottom single borderRtfText.BDR_BOTTOM_SINGLEBoolean?brdrb\\brsp40\\brdrs
Bottom double borderRtfText.BDR_BOTTOM_DOUBLEBoolean?brdrb\\brsp40\\brdrdb
Bottom embossed borderRtfText.BDR_BOTTOM_EMBOSSBoolean?brdrb\\brsp40\\brdremboss
bottom dotted borderRtfText.BDR_BOTTOM_DOTTEDBoolean?brdrb\\brsp40\\brdrdot
bottom dashed borderRtfText.BDR_BOTTOM_DASHBoolean?brdrb\\brsp40\\brdrdash
-
-
- Character Formatting -

These attributes are set when creating a Paragraph, or Text.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
DescriptionAttribute NameAttribute ValueRTF Control Word
BoldRtfText.ATTR_BOLDN/A (boolean)\b
ItalicRtfText.ATTR_ITALICN/A (boolean)\i
UnderlineRtfText.ATTR_UNDERLINEN/A (boolean), or (int) 0 to turn underlining off\ul
Font SizeRtfText.ATTR_FONT_SIZE(int) font size in half-points\fs
Font FamilyRtfText.ATTR_FONT_FAMILY(int) entry in document font-table\f
Font ColorRtfText.ATTR_FONT_COLOR(int) entry in document color-table\cf
Background ColorRtfText.ATTR_BACKGROUND_COLOR(int) entry in document color-table\chcbpat
-
-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/svg.xml b/src/documentation/content/xdocs/dev/svg.xml deleted file mode 100644 index b76626c5e..000000000 --- a/src/documentation/content/xdocs/dev/svg.xml +++ /dev/null @@ -1,136 +0,0 @@ - - - - - - -
- Apache™ FOP Development: SVG Issues - $Revision$ -
- -

See also SVG User Documentation for more information.

-
- Examples -

-These examples illustrate a number of issues relating to conversion -to PDF: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SVG to PDF examples
- svg filepng filepdf result
imagesimages.svgimages.pngimages.pdf
svg linkinglink.svglink.pnglink.pdf
gradients and patternspaints.svgpaints.pngpaints.pdf
various text and effects on texttext.svgtext.pngtext.pdf
transparent objectstransparency.svgtransparency.pngtransparency.pdf
-

- As can be seen most of the specific issues are handled. -

- -You will need Acrobat 5.0 to see transparency. - - - - - - - - - - - - -
XSL:FO to PDF examples
- fo filepdf result
embedding svgembedding.foembedding.fo.pdf
-
-
- Developer Notes -

-For most output formats in FOP the SVG is simply drawn into -an image with Batik. -For PDF there are a set of classes to handle drawing the -GVT (Graphic Vector Toolkit) -into PDF markup. -

-
- Classes -

-These are the relevant classes, found in the package org.apache.fop.svg : -

-
    -
  • PDFGraphics2D -
    -used for drawing onto a Graphics2D into an existing pdf document, used -internally to draw the svg. -
    • -
  • PDFDocumentGraphics2D -
    -used to create a pdf document and inherits from PDFGraphics2D to do the -rest of the drawing. Used by the transcoder to create a standalone pdf -document from an svg. Can be used independantly the same as any Graphics2D. -
    • -
  • PDFTranscoder -
    -used by Batik to transcode an svg document into a standalone pdf, via -PDFDocumentGraphics2D. -
    • -
-
-
- Ideas -

-Batik can convert ttf to svg font. -This svg font could be converted into a pdf stroked font -(type 3 font). -

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/svg/images.pdf b/src/documentation/content/xdocs/dev/svg/images.pdf deleted file mode 100644 index 01a34deed527ab84ed09a6f46490135f39b0efec..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 482439 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 ^Ew!T|h z$|xJkY{dY%1t?r*4txlr4kbn&+O61a=p&Aam|21}*E|(hN|hBXa(tmBYqp|2APMfz zMJn+|)+YZ=CR3w2!vgF|r^5#T-lHVXg_a%Tm+=*}m^MeM#DSRN41{QpFIuAbx}Mq^ zx7TLujIC&(;JdTSkK3~%n#ehur>q9laa)Qa?w*Vuo4LloJ|u^X$a==Y0@}vN8$NWf zxnq~jAr`|b`Lph%x@!F>lK!^`jRK14$?5qy__oaKTwQ~eMR8Z@zXV5FQp>01moS(h z8FmIr&7XPl_b9WfS(!+59nzF`HH=rw;vVIxgRP^riN6mfaz&;LerW+vN15IlNmFLa zbNW#rpYW7W8|p#Z+Y3d6O}wryFEBG(x8cpmBMzU(puM`>d{bAu+@?}f8;Tb!S6iPr zyWWAm@OK57O1G}ECriWAftv%BJQ3fk-=$g=C;!x~Cue?JJKKaUYI1N2a5pt~HUw?> zc~z+gK&YL`$L42?)iCgHZaW+7WVQE#4v5Mq&2h$ zcbCS1MVbw$c#IL#T!-;|fPZZeE32wQyar(55G3)24iIku5>FKcqKtMtEC8-(Wo5

R?GctfeR09ptMb0}Bq(d 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

h!=$>)OrMQA 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 kOX_LqOaOVQ)weg5we1h0=_{Q;{kqrjVIh<0_r2 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

K4 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�(|p6oxQ3%Ah1mN-UNiEu)$v7hBWdkl-aM?J= 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⩔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≧sR**M{RfuJnCYZ*!?YRjlrI->DBGeXGK}$ltttj_8v45BPiowea zp6BSirH>q?cxF06NNLXAYmokVXN&kNtTtC9q4z0FmwZclvC21;B zm$=SQnZqIpvcyjXXltI-mA5Z^lF*RINRW|wW)-xr)aSOlnt{zEcpSp*EqS`8>r?r> zA8)>9+b?DI&nEvzCH`X`{YQiUuLk~)(*DoV{70_;k&OQ(hadRx1D$=wv(M1_0-TR- z@X5iStnh;+KA7^uwEV0zF29b;{bBk4WbomdjxONr6lh1b|4R>!X6&>ZUOc3CH$~^P z867UC`wO`DNWMJsFHhOWUG?#?`MBME-aLL@zkFFe?ag1l{jWJx$Hn@rC~woElV-g* z(vtRRuN?=T1nsc4*j4~yX&`k?4V0LQL{D0dG#qJ~k#0ts$wy8&bm;()2N>KV|DJlc zQ48R0Vk-bUmDy{oi2`t8>b2o40H|HB@==CRN=eEBE)Z9tTmot4p+d<4bt|V*06K1= z81x+x0FFV(5Q|XTrj-bsrzFowy!m6{4R9O;0-;FxwAKgGFbbhUOes;gML1RHspu-fNrGdcOgvU< ze|Lds1W8+d03kvK@C`edm_dIS-1ma}dvtq^ZqLcX3GN?;!~JmjOBmlX`+MPjuh5S< z`LR%$AV1hfM^EzTSscH{$8XW`TX^uB9Q;N<-@I>c?w42h^9%U61AlG3zc#_2EA;1r z{c9fmt4#kY@{eh=mo2`>$`3vtM6W0E^;Eu((@TEe$1e}rYd3uvB(Ia?Wfnhaa%;sK zTdW*0_oCX5R0xs=EP-KyxJm<+l~X2&5p|n6MQua`?bw@1I7qyQ*uPKw%Q(19{8K?M zGJ2APXGwG^<+Y6O;jaf4DkRL~Ad9?2DO3Up1sOF(U?hPdJ+lF3~EH!U44K^dPy=B{LzCKNNhuP+P zzW!R5|7!AoF0(%>_CMz2KkDE=8}QG{`lB%aOh+H$;m3INiA}$<*&Z>z`p%x`eF6R# zC;Z^>mO&%^tmU7l`PXTAFfI>A`AILk>Ls@w*|{OZD?Gahj1$*8w(zmWE(Ss|cyp6> zPv?Wfg|3o?ZyWUWiGJGVpP$N)yZPtc=F{r&i_-E*`N8ki_Gj^URBleP^+h|tDDTO1 z6mwlNJ62ghfD(_y4wg2N1{Nw8Hrr?|v0&_Yu>+*zC=!`vG2NzGdr%b~2dInvF7-Ox zyA#e`;@m3+%XbDVW7=3+W9p6NR*qM>fkG{7>vfSNiYiE>76F|2F!zH3xb6EM;1sr- zJBkrEg^s{Z)YhK+R6r~VNg~v~W6W^V&}N~Ql$Os5z)-2?mQodZ^H%LZx+D;hA4Pu5 z{G9m}bxY*e(5;|TdQR>+SpbT_jS!H;=NvK7p6^JK5T~5H14v^*ltkJp%CM|xRAF8b zngt|lPX=}butV3R?$iTg0EV_VoCeAj_ImK)4n16>?iC%KM&pxsdL*r*!a2yjg9;xu z>~P7C*WzRopYGx_rDr8^`od3M>G2yqe1$(>;J4@C>kfY01^-&Zzc%O}CHY55|B=Q2 ziqn5Z#RtCl8m_;w^-uPE8a|(gub1KTP1KI^>cqc$@$X^wHp-u;_2aDGY1PhdwobhU zb=^J$$qPS|zDnO>6?w9@+eW!`>UzxenGM=WagN1ZGXlfN9}3tL=stU|981D$8D2^S zAirip>5j-gj>jmOB4N?kW!z&)*fzV0BwC;8(Obfy$tbJrr!g5 zFL3vKf6rrkAlh@po|}EQ^Y3=~YnJWLio9VQNm0ghC_rqnKz$1I;(0n#DV zp+Ba=ek(kdqRS5=Sy1D2QUhqzcSbuE$s!(OfVo zX&kdSWg=&yWGp9qPH2ObVClmuP$tERfi2Zmb!X6-_|Cv`273G2s5?*$!iO8&yCTC2 zF*%dkNopUb;HU^rN_w;iPnP_29basc%UyE$_^#*V;we0PVW%(n@R|I4Qc(^3vQ_lK zKbPo_MGN46=HWjw`A3xg$@33XF}VCrxBF~+MxQU)^L6xk&tE&@xhLO-#ml&Som9K& zd^cNcwdKZItgOYtYAUBGoGN!q;bsv?Lq8>c+wm4)+O98byDyygf@H_wo+i9e1O^fA z#Q0vayO>@_{91?`p#Y3;nY^dz5XF-qp83+o!c!ZC@iwFolyjC8B+E!vp`u2`JA>u_ zi$T#cnDTkd=7Lq6R7_zAGYnG_qzEJ!B!NN?B)-!MxVh`*7N{(*nZV_kF8ks3F5X@z z>+@=JRIh$D>mTdt)29BgPXF4(AJ^euYx-gCew^E%8sl?5`<{(|q?7$<{GCts*=(Pf zKal+cg1vxz_rpDp@43l$Csi2!GP7TLajX?*gY<5Yb~>{6AoSbNyrJ&77o0it)ZmxH zLNR!IyLdR=_75LNzn;8rFTvMW`uRofJ!fB@%e}|-xAmrdGBe*DmXAmI?)1Nh0L;6h z97UPN6Ek97M4-S#cq){Lq|Jq!WLBKMGZ;Hz0>Z>YJV4xsGzggQV=q893M}lKEYPSs z<6s(rapnwjXIT65IX|dBCrzQYHQ7W zm6=)swMA#7EoQc00&oiaEC^}>n$TMaZ;{hgNmq+-z9jQ4Q>r6Nsp3u}P#uv%p~Tx} zjZn!`3|0&@$jw>+ot!EFZ3SQw+9Gr!;c?}aW90-XR#8+IQuV!xK@oEvv#1Eef`&CE zb3&E`EfH#hVD5R9*Ph0hI;ON|*qQqF1UN(88_fKHa)n*kyTgN9GQASBOKDuh&PC>( z<-vJH&ztaK!LL^0Y7yV8lABe0yG?Gl@@B^`ckJSko;;F+E&92E-&gq468$wNe>LRK zjQx>D|B~`wVfKOKAIah;S?%NH5#64X?G=5zp}TJM)Z@=X`8>{FX4TVlzSZX&ZMD)D zOLM)jR&#q}nTG8~X&DR^gZ$l)MS1S01uhy~)T~^-Yr)I1 zRh{uB;R_K~5o;JNDJcnzAxvNp2g)|P(pOuWzs>EuX`kLC0*njD9-Luwvk zdmsD1eEh=?e|r3-($!^$qX6%5N{p_vhm0^Ze&>{cE{CtaoSS?mXLGrOStC(c|-B znCW3+vB+hiO2a7+SOi35OW{aiC5e-!ibSXfoq$zGGRQvnv~ut^51WU!RIRn%F9_iK8)LdSD>*aZ8Pzn6QTlHh}cA42>m zWq*&C*;d?iSW|ZfzI#Zf-r+ z&NkPVsX12)&5WrVVkg*(eJBDHS(vK0!$io%%x;myjzxe$z>J~^fg?(WBc>+{2lN(jZ7$dFm%dp1L~Rce(E{A4mWqphyf-1C=^1r*hFx77zL2rk-Cd7H3ME z=3v_#?8^OBe6SY#tMFh=j+XFb;hh!cd8S<^+NGS{@YzkM-BA0QxL4S}BIFc@r-+}R zdwl#Rx!}i(O4P-ZuhC*3FtkLcXoO=tZsXYPG{M@dK#X;j89(8 z<5&CO4g7j#KcD%JCwZ_dP8QX9)0`LeZ92ad%>%FctQ?ViMx~2XKE^P{>UKrUR}LYI zoLpGBu(R0AV>?Z)ShyngxWF`2Spy@4pn$Z;fIE;nDj@Z^ZAZ2hJ4RdR2lO0hxjQS` z=?Z%3S*hiwHi%VnX_8Q*)Ci%;13UB_712^hEgZxKBpN|FCWb%;M`qNP(3=dKl(aAS zU}X8R?PhJwuC;*v9C=HImXWtk&?ZN#T6sgJl()aKStd>G3cazH$mMD_wr~^h+!#4 zMLemKNtI6Pcw8nEb*;nxoOKuUevU6HbXvlrJou6LUq$dm;E$MmKef3q=68~_s z6E{D1@(WOR{kj)4Ls-wExgq9OHn+;TGjHt0+}YOlu2S?_PnFp!HP=dswG8!&nFX{` z=*Mo`*vd^rER1c4ErhH9J3eu3>{-M&2%0f6VRTHRAr%86hBzLOSY0PrXh4`Qw;T@L zcFbzq9_I%k_9;S95^&iz7KRBH1r|A#g%XoR7^ghWL>lu9U*7JB!uzVsW*cpKhD8U48UeootiC zZG61qCu@4Kgco!FDmQOZ{VvlV`0Sp~I!wP0?bfYf|K|OK#Y@C5P;v>=3zT2_`E^j< zc=^3scI|vblD?4`H8CLiG)x*Q4cl*-6cpIO+>BqnA!@t4t8~*h| z51yl=U3Rr7uAAzvs2<{`7uCbCoZ`ZOi3J6OA%QeRfxv!3K}zj{n`LAbky*u75i1hg zDheq*p_~Jy?dvc|aT`7|;$dncX8W!Aa~$bdiEX8zosyw2EL!OWa1zH&Y)@F2>y&CC z*4w5>UCO$D!Si-9ZZa862c&kkVlijq`YtCDS6&@>FlHiC#)A7t@Lk3(~J~ zr-Ijcpkmk4#QQ1SZz1?b{m*{z37}67{Q<%s4nMTTi7l_J_{PnKZZYvo4drH7Ix=@< z<2IENSeEXl0*{6LSh-Jy^_<&}?*Oi1b56{Xn7K-gp)Y*MJrueM!1iQ4WMW^DXTtaX zPX`7z@->V!f@e6IQZXU_ThUCdt;bBaJs2K)D$9WH47UAWl-gnF@wgprKvG0A7^Z~e zgk>bm7*AM~yw7)6w;Hh+DmzG0m!xgan5X<5cL7)E0h%)-tIxOf#Wp?LBvaj-K%0BRgHiH;e4P$~r|c5XFcWvoO(-3aEt# zL*!Ey5Uvtltnwr~Csq*}B{z%6sHE~JRv9~S?8eFuavV}d-m577n?d)TK~pj4DI+Lt zCvFSg+u87$r{}(w`|1lPc3t6kk;?1L7C>l3z!Z)p9Ge?0gH-dl9?&TaH4F{q`&9hN ziA9m6oFHjWcDFs=9vcjD$H{^7e=xX;@wQ;=B2-GksZz}K_rebtg_yQQFUl5&p4B#Q zc$x^b2u?yYW_U=+fRF)-MmQQlp*E7~w+F0)AcVMmN~lau6rxxJS>%@#%n4W`XG@$% z=sY3k*>Rs;=g9$E%U!oU6(F~~#B_z-cK!!}>%#VF=`8d#?v0~h9Ko?*GxZCmp_U3G z6_!%m8aSY`(MVmT7eyeVwj`#+GwBZ^{~_{jIXHvvaR82h_sjG59sj^VM>BLXBWE*u zZ-gBq>|4>;iDn?ymEU0P>p7Ifu!+f92AdQb_>qOKd*H#-lLS(rT2! zWy&;p9QbYjzJ*i_;@MQWzQ7@B&qDyA%KbeLVMUllsR~XE!t_>=ft0wV5~?@Abi4p~$n&8OA*K!u?NFF;tmpZx%qLAbSX8}b-CNgpoBDQB-ENBR zChshh-aH&sWK^JW5=`5D;Ax>_wZl7riGmqIQ$!{(93s(&vQN`{lC^!(r0P(mvWxRE zPNy)|k#PM`Spa0XOgDvQWTR0t7;O5T$I;#E@bbSVm;W_7`8_@PJv)2yuYdcu&*=UM z_i8q%!%-?sE^Mq)W|iQ!uiR85nY1P9ZsA!a{J-0K&n3x?BwhQ`&+ZIIaE7f)r$!<( zp>-gjRX_s?q*f)GTsv3tMHF||q($R6Wsa(DCK;^;Q zbu!Z9DE49E7zmPso4ICYDl8Qzmq_yrq=gB-Q~+~FYBGuJ1j{FX$PXNGH1rk>gLQbJyj z6e9)@Ux(O_lORiiB8|3bw9leb?p_P;EwkS$_r0_}O6x7xuDO0r^S=^K5Ubi;^ow1T8KJ;V#I zr{gz~28th(%j+XE#MXz%b+K>?mgAI)Eb91^Ms7rgs6ao_y;O4&-HLS+1LzwVK;6Nz z4d@!sCv~kB{_cTohn|P2x0A%oQ=G4N8!6#>Ke z9|rX(&~SkB62nEnN=>V9KD2!fjrM~9M84`sDwCyfI?{Tk;R10Dsafb0@qtO{=y2DFk)aVSxB)W726Isa2(99 z75i2e!!m;F2y6qe^^A*aTrhwRxRMcv;0D~Q;hYWkp!+@etarpV886ZvHqH1$^7Smx z@=z^8%%Dtaf)YJX$v#(6I9cXpIR-rlvXGp4L!nQOz4<==%N-CHl5en{v2ye=)Q3PH z=-^2QkE-#kz=3Fv1ZyJMOT}e0msdj-28M}0DAH6f&T+CAqfLwsaeU6gTjsyzI2w8% zmHSrNZ#g&>#wjy)IcPIb;=33-H_`(KXL=ziLB`7^IW>$dm_R%H%>6Kfu1~h%Fl~70 z1!T<(%`gUGX!&7C_Sf8$lsy{=!|ULDU&{h1#hxBXWQi>#H`Uxyg&7$iW@WDX89d23 zqri`y09k%w65|nRFvP<2VVQ~p6~|I6M>9PQ1iBIa_lB)aeqb+f@Kr|0$WyJ%mA+B7 zYw56-w>@{*aQmJ+b@)HUZ6$TN)}(ra%q+yR5q46J_qny`xS>rpgJZ+b6d&h9xfIoG z+%QSIO4n@Kv8ZK>TFxpt&9xZ8D01++0gc#HGefQvej_nQadnkuuj2G~EMY(-4?hg% z9Wt+$c=p7Nui`jYgbvxS3IfN)ET@1Rdm#V!gr~#&g3T7 zas<*8#w0RCjuYBA(Ey~^nF~nGp{oa;;YQGjKd)CF!Xki0WR$*924)dhD8$~}#r!%} zVwx!cNP(Gb=8~PtPA2)-O(a@`0mOL@2GGXquZ=Hfg1re2N91$HtFwh&I5C}-1J^FZ zS>ZOaH=(x){XPgbS=^@yR_LvWd^T`o-_<4*;WKgWo%_>sua}cP#*zv zY=W_FPk}YnElPJ-)!|he8#!IKOv7@3=9p?|DTystmb7+A0m#W!PnLeM^s5fubo-{+ zN8R6RUa!Y3B-=U#sryeN3{)7wB!(yfX<}8#tP)Tbc9mOY?&O(Eo<-(SlqO`3ZH!2R zFfTQo!~_x41E{&S0)V2Kk_5z+A&`#PiZB+0At#M^c`9mCNn1#OQA|OBijLnY={Mrx zj~bBYIWY3^RkC6n(qiDH zs`Due3mG=H{1NF0gjXep90`hiHw)b?@N&;fT|Xm(z~b19Lx2L1`9^{1^TjOWP{by9 zK`exb4CEAXzV8;QUFcR};0R*oq&mRF7d9|m$MQ`Okg_>F)U`mDJwtK;cGjF}afVBz zN1Pt>S|Vz(q$aYF08-O!5%9_+%&(8*R5hfq}=qES%FJ<;2)Bh#WKXH7Nn6n~obbW1*TDlx3 zcQ_>3nQavotN>_%yf&nbA#6-$XD#>6a_27g!D1IJ`iN^&uFm)(lao{lN&SI^QxVhg zO*;f2G7R!+k={7I3rNG6z_vo$zNSuzJC#*~((JOlCsC}RVM72`!S1_~G{=19UZ z1ui9kWPkSqC zU{*MJ>SMS_FIYRlb`Pf!1*|f&B41b)2C(#UMEWv^N#dc*#cwn&YzKcX|JH|m0ebLS~zj$OI1sfHtSMh$%JEdsl z3aC`00I<+?9MNK62BeP)X3ztgZ>XNGc!p>jf@QMMWP!IbJO*dndc>$Pr>4A;ib^i& zsSZ-Z!WiN(>PLw~PN|llY+>1gb#JbFquYR{hgfB2)oqa1Sc#v-KIz;{cKc0KfGji9 z7?24Cu2)-r3Bt-qY7sSJ-U@liRux+nY@JFqlB!6>sceDG5`?LiMq(aFHKcnmKN!?e zn!SsYpThXRWcov-{!rKtfxSu6MNtll-D(a_WYf{cfJp(O*HS~Rh_QNjLS12Ol2Q0i!tfVq&uGG_&6s}aaw@0b^OVhp7q&q#&@mI zCoTaef_Ob8r*|`uq;^QwN#8-C6(;0CgP%!WCc2qKW|}8T6l<}s;oLUGxhe+G^l~%E zNx^24gE+HM>?9FMuVN>S>^!lnz-|bME@rSzf;A$?T59rC9b4rYmTk=~i-C|gO+hmh zMbjij6B(UbY67kC6IC3k(oj>MMD0P+9tG`L&|Y|Lzyq2G3*KNjRTLFPknz7PS#VU& zSA|sNN{wqYX{$>IT|bc?T=1q@7d1Mn@m@{0M%J2TZIz{4WkHpYqpg)s?u*LJGY6wt zlx|*mRpk|Bn3GM{EQ||3uAH#3g2sZi3~NcR@cpF-nZ(5sA1JJ?Fs96i;))a46~9{W z48?J@AW}SLP+iIjW>D63)i52;^a3*eAEj@X z0o+vfy0NpyP8v7J$V_GFrGqLf zEn$`c?8@?3sjvd2j`*pp?Rf9B0Gns8wmO(#%2!NC$}yBg3@~?4AQt zaZSYoqGJj+1`x8QwKV*t9xU~URb>+2OTZ)KkSonwj9mfuyu)K)RmPr0l6| z?P_gRja6*il5~E?^hIf%q;=|M;@&H;qE%eKH6!gN0|} zP}ul(8@ubsYh%C0cY7RT8TK=gHBhaI3TFzKOWIOU7+z!NTe(Jsih0qJ?T_R88TD?cxiBtxVhKE8Ql@;n;a zYYldiu@Q})Q@5PFVYrrK8+KK&i)1wqn1!>N8_YskEucpFp|J43a_c6 zp~?m@Jz#mzi&XsKqe_n(Gw;oG3$v{sAA{sXGSXm|`Mb>PO1CNPvc_uy8Moz>wo!U& z?(umbpm>Q8gB9gmm~(zE#F-Xm_>!7ILSmqgZ92}j;}i!^2W8~BLym1_VQw;go2%PQ z+T~)GahsfN^VK@%vW&@d7U6HV=KYqmCo>BfklyZ^Nt%7?*!#JG?z$SuU2M^|c*|Nr zX9?Z8;mve!toRcx90_PFrV~D$isg*2=2E?sQ%1{pBay8{b3(%lJQN4yfCU)@ku+Ed z>JaL(n2af^f~N7y#%^|YwS)B$pk7b+dfFNJnsin#3ODtG%!^2~H>1e3GF3VxVq3P0 zg{>ZsBuV}3NLy*2LqQ5%h_c$}o;Fq^nJ4KiBI z7zqhntgJ$n35=x&RvutIC^NyoO$5#TATd8?W+S>3K!qWHCSp zJ6bKmsV$NNB*)kT;)FFaFn!3eNathd6-Jl?{L><`iEAL7R>jy+I#G}$HjaZ?1POo< z#OY||o3)2u?b5<|wvDA)k5~$PlHpJSBSD{V3dKnDieJ#wlAbclF*CnkEq<()Uzdxo zi{-!R#cy-|%Z&Xx<$uhWmoYn%44jwicsqYz2ohmwNo+9 z`i_%MEPtSx!+h1#^L{>Wm(zScMT=Q5r|czV(6r7h_{EZA@Gp*&{+mHTS0qzaZQb+? zC)8cMq?Kw+7&MaJOtvuIy7AtN4ned_ylv`jGPff^+0IGCu-(?S8V}SiU-?WKtny@; zA$(&k<9rckt1w$7Ilg_AFvl2L8SW~uE%jZl?kZ_tDEo@- zbG|D{uc@lyiki(zG46z@6@yl?Dj8y722+e7+2pqa)$yiZ-_1;mp zrn=sisr|_E zx(tjJktsw(asrhM>bYqYmR&)&hGeu$1B2EITGy?8EIW@up6ChE5K^O5juRz}wKUYR z1<4#3J5CB61fv3wqUl0Uaw9E3np&ioHgFU7lR=0XEPYS~p!Q+yg8H-BOAcXXVM}d^ z_T8r*c@yh}HwG(ZvXrMZH(ksZ^T}c{Sk3O|^KT34E4}#Foc@(s{A;%QZL<1py!tj; zJ`ERx0X-g4%khkzP~vo`PDfxivZ!%5pCEdY)7*N&^$TgU)b+PtZl7wxyoIX-m;8lMLbKB8A9_YqmpzH z7hF`};` z_yX&huLeRj5%QUcG0azb%9)6_5)foCO0Caltxkbgn&Pv8Sm$B@+r8T!-3HTlF{_JF z-n8_jpo@-B8k3DV?EIH1c+R62KYe!cA;?E^G2!wVo3k|H=ZP?nrFo*vF^R}v z6ToMtkehM|mCqwGW@}k%%W9pVcZ1FeI^V_s)}dL3IOo>Wm@pV4B|>@>=_oRh2V&1d zmYcu;nSKhQ%#4YbG*Aw493*2iFoQlKwGFTcO|05C8k~_jT4U=KBvYnS9b0srb$-KQ ztglP+`@*=R)jLXlnel@uGn`JxlhI`QGM#;&P+z9hZ`0Y|N7UcOvtI_(ufyp-pQ+zo zCf^>X4^NZl$I?8|&pXZ<=|uj96li$08xwts@o#Za!2^u`Of z75z4&ZlmdKG&(=MoSz2!=fQR~Y{$cDLPZnGpDsOmr7k#?5hPBMB~|##$gZJy zq!AF=u}8X_89|{(B?xLGY(dbH#n4-0+I*b0dnFEIID^cssC0q~s11~BlW+WG?NMzw zExchF4vKJCqe+#_@`NfgY)Y1SB}ADVS0FASN$}QL+!x`d4t8yL=$vEgo;z@8>}#tX zD~zFb==4Kp?l)@N8_h!6>PCVab56LjBMOES zGa7^VS&5(Iyo-PNPUh}IBo zv7G#XWfm8ZUyS?=idQ3l1;snauV(QIvkP|3ZoKuQH44fs$O<=F+jbAZ24df@o^|=A zNLNvQ<)v3%xiQ*}G0sctNC&$a+D?mdQs?77o%Hei7SOK_b2HeBBA!L%s5)E8>(sEr z0IGGYbgs4o>Pc1)f^y}R3oD;F@xllfZgu46TY1telinEQ_8{|KqVU;4PiFqC7td^s zZ@Uqx6t3uTu^bl?RmxPU%`0tDf+Z*N)n`p!Xo@=Hi*;)iwLb?IU}g*bR<% z$Rx8ckd6`~35~>uA$c5SMUJ14ii|KZgUpOlYy+)0{!A(&k4&#|q6i|-$Q&()IH6W* zAd|k6npUf7sp+|*WU7v}aDT<3?SIYTR|EEZ){X}@2Fwc|O%Vap5JdY+{N7H|g zr~e#I{yv)ibvXHDF#X%p6F2C*EfMKMXRT462yHYh}Hb-fQ7ss`y+an8aP3Zd=rK*?JS! z`?xp-;mP){rgK&0cR_q#G4BidV?6m7PF`OIZ%>2k{mb!wxOo}2&% z3sGkzg;Nwo6;(|#OvyGS&s2O(ao}+Prk&w9${f*=>yV#;7{8+JL+>(+&g#KaMsdj3;GA0U4R=pCdt$3MCL zK6EgHHTHy!llB1a40zD>i=tg+`6fy443_x5RNt@`;6|EAg~w@fnC0!bttXp&(x;1S zw73MTtH~dA>7;2V)$Wy`SJFx?Qgt0_YhOPp##uHltaj$K%K~F4T^ATb?!wKt(rhb_ zT5VL?FUWlgf(MB1_54xJAC~nKRliX6bW~Eqay~4%aV3l^Y1XP#Z7kMcxwiR@BWxUL z<7qqJ*oAQKfn8|rd~=)FJ$b?n8!`(55DX)LVi3nx?7)Z&uyAA7kL)0}{0IYTM#zd& z7)2HtGZSGtgXoh%QcS27j`}Bnts&K_+$d5hNrfz@f`qm3e*M(H=jLye`E90sn<^7}XL z$9L)OyLNYP-#>T{PvHZVJ}im{zIfEu1K17ScARghx})2Eby$n1wQ_0oTMgeT=e2Mz zO?BU<39$^=ZELp!}IZZ zw0|1)FVl7~&!&rHw({qqwUTvKF$7H_+o3=PP)5;oE&aiTxD(|uOAFJTybIKDAh_gDI zSNRgBlX;^SIJ}T1Kylp1>AsG3RdQ(j>ly>-z4bT_!s{BGJ9zEDxwlUp=r-1R1FOzy zwobXR^NpLdcGS92Yx!k`u3eE$@=`^4!>x31ixv68K3?^SS8^%JjNdHKdlKN;!gQv6uR9}D%3 z*57FJJPA+JWIs*Uv!s;fY;#^k0 z@Wy$iUzYlHC7x-FAxj1*i}Q^{t+jCmN5~xn-jj(Q)a*gXpO(!d)edIs(Wsh@YIix)!2w}Ke@p&iGD8-Xweq{AiA=aWH);7T6+8f3VYCAXTeR{6CeG$P*$Le29f zFBY7DMJ2xyh5s76{~p`FjlgeH?O`H4%($l!HJFY@lfi`kI;Q_Uo&RGp|79}&j|ugk z!WU)G{>aCF7X`M zAGY~n8Xt!EQ{;c=SAVP~KdIsGlflOT$HAA|{qXWQ+WwgI_f-3|%Ev64auKb1tZs_{ zh}ix)5|-r&fhR<+h#Wbwl+4yspyj5S0Zu4j-!IsX>D}8#mdqD%d=iDze+^6=dFV z8J()|+J?s}xHR~S__j`NT}&ElZ=>TT*lprNA8q@n@4cq+>&CAdFRs0~^1{lEDmN(Y zpui+z3^gy49kL0}S}6_D3?vhfKI`#=j_$SOtAu_NlP^O2Ma;ek=~q7gLGse#fi0df zhFm=sJ4#;D+LqQgJiKt$S#qwtcawrQIs7o)agqq(LA6hkeHN_S+Ty!Pj9Sd#bl6bCh8=bMxRWLuo!Xi7!C4+%<`iHa2TyW|56BgPs?LUg!n^7K{TcaScSK{Q&gmNXUSk z6OJO=_Z|Gdx_0DP$T3S(YoLn5U#E(_%y$Cc^UIE1VCD4cPf_SstXcf))cbAX{5G+^ zPSyK~{4ix7r_^vZ98RCcgu!14gVcXcssA&j{$n!!%O{5a7`}XYe7Spgc({9@?!GU+ zV+OxT-@a+zzJu>~_Sbvw>y!W6B>hgM-rF5;p zYiZpo_pSAB>*#eG?eU#>NH+UueM`z~oW8}*n`!=TYVVr(hr<387QZv&pR>X54YZ3+2IP8OQS0b4XJ#nVhru>!^M#V{1(KukP2b(P#A-6=C@ zq^6l_FjK8mcXHW{R6mx z(FgZU__#(dZ8~ZTx+zz6&6itP?A?6lqZ3Mwd2%Te9P(eg@U6!HMz4K@UoV^JOxheI z`##x{diiL*jvAscZAe=XRQnMY#<2RcS_ycCLx4;-0r@4Nn)WcHf7F^3Pr7(-NNdSfrzNpcokUX&&VQ}0$PukJ2oebC1Xw6JE z!ek@Q_JG<$`ee;dA$yJ3Ys_C0{*p?UOgg9fDJK~2a-+{-n_~vu47n(BqxiF6(T{u> z`DWtj5hUhS$gO`I*{3%(qX=ZXlLZIis|MHar2^q77AF2cc?X z2E+ehFpyJ^%qz}qJt3#l0n)8hbCBZ1S`f)WpndAIHqf(N%eJBC=mC^siwuR&jcI9& zOKsS|rv?xPxAxt}{ju|Ybm3zkJ$30|olM(&UYBgO)r!51F-*@XI_2nEp;Lvf>*U;| zZyR*$^6NG}uF;`S4}HET$~Nn)>rmUGcAaEocu$m+K~e=_>4hW|!l1zEsO;qec7+~^ zgP)cVy};xNpa(Pgt|s5K_^X=ykfZNXd?&=;1q@(*&*TFf2bp@rwNr67llC+9i1R$g zys_|=v)_2ps5nQ_y9v&5;oWHaMA=u`JW={#AvJTMUafVwZ6~98Hg4&0%g(mqY^zXvlRnz?$z7gf_KNsh%HMJk>srXyOx+jyJ~uW6 z=nJ#SVMCHj@3UO^^B)`x&D$OInyL#NkT# z!ifK7`G2y)FC6!u9RC+~^~;L++j8-*#o}&8Jx^yiV_ghhxR+<~`9*trG9O;R{ZsJp z;@=OW`&syH9)DXU-<14bFYaOf5N3mf^cR~o8QmAmCg;zkb}7KQf|u4m_2GFJ?@#gm zingz5{f5eqH2sLZKT_+D2z~^@hsnQ!v}^G+$j%M}E<>E)kQ(S?k1IW6Qglu@W)43VS9P>T#B(u_bdeF=IT8FEO(*bs|% zfaIE*YXFBFO2rt4CJu$Gj5LLvRr;{eUmD}N*S~khw~h6^ckedg{VsZ1XXCz@wfVB` z#j4ZFtx;@9Mq2FS^i-s$8lBtX(B`MEJZ|#Sx;*yfv8^^;wOLo2Hec6RX;T$#mDMF_ z_mmZJT12RHquPxcE2s^>P~BYebH+vs7g1I;apM6DUZDR3f=9!DG@^SYxL2YFIUb0~ zkVhj9jf8g0wG&}8<#&{LqOiqMUKi^7(s<*+Pr?3>o!@!uUABM9@C}B4K>x$?KRkHz z;SHIWT-!8Cx0dSt3LO{GY3`n9=4GN@hwAH4czxmD2K>iZ_&E{Yr_znmuatRSIHzTF zWYRrXv_jiRn@Zdw$D=3G`3;r*n#WeL=s`$EWV7_+cJDE&P`i9C7-T6{qr&k!CA-$SXfM^^2(fOO*a5Nq>>Vzl!|dc<%2U z^Dky`znDMIXXDvqH5mz`u`(VQ&qM2Z;5>}{r(tkE34c(@_eJt;75|X4A8LAU7Ef;c z5~5L(Oly2|rtCW752P>;982@C_6~h;?8D6|-keZ(N$c0VcrViT)O|1J`S zkhvMujhkK>>OxZ|3In)2OvKGp?q_N{xAK*fvR=f;KK`8a%rSG)YceRbuu%V-!AK^> z$N^?li!3#QAW(H*hMr`*tm81=pMqE{W-u^i&rn_6aTM2*1IWiFlNxkxP?a)ll$W(e z7~C4)cHsNg{l53UZ-To$8uZzytLAmhR=rYnpgcImJ}eJmb|~{hm7VHp-IvISxqim&=KN_cUFOp3Tz#jtpRD=L z!Jm@#Az8nx_D|J*vj~8%uKVU&m)N`{`l(X8T3WY!v70CRnSUBPr?Gw=D%XMd`XszQ zu{Vt2kbfNsuT$wv>1Q0c7S552_I$eI%T`?1(zZ~xNIpmE*;mhwd4lk0JD9<>88#rU zY(yBebKCFqpqIj}819((u#6A$a7Tx`nb%QvO`FBSNEk5?c}Hd-pe38){V5w#i+nmS z=X6EQTbf?47QM{uRQ3Rf{XF9=H0EwO|5gg`mGIVzuWRwPmM*n=sY)KHb%GAzD z|6Foh-Lp~)<`4s@7p790VrHnMuF_I7S4%B`96Ppc*YzAHbQ}c8^sz!y)~eh|LN9Rp z)$*{Uk2H0dP{+}9Kb-AG)6H;(wdx+QnC5}bUKa6S8H@xt6OFkfEwmM{Q=&eW!JTY; zQ;gpf_3x_si>myhDF0C8f6CHt67#??17X$y5T4cXBna^#MCLjN!4v;915^o`^ODVM5FyF-JJ67Qsl3B z`d&nY!5qFL^COkdwsdj1i@7|>^CQ1Ju*=<&+0NOXHu{CpF0Fd$rF@j|X(DHiUXj*f zb_2Xd3u`r~)T~s}LdnRvBP9-HQhwqZkplx+b0y$#(8dfdJR-`2SWCxZBU8lj&)1;? zEK7Bvf-}+-vN>GU>ZDaiosKcQ>y2+c__}kx@4RnY|3{BVM%v|*s#sMOpI1`3f!W5% z_95zGw9WG_FZP(VrrI^@?YiB!-L7jlb=PAC>$WfJKCjnV-sDA{Wp$qCX_{q8iW#iP z+yD{>GtJFp7YT08x&%YY31@CFw%w8I4=i_RyF6boNH+D zNOQ-9c%{YLLit##@0|X|8LvEeSFAVHemCq_=)XJu&G&DCd5GaL(YKAN@7bzNA@z{>0UPSvo8~Xw_W_4mT2sWwJ)K*e(lh;bFVohb+nmsiN#YSoLp|_usf5S;B9%S<tCga%)*Jdn#0bE84S8~M21tXNK z*sk~;Bc7JhiIrcM>W$Uj81tQnKLzVUwl9iv(VZjocD6?bh9qW(K$~k#DWoln+GVhr z+S{?QebLVY{_@0Kp4sEm^7y3SsO`fWDTq`W0S%|WF7-} zcHr4I&%nB18TJ`E8`JA8zqLrGfW$?ipTn>;qDn=*fHrK_Gs&7xTPm)nVM+TrBVNb^sgRUXRU1p)IQq_4kEwdeCxS^4Ud>Yrn<=Via3k{3Ofsg??wX_g=vFCqQ z@M2`sKP%{Ec`ZpD&mWe|kzO3B#brWWMns1pbr{XDgu{erI}_`rm@_isaVRh?6>6Ht zTfx%yDK~x!qq`{j7DfMxqJKouKO^@y&;8=tKU^@f^_i(Ifg&lAE{RYST}B8QK3s6= zoK2@pGG!6QaLC02E*=WePz*=9KLOs<3Mkj*0$&JysfhJ5F`LY)DxVyTX|v{l8LTtH z;0Ap%2(LBKxl)hVI;YY$lsBHxS#oE}m8?|~sANBv!dyyHsYr}EGTH!=*-y6L+W|TM z0n&|`uC=Vy@>)xC4W(LwbmRfsF&zL%1)|`Zm_f=lrXd)GV1mpcGN&n=B^HhBWr*XS zqxz)y-7)ph)Dj>SDpScA!)dQR_v-ytyW5ywcks)`{<;nBy6Ao#KG)f-N*6`J7KNTx z7G^N5qO3+mm6df_*LB<0O@k3^2!efy9U%s=Cjfr#%CvD^M@1C0S{>@H+ zZEp5CULg~Li1#CmArpGb$f0A43C(3_upv1k$@-??I|6hi7>Y(Ds--AboY)A`o)eCo zd|8QSMtNPyR{?zR#;XM1Mf0dQC(Sw7?$&jC-&rTHL1vvRc`YVuCfqFD?HKGw>h49t z5%Bc5x;(G;PxSGH-VRp#8M~qQ%~EPu&`7Y7oyJTmnB}lcoNeUnL+5N;C(F8-*2T16 z4f~22H0+&W_rO_OergAa7X?1D<4lipHEsB;WwZ4%E9tzNp`0i}Ge4nSm&^#ZEJ4;) zSu7?*^V7{W*RcQ!C4@ zEcSx1UoKDd@-$msC-ikhUx)N*v^e3{A^pD${x5_7%i#Z82LC^c!>v9FWo~41baG{3 zZ3<;>WN%_>3NbYxFd%PYY6>wmGdVUn3T19&Z(?c+F*YDDAa7!73Oqb7RC#b^ATL-? zVrpe$bP6w1bz*dRaAhDbNo`?gWeP7&VQpm~FG+1S3NK7$ZfA68ATc)}Fd$M2FIQ<~ zbZ8(mFfa-)NM&hfXmlVlGBpY>LTPk!P-SvMZ*6dIZe?zCAUFyyLvL(va#L_&V`U&O zL}hkqV`WEjVR;HKMrmwxWpW@}ATLI2VRU6gWn*t-WguM&K0XR_baG{3Z3=jt?R{%o zRmalp?>k##yelXm3MvSwC@3gIKu{1=P*7Ab-V!y5*W7lp_kTM*tGcR3Rrj20Y0i1x zFK>U@am8(9tQytTbs5#ycjCnH-eWyIU0p|ybaoy-eCW`@gZuaI+q-Aa?%m&hyKC3Z zojZ2!*zqqq|A!9$^Nt-mcYgEDx8LsGy=U*f{re9cI^5BDDH~~6q)pC>&PCr=(f-rRin@WF%i_51hl-Mf4D z&YjyU%eQVVF5bMcuyFnQ+}!NUweP;0n!0-R%9V+UiOZKST^b)B8ymZL@xsLm7e+@% z&)X9|xlo;p7stlN$Hy;Sx_o(J;>wjPegBKqKf>z3{(bxQ{8Ow3&I}EmEnqc&6e0$L8M09C;1=+PtpKkRDs!o~4RmjhM=)$H~8`CwN|0jb-;tnOAw zt*-~HHVLVK6&cmj3aktz#EO7?`gD7{Lh8|@3aO2afYsV+Wme0}x0V(wsK}^h15(pu zRF|t$8I@Ypxtc@PRaw@>3NA)#qJ-7|OS{UjS_pP^i?F)8x=L7W6bYDHl*Q^PL4{bY z2Li6H-VIj8STO--$*2MWuS`ygQC(E(5in=Zoy8M=eNLFjrWLU|apFX83%d#@f(2MH zRLxio2MS)eI2QgxS0V)&tHt1~Zr>(vRhiXBk${a@MFMVbZxK|RWLE3wtdxKODJI~R z$%z0|IABx`B?Ff-aZJFfv#Y&(_cB)Bd{aTSLrhDIYKPiYfQqpqsCoicef=j-4-5_s z535}TcNL(TonxpLgI(Pg$6mSh&CQ&EjLZu<^#ly(@gs3oYpWFlE2Ju`N(7t&PsKo? zMU9M%48sY(WUR<>v4bBASOv7|>}p@a>Kmk?5>V}`9;*?ttBEUDuYQ-XTGC69ofTu{ z2-t{KA|N~V+*u(3$*3mPQ(cJcD*(kzrOu`&b)8L~&PI!l-MDBOmZ z6e|~BF;;|Dbno^MQoDAsUF|<`fbEK)I?;df)WG1G096PW0^5UUCvSCaZtnVmy#&`O zwBk!}%M$Q~J&KhQaEro)M-(osSJA>fA>dNLYF@&s+^E!|hH4I3*I7%$akQ&1!737v zpsMU@|AB*SR}EMN$Iii(T!L#5g+3N%l?YgmRV1K`tSScDXrY2?dOBb=X^iTeQg3MJ z%+MKk!bd~swUmazuGF`eu-Xk*p+AaM<*h2LIsyfIjvYG@Zoww37TH-bRvd+jV>bk> z!Ac1jomD_8cq@(;lz_ooF##p4N?x6fss^Y8m!lzLg?1G@R!2vL)`0{2Da5Lv3P)X5 zPQcxJ_UvP`>gZs*3K7G}Q>OfRzhG^MJuzf`XMJ;L8^;!wLUWCSaqp@&p_QPlZNB2%S28ick2b>JU~H6FELq zmo-LM@!Pq(yNjZR4)R!4IJysLxN8>!_6=JU8fP-(bV0xf%(fZ^<~tg3VgYUWBEyJEE_QRt)e40Hrc zc7={z2`JIR116xpmmLAwtDgs;lzIW2K70E6`zyeJh8mQzd#}eT(lB79Ohlme5CN@Y zuY#)vtb$`F26DvyfFr9X^0cvDJ=qmHcJ=CyAP>_(z;Q7u_Ecvoe;$GAuYU3ztCL8> zA&*sm@hVgrir4ao3AmqLf*plR@Z1HPVOXG-AbTr`*f;qZ2+pcZK*S0ONPayMkRQyB zfD~4Zs;46IRfm7-U?gzDulv+%olaPdNJM%e08Ab$U4`KUtkATCiHg#mz4Tyaqf*Bn zUN<&iC|`n_ih(E;30SZzM?m)Kl81@8g$k+p>z06Hxlx^p)N?>ZtjM}fO7IZT(yNeY zYur21@Bjr`%0xbU>1edT&Wf>WbnNjZ2oZaVtm+8(!eiwLxXR%IIjew`BOr$gBVbf& zQOC2xaE0H%G!(3c#l2rZtSB>cRB1>7`~hX+UODX2>5YP(i$U<*C%70yw>N0ISNn`YNm{8V(3piWQN!ua1U?EEDB0 zPzRKN6j~X_j_FW#>{{nqvyQzz0#;Gzb|V3qfjI%$s066K_@h?-*&K!qX{c9W2`fj# z4)t1MUFn2R!skf9V)@2lg_j^kq2Ct>=$)080w39`4H7UoD@(xhY*gT>PSB;_OITGr z3Uug6SoIg+tCQE2HUIE5)by#y&@Pf=()1bmvX z$}15|8ZBf5905<&$Lu3)7$`jzVuY2_uz(eZs^ac?`A=Ze>ZBN+naE`1BOgSgI@;CM zBT;B&w&bkx)bWz7M{pF%&%kE|0w%kvBjCNYHBN*s#Vc@*%MeJwVQW-m4-u&D;BM&j z80(5Ot7KH&-9758iYY#=bD?9$XJ8!xUqq~!fLje^ zQ;8O)a{>;6Q7QElsBpUJfN61{RmAGF(y&kLlY>$*t;0%2MTt*9iU}xDXmVB>u>)3^ zirK_xU`9a1>RAH;H4!==OE%Lv0rC1%>UCFcIUd2PhdfE7A-{G8ELMXO_G{Fk$TM6= z$j_63#lyb@ppFs8Pc}sCSdZASQ797d6`f)f>fV4*iAdpkiGTwD)G@id3a5*%@^C25 zGFKsDg+UtKr^nPv)w()~k9_!->Z$0vFp*W!v12L*qfjJZ39Ik3TKtAf?geLs;kqN> zDH}l24|P<{fWL9Vs*At(;{q1BcZ1a#$x+~y3Z|9**iJe6pI}eLfA%SHR+(crQ7ETk z9!JN{&MFbG9xGpq$4Ue^s{#Q}LUKT_t?cmkUeU1EU^PIQnS|9KyuKY=J^qVG-vawX zHY&2Ja%2^pl@^-Uh=7chJ_8*A5v%qH7{m1`Dnk?r2rsy!$`s{@{!sD*_14)HhiYnC zdLialhVZ&efl{M7DdB>1RyGPXk(EAe90BXFY9OFGtI3JW83FqtdS7=_vT&QLj903WdcnP*cKzZ84Xkn~GK#8%FGtqkr zy-HUrtVSeVuS~?;4wA7HfH0Cz{;&p zPf;CkJSU)Z0Ud?6n>l1%?6JC>2hOpAjQwfI8J++#`oqt2#b1mn5)dOREOO<~KCTloW1XPP=I z!K(NSeC|9|16G)@vXzKgj24On?2+V&1uDJN>ajAu{cLQl8RFtT);LOu)|5ij>@)|r zOhA6xIA>LQ23FAm67UB)h!r~a=2|@E7Gkt;-V(4EJXPtvcIc3$VY6L9gUy+|b|wjY zM9cuiMx_MQmSgOSxm|h&Is&%Bs;L%FP;s;{>IjInJWclE0U8#uGIph{fK+Jp#p`0d zqc7(0Puo{OO0aX`MxxLaDBNt;5fHF?nO}l=E#5tCCM90C1UwG)^iEC3S*#2VyBe{& zAa%yGw$ld5SgJW(ph zA^|lKhq*Y)SVkH;yV5(0-3#ZhE4JoyNIq#vw&)P>yY?O!eza43!;F%JVQq0@h=tQK&Bk=6RS9S)sE!E+J@V*{D)A zss^iQS4f=ksypJMolkLa4S|it{=gyWw^6T-!x1i8fIQ4rk$@$vzR#mjtVGObc^HVS zPGSg}*U+(ew?7r6I<0S4tVX~ds)KV+NXD}@-SXUb%IssK$_c2^0_0(yIs*O(C%3CD zaO_x#z^9FS1`ZGbx%*CUK-mcB{yJ)>-pJh!J=kYZ&wa0?Z4tNF@_7t zC~%d>pm=Hw$DncoinChRa=Z)IE2v)c`SEoDD{~2Q-PGn`T+%pTHRuTFS~_d6I;5Qj zgjFwOxR<{ zt|L?jZ8QoUj^(Y0RX0`bkbwK3eFa;6*seNKQMgy@cQP(IO8JvZlXMg=A!9NyJ~-d1 zK=A++&1|YsB?3Yo<`GmPA^{1W*G0P$thVqHtZ7J_L}$fOXmKRjwfb1B4rK-OJ{vGZ z$9{#*WHqtk$aoPAOhMD(Rvp+3o{GJ?ya6KtT^>eq3rxTt1SN+RL-kBwf^rEK8q#bO z8l9D51Opy>^P#eu=NNgx4#9=pbBzG!%Dfsv0l9%7{7N zHBM(NJN!AbPmQXcfSV94R0O2!?{$M+X>f&?pzDWWXQfz$h}}k^>1iWSwS!eR23K+k zj;dRpt|pRCM<0DYA0Mu3TRP5E2 zfSBClL}-zKt+3jLfME^t#<3VNm9QGshBS+niP-D0GA*yzohao_CSWyzHCM@E%phXu z?Q70eBHt7PH6vafhrV4UA}8QmIf7P&6$kAah;G`Kpmb%=7OTtyZCrvbV8|~)_UkC{ zqIo&SYIb&ZhK}-aicSf!XinkZGW#l|s%Oo-5OAfK+{+2r3ac$i9s7X6U4nVq3R5u$ z+Q3S>6T9IhIH&?InnDRbbGTNn3tVbl?7ptn9|nq`s=T_Yd8o5;4QYZ^B48U>J%U&B z?JO0O`u8}=UK23XVdb3_U4p&pth6_SoYe$-=K1+~hKr9{m!2tm2&L~3C?Q}R&MhYQ z;0=W{EUn zPmvW8kRK*DZroU?Br^C!K3+@5*qB<>H884$YS^tJpc~GGO2l({FE?ZLN*{v~h;C>) zwB{ukyZto~?QILIeRZ=8N^Ky_C540HsfhsoSh^>DbU)|KuUFpI-1lk z6QfSMws)BUH*GtbJ8bTv69$XdFVLjcd^0uEAXrym1fi?%KEox8T8P+}#5K zg1Zyk-EH{3hnbiEVWw)j>Q?nb-|p&j?%wC@wbxpw3odIz#rZ4ict}}YLSSe4`BF!X zZWa>WW&G;=O@_FXI*cm^*87U|{89G}0Hx3LtB0FOCD#kGZgk^7t)<J_~p^SkFZ>rhLZL`vZv|BnZ3rHoKCMct2RdQ698HIfRk_jvo_yfc+2 zC*rf(jT1reNE#aYrf+#Wp9`5m2`cQ915sp@@aA#fVW_An!Vgk$Givjo1KYbX6*HBK3d}nt)SQPGuS0)iP)mpYwpi8OYH2-~aF``f&7nk1E!xg?f% z#?hOD+oz8W^f_)Cn=0(uM^2jRhAgNs8XPqfwgQf-Hn$U)$ke$fjjeh->d^MM^-Cv``crm3c!EOAkL=pbhW8!Yj2( zhy^v;(3Xc`Qn*n_Bn$!0Ndw7`a8M36k|sXQ)OY*p(3lvska7tr6GL1E@ouhPX|~65 zv~X9VShns-Fx2ayIt!^ah5Fnv6t7nu;~k{5GH$m^HZEz)2I_#TTtcL!W`it#c4kWB z$f;TiLwP955-LkB&+S-Dgboe!-D*RDeLlfNf@8Drcs3)} z-C^H3N$GXvqN4HPv6ht=UpP31n$!Pvu%C?NQl zA_M@ifZ$;*|5fTL04oXb(*?_7pHfIlgzj@Zo5?@Dy*9YA!}{LH@jEL+IYIR`=bv1x zEgFj5+t65X{(9BjmPm*_*auery%?XK2ungI{Z;$VE_&hVerX`(8M#SEBL{kv=)#n*m<&gGVOrQ%TEQgcVa+8rA$i zU(-(s%7Ivb#%?PCfm31Hz832T3l&%x4nY`UrBV?PvSu`{T4=nz2+!^QEoR)$7zMRy zEGPC~ zHF7zDeThc;U1-gUBxPX0FgmfzWC@mRN`+f!__UqQzr+BSL=%|R-!w~O1Kvx9QhFGe z`I?ZAu8GhbmX(OHRxqk21zMsdh1`$LC0}xdc|E2^T;UU>aQYA#5r<>=wqa=(Htiu- zrTBoQJ_2SZ&jWv!AHL%f?byqG!;=$a(TZ~ev}MKG^^{bx0l6ySaE!*u^~Fg6>2+l> z@95=7fSgF8>tMeWl#~wbYHKa~ZqB3l>!n(2AjA9t ziLBAAY*Nl4y-9L=>#$dDU9X(PNyP5P8Ad??zw~a zD)T&W>Sqs@?+u?jb@V}Sqk$e$DH(GpIL7FmLgNB5=Lb+$M>r3&Zy>nK8o+r4}hFmsIeC zjSvvN=9lL@U*L-JEt9q)we9cZNB+a>In3&@N@B2FH!9T#iu^HJC!@+B1~Qem81(!98^$m#M3~rV7yV87XQ8@{+;<&tBS%ea1MoR z<;8!jxh5wTL8O5iKgRW{C7C31QI48^e^-t&yUkQGiU@%JC59$t^XC-{(CK$|donJp zVQ7RsgUV7gBOz|CaW|~FIs)-;pfg+dxm26BP}5x|OgUXlP%?UgI~Fw3sa@_tLB_8} zv9O$`2`yR{>AS7&b$-hhajAk!YA%)JqF=E(bhDBnImapcd*_1&qfTAKj6N;V?S8g~ ztXriAu_i%thF;@PBtX9n%QzQ`I}Fcv9p2_#NlIR@P#e0Zgq2R0_YXx9LUPz())9jJ zUil1fMpzX3n?8agLQjkbxI?>K9*B!bTR)qvN4LM$qlL!MCtkl10+xznsvL}PBI7}# zH<`%ysv?J}25VjZZ>WKw4Xeb^yQSYKsKo98Uh;pw{%yOd!v0r!ImmuE>W>W5#)&?i z;~LybSN~h9gQCRm;e7KY45e~^iv&#>!lpPmL*k*27a4u{YbHO=w|SC=r;H!K5A83B z6(OY&gw+vB2fa6yLS~kSp+U;N&-fEwNR|voO4eDs~W8X{7 z*jz#;A=oasa*cn`wT`#*&8xlfX!Y}p*ig@6QOt72DqTCA8E&c4UGfv;Rd z$yR;0qE>o!xsm`BaA-i`JGpO<&iy!OmIY2dWVR|t*#Gf*ax!kYgoE#2Ooorsp+jFK zlTF&ZELlSdamnOpi7rBsjL5(+CdL&j^or#Y=fwC1Rx)pULD=W{`k-muj~Xfjg9c(a zTO-4%rdK;BDjCErw6mJ3Dq$v4&jR=hf~C1?oyLaUOq)94)+0^c)QmtqPRvnPTH_hj z?8he1YSnTX!J5+jBAQyzY^zsoGiQNJ_s4R|PwY9_fhuUx@4sktBbPrBK1=5R+{5`D zaa{Cs3sl2R&k2ktmzAM zyD@kDh~_V=u_<4i(p}+hO6!Q!cgb_Js_Pcn<70Lp>_k_pk@`>I zd#=KQRzDt9`6ISHzTB;IelqHXCg?Yw8wC}MQyw@BkHVu+2b@I!4%FG6GOv> z7qCP(BjC1hSzSiRn-(M5_I`WUD^)e;uotaSA39cSJ~8o}2-_uNP1V3anBB0T`DG!8 zU7<1>7#@&auUs;WNeRy2mwE>bCMunv^wn#eMy_{uxBJe=KY!(aEWkv;TMu_tZT^ID zS6nYH5=c*LNcOqpmrTZDxH1G}R*41ne|x#>dV8U5y}P@n_vtg7U7oe|e|h*ws_{sy z^e~XBgLA4Paa*dv!URiSm2o)EZ5)2CL17q>AhB2}r`eH+Q4TC`(~Rx;m|YO!+gW%@ z0gIPor!PNq)HuH$kE=P0g)z&rI%P{%H_Juy*6ps^(2w{KaGVqD@ zYMwuPZ)wK+a=~$avfMKJ;*iaSO;{t>DY&5S2jVt#WobxZlHcT=6$h0ZJW}c3##wgW zkKUw`ndW@IeXitLyJr1Vwo!d(VOBXaFmI#bPjt5?1P;M@)IFkFbGUGY=BX*R-pA%E z&x)8X>~YuLq~4P2%4z-`Gi9ik)1-cHPe1l=mIxu|1QI5H6J0A}i_th69HsT%HygG*Y@N5DQ?h}ob%Kq1flrOtBA?il%1tO*?OuMKO$E`I%dL8VV zzHn{-%FpF%wEOQls*Eg4S3yrJc5^n~W&)bjwxxd&mfkDf9Ph9S`r)iSxhT+ zA;u4{rkD6~@CO-udDlW^Cq}u1h`CxzF<~%T)69ZK zhtDu-G}TR(#w88UD|+Y`L3~hcsK}+4WCCkw0I}NFiKwDHfAMMe`{5(HhN3n(@ZVMQ zg}vxu=IG|pBhn&K{Py}&BYBrA{dddfwz~k_C3Oa9!ghn(&JNs+k`ZSEOXDf$(fJmI zSq6>&UGf4gjD-&@aCn-=Hgrn9+LH_6qg=b+%Z+Bm=9lokNF?3}G_|q-G$~g`gAF@n z`e@nRGa)>m-kbR+6|Tk?-92wSaO!+ zldy8#eyT}`HT7R22YyV4k2->g9KVM5=7A}(Kj|f_)=UM}?bKTFm67*v??(xZ%4>Or z|86)m-72nVE{CgoZG8YY-C*hF%7$sB8#u!e2Od>%twZDuVga@PV% zG=yh^XA$<6wKV?mMYKNCaeizvik*F*;Y>Zpp=!*#h!xzt2zWfEZB>fGnDh1@$E?F! zGf?<1C7P~ct1yeH2L9WnV&4Vo(70dAD*~0;5HfH2-1Ll5gFa>9SkcY&yiwsV zsf6GQN}Cp5(6LsmHg=H8w01WZc&Kx0Ox5w3PmO%TR8O%_o(vZY%m9`XJX!al;M{JB zaC@Fjf%;*5zM&2mb7iy^b9K+!NLWR{U!=uV!`N_5a6DZ22~mtG9a7C=!g8Ru(@TeU z9sI75zrKUVa3obx)oX=G$-raFNe?H{Q>c5PpgerL0%~;DhC1C!K5n)ye}eIpL}0jP zp@M>4a)v^6LnM=5!J2~RldEA|nwuX>4^IyP;eKtHqzg?3e@g|S4uE`OpR!`YBF&df z>USiqVpDw|JX?)#^5j-nHt&Tz%z=>%lW^}t`?b5za^GCvjwsp>Lf zqhB*0gxfYJuM8K9@cVtpysufCa*W-zxEFSNQWiYhV6)a((q?_T`A-FMTQh}8^>odV zZAEwLBh53&i*aNzz??z?vo|9@oX)m9ia_vtDIqb$4p- z?q5#(Z0wE(&XOKZA0HAz6Phg<8=RfRGksbpkjmrW(sbmdKguVqHAeQT_%QEZraETe zs2X3#p!LE!{#Zh8f(4=_gquZ=Jmk{E=~IU(oHI?G$N!A)`>1>%y6BFe$Is~W_5EQd zm2cC?yl)@+^Nu(Esh9D+gWp?@@>K4oUrg3X+{~YFcBAxZRR1nq%|bZK%s*F843qq}u}4vJd`c7H$~hWmK+`e+w1exJGzJ|tmC*~D7*<53 z4v7;zaUzK}9nluohB{Ho?Kd!V5g624TsQ(UJS+{#KA0kT{5=&`X;b++qR!5QR!>Sp z12*=m6ne)d2~i9LCXvI%92;;eqn22*%K-EN(&6XfrS%-dEs+qPg?$3B9TYYeXvH ztzN?Y6^h9~c|%e_xH@yCpT=6~U0{UGySLu8q~_)=;*22C0No6e7B1ive4AXo^p1ol z2K~W$w+hWGu9Z^nAO4x*#bo+P_E2!FIS_avg)-k0XhL!UyN-htr=QZVwv!t=$ZMGMZcn z0KrtDU8u406%2jD*JZPY$&Hcw1nBH6>B3$TQC3_)U+1ACrX4&rjP>vfpVj zb`oNQYmr4e$!4F^*2&Fp&OU*08u6-Y%Ntb4hgn4R0t-+}(Uq$0kef{gyZ$-44Xj1x z{LPZW7B~%`uitCAT^Kwgd_P1NwZLWa$MK^q1G*BiPQ?+K$R>Z;{vRMs;Hr#U^t*tZUvI^QZ6?NQtV~Ivz0=BG<7+^ zt#O3#9$_bbvVrt^L2c{++?rnb>SejhR+Lge;S42Na!M=U=_AanDId+HD6CFsa};uk z+blPj4s4Usd*t`$7iRhPf-`{ISbbsa58QV}SIh;C0@7;xF-(ja0Ia+Zqh750hw^oY zl}j>{*}s4%E15bVw18$KAO?9hwJS^4Kt@oieIPfQ7^f7or@@^Z8|{l zqN#-;p*k{k1J9_iTs}&36SkOuA$A$k^ly8X6a{~xhO8-}eaWlhxD5p_r|oiSuy}Jr zuQYYz4Ffz`nRc!%vnB}b}v!?w3BBJ9mp|JM2!4qb)5_$H8 zkK$ChzR17d=R^ujDIx-Gk@w_$(exYS7$f!$F;hT}b6wA2c3Z zf5i$Kh9tDNQtA`(6<|Okt-|MKuPH`-bzi30 zoj6+SwJ{pIy{4}~Yr-^0rw z=HDb&eCb=~q+d$-2sF~-tWqPOoW|%MN2xvQzR@Qh*6(iLsp>$Zf2t%E$xEa0_Q_G3 zuI+zhxi!#&7V)j?kKVY-g4C;*PA*TPlarM0*kSlUu!_4>f65`+aw6Az)JY$81K!(g zNJ++Ara!dtU<);UFFD#ftA2P#I;V7MmUuD29bFnLE$r2fb9 zEAc>wjP{i=C=F=Q78F`Olha6K*KLf$Z|rJV`8%af%PeOky(w_km3)KCMU_B~v@&0h zO_T9RLK%X*%GMuLKEa6tvMwFa@9dZo+eS*0zdS^0_bP+hnZ}-mOGBLie&$S8wFzn& z&5VfC_mXYK4M$`^^r9FpP!~CDYSjGdcYgepDtQ4DcCWWVZ-oijxdD~cZG#J!`c7DJ( zTxM7{+;DmU+G?5X)H_!-xAq6zU*(-2RP^OFRR#es;fZJ|6Gy9W2Q4bB+Yp2}ctX3TT4B+~P zh*{o)QW$x-)To*qSBF-KyvQ|2I&4N=e`0`K^3Y+7L%&2*8o!{vkXoVF&`Xbu9Q3o* zMN5hB7iGA*Lql&FMl3sc0_LB=L;{ImEa#}1!_)x z*x`w4QT$s0g6FPJL1s3}(O6u*25SAidy-HmS%Rr0W)~w_39A)>J3}LDvh`5b`$niixtO-Dr_=HyKV!i8#ZQY7Rq>ArNO)&_y2+d=1|JXv^v0p zeKl?9lq&m-guh>JeXI^X5R>>EjcOZz|LPODVD!wr7BJKaf~YT6MkW*|lB17IMMY1Q z5KBUXXQlDp|A{9LJB>_*w{TyZLDaNEc=9)-UF(1F<#c}pENgn1|Lx#vt|rMlWdBma zDN$on1o>k-mu+9(4Z8WVU~k3Nf}AOgjo}dZ=L`?%(AJR|7IE8e z^#!CE8x5ZR8UesJl&6_|8T&4W-aTrl3hyJ0=`%gNW#*@P&djky4qmffNCLR6cL4P4V`Zg!=uM6s| zhT|sHP3e4cNUBJwR>DZDdYQbz4z#l8{v_2nnW2Ap!NhpIq=dz+SnQa`IbW}45Ub~e z?0b5U)LB_lZE!rq8=oFcIRz$ID5H_`;!AEPoH}CY&nsLTYknT01!~|(Nt-6tyGtru zdlC$nn7PcD195}ElMXT?ZS!A^Jj24_ZxNvbVMbXS0VqScr%Fw(U^_n4$h^O@cAKa* zm&5kt9pT3&g~LWuhQv+|vxcT{O$L&aPdFV_e@;D$D5QWUj(E=b6doRw!ck)UtQoAbn}6joqcI}sw`{IpPv8w#fPZ~%X6I-1LS~k)GluBpB?YUJk~V42(NFq>78u{K z>T+rNx@b@!iP1O~XNKM{C=>FBd@8P6g70hjw-7URT*!zq8?Rz>Y*Wop?5nMvht&X8 zS8}hODpv^G;J@NCRE<(^M^O$&`~{5;{p=({n37Z#SsUC+B=#iM1uQr9*jRCCI-Xe(qSPw5s+(FAveTlAvd1u)O1%swOWptKmn0 zbIH#&2uuF4aMj@Qjg~vLPUv%313P}r_ywIYDMJ%w05-6MOIunT=R=LPQQ{W?3)O-h zMpy)fEBt4%_b$Z#0xh4~o=hO6A`Y35Bua_TqeW{X!WTtfs+*;i%5(YxP>1jkVG%ze zbMuUWGW^J)rF5>0{boOMToImZ{emqQvRJAl)Mi3IZk?r!#f-nEI0WGH?K(o2DCb9k z{?BF5DT4Z)on`Z8kP6d^xoU^s4|5ih6nDtBNhR>45 zhVRu0y3)9g``C9cn6JQZ<18~Q1Jz#+pJkad6~rSvM2O^)7C+`1zAL!e`3DRiLd$2i zpacs|B3j-``XB^7TVnYWF+C4F-V@dHxVBaaPdFCcL;&?ensYQPn?Dy(lXj+rezSV| z-fE3Q_sdhoTm!$!1VAvtGhm(@T_b(LLq#5?U7p(xC``B{gzGG}ZI97RzPl2FnI7Ij zB1T&b`KJ=#=Pg2Xq5#p;f)1PZWSDQ@lnwJ(b5SaN&_I8%R}}A|*9&Q;(XkvN)z6t? zXyEMcS_sI%H7;DTxY2z00?E3GI&L#{o4}dDTbywQ7_%1?KUz9!B)h`wactK0{*MYdEYnCj1A!Na38RhxN@9_k4WsWY@?~+)rXLP;KbC98YI* zq!j<9tLzp5xT*dej?c)j?~c6tOot{M?s{MZ1*Gwz<&5lVX>=CH{({f^$*?O@`|M9e zeyG3u@-}cPZS%`@$0IdN`JxF6X2kdaWu6F=R(jg1e|S2M9v9wd`N+-8{L69x_Y5xh zPvuhg@U@nyXId>nb9uBp-ak>>gGoX7DpTnXMmMj%2)G6zv#Q0Rp$mr_fO`U^4=Eue zd(s{`b#r~J~2zKrsza>~Mu-b~4IH}YHQRhd@&8LzFN z{AJXRvM&39h4VRZ!;ASW>uYg&1m`FZn-Mke+hQd%B&{rbh$)FiZWu1O?Y_PK;-g^} zp2R&m$r#~beepMUI9~L1Aeuq?PTfy@K3=|GnW1XYL zWPz}&iJ}jcwAJIhxY8ruqST)>UkrAQ=9~Tp)!%;#%cik^c{u-n#(tzaL=xk3#WXWcYuh5IpXfPax7tv3+_o zYhpItf3J$5Gg@R-IsLC*P_m7x!dqN*h~vJ)-vY? zS2m_P>zU9#pYWhoqdz>C8u_Bz*p+m$mw(l;-@dkNfI2sl^{_MM(^=ECx=^KY+Qjg3 zGxh9M+M(MbTnVj89lK-L8Yz51^QjH*8m;o@eS7%xdV&5lNPG1pJbLE8^mc=O@|5%2 zKTsHYx4-_{_p<(G^twlM`t}=7*k?J1`;}&0INd;q@9n7WW~=TA_Km@x&)`DX{bcIx zI{78!Rd%JS>An~x+YU1SbK_vmyYq?+wP(xLqZt()-d`h&9pL1oY_CFsyB6=-hxS7=TGf*4jX%BW_|V6WgfpxHF2Hf<)4i#<$WiW`<-V& z5_#B}dxpC7I_A^NMp{`BX1(QL#QuAeV}k6pmh_dKObBLcb3C(;tb669&*Q%D%kvh= zlki&L*~)9*0_rPOW6mY^JIT4_1L4?gVT$utM!W0Tn9gRd6!)d}T$a6t4B9g4J zJ+t$b2!o#&CJa7yAKtW(b3kvhmtCJv@fM$$y{i)Lk{|RNd)}X`4r6}?9pT}*Chsdm z)fY0vx51t_$Md%;;2NL7S?2umx`2nRPY8r(%>6mlzYp+g;5K21$n;p;>XcKt(4(`N zI|6(R)8WMzTC0N;-T}d3+lE{eh&wKqYduLM3P;<9O6G_Vq2XyV=``OqZ_?6d(qBUgP_wVKk#Bk^VGFRTrR&+K81_T_#)~$$Uk<2WJ>hbcL zAP)BS;If+AIyo#fO0@)xHJit%S(juuuqtP%xf^rg>tL`FYwO#HiU>P~1o$0`2_mI+ zw+=;_2m@EC@(czXGd(anG1@NZ2&12SsEA{qEwFxL3x6qXazHdZ_+hqdXcyBx6^_iL zuXCY|*t3Rz91}bdTOEL&^$e#dJtVqYvkA+4Uvht(`}9kc&`vyXGBM|Z z=#@JVx1zZAN~N|dDK6kPHUA|VuD!_sWo~_E!~E#T`~_a$hr9FH)c@%yhxdL*5th*J z&7ObA|Ah9$U_|upV9vMWA`W73`n)H0e(BDKU&Zi8g^-cKk|w71kS;NF>(D}lD0=%s zlOQH(QiNdeMpiRNBF1teGxVl(J(~h!6>Qemf4dSCaS}48RVL`Bv`sEn-DGz?cXKLr zV7tv6mfKi$@TBdoad;-zp{KkInqBSaY%@nZ+sO56o&;i?YYXTSgfYBqs$^dO+pH52 z_QAs6-lDzwKxQ;Yb|!L|q3R?NKMH`U~S_)~Gz{AGWmjaXOr(E3~VYz24M@o2r3FL&WAue>jl2qLo701uN`d43j`@eq&ITzZ%XCrtfWhh8rjG zv3LkdjIR2NGB*tp@L(WzF?eN0T_YrGEkpu~!`ddPEK&G3nC@k(o7^D=hcQB9)ZBkN?SLTA}7Quv51rHF)L5ooG zE0~leE`lc9=`7X;>N1PYWA)K3Xzk*70G;Gt#MpT$c5e^fb1euEA6mt`D0*IqfR>e7 z_9E`sDSM0l=T#1ma_o3wkb_hVHY$kSz6=6;W56lZ1dB()V*(hkCr-s=I+}Wl5nt zhkabc$HKZb5DmtSLce=d5s_SHz~OPOn+JsdP)M-@`_rqM8wPC+--VU~&iOyO4G^lw z2Nm)(OCa`=prpTuN;NsJKl%1wyZvu-GS6}rF^5Ze5WDEzd8fOM4n-Ft-2h}mpnUrSS^Gp;80Kdvf6}q zHhh~uOZ`--rw=)Ds%MlgcS=xC@HFL3olgIf@fq?*3s`g`ORt#l$eB`{$KI#5&%@rt z=T4ZuI2sKu;@Y)xUbAO>%#tkb*zfI`Yn|3|Z#{A|pWUxKI%$|P80mu}M>*`~i4K&- zDyWZiR2jl=rL-$hVsZR6g9dYAXCu?8SW&o+J5p*!wQMpi)w)&+U-lj z{)FeC39XkEBFm`iDlB^BQxIMxYA5?T=uXQ`-*m6#o%sI@pyxyms*;2>^SsqrJkNI^ z8|G|ur9+r6_Zf(vU5?YcoH3raa#E%YF80`9D9As7fUlX5)JI|G2@^zLH`Z5LU<$b* ze>ob>l%Y=wgf2gVJyNDy_5&i3YAVU~f@pa%K}^e9ruDHQIe&Y;g~w7$QVL43rV)y|1uBMeIt& z2%1oWK-SM(&l4fz#~U1H-}OCcuX+X2&E3v#)?LrB1=6H9yUsQ|;Xwev1&_oe2%xV? zwUI2^Y51mT(6diM!Xb$ed|RFLSWWrB0RAd?&V?sA!Z^R?nK8xj>y zza`Q#_~X?Ak$1xYRBE4~Aup`aubNi0mEFv#zvnHzpnxnANh5c0z-^;D)y69V@YY?! z0i#=VV!cNI={}v8^+!&_i@{Q$(w{2#>pTD5W2ejY#|5!*;xEX}tvCQcWp2~saSBQM zbZO9ea1NrD=`1^GRBJHCnu z3L#U{%y`&J!~tz$f{}liH>*boj_Ei1kE4~yWgf-cm8bNY>SXT+F5#ba!i5bTo-qZrgqgAcR8L5L+$<3 z4Bp5%6vhA1BEEqn;9vSdYE&DvTSxHDrdW7MkScr`mIm|SjfM*`V73#++XAlZqz-*P zI?pXBU=4m*teWBRr%E*wqFA>lwZ2-uC09oBmMm9#%CsZ(PP{{$OkX{>T!Hc@bQ5IC zO}dg8-|hEVBS$<+pVj592${|NSrIa+xnE)0RddXxu{xK(s@=GBW#&C?Q$=)Q`>R7` ziKwtHetFr-TgOrrCnZ9!w2k2tN`yF!3)$&o+tJ#o+^U{i-Wtr`t00CFneOq9mz)m4 zK{8r$V_=W;F%qWFCm2OOy0O>Y@jBu!v4MjqWfd&Qga}pje4#zomAOd)kF_FzAQO15 zI(96K+#nTHY8r5yWwvg1)tuOfRWRu1r7 z@xJ$OpPp0(^Rl89m(vz*RcU1^K1}8L#QJD^$FkjN!PuK5q+fyM z%)Q7pHIa>o6?1oOyn~c7S?!jQ@6J3&Wl42jO&Gi^CCR4F^*&c)7iv;7E$(Wn17j?e{7Yu`rKCXg7)XR**%l+H~-J`N#4+6T6-g~Ka6eOn0&Ak|P>3YU^f(!{{H z*n8rJ+qR7+@z%%kfL&LdklZA9nm|S3p@PYB*uFOrAXuL4|0b1&mW4lhEW^r!&xCbY zp&(&YJGJH9co<=V8?W9umD;{f6+2cs00acyA>7Sat3U z|56Caseca>^Oqe6MB{#blB_DGnCQyEHZcGmy~70!=B)iI^->)~M_FRAhmRQgn}b(V zzSu#DFnUcOtrmhQu>UgE^QapFxsk*J&h4G-Cgh)+BmOM6vR1XNWJL!H2xKPTwk|B< zF0)=J9Sf~Mbi0{$49)KdfNnoPYDfzL<+*PwJ%2A&o*x`ZS|5GNa>YadfKK-b%@vOA zjW85BU~Ktgfm>PbSUn8Ps$&$f!q2(t9U4Z%m5bkkNchoh;9#kx_k}B;gn`bi+lL5( zODJi^oNNEfQ%r<&e8|;g9sTqDb0F_m|L+f!ebTq0B9X!Z?s0^lS)WJcEU-9D9I+lT zxy)z(F1m^5|6OZX_u$R?`qn@q%p-nYK>pf}H{czYMVl^P$|zU*LZ2?yx0eBfXt2=p z1?2}2+^*5HzD@p0)Hy>YeDp(uTjgM+@a}|V>!8;wBm$4y#iK3n!@tmf|I$MJ9dRO6 zytK!1)u-&H-~89P3#Em+_EJIDCvsxHY)4~WV`xOLo|132#ykQ8njW!Vq0L-5_7_zq zlj7`mYpOlIbglQ(yYXTZl!)@Djr$eyueJE2@_O!C2!|p8nG%!!3{qTfE)ZJV3 zn5Fe+S8JR5wf`VOuOGN+bhkewx2uy1occ1L?(bKq0$*qwow8~%0;mwj3`!K}zR>uG zqP>fvjd_PTr&)^`)R!TcGMe`t9ps$5V3~!>{;N^&G@DrBnNN8fb)CM1Ogl56Bsb&i zsI#1mp@gK5cU<-h%caq$)vrodRJ~2pB!>8zya(jy{jBfSsWO6aWHZ>s1XY}J;+gW4 zORNHdd{|hAi;G*JuPj~@&tchb1rJY+R}-$cBu9BiCjuUuU)aY<_6kk?Ef-n7UKQF2 zehzgwFaHjiH~IV$sINWem((zyaGU&Dz#>nPy7SkY9#Fqq^a!3%-*dfcp+|m`JOEPf zN-;+ArHk$hTIl;KXP?VH5wXE2sdXiq)i8DVM(mx2ne^L=c?Jgw#kl% zar{bxxW4GVyKyLnRPql8z^vKLfp`Ej`6r8w!6FfG{G=&5n820bfzXdSkUk^ZZA1c0 z2ykJTyqSvq>GmR;0~h`DZD9vx7#aWQeFbs`5KG%=w%zi0~64%e#YHCW|Ky zq2ebLWocoF&9ITjE0xDTua1X_dq1cAGYQV@JG=i=?cJ~SR)~+qh{M0G? zRbhK_Mq*=2v7u+}4NGnqCSKhKNPs-K1Kk>P`jNdpMq}^s2_uK&$^r8Idqvf|0i7Y_ z8yISqAP5E(A_X}gZ$-m)kR&S`!rVMpvh&k3^bHlX@M9D{{R*}H5C zX-oHgrusP{3zaetco_Z32=z>xCMMdjUsv||mw9XLy7?}^pkKw5bss7(jQ*c#?-4htiH zd$?^#t()BE3a@I^ToSCsHB4WhlCFk`&3n&=IGD!?j1Qe!s6x}T+@AT}$l17E^Z6^M zXPMk|Hv7?VUF?@5dabr>SHh^+TASS1-k#rbl`K{_rVX75gh$#Ys@9cqe_cx(=o=dc z=5{+9+U%<)#d<2j#oW#jI_m2R6>K0c>gHDj*#G$SaMX&r-WYjNrL(Dda=e$L)yb#BRtpXa znP}}iJ>gFtBfh~JqC7qNL3<^XMfEhk?u$)G!0#Ag@a; z($jOqBW$1|2vFy zHilAu=|n=2!$g9agHl-NFw`LDX2X#3sP{b!f>SE^og7w6Sho2&b>(jU3OiOe;PS}; z8=HF@eS3vjC7aL&w z;iEX7^3YXo);V+1Twb`?JP8TB0*QTwIhkN0H=8&OmXCvjQIS}82q|N|OP(ZZHX8gg zPf#YaWA3zoONZXFXFrRq__Ye2NT2Vtk0F}DPg2VvppX%LzgCm}cjiJaixU4rP|R(i znMj{Kl%l!V9ajmDX(8;BfaZM`+yp6#G5S zj6C!_*VCm2xVTe&FGhRYs@#8%WW6+eK;(m~8ucMTL9B{-$*N&V+csSE42GDRyPq2J z4T)pCm-gc%&{_zWo6}EY|2* zRd}>7B!Ey-TZsp&HIcXAfVk5Wxu6sAtA0ERa{j|oPavcJ_fSI{Nq|q5-^lKa_~%(z z$8SSD7Qca!&KKT@1d0|&WFet5@>=4&beukR8CATSdVNK7Y6|p)wKwOxxnn@9V?zU8 z&3e)g`R8LRt4oNzo^bF_7sGz-jbzNnVMKceQ=YAjSEX@y1r`P4scY7q^RXdNhiGXwFGN-; zJL9sy0E76*HMaLrLA};b@QD7(&38=&_p9lol9Dvu&10Fq0sRdZKv@OcKvPJus>;bd zQN6GN(m8sXyX|aYu6GOBy#>~D&wpU5Z)ph%*xv9a|HXR%KfS8!)=2xrEHt5`hlLuv z0n#pMZ9f(7-a+#y&*fMOB20UwxkFf&&@`bU=PQ{+P19@)ov5|~T91h|B1S@B;t<3? zLeSKdt`$G=t1E$!_luWU=;>BP_Z|JnL_s(gh%Lq=a{Giq%#>KmpdM)onM2R?M1?G> zD^0<$HCHxQF$$7s?5T*v=(_22%)mmS4@Ccqqq7cc@_pO*cQ6<^M(5~mq?^&8bV6R1;efN9+*?&6@_B`D8eO~AJxvpELcN}!5ICYJ4 z|KdOJ8`fzE!zVcdx;86q9o{0Hqgq?Jrr5Lyk7p_>g`3|ln!b=a;l*^+3iZNXo54Y6 z!FzeXS*Z%Q^M3DiBCA=6Tayi~dQe6@@-nv{eFECP-$J7lsS>uT{{=*smwjjC+b1Nv zy;iX4Pe7_=F?5LL63P*+Ie~xysQ3J~9pVc(fgsS+o4?t}iGpo`(X|2~=qsi)a1uzG zUqsQ#mTrS1j`J*`GEXA${fb=fvmQ_PiKt||EHM}&NA!vdtm)O`*^#!))-J_$kg z-E`G*0`RF4pdC0T;{wtxtUE6Im z_*0CXI5!K|2@fM!WN(vY9Wm8{Y$+7_o>N#vnuL|$jGr_-l5g6b1XR5e`E>r5GQXz4 zi-dp<=Eh5$gWBW^`2IUKZ<}|t_avB_vrT=E=i;Iw`!6xIMpcIF2WDcd7iE)}Q?OTo zti~~zk_C?&IKIa!8wJ5U^N|POn~b;IKEAufaMzgKrdKDYl{&*#l$B~z#gMQN%3y;F zE=bLBeEE3`1DJ2Bl%Y69xKdq<o6E}_^p|SulX8Fr=&-evvYPUA$b?;=Ga%jq zL9%$T-)DTKUsbx%(x&?BG{06PFM`$^R7Uan&t~QPp@({p?*DBu=h4PHX=op19vE~! z%pzM;w$aXFFP3?hUSodtfHd7qFKtDj+nYAVu9kz(u|FJYPK4cxX36OkygiB4c*2qK zXVAjOvGb;%elEFbhVE`>0O@^siv3j|8hjE-G-OYYaGLP`;PY5OnAO!M@kdevyefnn zlQxgyz>WC&^z#y*JO0}@?`?CIs?Eg49^_zUk!w#;zs(=9gdcZEdaszYCwy(!P5y-d zI}DgkE8R4elqi!=+NZ$HcfE~m-xo-H51aB%v~R#k@cvbIysEQRop5D$YY!eE-v?9g z`p=4d?e%qv-|mu}rOMRENfCyhXQz#|x0abd3zJN<)1Y-7qWsZipT3MNmVX*Q>?_p~ ziw$ekvdO%1wxgJ;iuHG2D;v+e=-?S2R`6$;G4>ln-PM)z^Yziur5+uT4T*XfLBu3| z^Sou6kGF2xw6->@u}PoAkb9Y#A=VBp&^GJ;c?bQl$>DVbT!*9+2-5qqcib*G zRoiSGxX`4urb!wla9O5iaEp$J9W>OAGY(FO1F2zG8|Ic?GrBArHIkg3X!IIg#m~Ds_PTM#!|+_zclsIiA%s-!{a95o-@PD*J6s+? zUcXdxkp6Tz=Tj&g*_M|ef1+ap91g%-e^Btd5@jWJX2MdPe^m%&%w~4{mEoDL9UM8R zlo(>Ic<4cR;tx~o{)lm$MGHWxm_)$e2SIT7+z8r+=5OKmpCytHrG^^wGu?a&1Mk;Rsz*7#M5;1cy-n@5#G4zT z;uvKGNr0|=_x)95-whKpe5XH^W8OPx@h@W-+OPzRhc<*GBOgBZ1QnyuMW|oPqnP(m z!J>U|nKF2vf$3BNQx9h(}iR(PV5J;D#D6!5!aImNVkLt zYYoR1*CplNnXsrteaE4N-@9GCMGb0lv$Se~FG0CWFccJ53I3MwR0Xx1Tio+C`iIL$ z++MQx3lxZ$^O6J*p9Tkd9G+O4r^5PZU>XmA<`33s7B~kr0@9cIdXf%D_ z5$(vJD$b(6WX4_YG6p4wXU(d?6qey}+I>`YUWR7ybq6%mAnz**@K=5tbW!7H= z!x*`{Pa4-o8DgR|JTs|IM$pMvb@a6)sXxvf=yS%%ZZ$@!8)3C+3E{Otgo)PQ_s zJm_+K;R_T7r4#hyi@o%g%MdR4_sLsm1m~D(67%$}BNv;Gjlhg_1EIc!B@FMK9pknC znfs5TR$y6BuO%4Q_rjqW^zw_P$<~O|7mj}XMe+ZWX$tR~@G*-1Vbl*o7vnr~a;4TV z!}oh<@m||Uha%PRO8K=q z2kuT)lXSIvJyq#GBad93eGGxJ%Y389TC3y%v}<<%arO0B7#Aj4``3if^#qCQDtQ}+ zh76nwDllOiVgBO3NdyGU%qIG|orH4Ys!(rlJQ@~|byc2(nf~a{g)b4GG>-I*bs|T& z@P}sB_gfyeedvhdLXNjK$j8Y$DW>BDE<7Bc@-@I0o02v ziwDSc(m6a8a{p_rt!Q~q_&V73)D0_Of$_=tKwfU2uf6=^iteAi;1BjM)@(ah+8wj7 zM!M?mRq*iMUO$+ljc^2Ra$#CQ(kA+gAYM9INBJJuu$=L=^~pZ7MJWU#&@h5!dJ?OQ z&M`iAn#-Q$Cf1+`M&*$aaRbk>*z)yQxYYp4HQFruQIHDon=oeiCi%L;GJIkYviX6> z!xpowoANC%utN98OBnC#ajWiDR$%fjdtR85m2r{U&I-&P0Qfj^!6-J5Xy5YpHPt?N z<9Zqv0&O~5LCt?=cq5dz>8gQ;_XKxI1B?OP)Y$W6hE?<@TM)XAxU*dBc@rPeTfM?D z*@|FZ`t7`z7)!b(s(Fpq@dG(vqA8CTNCefvqghro(@#4ELby{ARdf(0L3weBA>F2C!Kd9-HIB{^m$G&fXp9y z5V4QG9mr&JqbvU;P2S z4RD=JQ|AR5@1v$L)u|Cr_I3HpCplNGBnQ{&ggOV;wS>JmxNJ$T|fck4I&XHm@zg_qD#OLWi2epeTN(DEpjh>+Jp_-PF6!2|2&SN~2>8d**0 zgcH&6c+6wPtOnKu?{dS-vGT)~0-gQU^ZDBo12Ip{Gh#8&pZm|pVe6DMzAG(pREM=8 z4gX><2oCSl0pgQ0`Y>$0uRyP06PPPK{=VfNrI?JMVs?HU@Cq$QE|@FQ<)~3c8huNy z!W0*%u6kG-WcP}dYb$RrZuY-tcU|z}aHjO~PxqWB@=*rUl(2Z**Us} zMWjuHE_v`XqIIPqOhV6`OUzbu-9DWd_x+@G{}nDKXDF3pEOqc<8-L|U6&3`+BD-Vb zE@OwA2lCSE75zn)=CNZyKRDU!Jf)}EoTQ1J%}jHOD2N3Zb9tn<$Or6wDNfez#EA`iWs zyzqigK85BWEbaPYIVUBh@~@X|5dBORVtXeR6pAh`(hWS4jPwJ5ST^K6bC74R-q`BC z0z~huwjwK~mln(uyfF69T5U*}Oe9jx)!=Yk`>|pSY&r~El+6FVU4GTHVuWMD|AGDf zM4nXZ2Pf!{OineHR(HrvuArHI08NA&>wj*re{%!`fc{e)EbxH{jiR(}u-p0ISEkIp z+eJC^PCw@oyL9_Lc!35YcTP6(AQ4`6FTKs?)MC8l30l{7S|6TCU=aJTm6ub(B3;^p zg37kM1~qGdp8f?>bk`=o__4h~oH9-9w0}}{J)Y9q{$!yC=D;S_aqTPl7w|qE;%|Rf zl})zIW(WE8@#D_SBzmEe>)cgMyaWLh%VFO-pa?dRa!f#CYFpQl8_#gd(lChXG)k5# zVQ5h4eUQ1hsrX$ikgVp7?kibjh;Z$395cK>JRqvac8+PJkg@J;9L53OVNXa(fO={5 zCIgcr0$ii0%I6}2!t#2+Bgb&pQ~N3gJ1Hil8V zhH}c6ACsURvc5H~E#z2D)W4OLem;kVBOlcS^HM3pLwGv{(r_5eu4(a0<2klU_G-N| zfk*0h61V|kcT+U`^&wsVOkrwx)9klGX6PtEK>x)Ixnd#KjLnduuK-%)u^-~TU4-oN zU6Y#<1?f-g;UpK%Y$sufz<*k)2t4TUs4-jkQ{0?b z^)foO*n==u?&)vv+9JJ!8r^ied9&I4-N4!lL!MRZOE|agklz;LTPt7@p6c@S7p(J< zRS}oA)nDN7jq_zG^rYAflThVjk?zX!Boj9}@NUgO&agPX6F$apr$iAHTX>#VJl+*$4i}5YKYQoW zc1w(W6L@r{s|`Pi*%hn))KaL5tJ>1c7v#~kr!1Cnz7-d7VhjsWX^&uF$ZXu4>Pxhs zWZP`v(~+SFPihi#NkU#a2z(Vw&fio{+@(N>KMNnV5J!fn21O?(_!Ryur2aOYh~>%m zvUV6J<%CbEjjHhLaXYn_X_&kI(Bk-M;N?ppJ|F6x(~cEO<2LdJw4s}!;hqU4ew3$` zyeaxYAaq_y!br1ZABihGvs;G9AxjwSZi4!B<{jMy{dXM}WB^wKbpG3Krkvd%aQ4Iz zFSxw-B?^i9PV;!#^1$Hl^+RyCt5%+Q%r9hOxX5c(WiQNwbPVC8_&);hfkRo3!pu=> z&roKegR)-VI>G6NE~U|pm0+*Dv4?sX=D9lOYaO&yFOfItv?zMxw`wZs8iWJNfAuub z(dnqT&7NQlSE)BJ*mLh~-eyW85*gMGFq_}y-Z~}dOon#&Fz;>-AfqvNwoR|xU1`#{ zpcbN68y~$~d(DSh)XEKOWa7j8<;DjCFE@QD#s^tl!k5i$weJ{L=p&mCNN_0sEPlN( zpCd8(2%YtDhhS+hHw|EE52!l;Tm}rM(;)g!%#~aOmqf#u@g4QbF*9g@pJr%bN{0o2 zL&s+~C{#K_vXkuL{7VwBcEP7&A6NK1uKG21p4=>R-t*C+W9Abz9?&pKTODl50$0Zx z@yr0e0$~JYs)_DlHUvvzzr(HK)I&mVc!*2ZFZdMh@`1wLTL}1u3B%xGLbnpkel*8J z65>W_EU^e%d|l+tHHTiV382Bnnr>&Y`ZD0gS9&sV1tZ6t zHjv+E5aFWSHl0yD7K?Hm6*ju^PzYq)GcTO=+QH(9?SMM}P~6PHwQ+EypR<=k*dM2` zpRYidwFWEn%DqLTUu5x8-4n#T{$l{TNDa|dnSj6;j9);u<)IVVJfZy`C_JKhLf6sH zsjB*fGEb*W!yw8h;Hl930%rEKezKt>_k_#alIAbbzaO^gakx7p_mvcldKRfF9_jD8 z_K!dAf-t`9>Ag0Ux2}h>{M#Ig;JLqT%j|=6F^eKZslv`7m+?Y}* z^vabOVBerG<(Pyd4z6mcZ%dQayje2phtcU$NTzg#{^an-!%ghL8Zmfo3m8T%a+1}5 zrkOLYF3fx)wv(S9O9Y0g=3CHvM~SpKYD6IGeY|l2^eN`nFT@;qzbv?53}F3{LJLzQ za^$Ct_b*i!>o*C={#`5#|H#aI7KW_H0=}7i2fDvB6oi}F0!F1sgCDgT71il-cuV;u zgli`A?|)P6z?a3QQ-g?5MmRzA*h{d*zu7{}>g>#)6N?r9 z$`SPCYRoXLi%0Edyt@nwDH|DZdh_K*x1sf~LHFhQ-G3OY`xS9Xl-xW7Oh8QCruRP} zdjNcR#$Z*xyi)~cXCgB$Wx=q3!*P` ztjOhR&3}EYq6vAHc1$9km742)X)sT6Vg4|@i|oPIq%^jcbR<(foU#vlDLAD}8OU;E z)Su3?45T#vnM+{Zj4>oUBgwe(eyTa<*D-0MlnBUF^BI7R=(P7XpX8-4w)>J^hGCY- zb1T)jWu;2+{TzVT(T473KO@5+%d^Hh+lP0?$91`4obKXTq9aYRiyVm|&JNJHuDq@k zBLqz5YgmOw5O)PYy4SBg0S7T9NhhP8HTArR8?4u5jogiCJEo>@CZC>Ec$vaRJI#wE z%St`9vbB~wZcJhEieDh$LzVE`GK7W4Xv_}@6aBj~iYwt~O3XlP634D@8ab5yy2r~3 zgfxEhmN?=k=$iK@ZoH0tlwuPlil4qeCp2W!o`b_la2x1!rsN`5}-^~2nGz$NiUj6T4yUH*1disyWDk|iu9eps)-=X&)4jg_4VI5dq;e7Eq+&$)og?} z6sigSU->GgL6q)$`r?c4O-`W?D)U3l=X%+_H3hs8X+1ShGcl69cZKDO|CtAK(+7%; z#WWclgN9e0-n=kqj;XCwF-%$kdOvGhHgy1S5QnxPLh5Q0h}k!kMTTG)h?(a`wYJzh zOM#&@Cq9&X3Cep~Gl5@PgN(@?`cMHB!Kb-vi~=UJnt{!``>HrnlMSg;BGZZQ_Y3Co zd5IH4*uVO{v&`}0+b=K*gFnr|6u+j`ZxrN;GgfRxy?BOZ{;zXBwe#ppB-NcP(k zAP@uhTGb$FWp7Pki6L`;DayFYjLH`TRGav1E5he_ca;id@=fmB zJOaQHEDmanJxIVH+SeBe^r{$=z)(N79*2)zh-s2LwFcN&7*oXNUndR~`ND&I z$k@{CC<)W}^nIs^$-~F(jp*EEp1%rJXkpQnSn)4ejM9#^NKEST-BZ}8(g-YQ>{*oQ z?!LOPCcPLuib_ICn&J|}UT8n=xVE$t45J8x{SPXIhFju7Op8~Z>YZFQRPij*qcURo zJ}<9DWd`U@N#pTq^nK;u5V-zyIQM3DLZ^RiHZkO;%W3AKe&XCrlB5UL$8>25I~t(F z;&sdi<8v>WBXKHzP#~@jtmZYtm(w|f#NAU8fXQr@ zVQ|+CcbrBFI{ZdnHOwA&^`|Oka&uMca)h!#BWP?{(1Z)yi}IcA2DOhVji zEJ{Sv5_PtL?AQD3Qjjck90R|vY07-T^b6DTHu-9$?g_1Ke(IWBmcPt-D@>z@&rG>i zNH5}fd;f_De5A@3*ktD2_aK=ebsOCQ9{)Jb8w5wpD)Rt&K+s5F!$}m1FhE1DQvNY1 zB!71xg8blnMII0SKGDw)>CPU@fgcs6xHI<_X<{2u#(H|=o>#ca!aCPpoHr7Rq1Bji zz_DPE?i1F=74~&qf1ZMpBXw9y=^f}!4NZ4Z&%EuJExw~v>D7$m{B`}zedusCC(pRO_W0R$|2hm^I z_si#DUjBzD*+-@4ptm^<4;4R-B3fCl#OqZb=4@?(=fuovs+}tBDd_|$T&HGBh+XGr zH>@Lo$;ak1jN)GmW>8GOOTV%`Osy;7^{Bo^d(EV#H9TnID|6r_b2|fHun}Yq!Mvu@ z$!Zuav|o*cvTy_ln7W9#+EED47dAu+TF`ruBIXP<=Umt;RQ@E0>lPiUnVGt6MVhS;6a zv!j~bj4_URJz-*uP2D<*g8@yWFbq~5@Ia- zgXThD5+^%ut$}`W&nF_0a0jCQ*t21C@j!UQs4<|8sjo z05NH!+)K~ZeoeLTLVa#F3;PvoUP@W6tRH;^P+6V%bL~cDKR)OqckWncJ!SIoxOB?a zAHuP?S8nVI2K@FPl}>=fc6=E}ZLO)-I)pd0&rX@~7ty9MU5<1|5w&j)N81`5X+B1D zhJ+B?&5Nz`asvzX_UfjZ)urhDHi?+?daxuON~0k}2pMt1@1fLa2n&t0_A9<n4YC0o|Pk?%*$gaMa^o5 zNA&&%PwOFm8r!S%l7Jn2gvC4mWFc?JzW4cQf-}E+3EP3v-1SY&#JK3-t1~z_Zk#P~ zsbQFT?e+AE?ZniBKA9e})-RR$!YEO}TAYb2C-Dy|I z*3&L}4KCST5<9S4h0QzN!yt3{t)oFlH)U6Bv#_P4h7`l2@aqQL+r4LrJQaC&yQ zTc~ArsZttAwfqW@RWtc>PjMeL2*i@;NS`I_#bt=)0n#U0#>;bf97Pj?juLS|E{V8+ zZ_ySSc%NqPLa3fxn}}>2D3~rh8F%~N z8HDMW$3WYLzAs$#wkK4b^&CmCY41f_2f^idC>H!ET6B7YrVKr(wt|xYux$cTnl3t%b&So ze;t58L^quFpJt^0jPJm<3nVH&HO9mHKqf4IZGv&B8Gf`zeEki6M-jnF&=2=}=RN|~ zT|~t~Ri%1R(OO^!8EL7K7Z?~YTe-VP7jsa#Oi5B<iGcD-W54c)p1*OPbGdmQ?pC#f)f@1 zwZl2HUld0&6^BC-e z<$T+BEFtM8KPJ<3F zc`+sss&1V>UT7$6YW|~A?%)d5?tKT$gDur#(U^OxPg_B7ZWeH0<`PugN64AiABdEpXt4}eC zPCG=&>#%kv>WzPhy7O?EdAwHl-G9jZat!~11<TR*A^G%Ac>jb~8b5s9;zXN^qTdE7Jd_lTx=W`nJ0o z%1&Hq>?q}Jl)w4wH*ypGZW8*X4oS`zObjZSumtN0ymMD4)xvT}#R2TKNh6WB9I{f1 z(s=h#6&nt%5kI{ge6`f+dSJT}FQN?2Q#JY#lAt1Yty`)3&$*OHwc%VU?2aMrQ)PV* zGemi_w1z@Xou}NSBfcEPgxbuD1f5-k%j@|kT1p|e*sFibT?Lt$J6yi$zgtp0@YxqS zST=u})!3*-Um_A30`e)WmcK%om;V&BN3*u#dMQB!=zWC z3QqVSai3q$VTs87+;Vrc14!USSim4;`>7I{@Jj&CtsK`y$I!JN_>L}|`N`>XjRQ~* z1D|70A5(LlGZ19d70h%Ktrg6zoPfg+9Xpy;BF+K2=fSw#WvNf5&STZF7E9Fjz*zrF z+@5Pg1&gTcclyo`raXRR_h4eWhA<>*_L7--BKmEvY}A6gyK^E^^bv`akd6A}y!waD z{Un}%_26f}s}xV4sB&zKW64y*26?|Qc2Rm?M?C&5cXzjDOY7$y__$(y0P2!-RmZU9I~b z9B2DqKZ!WI^ybKiN6X*AI~w{08n%jEH`sM#-58p!#=;LTF<6MM58C2wB!vvV)Ek_E?H3;Ru<&8WyC>}cwOUBf5 zs#_0*_kDC`M)=wipKeG+3*?h5MO%rl>ty0WMZ*WXIf2J|nUCfw*%GkeMXcqT$|)$& zO#eYqY(EoOH3Z{3U1|t3kbmZpkDIpNsTsQY8CfENVKDFapRncyf-ta2s0-(#+T#;FC?+*v&;~e5L5h z*1;#eb~SvXI@<0}C*lT?9v}3-?K;uPu5Eq>2wn zrtkJOmHccZX391K>l(Yfe9ksLM5Gxr;;bv?Ij>W0IWG#$?gZT%zI)90KiiNA7 zeu>cQ7#^~xq(HXj9gCiJkU3EPi?gUHl`~6Wj4f7EO6f3s2n-^8Lwp$U6gw(ji$#70X{-KDMO?z_j zvKr(&!2TB~8k#1#cMyZci$|Z0MyzH^nQ^oej;Uw^ovk2T^a(RO8~TRGk;RDVdKhKf ztiXJqY+xB0!49{iYdkcXhUjBbA>OUFCzbWcYfsQo{UyWuJvdv^CR{%0khaGlA|&oo z#9dvD0@DCXAT9MxMX7WlV(e=xk!5VCjI1UWI6ztHKTN+XrnlTW zSK%u;WioYs#|K-$0o58N-|s<%p7f$oEm*?v>*W^`G2TmK|w{;8)D=g-C_$E=x83a+$QXCQ!hRURgT4x*}g zZHN;dA`rCbjnNhuirqGg&vAi3)^xVw4gO zCPdxm|E2606vl1b07glQ$bL4g0-3SF1sttbOwsptnKIqjL-9)WmRW&wwrM!WhB(kt z2wKZzGmm_aWgks-C5C%(*YEkh4bt!@k)|tAF@m{K|F1svE2i)~oQ0kl8mW0!1K4@y zji@@=Z#z7^(XfyWW0;*?0xQrT+w;p`&0&LJcFavj%>EjO#1$gZy9pt7o)6$i2qyut zQB|>`tP~t%1CvD-a{9|m?JFAT6LIBH7*VW6ehs{(`J@W# z{8)^z8om;s4gZYeW*l4G?`U;3xbw;aT#_P1&PB?2jyJ4AF=1bPDtdbEwWkxR=(cp3 zs_}XO>2cX5S<<7$=}@kcLUt8bwo&?GzPY|jx?k&`?(J8c^VeIlCDwt(M{IL6PR6j! zjnchXV^Nb6W6xippylT2s>G`knw#s2(k(S>Mdy24p{O?7MHQTIWY>>kZm}PsagaCR z%JP+@Svo{W<|!p?>GYd~kU~b~gncpflY!DXn&zw|Q_p3mXUlmCZviow2Ae^KZF+(~ zVOWc*Uur4@twxjo#WzYCeA*hSbN%;^{H;r&Cf3kc`reY=ry+d&kObrFuHBO$Io3pG zp0c|&Udvso|CU_I!cqd6;txVs?@DvsK}J{rH*1)gAf zaIyPEpJCh0(!3XQ`&kets;1?M?xS@~s`x~qwXdY ziG1I3QTwIJ;MRXffu8zv`1puKMo6MCfcpCLaBLI~2M+yLfs!9<+Zj~vgWcM*q1_{E z`09je^sX~1zw)DQAP{`Vr&tz%4i{!-a77*>#ENZzY4QUO1v=^yTHQY4>*Op9*n%>Q z6$rFB4q(VydJlKYyDWNuWC|hRj03>reAFd@4_#Sn%!>S*9r7C++CjgD0x@=N&4@$1 z7hx)XTy$%zLf{Wnp#JuAFdB7`1G<#Q>4OEo)}hA+gDuHf7TsJK#ALsz;JszZo5|F* zgDL6N2H&MX-I*e=oIyq5ZI1Z|7O=(;O(ki1n&BlSnRL+$VO)nsA^Lnd`t)y&hzqYA zBe4lq=2x@D!lP)p%82ZlHy&u3xT-wuiz<%*UMF9d2jWT$Iepwcz=KA zM;QF}<_S833xFkl!v8SImiAzTvjG9fgyzFKEFv#{v-WofBj2vZ`acnu?tibwg-q^~ z@>G5eT5;L^+hVo5RGEL!|LvmViqf3OS1k&1p*$o7dOoKjePW>K@im5k1u2oNWSX3+%kVO?Lf zm3?u+vBnW&${fcAzF~wQNaUy814#h=sPi!U#>p-X&ekp(r+^x>M^W1 z1Aen^c#(i4FOfrj)tDBL<*j*!=J^&&hT}ezg9{w@m>tSpTJ%Ih-}SLQEJeCMb#`a?n8@B>hF$r z4ESc_pkx-eh6fzkx*on}yZ%+_< zKOys3?03IA=0-t@BLW{A(M2sgE~qfusqM0rhAf?J2DNULV$0@#2Mjl3^U(oZ6mmcB z1b$)pE!^7n3c2xegTE+A8^Q!?Npf#Z$AEpIw3k#;Y+6K%8stv7!&C$hkt?Ev!DfC+ zvMrUzks|^6oMi6bDs*&C%UJv!eKxv61KQicEG>^?RBgv&D$BxEXpJ5R<1f1U{;K*B9TFkR3>0XWJel{RZ_pp@zcRD@ z;0hw}v)xfoVPXdL!xZB5b=5U-;@)*datIaxA4N&Fc)4|8#Dz zxau3M4<$C5bgiaLz878zbb8CX|2%N0J-_g?t5b8f{QOPS8MiMQ|JLO4_zUT|nVomr ze3qr#t)Mpdm#Ulg&z53tMaF6Z+}K4g)wX)-2ryVZF@tf2RJ!S{5$1ktUG18VNHMM3 zmwo(v9$zk^`*bo>S*^n%+xP7%DZqr&)<_^_0hwj_>4*b*Fqy znT4Wt6Pjx^qUEo-jPqGXK+&eVOtR+ z)U-hY%=fQ%a5%tn#VnF^Z=`50mo?~FxUn*|oQp)r(9c*2(j(m6({5#B!&(>3+S=cd zx_@La-ZfpKC;gQ#!9;^_!%`6Y0g`FSYv*R@_=g#rwSYk{Rytdmm{)tTy|#Frq*hN< zyR#=0hEXRS)(n073tz)~6dKS_h6WH4?DG@uV$q4Wxab85+U!Ku2u)zz3p|=AWb|<_ z8WjuXq!9Kahb*Oe67h@RKDn36d66cPFiw7hg306l^~O0VC5x^9F@Hk;{Y&-xtc^h7BUZurZg6Uo#StP&NpCiXxs zUdyOl5Hq+Ssvz8ABmap{V`HU`yWRTX26OC>_AE%p(OG!A7tXvcg0SrX_FljcX?Kk=O z$4De)@po>d@AGf=e4I0TfP=iz%Jk)zc)XU%2}yYYgs4Wu;mzXmi4M+5>X2t34k$Z^ z#c>K|4dZh=R8{)(9qN7gpaF1W_|lK6RZTDG(*{%7?7$60K}jzdjL)FPKjGFzCK;MH z99oI?&ETFcLturW0+We7SsD+Hag7l1;i8)n(_F*TAwB!DKSkwYieH0SSB)=4$sjR1 zF~KaL)(6tR%GXb=kv5jx<|eXW&Yu|XmTPzHQ&%EW?ph`wh{)^+Eb0{ znaAJp9u&dH%Aq5szTTjd69_#q>#_-C+#=z`HK63UeL{>_xqR|~!=?0K{~@{6BZg&g zCp3Y*N)ESw468xE!h!C2h8t&&$*sfbl76+j&*ueW!`uPN5@PsFTuVQhRUqCpYg|wLA z&p@;Ydz#lPe_s9Jf8T)axI+K*%PxswKSs1&TN>*NWP)KkWzF@Wju8%#LoWP>xFuDT z#y+sYP=$#~#pa3FgKAHaySTbb9?Dr-Z!C$^T8|RT@|u4Hl;BLdb82snU0CNd>~`*R zY%*;G3U|O@*f7Q4I#v7_887`lEYbgkiF-mul%WL$4scs?rXj&F=DX46sN8~^t}0Am zJ8n&>2&i4ote+360(YUb68PJAyi?9!_e)MAY`$5PD!_@7&D4ZgN|)pPA6ws`td|@a z!&ci)>jp}lzxqX{2rQa^^&lr>k4tKLF~YEI`N@vuSSj5rr(|!{LU(i)7NW?zaQii+ z>YJrMM{{*3YZO5rQv`#qEJPR)g0FC7TTqWj)6Re$^pv6DvU?=x+b`z4ly-;Rj1)VH zDudSco`{ei%D@VK>?F7rK$75))^fQSujQn#>xIhwX?x(J@A`VuIrPi*tJC`&q?>dL zE#sQBR19*)N7Ahc<6JtnG;;QaAd%6m1b`D5@R(m}-)G_{b1C$@4-2!UxQ03BA!EA+Jz`603{DU1g^G}joZkk|Q8*Z!~*@eO9W7IsL zcOd!?MX7tH12|_K{b#g%j#z*bsT;esf4d)%g1ND@vgVHV0G@=9D8<(v5QFE^raM^J zH>B8@>1r~iJ{$RKA9gm1S6zRc6l2qG=3Ei}Yem+O1QRUOye%OHuDl~E3>d@oogM#} zLgjpuUnW9LSuj{Bqd!;DLDfJ(%?c)4goVUBO<{O*L zXi;hS+f-iNg-Axlk3rT|SjWtR)NfaIhzIOg{ zkcr70n@a|AWLzo)N}K;>5mV`_Kp*jTJjc>Q*dn?(4?cS7ALtJxyyZ@+8dKMj zcX*lO>%Z&>V#)T=pA41~B=DM!sM3N77$>HYMLNYW(fuutF>#Ul6R`A zd?-bzojaGMxScKCzq1U@3K$F=<>&{$e_vYY+Gmp}6T_T|c>6JAfAxZKA#5*>F9?*? zl|t-UKa_4XU@Um8$(_eE7>c*A(k*r)x<1*XM3}CkG&w3S=?ef-Sbb|ao^B!-jX5O&!BV}-nf=DKMee~h!^!5zeOSq#<}=5w|EEA&BD@u|4LH19wQ)yd^fq3(_oCj zEP>}Jl#+=;b)Bg@x&--4*LR}GzaadA)3-p6+X{Nz2Q$`Ripk)~lUGqf``^2OZ`J@{ zpVKaKKq%g=jb{xRC^U@O)IaA1NFV1}O6tB%uFf@HYQKEIXq=}3mTFw~{)EMzGmf#5i@4rf+4=%$ccTis) ze=`aad;BIo*&?4W-_x$+-dXP~B{UDsg+J&8_3M3H4Vu)-3TgJc?HTaHFmZjfQ1W7+^n#P&X8AW;er066w6M7;F5@?02|D=7#O z{A;SzfIlSQw|%J9pQ|=fQc*}K z^c5EP(~tI#$V#b2KmH3c#0riY9Xi8i@y!io*7&p#r!ytAK))@W5+VDM)RG_tXe?bk5%%%(*a2$G9%*2RZxHe8js^ ziUYLhZe|$6-Gxi+YLNh>?{>U1Z~WKn=D-DM1!{u#g5K7~I-x9eua;RhFY2DPQX8rH z0|Do3D$kUSieG5~_?+?X_0LrL%gFv|90>9Ljmgb2zO>A8QfR=rt>jajUn=3`at@sq zf7X59)KWdH^3>tnpaW+noqjRnTjm4? zFM>gVH-;8(5Bx?hl27JSjWT_l7Ax{n;RT4Q8&|FG74B#n|4jITVg(<2z+z>Ld~BQT zS~c66e6!@ihI+3#35VzMW>)(gO7e^o`;b=D3^Q#JO~=0kZWJbZX^$Cc@y4oTkY>LP zN#6j_+wjUCte1JBx9~(h4WMuWLDXOd{18wo^uLV4Fl`mKx9H@kzP-5!S+is~0X zQ%~KAQd282EmUB=HoodZJd^_4e%v4thvIuo%A1wsqwVJu(#?)9e|cty*f3{Tc-4$H zBEP?I5*^prG)i-!J?qoxR2V{Gw>etAajvrzF+1j)L-5^NT?apF?b3>>s<})Z>zKQ+xdT%NSW~%-4^2w&Gt&sggenZeF!&%v7M^j ze%N#ZuodTTO~Dp~1ggWLS>gRN&J_BzU_Ndf_7h#ZCQJCQvDWNRbU|is)4~t=pF{K1OGDO?r%{0a5p^>@!)5-_TAN1Za zP-&t5;To88q`ZktwXeZEd@t-~75`D}&dX&g%n*-$lqu#ek#1apSt!c}T+bbHvnsO~ zgT&OB4xLbK3@7p%+JOa{JcG*p)4>RR(JUjN>_jR7<^*i}K!%|!&O?qlb?ajKU*7Cl*2}|I?{I9hY6CSX^??_81_dUf2Ncb#51Ya$-~RbKwnVUv{~n_T{JdOV0acNqIR#k zKxdu;*rSzXy_lhKKEHkZ9SSFzcGu;SGM=FpeJyVJoElq*!*$~6hx9eZq_|0jOttf8 zxxu-2J2P^(w>EzTy96(kD3hM*o|@(^{oH5?>g`NC-Wz;>=2h%9yYG;s* z73pC-d^REYNh_lYQZuMi!&rz4YKdXH4m4Yu0+l~4pJ6M)6+I=72kdtbDK z$wK4IATU1tK`lljut@_{W|f0fB|-n!BNnpgwlNhcZ{~hTAf|(TmHqk@$vmGI*3dLq zw#~-BjvgtOyqKOep4b`6mLQCjxgM2{=#gyFLOyj zh?O>hwbTjJeTM=h(DE~u1?*W%ZNcZ*E6-s$8;t-V5!!wSH zk6TzEvOrQfSQ=4Mg6Z9l7-D}fQ;oaO+J2>6nOf@^o3__RjRQkcHJJ|-Ufo7``N6mX z25fR~5!Jf=w%Gqt_p~?yuGnk`Uz~+JKe@J^^DGGFLP%{1GYE6(7f0mKY}p%cFo8Y~ z$amCkT*kW)e@my_Hv7~lM0a8Njj3StW9je1s@jf@9;zLqSoun2GMb9{+qg|V1${hk zkI@5V1q9yB7W!9(QFz3HW|zZ>!Tr~eYu(SA@zd-ajzGPk zT#=&UlA?^sVk^pN^F!HibZYtdn%gM#R4GV7IH%PlaMJIv}{kwnUWgWyg#SfB3F~Mvh zStJFGk<$l5(hU9LLwvyCPJG~%o?KPD#tGX^H8Np|*@A%j+47aadW14SZ}04Bot*>R znEkAA$o%E)N~KltZ5ui!@W~pXfcE&>ozEakJ?9 zx9PF!+^(Y@X|PUyhz~Q}uQ+UF6U9bOyn@WhT&JI&j|aUJ92PB!p#2a)Cp5Q+RyUA_00NvZTWI zog?o4uXy9ESsc2@8H}0HKII1W=Zeey*fa_)zsNvgkKh{muVdvt%+-Ai&1>16O5Gh% zikQqSsF#dPcQT{2R8c4HB9iM9Hnq6b^LZ&(i| zJlhao?(!Uxo*IpAGKb|E*e_^cu(ky!Q63m5u*addYYfiq&+GP)=6@y(kKFz{SSJfa zyO$G0yX5}#isNC|L_}AY03JJrkn*Z0mW2s}OgNriY*W9GtrdYu;ifd=tY$Ci2ALQS z2Dr%%v!sQ7Y6jd$6o1NM_=BW(BM!n23fRMM6{8~Awdk%96cj=qYf-GNz@PckT61B1 zA0|s;;Fdoc$-(ZsJJtRtJXqa+75@Bb*TPX;ab3qezKKhfSVuTv7&L=V;Q>&*eSP*{ zH$A(PXsmp8@X8iiGcTX*??iB{-)wz8iUl=7h8dNnXJ9lb;jsC7*gR=Wv51tjU>dU3 zRnUQ%Xh!J6`*)v$C04ChJOtPIsoZqgzOP9lmS5%_OGKc2CALh!m!|daU=Coy50Z8a zzOY~p`0OA1$V}Qv82ty=le3^>3vSpq=Mz@)3w#TPL{MnB-+zEz3!l(n`*_VorM5Io zL`&6Fl?ijfD((U8O+gS}=*zmUIZE=%;gKK2L*#5|xR<{rSbY>S$f9P^jA_E=jtF>g ztoUw@lihT$Uxl#TV1K7tEcr9%s=BBNcHNN@(nj?q_9>nd zqmHd?)D8CNyAEmA3E&WkW5cil0hs4+LRQ~5r@LFj?^ObL-<9S3 zpcG@mxG|qMB?caVxM|q_O+XOu5>S{zTMrJAgBrgqfm5Y=;)CDC;jU#cK>(dL#DY6r zh$#6W4CrOWP?wKUuoh+Uj~`qKqpAJyj?UA0R7O|9ueIjaIAYr(U zXseR@Gp8_!GSy`QsJ3Q(YDt)9I>K>rj($RWkrw+K!KM>oscMW8IP$wat(5`+us>(! z?pO?Em#^S3_-6@{+%beJoTzOFWOXL6{5GG{1k4^44pF@?vWr;w^o!ZL! z65!mUwq6e6`Is21KB=mn%UZp9LHmlCHfYQ&_NHZ#u76UGrSK;Ep!GGtS8BPa*i#Qak4O zX6R9(B^c0J(#z~J&8o8>7Y5y~W);00I!fm`nm>innK2fe@ZqCkqSSw8Q7A*0iL93W zXTp@8;5W;Qy;;F_9kkW0@~KD-hq-yvKCF|``|gWMp--g<5vBF5Wi`2|`#s-JffVise|Bs6{M* zyW9q&)a*D@Wa4yf+q%X&fwCZi6(?dSy&NV;^C*YbkERZ~v0f89(CQr#)D!rW9dz=> zUCf9&=*eP25?C&-WlMYF{<9metkL=to(8a*(`hu4++8auD@KmeU*baFiVQ0>lW zVK$du4VC5h2Nq^FVd&5(OjVpz*7CB_EGWZJ z*>KE*zX@7JV{ZOx*yI>y>ImDTAt2$Uk9HbL6+#t*BGWzOG7X4)!iqNAYUgs`fb8(N zR6XgiiJjNO+xZ#Uw0zung!HF95+P!+lB9|6V_+Qd;BVb}}`wTey>kebI>);`06ECB%8U zx~TlSE$KNo_jd)cAMgL$|8HbIMOx4mDzx+GOEQnkfUqtbP+Qx@!1YBA#F)}~sFd5K z>I>>c*vC<1u*w_C%Ndx>PxXu`jEIK`E?l*)p_}11j4-*#;3xlA0-@5bNEdv>yLm|t zJSMxspo)e3(qI^atlT-*9&bU?5G`#*HJCFeUz7UoA$e2ZOm6Fz%^F*_0J$fdUW~B{ zS?CUQ^!y?lQLy&B9H1D^VI+}zBMc~ouiO{ue6W-<1NEW8Y2>%0JPhcT=DMXVi55Py zcN|(<|ByrwNHxTq$;Sl1Rp_P+!39bYClndnfF>pVmFyLMn?Vt zkP#&cr)0^d?poI$W^`o^jiJHO^)7t@1{6G;#atHC8JIbr(Z0^U{@D#A%W=}NuL}3h zQBb$jV*ZW=w}&9zko3bGDb==G&)iuwKAQF|m5eieZNdP<%Y9b6LZk-pm7kIha=6_k zq0Y_y;H6Dle~(vi{q>CoO7g@u_Z+0yaI-;9nat+3`T9WQtbI9 z$jM~bHrJmc&RKdCK$b`$-Rx1tmxw7U;mc+2;u&o-iN+oKW2E#dWB9AnK>@MNQ(6fE4tr5w^`3+z0*ghk!wzz!M)m2o)A7pC5npB$VEq2-U}4<<;tv!=iv0i#hR9t3+8mPN9ReQhw?{WeLE z1o>y+)@F^tXiaR$cCi#r_oEa}hjgfgF2fEZ49!?jmEPMrxXM0PLbq zl2Od)8=}}}#G5hdml|LObe@+5tf3&s>?I=M8Mep8ldrl6Bd|*>^{6Z#Q>40X1Y>Z( zf8%rDKYd=BErf`mi*+to5fKAwjH=g)hTvsaFYZ@iTw#z~dhzB*6=56=yk@Dsl0+MB zI;5h`r^ia#4J8E2^zgKNED6$mG#}OMm!Z=35_GVHf_wXJ=Lx{Vw{c({WeU!ee|SQO zD)$LqwXypkeV@yjUvQIO6!X{_2CDzr77c1K9A%Wo9_(TReGSV&?)_ImKB?~q*_oP` z?t^zK69UBx7lt+aZ7juhdjHeUr@>tDBF&;RqK)zQmMcxJp5GXsN<6OHy^}l6uKbnB zSlFC?*x0_TDS==2!z(U*){g<++eZJ|_N>k1f#5i@fib7koptWXk8gXFDH1DX#qmqO ziKX((u}ptR`v_NCTMB;uqJ+)o&zdL0H1L5H;OC!y?t$%GrRStCT}^J4j}(tHol!1& zqxaIE!r1Y1IRG5f)8;aEeCCu&NT$2sHPrrVfyi$5L*bhzmf7{I%Kk%vrq?FNe?s8k zC6)Yz>JG#`E8hiXcX}<6@gebwRw99tPhOrP5+h zYMoM*OnHAY8WIn6eJ)lKwO2fxHw3+@HfqsC^wM)M6}&K1b3z{}rfKdG+dLYT>IJ)7 zv$&aTYkvoOB$tr9(ZV(beTLqFtZ}{stKVt>Vq$7Xi;8{mqcPX5WLx-7Du=oPbce_J zA|q*qwu!>!_w|0jsIEf&0_Ix*tG6}d0ZjhbmEzJ!U1|a_7n$ePUNrI1i>l>doy(9D zm+JqT?%~wAHs^6;P4ctXB6CNS`0X-zLGxQ1K-;Unog3B1`m5^!8nnUz-n2p}N}bXg ztDlm&IfV-6?cbDwsS--}@jU53>e`=jxTKzcSdyg~p}To2 z+M6t~i0{DDT?!6Yd+47vR#ZCk`QUJLm0}~3bl5)4lO8rE9v}aMV`~iis9%J`WQ*8@ zWYiO!lY6%D(_!_%p}N17Z3XPhcP;v(>Fc_Wwr0i9-BC~7W$Mqj%R)D!Y9D>0@o9>| zGaEWgG>53ouYct z%F}2nc~I?{df8aJU~}?gMehW4yjz?y#J?bDY7ZWSeUl@({q zKr-F>47*vmEKkSjc4sR!uNgGdZ3~g}xh$M{Eu;J<;9@^%B1gb{GQOBX0 zr5QnvZgu4>e+XT!`P+{F16}+QLF3dEMTr)s4nO=U*^DIk* zJS7b8`<0K2Q}%O(M~4Mwxr0LSgJ{utkJ_8=YZm42G2Xf~U!J0Xm?V|B;SwLP;3Gd! z90&Vh1e1o|Hz7rl_vC7~d8nLUuwEiruvwY&5`dr)>@QKOl6>B^TfK%Q4AAYyPJs_WMsiqHHnz8>U&MHvWu-4I63qAp``n-g9!gK#Oq% zn1N<=P0yQozLuhh1aHS#-F0zSdRCY%u9N|8C3#%5{!s%Q5ULkyZMINjW`H?kUS-Y_ z6xh<%QX1^!))QiqyBH3$RUj=&U|2Sar zL=`<9T6&MXN9E7l&w0aX2>q&MU*d^`pceWCZAjBfV;}o36FRI>7M_3GVeFL3io(B6 z55BVW+nVbiU=3yZ@)%vtXL2@q5N*1R0yU;Ee_)WIEzuU3d45iDB`j|VQ}?m2NcPdbZ_PznW0E6Bwc+o-1RbM!H}x}$>cw@`z{r|>>@O&0M(*NPL)~Udhukm7 zy|_`;0ojG+?jMBCqn*7L&M+e6<5+z{h+Axy{-8D{q$?}rf{!nV)6pJ)Lr@q%@g_Tu z2|G4Ic#6DsTYWl><25<0GNd5h&=C)i?BM1(@vV(2ZRUF@>U%k6vfLu2HDIFse2(&e zf}Uj~BXZ{1YJ~YF_$obB|NqXyUmckE%=16VK+7p0Ql-rpr1`~XFIhoh_WI5cQBwr> zgPs?K!UCgKE$*QJEAI%RGJbxH7mfd&qX-pD*(iHoR>)B)yC4Sg2k{pWh0N0aT^)PN zo}IM=T@91%)aNh)?OZCSjx!8qV|>|*D3 z_7@m*y_u*R2~&;W{Nvd9HLFYmqvYwPTK_@FdlH<=EaQ+5FXeG7)^`^9jxp7j8|-k;D#^c&Bc?!I;-g4MwdZ5Gn}m(*;FX|B?rYy9TWU)*41 z7?*!v6PQGhSsSFLTBXHNFp(%cjJNvuM4JbU)V!G9`hBJI9o(eamGwscmBI0t=Sa#q z<`So;%2i0FcOB~T9}^Yt=6PEZ861}I#yh%De}iEiO@*z>YOx^#u=+5FWFlw~O|P*Y zT;tNwRqfTF=Qbn{NWN~OWmnqaN}h2v`^gqsDis^5aape2_N8Q0QNM52%Rb`iylruw z-mdaWGaWG;{lKJ%0$xghtMk(nh z1;*tCUN@?Oac6VOx9lW1YE|`}Y`21p+q=4=J;{ii{cgdA>O(l7y!7(WPa_kEQ0bs{3mA0Oc;O1&S_^&NS(EE2T zRRP&p1{% z7*Zt^tfBy724NzIU-YR-2+M1}1^dh?wtYvU_#X4Pj1fHI<1L!LklAnUy5r7eg|~d* zpDq|%G7|Opvc3J}D=BzC$n^v|sdQ3~nJ|$m%^RB;7{V*ChuPv0Gxvm%izY!c}VvV#Ao=m`VzOGbWciX-*s+&|b_~ zNC+r;fk|5>!)H&@lZh~4hWmeEC~3@!R!57IKK>Jz6U4j!C&cEg^HRS}@B{ov=$74t z6;HKi?JyeHGBM53B8%H7>0*pZ4p9&@ddyP*qP+0inQ~I<)%5ZiKiQ~!A@aGx_Qo@a ztN4Y^8|P>wsiL3-?94K1Fq7m%Za5b928;MMYtH!RueHeFvAh(b1EB||qrGa!iH4{9 zgOemkyZmR^d>oQ`v!(d`YJdfh75X)1H268f3bLAmX>nQP=D0)ZNRUKC&Lj^Qz&fGJ zNrEs6Rr&7xbrhGyr$s}|11H%scgIc^Iw1%4OvS(uwWFC(4Zz`5cO|{)3wb4l z8Xs2`1@JNf*(d_rF)<;*Fb2aN_!z*Ugo#`bCF*KI?A*j<;A%a-Bcfz=5qz_UUW5@5 z1e%NT2UnSNGhqFSoKJYg-WAZAC=s`T;q17#*>O8|_G@z(_FNnXPx_&C?PW%sr z-NS&mEQ`}jYOK7{YbUVT+naj#M^O;z^f1Gd4~Vs6C|z0B!ZCUvif@vh(bV2WwYK^n zJ9vM(Sh~RXxyQh(%W!QaoV6;DWwa=*IIhNS?btDCykW;*X`p7%1gbTaG%RADeUQX| zB}zU@#X1*E&v$IS3;n)6A`O1*u7~Bgxzky%uskX8yK1)D$+0{p`z@nK^@{}gNE_jX z4@Lz*!NfrySuNT)md0B`M}C%%|Iof?rW>do@xjHfH-qCl+`HzmDKmcmPD2#=cFyZl zcmNJHI9XGJ_TW>#);IRd40po46XSDsxlnXTg7)3#E>{ORsq59RxNkO}(V4x1Q{~Lx zd@REhjOU^6UMW`^*QAM9P_%GvFe;s}UABH9e#vbY551%5MYHkFKr>!<9L(wP>;0uM z5XiqXE5YsVJ$Or_SI%1ZyCr`Xe^31;=Tf*5$oXM;FzXg-O+Q9=|e77}{ z6#z05F)@;!blc|~T&16&`;S(4!*DU8v$mmI-7C#VqLZ=D0Z%d@>zwE@g{#$LL1v~c z0GzitQW3arSVuz&qxY7GGxITtd)>O~O1XqDDuPRxV%9kqt)uM^A{tdW`50v_BX37u zV;bxE)13Cbk<|P)CW>&PbK=6`P|U+c zlAWWCH?5*Xt;(2)Oq}YiwF)IvlAo)HkZGmPJcAU}IbhZ)i48u$V5Whg!H%BAx5@}9 z2;g4~OtDSan;$hZ==TOYc~^kYycUzx53MH`ear^3x3<0*JsXMieT;&B?^R&UD>QrU zZ6wp!U1M6oWGujB=Ov*1uW>2p$AZAsiRJap8RjKd8tz3|D9b_}2LqZ79$E50A)bAR zG~?VdGthwr!=-yh(u*UyH;t{}#&wigNcWlg`(@!8w_jK_msgD@NED!BfveFm))c0j^YaqCxQ%`?#EZ{$m?ms?x!rqj+VCE-)XvcSvG-%S1< z?U*3BvjN3tTIqLo2l+Mk^Lr+xj@IV2;zVJN?`rAvnsEh5%-j-V+xmJJ<^+gbcvFm-Im2UlDruCh?4S+{;R6q#xf0uvn?~7x;SH2z`QxvCF8!y%u&8E zKk=!5hpnZD$bV&Cs<(w04A*#38W4v}H#MpEkwXs%?>D+m_xzk|qsX{?jJ+c)48xpGW$Ner);d?pBbEw}c4aL22NYOF8wKg0{X-I>D z6Ku}ke~)R0-qr5s#2(FsM#brxqYF#uwfq?{8^IzA_6bm5@t0am=$t3tFGHjyFL4iG zUTw20PcT5+8w+}d3W>zM`}u?Y2jIOm_UiIz7Z`5Go&_G-2v#5cli=CHvAF>;6yu}W z`}y*Kr5pmen`&`+tJQpYNzW4@PPI!pmAT?N+UVi@6k}OT8fV)NwVw*m`cG5|H4Ha+ z=o-7~#)ZRw4O9-AXt}=CDez#kwB#+JRND*NR+0Vp-mVrkJh5=mdmz0a*Q*p!#6fR* zJh;_=cDsX161Lsecyo|jMfmreNEknB?}s88NW#^ot_& z7k+qu&{Vr_?+TA-Q%^31VEn%uGwiRyuSsuiXxNx7P8-bwalgwqL2)C6i1;pIj2P$5 z==_TUJ^l#9p!T|-n-AV$04QmB0r{w*niooKl!ZRab!kMo_?nT2H2{FisEncxBvOEn zon?XRKtxE~(&D|Y>f2Y!<}Wy^GLOZYT(Exi?wO4C{S(4R{%aH5!O;CCh~^RIHI(rI#m$Yt zh>g4C6QM1HgrNFW|Fj|OB*<575Zqr!KH;fh=rLxUw41tNmP)cqfs~-98|g3`g_P$5 zei-p-L`oX-)eQ<{tA0FH1pMtC-4djNClKFpU<}{>EVs36{eQ}U!rsAjQZI(adr_&k zt6UMN(-7b{5lsUkL5xDLt=FcfSDlXv_K_Y%v|wSAuH|{zpRj?-zJCO!K-x>VsE`D7 zw4dR#8@__Cu?LmgA{X+t6akIa#6-Nn$DgQ!TxQ0BBFw=;dWb%Lj`)`dz3Xj+(mc|i zzegYU{Sv%QVoEDS$|)&G1SLc7qM>`KL5iA$8sFu!?sV$!^n2QjFbi9EbU>0z%V~k9 zLr{kwNI6H9Hag%Bzx-gnMKbEf)N(1MHa-W3f6B*F8|+U?N_15(f5*nWq|*vJ&MKR* zjSKh%-ts@D-{e1DH>}Kgy;^zPh--tTTtiLgdAi)hCO?~D=?Oh*`$cV?#Z;)L-KR_{ zdPg$TPseVXw&>!1sS%!hbbq4K7w44b8t{gc-r=GC;`*oR=hAessW{YESuR%(=cBS8 zs{_MhdJ!qS>}O%0Z6==78+0NK375&&>(bP&a>(`rGofP|@WP7Y2OrAZIJHq*EL2ke z?Om-~VnV6!)tsl{rHtOlx;iu>GB&m&=J>Tt@UBke!?Q>behxE6WLC#G29?I=S9V2F zUK$T>v{^AbKOhVPCy6-sGV_#=uS4B-<9vL})&g=0vM~*|Pp6>;d$gdqx0A!duhf zK#PGrW&;QVNSv2KK7#x)6*ZP=8;#@_gpLfoZD(R7|1M6m&&&~z$BDRVvWIKrB6%;G zXE!PF3@X`mE1%vr#(@kf>wM>?Dv6wD{C~_F6$Xe&`$thk$KO?>f-lcgm~NPHZ{EA> z*yylQ<38a!M8(>Ep30VzoGLWU4)JKhy4qcyUx^COWxL0K2NH=-kUf9dM>#Us?iKtQ zaSxKjR{yiJ*QgzBHXT#0$>PgnH<{3m|CTEw?CtDKrQD+}y%XcowEn8Hz6~xobHr@X z482)##iV_Hi_{e8XhxzoE%-I1bs;h;@JgPi9i56zBy{*h^mgXX;vK5`c#sEGAOV)R z4o0Zim3t-Lak}PB+1tu^V3+&%h9amAvLkmJ+uGaKQl6KPe@`Wq8krh<#;Ssu>D>0{ ztspxr00y@YxnR{n6fJI{67><6g=p%Sv0@t;pL-=^-fM#S&GH5_!tS^3_^hp&N7+MuLg#r6LPGKbhM%N zuKiUNof4Jgt$-_x@wy`AO$H!bL$38nBvuVwCeuuPHFu!=E2qPN04z zAL;uFmfv@&O1^cgzQvL`R6GhhiJAFmjd{oJYz}p)_m}%D<6~ACyV~+l? z6#D~WI>~!Qkxu!&ALr*{e|u^7HU^zhXBoPzLS~6W8w`QRyFvpYwyTU;4PLZgV(2e- zmy=ru+8wf~e?~R=4i)&ul^1n{2yDKx`z2yEEjB6Q^T|>cq0{44m3n5L_2oXy*zNU9 zQdBP0RA(7S$#(9qZEBa138?i9_6|?{0qNR^;_Zb%{N?*Oow`frJ=0&eyG^0PNyjaD z{>-F$%Ci61oO7{`v6Czg-*Sih z$8|_4KEyc+pV3E>eRcot8lG8^NAR?x$*HF9L&mqG1`6|(>?Y=#@_j4Q5e>S%CjB$| z1@4t3ck``h*e_0hXpNAG{5I$>QT#W^|JGHnsRF+@fwkpK3u0EO^vrA;dZ&^LerSYd z{0pJjvwemg=gq!GC~=>f`EP;CZ1Jo+1?rGeX$S-SJERDj-^?|<6d)}QVgXPihZvq? zAT!wIkAmEf0XUYI-MW>HcW+IC=ETiopU&Igzn$=(s}&&pOyef)Or;;0&G z=1bN`R)FJ&sMfc4ZaEYc6AXVid_LYZGCum>OFHKO_lZv_g&uP@L4R4+34#1FHf=$J zZ)4ayy%;SRmv4JzMum^w`Qw6p*F9;LZJyHmgpj=Ztz3F_y^d zH~jsW7YDz6^MnN?O)Zv7$#?!-T}q9hF?Qe{WbQoHs`cr?Oz-!bKwsb zu`?g=u^sUYv{7NNPXk=xoU=Ffr1^7uM+p7^>}XlIi?W_0h8hqiRTI5u@Axq3#<=AP z{p`!`!2PYYJmb+jt~f9)4Xh6my)2ySUV*`+?uLIPh=aPMRHkHp-C<&uM5D;?h+yE6 zj~uXPE>pP(^`iw(55a_S7i!d(Jhm$Fu;go^hhBV9Bx;i*s!yJ5A~HMPJrHR3ys3~ zAqf3!f-k5U6G%(iZfTCG3nPz0{)OGa*b!B_Lp=j`<9H%`V-2NWQ4=zS%LI3lD6K3t*Qp+?9RM0ewetvQI#ht zGX@$(4Z!4W79JJ{wzl=ef5pgGOzPqc~v8L0%}tD!4_SE9RU>utYF1uMO4W%RGpQoG>*2?0#1H>ae# zf`Y}NGyqfYL`Q{p^%?ry|LB>O1zMp2oPPq}T;X(BDeSecJuKJ;TE$6qP1 z5Xo?oD@C#h)L2nrFp7+b6L1Xkq+#dD13hrSp0+<8Ey)6sgWD@H)hmFYZAOwrU=L-c zE!Kzx7!V;xTNNe@SSjk~`NKit++iFVKt{x*2BXlsD^8cdf+Z23PlvGgnNILL}#LUHvwiFvN5Obn4`0qJElu+3F!k3Knq@d;#0jP;g0{G+t#Kn|ifo zQITr>T-nLO|%hcw*$PqW<D5tw5wp~xdXhT*=OEwL5llQGi4;{ z>!gU&sl?_Mhx_{PRxT-S;72#hq8uMkzDGQ}G~tz&XGMVKV1OOn8rR+qlQ3aa$Q$P; zPa-k+8hYsQ=ly*$V*3K5ldx_2+<@rosnze%;v%*=za5W;&n&v1d@6XM0^WwSbHCfu ze9O#T%xYmgyjBgkzPZOAdClrbTS<0JYtXZVI(9pMn3TU}on7H6W+1+HGUq(qHghZ+ zn@TCC`mEz2++q1}YDp#QFVvB0?<_RI;QR2+R-Rq0`7^mY38Jmu{-#GrFmUSAObLY3 zmU&q$WkiB6=*i}B;hHJP8bP;J*?Hm7mfOxT!%sSmn5>rfJDz*QESRM z3poLo*72s_5Y~VR62odC8OpnY;-?s`kT4G5q%mi0=wv|w@e zGKF5T2*~SOvlU~8w33+4zV%D+K+2YVfe$_Jx!u5p*TRF0f|RYsr3`scEeVj`G~k$K zyA6)BwMr2LUsh@!oekT<1wQQ&3J>1mS9y3D(J}wF$t#37{Uro(^wF|FyIE_qJlaAZ zp&*x9z?F;w06$8o`*VNA6ApDZ%x$1{j_E zgb)_^J&$M<*PPcZdFYuX8m)?4tANt2a?7QZ#xkcxxKQFPoHxy@vx%pe8J+ykH<0F(7w4d{qy3E{ zpjS{REMVKk6*zo`Sk-GQviN(zmy4WotMZN)|7*8IIQ^Fj#t$YU(o0jr=9}KhUH9)E zNON<5e>b!O5+Fn>=5hCn?cnC_u;F)fG~z#9+(t>jVV|5AYCQj4!#fk8lo<^uA z?nyqE=F9OC>{orDCJCz342sWqBnr}Zu+t)3{%mOZpF1O?BnbH-OSw&C1Yc3Xij*dG z6i#x~b3h`O^}hG1gQJ^j{Gn2`JQ*Ysy64DgQB}71_DKA9O&=#ZT7tFzFA?Y}#DDpP zuAJMq_f%mXq)N@N*96QTieNYl`|9PGxy3cnFP}N@{vEalR~~#e`=eKf4!I~C(WcG` zWB=eT_z#Z>KD-=v(<}Oz&k+>2eyt7+RD-mvns9?u=N5{sA+9{^fAddGK6G9Le8wd~ zrh$4%kk#bpe~fv}KDP>{7BWQJxzMwcIg^?9q+!f-&ooxfhS8IQ3VL#SQ8FYONfjmk zodfpnCu<%E{14_n@TP(0D;_?ouwd*@ijilayq-Z`$o{?9F{#+oc@wKTQspXtt#% z&BmqLFY5c%H7(iv0@LwKj`PI|n_$q<`sCG-=3mFJ^b|Ws+-~GbPh&&dQxZ77B>Y?? zi&Rha0z*9j%q>oqJ)o?iam$YsTCW-J9X!_L{%or+BjHDp<8OO)uKvn_vAhaNM$chp zYFUxS?G=7-ruAcV1IL0a<^{;KmtK3^ML|QmifOft4XJ#eKSwD0OA|RT*{WHvFWMB} z8AH(=zgC*^TJCON>QU`?7eG`*lO=hfA7!t?sw;M=P!4W zSKhDjd_JCykP0<~Rrdx@+?l>ZMUASdjmoY{_o< z3|#2e2Ks`*%$`iXL(q`foV|V%jw(PDIku#`jbAQGs*uSF;)uR@H}y^KQ4v$Nly1Tz z!jJ)7RBXXwCBKk50#h0fr#DS!0+?3vgn!3B^)nRN$Vq!xdooZJNz>Wd*6!pMxR`Ib zZ5<|MN9ZkPbmBalbki<+l6=vo+NV)Ilzm{#k4b57>{_(i*Cc1LX;F*5d-p{T|5IE5 zbZn+jUf%sDpJe`-gwxqgo~uVm-kwBFa)cDTN)ES|44N;?`x&JzSr`B#b9?{9`E3&_aJP0H5oz0}h(_eXgCVt#XSlmQ^v zRY`8$NEILcxd&5Uw4P|I`Td|*52#|&_DHx-4vITAY*gcOXxoi-+%xOvFBMrb2?_Pe zoP9?|DGvb?I0i3-os);$?H_TW>*N>QwBHtSy&7mnY(}DfAT~?u3;)T< zX~ItKbip*sSa}>UwY9Q~rT!5`cy5kKvi{3iSI0LAv!`xb1uIoTLPSr4em@sp*Avom zP!)U1wIu|q;dp7>^3s^!!L4R4)6U*?A--zlvv;oyw%qF|`sSpCkDiTrLWuIfJhuLC z?8aSzfsMEONtCp>R!a}&R~ZYa>c^qyh9(39!UMvh=;%Y&SwuV{+`0?u4HpX&?H*B! zKE;1L+2B4t{bpUJ^3rkpKJ|Uv+#qM3B;s!%(hQB3qP4z_+sOTF1zdOP7a+xd|2=JP z&LITL<_DjLa8+q;r;%NY5+iiDMkQz;nIxGx1-T4uPqDVjZ)jDyCH2->ef9AWbbQ0} z<@0wJ5}^U4n3QKHx$=&*CUij;!oNezgB%)Tu`hzq?I{kacUP?DW}PiL!6tAP6+5#R zgskup6G?WuAR0a&I>jQiiaH>s`ebufwv5$_+_YxB=-anCls1xn8r4Pn(BhhwKkMF# z!{csG{-$g`f}Ym_SWA49=t%b$)r2yot!z^FwgBO8-JPd+2AB zTTQZCO_1*!p3yYOa++zk$g-SgSnR$a>T~IYx%KZjd%LOb_D_FV!5+ztBaH2fPoon_ zOm-SA8N)H(U-xsXzAMZUk*V~J5r8uYJUMNcT`zRVe0WQXkwPB@O3?udVIDbXj$Nqs7@BZ`0`l}@xolQXdyG` zCaQ}6-1Xn)cgvVXi;*0^d{yoARAzbK;G>2@FYSjHxHC&1@es6PV@hn)4xQ4CZPgi=v;VTziYzabwzLUA|L_@od1`#?DfDar_ zC)aXI+shd(o=V6ra&ZyUzO$mBlG03OHTEV>cL4|QP@?~Ge|a(2wUz7da4oqDQMMF5hD-{Cw0yCulUzH7EY~ABmNBgn39@ z9l1&+`oZ6#?dG*XC=n;evks&I%(Vj(3)*oOJO&CYWf?21htlY}jnJ%=Oh8fV|52jw z|6J@`o@z||M`=tPP7+tufYg!Z<1|biA>Jag<&DE`kI%|Ud)mY^{&Wwm+|V6?71h+6 z;PV)x=jp&N#jg&7nSsn1FHjNJb`XlV1Z{?0afFbx3QgIs zoj89)wIS(6==$-QwF!xzHL0KrLz)}9!xGI5UYtu$dE)N(Jh;gLd90d-{q;2oi-5Rk zdY_Thp7&CmEGLJsHvVGvt~iJXhwopDkRYNB`4C_>ijD-?-(AWO#MDt-5!aDUll(!^ z04IrW9fTOT(Mf^QzEOAMuy)G>iRBur8WAK#$n*VxKcZfi!mWs>OAI=iAVubiieAqB z=d_691^VbWA;u!`wQu$>bH+`tWc+ zf-=3vYgnb67^whm3!(lI-dv48xwtt`TdR9UcQ#R7BSpRW!Omvm9y|K3*sIqIoTNUB zMhV|$?g|WyNh}u1)`s5Esoq?MHy@gcwr_Cy@+#h>U3VjLqdLzoL^SAzV?*jvDyi$k z*DN!>GJj;m*)gHjS;DM9`-xHNZT=3OAqg>0(@uwgbh0L_J0;gjz;Aykb(?|xxuMpf|n@B~WQo%l6V_+o_u9UX- zLad(%hGn*e*dwhbFQWM(By((yz!>6en+=r3;rJf!B) z8kZ)FD?6$1fw4bBBdfH`*Hw9vGS~N}IS&gf1lGNK3qE9VH@hk7c6>;E&Sfqk(=kT% z?VbE-dlUbidqiF7bD$jjw9|5%UuXgRe=cfK!~4jGH#$f>-?#o>>|>(OfSLn!)^uj`en}%3bl396u=2Wy|zPyGZ%zL+?}gGnkov zolS1Rg7U_eR=x)QFqFAK%DyAoiZ>Kr*mpmy4289$ZT{4Hu6-gCz8H2G`|$|Rq$>OF zarfO;p)A2pzO1*(@B5I}ikeyXq9mPlW`>=6>|*gOLQN0{B1Ck(n>v*l7Tx(XNioWS zIW%&bz&&gfE9$yX64dXxQx?P z%ej2*B~dYYKL4$+O1cy~!Qn=!txX>ztt}s9Z!d%I2n~PR{Vk1`sxcd;uJrqaB)a3& z?p8;cC|b>*(vcrB=&&E7&4sf)!>?Ky?Du%9=rhSXh2>6FBi;vlLkH(6T)D}GxpA}$ zGlvt^;M0jwrO9N!^3SLT*?23%O@1^X_q8&2u3e75e7Pl>;b?`ZX5sEa=L%)*;F>Xl zqUk!K8van|;wX7h@vA^5)qsyZT-f+S8%9;z43_JDyY~*xSi%Y5d6W#Qq6txzE8`}5 zqQY%nRrH(KC?cTQWtbX_ijiH%4qzG)wbWoDiAF-ts?n&w`z%0Z0~bRY)X?9MfbiDI zcaEW`w>gfE^slhY_@ri?BT?(kF}DVMp4JPJ}G(${C@t)P~QhQ6hSIIrkxJYNc{GbUf5Sm%Qw>e)XWtu2rz2bWw|fN z(X$o!2tm}zhabHW`|LQiA71%682c@Iz-JiRg4A*Xhf?1c<Or+APpStK8) z;MSn~-`?OP5q0QBxx<1LMNCsDXekpuz4+X;dDz!2BPTZ?=`s80{;uCna}-K;)BL1B zJ`U39?+DFSAp|CMKwEs1Ez^8+_(=Z@8ueaMG#L{IX^KGYFJsBYdoF%7xioq53lfPnR_vziqK!zuyBlgZYJYk#6Z3||K5}ql z<@ZFnSmiUx?CMJHKF*p~>Zar%Oz#9(G_kqMkxuwz77F!#(U3&)BMa=3z(SIc56U7Nnu{8}ARzlkgB>fme`m{>w_K$4qk zP8(-FIrWdhGd5JxHw3nnw3bh+vjQ`AQjU{C=mMAQ-Y;q(@3l;=YbR!nMB1ZzU zb{)YEE7)8wngQ8&7(J4qyn|ePfi|q$swJr}gO>x|KfC)45NNncBeoRYbULN7Soc)c zdx@ld2fu9Sa8~!??0)0P^0_@_be$wIS$5lbVK}dBV0Cce4w&Kq1B;a3h}z3$S%MsKH%ee3fs?aQN~y85{tb zwm$NZ(OsK}E}H@zG*RiRT4hyZ=>mirHjIb6eg)6A6-%iE)*de!ro=Q?m>@glx@Ns6 zW|psUYLdr_Co^NQF6Lb5-&6f#>=$R7b>S!mI!h1jJVv^J4)Xfc3QJsAyFxt zM3<86-+vvV|L&*$bv#Jbh@E$TTZ8oG;lj#fqUEq)cjoFkzP3+-QRg!og94B%-NFS1t&o$U;>d;0gQ{;#S5{8ghb(Z-1*_%v_jzPyR8TmiX2Q= z5dOjm`p--N>d2KHZ8fB9Nw!X^a=l6{0j*h-8}-$k4O55pcVH;B5&l7;mp5M3v@dqe z3BWd}Xkj3sK9zInQzK zzKp$#LPeATEox>!3EH+8ZA;;pSOhQl*4!WA`zBRNtX~&5VGyZ1o=9`?K&(iRVZz>| z{qR)9*7-fXw{vr`7$Vl8>s>2R<1Z?Ps5@F5I&sJS8=XblVvx(QB3 zN?%;u*OK!k8I*5f@_BUkq{DX2yk9~hxO`+5;guJ#nS0@Y@}npik8&0?lL|;+xrlol zi+-PloUaJcFE5J+eel$X!*ymH$msF?QEk?_>pMEgL89S*RUtIv{rgK!%$D!kRzL3d z-UoATpP;Td95N6;Dew}&cwJ@=(7$e7d~+v5E>xDM+?`BimuzJsf;_RUdu#-!6c}M0%G%;plvr8~o-=8eE`RdRNwd#L0^6zB1 zIqM;4(d;4+2mNv%Pb0?RsI0p=W3EYwilSa1d|unJ14rJAjn^Y`O5V&`H>vC8HRCEN zCal4$-vL62m^#}IrJo=(+Kht?h8>G{wLFD=aDebL_=!&%dVX7j>Cc;OW103Xn2Fk;MCQYIi+urM<0@qYnt;+sk`^ynH?*6$zHpalkuh0 zyO`kBbu=GDr%|F!YBQkTTW{?_5G6E?@Dv)Q73-h*#2(=yPEf5;d(tp*q^+0&F$?IU zVVYjx2te&kZ1Bb@N`o6+x2F&6H`2fkkNwqgRf?iy z7?p-UOYg=elp)2cbzsO71RkPD{X!LVQUBG^(Yc2O{jvYlL`K?X%<|0_T?)Yvzjc`> zPZWtfJ%;P_wA$f2m0o4H(s#XPF2kijA!4yRH4yI}Rif~b-&BGoQ31>5<3M(4;gVCY zkYkxq5yF#c<)Vptg%QmHYj>!1)=GpbE=T*`t&>Y<#l{88uL74QQ#l+T=y2i#`topA z5HdFO?oXnocR!;2wav84g(bAXze?Y?xQV)1jie*R!8IHd>z#+>EDgyd`&1X7sU&hXb+jx z0jCQNCq|#B$itG^xts*!vTWl{|#~w z>uZ-9gT{Q5HTxG5ru>s z3%oCZo>`E7Fu_*4-`k+cYCg#f+2HrXeqi*P;Y1BB98#-virv#yWO49O{&&(P=@Iml z#~|IWZfa*zdgxH?tC(q(%hS^zAF^&h1IN-6X0MO=cK277gczBW8hOvH3TVVF!=ZBo ziGIO<9h~_%YyvLo^@i;v<~PQk+cQ5nZ#ODrlr_*Q@)$za^GUvmd|8uRbBapK{5(&T z)u8A54Q&Eh;Msi2v#H9nIT0S=tvHWp!8koK7HTsOgTlP7ujwu+p2%V{I;p5!9kC|Y z3tm{Ws|7$hIMjHCvK{jIdnq8j|7)XJzQtyLciP|Qh5IN*qSgb3E)x3zXh1m8HZs$jac%|h5r+~+Y z7X<=JPkA6H)6ZUROjc=$8>U%#F;`xH3)pR61abWF9Er9x4}Vtfrodw8X|?9{Vu;-q zesKC!i`>MOQ=oI+n;_~f+QBPKQUE1>(W$}jx?~3lbZW@9Bj=nSK6e|^mGrmEqH-M} zp)-3e=oi7v?7tJoh0~=KTez>w!crfO%X+F&b0Hc2-|#!P4%K33{-@f=j)lV-vCsuq^qiZ~L$^g@ctl6^)ic5$TFB1< zuEU0Xm>BBunFUzVw(M@^hw5EVigW?U?|+>bMObtPlHHs#B49*c`W_ddj0+X?QU!;G z<=dm&xY$P&ICxW&94c}WhA0L7Mf;CyxYnzrYclXkflmU125OX^)w89 zEOtSkXhb0t;M)lr9QL~hOyw49y)IAq%P(A!Gd6t+9;GHy9c34iD^LD_&n}#wdDR*Fz)nWWsI@2Y*hzZJ;#hTLxw#v4{kTK;#C12f8+E6bNJ5 zEIpnsAW0fOx;w6_68=uf@}aA}52cr>yMK^IZ<=j#b+I$rC6na(ccl`AIarjqP=G0N zhoJt6K*3-j?PUdv577XQ=e0z6p3KK#;%{2Kn%@x|PrHct+iz{S1F8kzg2!J#oa&9@ z4H+dHV{XzfBO;=D?@3(;taEFA-5BKbKstyUT3jXS2D-*E4h<%LgH-k9<+teN*zCcV&okis9OAna$&tYJE)A#Lb2 zc)tWaDc`)FUIb3{4sv_eqdi4b1G6Hu=anhaDCI3m@mqthqA#8Brf#051U#LiwLt0V zX|bWRew?^UMof-*0;`=^Si|g-PccwOSY8a%I2(d6CKYsj_iptyn-qDbi)^rmfb@hc zaS=DzL;?{9UF9Ys!q|wj<1}YA!ehB|7p|!cT*qsaZvxKm9&ul`7er>qvqlm`t^aN2 zwP4|pi`J3*mpPf~y|0jMBgf2mRk+?v-bgdxGd5>nKkDrW6~B-;CHji@81};U7?GXl zfA-b?jJ_MO?;joLl1{kEJTf_4o@Kv@{`rkiS=Pys7qaI`pWBDA2Zutg{=Y&f95dKh z&8x@`yc#;3JomF10hm7@UUXPIWn8$&^BsZZ+9k{YMpOrP;%C?7(3_9(hoxpp6iL>p z_f3g$)MUR0DTcoRorU}wa@+HHF83gQ(sQrXW8+6<46Nx!y4+$ha_CpJ{?T0?SsqlK z!ppesSD=UVg?YpAwA7jy*beR}u;wW_&s=<-?-j!@M7x;2A(#H&wjyr+F@B;ND;L-+ z>$UT9aXeEx{}o+Gf%0CI@C842CHW5FerfFn_Ux>@o8eyzW^olu1O8Oiw1E}P(pEsw zx>+*Af&+qa?W;7!xh&DDEsg8@T^Jn5d)%7WAKee80cwj+KSoBiSQ+QqFq5}NL7GX{ zi*8C+o zjbk|z9~P@_JlNHju3h^8$UgX;ew5szQ>{P}1uWbc*U?gq39B)$NKZW=d&1csx||I; zMj_ZRR6GJ81uSVoe(d2sjR(B4Ea1Q=VXQfe_uy^J-tU4%ODLk8UUZE}oxNW^a3jvm zGC~?9)sv3@S=R1GYZ>3_XK9uVV%tXHDO9650Lr{piI zCQjK*jv1Xt-or}FS;LV2-$Ag503$BQHdp3j4h+74JRP_q@@* zIo~!b)0^kQexS0MoS^INL9y5S$)GQ~yOAYUgzt@IR$jMnz~1oSa7Oo4&HkJwvTYqZ zDM7Q&4Ecy&xOO=bXungWIY^@KOH`OOcW#qX9EKBz*${c)vt)MhC6ns61?|bd1Zcw= zx^L*Gj@;BnBiUR{pnCc_fU1dUJde0`A3`#kjQim9B3ni@ML%pYEti#oqx8iru;%%t z@9p&7xoW*>(d(ddWafCcN-z-;ssemKdt6n&vpMtRC?o)yYWby~sGn$AkLWXafN zO-QD9({T*d4rdw5@If+ol{DncU+}|T1@8%0gbX%Odsoo( zW<>ucF-h{C;T|y*kR7b&^@^>B9}iuvJd(~-u2 zrhdz2rcg}fUAElmoh>-c`?Am{2VZDJCCUfzeGdUK2z7*9L|g&~!{s_H)Rd0UQf~8M zB1Ggl)NwTefMjyvLgrk^SvE7XSql8Usvyz^Fw&3C2Xu(JPhQT3if}rYGR?tRs!H;% zeL|$~Wsz{a>aq)wjDh^vU+2oMP2m4<+=20MIw;+5T5!>FA%Zn*Ff+QE%8f}SOdscZ znWBBgZms9d28U&ruqv?ecFf^7dJ&LK0;&O&w3XxgL)FDZUd}}Tve%B3;VW}Iud5kw zgdKbY1Gr4EpA+!zuVgd6z~xvrSH%%0=;cJRvRo`-C8D2vtT;=29{0m<)x6>`0Utlw zNWieIi_56%CuRAk*X+!U{oPXJ-??~JpkL)-VM;jHxl-hLta9|Bb=lakZ(M2Y71UI$ zICX8VkXywGU)w>6`yk)luyTdx1|J@ z6axTRN5(xAWQv?#L4w|HbIE5>$X*=ga^3bJN(v5#MOY;WbJ!!C?N)mtXi*5ic2ZOMNt zK5k-A`oyg7cE$oqLn*z`YD_&$5xJ}2>HEf3I>trPDh1jyBl*^y&CV}hmE+xwv|+li zWi#J2CwO&W_u4A)o^8tWl%^&K$9BsUr*1jX{?;dtR8ZYRAoIh#$ZUDh&h2B`sUQ(Y zq-IEEZ81&s4+?R&?%UI^wpkuAe+hSVZfxdU;_P1jq}Gq{rj-%YcT&FotVzD6-BSNT zniX`$ofQ34n^s9=;LTVGUH&CkDaThmdX4yqk!Tj$d(nYW6lU*7-};vIIK%9oEIPe(4PB7`ARr#UW*(B%;lR^AGVcosEkwj@ZNY;1UxEWWFZedDssw zUiNUq?t|qC%C*e$9N6f=#S#9jr&RKeLfZlxc!+SWU{tv#3>JZ!p*KmYM;GOdJui0P zvD9rr7NhSEFGT)_+{wP>0G~%V3*IE5dWIkzaBcuJc2=l1UP-kOX7G&k#D`TVWHJ& zO2;{Bw(|1B7-lNHV>8#D;j(Ya{zBrNtF}*CYG1b%%_lN9q7#YXn)s%KF4Y}RqgS)R zD<)Di9p%of(e-L2&Gv3VOGKGeAtGJ1g~S^UI+_}$0ZZ(cL7{NG>kG@1dUiCWqwhsG zrVP?6nUNIQx!&yIm{9NphlIlM%`kH6$>j3YLx8u$m(Gh*i1|h(_*SU}Ab66_pF;nP z&mvozn&Gv^Rl`j_aiyu!FxZ7-T>QDp_2AIpWskVFsODFN$8P+Z3wN^^0}0Q!OxVEyD`(|(s`j7ku0_G zPl>@b%UFHb-0eeP`&B+9bae@KIzR)nB*qXHeOHPac`nxu$Di~3%d?p!UjaR(j}Ajt zC@Mbv>FmgK(3U0-D^Vy$e>rHyg}ix|RTu)ObJMM!B`66}sp@o!zB!}THVjE+YJ0ge z^x7dy0=I(PGrXC@{Xu+Pc!~9gN0zpk8Yw@UG&m6pD>SKv>-!;8&9jyrG6Z9m9$p)c z=k=w7(rl_D;-9^xwH=tZ$Ubs^F=JE&AbF_@*(KT9xOc$4bgXHdi*N^zfQvY4Jd_ae z{Eezy0G`gHDs)gl8#+rd6Lo7YwmKWS?kZS-I+Ex=ZJBPt0Fmgig#SgBEh;>mZv)h^ zHejDYJ`iIlmMUr!A0i{KaD5YQc@uDa#Hf0=ip@Y=3>K)KZkq3ti>rVcNl^}X=dnPB zv&t8PbS@w(y3Grx?^2{V+n{pc+g_=SpJz>4tk~(>$BCt>)1JB-V$=;8_O?ZZ`|m9? z88Q+I9m(0VNnJPJ$k~|v4(k_RU5I}ItGn)>*|do9T{i5EEw2HF1= z>qng9{}pRVp#vpZ{wiRQ#e?1Zvz1RmoEns$5fGA5r6KH*FtIYP)Y~Mcn$GpEE$NU( z_%8ixD*MaKbtS0EK)WCLJ|X@6sl`C>$q@Ht4k=*=;#tm;tGyfmvT<=9muIn z;_NAl^N#Ph>pYKn*Y}}8LwS3Aii0Xg*MYOxBW_&M>S5rM=DxMeTRXuiWx4S_#YWsw zqC>eKG>mi0n)OzZ6z4V{bIWQ0n_QK{^|RjsAN<#KxgXD#Z5~(U>8t`vKD2mtpNR3c zQx@;np!E{8_`2d0kVPtr{P#r@K`_`QWb{@9LUUWBM6w&U+hTS)uOw^u{rupxVZf!_ z@2GlckN!-0R#L*V56PVy2EM-7WNel!bU;)OF7B*&9A98fnCBll57#Yx=MWk6y5`6I z80PdKYBSGkjZY2M73cb_ujL~H z?grWPlL}d9sL2am+!+B0t1A9;*sH-TLKvHB8_VNh)UOxAMtLZ!-=zh;7(4qNRa5JK zuCOj0t3=$pJGc@egHS4t2Q$6W!%B5Y#epmS4$05l_+%$7PW#M@%KlP$^0NW?lnhED{Wpuk ze^QEd$T#~)Q@33k)C;$*8Z=J)#1?GEOa{ki^VOxjQv#M`@MjLQytO!3>NjP!F|~Kx zxBUkRyufGpLLDc}##ysb(*OPeFz$i2=A9jll3Tdcrk=2`DT2nA<%tm7?saktuOsv2vuU%uaGCmgP8*LQ%>Kk)C5n9SFOroUk{dFL zJa1(sCNn8HprE)sBQpd3BydFSogThAWP`{o0?n28neAee_}d6nHRA2v0`eaCk4n+3 z0iq}hWdex=2;Rp=usQjbX-75iv=okqIWzP1hO61L`|G(D_Io79a$vjD^*B7nlbAXW zEF;vnlLV&t?<>mrw2$Qh_@PAYh7+#4)W4Y2Jk)_2E4h-W?%^a0V4Qj)I}4^a{A;Dg zX?!g9aMk>kWKqGhmAsfEi4+O-KEbTMm*;fpZ{mu^Ancs7>u5^BHCaKCPsgIgzb}qm z+_)K*1#I81r2pVq|P$zWv` zc`@c*SFJ`+Z}nTV%crW{x3;4@IjG({y7}P|f8)O6M~d=)+;`(*QFqg|3~k5%fCwBf z&^3pfRI!B_DGsL+Cz>5XA4Hg{+afhND$g6K(enC-QVnr>wdG!aKRf6zw%o<>^h1p= zUFw)BA^-IqG0-mCz=^t{_rbA_`EUGaKwYW3?v{{YvaXe8BtX5N_T576X#@ z`g`<8k5CBO{X8qUTXD@BmF5a!%9V;qohuc>brBqDph%YU zub?FvZBqWUTz`jDSrMs?_qU+?KdhooMV@u#tYjmmN_p?3k3(krq=uy;v{9Z$2~KIK zcWJRlgEG=(Z_SKia}(Iu8P&gAyow#WV4gme_FyqHP5<3scc$`Yy_K@Bh47;vbJby9C6n}odC%@q{$kmoBIqhv zu>pr=>u8STIbF&rGWeeE{rikcE9tR*5$ z3a|vQR*;x>%*SDK(j6jb91v|cpI;srKt8Asli~tX1jP>C)&JVy6g#(R%D8U!h-3IF z#mmAs-ozubhV4TkE;OB?xT8o0ppS|UZwBJ?-|3&sb3ls1xiQZB0C<#Up-xM6F0TVbK^KPP#61S z4#!9`PpABJw2vBL;hcRTgh;kBI}=d)XV|U!*L%bMmJjde{$f0-eahU8F4!S@GQKH> zBkJCk8}Dvjzyny)XK-bz=pmaXr{1?5wElk{UJP?DQa0f8A6gbq7p*8kg2A|eTf-1E z!V`{{$u18>mDMqz+-E|tdG)vUc8V>0@&}bD%|Qyli+T^|pAVSN39yj;@8!AEus);- z!gnAnyu^&B?XuW8;f71bH%+k%@)auiZqc}P^=xv;T=%r4dJARpcuKF$gy`wD&a6SA z!sB_pF-y#arx!|6;hboPU&RWg~N%&pCHmosDuF)%00-a5g zD)XD>sXMFfi%etL*}Ev;?R-gDJYxX^Kt2)^sPW?>Kd9hSroc{+rc7l;+Gnk2Pwd#p zE>+$N^!Y7>y>J#(uVlvK-YSUgOydY_hkHC-5&Yg-Lg-R5SBCRZ`(9b^JZosQV%8Yn z{*Uh6(A2Gn{Jyy_U6kRO-Ya@SO1pEb^0~tk__TH|zk+<08XPR$x5>`>S2U%mI-hIg zOT;@B3KXsMz$2&u3}S|@R8BGUFRj0t>qp>`c`f$h$pV8YPBz~rBJ(*|gi*V7ClvuzbT$Y>w6;$(k+TkT5Eu0{taWZahJpT-+H$z0{FnOhkBG@&Q~|Da(?(R`VzOvI2G!I zhWX+EwUge9BvgTe*WJvUAdl9tyfE0b!^3T*O7lf(phglmJN1-umKs=b?5>H$^!ycY zz{bGt0+#sNHvq-{_^Y4mFcdt1$LJaZ0B@pDw0I8Up0Cet8&PQpphP+x7!~`SNL~M8 zTXO?QoDOV(leTf87Vbn0;ih%8tN`!4sK?lrJ2w|d5r|l#8yd2CmWpiQV%;nZp6qQG zCVwiEEs*HtWv}&;I9H^bL^;)0d34JLMt^T&Gy2CdUlx5A+#o%hBteDv6dr3sOVCZ(-uA+)uIB2^?oMfS(2f$bKEl1Y5IPD{vc5Bk2h|*O#$K@zgX|L6=Q)Vw}u8geN7K91iJJ zu6qDTNLe8TVYCqWCq2k)@miAhF6PDS1aBsk!?r5qcZhF-8YJ1#@f}SK@wcpdy~_N2 znZ&sKm%%$p^f zWz}jU16<2Bx?$R>)0OuRKA)jWe_v!Q(fk^xnZAE`Ug^E!_UJGrM!(L;tK}Qg9{4&D z_g(w35Pql}T9~^sdI&gmf@@wqJH7$^S)oQ28-mw%U(p zdn~mNaGtPY&w6rDv0{ujz%oe}XQ!S9v9TRiH_q+`bP2IusH%m>lRZ>>GT8D<4rCOO{hTbTBj z5~fL@t%0a#8K^^HUDpAZ&zgcJ4yu9@4~T;qX_=1hBpB_FnP!T=JxnFm5XsreOkXH| zK-{syt#|U#;=)D-HrMrV;n(33HuF&Is`Zw~-tRdFE4GRV{45}Ob(xvxZQz5MV>Lp=!4XpHwBa?hhBACN@rlpT zu+r?l`?Wbg)0YkrqoPW0E8HJV#^1p{rvvR6BVfWk$f&zbX}W#0(-aY~NEh<sBfhdJAyijz};}ynLdWjE|#fZX9zzOcig~F*~*y5q=^0VEu5<{LQ?}L2!dwBan_n z3D(R+B^5-9atr!!P!YJbgDo+dT z2svD)Xx_OwN@|DeeCtjE#9QBh?2tS*21|nbIAQNpaaMweXjgC1AgC6sBsKIy&M!iQ z&lw9AhWoLSo&wrOn6b%r7dk$ghzyRM` zH`ACz1fb^x-gCfw8HK|5@0iDpAO#9h2ZJ`3R)o1;zc2YfYD5@ci+tO{&;Y}YYG=XS zPC4qJWW=T`q!mV(T7TJ}DCe3Vl$+%3l?#d%B0oyleZ(&x6Ws8I&+6u<@0Ak)4vQ0w z|GW2pe(8Oy362b?eC43p*khjE4hNMK^nIAI>SX;>#P%mc^-So_{V^?k-QzTLyP-w{ z^LB`@e1zb%f@yF2`Wxd$Z~YJ#jx6jZ_)Mf>>N@qG0yyl+zRVa=(HpsUS!2e>4Mdx~ zIDwSV!$J_qh(6E)HV0By{_u6Jw*4ebQ%iNlVn+O8Cx6KFZq#{_VaQ-N_Pd*CZU}uB`1qiV8zj{VTrVpB z%MpGA$zo!IT}BL&XXoUogrS%o`~GF1d79(JL`#aa51U~{{~;pm#3rK%dJFRhiL%O% zew95?mtr)}c6`)@eG%b@5BKok|72!H5trhBfvlUT1VCC|ST8*1N1wZiW=6SbScU=F$+ zDGWpw**~KSGoaB1O|Qp)n~z@Q)$!t9c>^#Usnq@zCq~>-Vi0$co&>)j&-w~3_?>Lz zJ)0x?L~eee{BWl*=&GM_ysfXw$U2;)ohTzx&0^N!O`pV@MZGtKmXMG zJ?15ZJJ)+tfrhoZNl9sXf3k(orNKcMrI)?w=|AH$&q7nv>?TB+7Ov+gTKes1k^s}_eJy2y=%rq9(^1Ur05^CE8{&4|(Nr(I&u_sB`{E3RjPm4^Nj0vc zHU7A|#&vwj^QAYV>Fj&_qm(mJ{@BZo6)Fy9EJ-C^TB&?3V|j0U)txJM_~w0!;`Ou2 zY}cbbUdrKWvkxm6F(!;M7#@6PxJeF&`C5Uqr!X5M$ZST^Da@vWBrUa#cy|}Hia`N) z@15Wy6@}*2U9EJG$ErCI0X^Q5c_-vSqsgetCZl^?Bkwfwm8gai_4o?$mR_BK6|zT} zl9k+rF!dk|Z>5${P9E2rTSy``KH%iSr`;?*7T$vqG)(E1d7w2+KK0{8y$(Yp-w;Yw z;KZbE{_{-E$Fc>ckjj^gYUK^Q_x|)*R@YLSpK9I04zo7SzgWK}z+$<<|4LE4fied9 z^BnE8{&@lGLV_OU=WGi+ReV2}MVZ@aY_*6FeCBkL&ljtkDA%<%&OKFG9lwX%sO9ON>Bq0$K zm15#Whgs3c!}AZuhS{){5uu1{9cxi{E&q~DH&ATICE>Ly!@zN|qu{ypeSXQ!yLL<* zWArp;HBe;N_t-J!=x_qNs-RO)~1YKL8~;nx+Eb1e6;vqc)0HH zy+y3`e607>sgv;4akYn^3s$Yr9dZM~cFy-smPggpo)i}ay?KG0{}vK(a_IOGPAcyh z-TY11*g}+D?(Eayr2cy|T)Uz`RXAQ>GU>O1VDELt)Bf%H*N0jIS^^Fo(P^?b(XK{A zo*d|`SN1P3$;H{?dL!q2F#3ZT8}jlK#Jis4=Fc{N=6a;O zBNhsS2GL9~v3UNiKuwfMdJaJrfKd|on5NTdx}g4#rLT;N>V2aX7#J8}KuThU7Aa|@ zB!+GVq<%DlN=SFfz);dHqI64l#{d$N(#;@Uf)Y~VJ^y>}S}Z>CfpyM#pZ9t8-p}4J zGu+KX7`47+X>d5oagzs@s@o#S%-nTfA*tH=W|ae6!Wqa4u6#oRn7}nLnjL<$@NJp74J4X*Ww^(jO#Z0?3C-P04?y)Mf?fW?ot(X+#ft2 zLkq%2nb<MqMrO zD5@yVzBX6RQ_-5HNa;(SLQVhJ>z}qKX*dUK1UEE-Gr^Ssa+hlT z87L-?Qwg8!@Db>Ztee1Vu#LBXUoz3qt-zmD^jEyHC%y_1u#UezP{z*?=xw1*vyDuM%lDp@Y~m zEnN1uJvyjegT)*>HLg$}D&QM7_un-wt)yxUcd}cq&pI|t>-gQl#9Im{Xz!EJ+*0C( zNE&3Tw83O7eptkNb^7GkZ!(kYFL1L(bu3x&SDJX42Xpk4A?pJ5jGO%WN)=m4$$j5c zv(-P(q#U|axN_m2L&Q~aZ?=nKt{j<}t#C}MatSfcJD$8&I!ZGLLg=H($vu8v@5y^F zu*)JQ!25Kg@_*%pk^}KuckrvQsGhi84VoZrBJRF4H%VS$G-79Zj)N%=Ajl?&GQ;d; z1pXBNvi(kb_4d=B`0EGR>c{Wlff4?_zV}#cJu|rb^%nNU3IDGQaC&IUCr<>`BF zf;;cp3+BnH+XU|$f(njCQczZc7+7-eskf^I1hClW0s+7Ezq_78Vh@~d>^j+C1mv=^^nxugCo3h_LpEv??jLy zZ=FApR7OQg;HO;=S=0Ov1lK}^&{@`t92i`zR~m^Z-GU~dGFs5JiR+jWPBV8Z=ZYsv z0fy&;aW{oa38sfcN}lDiWjiUwvWMd-<3*{!@jT%@D|dRnNK4Wfu*{r&CHV$Kw35Q2u8jGmao*G1SB^Y2g(;&2Jmk9D~VkMdNDKsjew=Bbl|K1GvAyx2l~L zLRg>wrvLskz`r=M7HA)*k1)t`GO6wNUGU=8b!l^+o?XuC{0XV6E=rj{PLfGwH6m;g zpNnbt_cEIJd2p@zD`L<-D`WLlxyqdpehLm~-R)M>plq zoK#@PjSFZ0;{yThs<4WzAm-Tu7))5u?890cNzH!P*DyQ)^B-M`wST?&YR{i_*?Yh@_LKOi zfK_q_8~$Fi-;(SDM@y^t2nLX&hr4+o=ox=~<=OQ8hT#d+?aui~Rsu82i0Y0kiuXIU z&Xaw5p%NS7xan79LlJ02wVu^Sa2ZBE z&mXC1OVu77m?E?n!!x6McAttSJ_~^dT7heOTLvF@6i81+ineju50zh+9wba6!z1R< z1N6x#4p?A~7R96}S#qhx5Zbu%c3Ig{ z{W=>wR|V_&$f|*A3ldy6TGqEC*d3LL1To6-6<7@=u^mN4&oU~1LZ14_NLG<3p z_4MbugfCA{0tU*sF5dDH1k#hsP(4^p^mi{Jra6s6AJ06$CC5FW3JtLp{+dID91a57 zW+A2uN~2*cbC(dLCEkXMdHKT#1ajMxmNG)#0sX>bYUcNHhsubNNPH7^H-jPGNrrd$ z9%9qfpca{1xgBxG)v%dGM0_v43a}jZpasimcKBz~)yXO-S+_KUOjY5lzy1u^AQ(9- zm8xeKm4uu>@%+nJULY%RQ&1wCxl^gMa=TNhb10prvr}I4zBeSulDO^N!=D;I-;H#p zp!q-k3spPa!u|(+rT8-(0t4%9MaMJyv&JF_cWG!QkV72zWtFhD z@{8AF9=pmMu?eRb_uB6^;y+d+JPjMBh)r$k=|VJn}t@vf~MmlQa7I0u;q7T!v+4`e%&7O}|#$82AL zE^tXkA8g5V=VjwUq*DoN>^;~w00c0lF8WD^1aiZ$o&y#jqwC>J%4iT1Z>SYruS(*? zo!!n8s}SXb7)Sn`fa}Ij=4_yiTyqP_*&+k;1!UdL%h?ZxLDnLV49~u@^TpBxBG_gl z*UvZPneIPm;`xJB&Gt`@KD5-22KrXyI9{@MSknLT6jC)6oQVFFJK01MnR`)c+TuG&`ulqw zlh)y|d$uM#1)Ej5-Zobd2@+v4GZQ|61wP!u5?cn3$V$?7Y;AbZ2aaN@zwbh2A{Ozy zbbrYS1Lm>Xcqf19p=)*M28PXF&LoCQk=7R-{&J(W=wnl`qj$}QU`?V;E(^EWvcblr zIj>z_xR#C8>lgT1S(4rk5X1)##1$b97bxhV(o-o_`#oh8s9}0wOihjiWuo~>`uqyt zpFp=LTA8}EU@O<8ksN8C$#u_NlONgOeg*_I8}SHKm0x4FFMdy|7oz^5wMx;`>c8iKNtnlCh~ z;QIS(^UM9OCiE2^3M`A)h#c9DEA-O$5OtSK)*w5 z5dx~mHVXwd1I0^aM@6(1E`HKeQ_*MY5YLfADTWZ}2!y(vxGMdc4T*kSfL$q_&t86; z+Z$s-nNgHZx|<`zpUKIhVXmI+IcPv4gk6#PkJaO6Ihsy4-oe7^muIac+wO#9?^y+U~@y|733B|PWR)hk`HnJ`KTL~=dapQf3-9}EG_WD z!I=k&(sq|66JS|W$AHfc7G!7TT=w>wp7>P__wksSvH3$Iquc>r{ayBHU2Noo^ZiUk zcIHHgdJA^UrG!nr-ll z*nDw?u|{^BE7iS!vv1ek{{=8wk)&RBvST#pWu8<6)o=O(yWenK^+V8T6nk)d{jPZM zmdEvA;!z*%6}e_WULlLalgHTaPvaYi)o%p?G(({rnAf{A=;dtpntBHbqHK3^52m=V z=LFxOZucuV(N6Vn(Vw{D@TdZ z({z>UXf^7NXHHCW_==BwHz7xyGl!{B;x#wPHppy!a#yJ7k33vwOL#3z?ZQUV5NW^8 zg3I}NH`nh=fF<0_i|~BlJHtts`a!3C_7m~@JHdMj67)Scr0HX~8ZL@6mG_R&EZ`xS z74z!}FtC!_SdAaJ!5ix|G|Xrv5<*B5Lbe|j-1kDi!8(wih%50e&l&HEFCVo`Mrhb% z1g;E=fF2z@ZCP2fps&bt`|PA9_D$w^ho0k0vxg*2pqZ6`{z*E$4Y^~kfs0ZI0Oxmu^|%Fy5d)QE!|kF-=Z28 zQ(LmGr%+*L>hHILSH8ksa@#D1gGBb-4r%eEstWWGUf-E{8 zG^45}SMyVnu;rl5AaaJm_EZgLUYcPL(|ki79Mhg&HgHjE&M0eqJ=5uvDCV@2vyI&Y zz$S6$uZgHn3~rL7VJNxw_m(`I#J=w22g3#>DuW9qyCEt5?gpkyA-Wnm{L)Iy_po?b zm4TdO|Kt?(Tc!|L>Svf4==(|xW{=qb8D=#OjrM`M;}?Naq4&jU)eHUvy;o~B~p7ru-bqrU;dvV8S$3MMTCbZIWBkM##1R@6^YVyha0#YRH)fl z>ukI*ZnD6s2UFm<+E$VM28R0@fW*LMfn8KVi~J;`f`BkcS>86k=2Jga0h)t|)$Tek8MmZ(b7GawZeM(BVdjZ2^-FKU&1V zrCOLopQq_vC_DI8t_^X1Ww++SU@k#G>w$wU=Oc<;2Gic(@<>NnT(ymt< ze|T@Q2Ww8kpIPTy4g&~gFy!ltj9|~xfe*I=)e=!47;mUH>*qS3!w?@ugpFvfaQjk~ zX?bO3o6x7;iZI=8$CJ~Bu{BBuBF~9_CxKkTBAn@b@hQm5PYk2DTsC$XWR!=BT74VC$3VtvC5xUSu-ihLOF4mS; zllAG?Rl7tUE??fbCEBZoT%EzTRQ_3U1AcN!HdgpeqdT<#>T9WwgkQpKI6#ToRUlEF zUI%%rhK}9;zz+_Fu`hfDR%kejnk*=mNAW-P&kd=&d;+T<49S@(C4RRAF_u4az4Y_o z2N`*TUTdQSU3ajoU-9R^$8IJZeUkX`jl1WOf zr}OX*x=4(_%b7FDO#LC;FcK~@jHmzt4V9N-sYR;J8+4~BaP^4Cd>@@x^Vp3|TTYCn{P$C` zHT3J%%LIp+;}_14`xZ3HQh`G-KZGFkHF~=x;0ptm5e*S4IDdYrN!vt4DJYKB|3QjZ zW`h(D%BoYaYSJn^X1R6A`id%G>-8BW8%tKW*_rd`)F$6Semq5K!Gp^&w~hRy0lgj% zaCODq6ni1?&xsS_@Q+0U-GYw95bn$8&nGbH@V680uC$_eH4<#ouG(>_Mi<`r;Kt>& zh>O>iNf8hw7W-1#X6}N0u`q-XJ^Lmc)Uc0a1YE&?U>U@O?&UrBLxR|P|GozXQPmE1 z6nu0|5}02f!ula#d@0WRI5eZwUJZJV0Svy$pm5yFkLq%Bg&^E(YSzUww3qWdS^0JF zt}(gpB(`8dqB&S-8Xh=^f}Ewa9&o`KFAE)@2F*~?;QVyLFHvX|aYbfO0MB&(@vanZOimIo*XfLgj??N6mPUF<@^9D>!{ec%t&~9_7y}xs6SDexIad++9>d=6LsXqU+V7MrQX8^J8XJ zz>CgCe@aWp`YWy>_F3sZQl{tJhzVE~5@YhHNn@g^YmHgr&3!Q)U%EVLNTL&Zes5I% z?X#pXi&fgY6=)+51i|oB-rN6+hYz@6MLwq9OZLi;vAW7cd=sBk4}4&PwFd{VQ7HPZt>PU2p# zK4#4Pt!VA+;MOYNvzws@Q`mM-0H`Q_;|Cv z)b7E%0kt+JQ@y zeizoJJd1#dcykeF?1{anLZ0-c_?s|fDBAY456pAVI|xv;DekKlqWwcaid(v;PQs2~ z3T*DUhPozABR9A`jq=DAWL$oV>&cx@v>r~ZlB?oW$08www|rw)Q~jChz;(+-93>Zq zk^r$c{0l|TQ$^i=j5zFr*{gCSqxbR)^9V>cu;Ub<ZJ>T=IM+kLwW234Uh}-e@0e+cA}q3Ei`G|y#Q^$BilJ?S**tN zF+!`D+9u!~j@umEDjN*o?Z{7CyMZjs(uKcipiSh+c1H^r$Ts;_C9QwY{v~pVTx9S2 zIvt4p23gXY@MGeDGFOa6?pVa%($U;X*jZ;R<(V~Px-_secZUmqYsVh#Wvh-epY#MD zG}43TF_DCuj8>JyE!zd$A-6SfFpX(K*Q2p-UQ2G0cg(!_Qozd$@SHGP91TLkLevv* zcMaOz^!4+?h071itKstW7F?@ol4ihgN8Te|wt*|-To&j~Md6BcC^Z%%Cl4tt4KPrm z7vgB!TWk2Kc{cE@EZ(I5`?OCs6#OSUC{dSoNotsEL*pI4ygX{}&+{Ae{_fokvWL3F z)WZp%)m{uYv*Yj+@zuGgLAwS*BQS+mwv4grZE8E!9+Pw@iAgNtr^kZ1-uvvK+IaiW zhA+%GjvF(rtBL3VUv30c^4w6{{|VjtNAD$Q5gwwN1FW;0=j_y)wym|Cmjhg}l-HzP z$uDpZ^382$IP}Y?6K}`s;J-7H06CYUFCB=$C>Um zo6~nYspu)0YnJ|Pt=85&u!sxGPSQZnMRvAT0b`ik3wwc|Rr(3?1(Bje?74m~Vr{Ul zhKSpY8r^+eY!-nYvF#}kDZF5Eq&xhtfegxMSiEH#b4uGPptL8o(UMQiYzQk zskK6vBarVk?$YLCxJWTYO*TlGNFFb-O}UO8y>Ga{UV>SHrWrjuTPRsYqx3>4`X!7y zh)iEG&u^yERBPFdSP6d>&zu3aYqcCOzh*kO*0k3<9oYj5EQmQ~5!zQv3hqN-ps)8& z^c7Q1X5@d(-^u!%J_ld(H3FUP0wxpw_KHR{%u20!P$V3n%oDS{gCuDR*#OR&G}0=L zRnjSvX46o!#}puns5b>&niU!~oxft+bnBojEg0GiYm$oQEh~KR2fu$t0HYr0Rr3mb z%jhR|`02XqHtdsII9iBQ*6p+^?M+Oe;}`=N_~Xu2d(>S`O?34calo?_)C1t&4jt_I zJRm3YNsjn2cwK)IgqsQER&g~eJPcLdr)zvOn?0aJ1)UTg z7JM$&FleeoI6ID*r!hbN=V!Li%3dZ&1p1RSQHx|OFg?E_1TK_fA+qowQ%xJI0bt~} zvEmq%YsFKTAj#n_Rgz`9Qgh3aX$V+9{+r@ovQtLnINIM&;9#2xIFa@|^9-R$_IKEF z!c(cT+H8;QX1@r@vl_xr~nc{icGL^3(&5mQw4l9v&M*@*9k3<3P!8K1EYjrV) znU_mNv$U}8C!+tpZBNnlEs8JlEM|caEz0I?d=vlez2{c&lj^S=ZInD=lvj0KY`T}o zSm#%v%%11s1LL(lnA+TpHPOf(M%)I{z&E7&q%UJ-k;;k>|LP8qpC+(g!)=&5Mv^Do z1#Yu<_|@*&235r+0FE5@rB-x_vA`Rs^0v8g$fw*Low0ug&~FJEp1~i{zg1a<@q>)l z@^!es8nQGi1T~+3?mfer+XocI9i4^KrE^?N43H2?!(3una3sL9rHdR{>7EQr@9gJ1 zJxrQM4@8~5rkZ}qRqb*9k96dVx#+FIG=KYQBt+5`nBv(pmDi-&mb`LYv(aJ!tuAMo z=s|~|w-_$)d?X{TI`|bZDQq|4pGQ|Lf9rYl$1X2Ti0V9SqjU1wzVCP5x-HWW7uEA1 zYm!#Cp%O?YlK)tt@*+#7VBX=J2vX8P$?%cz{98TG1UIbwRMR@Mcg~|ihMsFu4@_HD zAUE8Gn!B-;u3Fnd)GpF=_0a%FKyUeuS@S z7~k-z%`IV7ZYt`Hgs(io4?lnix*Tch(i5b}Pim@nlAVrfZNeiy7I+ca+Qv4i@iDCy z>}Ug~n;h)O{j?H&?Ff}A30}tNcp%@ICob0p=USE3 zei0K5f4hKjlcIuF`Oy{%*5nGhTJ!)T%hCG(xbn}adLS!^7i*x>W*$6n@EoiHo^VgZ zUx8VAxKg>!XSpLK5>bbEM5Tu4ml6Z?dQ#*+rfW?fk+I{%V6f5rCp zF2b4e{(IEX0Jt>EU9`N1JU!%S1oM2^rzia<35>0&WDuBP?y`IZjbnJj>qY+a-D@DsR^@DBmI`jnx1ML^P7D7 zrDS_101-0^-UmJ6t=YnmD4>&BL~vQL;)9-C6kpgtvthtTkO^0$ zdifYUf#3zI236DzwBp>lpZVEz+cST(yz3xLr1go-$=iWCNdl<1=QLjaw|3&mG(+pF-Nn(}(siYz%g0-?LFXIvBqHkKi*JXE#@c z2}v)ev<@ehS7775sG0m>h(@{9lRD=1&t7^_RM@FBlA;)lAekJSZ=~&))GfT~9ikbEBF!d~52qnr2XQ0+=8^+fYo;gAtxTqd&|J34@zJqI7ti5l%$S=L}YJ)8+;+@gZxp$a~ z(r^k>f-0v`Z9(u?#(`NzlJY09bNO*d!j`j)p3sCWVl%))(~+$_oyT_RF~)KG6{eN!|c8=dDoz3 z;?m)h>|^U>^kXSb4lvJCK0y-aePQ%d*mJmA4x#XBlpuz^x#h~sdHwyB5uClZ@>PKCIzi`zoxgWoR7kWT@ITfSJsH$SqgN^ zTm|84wT4E(f|Cp;$J5ouLXQ;Mo87?~H3`q;r74he-xtz{SigkRNDy8GT3$F&=~A1| zuu#@I!yF1VmMtW3e7?I{w-HZ+=k4++=!xDBW45wTkMt2L7aZfWJnw#3J)J&{buNA; zY$7FoMF0<3;IDBw{uYK3s9o3W_&IEhR?iLhmNY5V!pqfiJXzYyrwWc=_0x=UsajR! zGqHQxOg=25cHN2&rcsqkWCMVpPq5KNgxV$0anz%wyj`!#VZ0hHfyfP0u!c9%6-qON zSR?+s4E?fYg@ZF&3Op@lP+G@IB6{{S+zjXvk=Eemqg+YJmN!6ORFkrtcas;68mLtu zJP73AY*rYvDXT@X+vFhRf`(w?zMR8|DFGEiy}OI^P?v&YCP)F~*EGxK1cgkEu2i`l zZ&B~7K)xcznR;Qe#ogS{h+?`-Wh+{}p2-kY<_WrTSM^ys{#-E;c)qE#X|?gV`k1_e zJp2f&PWH$@%BvXcA)RYL`r5&@D9rU#{{2VKtvFOSAXr$yG)onQ&77JjQ8n%IW~9Y8 zTJDFv{P_T;f7~~>^bndSA+;(`1x>FP9)m)0Td6l`D^D)7rwOzVCA4}b$3{nGzhrO@ zUgWqYiYfieO%lKhMiPf-jHaU3>q#zy{)vEve|@&*e(oW_$MoZeOei`u+d;LuGuvID zg3P*+*utacVuZj~>G(sV7|?5EwBM!5gQ4*{yd=QOf2SY*MBXyYf-mRAMjP%US|W4H z(_*^~E85R8W#@um9hEaejDaDqFa&eft}t<;dHV_au4>Iv>Z%R?P3&Fu-h0gLaUS^h z1|WxRb!kwDVT~3!0{Ec1mgqaE(iRiS}>hrv&_S7{~^`s9{o>`jI zB9Z>@KKN>FZNzvT%?hqNP<^};aOWRv7FOIyoywY-rWj0AWJLKZ|FEwu_}aBYH=`l# z7{hnqSDKsosI-bK^?mrZz?zxQZkz0M&_3K+nXQfeqhVqQk7%bn@oKT=_?-dNLP*%; z)1p*EJY7}e&&)Y%7C~A^U59vu>{VKA?`IHVc4zdpKuCHRS~~KQsA%hn`;w_}qMsu&2Uc^gL`7kRw98ku=|V zJr@xtE>fi&+xy0+=LmB@k%@M}+2sHGow|-dofi;Jo~J!f?;|TR@I?q{=9C}C07T0; z0AkaEK8&>GiF&~!@=1D#qh$)Jvt|hvM+H^K*@nihzpCN4qlkehMb-3Gi&5#e{d(5t zGxJAif+i#-phw&MeVTYr)Kg-BUnUQ+6Xqk{E3Jz2LwcF#E}WeDv7h(o{dw#W-|aY? z^Xa>>y1@_ixb1I+$!a|*=-@Q;hiZ}C9*hPlJ;f1ot+;h;MMj)x#f5U7TFr|J;PKQh zb&fB16T`}j8E%c0Cma${RH1wb^VB9G!jEXAPL&+w%Ft z+Z4>>U1JNzm!Pdd<4EmkfQh}4?B~xWSho+6&O^ROSU>2^kyQ_rU@P}4l>R99@?QwL z+&)VOcYNSe8ySOpBF|pc+UXN=z>m3vTt5=AQNq!SaI%|#ul(ep3*ABTobzEFVn8ql zN28^neHhOh%l63RwVZ{W2bVbgIcn{=wdO3KdK5gBdU)#*uJ4^ctdJ3aq5V?OC6%;K zepM{gzFddEdHN3+LTo0pV_*5k|6Gb4x%zVa<(XlyqhE5-erULJUsw16?t+*QG(u2{ zw)=7CYw(+YUf>IhI!WvJx3u{40!g+?*z5LOPK$B_N=sU887fJv4>X=yn@r}c&IE(o0f30CaP>3rN zb+rT`c=II_b!5#7jyUZH1^o-%*$8r1_e77x0l9aSyH5anPuq^}QG_@xwKgGGkc5WD z?}^ptOe*@y$I^}aX!LKpcfW##!GpK9QJtDSW4@BIrz%h`9I?Ty&!FZ&k%__3_G7o^ z&gK25M0TE8%4PGVk>4aqcJk`U@VHAmtC5JfF2P%M7fYVfS))s2rui^Yh6g_NyC zJ_l6m+NP(DWe`Jtq9a~cy@bn8ejWoM?_)oZYioMV#5+lO+f$HKP_`v3PEH3sdh5p% zajE3A_NWNdFvuwqRP)^p{?-+9mTQ}bpM02P*M$FT`&l|q$~!CGqUoFH=k*VasztE= zCbF*tYp33mCbHP+9MTnQEKEZN5&~F2`^DRmxd9v+>-<5@s`4}6A)nn(6QV)3QvggS zA(i0zD?fL++mTQ~jgUT^@U93H zDk53iR|^W>|3eoyPXs!T7U#vX?Hmo|S-uVVbSnn|ESVvDY``)?5?%#LAjq`J3W6~8 zfDOEGGJSkfBQNb^(-!^HIU{XDP5VGgQBUqAgU0KWi28qD(88T*hh{F@kaS8%4@GN% z2i)G}*?9|b`%P^zX*G0%bibZ2v6I+6#UrDS4h#0j$Q~;GE&)O3T;LVI?X~`KE@G15 zyo-omhtO|)-y~>XKp7VitlXDwtvcUi%5IEB9!k-6xe0jGKM(WwqllUrQvvr;$nu;E z9sYs7J_2Z60DU6bwd$3~sQaI!@5Ar?@U7fH*Ay#o%r6>I@u2{r3;&y%j^{7{KKZ$} zn)mcX=hHY?tuG<4BKL?nN9AZ~TOX13*P<0i?5<%d-gFO&>kx^6*d0mwFVnA5zhDE6 znS+@+gNSif&9!iw8ke)UIi=lu?87v0X&Ros7$N6HX^=6hmcGEY^StCoqu!_VAx6@eyv zJuiRU^qYb|*2cf%En-UAz53wqS41P+`FUS-TIix=^yB0DXDX?bmkj#N#WV*LO%p9? z$IW`m{>gZ3>s}N}N=NbvKi)F-3uI7S4CQz!>%RdG<;XB%9JBtPf>|I>e=}<^S9G9eu-iYx3A`KRPDL9rmJ)2f7MJ}PtLCWJPdH8XcNr-JTpM<9W|-!ln= zkWC1>%k2>_{SeOb?nOz<<=@d5cd>6rgpcrN>bdUS@z_5yrqe4~H)@r@KJOqNmp{v2 z$(DW|2jg{UyH(OZ`(n;|t1Yo`PJDH-Sh+NE&n)|dbN+fUNa)06R;D`lN>+(%kK=Z( zebu{}foHF4khaBsnG~oTRx&XCKLJiC6#AWAoDI0b`oX2Z5RRQ-JmFzeVb)+W`Y&q%yHjN zAW7|M(p~xnBr8&w4sCoEf@Soa+$1kH) z2cTXeqpk7L+<}``G`7FtbFKnJLhb^#0JkCF3w-I&og*s<_$g3kUz^Ym{|D9M0Ez~j z7Z}OaUjxr#Ozw| z1$iyUmrtIk;ED>`=~6jB$Tc9vRU;n;#n3>&$6anq>7XO}!n}1uXH$PIfa?ffe)R6~ z0;X31{#3Xsw>2`K%zjsW4^QMr;{*`Tta+_}xmstp>#6Mz%PrvXs*(dXd2T^v=^xn5B{nZi z9IG2M1(a$0>#;bl*3Wp}OXq8rJ~5NeF1)=2p=kwQ_Pgw1N%Cxc`2|8>CFYb<$d&Bk*|Btc|D2r;7y>b+*#tvzN4*zf2iwiaC8HnUPPB z61T&FA}H66O&Re_{Y_tLB!o2lCs$sX-vwEcEUe6c;QCjRU~sR_pK<$Br+wHZpB$+x z)XZnqikZ>CC5*Zv##-^gJy9`NF`W0k0_>zo=)7PEMof3eINhceJ;%v*q(F6JC0zTG z#?+`P_8)<0$68p9q__?E$#1%Hv4BJ7!cW|G!?+an?{#~G(_f3d?6%%KcWhsjd^)M^ zdWn!@+w)=yQC%1{M)XC?$n#Y%BFMGw>b2I9-8)#>%vd`>?iP%#Hu$ZQ@=y0oL*4ty zQy+_Agks)M*RL^Q{*OKC^pHg9Es3P}%g?*VzB+L@Pu+2h#s3#kcA6NC=PvLxLf?~? zXu3m7DJ4qssYAv4(jWP;VJI|9hX(Kp-skhiPbXI8=`t`8R`CIC4af3(^>xARl7+sx`z+zJlC!6Z~Oo zaCd*BGo~H}qmz}^4KY{_9b07MWxqP~?jD@CCvI?BH<;W`GTC!jpSHJ}C<$p7#Ce6E zX2aZw%)IqSQzB33;ZGYX?MPrIKJ$J-hh$FT4cgPbTANLk^Mv$xJo=MMJR03!CgstR zD!9tjV=E5>72(?;#q0BW_E8G{K9}}>AX(u(>rIt{v@zX)%#VpTw`S|bG?F3YoFLDZ0~y(_Q7;KDnq$CGyhjA;y>4`S9g| zk%`(~+?Gi-yGQ-U97A=5iax1r$UkrpRIhc(>@M80>|C z)37`byHmLx0U#->q>x8R-BGbH-l^vQcXJlIo+cI#HY}7}%Z%NypKNw0z_q5HjUS3T zCU-=i2@OYc^8bKASs@$1EepWwqtN{DUJSE3n*CSrObmti-oWCzS7MJ+h$Q#i>E0;D z&mfD@I^?BRO zSHj>oH9A6%u@|P`*3d5ML|6rT0kG>7b#LG3(P?5VYOEIPe>~$@z6Q*%nPM+Bjd3;- zQ4Ny1$N0T5s(sAdMdG9p?qmlSOZS_U>M#INdP|S6( z$1$9{!7))3VH)2{8vAL@(c7GA(lsJjL|XF`47PxIS5W}a(Zkh$jy)Z+>jH6)weY3C znIr#B9!BC(-5Mh<`X1njR^@Uu19s})^8;y0fJ|h9EvrY*NI_vf+B!mQLn|N%GaeV(Xb1ORA z9Bc9#m;Q{&z_JY$I-@01Foq+Qeq8L=mepl;Gj!Z)1#nn#fvwb`J2dc4RHX~jcwT52 zvOS(LHQip~(kcI87;Ro=ysCadH$js z>3t@Wa4rKiP9E+>&^5O|&mB}%w<{FHeOAI6!2Me#NtR}jZ3?;d z$M2oxmJe0bBEt3-Rv482(0+|wEv4{PrlGDOyZyrw){#9hix%a5O7Yb!EG5DNJ#9xu1zWSPVZ5q6v~E;QkvU3 z(DWf1hjQ~+^%@naUegja-{oH$Bsp>8kcydihWR)(_F8UO4FbRiR-kiX``q@nEET}7 zzd3)tUt{V|XwTJ0_(;XwXN{xKHu&KvsRsZHO1_tIb(7sBw_&bxmMa?LRKcH;rs*-UD8D;GxaQO?0P*{!n6D^cEc$~9Hc21nQ%8F+xze55A_QPk>i zL%sq7k!SwJ_5K9qe`pp4_1SarC_lwbzr|+FJKs4R&Mu>3?2rsCxqbY-nXc^C8;^^a z9%*V9iYO})x&8iG0+jpPFp;CZtN)P!z}gIxXev9nyZQRhv)eh~zHrP!Ql%5ASbx*a z(4#V3wE4LH;W}$*2m|z=a!bU7L(tbuFslEOO7QRB=;_?6PFC9~vc~o;gv#DgTOz+g zqx;_vaEhdWFeQ&!U^BlJm2h{G)aeIKwX25_m7ig6zdgkRW9q&cM#;wa8t@czZjnw+ zYY?~vO(#_QZ0NOZ?7mf4%jp@T{72sncJlJ@CJ$c1hwHG8^XyrBx=NC!LQN)}x_8M} z!aJxbN#F?~Pvb%iwuP<#i+F3PC+em<_)0p0xvLi!_xgOQs0N4JK3dw|@ zdTGvpJIaN#F1IEzw&eIoyZ+pyCa5Ug&O!}jjK3NOBYa9hu&L=wgmc@WDJMrh;{33L z3I6<7f{cy3N&6j>`Hjklzu&b0(f+&YloO|$0yPVIMQd(&pgkwpa%rnon-P(=W;AU6 zaV7ni7EW?OR6MK9&UZcypa1GcQdpFzIHG!=#r)S-IJzl>r<*ju`rh9Ay&Ga9t03>C z$-|@-o?O<kk7Q?WkmHP&kpf+)UO(5$8o%07g}!`vKKTDiSCF8 zewDK9Tn02c5k+^qJ<^wDOhOS5^jVhXdMgO$8q7OKIub6h-6CaDnn-VDtbep=Wb%cg zM3;^96ZuAvXAeWQqPuCdl!HOscFBYy@fpPra3qND29#Id+}1Ix|D{#5U{+fp?~l)E zaXZ4YlJM&MIPB_wrpy~BP@J|9Z%0`d<@{_DGOli~`B}o(WH&m4hYsa0grjqY)f}r5 zMKB-HE}5@d!g$jyi01BxI4Yt5W?fl>$fmGvYCxSQ zvWi%$@~FWzWhxwP%L)nJDR^y5cYMCP-|Y>OXu17}rZm5KVxMup25fNsd3KEhZr?Ih zV7a0e@@{zNG_@-kfu1@Wuh?!nSvfs3Dq~otmjjNLh=fwVA5j}$G4mEVG&UmLQ~O-{5GH*-N#>s1_0&y z+>wtc`UCcOVtixB5 zPugXrlMuTLe6djDVdJ*SNuxPp-Y9PEpAeEO5PO&UF<4&C`_%IG`yeF~Z1f*&O7`X` zff2gnZn^`Oy6TMEz!I1Fum(AAzEQMBb80djY~|6xJIaSJ%b~F6Tf=-Y7-T;>D$hDg zMf9sBAvoqa)p+VdslC(eVCo z)e1>v+@+^5%~w=k@a>~G^{p+bUCPO!&M_dUb32Is3z`<(2SHo^ADYfGAgVXo`VKYZ z(9OV*(jXlYLw89@BP}T z(gXhWpP~!mjNnoR0&X3I%ySnmi;h1b7~6gVJkAPsMJZ@X?4W9_Yg2_jkuhbKHA_;U zy3>(92R!NY?@zP5Z;`%sO4+7xz&=8Gb;}i~OJq~1n4FEr>-R;XSg>9f57>8o`LAQg z2a6x9#b4SRPi-eqoREVlTRgw(!TGj3C{l8FD1G3N%&gJosj&80E9sw0Rd`MdA5Jw@ zsu7M*LnWn;>a4Rqqh(lZHY}K=!`ae=cWZyn4imp2h93^59&B&!cS;e87nx_{ve%88 zA;)CSS8sJ?Lyl8{npPSUH-E`!DRMmn@5>fV;KX0NYEYsWR2%4&>Zsbti~qd~|MFJv zai`RZ(WxF;aL$?XbX*&yt$CRr=`2gF;1>$qFOi|4ST2k(tkbu&k;XtP0EsRQX(l914&>qjvitX=Zo!|8?at`-KjfUc+I z09H~T_dXg8N7rj5IRueR7VBI%G*t~)k`g&g!v|QL-{C@x9SkY;hr!R487Y;uAn~vm zgz}Jdr!0T}hvU29r*ajGS9j=3fRHECkfbgy2N(NFcJ?LWvw<^--11V^Ymk zL$PLE>&t}6V~y|KzC~8}MB+83msl92ZpF+(6Yl|nU9Fb;doV$;FrPYA?w z^+XDcZDsAs$8-Sv$Br;EGCeE>f+vAbL&nl~DXsVr8Qh*lWyOsh`MN*R=P_0#r8=3g zP08Ge9V=n8d@V>1^O!G*OoMk=Ol$_F`=2%>5~{Uch@LgZCh?!;g{>!5oAzZ`Ct#?UzVkDT(3bd|sM^#t(H1(A;Vnq6we8sdRafwN zjvCP^fxytz+A*;0lwdos(SSe>*7_h9Xw;eOH;jvEHRiQvP!uXgs-tdWQL3w^bdg&s zEOkcaBWqH>b3#AM1}9-2H-?|&h^Y|`&fWvwExt~bAph-0rQ7QYPBsw1pUIuK5g(Q| zInVaa5&h!uCo08Os%Dgx+An5E0p5!ZD|EEQy;`I)qHel0+E4?`kA%8h^)5;`9!jM0 ze7}EiRUc-M>9p#kjpl7ZWf-E3Jq;V5Z2d#KRzZxQ$B`gr9 z@-;rgQ*20}>$>0|mgEo}w`MYfMLmLqM6wOyAiC@YVT1yI8Vq0)w5`=-)7KUWbFFdM zgG%YQVD?-1fxIP+g+Ch&I11Xoj*f*@=evedq^Ps!!P3;ucd4q&^wJJu3+&BOX%d8O z(~_So=h7!xo;^TLiEj&;S=QG0If&rn2V`U<9RBNa(b*ylFSH^)mI^dK)DT-QJPN7_ zF2O6{eyD^Ll0*^J#P-Jw_Eynk<8t@v-pP_fIc0h}SF1GY0Mk~MgH=I?%aJ2q2z2u@ zCZ;f2LKUOqdARk|l~(J()sqnFMV7`r#>fxo33aHnUrqlyrfUA4mf$M4%(EWiL>$G> zo_X@39X&Mpt%=47Gz)9AjVb_b2DocZNw{n`5Et7QOpy0(x2^7ztxgN zT2e^@=FbvL6^Jzu4{-=!KlK?gxoblobljii2qc^$!?s|R)UrkI#db^X?GhQzJX~Ly z$6<1Y$6W0bOfm!ZDXv3BSbgm7d0;O$>ixGU9ve)N~~C}U$i zHW*%P8IN>tIKohA;6*I3h?9O<{Dyjq%|-zQrX|?3p__F{xI!S58M9on75i8?N9sqf z-#iJlAJzP2Es3|w28#*yn)ra##7Z`C=Chnk^!_EwWS1cUSz?za1suae6%^jfcuhb% z54TY>e#T{4kKkEz&sz828-P1devoRj`rb|F?e!Id-z8Zj_wP2L&?}WbRf+7;p`I(8 zyJz&!u9! z7RFH*#m@p_3B9pjX6rt7*&w%buNL{Y|by5cesP}8vxB_oOr(xUe@oU0iR$6>%A^*gdD z(U@o~+Etx88JUjpL>Yz_J_uG9$#JV_vYgWA^&keGRE2X4{IGnRt5EqR9aquyGi)RP zyTKj#CxHV96cKQJY>J?BVu(sRA$&C0@BNE2Oa}&IbtOpoD?GsRUjO31onH{l3OedN z=QNl@n&EF@s_&xg%N>3+01Wd^X`XzB#KL|XcF3So7$athv32IgYdbE z`mn`j24cYDY@=fjYR^hd6?ZL!CTzb1WP%2LJcfEi7>@PHiU8y4*)YSr6QyR_=J+UT zG&*~)8Cv@ON0-}rG7mZ8XH$fGy5M_KcAS~W3#;nLBlDSO3m?Sya{Y!(YWJ?d!<-BJ z_i}QAUmljeJ}~I?WeI_APR3WkPviM=ao||8e%5s;>Lhbkt== zTU~dj+0xGsh~_yHSyulHaI^;D(3ey?7cjd|-LOo2f2v2z2m!qu{&RKr-0g+w!DNLY zEbR3ivF3@`Bv@zvdlNKv#O=Q>yIXviRZCM>T1VFWBZo!;(|y3BZ9pM$-q z+-8Qgq@%ckj4MOfK|D6TO2O&)TjzuFc#8m^l)FOMdp)6NvGjZe``4qReTf-i?P*re zC!5I;T<7-dyv9N|x4v*Yn=X4Xb)0E8i=S*cGxipZO5+M~&)E7(MbBum#=l_q`g(ms zcQf0904O4ZjWyQI8cQgR^IJRHz_MaxKwp3T#(_XGR`i!Jl#67K zGBXg{qQ>`Us>n1D|HnwkV^X6w@KB!a@!M;8&}NEF-bIM^oq30w{xA>qV<7`xp>ym0 z+55qYl%(J42Wj~DAksHhmWuNFuS-_2gFqONXdtR&UI8$i>MQ~m%~UbX-wY5(qc~z< zy7(@ZVN}r@I9I?zF$VxK_4wY?2Wqg=PqP8~@5eqDOrt&cCr&4WZ?9U)C1hs$-vl6aHDRz0kwuH$G7`D=d zItVqY1?(go@o(%;#-P5F2ZQQKr>$O_NVPbaZHZB=O1xCA8(9S7Af93r&&Sk3x`BBx zIJh%*j78*EoJ`P*vb5n+hpx~=vf*AolDo8nO-}opIh5rUl({jzc^Hi=$B;W?Ud-sjC4j9(+=OUXWKR| zH^^VqAB)PrfAfpw!awYfj@D5J&>pFX<_R99;yM#C7a#;U<-$p6sNtA4?z7GFBEa3ttKL1> zyPjwWWjSR2goK1oq$;Lt2`T9rgLa68KvKh==T#7K>M0HXXQo}V8HS92>K#GvE9>jd zzNa$q!fXz;FcxUB+^Q)6C*DH?ViWRpYmGGZ)vu@o-w8W#_jOhDW55Ym^bPW_&jxHH zA)zQrH0$G-L9$Olz7YT|1VpO*&-<|FsWk?#5E)$&?eD|cqv5Q%d8f^^BMW$I%fw?o zTrW6MeowM`b^*CuKnPz_S)@wUggkKT^Pk|u3Jdi3I{TS`_}L2atq)W3?FYnJaP{O9 za4#`RJRwr?q?w@SVz&_Wog@TWQimydHFsrtZ2oHX-^o$!IdM&|rwqW)Fx`7Ig`ZZm zXskoDJJ#uecf&0{?k;5`()xKpkyKmrF~3{Oc$^T=2DGCz4kTBhTybs8f1>e?o3B%F z&rmWDlUYR}PqT6u>8mj?^NfxfX;?~4T%10b9-W@RiCj0;a4l{MH+bh>2qOW~FiQG8 ze@^FFxO;bVooXlk$azeglMU%9PpjpkT}AII))G?+F5r0-Tr{zOf(<9SlyRl7j|bA5 z|LgZAXlN)9MObba9Y=aoM1pU!8WAo4TXm3V(S+)iQKT|$v%@10ea9O4bkTO+99>6d z@?0m#gUux`c{Gb}pM^y%9lpS*cqvU9gykx;l=r`D;Uqf#P$`U~GV zuSZpUkl-|VO`0vow#zBz(9{`E2tF^# z^4Rz#WLmADpw9M~QY3#v0K@rugTjs=N z)6=0>mh=^kb!)>Ijrn=u0s-spIU|1F1GJ*Pd}X$hM9~?;fJ^FAvm(NFvnLa6{878e zx9i!0Hy5=3kRn!tp36wy6KzkFA+^%NrFZ2JYNlG(gG|HGhcA-m>&youPO08O?a%3m z=VwJILf?ocg^NZNJ@c=#vw0FZQNsX(St5phSJSN7;G@O9FR-{W1H;KoHTfV&RVgCF zI#F^2L#!k`tR`y!H5h&J#=U~1zPWLQA7=B8gblp;Fah{Pc*~;G5T`*{5DlWzVR!>Y z1orJPd^{C!PGV#q6ybxNeDN?bK2Q_3j!2qAqV=Je3IE#E%XOktM!8lY~*WB9s zB{qWw0&0IU_7>+~@qizf1y14LFKMRA`I87nBUW)CD9~M6$q8*Ev+DXYRbW-Ua;YZ& zY7q}NVDU5JaMxzFt*9!$+?zgdmq>p%NuQH=0p|*PthaQJ(UdT(^8K1m-0GyiM23Mr zx(d6v*nHtiz`>*?KgZaErgB}Ze%$Y6I{FEIGSbi;8sBf#m5H8-iQd1kukfXYD+a#p zTtZgPqb$pb_HceT?{#QvOW77kj09*6mL{l(>i44DMrOx!Rc!cP)_u&cwg&<83q`>q zX}Mu|$5|gU4VB*y=2%ML4d=5E>GHXLq=fE5{pHFR7b|Ew^PGr>GDZijbIphP_hChk zNKU5zqi9Um8)4`v%Cn>x^1=XJ{=2BKXdr1kI@WQ8%S$jj4S@m{=r2gy2-bfDz1^PQ zD$*UrAi(&6Q6#jrrXU4~TV`BBUIkxmcL z1gyrzK=3#jZ&FI?|9bMg`fgsTxKCK~&Path$Mg-912t0R`mTZ{kU(G=VUhdXqoO^- zfZ~P3tBr+t?#I=fMC;J`7#0n>1rog>)?XS^?rv+-R2o15G!$@e^uHdXx6sh!M`CB8 ze^(eR;FcB7BxN0Qk+__dUM=dFmkW`o4@zYU{nl1~%xjdfk|8y0^!=P~nM>&22H{K+ zDhYj}(;Mf^Gg!Ib1l{O(w?E7C=aouj){bXJb!7 zC-+f&efaCMhuOL<_Qa%!y5CDB2!xIf{N4BoM0r}rTzEgBO!%`E(OXdu%DF7xm(x}H zV;7`(xYPSZ%Q%Tm$rT)CJ0YSK&Dm*Tuza->AHZEHi8YL(2YpFAsg>DT@F9&b>F>T+ zb{+4)tD#?Q3y-dS;-mek6r&PPKutuC1 zMd*v#t4G!m*hpJngb|Tbpp-aC?63hbsy~5xNa;*hdhHEKKKYn%(A3kYB51at#kU3v z+a)Q;HN-xU%}L=lOcvf573J#G^0Qwlkm#!}phUCuw|GDS7^7P|0rj4=Fw!p88^Jrj zGg{%b@BBdr{S~qSzXt&5O^mIeJj8$^Vo;Gz1AH@6P%`048YNmX@k_ODQu* zU!J?Omlac{8=K}#q`V$vh8asZ!xbxpK8$?kA-|X;O-^**8vJOhZNgc!E>LHDYs7`T z=~$FMLc8VR(v1KM(?jwiMJ;>lJdEZscB!#A5x(4%_mC_alkzv1mSG=v2OFdL6-jVW zEtCw#w)0_;RtX3yjsKJ|xfk99B0RfSAVB+Os)y_UX1Wi>?Xq8n{1Zp@{dBe-akmRJ z8^+zwQp3auoPS{{=#Aqb!ouVvaBl#l5hWDp2_pq6smTA5{>L_}j}}*oU~=W?;83VO zun{3%gK7DCS|np*{YWG}00u~SxP-rBwdun%GPID_sHiDW;-@4e}N zv=&o%RkHKi5Q3lgIXkkef*fvZCe*qs-^Hta{(~3)RL&yiOT#;lDfyBu(g~MyKRq4S zy-7i}s&4|;-V8r5vaV-~A3a2dbwz|82y^7jY%u|o-f)1gqx4(moFa-?Q62-bk>qdZ zO!HLasFpA@CQ>f*e(U5PasXr-{S2=svJ42E2~h z_vTSYCXm{>9$Ft^gC*P)UDx|G1c_kBDa&Y_kBJ4|t6v?|UK2h7csnEDt+la9cyjg| zDFWPd+Hik-Flp@8rqEJRel3EC02fx|>s1QxbFPUI&%?F0^5nX4tk+F;>gX*Zz8@Ke zt&#mL+FWg8UR$_ccuE?ixoR1Mp=Af7ef&Nd^W@Q$6ds11S>i&g&p1C`WRz0iH_EfI zf8(>FQNF3iqpiXJJ`-DCkk%;P3Mq}>0Uk|Xl-;r1#n##Y$qMnkBGZyBTiMUAh5^pY zi!-a@FIEF(x?J-CsE!K71U#D|YNEb+xvS;xh&nxCn4@tX++*sgnoz$i>&t}tdPyRE z4biM^_%c7A)ON4PFa2*94e2cw8a({Sb5o7;L6lRC-G2^ z3!k=-czlCp*;A!#O!YOz!4kMO6iVW!bqu{s2yw8Yer1kyheKv?;aZ_ab4i%6s@cZi zd~qpG9})<}zqxT_g&W-XsJlRDUT6FQr{S5Mf>c{#Up>BjFU0`&?<`Qm3HzavFm-CY zE&1|o{7|ioy0^O06rFY4nnvVoPqJ6n=^g!e@1G^w7o?lEYgQdUDAUhI_rv5NR$wV` zNe79|J3p=#O*q7(|4@nryocl2Fh4=Ao2RWr%cNd-1@NP&ph;@(ikEGfqCtU69`iRcWuo*h7u!Q@o|9lG<`}KpX6L4!hO?N z@O>$XTy|_124u$H?D-=)j&^7kl}H)%??`0yHv{efL0^|B1dhn`maNfxw|mH#<=?4km0H)sXIy*Js01TpW+(#$w~!fTH{Dr&VHfhBlw6Pub`4 zH%~NVWgM7d!i&9!&bq7FUYfy~VeTOY0MA5B(m6Q`Zg%O1ldMf-gTHVzfUms&qaKqG$;uSaa!_D>>qMS^=4T zD`e25)?$-@x?7~{>{e3%h~OHA6Gn^BGeUjm;2^NJhT>`);6hQz2mk(nWk|K+Pg|V+ zXL*?oMy?K?1$0LghPn5KAE|3kP`HoGI4Sk%{idxKXz-#ay!J}p|I;LmFd`9*z&>MM zkUC?A&6Tlg$oA)jL>?4kS(o{j|3v9>M8QHd66G$j!&N#e4B|7Y%RINe9l%qiVE}t= z7VzjWAIAF2P9x%C3dDddNQVDxs=))LOO3P8AmT^jWEs>@25#;_KSj91sMHmU z{XjjX3E{Xm*;YMY1yo>kF=Q^zhXl=p#l;3+e(*PTv`$A(Q5ok*`oSq8Ut2V4;j2Md zK*i>gMiX5bCQK(|Y~f*JzF;%$*S#>Td6XCjXmJ>xt}6?V7Gbz8ub{1uMkFdiT0HQ; z;24Id*;{Kru3iJ?ER-MC#k)rb+b?=!{r}p?5!PqPmL=X$*vEmDe4;}FfXbiCHTFtnq!rm**-1aHB@*vqP7R*Ty@^IPM$9b=82z@P6b8c$4}M>BU!) zlQ`9WCo{mWc4>!A*^2q9h-&0_bC3)M-dw;R&h(aM`V~&FgB@j}`d=7Pw6E>PH-m*- zUxyU#j~PvJ8E7+Ba(aH`Q~D8=m)qsL7Ok)HXRh1RbBWkl=T*aZr@BR+!O#euW>54Z zPP->hbz;5QI|xlN?UkU~=NN|~72-*v?Nb@XCTO!Pi1YsDzm8KO(k;r^Kk+=A%@gU) z^YB2*M}vJVH4{%=y;EAO4RC2@91Lgm`BZ!TJ22Fw1+AhU2qh!}ey&tObebE#%ZyYQ zF#t90=zPOi!2e~S-qf;K`?E%K_I8uccT!!J-(s|VTh$?pxCbVnIliwUl!uvDC%K5b z(fzvB39BSSt?=`HuIyVhtB$u|c((NiT#Gi)i&KNPotCSO4r_~tkxN|fi7x*!o{r(M z0=%MCk_AGa7azwli$<}YRK)P6YnQzsTsncfyM|WXxc*$-z4zX)GYmx)ng~vQG29)~ zej>h{nD2JrbvOvPW;^P~qh2Klm>7@GE3HK9IFfkw@eWj3*?rZ`^1-r3*WICoG_K17 zZ@tVsD)6_*6|sxfnLb2^>g+S6hoLn-W`#aJMg!GP7y8uqo^uUmDt|0bFVw_0_45ow znXb#`y+2b4Aa0z?ChE&fUM%{)s&Ap8N2!XFn4J7bdMW&px5E|Rhoz!8*|eHB8NX#% z)I9UhgeX6^mR@0iNz>)KG?K`==lG6`#Ip2UD_|D4)Rw4%b9z742ur#5MPnChoZcIEjp9I}b&IbEtO-k*Toxx@kZC_m)s~}iDS;w8)u{~Lb zaR8Vv#7h60-!(U}g7?~JZx0pvP|RTPJBB6tuTQ|l3%x#GUm>-n(mznbNA9AEP1hR0;LX1J zR{T$;gHn#QH#tKc=p6qLMqkCzI0PM)#6XV+4{kg8yY>-^OeqM4sJ9|$DvtQ#9rgM& z0Quj}{gWR@9+$Hez^i(5X@~M7^P$cD(|3j%uE3ev2_$;>ROwz(V(?pxBg-I0vyw}* z62w$tz%5`((+wj6uU4O^eyk31ea)Ue(!7X8XXegZD225JQ)cd-TXr*Oj3e=X_BSD4 z3VU-~E2AU$NGx)o0k_|A;~WF)xUVQ3efYuNLFH!?Kj2YG%=`SG0LOUG4mnk7h0V zfgK1w!T=rRUy2Q^#O-ZckJ>4eUTG)q`=$vZANxKD?}=yb%Bir%+gzBcm3epMM353a zGHT?Zr)}v#TX|cQ_8AWKqx^ae?`tNlHcXc5C94iJqvg{IwyzCHTB)2A_cf)A-koyNtg2y+r!jB4~wD;N~_eA&qB4;9BDX zsmo@=4NaH4Qo^H=gA5Pw2YoSYQ>2In_yc|vcCZq!l%_41W$CdXUXsZmT?gOynvdz| zAB0161Q*EW3_}%z9ChU5=0twFsh@B70QLboVgW+OQ*<@e4NU*=7YDMQarw2UFMNpJ zCPtXIlFl>0K8Hn)4+x0%`AJL2We=rkv=TY(qmKFa>JjN zL~%Vc=Oe+8XssNn7LQs^wm;l_0eh^2^OHf?0l_Dh+Ryd;oS@1eaWRGj{;o$saIWS%g4yehwuuw8zd&T7fPl>YNQ0-v z-)Q~~SDT|<%|M)0(|>u$W=pAkWa*!Fk>7*X{CnwQMV}b;M5sCVi6BaZVcX8DBkNZ_ zci5`y{mmx*&v8|WzGixv6q`mJaZr8ld#=hjx80(|1s%*a)^rlQH_iW*u=_=)mFKHR zoO<^^`Zp#|kXum<>2xE0BBxOYtOfNtl2?yzOcg&T#~$JMPNpz0VEjNm!Z?z$emU35 zNICh#T?$CF3=i|&OgEna*jcEq1}-d~JZNOHqXE4-f^(V`UrEOK@R4OxgHq+Yk+A3? zxPH!xI#;u+g!7zShC%16H-b%XO6P>1D+czL6!TR#q>EYncVa0s3~DGSVntol#9_=g zxkI(&^2gM!b`|O%nMdlBBBXwMGda$WX&*0@0DebK``7wE0ZH{b|Gg&Q>axT2FY$c32bQYW8+~TN5~W3->uSD#bGlDjG}&dO4BC zT*vl}Zz`rYzh5%S?QT6kA!VK`PFGO0{Ta@Sd<4PRwXj)W+H^G$C5TV*TJ1~8(x*@1}<*5Fdkfcjg12?gitbpjuU zdI2i$*@LxziT|bMVE&g%#mG!s7qO@bf>1M}ejok_XE%|UYYbbCA^@3JhXEK;InwzY zlMjmrrO;6S&2hjnixsq4bcm)(JX9DYpvN$a{pyOlDix~I;4wLKZ^{v~7*-H^h79v-zP+vp7 z3>q-_vv{m2e1=KNaMxF|=cHjHJm{_?N3`%npQU4o)b&o;(&F6On1w%X}KB2sm(=E!7i$qM298Q?WO5$1?xax*dW@#M2wk-v)9(W`)k0i8wGv!-ty85 zyFeS;IU5H_`k3U@IW}pM6Z#;E@D6O|Q= zxwiJ*{V&0PTT|eY2pqQ6I&qax{%h;Nmt6es3;?Q}>vD$;s8byrOm$dL^6 zW(SZ~Y_NPPGaU?IO#%IwxF_)Kks739YYjks+klVD5RN(!y04fFhG-z5>eLBr!WCfl zu)D@8ebon%tw+?+g`6_hMcfErtO;)(49mt`X&unuN_^-fsYiqr9wcGA$$myS>0A%< z%Pw5gzAuo3$s!OJ^x*NeBAy@a$L}_S8`S!E%z;awRcBwvDKFW?lR9lOukBp|6YIGJ zv{7aYz{{WqLuzL;Zy$kLor`mkDPb2g{>U(b@2MCbE^JC$k~WkJ2`J@h1N1A)ilkh6 zbCsI2XJ;xI!0o>?L*mfv55~=-95uR-C`9Wykc5SGLt|VQU=MB(s@wtsw_YEt9g?j2 zpMofx(k@U+K}8JdC(ky0xoISa^i9z{oJM-yDW!rn-&EVyZTjg3X>i_za#SaTF-(^( zAonQ}Sq1ULb_=7&TfN@4ueYAD_v~o_PY7B{BHx{6@Z0qEi_G!QfFJ5yelI~pmS+Y5 zCSVoXfSU1Dyc(e}ga>p%d4sCK=u1d`K*D%RpdXFl8Ga&6mt8$4IVJdPyeg2~#Uc#r zRNM$a3f|7cSHg#ZN@wc}G~WdN^#PkjCEm% zkNoeoDmYEo%HOfP@ZhSHwlQqdi5}x0ThXRSwYW~ zBJ_-~e9GWf(tU%n$NY2>i|?}l1q~s=h|(w`MBVf4rBC+I&{|IN-0Ke^@zEC7DteoEAby^qzK z1S8}^$Lnak>qfZx$2|hu|62x@2sm<0we!Kv&q?Weg+o^G>dz?m54SMpCz8T;Y-_5* zog~BUc_F7?RF~z1yM$S!C4#i7eiV!(sz7UHrntGhG^x9oB`c zK!!m~9W)n*(OzJpPMdFZ7s0qh=IE5t`clqn>16(~%V~u@ObsEXXQ;RG&dQ+hA2n9>bCl}=1l+287u z`nhVz2gN`MWrFxwl?u#@A_leC;zlBe(o!7COuv)qw2Kr>Yd$Uud!Bk46<|=8@aM_B zX6czkyK zuhB^mHdqEtVu3pt{FFL*hkrVaM_TP^hy;lV&6JYKvBPCP485_0r3V8 z6#x|n5MP2ajT^!QJ})B13!%6)A)jw`(eUrmF^E_NdLc9FOrO2%ta6{tq9ik6Fb18^ zVm5scXCfxJ8ChJbI}ooP7|+GJr1HMgVqJGhr_(UiBjtaa+`rif#U+KJbZBdz{YSW5x8% z*vSAgw!f?;K!Adk8Swu&%GbRfF#H&kj)?XZ+%ovBjhyDvt`Ip;_@sI{swIuALryEQ z*0|M$@F5|E!Zy?!W$7wUiK9!XQhumnXZ*DR@hH+pm5`JWDluO18BLIcXX{I2mm(a5 zJibm4xRE)lvE{Jk3}r`f+TZ^4gfgtM!553MW7gsj5NYQI#C9D6?;OC&m&ld@tjbZo zKq8K!^HrkgEe?^>`H@yth|0iSI$w7=&&H9TCQX^+EA*y1|sG`3QP?X2##0mJX}Q2ouj4F0Te4nCpr4 zNc}$SJv9sgfE{WdsehZf4NN#E5a)sIHfUGi4}C>b068STM8^dG zZS!RGZ??#Z=c;J#V#1H}O;HCeW*xw6sEHMyPUOlDgixPLf21C%__bgqk{)Ky)XS=t zo;YTLbNCrq(fM~q`&z3z@<`n$HPa(OJ>aPl={Y@*yeQI=PI%)xl^s`2TY9F2h9vFY zX-c7HWmjcq5f&SeIujLlJok+2ye+-MLPMGV%2LOUD z85H;)Y0BnYVC~sovH$3)b<`J!lOV1Ffu$XS)AM%^=bCCk7qrKF{fGp!2uZ>~^^~0;`E~ zG@6F+eONr+O^dl*m6`cZJtArj?#xD`pNX~P5cfoGMq^9c8($q6_L=rKzn7j;&Ogo2 z$Z}4+z}z01IS_69*5MZ|O7b=x-QLYQ*Ru|yW5FlpLqQ5~1AI?#8F-)f0TJ+NLZ>=X z67>khCAi|;H#%*LWT@|RMfl*nl{$KI*lnWz>?&3a&ZL2!*x(2D zgl}|c6YyfMcrbg5X2FpkiH|79Z@hR>Y%iF43$4IY$UrQr=xiqwUA z*PjdH&XvY~4)bIXnTNlFPKW*ia;wpzv02);T^d$ms$f=s!H8&U&miZkbE&I9Xtzbw z7i54fku^WYOv*u;eBXQFZN%G9M@4zB%YwFiV;FR)yETw(;$ZcC*z)ng+Ogx`PCWK^ ztG0zXz2ZE3o2t@wpiN>Ntb~*GG=vmghzecqBw&CBBEOit6QhASy66a%PXjvS5kTs3uE_LNM%*VdK#B;-aIX%3a&BNW z>=$SJa@60V*s7f!2z<%-LPynC?6)mMER8F%M7%t8cjC1eUdT|LM7J^^Tk_&&1k?3u z1_fjkn)U(AfwQ<5!*8^A}mxjyvGp=8(1-l<} z;*USTxyC9CG{z~-Jd!*Et@hfQ_bD7LpdQfyQSvG4RJOC!29dGvWa&-J8q}Nce0y>^6Fo9Op!(L| zOI)(;G3amSFc6q{!U!>=wG47%oIcQJEtvjb1F-Xf{uu*oGHfEz7F)P8`JI88rh7EC zg6CnMQaXUN+amG{HK<@*m*IAclxZH7JQ_pFwPp?;Ggpx7Y9v0c22NIJ45vLf^f9>e zatnr4y_yUNrZ_(~S#H`NpPwP#_dW(s=|UJ1F=S3-qS^fIB>Ze6edTW_2KW%h^dbECD8pBreaaspaE`K$BpeCNNUP;u8p*^hpjfsvo zhmMK)=nS~D%TkkH+P|`NV;u!ut+_va^KH|~(#TgXQCJxUE#qerM8Lg3<1+ov&v>9# zCY!BUOJ^FWfj7gPv8v*U!#`rwT{v)^6FgT^bXg^4JJVQX<1>&W7!bkvBaQn-3Fig3 zHO6>d$c{&@?miboDAzaZrD!f@8gWUEwKWp(4jXuEVG z+jUdlex)O-wp?gKk=ofOi!ArD$vpyTo+kILc_)j0Cx=r1{3%JOWy7LZnOU{43ZcWZ ztc7kHrFUnjz<>DxHb?b6jmNnAyKDE|JrB!|2Bb^gIyLp?jCnfV{HR`KrW(WVntgW} z2)U8{(?UqMmqQvn@ggDecx<;z0GcKdd{p8FXZF3XEqDJk24-RF3KeHD%OnQT z$A(X@IOsmac{j&LS@Aj_Qc=zEB?LP9);W*))#t_C(=8o?Hy(jv^aln$t}jm{)Cac4 z%30a|3O}d{;9HfFcsZB9y+#cAlNV8+inyZ(gP<*tnn=ZTBn=_yJ70JT zqqWd=G2XkC2)#*uBFnZI-}Gp~Q{WI*n6K$-*KNlH@u2m9+(d;5DJ~>MkjGw<6SgK1 z52?Ij5NA|gr#|JYi>P`bPDK40=N4s&^7HhGT20PG%@MX?TF94l%qPEIuWq~WCsu{9 z$yFAy0ZG^w2WuiY8bBo(cmg~~MhKmrfWzlmhNW^WmuwVj=a)L(EBvay5X=YGUNiq%t;rQ8F8tsSTq~G`L zdxiTykiRVGeq`)fz5LOwVF!wI-muiL#Q+{`ERABdGrSrz_0dePg`b?8SR!W~IaAh%n}HB}8=_%UxX4rA znBwjqg7*?ee+bZL$8r*uAtdwJIlR$&Wz7SSj_1b; zeN8^4shTdf#qUS%XxmiAPpFL91WZNBbp;9p?;>!3o>5lP8O*N1VcDiifu>P27ir-| z`tpk(uS~#Wkun(uOoP|#jxy9tYej``L-w$JW!v|EF~;tm2a_@o`p5x-!W3ZIviUTV z&e7f?8$ek3{)V9*iZVt-k>UnBa)S7r5}>Cye@a2lzLwRec`2K@X=cO2yTWD)Mph!R`4j7jzQXk(VvU2_0O=szrqgp0*F>W=Y!WI?`Te%57a?%;;WpHzr zq=?D+nV47_QFj3Qa8|uMWM^dHqD>XfC!q0F(>G9HdQLw!=$zSiqs@M58K{l4bMIyHB56s4(I}`n}L?zxR6P>-0{DWF~n9wJm ztX}@&RJaRpk*T_d-^X1k{@!DZDq7$1y)Vu(577o!#it%+0_d;8&4 zYDNp0%;&kVPZ4cr-P7b;-M_^*L9cWtCNy-3 zw|)PEJ;5$e{OME@?0n7{RtoOu{KcqqSoa5!3V z8So4Q-`9$Vs`9@4wOaFAyzy$RI^r_Y}VO+O41>ynoz#^=!_{Vg8dsC4ZlT?o1wjY z>$g=#kQ4}8g|xMXbTm?a;cYRC1~G9z)VrRINZIz3#(B!=o`X1=V^&{6nXUudJzha2 za4zNICByr?D@eC=^gXuJBS}tJx#j{D4JH>zQAg2vx58?u4zpa|o@moh=?r5}aP(H< zYnH64Rr&;WFB5dM!khcjZTI|xtwEFv`%Vv2xg74UQ=~KoNEf=4Ln7EM-uP{bAsyoJ z-;piIIM~lU4hctSdZ&m){%3xb9Ky7@%7@;D>>=d%pZe>O>@aSI$~E>DwhJ&F%8h>! zU}!1}8}CKIH-S9))BJ0BbPks62Z?~oJP7D@XbeJ1=+#x8?CtWwy{6}bV^io9_h;R@ z5OHp_-(4^meTkE*pz&F~#O?0tN_9c}%G50XzrCB*;lTOq;!{r2fon1Ggphm)@}Oh_2`&H!IP#l_9n!5d}{6Hsxp z^>t8ku=BKcfLY?p%Hsd;PX~Ocd4}?i5G3i|;klS&Y?_b6>XJextw;$S7EfU+hX21x zsyrl$C=OF<*@OiJg;ey4%%WuG&9OTxcI?sOlBKPYT}w{uTN~S*shu%)%MPNVgHS3W zp@_hu45B|OAw-OB!wMw|!$L^NgbpdOpyRz+k7@Le8km_k-@Nzzj_-RfJL&TKi+kU; zdsfv>&!*`r#JEOLDqJ%85Kl-ucVTf1AwkM;(~`DWePpSktUf{fM5yER8z zAN{P0O-<|Y=bcoRWPI;R_3p_n>x-RvDOZ0ge$m(y=}kRfwa|0+a8drXkM3*D-TvleyA^dVan5I9RY_E8CdfocYO?y2B^8+{2`|e)a z^{A2{YX>Gqd}yBe!bnQqT`hsFihbmI`?~rC1k`q#3hMXUObti3(Gg_MrZ;;ie4#2 za2{TcqFs`P$Q(fDqVNu+%Rwp2rG`r=dYOWKBrBzWE|L|eqRE4RDIoiQ0deRN0{&wx zQa&k;vvC6j53iT>R-ThgVlT1te$6#cpkEf|QN zlY@60X&4>=(nDZ$-EVwAz>k=*teEX{G=mKlG0WFp-JD0zqOKE@!BsSQLdQ z2CzKE3|_z{2%G>yz`%GB3N}nbE}#rzHex(0X2a)}86#te`)0W%-LtU0qR!wL4k=Ml_qsg1Mqf@q10F&ks4jT1!& zW8othYvJQX#?Fs`S!=`n=Xbb*~9mQjkVQBtV3KfItSy08}6#zQq04;bA{Ves*z>eLkQq#N@>w zAeN!T7Zh_p-w_;Sw4EU!Q2PGsUy>P62tNm@TqLzzRPD`O+>M;fAe3D#O{~={ZOzEI znYozR$iB%NnUE=}l4;RFe5ZUI`TQQv1t>2GH;06diN(x~!`=-6K?VT?h^cvGo^~Ll znMu3S;GsWsQrBq!)pe#r;{NLBVBi=~5!#H!Amc@`{qRb+G~tPAs%f+E5)`_BtZN%w zCt;aw{8be#lqVn9ZO+!bOodh}20siRHx)uvk6lU+R4*(qEgyT>=s;&X5IN}cZAus` zFCQr{r{0;2@VZ!cPig^tz(uoE{d<}yy0RpIi}I<&Q=IWYjSgP`^GscGW;YDAG|u2nKd$nv ziphS24={0tctxiV_;PMEo(c>N4e=iRi@AeVP+61M*}&#sgpqkuRLwj_ zpm)Dh6P&nieoPKs+%iRGUW{|{bH3L$oaqr57F><;Ul`_H(Gz@x3@{V;N$yN)Zkw}z zHk9CoO8;^yaH!PptGAo>hl?nm3H!xGR-v<8#{-H3D14#HeO8E-k$lch`JGpon5S5; zEK;G&a0^q@%rz}}S#hsK{1nv zfiunxON1M}12axxQ`5ayMa~V;ohHk6_X+T1?v=980SW62U6yl%w|e zBPYe7s#(LkKgRoG6ZDD~odG&6ymIBhd5tuJLSC~Fn)LP)-N6N|Ra6;yd3D84-bQ%d z4>lgmHVdP53AZlM;={;X)HQJ>&-6#ADJVamow`{~DK zbg_3o!kX@#CBKTnx6ICg`;T7u7Moey51$FwDmDs0SLNWxF9WE8+lB?OCLuZWBNiE+ zU*Ld*6!eQ(#hcy2Q)k9N)$C)t!NVrW_WQxJsKW)?HHR0L078*YaR_(~m^7>$-Up*rR zkV}mOMR&v~-Clx_ZktgjTbRdKFGcEuw^m&?x&1|vAZjvaSKLa`Yaa_bg;ir;qU!_G zeI2r6SzLA^p5UPmylkxrHQuJ^gQMcf3-bH2|OVHttxg43r z3D}Qgvi(DLGlNrHTtes^1}SY6r^g4n);as_2Yah!_(9*>+l3To4fn5CvC*9P%gE=A zNS#%K!qtr=?nB4sLEVFv4SND|oG3UKAER*RPa|nTX`Ov5mp*9UD2^4_w+Stw9Y+?& z5l%4Vz%X;MjzWLOL=&6l-f}v-ze+AsT947=p=8n<>Oe1*PX&0}l#j<;qC+RAl*VlL0W;^6FbpK$Yu znffhihe|lTyCMVdk26G@GbgBG+rCH>K!t`ar)6&On7IE49f+-$;&wLsAA7JH`C3kZ zS=ep_61G4gEKpAfWVrBWA!Kuz&`f*#3v7$WEnvIsCs8OMP5F1%uC6qTu5-bvRh@}> zFA}0Ir6C5^90cq04ya4@wb~)ie-B@@eXQbrg+Ww!ztig8%*;>Sf&TC}lI9)in=fyY zm0!s6&ZZ?!6XWA+LLAy@F(`Gw0vZo$_GG7$C)GBk=6fOnnzJUJg_xB9PPpdfY1S;k**dUrUoR@5?NeUMT@AwGn})-#)#hEBVw1$ejfmY%sy)L+>-3#-y{v*u}HWYeb~OZbLDl_iUTK%!F1W zftFwQd+$P*g#JUN0tje&IYsBh*SLz9`P-_>=cxa{fL#HvV9YJ(nc@~_pXO0eIGuf+ zx%PkoRQ%yP(G;%Cy%w|||9^NK2oH>I8Ml`jINrjd6b@I7 zxdX7Xr+iW46Xk+ZgGu8~NP1eM6vVx@I_D4AiHp2xkT_3{uZiH@;F#uMkKt0PfQa`6 zg}BjMlIh;wZIaGvo0$^9X~{#15!0xJcVrLDN{u8IP>GtRQZA#c!-^QADCoQZeNoM1 zmF!IHL?WZ2@?j~yzDEDv{(`~i8|5gvI#qt6Uoj*Mf|G%loZl9){?&pe9%F?#r4y&; zH7=N{b=npStqWp^O_$&y8T~}qDQ=?<(VTpA6)Wr)HeZz4zg?^ z$Nmq@1>?;(q^Nqc0rwAjO4qSk1O^j%BWC~KSTgh_j^XiBIaP}S3OEq@2StGC*UKS+aBGDMYjY;!M! zH(rcS+7Ck$KmTg(v7%kviltPa4_3wawZm#l?r!oK?rKK7W8w+a5t@k45X?=-ppxdL znd(@ytv}SGu8N~wssPv~ytAvDqk}FGEIcYx7!9*Z@Gf>w_;KUno4#ssc76}asOJ{) zpPm<#zXc_B(3Z1spyipHeqP@xT%~SB>_-Jk3*uM*mfc*#r4)(4WPJrUcW&hPq@4EY z62_v-A4O=zZp{E=`g#Pc+8~7EyoL8aWw6^Gk?3^`0^u${_QlorTEg2V(}KHRE}!&g zRvwgK1Uc9h5dWdVH5!z!Ou5~ywhBFo8dO&Kt;?kF$`+uGHCw=C?mv_UVkq2Oj4j2y zS|-YC;g?0KMyqj1;eX7Dz}iOFd<&S|LG=9)^hHIv-{iu$yqaF{oRWssabFE;SaK&# zN9cT+oLK}BrF{NMD|875C%w(VZ;-z#2Kh}oMua2@Ub-tB=~igT{eduC%0K_Lb>Ruz z9R~cTOer+&Y&{<}5BuEr?ZJrgg$4XTno8 z2hG8bg2_5;r~OX|w3e~I3{DS$WC?ldd^x+Z)B4vD6~z_E?azpvDCI+?)seeSPZTfG z*>f}U$tZ?+C;XFF31j~8ra{KV!4TdWuRr{Eod4go1(eg8?7v3aiz! z|Fje-J|obsv}ZZ3L)wz`PKb$6_zuwl@d?6z+ygli1l{v3!uX^}KBKZ>K|}h4fXnD& zqa&xd7)+%$XJRaG@aCKq&MtjzhuDsD${jG?~1zMGBbg{IEx z#S>yKNYBTu&==CTL+Ojc;!W+IbHc8Vm#z=#%GTr3^Xc?SV?315tdpuPu$7k=Kc>uQ zR4v^KqCyjQnFzi+SwxLlfSKSwDMvw{JEF==6(^JI+H8_`7LLpVMsU zer7;u*4`mLM|B6fM_1ftk~&@t%+g|1GaWm7%3FMWbUEbnlcUjjy>R3cW{_9Q4?Lvy z6;9b`dW1(BRc&Mj*c75pG>d$^4t~6q`XMM#m_lkp6eve=+pT$^pbx3IvG8Zb2&_1d z@bW>3LtsKv2bsUDA-6tI(DL)fBv3aRnQtAOodNi-S84#Ea{V#&BExD4-MsLG;mja# z%mZro$_#%>iyR3Vx-j2+)A+n?I!sp2>b(mz+MNq}oFX&uWei#}#9B1Vu zhd{_n00TE}q7{q;PfWxy*)Ll?skowt1C!aoF&%-2jAZZ^m1#nCXIui@o{AP0w(@#WTpfmx7F|IJNbj+Rv8fkMD&o>BZErN!E z@Zlh{5sLqkYba8uLuw%y8@%%^@aCx_2Q(lFy2lR%ycdn%eqv?7*7VUzvwsaITx z2&)K?sT$3xS(vKMk^yOgy9$hv&WT@@tuh0a=`D$kCjvT+d_nc`-=vt{McCi)8XvC) zixBlyT8vKu6EZ@u$7}qN2%=nF>vK7kG;C<%%qTF2D99jxQAL9}e64fzY($>Rj^hSu zb!JC+{ksctkv3B#C@nEPQZ=6(_~P1k?nDf@-(wd%|3Wj)Q8ExIpxDe|F_?p~A4e$5 zfj?ycOMy0-z4GjBLp44zC1h*_SVGzV#r&&x|iiwHl zfKwcTDY~430t(Nk`@YZ3%{Aey#t!A9CN5fyGwk#Q6Rb<7M211}MUff}AYO|7eH+8^ zP2H`rWt^B|q+r0fjAjt}Gevu;ow=0D*d@Pf?Ac~nZs-$bQip#bIvGrs^dpZqC(DX} z)p;5Sxmq9aEKF2JutCd&AVR-QcwL=G2km=XDv1`(>RBC*D8)#POoL6(0PM@1gPK9V z2nCrbe{~<@Kb~eQU4}7}HZor0eBBSZW8o+9hqTeCTMlZ_`#gNm>gvh))1Z&s`x6&_ z-=Na+flPJ;T10`Q*Ajr&H? z?Pf_teZS)GLq#$ly2GQ;5Z(Z(KE!eq+`J4rh_lG{sM*=L(Wx6q!{MYGWN3dQW;27^ z_x>>S=}^zAM>HGv{8_efW%ZmRLu0cUX0z&vP!61bWVAtaiOuQu6NnVXxF2+e^Dd~bO@%+Q-#-E^}(j7MiDy%uKKtQo9vMsT%w z%kl-nbO|Aet239S4grXAVru=zXT6DYFy-4Qk`Ekx!BO_S3HG(%~2lfvJ6 zUTq;zYu`Mf$K1zgITJ{!Mrf&mR=7_r=hScTCAxk*h-_kpTEm!sS2l#qsK)uo z80Y0=_h$^S_j_5Loa#N7IMYno%Oe=NvFm#Cta^PtFl=$;UGtc1IoP<_@_S+tY0twP z=QTp(A{wcIBHs7ruExUyEtQN9U^DD~3D-Jga5KBCjKaz_lk3I!5g!1jTNx415Dg%( zS*v~RBr?8)24eg`b1N!KB&zfWker6$&ZcOEd!!6lLOY_Ra_Oc3c7EWZ+`>?!Vh(o3 zrd*5@>{?=v;i zvgn<_n22f{hArQt#2kX;b@(UhelU^sFg-h+doO94+pt-IlG!X^NpADJ8wu3b0SP5KBW}H9{UQ(lgBKGwdg7p&qFvM2!?Rt z?fW}yu}-{+e9*W!t9FgE|J(a%8|(JXr8v1;=3=hSpwDiuQ9DMsSrGVfXXX#XB$hxC zgwgD`3F_WmqD=m14`wNfZmPnmYHnk_qPV@!a0R*4<>%+OSgG&M;<)Ke3Vz&5)pJ$v z#WZ)avbwHVH2heodpH+r>tK1OFdFglnJpUB^ccaXg|O)^dXm{zdz&%tcLz@XTkPiE zCD$Dj>rp}I3%hj}$B9AsThkyr9LR+MmIN4Uy;KjoNM1zJPzc8z0vL=eM=eRai%xH7 zX4im9T3;<|umEr}=G;|v_JxoX+auMzL>nj!d_?7eX^kmtG^i}*jHhQiOCLs5o)T-v zQknY|Xch=`|M(;sastN`glWr!sRjkMw7Um-=U+N<%7>t9A;Qq^7hOA?>0V|?_Y)u1 zoF_3;4Z%-GX4)a|oxX2PT?az;n@<1!raawWL`h{OXW0&fLk4kl-$N;r{5z16f~LK8 zEXt7Y=i_}7SDEG7UmQp}XDT8{jnXo~FxrH*(IiS&XU*VM(xAZ1Z#M==bOVFb5MAp7 zHR7PQRR&s-$LuhS`#JnU8pT|XG<{e_48QPC@7;*l`b(%1I3_|EhH09PHrg;$u6WSqu@1NZM1DVTdq48FU|o!cP@f21FQ7I1b-TJiReuuSY)#PUCEKe z^|gpQ`a&WaK&YFv1WJx@284H}Cw_EKn$$k&BCEO@hiqGEDGUXk7`0&RGy0xk)covg zmP#=tEBeNCzzL(zXvFBrhcgN)z$W8nV4!YQ3CC!(;zM5CYZJrzC8Z~s^GaGo_uY6v z7;O`A9ho*xdPwb)u7>RX*3~^+~DJ#NP+x!jQhaue_}J@_riXY+0HplzAra8tL~H97H5`S zo!6xATO(x`ttZE}7Fi8vNLAkJxR91?qs_rlJ9rb8#57dV&b2&3$fcf3A*=-SMn=T) zY9{Z^Az>Wc%P$p6)xQP)#!&Ben=^1*lpKv9dj9-|$YqP2PG!vNvJ@^N6k(n>0q&$Z z2*5h+T==&HAg75<(fPnWSd44X#{?;*ep z1y0Uj$_KU<0J^LRMN?L>1_FV3vp$n-u( z{%~7uoP4{-K+W;G?1m$4y%gAd3h#GYaXT(qO@Mk^dpQ?)z|MIZV@Sx^eO+&xls3vE z+Jo6wnbyNx5}8v{=45qXGuiHD01Dr&Xg$mK2f}uo5^UtalAZR~TN|*N&d_ z?Zm=7`zEvA_U$=xtS;w`;lt}-qUzOF zU4FAI>E?8)W~cENGGQZgu*?HFoy>YA@87&=^ z=NgEjC2c>^G6eTdL1mXpTPds0h{&Is55*P|=&wbG3Xt$bx(h^$XLZCfffVzCevv>+ z+soUJ`~h7=+95;f;;KD~0;>EOIb7>GjyJIqMlcUumyAH**`E&QErOwpM@m?SHE7U4 zQ7I0hzl!)Z3cA9e>-ZLxd~85ngWAy7Uj&`HmlvawRLIISE-?bOY!BG@_1$O+f3!QD zHVz7If_JB8aO2hdg2y)fWn+I_r1m|60emN9__A`*xy0C=B)NGuXwNh{2=EIB*3z9&6l)Be#bX(D_5;`f**k~{r zO#J{M6zjRCvvur^A@~U{4}-4*yshvmvNxR4dlCGLw@*Z|i^+a@PvPp!#05~Z!9Tx*z~1!47n+Lej1Jxf3ELjs;UP$UAC*bGMI(44jDpb5)Zm!9w;`qGEs-&+;i z^w7Ws$*TuHi$?qjGG4AX10+RU1Oln^K7NO-(=@y4{Sa=nYWj|#S0-5`lTvp>)EaDJ z590z^CZE@LwC;j!nj>R{j*VgatpyKR=X2rSBkZyFKd#X>mGb$1P#*lSq8m)g$_WdQ z-cmzS#&A@y2Ag3nIMvV~n3|iPEL`{;jN1!ic|yEAh!A~3{M!Y0C>iR{&OM8_zT4a6 zQDw1C$A0Wht${84K|Zax69NNvdfr~jbZ$=~0F^nBuNfz`#JHS7Jvy5S5U~Y>Z&&V# zXE8@hae*KGU*Nlt8s>K&2Agvs10Z`$5o?!AsRnb!5Cx^?(fXEc2gGyawd57W@@>5f zW61<&?l!C^?y3nQQv%Ysx`HgoW+UjTMN1g*uhON9CDPBFwERKDvIGi|a{MKzA=Uo# zuj@HcTF%hy1o8^P&xg7j7$z5SPQpRxmh^sa4aGT~H&EaC9!#s;pYeOQo+-0*ZJ;ImGfD!K!xDs@ z_lLCG^yqLe%)y1>OvVb`bBOG`?T>$7_Pf}qn%MAt$aziYbCDJwczSy;JW09wg^`h3 z)p1m`*mOQoXw3((U;G>YJv!h z#+UO)aX7bRETdGD8cCg9x==@BCtGue2zB*q#w)=#4?&lCM_C-0Mha?JE`xVYMmh(J z_5e2%r#FY&p5ZoeQVVAR%U|$m*L4vY_8_}0$rmoLc&r!oW5N(M)Z5L#Y53%Qx3moW z6cWk&JiM8jAaS#knb&N(jyQ&??rr$EJlW|0qmb;F*_|woA<0Jrfn!$q6~{KAZVNCs zOosF0pji;{33MLH@O`~_iU?KMJ&B8N@Kj0xXtCIWbSkVEH0_fi86EHc(H@RgbsE@6 zhMo`oWhW6C7|D*Y%%H64fAUy*u`06#V6%p4kS)pALn5dx^>4j8K4Yb;EsG8e2b48d zr{un)y#L7a@XriEt8NMv5xa*+Ur%9w^nEkc=Qd&@v>pgjUtB*wUl+NR_`b{&v?3?( z>-ku2(XrKkko9m=wb}keogt8gZ2oeO`u?}6>#gQPrtLKSqM4(-!@((d-+Mq+F{?(r zc!W0wLX4ERu3f#T;PYIS1|e_(M~1r6TAFp`s8v`%}H)ozRw;dgG_K z$`NM^Gxp`=Jn8>x0cQ7%sZF|C;$<83N*VZ?TOxl@d}f8o!!(eHVN1w}sBR=Es(PB? z^LVF}k+Z++S@^n*dM*<~6MAdT5-LBG3SqHaK#DEVp^UT3VYXmh2R*4*`R( zO;FYyZQ^K3T*r90wsF{8Gq!c#6SU4`ahH#0@glhzbguJ6RskY8#&ZuRN)mj`Kg3Fq zLDVO3za=xjIlR4N2NNnzX-o`o+!ap*WLf&SsUM5H}ua(c4Z)M8-bxRfhs%RU+1 ze+~bl6d{MRR^WI}>N#L!GL9xw)pSBuhsl&F*ctL&sI&C`*Ya`}D&wuNFaBFScTUe{ zcctrzo2`(;&(U;`XH6OMDe4{n@66hlI{38A|6XJm?2Bp2((-Ea3RWFCaTZ=-Fhgk2 zt?t8;xRMyVeghJ`vIQ0uitC24v)K6xMj0MVVu#Uu|JQr|t4VDyx@0@YD!7i$8p@5dMBxvRcBi}>Z;lQp^(sw_ZX+j4<0rdh8*_t(XOtIb%^%KR>do^9=4PV{EpcA<~jsii4`X-*r? zL=UJ0aBd7F^ea}frubQ523F>DC;$A2P7t&hU=AG6%!6?uPMw$aW$R=668@FTzm4&# zTb#h)mAoWN9Uk}+$6ZgJY+_%JaD;lD|C!Z%6}d;fci9b0-Ct; z>C)9PwKWui>)Y-r=yoh0DTgPhv~(Z)8IFebz_q=}zbj9drR{Vf!{8=8!>8&1)g6pa z3yUTr%jwT8Z!_Rn;v+DsIY=y4--D%hdg*T6V>C5pv&af<0m1ECD5sj;j-b`!H(kJ8 z>7xKe_qwZ$N>f;%O zD1O769s68<4}H!#FMV4RpNZIj^4!7z1PfJBE~!;&EwkSyzpGosR@E0Is1n5kJ+ss= zYSFJDY|8S=Q>4&~y+v2d5uH?Bxm!y^Pk+2nj7?#h2 zS?iH)ON*@Qb37yEnt$fS>P&S^ix)%z|)p*Rofdx(7stD*L_IRm&tFq)*MxZNtX4O59&%D&r8w9vm=GSU32{C>6AzQ3b=qNV$d`i0L)N6M5# z;im``4Q#RJ>NLVV$8vx^-d8|qhKmoPy)3YT#e3^Mw8WFW@%fxz$qI03cRTDc`8ip z6KAcYIZ3rM$|98(x)YYZq%Ys__m3Zx5>x84le0YxqFou&rnJUX zY!ltq?8J}5m+F5eAhzlpj95i7g4H>P1LXsLC)<)CF32^P*yiel?nYgj#LH`q_NSA_ z>9>iJgfeg1o!z=9kB!aU9To4~?e0pTX1Q;KioBj$;w1l5erhOFZ4l#dCoL?D21#QBFli~Lkz3az3x#<6wd**|Kj zS}1=xt%5`=%sHFnTFeao6Af)~F64^}#eXsequJ%kf%<@yAQ4~2$x z7{+9?qpnj&B*a@?SF78`IMaz)w*p5#j#v2DsT2kEdbF^E(dQ%WRK8=~N9!_~<<0kH zqJ>Gl%NF2(jXxR?Wb_ z^xAsmi0HmKWIzIH7LexK0^Kb^w1iF~hJ+kf)tsDJ!$O$l$PT;ZAN=pLy@BafD*9!= ze;uqyvr1}Am(sZs%L&0gah7&~h&RX_f4F7d7-4>CoDs?_5;YDX(<~8~^pd&`)?#=^ zE!+L##!B}Q$c4;MRiOcysL-K9_PwzVN?3MyWd7|e$43hjy4LSw*<$g|{XtN%+KpH6 zqCM7UH%XPmht*cM>Aa+P|J?n4*@Dz#_`AXNwxZ8A=4Q#sa~sB6>-u?-La}Pq+8Bod zw*&U_@A+X>JSUDj|ir1%q% zzi-|!bgf)D0wg|)qJVAg!-&%&Gl)1bvCW-jPcK#9ZTS>aQSfSH)vgU0`o`s@!=S3k zAD)U9!kjToT-W}$U~($7bqU*_nvPf4YXI5;dxGZ&SqosAS^;!wk+V!>M%x~fs2IEY?HgJ=yEh>Y%n8<5y6j}WLLBHeCb z5x7fuGzZwLY2XXK!QQw%=yttN2uun+sOHd*PJ@mP=*Qlz{Bkh@g_ASj-6xJcjCi32>`!XCFOzJQH-AXO24ODj`UQ-26aybla#R90Hnl3#x#Lub2Zv*&TOJ1Z64} zUrelcDoT9Ow$WhS-#vk-0{}`hs~oXPG^1IbEGr4b&)XM=JrZp zk3kti8vtX)b*hw7FKm(1G(L8lg$y=42~{pNe4Phl5Eh$Dnf{4uvsoE=)+rnu~Te)4|g z`mraopXj(9psNgBsbH3$Af05!lTp*&KKy2}JZ_tS+uq=0vDiqQO00}5>OB}@+L&M? zOby2+G@qb?SKyx*hnN^ng=saHT<|k2gOZM9X*0A)T4n`0Xy9+rw2`qa=J#YvJyIWB zo!e>I3Xf@Ym5?W~-T2J?M!I!jX0w2eNFRtM>1kF2^4zo@%)f%&vXJIBi?AkvMrDw4 zpJ&t@eplw|kS^9BX^1i^;A->QeR}^XUFfc-sM@H+aLmZP8RKl0LxB~Gjxp7gVoYsK zUn9Vs={O&k3>bMdz)Jf3a7GyB#-#X7tW_7 zADno?l=mkpnb?XD1!C5&QYy zrCsdn2{9vki^`-%_ED_TBX%&3m}aq1lgO`VT%ob#^Op_l6Evt&Kvc@u*bQ+&HBDJ4 zXth;5Zwr)#WQ;zmr23y~AqGRD93q)&#_@LN^6*tabPc_ZPBz1E^8`q=uTA2P(?uvz zbf|{p3*wY8r~Tu75eXK-R(pP3)=2*?AeH%P#@csMv0!nlgmumPVk364$zFf)rB%@_ zC+c9JF4gJ$dy~G`s_Zz&PM=t}=Rw>8%tMSg73{82H}XJ3wtA8oe?7YWz`Pu1vYrpI zlyNRWmlVAhsM%ay0&7h%g%H-sQjZ+_J{pATtp3AiM>-^m@zF|*Vz_Q~`jR$$#;nV(XbElowf)dP;BY3k>0oOR; zogI}({4FHehIRsrpm>Duc;`3ytcxg0V@JEa8X{B6C&-q-<%P;k*R9~GTgI+(nD6>?&a{TU zvn4oQ=gbEERm;zMBftnPdz%ko6;&fS$yXMB7vJP{k3~gr=;YTsH|+ zlv9xsrY>bkX0+oh&E#n4{xF!q#;8J%ck6@)rBai6$a(I_oAZg_RM!pke9_kasKUc_|5EIG93dyG|L8Hhwd+5wrKf2^%p;p^O0YgPFJp# zypTTzvjy&7$BhT0VDn$r<3xq(uPUJ}Q;!|CL!;mW>R#eJdC`Wg>1x6|@ zeY?z-xUzD))7LRPtSf)?eR1U1D$V1azopZB$)iY4PCo&zR$~M$fWB=b)hMJ5|3Mf< z4Cg!!y`;mn2A)aFwFPJrFC_w+ti`EYwJ!Ne+<$!*?%@p_7a2DEHX3g_BM$D_UT#5) zht{FIrsjhOZtbfgTLJWZ_CSaVh@tfwXK!Y`^9VTw_faFam%=!tM90sbJDvc@?HR3CeC$ zJGdudz3;PA1_64b5tx621v8_OJ;QP+YoF*Xsl-W?>&C~^w4(a-TCn(R8dCFs8jRr# z94k*F$I)8EVx>OaQNbv*|5e1~$RdBcxz@bho}~`Z6Zmy?Wpwt1&Jh*4%Wtl{IX%R* ztnw(@f?p*!y{2hnCgeC2h{E>2(0@y3dLAQ;HiogOtK?Q*?^<(`sE-{2f)mQ8cO7Nm zoDiCfH)JHyYL>%jwpHQ8EYYxgmgf4^jFVV>R5f`($_XL-D>(T{y4@U7yIS2=iNuS= zGb?IqO?pE=d04gaa%ktKvxF76M) zhs7L?|J47_GXCXOpz7;991nYya&tV4`%lSfTHQDEj?V-7kq*T_@G3OS6(^hrnK$bf6g#&IzECN;CHhZn*rHUaxRC+zqtQas zbL(NfXD9P5l`{}2isX9!5L@MEa!MTmv3vFW2A5o@T^F;k5FJf8ur=A|LWoSpDJ_XA zWmcrwV%n|5-Q-PRXII)^{i9cZ6zWOmGkuq1KXlyAx2H(^C2UmFdzruTDGcNOPnZ-s z;duz-5v4d_HOX`DV_GsO^fon1df`{`!6dlZ?taslx^Xx2aOYz`3`5AFVCP_0Pm|X+ zkOouFuQpMq6%KO9rccGIxwYnhY~IHXJ$R zR_l1)Lx;aa71-rWQ)uftnkfl%w)z4w*KBVT{&}@~vI>5zj ztM#1(bx6T@)EM)`po_q*OOE%UFMWKOR8rTiS=(Dc8U;*1X+x-Ds%9J==m|EVE`C2;#b&I`^vgWSR4!yyWdPyf#yKiY?fd>zXA+o3}E9!(zM%(G4%h$7;X~0E{gcV;&heEK2s@rdFY^-r=DgliQ!ABth z;b`&5g%to+1%DVFzMeio3AoaE_-PuTw;V`OqlY*XA;m75Uhqm&J92~~--WU)EyBCl zj^mwfOW_XnlCmTPzdl@egHMAjY+Kz(N>`Ub^eZac$pNJEZ*ZFxYOE-Jt`d`d+ zOk~c}00*h?+KxchM9CXiq{@MP|1Wo;=)b!^4W}WRTX3BCC_g!a6V6)03&9LZ46b-` z#2Ew?eJg*ma*cOj6scv6y@Y8{IYLFtZA%vs=SyrXxeF;AT7~AdEBuo;iS>F@Dy1Fn9vQkkzV6QkS;2WY`&bAFSu4`+sw394~QPydm%~> zR1V*Dz3|-gCwayH(?M1}?lTBG%nI>jT`gh8`W~^Ot~)&KrFNZWI#2L9sL`Z2Qb_o2 zHCkHqiR)_hiN2r@#-oChj3Z}-$sHW9h9gL`w0K!=N6|D9qP(6<|PhjI#NE-nvwOFVyT6&NYlZ#YK z2oi>ROEK4hDV?gZ!VFjovOE1hR8qXERf0zmytU?U0#wxgk7o9ABO}ZG+$ZjxqNv$x z3Zuqyw#XWx7+ca&OGuhs0SpRsmcRJ9W?v|=$`>n#7p=h#?z>NGq=sV$n5>ovHvS}k zbteiWG%0)DT3a3$u^^n+D<$1DiIzc!O^Q3btxH0e;tUkhNMV^lSysbt=MB zjXoDe2()&P*#HCYlmfxRlkdIOb7}FJlZXICNwrSN4KK+6ky2wU#P2P z?EP-|JR^^ZiP?3z$Kv;7f85$>QS){+FL+X3XW%xku9;i((#}=KzQD_?tFSPOP8ANMf8BBgHyh{ zEt9KU%EVh3EwvNpv6fd&r;A3I|0volhyW+jGJs1FuSH`?uno1f>c%}EjYZog<5NYg z=h7NInrW@8Z5eQw7OmRYX&K;Cf%9{#EEqtp+)6e>72UKP-YI7a$p_uKUg@`mWC&8^ z+e>O%_t=Tf$^7+8OswA%Gw$$WYkASY`wW|q+lIG1tRjjlsD59)!awmFVv=XEyaIGq zomhfofEAtswVe!1A(asez>_2Z@oAuU91IC2URjO4?V2an+4^xR95(Kx#~Gw%vd-mJ zDh>p2qA1*g5<{QGs5YT!7)?IK$>w_LLXv9XY~x(%p^-bR^;iiS@NGaI)T_WSr~dTd z#;bW&10#j`=H_SPeBS~J+IFNw6B(m!{82HQIO?CA@g8^cny8<*0v^*9eUDXj?@yO+ zET3^u_fHpmC!DiyMj}}{AOBE&otT(#b30pU2#2rOs5Kki$ouBxaftvwZX9NlXN;NR zZ~9%xR`R!FK!6Ldhmz${xvhkCrQ81X&z<00aomV6;LdiGJ2OTiB`i2V)17#)#T6EYLZ>C$gl5)w|Tf(t0#9FYA;Jo_M3gG*j>Z9QNYh26Cft;H?rEYF-rmLd!vGfch@ zUELpHBx!|jr1iHa)Ag68fI^NKwB>M@G~Tz{+2T*V9gpzA%y*VIKCk6lE>v+X#|_eFYRBX4WbzJG=yopUQzK0MvT>7rBE_@ev2$YIdQ`Vqv3tiJ zBTR6XzejbTM0G@4_yKq!qfQK?aOgw(?%*}fokyYGB!BF$7UKTALWRJr&r5ctjrp?! z*k)Vp*V9OZPv@6kq8Tisml^=M@b!PS0QKP^f@!RJ5;(_DY?fNI)b7E8tojoOY{Tu6 zA23_p0ZG`EOA|s{)LdB|Cr0H2+Gmk7X~pTVO6iArEomkB_NsA9R`yK!l308U9d@#T zg*_2?gWCcQ?Bv#D(qSbfC2zM=+?r=CCzWlTPM?0=wL7P(sPFa;Cmts9e%19BuGx9r z^VW55t$DHDXxqwrQttX1EOOC~e3#|kdFS8MzBj;d(fM*tJHdC5S)A(K5j7udj?p-- zwIVGmZXRvH(#%Cn5k;WBxx5`Pqm8mI_W#lL4eWVE+q$uB^NVf!i*4Js(Z;sf*tXL+ zZEV}NllG?j?(>}c2k!g@Ypgl&4!u*DsM_9%x_%KXwpN&xu(-X#N*6Uc1M6vr@QImk zOk);4tDNeQuw6pWRaUrY5v3-pTJPRUZyxbCK>lm={U*nr;OZA%*(#2_Y6Z^2T0tra ztR=z+XGLf&6!-Y(pgMI?s!W`6YHa=xSt_PI?ISlOcG2pYhQOH*L&xdA37tkLmyGiB zwN1bK$@f;r?LTb~jW&I4p4VIJy>E+kj9ZCLk^fY?bJpstTIgf&+++8VO6Ya$P4U}X z!{ezxprh|xe;S|vVMZXmZs?I!1G<+`6CNW=L5tF|O*y^UShHCJ9u-l{rwm_c9v(z zWU2@YPz z>%_Ix{2M15!#OMb3T75K6zJ0~E3<*i1f8p`I z+f!?$!}ZvDI^e0aROe)==KSN!q%BqLB7e};uJC4Mt+~Fr)TK6LIg$NY8%E8w%{hkZ zmrdwj!z@x#RaY)|jzUxfd>DhP4CHgcQ($N|+Dl0lQ3LR7y2F*^P9IuuTCzT34@j8i zT+3!PbYPcTI8Yzo*_5puB2-n?X1k9wfH?_)^5PdFlq&|nn#%Hii(k{msq{n0jM9&s zA*B!4=@8Ks24?pgTz~=prsiN@wd7Qf$497=jq@zowQRZnB>00Mu#b;in{M;iQt%z$ z3jC#9U#JGQ4h_aj2MVGLru{W1-mEYXV3P>O158Asc{+|DcS?vb!sTXF^j#=bA|D=9 z0e@R8yrNA(>q1dvG@}AcGPvQmmIU!s8Y(lj%8K{1{PFEeoC~OpjVxO%>JgRPOW$pFOO;YM=%YN#x$pr zZkd@|Z72ttcbXY4=tc7v-Wh@-gGg#Sk5#wJo7}NLKaTH@D|4ZC>Y2$VOQ}4%;LFSK z0KcPAsl?b~;mL2xYJZb~sl|*ep`^uDO)4t>bna#}R6b9&GIL6nt82p@&|2TI0el1; zOkJZ@(kUQF{#~Y?W#p_pcuvSW&VeWl4Na8?n2ba7P(1gcv8B(ph8ZywVxB)(GnzNr zeYMSDNz9kGe9mhI!-)fMN~^>yGOoA#{vyqZ=4nrHe61^Sce$VQApenTu)fe*%?FDh1s&wesSWt zsJaOd+=-=1GT&7T)LIo%uf+UnVN40o*QvgVe-y?D)sQw^d zkx{3*D~ADIIpvC+V_J~;D8DA^(V%04{RvFcWCW1l{{Yz)$)z5>k08h|tE-&?tq24& ztGcu5yIX_8O_Y5HE5qLei{Xp1nupxPM{jNGV)5cPxpohPzhJ{oAT&`%_hsw)pSV0m zjy3D;p69LilCQabpFx+}_bAPeA$eqe=A3}Xs=x1gzgqvmh(8;Z%0Nc zw?2-h?O!W?_zb=?cHaz?rMbq&EJEIK(xSz496K3BUU*qws#Z|qwF3E3Bb~UHqD6h8 zu*t@G7Ao8>WSnHMvf>Jcl)jtEaN3rnAZ8DEjB4*i`pINRz%Zh-m{jn{{+)+0anD~5 zo={&KBbOl@4Wm|((~9OEY9qa@S&^P9rHgGhw->V!tb~nTBvUPWYDSA3*I$ztBdefF zdl8s9B`j86-jbm+puqK(+wF3{vH4x;f^!W=l3kA!xY^}d*L6FB?^wVwZcK40uc)|v zoBAc>nr6?Lx&S?VJVg2MW1MIA{ToxjZS?ftRKwRbOg6Upvbi5FE8VZngkO;NT<|mJ znBQ^~HJ5uo1C&KfYbux-j!yc7Mk%!fm#Uq|fvBVeWVPUm-F>LL`0X* zP0s%ChLXJnsQvQu+s;;f{?S@sPIRsOvbl3zEL%Hlva~*|yy-}k4QTMZ?i|i=vH1w9 z+8iNmoZ-Huoq+9GNjWE({jP52ZiO?WRB>7(K!)t>J;6&9Z2Q}O%zLO;PB$-U1V7Qc2f4HGHM`aXhB z7D;Lp1VcE8jn;ZVkpp{u`+GC8W8AstUO31}PlHp&AW|)W7TzNq071T}R7?QlHy0M{ zu`2(wM6KO6JPo>mL6kX`Da4g;gu-3BwJYOk(I!SD#*q1d6Qz)F)e zH8nl^?|>6)IbP0wekT9S%gD-lOW~RDXodaS_*nYt^OB!`W!s4rB(e~nk*N=v^f;&RlJWMSA{zJ5qB2T-@C#*AkE~4Gutk`m1S<{Ro);68J zjff~Rbpe8Clk+4>u#zDt2EpO%Bny()9UTMloM}$Tq_3$$XK7;^2TZ_Uy}Lgq1?r>} zhqD=KNdf?&2tVo^1nS+c4G;>Q8u#H#YxxD?g)aKk;ZdKR`Z6A$_ zm8$v{32iw1EMT-_mdzChD_K*Fvr_J-nk5Bu6x)`Vot#E>fK-f+9ED7CL!q8_Q5C%{ z$pq?1`ClMZhg}w@(qF4@IH1JO-yNU8TjlU9`hY60hlol6xa7H9hhR3+0#mI|( zba@poLpuE)gNEd5(h{l;jpN>Y;8FsJ`fb{mevU=LP~rMz-`?yN4# z&~gPxAB;GaVb9O!a5j~*Ntm6B*t<5`3Jid<7n@LuWX2Qim&Yrr6G1sm6gXX3wvD5# zHWDHCYC$hzsd(he-i7nq3!k-M|KjlY|9AF>ep2F{AA9E|ew_vhP_hX4nB!By>(X0< z*uVV8uZcU`vnPzEy{^uAJYG}2RvS|Le*S-bt^Lla_4&R&%T%5mbxb?Vx0H|_jU=Vd zGVeGXJ_lWY`c2a7!%qrguIRqdbRP?^Pj(;6|J&S{U;IeRKbnyxcC2%+jt@G|_^1!Aw}U=J2@9iEISTtS zc+2xI#YAlmQ!J6fYa!39x!6v)v5M2KmvmO$=_5bpR!ZLWr1mYo=%qev&i(%8jP$UV zT5pK#;|cr$=WQ#q{>asSVVn5Jn?REYbFe+*Wog?jy)6_v0!m)>GOs&b(D21S#bm`F zJ@Rh#(M#kC6p5;|KFdoUe>KOKZS2{ed26 z^ruf@-!lefqw4X~Y#__`5*vrTne&Ltia&cKm-jdwpEP2V-G`l#Rg_?bc<4TzU9hOm zxmRfB@|$tU!#~1?B?Pp<4Kv`^g5+_HKZ)>k#{I{!wcl!lA}Bb(CI0GuWXTmI1f-xl z0~eO=kFIVV)2w$7*m6#|6B=5e-$n#T-zp3$0FexJY{NDf#6ss76!qhI=^WZ^D%)DG zWS!EgdmLtU=Ot@oWXVs&ZFMv$G0|DCkU#1;Y~=RA_ySqwyVDkjQtPN2 zhJ~@7QAh$B$`+_#8}YTb@``XWgTZ)xmw3HEL0kyZ9QW|OGS@|NpNiI5u; z5N-apN4(NHRqG4(#yKGZe$jnC_CKqnPuad(uTp0W5^~PhfJ?}%Wyg7`wHfcY{ArP# zn`wUMjDK8GV_KL5@?iZo@A=f#;u8`eWBbGGj7!Tx()%8#T< zsmzRX7{%jY)jweVpH1vUg$;k5j_N2Yx$tji{dyk%m@FG0kPLTOZODu+`CP^Iw(*4A zsQCY3V|U|Dow-&beV51UvmP1( zw+E@ZYddu|oUz|_MB>El_j~kZzbb7A9{E0E8}mYv78E#zYXLw(K0;zRh*=W6v}MBl zI~n1POv&T-=f{k9fB&E2#Gjx*m;Qst{cz{4n6JZuY(-bba6_bV_C*lVn}Ic>ec(qI zIJhW`reK>{1;Rahy?k88=qU5=cjMZ^+JpW2r{z}-S{SM$XC`JtZl2o(9{)7||2PXY7=|O$NJgu)*0s zzctyw@z?^qjFc9e#0(M7*EF}XQN&`#y6gM3qO}-^ix5LgcH!n3^jEL3%kwrIz9I^K6e76LtiMVYBg-18*=~-esy7xr|dQ zrzwY>3U0|I$O3$PZUH_x;l9vCnLUH6r=NqFpWxq&O7Rdaf{Bsj%LND>x@u1pJl>Me zd6V&%u<^NSnYbKI(vm-sHg)T`X0IPk{ze9Dd+3cmjw_rDy}#S9LIAqLTFFfOEKoWVgZQ0GHh{#t$06saCDe0cTz7O zJ{@$124Uq8trSMATq8YkzS;Nwg@V%i8DyA2(GfIT9Lq>9`af;v*48+Cfm&;mY^`nWScghEL`~us{TW2)`pAaw`mdDmiV4_YjYTYPT z2GScycpSyr=bxk;BL!`QJvZyEN=Xz^@N?R)c6(AFdH|bucXBcMuXC6gt(r{3W zwcB|ogB`Mwio9nU1UjpF2T7KgDU=~MHAVhu1ckz7D9BdBd&-Qh&IqrDOqeBBQ>!&2u3SepL!2?0IR^D z#L5HI$Gd|TMxY!&fHz>XfK|`~kfjga*3ef`?3rB?+$alV{N_pTPPEofagv(Fm9hHo zklcupX5DZ?+#mv9l=X*xr?Q=Z6390?2tJx*~$>?{%f8&P-jiqiD` zPH$9qBHikzd!&9rCh6}2l82~)r^v5~XBZ&_otK0ohs!_=fqJO#i zWXM6mca%T~@2aOw9n!O`K9j1~dQc``oAhx8BEcoI+%^l64Dlhi5TBSjHw zTPuaLWJqH0-kK8R&m8n3vOn!6aodcMGTR^DAYt<$R@m5of9pzZLCgosYL3q05~cCPQCCcH9SS| z2hACTPWD?teI^gS9@Xvr+-nF(a*bi?BtbPNK=F zk$$Uk2$e(>DsSDN7~+cd=^+d(!Y4CXf=RU?!RV+7qa?rZ;Y=Vj_~@li3NO;kJqt~v zVO4nE5{3b5U4csn%`;S|aM@_ED@NgVSoc6cLJ4C?QgH`UFa@aY2-1c~C>t{y=BC0f zuYNgcEg+AYA#zJNOYG8?Oz8SD!fQgUIO;*pjZmwSR)teyh;oNdFR?r*?N6XXIHC)X zq}U*(dILp#ZbHV6y_g)+AKkfYc2>`aox>!!lC1KeX%Ab+==lY>obOE4Lw*GsyMHe( z_(7;X__^rhl#e$tg_eu3H=`K`kryhuYsCnJu`8ykP#j3cn&UV{2GoBhnB9-X%gM(G z>p-j*OJR6Q&3V3WHu9}9@FoLE(A~Ie7P@+blae05UdXK~t|Z-Hq%W8O-Ujo(e?*j1 zCMuc`6QxSYfOZ40zDicXbb9_{oIkr#qjKZ{mz$r4aciHw0@)AMkA1D?h^qu+(Hu})D{ zctv$_LU|GB6d^?Gq*A+1RS-8vJS(XUth(WJ*u zk}OmM_4LZ6B<3k1xlM4?i|K#vi1~?YlF=yOiGqR!J{j+fPz9B*^cng-c`S2G77?L> zqGm4UX}q?|{uUEC17n18#g__hj=+fu0&pe5SS3;#U?sZYuRn^fp3j!NxiOF-cM|22 zdvxZd#IIp4Qm=iLMRNkV$jPRn1gRhp68;=UK7;|=M`p#HOsC!yq~YYt7=>jTgrm`3 zguSCy*{xNG$4a)KvHxFlafdNu=M%tD3)Uu!_iqXYXB*61H6~DR4r?u?kL2H3 zCP|Dy**Gy;q59=04~pz|z>j>DGX>fkp$|s004mbDgVRdvPA@HWysJYc0Kw>p662~q z&1=|bTeR;ZP92%X+Z(4JvVxa1j*2Ixzo=|#?TpKmsOq#cisG;SI_t!pgBxSDw+O>S z-W1qsGL4i0)!G)JhlK+3NiGhueEhv}EwOXKIm04+0bIqQ^JXStN`1v3P^!*hnp>ru zHv+rXw$laIX`iE1Eu_%IMht;{)5RR+RgNm`a59-QQ0Y5pc)=_`9QbpB7zzt2n>B5H zxi+_EOae5E7OKX+=9j~0fU1`fOjupb+&%ee#GFCOaPTu956MPHp8PH9Acsc3jNAn| zQ6|(p8v!f~;RA_)@Q~gYGl3|mo-(9J^dVlVk*s_f6<;_Fi-O@kQAJBvmbK^LUUx~# zDEEwnmTqRPM>aSjq?k1~T`C07M%7dJRFr6GQEnT;(huZ#ASdg~Tsl^*GvBq^drltiry-7y2`Ov!;p)hD|)@XR%G<8|^z z;j8fYgu7PY7^XGZ6!{~8a|gXlO`W{>!S0Stxy_5BRiYy*nx074DVcUWbmRh<3C5~t z#Fpq7Hl9=a&!>t?_Q#nQ)Lc&tiA1-!s1s{5i7!j@NP{irW#;4KWv&im1N!gaD3alg zFj7keW}+;M#5kK_BlSGoOz_Iw3*xCRWVm013l8{z7NN#t zF$+XaH3_CUhMj&|D;Z|K7=N%2;S_0!fQdg*y(wWQD7>GUM>-@8QNO#BeX-{bF52wr zgjk4Wf3bO@N8H4H{|vHa_~ONcoV$^Q@BvG;1$Rt(GnEPZToiW(&Yy6k9LgDwgefB9 z?EAQ8#L+ZzKpF{MUfgLC)C^OXMd3wg!0IhYVy!r0I%(sdh+kyg5AGabVxpkI(J;^DW=dcQ*X9Hk1DDop@>J&FNu2Xp6=)Q^#;$N^5 z>^dkgmI_MYmJ{g+Gy0+3ppL7fcR5!}Xf=0(+1fYxQ|rNpBXS*Y)f=gy{*k)AuUj~c zD0i%Y2o5Yy3K(7}j0D^bcMB0AgQm?iLPds82`57R&3xB#;0a$PQ!@uT<!$3_-;;h{)(LH zB)V{*&Iz3ZC@ETzc>E?GM-DVjW3Opso4v$9KYxRSF)O^#{EVQ%=%2w5X$T0zAfEGr zY8ssV&KPAT?i4KI#>RN2bPZSl76F|bsHMO~c2lCtZHfz~^SMe<0V{m-r*4G)rL{sV zfyPvC`q}rw|H30wl^6+T$7L5BjFV4~~SqbHyiw#=b=H6FP>GN$<~1F!hxlt+8AvQ+fAc>$0#QeDM}wl;T# zWwX=pv9QiZ9D$GwAq06JhZ}VUjF8}ar*Z^wX;o7bF%>&nruc)1CfU*X^OF3NFTPT4 znt~y-^GHyW=LZc^~~O$9ii9yM z+m&NIPn00hghd$4=urB-qM5uG;(ulVRvE|xUp!Q2G+g%Vrq(YHGB zN;G8DhT9(cwZsn4PLmOP8qwd(v1K$j8FDTQ7yK0fUo{Uc)aoQCG;)<%S!`={gzUsq zU3}lrSbrU)XE=;nmz*?I390Wei}{sRtC^j7nU6)_O{qUfLHVi^kdS0Gemx>})$;Ku zKT$4w@}6_L={Xh#zX$Sl>@~&?GT*7hp(?A6T|13Y060$*pU|XwM;gbKm3wOGl-JUW z>8xcoYa9I0+T7C*e5o*sYME@bI+QRV1y2py#Neb>%W{3(sIAGZ1cOA|oW^9cxUpF( z$aV8iju5R4OX=ac+vK4;;v|xF5mfm3Y4d-^i_AZl*NBQ`wbbK<>FCshNYv_0Cw38` z+CYg6lr&*!A4%1=NfiSWXuR@CrC7)ufTvqpB+2 zF?nI9TF9qdZb*r;jQO#UQ38mPB(cn0-%5!t@YM#v!3_~5+;O1Vg_Mk!-Fd|w3%4mC z^XIqQ3)Z#UDl{Lc_!5gPIqn|qSl~51>^D)2JKgnT+izjWvaE&;jJfujIxjqIb;`+2 zV2O?utP2Pp-p!F2Z7{Y(QBg6ZxHd+Eo3XhocDb)Hfb0}@4mjM5E)f{N0ssZBfiGx0 zB%qiC(p@Yp9?}nl>9_&%ZnKC$i z!J%F25jz$E^9l4a9(NzG={$;9ar)_Q++F0IjY<}zEX{f#H}GFL5pl1PHm{W+R!u%S zScHyYgH!0oa5kplZog4pyMI9v^Mot`BpO`x5B34VjloPJDBHu;2=dlm%>O-q%iS7r z-~2=AcDz30ik_?=+!)S=NrT&5%_P|kBgx_wPXt&5QU0k8+N2e(7Om{47E39Cc`GjT z02i`0Fu&8;GnbfT;*-Ws)TCg>Ym04F8S&Omr~=?EmQMsoW)ThXv7o$=yJ-8kv4Flx z9mkIKUM8Ispr31nIULBjG9`jm18~WSutSLVF_R%JmB~U@M}Ir5g@cx%-fFvXkP=qa z(z}tFQ5GTyCgJd8H&pMiM~=-%BGX`;*C>Nkd+1^I8N_aTf7NP!#V=Mw4`IrzU8jOiu(IjmNsvUr7M`q8 zFP)7@kQq~{wAsKST@!&msN3MQylbULZ$ebu%=EYjIff$;zs&VUFPz2L37-HBRmGRxrSLOtxs4s$o zJlKCByoUz|E#iBLdl`S z$oT}3=$Zti<>GHciF2cvsn^+AIX;G}&RU&vSLkRkW0q9uxA7aRfg-J>)NFO^5EglP zB7Y-@P4~|D1CQ2NR298?@rfAEER>?t@`O{|s&%8mH}&$Ip&v9nKV~?TxJ*6On!1hA z&2_d-Ib?A3>K-h@XD{SgAU}bG?``jDfL?LWG_(W!ZA*tI818O!?tk_TXY_>ZTXLYz6ns zq91u?p8v!vUg_SJTZN;*`{u)klk?8bf!N&bMoD97+%*w$rHUV8#~}46QwVKYJo-~X z4eu!y`C2#CpT;=ShsHf{XHdCUH(QM8391DA^c8%3`7l|w=FObG=<+6e(+xE4$u(G8 z#4rqaXfXP_u0Fpui`ld5m%47;!ryX&WODx90hv<3dRGeYz?gQ=P-yLAM^s}Lr`a@pVYoU<5cD*Zx&Ipw|9NKiVedeWBkxV@ z>CxOHDwrp@%xkJphW13`<%EcsvC zGEJy~TXD|2{rlF?zFL#5O(&_wCJy1f>4O~S{C(b z9`8pH?Ht~H2KuIG52zJhH+&z2bfq%{rnDjXc=PgEN>L{>kG_!HC&0+_WED#g(%6Ss z&|n@($nI;!i+>2}8et8x4h&!FmNOBV6BGMnZg|{}IVhw)nwcW>Lb$9We8#n;p-vDB zJbwpOVPZu~qz_bMPRA4WKTb%cy9|uQ@~4>vfnB;vcs?_cGnpRwXl{xzKCPP60qwc7 zlA`HVA%VUab1kWDi}fmSgW4bPIeXm9(;kI}iRf?=5&)MqWlei5G0n!ZE(aE0QH+CZ zTGOR;7RMr*nUQ`|xN~{o5a1aIlkA)p#YG{NeaxdF7TRX&j5G*dAo=y=2sWr1N3w_R z6C@ZZMq@?yYDE@h6VZb|82xspd-$0=aS~@*k-`A!@{p$6$^m0l0+vAJSg|Hz9%uFXgjZE+|D8o{+oJ28(M$U6yT`rM##KGj3n zrSC%<*T@Pbhs502^fw5MmTbL}efM0D^4cnzPR?{&>40NO__V%;qX!-Q5s-Xj) zNjrtd;~f0c?I6S+mwwMC@7_7Zh2Lg&d4dmYsW6eFbQT&nv;NRlo<3~-g|QOu=fa@4 z>8O@6TXL+SQnehP9o5`>Y>US z%0tB6&O|Ys;OP_|x1wJ57|}L5-fEUQ^KLbeSm#Q2>*-lbUJb!Xs*$wEjx35#QPguN z`?O2lFN8!in_k(5B$Ojg^)XpSQ~txyu;}x(Y2-OGeK$0I7ETwL4WPhV~x)l*qNex494idjoR4dhFBQXJSQgoNh~QjZSV

6y@e)k>#*b5czMyzIo1(qW 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

Fb8FG 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 - - - - - - -Images in SVG - -Jpeg - - - -Effect or Bitmap - - - - - - - - - - - - -Transparency - -SEE - - - -Scaled - - - - - - - - diff --git a/src/documentation/content/xdocs/dev/svg/link.pdf b/src/documentation/content/xdocs/dev/svg/link.pdf deleted file mode 100644 index e0c01b6fa..000000000 --- a/src/documentation/content/xdocs/dev/svg/link.pdf +++ /dev/null @@ -1,123 +0,0 @@ -%PDF-1.3 -%ª«¬­ -4 0 obj -<< /Type /Info -/Producer (FOP SVG Renderer) >> -endobj -5 0 obj -<< /Length 3668 /Filter [ /ASCII85Decode /FlateDecode ] - >> -stream -Gau0F>Da]<&cJn5e-;EkoE\#=0Gs^rm`/U`_)A12@/lVJ^!@!6V9%qflFQFD0h]DuNEX:"+rcj5Bj"H/eIdl=:K5\[!_g_FMj0=+0pE,IR+9-Y?UZ<'!IJj#hhk,/ha+n%_0%'(\K>3tlZ@?F:n[HPGIWe)[+.du!^OJGqo=p@ar:;uTs8Vf-I:IVC*2KXu2sQMu$2%HtTt09YmI:E"C%6K``V;OH%<'"kA@aM>='M9T08%IVr8t_$2N)?"3_^Jrq?:63t-7r*+W<170JRX%hqcjCA$l*A=WsHeG+`XV"@Kl`#a>#Qp#FL=C8@^)":OK$e1ek4e+^dCK1dWo!-%1)]C3L*7&T\dUadm/N-BN^/obOm;]J(b(rC$cNPjsf)MXtgr-CWB!bf2OB9t+AAUC2^)P/?j`=A*E5lO/"*4W!g36O0U6EeGnRM5bBP9Nh:\?b_ZqRQ86>[J*l6W[M#>I1(ao#/>2:S]^HZhI3=m)D+t)oIXZqpO&*!Lp581$pN:a35ZqKG`:s%o2I-ufZGf.Gf&^(P+(6;S#?5P*O^71A$/DP/S:Mu^;q[,C2%XsK?lD1c4h>"V_X=-_B7.)i)9KohGnsD;t2cO4YX33d4&_0.9^Zlb@NNe3Ej-7pE1)0)).Io./<0FL3Cp,_k*B<:KHBep[Cg#n'BDNXmh8)2U=A)g-hhjn"D0Oe?XBi^icE#taa*SNXeJLG2+c.8(ZMPVYtaN>C"*?o[a)JAeOekdoNnFl9`Zd*;lCh?9C3\ZMF/=V.Y9S5#..E(Q'chFUU#M;FRE#/o2ZpMoakNb-/IOoAh2)Y[Q'bib=8rq#;Te'431ZjH)1Bj0aX%4CN+XOMW!;+FWJ0:7K&t1&#)N7*;N=!``bCWbN,m87FsEM?ubdb[UuYQ&K,@VBM?b/$h4)LMoe>]Q)5#6C%o][6:0tl2_d<"rI'n^i9uMPBIT57hBI15Fli?21jgPIXQ&\rg-oC70%k1^i"&&[:kTM/uT5P11B;3L:!9;4rV1$Z1Ule12$ks^aP@7eNV=`5T:l7R.F_,'dKBn2KV8&^E*q,E1sI0Jb16Y(c*YrUM8,[K[R=@V21,`/,o`tYi,O[ck`n`;kq>=tia*pf86t/H9pXK]b&.C`+!K?7[]qH)6\P&-=s!bR"eLHG`^shY4pIo+Y=j@+8.WYj-J*Moi"2c%4Vd3N1VuDS(Wfu*GgP5]]',+TCFmT`4@fe>K^25aV&mj*f8^dOA]Ub+k-4so$o)!?)6p:BHdTBB2':TVA@,!pR)PtLTgi,Dh@]nr>&LJ:,VsG_]VMTA.7-D_a`jem_0X.Go<+H:[qf*b&gcAc:TT/Ff?\-s%\Bf(Zj:kPq6)7J.,V'R0+1:J?pZIc1deY9R8D9]nK#h6!F`d^\_&'XqTodb@_I^`d(-o^ae(7T$Jq"&Jr#g;UCMg00W@3fdtqK5bh)R&>DQ(;fdE)]\Kp$!V0Fk71Wp1<%bk15da7"*'@3ffBe(e1e30im/+?di+tUZ\*'1P%"3"MXHe8.kN@[2aRDN#8Fj8YbC([,m&M:=.kaPq_ZeQh`B206r$\q496f/4`id$o\)9!\"KjF=m*A8d2B2BbNDmm\E.Wph#[QIR^Nr*+iSp$Y_H-4N/[7*UKG89#7l8(Mo/@1rPf6NCc'X2V[MrO;lPQk8\-n&iq[8k]6V4n3WfCu$M[EoOlcMC)X5`<_t/"BQDCqMp8t#oR#Nn^Rl^iYaQ5a2d*'9FZlK$,Gk]k8&DM7)Ye-Qbh&5Q@SH"=/g$/D@NiE/Rp#F`4@h6EWMAV_?c/IC@aO\.?K'ZJ8N+21Ge*UM\4ms[P1_iLkANK`UT?!hW#!X(uBpg2!B=iRZ-:#Oa.t6@<9jZ`D7R/@mJ]jkpZ5O:[3Y8T$&9<'mjc0&-,in.#+nBgD^O"W)erH*MJ;<.ulW2:#:/>;LFIoV3dI0&56(.2%`hfb`:kuTN:lh2lTj3f;f4aR6ZVD_p+^((PhM2HA9acTI\/S;2)PbCuZYRl2WA@nKA!Ws-d#,F<[8qd]K(0n1])e#"n`[^A(Sm45J3pY,p2qZm2uNVD4gqOc*P/k:lr^4Z+aptAn,IhSnj_0>YXlr]KR$WRa0RqQ:40N5nU9b)7ipA]lIE(7GC=.QIqBC%UAG;FYAfQjCIDsr07S"p%XhXX*K=N]/a5s"B7G;g-c]ktoc1:tW71b1J4>l0X>5h0s&@@_T".$[5qsnOD<6p#<>fD8*%j@4>D_m"96^lVU-ZQ=eCCIWUM#NMEV@gjD93cm"VRM[f]`"Jl/8*JF?82#1[C4=aUeK53J9c%UFe3[?"0ea'-Z6jG7.j`Td/;0gDER#):oZ7Q!%+J/pVAPee%#5 -endstream -endobj -6 0 obj -[ -7 0 R -8 0 R -9 0 R -10 0 R -] -endobj -7 0 obj -<< /Type /Annot -/Subtype /Link -/Rect [ 10.0 310.0 90.0 390.0 ] -/C [ 0 0 0 ] -/Border [ 0 0 0 ] -/A 12 0 R -/H /I ->> -endobj -8 0 obj -<< /Type /Annot -/Subtype /Link -/Rect [ 110.0 310.0 190.0 390.0 ] -/C [ 0 0 0 ] -/Border [ 0 0 0 ] -/A << /URI (http://xml.apache.org/fop/) -/S /URI >> -/H /I ->> -endobj -9 0 obj -<< /Type /Annot -/Subtype /Link -/Rect [ 10.0 210.0 90.0 290.0 ] -/C [ 0 0 0 ] -/Border [ 0 0 0 ] -/A << /URI (images.svg#svgView(viewBox(0,0,200,200))) -/S /URI >> -/H /I ->> -endobj -10 0 obj -<< /Type /Annot -/Subtype /Link -/Rect [ 110.0 210.0 190.0 290.0 ] -/C [ 0 0 0 ] -/Border [ 0 0 0 ] -/A 13 0 R -/H /I ->> -endobj -11 0 obj -<< /Type /Page -/Parent 1 0 R -/MediaBox [ 0 0 400 400 ] -/Resources 3 0 R -/Contents 5 0 R -/Annots 6 0 R ->> -endobj -1 0 obj -<< /Type /Pages -/Count 1 -/Kids [11 0 R ] >> -endobj -2 0 obj -<< /Type /Catalog -/Pages 1 0 R - >> -endobj -3 0 obj -<< -/ProcSet [ /PDF /ImageC /Text ] >> -endobj -12 0 obj -<< -/S /GoTo -/D [11 0 R /XYZ 10.0 110.0 2.5] ->> -endobj -13 0 obj -<< -/S /GoTo -/D [11 0 R /XYZ 0.0 10.0 2.5] ->> -endobj -xref -0 14 -0000000000 65535 f -0000004615 00000 n -0000004674 00000 n -0000004724 00000 n -0000000015 00000 n -0000000077 00000 n -0000003837 00000 n -0000003881 00000 n -0000004009 00000 n -0000004180 00000 n -0000004363 00000 n -0000004494 00000 n -0000004779 00000 n -0000004842 00000 n -trailer -<< -/Size 14 -/Root 2 0 R -/Info 4 0 R ->> -startxref -4903 -%%EOF diff --git a/src/documentation/content/xdocs/dev/svg/link.png b/src/documentation/content/xdocs/dev/svg/link.png deleted file mode 100644 index 2290504558c4eb98aced3c4134a38857638af5bf..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 4963 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 diff --git a/src/documentation/content/xdocs/dev/svg/link.svg b/src/documentation/content/xdocs/dev/svg/link.svg deleted file mode 100644 index 917d137d3..000000000 --- a/src/documentation/content/xdocs/dev/svg/link.svg +++ /dev/null @@ -1,47 +0,0 @@ - - - - - - - - - -GREEN - - - - -FOP - - - - -Another -file - - - - -RED - - - - - - diff --git a/src/documentation/content/xdocs/dev/svg/logo.jpg b/src/documentation/content/xdocs/dev/svg/logo.jpg deleted file mode 100644 index 05cc83cc287102f522ae1932a6d3741a3d5f7c7b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2970 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 Q?2%`5Ui=#hFCPv42UJ;V!vFvP diff --git a/src/documentation/content/xdocs/dev/svg/paints.pdf b/src/documentation/content/xdocs/dev/svg/paints.pdf deleted file mode 100644 index 0320df31e213b49c1e49c4dfff59d042fbba3a49..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 11671 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�ZRg79i@&e7OYyS7)F(Z; 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 AMF0Q* diff --git a/src/documentation/content/xdocs/dev/svg/paints.svg b/src/documentation/content/xdocs/dev/svg/paints.svg deleted file mode 100644 index 14b685fd1..000000000 --- a/src/documentation/content/xdocs/dev/svg/paints.svg +++ /dev/null @@ -1,100 +0,0 @@ - - - - - - - -Paints - Patterns & Gradients - -Gradient - - - - - - - - - - - - - - - - - - - - - - - - - - -Pattern - - - - - - - - - - - - - - Patt - - - - - - - - - - - - - - - - - - - - - - - -Pattern in Pattern - - - - - - - - - diff --git a/src/documentation/content/xdocs/dev/svg/text.pdf b/src/documentation/content/xdocs/dev/svg/text.pdf deleted file mode 100644 index be96c387c98040b4107d6ee3a00622abea3d2bc4..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 29437 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

NBf7f}g{*A`msZ+s58DF({G5Fq{ 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Μ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 diff --git a/src/documentation/content/xdocs/dev/svg/text.png b/src/documentation/content/xdocs/dev/svg/text.png deleted file mode 100644 index 0a8e3ecf1b3d409853954d83a52ec96546b6e75b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 32069 zcma&N1yCGa)HaAqa0r3m5-fOdcXvKt05rxF}{w3BOpBeH*r?9KyziCWY#V_s%2)Kj)9f)bHxa6#_3pY|3_pfQN@Gx>q|po_dA-#%K3iF8l4N78vx1)*>YHF;rpuX_EH`!3 zg{~|`rZv&fFw<0`d?->HNkTyizhwc#0X*K9+>;+tzDfSf1>bkLZ+C&4y|;7RFWL?$ z%21F(Bx&$5{=ZLsfswP5(1O0aJy$_LU(tNEUBXu5y4&{lc3^7&^+hph-apP}HgtW|pZUAUV#IgK|A~V7S(+>oliEQBybc1>5aLR`i_TxLb&9Qi;g4EPo zMJua=b_}bg>coye0D63kJ9=cqn;qS`8dm{}Mga^}3%gN_BsYbu;ESivU3(5}C)$I36bpcD{CYEH{ZEu~E-1BMFo)^V?dMr=O?pUk{R$Q7}8&JPN!B4=M1=k=UTt6BqXhU`!ezC{f~+sa16l(r{VPYejcq zm&&*FQ!FQ(Fd@7!da}H^*^3-1-8SxaV(7?Zg7c0REPC z3(x<4jXW4JPf6nXgn5umYEX=$vGR;(xdCqnjnLw`<6BDi<8eEwnBY^b=ez^R7p{W1 z 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 diff --git a/src/documentation/content/xdocs/dev/svg/text.svg b/src/documentation/content/xdocs/dev/svg/text.svg deleted file mode 100644 index 14c88bd05..000000000 --- a/src/documentation/content/xdocs/dev/svg/text.svg +++ /dev/null @@ -1,148 +0,0 @@ - - - - - - - -Various Text Elements - -Normal Text in Helvetica, -Symbol, -Unknown, -Courier, -Arial - - -Large Text (scaled) - -Normal Text (unscaled) - -fractional Text - -Coloured Text -Stroked Text -Stroked/Filled Text -Overline Text -Underline Text -Strikethrough Text - -Text with tspan - - - - - - - - -super and subscripts - - - - FOP - FOP - FOP - FOP - - - - - - - -Filtered Text - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - FOP in FOPfont - - - vertical - vertical - orientated text - - stretched font - - spaced letters - - spaced words - - - - - - - - - diff --git a/src/documentation/content/xdocs/dev/svg/transparency.pdf b/src/documentation/content/xdocs/dev/svg/transparency.pdf deleted file mode 100644 index 1ae9e11286deb7dac3fcb47b03638633101e4b0a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 204742 zcmaI7bx<5W)Gl1Sc#FHcySrO)mc^~OyF+nzch_Cq-Q9{TE=7w|ti}2G-S^Hr_pfhf z&g3NfJjqEinb{*tttutM%+A7vL|qL6*C26`v5`5N+8_xDk+EueJDHQQ$~#y%BC)Ev zIDU6GGj|~ql985?VPoTBXJg}KV`Jm_Xn8n4gzrPR+1NNf#<+Mskp>{(rpx)Bn(UKa~G7xAcep-~9i{2cG9Y-Uoq~Lj;Lc z(#71w&DzmH%EZn5e+~Np{I@9Q#{?go|B?U3J`DX|`7q*t_5Z&6SeWy__P-5Ce6;_U z$MGNTe{~Tg5fLPFhwuL#56}M|6Vm@ZCTTA>Sq--jLy%a_Ovu<+xY^kGdD!^=9}e&T zA4gLBgTwRxp!xn6{eKq#s+iiCo4FyeYPg%a{m;$Vn^=A1gld=wR;PM#lGXl8$zc zE*efIW*;+2nR{59najGEcq6gOSlhXMT)G|^tBl>p-lWXU9KV~B8T@CbtJ}xv+ar19 zp7$W=>FKmGKY=bgD&|gVPmx-upv=r*Xnr#V!_tu>hEg?tipq6Gb)v5iCl@)Orv0I`|G_0G}O*?eOzb`jye#tv6E zA0KDu03Vm;o{sE-Jc4ghuUo`%Em~#Nb20fs-cNUHF$*`R>rd&eXhteV#>Qk=ND-7t zPJCEM@CXP9@K4XLZ@skjs@~q(*7EYs&g#x+6?gY<_6Giv8m@|Z zzOos0U2S!&UyiTZM41WVCKFKL5MbW6FKcI))62s1m}ZFu?`T%7{^Z?DG+U_nNK zuZsxqhy0$g$;;gw+|NJ@r zF#U3R^ml&Zq{Gy`y{93&3CIo6%IKkU25Lc;xZ7GipE{pkpdNpSOUoBP`9HyY0(Je+ zGV?buh%+@OdF->bJ-ak6lS74vt0Wf+P9Lf+>$pY(Ff%jP)Yuc}J#|VX6(!Bz4KLj_ zlX3GW$tR$VMGOvz2O6ognI2+F4L!Ko>iJe=tdNSlJ}k1{MC$l^x%xZ%)wi`Y^fq=Y zmAdc;*|6l~eFdveNO5tk?w?uN+YB2SE&g0xSi3+UlcBk*xQI5$D<~i)CFbiwx^u$- z?NzA6#1!<=F@vz`2?+Ey)&;L!o?qU6h}<|ID(3%K)$(jpsaG#07zUqy{;FCHr+Ob3 z2c7m3i}v_6xZ@Lc6dLM?DWd;gLy;A5E~y*RnqDr`FlFQ4MegUpWuwq z3ez=%5wRAWl~AbzhVQ7%?VpG3kj6>PU;r+rI_1kse@8-tLc~ zJJzwz{`G8I(ay*a5}U6rub|6hAJvH~( zrjVU8TZc-2t*4vECd;{kjMVhBsRBL5aL8tC2$|JmBu@PvyJr2t7oUshqop4eN$K|DLTppcVDE7HqTjL+F4j^%w8N839 z2_FpFzT|PwyjfbTb%Os5SmynQhK8Pi_V1s^vUbLi1&#Vp!&~oV>rr_2Wb{G?tD@qR zp_Zm5J>aHcgdF3_fekLihVaB0}FK7k_4G4%>rx;Se0z)C=v zhbLXRLMCO1o&VG8+huJ$&L)~^?omKxExalB-k)`W&X?B#D?h$8e8Pgnx`yVl+D=Ea zmgZJ(FN$pgCdGVoULQmfJ4Y}x^MQ%tnoii1kPEhQY}sLYV#3b+It6RDAu)Jei;qW$ zUAV2ewV^A}$;qp}jnSfo3mFXmB7DK@f(b~^NK4D;tM1Qn7pXv8hSUbCqc+674k?ufN&tD_gyW2CO|MSL9OFl_B)Vm=AT_H$!xnPSDFtS3BoV^__^ zL6&92SdNsv=0~r#yH1Ty+(|>q`zRHR~;$PJl7x&h4$bD?JvRs`k!5rRF#aZX_i`tb7B%B!@dAl z*W06+`@_eHx7ni`2^LVia>0Z=s_KUTj5z04nBeTYHjsh)lh5H+tOd;xZaQFv zm#2+~cUc?v_Lfs)za(NriQG&G`RT5NSlEqd-AR}o%?w{`O57#E&hgrbBR z;TaJLIZC3_`kD;7eJRhY%Su3&V$k5b2RjE7Z+CZMH9Nz=alX9?#a(%7V>-upx7ayntc31}`QaF04`de*1Bib@AVIZsDw{;~Qw^0MLUMfmUM*T^WCW&Q&GH{UZLg8|+9Dd(TPgl_A1?I-( zpe{|+gQS5G9eO9Jlk}UO--Da!ssYLb92+p(lv-}woTliYUIY<71w;53S>@}v5%CfV z%^+rUf3bFwL_Zl&UY$2%ikZwWT`>ng%gg$)-)jk~`rX#%#u#$i0;;N_e-en|A8tmt z@44HTEGW~%;yV$9_e41F=kIlMT#?Go`S#wHo+c;FaY<{GQwQyglsA| zoPkWSw6EYj$@wqaY6T=@eLJJd_Vu+E4;~Ym2RtcQBQkOXWYUzo;`)(2Ho^gqB_qcN zwsh69SmYoPs1XK+d;{fQegP)V@@7^Y*~2iU$wQJ4}C-= z_S05-ua3aEhOBZCImSqQX%27e}~C(%w}_9@hq-UYq>yq+^qwAk48|`$Uhn zCK4DDa;wz5c`wu@!TXW@=y=w;PV^=Xpr|VR0UK}gkux@pr^dY}TNAqR@~+HaN}T%% zY6T-+vnx0#WZFT${rb0!lg+)G?*H>goayZ5Kq6gsyu=R+- z)xdz5qpYo~!M7GN>LV1hWiz~`UpnY&(WC4F)noDtO`+botb5EM#&s#|3qLx;N_|%4 zQIj54MolFAY%$U+IBrT$d@29pExaxmL4mX$b#)9e7PHxL24$0Q=jeIqFrAM0+S8~! z^MfnGKqK7MyWqFoY!oFW^IJvGhA+Zcg(Yr=t}6zZiYYrMUyjDq1T`NaI6H9^lTzNe z%+eP6I&G+WPpiXE3jpCdW*8r?H&tvl;D)kB0L3x`5tk}#@Iuo~9Q!nwbK~EX zz&0b`$*H70>ybL?x!(48w#!#93h`+xGaok2HkVpFQ?vbo=awTJGh)Py@pF`F`9EIr zznIug*(cUrBDy$+jjnY`b8^cKY8>t4Vi6YiDvmf!LLSB8+uHqLB8$f?E#Qu%`Mako zr4GNiD_M0?d58#S=m9rYE&9ofSd26C<KblWJVW zn_C56AcL1`dHzJYGoMtX7Ys)Xm`F52M_ubWJx=Zr#*b>)@OOlj9YR`Kv~qXg;sjus zJBki8VmcJ;T6zL;K`(b+0&4v>pW5dB&`Gq&zZ#BSoNk=iR1eoiVw)Myp~>N-!IU zQE+`I`F$dzk3y*;2U1D?`E7c7HfjS1)c>CMH8RTJ*fW}Uz;~sM#VY}SF`2Zmk2&Z; zA=b?N8^^+oy+0M}7I4uq>1y%aNCFX2jkBag*ayM3ns&G5U^6RO-}tt!vo|Q4&){07wLb& zsR)z9Nh3!zyt|!cr9-1p4Yihk`7)RhN(cuY9*f@jQDX2zUXH65He^17#ld&mO!sL< zH&LD+d_Z~iYb`keRWT{Bv8AP)_*PnO>)m_WwYj$<2DWrP)hPOUj z(}=Q<^9m8`#C3S+))`opV31B0#oOnj>kn8mbDWf2TZUhpgvN07dMK*wpyo{BZ1Qdq z9y&GHi*s&ZrR`~3Xj^*%rQLa)GAAM4`I z9v%u$;9~{42RjU&OkC&lhXkkL#W#QgQp2h2#L7#0b&?g?yMLrVXX~UTrxsOL!<#r2 zJu$N=))$vx%5n=vWa>IpaSKbcq1^v*o_QYRYdWoiUF^>OdD^LOkrO71Hn#mXusgrI zJMh+;ZjTFliAcy!gF$(GZGH=PySg=2k~TIpgy|ozQ!_I&i zV#BWqG$KV0|J6c)wt9q%-9A3W7s;+02D*CFhi|9=Q~rptv9aLvA7y|_@pb5iU-sSokSLm@ zbEXsI;B5fVM5Z)LsgJ|5<|ufIe6dHMrFh2%D{f%x{hVbVrQn7ei>SFW$GZBg@O z_2>Mbc!RXUDE!NHNVX4o1DIQXr~98-GvoGi^7~|3GtF-kM^gAepZMQ~{y91t8s%9_`cYQe69|X!@GrPI z+Io_n8A%%jxqKUF;I2@7eXjd(ODK&@ zbu5qYPSM3#IKs-s(%C1H0~k7);9`J1{{IYnVZkv?`&%_NP)j7f+&JH-*-*RIGv0N# zBY}0HN3s#m8#!lF{WgYy93km5#G5raI3V^oB>l#t-&%ALP7)XTXE-h>Bg~2iUyd(M ztTI9(_sY|Usi)YPe+}0Z`m2j5&cZ?n+vD#k2xW^bRG^nQ|vjVxe!bNP>qDOus+7=xsrvyrfU z+2;kLnu6hWy4t%3Df;cf!7#=hQY}crNqKV{rEf@qkA%o60nsabWbG{m?UA+Z@=r)k zQGrRw5-4ZTmVYSgF*4l!yjBrvC2-g4_h>ZCG=@)6`mVRS+8mdfh@lwm-@n;->u{o9 z-`o&nnzGvRvn#HA1N$^rVEy4ya2X%4pJh=7&844n>ElU3VP^e0zOac6g^A5uR)reh zFN;-B#)G~<8jxqoBB2F5XRH2U4gB}_VuSbSQ*ZB*+c_-L4|}Q(#`NiZFI=I78&LWR zA3O`}u7M!PMQykLl6aQdX9hPkPsiC~qe1oALeA5j@bKfL`0gU%o5XWkp%3 zpZaF3wopn2yc&sKoJE%&-76M}%C~8mybx`cpNIvM8`OW1Y#>$CSf+-sk{NEPqaD)~ zf~~;l;?;7_!W@~s@OswhNXJo!qJ3AKZ$bEWglM0G+SkjP-Dmn zXPMJ=V9Ep_Gx7%_rEDJR3QBB(={IJ}2cnIW{P<=jx4DW_;iUE>{^C*CeF@>W*T@b9 zJRh(SEEx%iaQ4Y{bq>VQ11I7-nmSt93i8BylHf4ClD#ed#f;n1CXM{Wod>LaH_@*l zAuq_0K1k%Mc@N-ff~H%uR-=d;s>IfU_SBTGp~*5KOpS zXfQUv>RpNS9xhb=!b2(-DhXCC(>2+}b$4MdE4Bi&J9)6QH8=M5csfPf?!_6R?nNr= z_9q#S>4U{2(y|`m*3*pd--di;a0PQfds<^kBLT1@>GH$Q-hjBoDsveo0P$YaS8hZU z46`DHj5)oGw8jfN0{C1ATauc~(p8ct)=xTEPk!R`}r;gtD_;?Wq=9^g_|aECi<&(Hs;Cm9OJ3r`$7A6K zbV0eVqNXkM*J;B)S58Z6z3&p|2{P?WY(k`sw8=Bh6AgahHNsyfT>>DLfcS>+SK1bZ zTTrc9w4hDfM%9pc2q@$2ehA)SYx z!Ju$o0nC@hZSbH&6<*S+RsF5IJ{+ec9nZL4VuxX{oXQblu8lCzoHL%S!DY+IPXKkv z`6^4GqGD;{=7B?h>^xQdTlcGJ#%HD`-T3Z@m%F=W1@G2yjU__7Sk#Jgi`#yMi_??= zg$pENF>N&>7w?8LitqA`1Y(^l!G9B}M$QK-R6CnVJ(6nz@1|QYrW4(#B~gt3Eo&L5 zpEh#INHV{^|A4^nd$dAl-aC>@09(;PK@YU2Z*stxY@0t%R z_@zm}e^prPs9PWI9#ix)GiM@%`Hk z#~w`b3{c82YZRHlad(v2l?W?=~#thA?>}Rrmmx+nv{55N>oH8bvewWH2 zjFI%~N9X~uy**V*<0~!eXWU{UsVJp;`uX4HYaoS3APG3N_w8~>mU=e8i_sbH!bVCj z8fM#}idn@xDlJsIr#C)*)aT1v%kf0Xx4p!D9=@(8W-!Y8nmAMwyQ*OHh|{hpo?8Q5 zgMh#?MH$~+%}k4V+?dkih&j>rCEhrUZqPZDcr&8gz-(>)r&_Ai5ulnVAD@t4t%|&k zxA_(>(3<5=M`*e0EJowOqlHmssy3B&evZll;ZLV*aS@b<>g{ z>xEvCwywsXdblw*Kc5^DffV93H_K@{et&G^#v#l8&8}>JSG<#Az81j)G8EHHS z$IgJPkS>wI@NY+Q6Dkqn_ag0kQ1OkX1=Sw+#X&Z6i!PNCZ%Y~|BMtX}IO*ConCYbl5v_eH|1}Yv7uuFPnN_q{x>h`!!kZ{;kO^gu?u zCvicWy-*r#=j7gGfL{#1y|ySlGC$$V+<^Jd0?_Sayz}&pmLuhCX;lbA zA_VlJ_`eZjpPyRUSJtqw`d^=)Xl%Qc9j0;LeGyn#>td-1(7Q2=Oeqb~-OcDvfWf-=U@6>iywwN?nQZ;xy9l5ns`N*&b z{Y&@KsJ-&QGNhuc*WSfp6%SI|tFtn7GqrHg`n^@V6Zm$*3Jnp31Ain__s3Q;Dtzhw zeX|DB(K@Ue3_IK?&x$luS0}dJ6_*}_c}*h4V6R${^A(FIjoS#OHHF#OAvi~(GEHdgav=R ztVLQxLbU1OIBTa37b5WzNs|5pYf04brv7>#^EE5~S08tm?#dNf+ypcOz!_1=EH#At z)GHo6BA!%y`qQCqR1swCwEz4ggd5Cl#?YU=TSJD*FV^&Mr}>PoS4kFECPVQ=E1zi% z&vFh6g$hRI{K||viNNS@_;NSVH-=;~R8EuozVCCG?j3*t)EY~1GMHZl!{N%5jJJPGGC9G7~i#Vv~OLCS5VsEE?)md3xH8L zz8J(Zv8T?IF8gfF^|tty0S!yY=JyUj32OXIlRt4Exq>t&(5V@2lM7}j$ zOE!KHpN}M>-$q0*OaOOu!YrH2z0GPKDMxWE= z-z7<|{#G{v;2o>$iMIaf&)@qj4@6#o`1!89(vUN%?RY6CAQ+pbMDRS7q9VjVkN-26 z@22XvW+8+3o4y2r{5ExI)jditWJA22hC1arF^`@$P9Lx_xq$b^Q7}V z7W)Llyk0+w=JGoKPXcO7?p8XrHK$U15-^DQ#Hn1!aPLb4^qh^g@*{Rb;pjolm#|7z zMj0*X3*bq{7rReuBtUH3liNFd21IU#D6)UXtBODBh6)itV|zmY-d1!KmhJBMhZxg) zl_!ws`^oPF-4Ov{Ddkh8Db!h%HGWyaX|xmMX-nr~r0%sZ6pT@p>r{UwyKQPoytC$7 zSniN4rAU=}HFxWeBQ-Kmkt^)z4&}@vCdnFAiy97zVM&^S*ERuv!FWbYX+SN+_!vTC>fYDDVZGOjy1=JH*#?jzankC} z+P1D<+Ov}g2rfUZu=e9; zd+1Jawt;GFOia_=ss?!!>Wi<8@;UEMZGEq=SAp+mM(;0EDg~l+0Lw8emy~qQ2*7+L zzN94fcA}pub;N<(((pf}Tla@ZpnNVN`&Y!WqH`Y$HwVfr}lOQE!OM}0YAE4 zYhdITpR4|mIqThbK9k_4&hF1$99$Ba&h(A~Z=GY=HK{+F55BffvgeB}`@7rs5MvQ2 zlyf*()xv0e!oaH-t5|gw5$U1=1U`Za%j9QOL<4-@|ISeJ1yu4fL|GYvo(#c6Qkemf zW0?80wFwqmuWuyrFrNXYTIhjZWJaPwewwAm6O7D4QZW#!*_tsoH??}*9d(CML=|Gc zRPXqNgmF$-fT{L%{nv&hx2v*TuSa+E%bmbKVgb9D4a{E5+3fQR+MyE}@JfLQgY%j8 zu#A8`O`@F7F#5rek(n;^0xj*|tmAosZ`X^mZUriVn2bCXk=P~#y@Jgn;}S8hM#g1x zLp!4i1C5<@duniusL1SYeZPgU8U#jNBN<3D`=hmVkxyQExN*SwLVkaKZTI+oL}c$Z z8FQ->g6bIN26!DKXomgBBMMg%)aVr{^+)lA0{w39!Q6i@$6Yp^LdT%w>0DL#Gw3$Py!#Ii1<`m6)j&Y6+V6If>zT>etWBo4xKLc zt@Wo<JgZR?90EUV)6X$U^UX}Rp)#6ODkP~3Iz=w7R6%^!hL+?dX^ z-X+vy5xU-ogQyz=ITj@#2;1-3(bW9B8YgAG-zL-}EUJ4E86EHu!$0`5A&$OaojjiB zj|O_)3H&!h`c7xH)%8AvIjr_@jjBA^ANPC8KKMx{=%A@k=ztBulFg=}8!cd*n$DiI z=;ZosYhz_a`?qBU8$%xYALFzJO3>GhSe|LF-p^bEzuDYN&5rsfvB;He;1^E z>2;2gT2-UFG&?5Bhe??8$pjN-=@IomtTkF|8w)FvFWtS}zo|3m817YA9Vnm__EGeq z!8EC*zwK2^b3!Rk-3Wy1^lvA98dCC!rwR|Yh;4gHtE#bSF$!2#I~RT5L=Uub}x9bYnfmyTsIswMlYW|fEq z-%h`L`dLItgawI2%OeAN6HuW_E*?R*2@AQV>R(t{w{BpOheN#r3N5GcH!!%yk+OEX z#rch?Q}JQyH5MNhl>B?HJ83uXSM+rn?1x_}!#>!zJA&kbbTvUsk)hIId2Dx!fwi4!L;nIKCFVw zdih0?e*@1k2}=nPI{&dTGmi<7|JXje$6S+jv=5b+gRlxzJ!Ha*Nhfz+&K*i|UQ(5u zP#A?IeqvqoBz=G}1kXys`qkQKfV^pC159UYC8;Olh5 z@L8GiAKAJg@%%iN4L7lYr=o^pTPXOUB9|5eA623qHQ!Btn@Z%e4w+})KW%e5?XRgf z&<-XLA%t}6CeoYrpHNlX?de;ZdvHBp{!BGmSj8Im)uUqm^NHd{pQ6fZ`6jw19m{&I z$k0g79|HQVLb{JKc{|gCkPxjnS>2+#8Hb`Y;!9^^S-~gi;1f2>kTGS>aqdJA-0ZoB zh^B$SP0!f&dGICLB;uoZuuDMBL86eil(uFXPH3C^P@}a)p$bKQ9s7XkbhTaTN?of4 z9KswqT2BL$M&6V5^bO~zenCBLm6`Aw4=%4&`0%k~qf^g+i})T=r+@;uxxaWNCHe5C z4I^Ye#cW{lpy&!0WP~Owj)rk@iwn$G`d$9GMmx{VYpc zI%HsEkV``95F*Nd*Z`tocFHQI3$nTYtl848P;jE}rbg;W#hpLH9E|BcPDgCsgS|QAngx7}V5EX!# z`Q#DI|K|^KJiDUEAqo~h&HPL*FYJ^vZ9Ejd%!O54tVO0jX$T>@2V({2@&Gq=)0U$- zj4l2Hx6WFbp-`&94U$%aaFCAO3~*(>j$h_9!e?Cq2U3KU)eg9g;Ji-}==-Q_ys)VT zxd8qDZS_PX#3(Y_WY2#Yv$ITo3Sg9&NmHeX-#J~wV;4&@G-*h#g4z{`) zY(5k!ii}3DT=4JYikn`I0Mi57UT zaWUw=L-B}sM#-V(PMf(#(RFx%JWdp8md$m`$Lm8jR>JKfed7dF^VMrb`TzzjnvtfbOITBv&zPtA@v+l@~aX*@EYz=(#3O zRt+cv=tX(?)1ytkpl_Cvp~Y9Z^ZA!T1-2P$0dCIc(a|pz*I)iz-{Ky&#MShyo8y%! zvtCSEr+U+jkLs^cnLo_k@ca0Jg-#O3+<~*1q#}Sf^QDb#n>IhqP%+6?!Y*`g8O>~^W!CR`#!g`B+A)Z8DSV=tiQWpI_ng9><1*&emOrp70Eg3 z>8FmKOrk2Kw{*7DO=#5yTgeEZnaqtEf3fM1^e6;`Ea1d`-i)O8C2yk&>F`-CDrqvH z+dJ-iCb1F0%AlMfN3?xN8YT1hu|-NXV###gZ%`X-r9&t&*z_hsc*oYZ)vST^IYaD9z96O>R#jK|_sBd`mG56Q?1@DEK*5`2#!k z3)jr_jB-U<>H3cCriD?T8q1_oW(qf=eY%*Xt%kd_cU0qGbTlyX2$k`9&51Vp5>6SceTOwnTlG=Mjk~iBWv?Z*5+ldZ#@1MUnUPT_ z3)9rIDETAE2I2Pzj(&N6D1}+MhL#l6fj|i4Z9Bf=E9r47EY)VUvn|TvPiF#rBviK+ z-W4saZYJ+qZnDE12v>{8Uu%*4=1pVHI`%s_06ycgfYqIy)&l-rez=8-e1w<|WYX|n z$A{`_{773@+T19R4O%zA0dYZ3Q!_I>It+4lS?}5fX9_{NlQy`YKurBc2U-4hb0l87 z;To%2!4YR&#qziPnv)oC^9UqH{p;2ml=v6p1(6-Jj>b5n+{Z z0+R^_kqcT*UDL0SY76qVL8`0NRY;?03v&6j2tj#FlR*BLi?Mlls0jqbnM&fuBc;iQ zNRCzC^=!gJ2%xb1voNnY0lKwNdMmp+hBHlFK+1tc=y2tbyBXE6b)H&EH2}RtfyH;X z(VPu?i^f^*m)22jfOQ>?|AnElC0|h!cz1&lP%1((f9BEH;Q4)KS<}pt-7=l^4_^F0 zo9m_-La~^xgw(Q-2sn9ZPx3&-A!IgWlTB?-taJ7!KcWH&tVc^FBZ;`sgbDCFopS~G zMCt(jNtDVNEM|$W`GQeup)>-$bEDSu`|3JuOP$fl@>Oo@_Zq%% zXUtzSoA`+29Z3;{r|k3X^kq2TXLw>q(F6(hmwRldf0=Obfk(s1k$0fn`54UzTfWzL z)5XeTa81h;b;TAQ9^Vdipz4WBk3Ayd!V4f3%kM4fYMGn>Dhdyzt-YnqQ3H%Y<|u!0 z_|k<9)qlFWHVHAR*;sv})ZHLQWz}#%8%%mX;mkWu(cbG>@USw1uaYkWl{2UsFV2dn0iM$o0N=47sKLl+C#IOv zM_{jM+PyM)hce=uehXf0s%{i57lj6Mm}&=5W45+GwC*@{yBFu0^>ynPPF~(dO56eA za`3zd4=}tI85NtA#hFaIzZU4SXw*9$&L_NLC`zUl6?dumNg=gl1Vms11*i``>Zj1U zH6BUMO;z2oPA?Z)g}W(ht=I`l-#@}lJqf4ZQxsH-B}*5Wa@I*WJh1D5{1{|UJ{rR| z;?lV^4Mb8|v|H_Z=h-<>2>{DM6YPCxJi+wAlYkC$8_l!^rM-BHdSo$ZKiy&~_162i za$dYxaSpRJeX^*Y<0unVVTcx`MOYlV^m$}?4`Pn)sKEjjj~VVRxiPoJ72o7xk#qN; z$b36aAgpD)b^_&$4vd<;<)Ya~eJt7ScIYovL6NV_C=7rpnO5F2;_ctDL3;5pof@GE zgPwGZRJs~X(!Z*g3I9-6sg{}~^8Y<;JuSR&LkW=Q@ul0jJ!ZGsEsG^OMzY#|xp2lX z|D;{Y=JA#EvClZIad3+gONFuuT|Ex2>y#JBT|BwIh74y{c})kHO1x-6GE$F8ro?#EuVg*$ve z;2S2=S7RK@3*sm;=MezAX!eNJd3;t_!bgFyNWM?Ur0JN6EARj*pwvqnZ~5sYSoiT< zfcYf@4udGhCrOAVO=3X@L%-u^ov0&I+h_BEE>-$r1Z%;5R+`S0KS<_JBX%rTjpBzN z#!cW1KK|vCHvatt&6KIu7|Wc`1h&}>(5ZjM4ESP~@`j|~EF+3aMYLEsqr=Q(p+a|e zGKy(>I2;`!V?rY% z;^Vy{p~sRQjlL5lvz@=N z)bw9Djjj3va_Di3-So=vTZ{j(Tj}7nez&$hQDh3;b3a;Cw+yX*&ec#ZZeB2Jw&d=` zFw>N5enDk=0R5h2id}es$&Y$=E-9H6B^#aBb;BG5dx33Sz^ge^CU6o4L}Lmd)W4N1 zYehM4BwaLBYGx8Fd~z;4p}-p8H4<(4uDYf&{r0??>{TWs6%uf5%P@^hByArQtP3Tq zYgGI>1i<_!&bfBfmZdatPEo<|XQiC&ZZGqO9`9-V_FvV}5bR(x%p`#%&<4<&xo78G zraJ_}aaJt(MC;zF+aOgdYZ7Vhdn|J{L{ChdxTT{H z>jIs+;p#CWcVqSBa$QI?$<%9W?`N6RW>~Q6n8#VSpNYlgi7fg@0ubzAwF<2Td-Cs^ zcPsHqw1tMprdy=J#b4N@ys3`r*VWB+)9!#=JyFJ_00n1_OiV)jnOHL#>4LOi*iDL7 zDlDq0%hfc@gfiFto(aCOCOc))MvY1sPOD{1Jk)4GTUcAND-}4aS=WKw?v2&;Dppzi zVmI;gm5p%ZB#D5 z^;{|QzN7Rcg5sKAez}^qJM}sIllpnNl9St-6UhlMgZfJfYaKBFWc#i+O+vqa4kpL0 zHYl4vI-BpL8!0#gtGQDO;1RJIzEhGnjnl}<4TW!v zo_>qfOBqGwpP48>d1__jL*xs&|6G=uXVbwV$&UH!{woXbW*nydvaE{=D!2N1es(>v zwSF`HX3eXt^RTgt1`Gaa9mCfPvz6FyuI=PyNK{7(6$!&G0*kIWo{n8!W(v}`o0o_~ zgx9s}1E#F-%rp}oNF?dfY<{xw=z2AlSL3AIKg6hUxpXf=5;>NO2)pX)yQUUKwmeEx zkI?X|3){JQxAR2sej2#%R$9I%>6*6|I+bC`%@)jN@ed3h5nnO16@G;2^?iEH)2+af zQxZK~111#7N}GGwmsRq*Y3{UydsK_pX%esGBWK353ii_k<_20u16Y13dcR^`bPH8G z)fNQoyG*s_PkE-8Fpe`zbIrzlx`G=cP@A;3W-iwPOS8W_Y{lk5?Gzcz8;OsNI_H4S z>#5*^)z5!8K_TcbGnD-j?xJ<08HBs|gMIRK=49y+6V$#CdLYW)wfpme*{+OTyO7q{ z*tu)svfQqXQ^YPtMQlHbJzx7ebF+wCv!Q+@7NPzh51>|lml%8Zt%Uxrdy|XE(tX5; zx%dM6G9o^%)ZimiUYP*;Yo;P={K~$_eVp@~tbnvX!9?`6CG+uag9mBk2 z?7DE9ZPFl_C=~FRyw*W%Ox((}2<<-i0YuBO{kR%f*dV`zLcuRNyks1W%xk;!C0g4^#_t9$6Mtgt-_$cwk3 zE`WT+Bu8zY_Xe$1v;71IL#dawisy(+$56mvomLO zNT;M8o^0-ymD48}GXEcI?+~3y7l!S2+%Y<~ZKGo+9d(j7wr$(CZNIT?+qP|V_~-jI zI)ii8I)kcF)!Mac?ZJNbe(vi+O@X9fWzI3-9kBYWv&gQ~HYTj_#K%`isPGoBGr~eS zuORgx6?}7P765}8R}%CCM5-mM8%zFtr%kL~TQVXJg2uQMHAn<&cv93Yn%9a}M8!Ti zH@B!Nqh+A-enpz#6|9gD-=emtksqq;$pEA@`Wv)J9=>NLn=X)WH?wHSXOIG}>hLoI zZ$?nO`_RQ~E{+&D$jwexKTdWCTgw_%6%biOgD79p;8CgsBA8**tuFH+u=Fv04WUch z-%EKW@LIUUVImut-j`Q$^@jg~ubNw^CZaQokIjD}{Jc9cL)MFQ>xfOZgsc#IeBvKv4q>XU>k^I8OVV^zQ^nReP zkLn2Q3TW2{IMJ=;Ve)LoQzV*;YA@C-#pYN;j3 zmeN{@rBkXqDtOtEC~ zGs+6l1WlMe0@nneu11oFieAYGmCGDAE+(A!J8VTE_G&yF#0!!&Zme9B88nZr5i-bF zl%R8BudFjIkwqWV)nLoT28k~~ja+n@-4(o6p7Nb}?)ds3=zi_L{(5`%d6DXMe|b5D z%`&a3r5QU9hj|cOw~BYl-Ns)j6e{Ek+$1ZQE1i)O9dyN6j!OsJ&`)S!Xrw`yS zj<<;RU>7;~>gTvo3m0($7cuPsi)cpE;rN?xPdI{S-QE<_K0ZbLnlU+feh9U7{Q7fWt}p7d&^loT3`se6 z$W=h(=To>wX^5M(FsP7`te>oo30Kqn*#CrBXnvzvNDznvcxUG(fmZQxNR9^c2^+sq|y zgL9snEkZ(xUd$Sw$-~2IK{>hG^Yvx7+2P@|oieGQCSMYuM}k(f*Z0t{-npp6=@q^}(>~Ou@tEM${ybo1dc~h*OVIRYnUI-L{fIU`d&8}{zkvm*&9q1T`Fwo zltkuVm}MUX9FE8r=l==#dd&Iy?hac1LIHlBKkIn8T!-YFkX0>1cj?TX-U~m=F=@=2 znhe+fi&h^S=TbC@Rx66mLwlL~rKKZE_ff!G&!{Des&H?!S8Ve`S^KK@tjRoC->JYj zH>2-BDklS9&i4l`a^uuQ1sxiOAKUH8EJ@6d=(;A%a`>2NN!gaxdLMn4`Htn@HjV)p z=6wxQ*z^x(=Zri<4l+6Xt*@u^YHuju=RW`Ey)^J*=>pnbZSsmx*-T@*Y0PqhmCGtc z9F$qVxGmqMrcKEWZ$E9Ab~wHr^zyX85){LwEm!L!>BX5VfTJy5%w^!hvg)WVfuz

+8DMJ8+JfTD5;}OsdkKTH68(Ic&DOjhcE*Zc0p)UW=7E>& zqp-W$g4g`ZL5<{~%eT=54lKHsDT;=AK)WkZF}gC9=QYv;D%xpwi+Nv9lgV5OZ7rF; zS-?ywOgju+U;TMSqv+pZQ!sJhI=rm$(|62`0!61=e!h#MwPdAO$0F!L%cRu zh0U1Bi;+DZ9mwAF9J<*4e0MUJCVin(p!zG!WJ1nkmaI%=&mDR?_g=-Pr{=vL!zjr) zsNt!>@^D@`vu0O;14_>?rAoSeK$f1?g!NZ-lPKT8APmj!)4<|{|F#9ms8q$$3(TJS zqHp=2B!ZNDgYRk;OTEOoIw({ax(fQykYaykQ0*d009sHIP<4g|haRDAk`SFH%W5#3 zqj`DyVqt#?3{Z~;*mk?>t?v4K%0?JZQ8u`g;8;r(Hr7mhYb2}I!}B(PqBviBS*Ovq z-GPrT*vZn3@g5xe%sefk^_fG!Ktc?Ha*s6UEg(@o@8+r;lJM=rd``D*h7)G!Rjj zuBdQRe!44@QhvWh{QB7L7WRC6~y)qgX(azyF9CiL806l*cHS%H zRi+tNB8Sh9GLF*j4j!yg_NX#dwbbOCm-GC!hd;agl|K-%7l>-}Yn^0mb)&wz24M@Jqh!~V%GTb^dcw7JCM3S7}Vedj| z`T0Iu&M> zrf5)-RVs+aM5X5}avjl*nDqD3X-0=~95!_WKld8zlj59gSoDb$>+9opKgwHm*K2`d zq?v!ceI$=Kh^Uj)XLN*qnn{>J%G>z%<|=s6 z6^7W|Amf%Kdfjk?dq^DyVMszMOz=7^j*g_1sps44 z($wteDw(sQwmZA1dy|hnxG+udCAS$pRY{=jH2#O}mq!I=fZ%3|awB}@YXX$*kA3Yq z+VS&*6*m}QRcqSq$6NC<1kieQu`ca#-JqilNPJnK0JpK|`y5SFhjOmG_9sINRld7JTq&?2UCQyVUqEG(J<%4lT&*~Y-oFw`29VXpR%^67GI z$G!&aTxJ!`hnL>YYlZH%uajFvJ3y@7wJ66i!Y+TXj7EV$`9DIn#od3479oon=Mf|y z`}aztgx~Qky@E4@rvT~fq@;10g>4Eq%|$CL=f5o=N`lY{u&FD)8aK2&$rgJjx;C5I zWszn$jwJ!JRivwR3kx8Bpd)H2AI2iR*4o;vS9P6-AmyvEmd^ckyR?J%>MXS$w!kDa z8VMDZbyOu8|6Dq9xFVpROJJ)lqSw^%SZ}%2Fjw&Iq0=x9vGr@u%k0gYWu_+wtDk_x z@4fUjikd127A6ppAhTQI*h-ha;3)_JHh2=T$Q2=8EqEUdvKp#2F(p8_dx&tcC1Zpk z26dgHF^7VJoD&kemq+Xz`V=|=G$)@E#M8zY!3A39B4*56MUw2Tw6CRC(2Pkvc>DO5-K%VL z@3;@!RbW_^x!I31&ZuuNE;7zr?GC2*r6#FtZkpe+k;ubw4q{4zAYI$x_;dLJ_9=ba zt6}SNv~37$0WRVeEKXB8E0r2fE7iz<<2BrI6*J5(?nnS&?i`}~-HpOC6&Q{@E=zkX z&;9vdC?N*bDL4^|_7cL594AvCnaj$E5IDcG`!qPquEgPstDEw4GTjJ;;NVYF-nLP=?8BB$47pK*4@rSIS zsz0B+_?;xO`~DzbwZ(Oz5t*^*-Ns?q*wZ-TcUC-xIO2Q=<9#<^9oQS#CHt4BD#9eP zZTm_VyGV9_%Wq)wI1)FN_D_JpuioQJ%9|%Lr5#!2cy)@)t83vVuHQf+mJjhX3PplTWkW6I4Ib>&*n^m*a8c2iKuT7OV#sI}jnkvaMJ!fZW3(vn!5Q0q zag|E&ZGWm(Zoz7*HvN+xqysaC2IQ_qG)rM(G7wHr zW8v2QXYZmIuB6i-c>hACoSITr%LLNN31M6jEgK3cuubpJ)W~Q!WM!dqW1NM9`ned> z5Pa%JEe&vm5CFQQu|WM@_M?~VlG2sQS&W<;E9r%e18W6pgtZYJjUsAzkBvl~v@*ub z;r;${9xis*VJIR}77ME)R)Q{whf27e+T>Y7@}F+{UmE@%_3kdh1hd=s^6;KyTQhrh zaun?6(r2S7X4PM?PuBXS=HmfoY2Nn}0jJ7xV#d9*Yt!&Np644wMWUOUvtUkfEdRPX zOavfZ5kPg32MzwNDwwml=!DXml~87!b!;TA9s3msnhPR6oLTY990TLsaoT#H5<%i$ zTtW{_H3qH%4 zz#sn7>hSiWv~d`()TnNjrr)L+o{j%gGv9$**(K)+88BZ>+za{s5t9%q*7NcqP0c7$ z5lY$vg$4ntKI_m+v7}UHOlC|7!SDm&s~eed!jY?_L4o0*1&b8`K{QluXH5?89LUU9 z`OqP%C*cR$6w&3d4xOnm2M`$5tF(1hcpkkQBISemVlEd}4WO)A>41BdZcpheB_I-L z*|<&XUhp6lw+gO64-!z_%%49G|7t#P~U7YKeP?GNoXi9B%0>ap&p{mNDfB{Zvu9pDcamP zoQ?YQNQVh$`k28dqOsEsDa$-8QG$c7uqb}_yl_PzY|H<4e%^U`KU>oyTfXkwfLl5r z5ijH*2XI$I%_W-2G!g0wo?vmZkzJGn^FAq{9jhNqNzTaa{u6ptTxC7bTf#L=QRjtF~FW?d*eL8IB- z5!HIn0A>XCOucb3O8+h7xoM>4=Qe&D+SY^33Xw(KfaGFLz=S$t2oN13JDk^n!5pq# zX^pb~vv01jRcuL0*Ur@{#4%i}Xxw_&5G($x#V=yjCrL1j~GVM3y@_{01qBL%{5x{Ma~mGUsR>Rk|``c#%Okgs>027QGKv=BOitS zslcW6lMiH;-|`s(koc!CdAbFXf8i-5$BtI7l;)vxsm04eEkmt;W|BoPU}dq`x$_=h z%nPqM3x%c@!+PVqKR;Z7_kt8V?osIqrth5rXY#Md)rAJAinyc<4|;`@FIz}wzxA;J z==`~XGi)%9nO_-AfVB2Dtkoc&2}E^g1p}^}?0MHtf%N03yZcNwAH=cqVpp^sbyW<` zWGyRQ)RmoBm}(n~P)(b=*FMb108EswxeB)+ngb*i``q!lDRUpJk~y=FM#Qeh*khGT zq#^s$kFJI{ww2Cu^BRr5d9g__PrSnf8x$r}2wFE@&y5D?_|(nReD0!kYdLyK{Z##q zxWAIJ5Eb&Yrx#Lid;7yN_MX<-It3}U^?8Q%xV!o80z)Hs@`3Z3WPkW$l(?RbK89ne zd_6sDEbe<_vmoSwrYf0yClG)Gd?Xs{J&Q%EPr^X_g96bOmV5-2A4$qJhEmoOW00LQ zA4KhSEH;orN#1fmS2&C)Q^_@Dyi0w&62{`u{a6HMi}TAQwfAyf=G&{vEZ)4lI4TPj zbEG!d&;Isi4wWYHCjGr%)b&MJ)ba%DV_`JQTJ#o>a0E5-p9O>FPE;I4ASL^jZ@j9T zjWi85Qk-4_S2Pcnzl5D5q@u12=)CpW4SDrc5>@StD3ns~oR?htCC@oi2H7Yr%Li!Z zdxnJeovY?`2mOBPFV4;4MIy+pY2C0wuUF|`EAK%?$3|)xsc<;6#Lr0%nQ=c^6@hQp zR*ZiWMIR5}8<=NcGOfa@o0LJ7&dvHya_q|wr4?YCR`#f4*ni4~QbD!_Y04=#By{2r zJ2Ds0G|*37sf7{MbJMx;SRbUKffAwHCN_oemnE9SjyGnkdw%S$tSoGtEp4S~>k;sI zC5uN%@5JNW4xn?Gc2f0kGZw^Y+Z9?h(hP<_=jxJil&kb}Sw2nJ@Hagk) z=p*OCGuvT8&%$8Y%t?M;4?CY;z+v}yCF$>Fmv`kGR_8eu*=(AfLC9jA8dS1g?+mn} z2Ff@m45%z@{*u92c+y7GN1m!Xb9-H_gZ|k;&Sr8c4pPt4jB;jYC+TdJ8UY!ARF}Xa zX8l5z7;r$APhWl?V13yF&Szo#Lof^~m3BTGwRyaD_Ow0&7~&|w^F86P>U7bVC%TG!Bbt z9+K@Ei%g4H-CUL(BLhE98gQ%>Pu0>bKjAT3^5dmT1s)t5&z0A1tViGRl>}EE ztJMGC^&bfr%{X=z#lzX#7+wQi9P?FRh*>RyOi*;rh#U-$=3p^*+>Mm5+@K~#p@FpD zGDfd0Uv3)~uq4fzq_d*FJ{Qt|{>ClB0KW5&``-*vGn@={>hC@kc!L^{61pCzd|HbO zgK1Q%y;33^p#92QkD#|X+*N@3G&3P&ai(tB-E$ACt-n3D5B9t2__!< zoDi`>fk#kJ*jS*2Y$KIP@FeUQK5EQe=}2@BL+cN~O}wU{amFD_e!gT3PFpfaMHJr|A@2$WuLR)R4-A2WX~Cy2BZ3 zaBraE6oK~E!`Q`{V4lCbLh~uxJo@qw=a|W4uj!*gA_o6?-A;8P{+ub)Ngl;;{o;w2sM~Hc)FO>V!bh}=xLL^ei+|^pkaC1as{HIxv~l2j z&xy&Hpi6fat~Cn(>I~X|f0LCMDk5ohO#Il)$WpuvR?lQ^_|ms&TgLq_glHAsXvfUw z_#gGDl0$i{&)|M)a9*((39XdPps@*Jab@$XNawv9Z68r!6=On=70Es~yrKH2;l<7m zg=0YcgWiL+XJt0_vLY*k`B{bpTSq~UZW0(2*CWHSBfdErrv1e9rg9`!F!=#%kXot9 zmFd^Pims758u}Fbn&=SqaYp~ZJeI!ejR77&ajWv-MBL%Nz$_#Rt!Y1v%YvG)(%iv~ z+u*?vGaX)+xwK}`7(5~MU4=ebR;{xOnH7l#E~z1K<2U%+T9UvlIW)3@Ff8;+5xx>} zoqhmB9@j|*Ss5maK53y6lVw>hK%_P|^sNIovXVX&8J7c-p`uh%05pPCbTMiMp+2LM2$|W! zWmeJ|umKZOd;wn1ie&X55v*G&QmxUxPL>IBT-^95^3|`FH-jBpW)R>2SMeKcd4ZGp zK06coPFEDtxEigkL|26*I1I8+ESuM05p?;2T(E@Qfrem!aIw+lJUN?y202p91TsT} ze8+5a!t#-Z#Wf%0xez-al+Bn*Pu8dwWAH2&gC?pr@^@dPa-^O|AMW4rI!1$Ks&?2& zVUzcfM_V;YV3aRX%UK%qoEl45TXRl8g=0Q`)~;vo(c}W+aTb`^@7Aw^ z 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 diff --git a/src/documentation/content/xdocs/dev/svg/transparency.png b/src/documentation/content/xdocs/dev/svg/transparency.png deleted file mode 100644 index 652e5a75909d44cdca45133fed63583c32c9a962..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 37709 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%0D5djyAv7V1XohNxs=g6HC( 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 diff --git a/src/documentation/content/xdocs/dev/svg/transparency.svg b/src/documentation/content/xdocs/dev/svg/transparency.svg deleted file mode 100644 index be855aec3..000000000 --- a/src/documentation/content/xdocs/dev/svg/transparency.svg +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - - -Transparency in SVG (to PDF) - -Shapes - - - - - - - - - - - - - -Image - -SEE - - - - - -Text - -SEE -THROUGH - -Uniform Image Transparency - - - - - - - - - - - diff --git a/src/documentation/content/xdocs/dev/testing.xml b/src/documentation/content/xdocs/dev/testing.xml deleted file mode 100644 index 1b962530c..000000000 --- a/src/documentation/content/xdocs/dev/testing.xml +++ /dev/null @@ -1,153 +0,0 @@ - - - - - -

- Apache™ FOP Development: Testing - $Revision$ -
- - -
- "Build" Testing -

Apache™ projects use an automated build tool called "gump" to create nightly builds from the SVN repository. Gump sends "nag" messages if the build fails. This can be considered a sort of basic test of the build process. To view the most recent logs of the gump builds:

-
    -
  • Gump build for the Trunk
    • -
  • Gump build for the Maintenance Branch
    • -
-
-
- Basic/API Testing -

There is a group of basic API tests that are included in the build process. -For these tests to occur, JUnit must be available to Ant (simply copy junit.jar into Ant's lib directory). -The build will then report error(s) if the high-level APIs for Driver and the Transcoders fail. -The tests do not check the output, but only ensure that something is generated and without exceptions.

-
-
- Layout Engine Testing -

- The test/layoutengine - directory in the repository contains a test suite for checking the functionality of Apache� FOP's - layout engine. For information on how to create test cases for the layout engine, please - visit the Wiki page. -

-
-
- Functional Testing - The "functional" testing section on this page is currently inoperative. -
- Running and Using Tests -

-Testing is an important part of getting FOP to operate correctly and conform to the -necessary standards. -

-

-A testing system has been set up that works with as a build target when developing -with FOP. A developer can run the tests after making changes to the code, the aim -is to have the tests run to verfiy that nothing working has been broken. -

-

-To setup the testing the developer must place a reference fop.jar in the -"<cvs_repository>/test/reference/" directory. This jar will be dynamically -loaded to create the reference output. -

-
- -
- W3C TestSuite -

-The testing is set up so that you can download the testsuite from -http://www.w3.org/Style/XSL/TestSuite/, -unzip the file into the base directory of FOP. -Then you can uncomment the lines in the build.xml file in the test target and itwill run through all the tests in the testsuite distribution. -

-
- -
- Writing a Test -

-A test belongs to one of a few catagories. A basic test should excercise one -element in a number of situations such as changing a property. This should have -at least one normal value, one border value and one invalid value. If the property -can be of different types then this should also be included. -

-

-A bug test is a test that is specifically aimed at a problem with FOP. That is, the test -is not excercising the specification but rather a problem with FOP in handling a particular -situation that is not exposed with the other testing. -

-

-A system test is one that tests the abitlity of FOP to handle a number of different -elements together. -

-

-A test can consist of a complete fo document or a part of the document such as -some elements that will be placed into the flow of a standard document. -

- -
-
- Submitting a Test -

-If you have a test which you think would be useful you should supply the -test and a diff to the appropriate test suite xml file. Make sure that the -test works as would be expected against the current build. -

-
- -
- How Testing Works -

-The tests are stored in the "<svn_repository>/test" directory. -

-

-You can run the tests by specifying the build target "test" ie:
-ant.sh test (Unix)
-ant test (Windows)
-

-

-This will then compare the current code in the local src directory to a specified -release of FOP. Any differences between the current code and the output from -the reference version will be reported. If the test previously passed then the -test run will have failed. -

-

-The testing is done by reading a test suite xml file, which corresponds to the -standard testsuite.dtd supplied from w3c. This xml file contains a test xml -file and an xsl file (which may simply copy the file). It also contains information -such as if the test has passed and any comments. -

-

-For FOP the testing is done by rendering all the testing documents using the -XML renderer. The XML files are then compared to see if there are any differences. -

-
- -
- SVG Testing -

-The testing of SVG is not part of this testing system. SVG is tested for its rendering -accuracy by using the transcoding mechanism via -Apache Batik. So that the only part that needs -testing is how the SVG image is embedded inside the flow of the fo document. -

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/dev/tools.xml b/src/documentation/content/xdocs/dev/tools.xml deleted file mode 100644 index 6f00fd6d6..000000000 --- a/src/documentation/content/xdocs/dev/tools.xml +++ /dev/null @@ -1,132 +0,0 @@ - - - - - -
- Apache™ FOP Development: Developer Tools - $Revision$ -
- -

- This page documents items that may be helpful to other developers, - especially to those who are new to Apache™ FOP. Exhaustive treatment of these - topics is better suited to other fora, but the information presented - here is intended to deal with FOP-specific issues related to these - tools, especially "gotchas", and to help developers get jump-started. -

-
- Developer Checklist -

- Here is a (probably not comprehensive) list of tools you will need - to be a successful FOP developer: -

-
    -
  • A java IDE (see IDE).
    • -
  • A Subversion client (see Subversion).
    • -
  • Ant (see Building FOP).
    • -
  • checkstyle (see Checkstyle on the conventions page).
    • -
  • JUnit (see Basic Testing).
    • -
-
-
- General Developer Information -

- See the Apache Contributors Tech Guide - for useful information and links for Apache developers, including help - with tools and procedures. -

-
-
- Subversion (SVN) -
- General -

- Visit Apache XML Graphics Code Repositories - for useful information. -

-

- You will need a SVN client to be able to gain access to the FOP repository. - For general SVN information, visit - Subversion Home. - A comprehensive list of clients for all operating systems and many IDEs - can be found at - the Subversion Links page. - For Microsoft Windows we recommend TortoiseSVN. - The command-line client that comes with Subversion is also very easy to use. -

-
-
- Step-by-step instruction for downloading FOP using the SVN command-line client -

- On the command-line (Windows or Unix), simply run: -

- -svn co http://svn.apache.org/repos/asf/xmlgraphics/fop/trunk/ fop-trunk - -

- This will download the FOP trunk into the directory "fop-trunk". -

-
-
- Step-by-step instructions for downloading FOP using TortoiseSVN (on Windows) -
    -
  • Create a new, empty directory in a place of your choice.
    • -
  • Right-click the new directory and select "SVN Checkout..." from the context menu.
    • -
  • Enter http://svn.apache.org/repos/asf/xmlgraphics/fop/trunk/ as the URL of the repository.
    • -
  • Click "OK" and the download should begin.
    • -
-
-
- Creating Patches -
    -
  • - cd to a directory that contains all of the changes - that you wish to include in the patch. To comprehend the entire - distribution, cd to the top directory where you - checked out the sources. -
    • -
  • - Run: svn up to make sure the diff is created against the latest sources. -
    • -
  • - Run: svn diff >mypatch.diff -
    This will write the patch to the file "mypatch.diff". -
    • -
  • If you are running TortoiseSVN, you can select "Create Patch..." in the TortoiseSVN context menu.
    • -
-
-
- Documentation -
    -
  • [online resource] The Subversion Home Page.
    • -
  • [electronic manual] Version Control with Subversion (official Subversion manual). -Note that this manual applies to the command-line version of SVN.
    • -
  • [online resource] Comprehensive list of links to documentation and Subversion clients and plugins.
    • -
-
-
-
- Integrated Development Environments (IDEs) -

An IDE is not required, but will generally be found to be helpful, especially for serious debugging and refactoring.

-

Borland's JBuilder 7/8 does not support Ant builds unless you have the Enterprise Edition (which is quite expensive). This causes problems with any code that is generated by the Ant build. First, you must run the Ant build before you can use the IDE. Second, when you are editing in the IDE, you must be editing the generated files, which means that you must make any changes to the source files in another editor. This is less serious for development on the trunk, but in the maintenance branch, all source files were "generated".

-

Sun ONE Studio Four does support Ant, but seems to use a built-in version, and as of this writing chokes on the FOP build file, saying that it is not valid. There is awkward because there is no official DTD for Ant, and it may be merely an Ant version issue.

-

Additional notes on setting up FOP within an IDE (ex. Eclipse) in the Wiki.

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/download.xml b/src/documentation/content/xdocs/download.xml deleted file mode 100644 index 3ab7d20d2..000000000 --- a/src/documentation/content/xdocs/download.xml +++ /dev/null @@ -1,178 +0,0 @@ - - - - - -
- Apache™ FOP: Downloading A Distribution - $Revision$ -
- -
- Binary or Source? -

- Most Apache™ FOP users will want to download the latest binary distribution, - which is ready to run "out of the box." However, a source distribution - will be preferable if you fall into one of the following categories: -

-
    -
  • - You wish to modify FOP. -
    • -
  • - You wish to use a version more recent than the latest release. For - example, if you have read on the user mailing list that a bug has - been fixed or a feature added that you are eager to try, you might - download a source distribution from the SVN repository so that you - don't have to wait for the next release. -
    • -
  • - You wish to build a local copy of the API documentation (javadocs). -
    • -
-
-
- Binary Download -

- Binary distributions include "-bin" in their names, and can be downloaded from a - FOP Distribution mirror. - Nightly builds of trunk code can be downloaded here: - Nightly Snapshots. -

-
-
- Source Download -

- There are several ways to obtain a source distribution. Please note that they - are listed from least current to most current: -

-
    -
  • - Download a released version from a - FOP Distribution mirror. - Source distributions include "-src" in their names. -
    • -
  • - Download a Subversion snapshot - here. - These snapshots are checked out from Subversion approximately every six hours, and have the GMT of - their creation time embedded in their names. -
    • -
  • - Download directly from the SVN repository. - Anyone can do this using the - Anonymous SVN Server. - By default, the code in SVN is up-to-the-minute, the same code that the developers - are modifying. See the SVN section of Developer Tools - for more information on using SVN. -
    • -
-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Latest Stable Release
Repository URL - - http://svn.apache.org/repos/asf/xmlgraphics/fop/tags/fop-1_1/ - -
Web view - - http://svn.apache.org/viewvc/xmlgraphics/fop/tags/fop-1_1/ - -
Previous Stable Release
Repository URL - - http://svn.apache.org/repos/asf/xmlgraphics/fop/tags/fop-1_0/ - -
Web view - - http://svn.apache.org/viewvc/xmlgraphics/fop/tags/fop-1_0/ - -
Trunk
Repository URL - Main Repository: - - http://svn.apache.org/repos/asf/xmlgraphics/fop/trunk/ - -
- European Mirror: - - http://svn.eu.apache.org/repos/asf/xmlgraphics/fop/trunk/ - - -
Web view - Main Repository: - - http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/ - -
- European Mirror: - - http://svn.eu.apache.org/viewvc/xmlgraphics/fop/trunk/ - -
-

- With any source distribution, you will need to - build FOP from the source files. For details please see the "Build" page on the documentation tab - for the version you've downloaded. -

- -
-
- Archive Download -

- FOP Archive distributions are linked from the upper portion of the Apache FOP - Download Mirror Page and can be downloaded from the FOP - binaries and - source archives. -

-
- - - diff --git a/src/documentation/content/xdocs/examples.xml b/src/documentation/content/xdocs/examples.xml deleted file mode 100644 index 6565c1b4e..000000000 --- a/src/documentation/content/xdocs/examples.xml +++ /dev/null @@ -1,141 +0,0 @@ - - - - - - -
- Apache™ FOP Examples - $Revision$ -
- -
- Example Documents Using Apache™ FOP -

- These examples have been rendered using Apache™ FOP: -

- - - - - - - - - - - - -
Generated examples
DescriptionXSL-FO filePDF result
default font charactersfonts.fofonts.pdf
-

Other basic examples on the use of XSL-FO can be found in the FOP distribution in - the subdirectory examples/fo. You can start transformation of all fo files into pdf - files by running ant in this directory (only source distribution). The resulting test - files can be found in examples/fo/tests -

-

At the moment the following files are part of the distribution:

-
    -
  • simple.fo - a very simple file which gives use a first impression of the structure of an XSL-FO file -
    • -
  • normal.fo - a simple file showing the use of a 2 level of headings, normal text and a header. -
    • -
  • table.fo - some table examples -
    • -
  • list.fo - a short tutorial how to use list fo's and properties -
    • -
  • images.fo - shows how to embed GIF and JPEG images into the XSL-FO file using external-graphic. -
    • -
  • border.fo - a not so simple example how to use borders in tables -
    • -
  • extensive.fo - a longer test file containing a lot of different flow objects and properties. - A good candidate to test your bugfix or new FOP code. -
    • -
  • leader.fo - shows different uses of fo:leader, p.e. as rule or in a table of content -
    • -
  • normalex.fo - shows the use of computed property values -
    • -
  • inhprop.fo - shows the use of inherited property values -
    • -
  • instream.fo - shows the use of fo:instream-foreign-object together with SVG -
    • -
  • textdeko.fo - shows the use of the property text-decoration -
    • -
  • readme.fo - uses an old version of FOP documentation for a longer example -
    • -
-

Also, in the directory examples/fo/pagination you will find a suite of examples showing the use - of XSL-FO pagination. -

-

-Developers will find the first steps to a test suite for all implemented -formatting objects and properties in test/xml in the source distribution. -

-
-
- Images Examples -

-Embedding images in FO: -

- - - - - - - - - - - - - - - - - - - - - - -
Images in FO
descriptionfo filepdf result
align in larger viewportalign.foalign.pdf
align in smaller viewportalign2.foalign2.pdf
scaling imagesize.fosize.pdf
-

Look also into the directory examples/fo/svg. There you find some very extensive SVG examples. -

-
-
- Instream Foreign Object Examples -

-Instream Foreign Object images in FO, there are more on the -SVG Page: -

- - - - - - - - - - - - -
Embedding instream-foreign-object
descriptionfo filepdf result
embedding svg in viewportembed.foembed.pdf
-
- - - diff --git a/src/documentation/content/xdocs/faq.xml b/src/documentation/content/xdocs/faq.xml deleted file mode 100644 index 9d3784d8a..000000000 --- a/src/documentation/content/xdocs/faq.xml +++ /dev/null @@ -1,1355 +0,0 @@ - - - - - - - - Apache™ FOP: General questions - - What is Apache™ FOP? - -

- FOP is a print formatter for XSL formatting - objects. -

-

- It can be used to render an XML file containing XSL formatting objects - into a page layout. The main target is PDF but other rendering targets - are supported, such as AWT, PCL, text and direct printing. -

- - - - What can I do with FOP? - -

- FOP provides both an application and a library that converts an XSL FO - document into paginated output. -

-

- The FOP command line application can be directly used to transform XML - into PDF, PostScript, PCL and other formats, there is also an AWT - based viewer integrated. -

-

- The library can be used in servlets and other Java applications. -

- - - - What does "FOP" stand for? - -

- FOP is an acronym for Formatting - Object Processor -

- - - - How does FOP interact with other Apache Projects? - -

- XML Graphics Commons is used with - FOP to provide graphics functions that are common to a number of Apache projects. -

-

- Batik is used with - FOP to transcode an SVG - image into a PDF document. -

-

FOP also makes use of the following Apache projects:

-
    -
  • Avalon Framework
    • -
  • Jakarta Commons IO
    • -
  • Jakarta Commons Logging
    • -
  • Xalan-J
    • -
  • XML Commons Externals
    • -
- - - - What is XSL? - -

- XSL is a W3C standard concerned with publishing XML documents. It - consists of two parts: XSLT and XSL-FO. The acronym expands to - eXtensible Stylesheet - Language. -

- - - - What is XSL-FO? - -

- XSLFO (aka XSL-FO) is an XML vocabulary, defined by W3C Recommendation - Extensible Stylesheet Language (XSL) - Version 1.1, that is used to specify a pagination and - other styling for page layout output. The acronym “FO” - stands for - Formatting Objects. XSLFO can be - used in conjunction with XSLT to convert - from any XML format into a paginated layout ready for printing or - displaying. -

-

- XSLFO defines a set of elements in XML that describes the way pages - are set up. The contents of the pages are filled from flows. There can - be static flows that appear on every page (for headers and footers) - and the main flow which fills the body of the page. -

-

- Synonyms: XSL FO, XSL (FO), XSL:FO, XSL-FO, Formatting Objects -

- - - - What is XSLT? - -

- XSLT describes the transformation of arbitrary XML input into other - XML (like XSLFO), HTML or plain text. The “T” comes from - Transformation. For historical reasons, a - transformation is often also called a “style sheet”. -

-

- Synonyms: XSL transformation, XSL:T, XSL style sheet. -

- - - - When will feature X be implemented? - -

The short answer is "Don't ask." For more details, see Understand FOP's Limitations.

- - - - When is the next released planned? - -

- Version 1.1 of FOP was released on 20 October 2012. - Work on a new Version 1.2 of Apache FOP is underway at this time, with - no fixed date set for its release. - If you want to speed up the process, consider contributing to FOP. -

- - - - Why did you redesign FOP between Versions 0.2X and 0.9X? - -

The code redesign of FOP was necessary in order to be able to adress following issues:

-
    -
  • Keeps and Breaks
    • -
  • XSL-FO Compliance in general
    • -
  • Process Files of Arbitrary Size
    • -
  • Minimize Memory Use
    • -
  • Table Layout
    • -
- - - - How can I contribute? - -

- There are numerous ways that you can help. They are outlined in the Developer's Introduction page. -

- - - - - Problems running FOP - - I get the error: [ERROR]: 'master-reference' for - 'fo:page-sequence' matches no 'simple-page-master' or - 'page-sequence-master' - -

- FOP was changed to be in accordance with the latest standard (see - XSL standard).The page - master for a fo:page-sequence is now referenced by the - master-reference attribute. Replace the master-name attributes of - your fo:page-sequence elements by master-reference attributes. You - have to do this also for fo:single-page-master-reference, - fo:repeatable-page-master-reference and - fo:conditional-page-master-reference elements in you page master - definitions. -

-

- Update your FO documents and style sheets. -

- - - - I get a NoClassDefFound exception. - -

This is typically a problem with your classpath.

-

If you are running FOP from the command line:

-
    -
  • - Use the command file fop.bat, fop.cmd or fop.js on MS Windows, or fop on Unix/Linux from the FOP - distribution. -
    • -
  • - If this doesn't help, check whether still all the jar files - mentioned in the classpath in the fop.bat file are in their - respective places. -
    • -
-

- If you run FOP embedded in your servlet, web application or - other Java application, check the classpath of the - application. Check the also the information pertaining to servlet engines - for further hints. -

-

- If you downloaded the source distribution, or a snapshop - from the repository, remember you have to build the FOP jars - first. -

- - - - I get a NoSuchMethodException or a NoSuchFieldException - exception. - -

- This is usually caused by an older version of one of the FOP jars or - old XML tools in the classpath. -

-

- Incompatible versions of Batik may also cause this problem. Use the - version of Batik that comes with FOP. It is not always possible to - use a more recent version of Batik. -

- - - - I get an OutOfMemoryException. - -

- See FOP Memory. -

- - - - I get a MalformedURLException. - - -

- What you probably think of as "file names" are usually URLs, in - particular the src attribute of fo:external-graphic. -

-

- Because usage of URLs is growing, you should make yourself familiar - with it. The relevant specification is RFC 2396. -

-

- In a nutshell, the correct syntax for an absolute file URL is - file:///some/path/file.ext on Unix and - file:///z:/some/path/file.ext on Windows systems. Note - the triple slash, and also that only forward slashes are used, even on - windows. -

-

- A relative file URL starts with anything but a slash, and doesn't have - the file: prefix, for example file.ext, - path/file.ext or ../file.ext. The string - file:path/file.ext is not a relative URL, - in fact, it isn't a valid URL at all since the file - scheme does not (officially) support relative paths. A relative URL - is subject to a resolving process, which transforms it into an absolute - URL. -

- - - - - I get an "[ERROR]: null", or a NullPointerException. - -

- This is a very likely a bug in FOP. If you encounter this error, please - Open a New Bug. -

- - - - FOP returns the message "[ERROR] object|property - 'x' is not implemented yet." When will it be implemented? - -

See FOP's Standards Compliance page.

- - - - FOP hangs. FOP does not exit. - -

- The most likely reason is a known problem with the Java run time - environment which is triggered by rendering SVGs. Sun's JDK 1.4 and - later do not have this problem. See also FOP - does not exit if a SVG is included. -

-

- Another possibility is that FOP went into a non terminating - loop. Usually this is indicated by lots of log messages of the form - "[INFO]: [NNNN]" which indicate a new page has been started or box overflows. After some time, FOP will - crash with an OutOfMemoryException. -

-

- If you called the FOP command line application from some other - program, for example from Java using Runtime.exec(), it may hang - while trying to write log entries to the output pipe. You have to read - the FOP output regularly to empty the pipe buffer. It is best to avoid - exec'ing FOP, use the library interface instead. -

-

- If you can reproduce this problem given a specific input and configuration, - then please Open a New Bug. -

- - - - FOP runs forever, writing lots of ">" to the log. - -

- There is something too large to fit into the intended place, usually a - large image, a table whose rows are kept together or a block with a - space-before or space-after larger than the page size. Catch the first - page showing this phenomenon and check it. If it is not obvious which - element causes the trouble, remove stuff until the problem goes - away. Decrease the dimensions of the offending element or property, or - increase the dimension of the enclosing element or container, or - remove keep-with-* properties. -

- - - - FOP cannot find a file for fo:external-graphics. - -

The src attribute of the fo:external-graphics element requires a URI, not a file name. See External Resources for more information about specifying URIs.

- - - - FOP does not find my fonts. - -

- Did you get: “Failed to read font metrics file C:\foo\arial.xml - : File "C:\foo\arial.xml" not found”? The value for the - metrics-file attribute in the user config file is actually an URL, not - a file name. Use "file:///C:/foo/arial.xml" instead. -

-

- If you used a relative URL, make sure your application has the working - directory you expect. Currently FOP does not use the baseDir for - resolving relative URLs pointing to font metric files. -

-

- Try also setting the font-base - configuration. -

- - - - I get a SAXException: Mismatch: page-sequence vs. root - (or similar). - -

- The full exception usually looks similar to this: -

- Mismatch: page-sequence (http://www.w3.org/1999/XSL/Format) vs. root - (http://www.w3.org/1999/XSL/Format) -

- This exception is usually a follow-up error after another exception. Sometimes - the original exception gets swallowed by Xalan's default ErrorListener - (should be fixed in the latest Xalan release). -

-

- The work-around is to set an explicit ErrorListener on the - Transformer. The ErrorListener can be as simple as this: -

- - - - - The following message appears after recently upgrading FOP: - "I/O exception while reading font cache (org.apache.fop.fonts.EmbedFontInfo; - local class incompatible: stream classdesc serialVersionUID = - -9075848379822693399, local class serialVersionUID = 8755432068669997367). - Discarding font cache file." - -

- This message is a warning that FOP failed to read from the Font cache. - Which means any Font auto detection or Font directories will be re-scanned. - So this failure doesn't break anything. -

-

- To avoid the warning you can simply delete the - old Font Cache file, which lives in ${base}\conf\font.cache (see font-base - configuration). -

- - - - - Problems with FOP output - - Leaders don't work in current FOP. Instead of - filling the line, only three dots or a short ruler is - output. - -

- Leaders still work, in fact they work better than ever - before. You'll just have to add text-align="justify" and/or - text-align-last="justify" to the block with the leader. Be - sure you haven't accidentally overridden the - leader-length.maximum="100%" default value. -

-

- Earlier versions of FOP used to expand a leader to fill the - rest of the line unconditionally, anything following it, - like page numbers in a TOC, was actually shifted beyond the - right margin. -

-

- The new implementation uses leader-length.optimum to - determine where to break the line, and expands the leader - only further if the line should be filled, as indicated by - the text-align and text-align-last properties. -

-

- Actually due to the fuzzyness of the specification both the - old and the new method are conformant (although adding text - after the expanded leader in the old variant never was). -

-

- If you want to have a longer ruler or space in a - non-justified line, you have to increase the - leader-length.optimum property. -

- - - - Why does FOP insert a blank page between my page sequences? - -

- This is because spec conformance has been improved. -

-

- The force-page-count - property controls how a FO processor pads page sequences in - order to get certain page counts or last page numbers. The default is - "auto". With this setting, if the next page sequence - begins with an odd page number because you set the - initial-page-number, and the current page sequence also ends with an - odd page number, the processor inserts a blank page to keep odd and - even page numbers alternating (similar for the case the current page - sequence ends with an even page number and the next page sequence - starts with an even page number). -

-

- If you don't want to have this blank page, use - force-page-count="no-force". -

- - - - Why is my graphic not rendered? - -

Most commonly, the external file is not being found by FOP. -Check the following:

-
    -
  • Empty or wrong baseDir setting.
    • -
  • Spelling errors in the file name (including using the wrong case).
    • -
  • Security Problems (i.e. the image could not be accessed - because FOP is not allowed to read the file). This is - especially a problem if the external file is retrieved over - HTTP. Possible issues include security settings on the - server, server configuration, and missing cookies or other - authorization information. Any easy way to check this is to - cut and paste the source URL from the fo:external-graphic - into the Location field of a browser on the machine - where the FOP process will be running.
    • -
-

Other possibilities:

-
    -
  • The image format is not supported or not supported completely. - See FOP Graphics Formats for a - list of supported formats and related issues.
    • -
  • The graphic may be too large to fit into the intended space.
    • -
  • There may be something (static content) that is obscuring the - graphic. (This is very rare). -
    • -
- - - - My graphical images do not work properly. - -

See FOP Graphics Formats for a - list of supported graphics formats and related issues.

- - - - Why is my graphic rendered at a different resolution than it was created? - -

See Graphics Resolution.

- - - - Keep-with-next, keep-with-previous, keep-together - don't work. - -

- Current FOP releases have extensive support for - these properties. The current release, FOP 1.0, still supports the - values "always" and "never" only, no numerical values. There may be - a few places where keep-* still don't work, this should be very rare. -

-

- The concept is called “blind table”. The table is used for - pure layout reasons and is not obvious in the output. -

-

- An example of an image and the image caption to be kept together: -

- - - - - - - - - - - - - Image Caption - - - -]]> -

- Consider upgrading to the latest version which supports keeps. -

- - - - My tables are missing, or missing their content. - -

- Check for fo:table-body around the rows. Usually FOP will catch this problem. -

-

- Also, the fo:table-with-caption element is not implemented, tables - within such an element are dropped too. FOP generates an error - message for this problem. Older DocBook style sheets generate - fo:table-with-caption elements, so watch out. -

- - - - Text overflowing table cells and the like is not clipped. Long - text flows into adjacent cells/block, obscuring stuff there. - -

- Since the overflow property doesn't apply to table-cell, you - can wrap the cell content in a block-container and specify - overflow="hidden" there. Alternatively, - if you have long words overflowing table cells, try to - get them hyphenated. Artificial names like product identifications or - long numbers usually aren't hyphenated. You can try special processing - at XSLT level, like -

-
    -
  • - clip long text, -
    • -
  • - explicit wrapping+clipping, -
    • -
  • - insert zero width spaces (&#x200B;) to allow FOP to - wrap. -
    • -
-

- Check the XSL FAQ and the - XSL list - archive for how to perform these tasks. -

- - - - The contents of table cells don’t wrap - -

You probably have keep-together="always" set on the table cell. See next question.

- - - - FOP behaves differently from earlier versions when keep-together="always" - is set on table cells - -

Support for inline-level keeps has been added in FOP 0.95, and setting - keep-together="always" also implicitly sets - keep-together.within-line="always", which forbids FOP - to break the text into multiple lines. Set - keep-together.within-column="always" on table-cell instead. It’s a good idea - not to use the shorthand keep-together="always" at all!

- - - - FOP tells me: "The contents of row 1 are taller than they should be". - What does that mean? - -

- This is usually caused by setting a "height" on a table-row or table-cell and when - the content is higher than the specified height. By setting "height" (a so-called - corresponding property) you - implicitely set - block-progression-dimension.minimum, block-progression-dimension.optimum and - block-progression-dimension.maximum to the same value. You'll get some information - about that in the warning message. Look for something like: - "MinOptMax[min=opt=max=14000]". -

-

- Assuming you set the height on the table-row to 14pt and your content is 75pt high, - a constraint (maximum=14pt) is violated. Normally, you just want to make sure - with the "height" property that the row has a minimum height. If that is so, the - right solution is to specify block-progression-dimension.minimum="14pt" instead of - height="14pt". -

- - - - Page numbers are not properly right aligned. - -

- This happens for fo:page-number-citation elements if the - citation occurs before FOP formatted the requested page, - usually in TOC or index pages. It is caused by the problem - that FOP has to guess how much space the yet unknown page - number will occupy, and usually the guesses are somewhat - off. -

-

- The most recent FOP releases should have this problem - fixed. Check whether you can upgrade. -

- - - - Hyphenation does not work. - -

Make sure you have set the language and optionally the country attributes for an appropriate XSL-FO element (fo:page-sequence, fo:block or fo:character):

- ]]> -

See Hyphenation Support for details and instructions on using hyphenation with FOP.

-

Explicitly enable hyphenation for an appropriate XSL-FO element (fo:block, fo:character):

- ]]> - - - - When I use margins, my content in a nested table or block-containers gets indented twice. Is this a bug? - -

- No, although you might easily think so. The problem has to do - with property inheritance of the start-indent and end-indent - properties to which the margin properties are mapped. Apache - FOP strictly adheres to the XSL-FO specification here which many - other commercial FO implementations don't do to better meet end-user - expectations. You can make FOP behave like these if you set - setBreakIndentInheritanceOnReferenceAreaBoundary(true) - on the FOUserAgent. The better way is to reset start-indent - and end-indent to "0pt" on table-body or block-container. - For further details, please consult the - Wiki page on Indent Inheritance. -

- - - - Why is the output of Java2D/AWT-based renderers different than, for example, PDF or PS? - -

- If you render the same document once to a PNG or TIFF and once into a PDF, the output - may not be the same, i.e. line breaks are different or lines may have different heights. - The reason for this: The Java2D-based renderers use the font subsystem of Java2D/AWT. The - PDF and PS renderers use FOP's own font subsystem which provides much better font metrics - than Java2D. These can lead to different layout decisions when the same document is - rendered with different renderers. An alternative approach to fix this problem might be - available but it hasn't been tested, yet. See also the - notes on fonts in the various output formats. -

- - - - - Embedding FOP. Using FOP in a servlet. - - How do I use FOP in a servlet? - -

- See Using FOP in a Servlet. -

- - - - How do I use FOP in a servlet with an XSLT - transformation? - -

- See Using FOP in a Servlet with XSLT Transformation. -

- - - - How do I pass parameters to the XSLT transformation? - -

- See Using FOP in a Servlet with XSLT Transformation. -

- - - - How do I use my own fonts when running FOP from a servlet? - -

- Declare the fonts in the userconfig.xml file as usual. - See loading the user configuration file - for further details. -

- - - - How do I set the baseDir property in a servlet environment? - -

- See Setting the Configuration Programmatically. -

- - - - How do I use a user configuration file from a servlet? - -

- See Using a Configuration File in an Embedded App. -

- - - - I keep getting NoClassDefFound and other exceptions. How do I - get FOP working for various servlet engines? - -

- See Servlet Engines. -

- - - - Can FOP be used in multithreaded environments? - -

- See Multithreading FOP. -

- - - - - SVG specific questions - - The rendering of SVG text in my PDF is of poor quality. -Can I control this? - -

See Placing SVG Text into PDF.

- - - - How do I use FOP with SVG on headless servers? - -

See FOP: Graphics (Batik).

- - - - FOP does not exit if a SVG is included. - -

- Applies to older FOP versions and JDK 1.3 and older. That's because - there is an AWT thread hanging around. The solution is to put a - System.exit(0) somewhere. -

- - - - I have problems with SVG referring to gradients etc. using - "uri(#stuff)". I get a MalformedURLException. - -

- This is really a "resolving relative URI" problem with some - twists. The problem is that the #stuff URL fragment - identifier is resolved within the current SVG document. So the - reference must be valid within the XML subset and it cannot - reference other SVG documents in the same XML file. Some options - to try: -

-
    -
  • - Put the SVG into a separate file and use it with - fo:external-graphics. -
    • -
  • - Use a separate SVG file which contains only the gradient (and - perhaps other SVG stuff you want to reference) and point an absolute - URL to it: - fill="url(file:///c:/refstuff/grad.svg#PurpleToWhite)". -
    • -
  • - Same as above but use a relative URL: - fill="url(grad.svg#PurpleToWhite)". This may be easier - to deploy. -
    • -
  • - Make sure that the reference is valid in the current SVG document. -
    • -
-

- In any case, the referenced stuff has to be pointed to by an URL. It - doesn't necessarily have to be a file URL, HTTP should also - work. Also, expect a performance hit in all cases, because another XML - file has to be retrieved and parsed. -

-

- Ultimately, both FOP and especially Batik should be fixed to make - your code work as expected, but this will not only take some time - but also some effort by a standard committee in order to make the - semantics of this kind of references in embedded SVG clearer. -

-

See also MalformedURLException

- - - - Why is my SVG rendered at a size different from that specified in my fo:external-graphic element? - -

See SVG Scaling.

- - - - FOP fails with something like "The attribute "width" of the element <rect> is required". What's wrong? - -

- This phenomenon is not a - bug in FOP, but rather in the dependent packages: Apache Batik, Apache Xalan-J and SAXON. The bug in Apache Batik will be - fixed in the next release. In the latest release of Apache Xalan-J, the bug is already fixed. It only occurs in the Xalan - version bundled with Sun's JVM, because Sun uses a rather old version. -

-

- Bug description: In a namespace-enabled Level 3 DOM, an attribute in the default namespace must be set with - "null" as the value for the namespace URI. SAX, on the other side, uses an empty string ("") to designate - the default namespace. Many packages appear to not properly handle this difference in which case they still use the empty - string as the namespace URI parameter for org.w3c.dom.Element.setAttributeNS(). -

-

- Work-around: Use the latest version of Apache Xalan-J. Note that starting with JDK 1.4 it's not enough to replace Xalan-J - on the normal application classpath and you need to override the Xalan-J version bundled with the Sun JVM using the - Endorsed Standards Override Mechanism, i.e. - you must place Xalan-J in the "lib/endorsed" directory of your JRE. -

- - - - - PDF specific (includes Acrobat peculiarities) - - How do I embed fonts in PDF? - -

- See the Fonts page for information - about embedding fonts. -

- - - - Some characters are not displayed, or displayed incorrectly, or - displayed as “#”. - -

- This usually means the selected font doesn't have a glyph - for the character. -

-

- The standard text fonts supplied with Acrobat Reader have - mostly glyphs for characters from the ISO Latin 1 character - set. For a variety of reasons, even those are not completely - guaranteed to work, for example you can't use the fi - ligature from the standard serif font. Check the overview for the default - PDF fonts. -

-

- If you use your own fonts, the font must have a glyph for - the desired character. Furthermore the font must be - available on the machine where the PDF is viewed or it must - have been embedded in the PDF file. See embedding fonts. -

-

- For most symbols, it is better to select the symbol font - explicitely, for example in order to get the symbol for the - mathematical empty set, write: -

- ∅]]> -

- The "#" shows up if the selected font does not define a glyph for the - required character, for example if you try: -

- ∅]]> - - - - What tools are available for post-processing my PDF document? - -

See PDF Post-processing.

- - - - How do I add security features (encryption, disable printing) - to my PDF document? - -

- See PDF Encryption. - See also PDF Post-processing. -

- - - - How do I add document properties (title, author, etc.) to my - PDF document? - -

See Metadata.

- - - - How do I add watermarks to my PDF document? - -

See PDF Watermarks.

- - - - The PDF is printed contorted! - -

- Check the paper size in Acrobat settings and the "fit to page" print - setting. Contorted printing is often caused by a mismatched paper - format, for example if the setting is "US Letter" but the PDF was - made for A4. Sometimes also the printer driver interferes, check its - settings too. -

- - - - How do I control the Acrobat bookmark display? - -

- FOP supports the starting-state property of the XSL 1.1 - fo:bookmark - element which can be used for this. The color, font-style and - font-weight properties on - fo:bookmark-title - are not yet supported, though. -

- - - - How can I get rid of strange single-pixel lines inside table borders or between table cells in Adobe Acrobat? - -

- Since Apache FOP supports the collapsed border model, every border segment consists - of two separate shapes. This is due to the fact that each side of the border - segment can have a different color. Now, Adobe Acrobat may display thin (1 pixel wide) - lines inside the border segment or sometimes even between to adjacent - colored rectangles making up the background of a block or table cell. - This effect is due to the way Adobe Acrobat does anti-aliasing. Adobe's algorithm - seems to cause these artifacts. Other PDF viewers don't have that problem. Or at least - we haven't had any reports in that direction. -

-

- First of all, these artifacts do not appear in print since no anti-aliasing is done - by Adobe Acrobat in this case (except maybe if you tell Acrobat to print the page - as a bitmap in which case Adobe fully composes the page itself). So, if the artifacts appear - on screen, it doesn't mean they have to appear in print, too. -

-

- To get rid of the artifacts, you can call up the "Preferences" dialog of - Adobe Acrobat and select the tab "Page display". Enabling "Enhance thin lines" - may help in some situations. Otherwise, you can disable "Smooth line art". - You may have to disable "Use 2D graphics acceleration", too, so you can disable - "Smooth line art" in the first place. -

-

- Here an example of how the effect can look like (left: anti-aliasing on, right: anti-aliasing off): -

-
-

- Unfortunately, it is not possible to control the above settings from within the PDF file. - The user has to change these settings himself. Improving FOP to avoid this kind of problem - would be possible although rather hard to achieve because we'd need to add a considerable - amount of code to combine the various line segments. Something like that has been tried already - years ago showing that this is a tricky task. Also, the improvement may not justify the amount - of effort required. -

- - - - - IEx specific stuff - - The FOP servlet is called multiple times! - -

- This is a problem of Internet Explorer requesting the content several - times. Please see the notes on Internet Explorer - for more information. -

- - - - How do I print PDF directly from the browser? - -

- It depends whether you mean "printing to a printer under control of - the server" or "printing on the client's printer". -

-

- For the first problem, look at the print servlet in the FOP - examples. You'll have to gather any printer settings in a HTML form - and send it to the server. -

-

- For the second task, you can use some client side script to start - Acrobat Reader in print mode, or use a Java applet based on the FOP - print servlet. This depends heavily on the client installation and - should not be relied on except in tightly controlled environments. -

-

- See also http://marc.theaimsgroup.com/?l=fop-dev&m=101065988325115&w=2 -

- - - - - General questions regarding XSLT, XSLFO, and basic XML - - (FO) How do I vertically center an image or a table (or - whatever)? - -

- See XSL-FO Vertical Centering. -

- - - - (FO) How do I center a table horizontally? - -

- See XSL-FO Horizontal Centering (Tables). -

- - - - (FO) How to get page numbers printed on the "outer side" of the - page (for books, for example)? - -

- See Recto/Verso Static Content Differences. -

- - - - (FO) How do I use different static content for odd and even - pages? - -

- See Recto/Verso Static Content Differences. -

- - - - (FO) How do I get a special header on the first page? - -

- See Making the First Page Special. -

- - - - (FO) How do I omit my headers on a blank page? How do I write - "This page is left blank" on an intentionally blank page? - -

- See Blank Pages. -

- - - - (FO) How do I print an Euro sign, a checkbox or other some other - special symbols? - -

- See Special Characters. -

- - - - (FO) How do I keep linebreaks and hard spaces? How do I get - preformatted text displayed as expected? - -

- See Preformatting Content. -

- - - - (FO) How do I print the total number of pages, for example "page 1 - of 12" - -

- See Total Document Pages. -

- - - - (FO) The header overlaps body content. The body extends into - the footer. - -

- See Aligning Regions. -

- - - - (FO) How do I get lines in the document, as separators, side - bars or folding marks? - -

- See Drawing Lines. -

- - - - (FO) How do I validate my FO document? - -

- See Validating XSL-FO. -

- - - - (XML) How do I get a non-breaking space in FO? There are complaints about &nbsp;. - -

- See XML Special Characters. -

- - - - (XML) How do I enter special characters in XML? There are complaints about undefined entities, such as &uuml;, which work in HTML. - -

- See XML Special Characters. -

- - - - (XML) There are complaints about illegal characters and entities - in the input. - -

- See Using HTML Character Names. -

- - - - (XML) There are complaints about illegal bytes or characters in - the input. There are odd characters in the result. - -

- See XML Encoding Issues. -

- - - - (XSLT) How can I use the current date and time in my document? - -

See Current Date and Time.

- - - - Can I use FOP to convert XHTML or HTML files to PDF? - -

- You will get better results if you transform your source - XML directly into XSLFO. It is tempting to use the - XML->XHTML->XSLFO approach, because this apparently means - there's only one transformation to maintain, but XHTML - and publishing grade PDF are dissimilar enough that an - "generic" XHTML->XSLFO(PDF) usually wont cut it, because - the XHTML already lacks information from the original XML. - It may be worthwhile to go from the source XML to an - intermediate custom XML which on one hand is close enough - to representation to allow simple transformation to either - XHTML or XSLFO for most of the structure, but on the other - hand retains enough semantic from the original XML that - elements which must be handled differently in the two - representations can be handled differently. Setting this - up requires experience and most likely extensive prototyping. -

- - - - I know it may be a bad idea to use FOP to convert XHTML or HTML files to PDF, but I want to do it anyway. Are there any tools available to help me? - -

- The FOP Resources page has links - to a tool called html2fo - which can be used to make such a transformation. In addition, there - are tools on the Antenna House XSL-FO Tutorial and Sample - page. -

- - - - - Development-related Questions. - - Where can I learn how the FOP docs and web site are built? - -

- See FOP Doc Management. -

- - - - - General suggestions. How to solve problems. - - I think I have found a bug in FOP. What should I do? - -

- See the Bugs page for information about - bugs already reported and how to report new ones. -

- - - - I have questions that are not addressed in this FAQ. Where - should I post them? - -
    -
  • If your question is a development-related question, please see the Developer FAQs.
    • -
  • - If you have a runtime exception or other runtime problem: -
      -
    • - Double check the Runtime FAQs. -
      • -
    • - ClassNotFoundException, NoSuchMethodException and - NoSuchFieldException problems are almost always a problem with - the local environment. Try to get local help first. -
      • -
    • - Check Reported Issues - to see if this is a known problem. -
      • -
    • If none of the above apply, post a question to the fop-dev - mailing list. -
      • -
    -
    • -
  • - In the case where something works properly with another formatter, - (e.g., AntennaHouse, PassiveTex, etc.) but doesn't work with FOP, please - check the Release Notes, the - FOP Standards Compliance document, - and the remaining FAQ in this document. If not found there, look at the - list of Bugs Already Reported. - If not found there, please post a question on the fop-user mailing list - or Open a New Bug. -
    • -
  • - Question about how to use FOP, how to perform certain tasks with FOP - or how to integrate FOP into another application should be posted to - fop-user. -
    • -
  • - XSLT specific stuff sould go to the XSL - list. This includes problems with the language and XSLT - HOW-TOs. -
    • -
  • - Problems specific to a certain XSLT processor, like Xalan, Saxon or - MSXML, should be handled by processor specific lists. This includes - problems with deployment, processor specific extensions, suspected - bugs and processor specific APIs. Note that JDK 1.4 and later come with an - XML parser and an XSLT processor which may be the source of the problem. -
    • -
  • - Problems with servlet containers should be asked on the vendor - specific lists for these software packages. -
    • -
  • - More general questions regarding Java, including deployment, Java - APIs, classpath issues and property definitions should be redirected - to an appropriate Java specific list. -
    • -
- - - - diff --git a/src/documentation/content/xdocs/favicon.ico b/src/documentation/content/xdocs/favicon.ico deleted file mode 100644 index 161bcf7841cb95d326d9729fb0000941cef010d2..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 766 zcmcIiyKVw85Znt$i7TjRC~{@~0Yy+;gB1ES`4%kk0ioT3FQGA2+AEUc3QLrfNHkYO z+061d+ZUu%tZ%$Kp7HuDnJB}^^FC?p?uZ7+Pe2Y#fQ-7Bi7d41VIe}X_LMNAB^)TsBsHWP6w-$U*}emq-5YDhJteeZ$Sa@ diff --git a/src/documentation/content/xdocs/fo.xml b/src/documentation/content/xdocs/fo.xml deleted file mode 100644 index c100d6489..000000000 --- a/src/documentation/content/xdocs/fo.xml +++ /dev/null @@ -1,528 +0,0 @@ - - - - - -
- Apache™ FOP: XSL-FO Input - Basic Help for Using XML, XSLT, and XSL-FO - $Revision$ -
- -
- Overview -

- Apache™ FOP uses XSL-FO as input. -It is the responsibility of the user to make sure that the XSL-FO submitted to FOP is correct. -The tutorial items presented here are not comprehensive, but are of the FAQ variety. Another -good FAQ is Dave Pawson's XSL FAQ. -

-
-
- XML Issues -
- Special Characters -

- When entering special (non-ASCII) characters in XML, the general rule is to use the applicable Unicode character instead of trying to use a character entity as you would with HTML. -Remember that HTML is an SGML document type. -SGML has a limited character set, which requires it to use character entities to represent special characters. -One of the improvements of XML over SGML (and thus HTML) is native support for Unicode. -Basic XML has only a handful of character entities, primarily because it doesn't really need more. -

-

- Entities such as &uuml; (u with an umlaut), which work in HTML, will be flagged as undefined entities unless you define them yourself in your DTD. -Use the corresponding Unicode character instead. -A list of predefined HTML entities and their Unicode codepoints can be found at Character entity references in HTML 4. -

-

- One common example is &nbsp;, used to obtain a non-breaking space in HTML. -In XML, use &#160; instead. -

-

- For other non-ASCII characters, such as the Euro symbol, checkbox, etc., see the Unicode Reference By Name document that is found at the Unicode Consortium site. -

-

- After finding the correct Unicode codepoint to represent the character, use XML Character References to put the character into your source XML, XSLT or FO. -See the non-breaking-space comments above for an example of the syntax using decimal notation. -The following hexadecimal example will result in a Euro sign: -

- -

- Getting your XML correctly encoded is only part of the job. -If you want the character to display or print correctly (and you probably do), then the selected font must contain the necessary glyph. -Because of differences between font encoding methods, and limitations in some font technologies, this can be a troublesome issue, especially for symbol characters. -The FOP example file Base-14 Font Character Mapping is a very useful resource in sorting these issues out for the Base-14 fonts. -For other fonts, use font editing sofware or operating system utilities (such as the Character Map in most Windows platforms) to determine what characters the font supports. -

-

- An alternative to encoding the character and making it available through a font is to use an embedded graphic to represent the character: GIF, PNG, SVG, etc. -

-
-
- Entity Characters -

- The handful of basic XML character entities that do exist are the ampersand, apostrophe, less-than, greater-than, and single-quote characters. -These are needed to distinguish markup tags from content, and to distinguish character entities from content. -To avoid parser complaints about illegal characters and entities in your input, ensure that ampersands in text and attributes are written as &amp;, "<" is written as &lt;, and ">" as &gt;. -It is not necessary everywhere, but it is wise to do so anyway, just to be sure. -

-

- Most XML parsers will provide a line number and sometimes a column number for offending characters. -

-

- Review the XML Specification or a good tutorial for details of the XML file format. -

-
-
- Encoding Issues -

- If the parser complains about illegal bytes or characters in the input, or there are unexpected characters in the output, this is usually the result of a character encoding problem. -See the XSL FAQ for additional information. -Many software packages that produce XML, including XSLT processors, use UTF-8 encoding as a default. -If you view their output with something not aware of the encoding, like Notepad for Win95/98/ME/NT, funny characters are displayed. A � is a giveaway. -

-
-
-
- XSLT Issues -
- Current Date and Time -

XSL-FO does not currently have a function for retrieving the current date and time. -However, in some cases, XSLT can be used to place the current date and time into the XSL-FO document as it is generated.

-

One possibility is to use the exslt date and time extension.

-

Another possibility is to use java or javascript (or perhaps some other language). -Here is an example, using java, that works with Xalan. First, create the appropriate namespace:

- -

Next, use the java language to retrieve and format the current date and time. -Here is an example template:

- - - ]]> -
-
-
- XSL-FO Issues -
- Vertical Centering -

- To vertically center an image, table, or other item, use display-align="center". -See display-align Compliance for implementation status. -Here is a small, self-contained document centering an image on a page: -

- - - - - - - - - - - - - - - - - - - - - - - -]]> -
-
- Horizontal Centering (Tables) -

- To center a table horizontally, one possibility is to add one column on the left and one on the right which pad the table so that the visible part is centered: -

- - - - - - - - - - - - - - - - - foo - - - - - - -]]> -

- If your table is more complicated, or if defining borders on individual cells becomes too much work, use the code above and nest your table within the middle cell. -

-
-
- Right-Aligning (Tables) -

- To right-align a table, you can use the same approach as above for centering tables. - Just remove the last table-column element which causes all the left-over space not - used by the columns with a fixed column-width to be assigned to the first column which - effectively right-aligns the table. -

-
-
- Recto/Verso Static Content Differences -

- One frequent request is that static content be different between recto pages (right-side or odd-numbered pages typically) and verso pages(left-side or even-numbered pages typically). -For example, you may wish to place the page number on the "outer" side of each page. -There are examples in the FO distribution and in the XSL FAQ FO section. -

-

- First, define a page master with alternating pages masters for odd and even pages. -Then specify appropriate regions in these page masters, giving them different names. -Use these names to put different static content in these regions. Here is a self-contained demonstration: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -]]> -
-
- Making the First Page Special -

- To get a special header on the first page, one possibility is to insert it into the flow instead of the static content. Alternatively, use a page master referring to different page masters for the first page and the rest. Here is a code sample: -

- - - - - - - - - - - - - - - - - - - - - First page. - - - Other page. - - - - - - - -]]> -
-
- Blank Pages -

- Sometimes it is desirable to insert blank pages within your output, starting, for example, a new chapter on an odd page or an even page. -A blank page can be forced by using break-before="page-even" or similar properties, or by a force-page-count="end-on-odd" on a page sequence. -

-

- To write "This page is intentionally left blank" (or something similar) on an intentionally blank page, first define a conditional page master with a page master specific for blank pages. -This allows you to specify static content for blank pages (by definition, a page is blank if no content from a flow is rendered on the page). -Omit your normal headers and footers, and use (for example) an extended header to print the "..left blank" statement: -

- - - - - - - - - - - - - - - - - - - - - Normal footer - - - - Intentionally left blank. - - - - - -]]> -
-
- Preformatting Content -

- Sometimes it is desirable to retain linebreaks and hard spaces, and to get - preformatted text to pass through without being changed. The XSL-FO - specification provides some properties for this: white-space-collapse - and linefeed-treatment. - In FOP, use white-space-collapse="false" on an enclosing block. -

-
-
- Total Document Pages -

- It is frequently desirable to know the total number of pages in a - document and to use that number within the document. For example, you - might wish to show the page number on the first page as being - "page 1 of 12". -

-

- To accomplish this in XSL 1.0, place an empty block - with an id at the end of the flow: -

- - ... - -]]> -

- Get the number of the last page as follows: -

- ]]> -

- This does not work in certain situations: multiple page sequences, an initial page number other than 1, or forcing a certain page count, thereby producing blank pages at the end. -

-

- In XSL 1.1, you get another option to do this: make - sure an "id" is set on the page-sequence and reference it using - fo:page-number-citation-last. First, the page-sequence: -

- -

- After that, reference the last page the page-sequence generates: -

- ]]> - - There is no reliable way to get the real total page count with FO mechanisms. You can only get page numbers. - -

- The FOP library provides a method to get the total page count after an FO document has been rendered. -One possibility is to implement your own wrapper to do a dummy rendering, inquire the total page count and then perform the real rendering, passing the total page count to the XSLT processor to splice it into the generated FO. -For example: -

- -

- Declare and use the parameter "page-count" in your XSLT. -

- - It is possible to run into a convergence problem with this solution. Replacing the "#" placeholder in the first run with the actual page count in the second run, may change the total number of pages in the document. - -
-
- Aligning Regions -

- Although it may seem counterintuitive, the regions on a page may overlap. -Defining a certain body region does not automatically constrain other regions. -Instead, this has to be done explicitly. -Sometimes for creative reasons it may be desirable to have the regions overlap. -Otherwise, you will want to set them up so that the header does not overlap body content or the body extend into the footer. -

-

- Assuming you wish to keep the regions separate, if you have a header region with an extent of 20mm, you should define a margin for the body region of at least 20mm too. -Otherwise the header content may overwrite some stuff in the body region. -This applies similarly to the extent of the after region and the bottom margin of the body region. -

-
-
- Drawing Lines -

- It is frequently desirable to draw lines in a document, as separators, side bars or folding marks. There are several possibilities: -

-
    -
  • - Horizontal lines can be drawn using fo:leader. -
    • -
  • - Use a solid border on a suitable fo:block. This will work for horizontal and vertical lines only. -
    • -
  • - Insert a graphic. GIF, PNG SVG, whatever. -
    • -
-
-
- Validating XSL-FO -

- RenderX has provided an Unofficial DTD for FO Documents, which may be helpful in validating general FO issues. -

-

- FOP also maintains an Unofficial - FOP Schema in the FOP Subversion Repository. This document can be used - either to validate against the FO standard, or against the actual FOP - implementation. See the notes near the beginning of the document for - instructions on how to use it. -

-
-
- Producing landscape pages -

- Pages in landscape format can easily be produced by exchanging the page-height and page-width values of a simple-page-master element. -

- - - - - - - -]]> -
-
- External Resources -

Resources needed by an XSL-FO file that are external to it (graphics, for example), are defined in the XSL-FO standard as being of type "uri-specification". This is defined in the standard at Section 5.11 Property Datatypes, which includes a link to the URI standard itself. Refer to the XSL-FO and URI standards themselves for more detailed instructions.

-

URIs may be either absolute or relative to a base URI. (See FOP: Configuration for information on setting the base URI for a FOP session). Here is an example referencing an external-graphic that is relative to the base URI:

- ]]> -

Here is an example referencing an external-graphic that is an absolute URI on a local filesystem:

- ]]> -
-
- - diff --git a/src/documentation/content/xdocs/fo/align.fo b/src/documentation/content/xdocs/fo/align.fo deleted file mode 100644 index 06e6a2929..000000000 --- a/src/documentation/content/xdocs/fo/align.fo +++ /dev/null @@ -1,83 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - -1. FOP test for images - - Align in Larger Viewport - -Default align: -(), start -(), end -(), center -(), before -(), after -(), center -(). - - -Default align: -(), start-before -(), start-after -(), start-center -(), center-before -(), center-center -(), center-after -(). - - - -end-before -(), end-center -(), end-after -(). - - - - This section is only required to show that the layout still works. - - - - - - diff --git a/src/documentation/content/xdocs/fo/align.pdf b/src/documentation/content/xdocs/fo/align.pdf deleted file mode 100644 index 4b9413b1c7d8d93e5ad26ffb0ce3e9cca8c9d00e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 9284 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 - - - - - - - - - - - - - - - - - - - - - -1. FOP test for images - - Align in Smaller Viewport - -Default align: -(), start -(), center -(), end -(), before -(), after -(), center -(). - - -Default align: -(), start-before -(), start-center -(), start-after -(), center-before -(), center-after -(), center-center -(). - - - -end-before -(), end-after -(), end-center -(). - - - - This section is only required to show that the layout still works. - - - - - - diff --git a/src/documentation/content/xdocs/fo/align2.pdf b/src/documentation/content/xdocs/fo/align2.pdf deleted file mode 100644 index 01b8d1bfb9a2cd9e07053543a79b51793f0953fc..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 8797 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 - - - - - - - - - - - - - - - - - - - - - - diff --git a/src/documentation/content/xdocs/fo/build.xml b/src/documentation/content/xdocs/fo/build.xml deleted file mode 100644 index 4b4a099b4..000000000 --- a/src/documentation/content/xdocs/fo/build.xml +++ /dev/null @@ -1,70 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/src/documentation/content/xdocs/fo/embed.fo b/src/documentation/content/xdocs/fo/embed.fo deleted file mode 100644 index 6b052e0bf..000000000 --- a/src/documentation/content/xdocs/fo/embed.fo +++ /dev/null @@ -1,110 +0,0 @@ - - - - -]> - - - - - - - - - - - - - - - - - - - - -Embedding SVG in Viewport - - Align in Larger Viewport - - -Default align: -(&svgimage;), start -(&svgimage;), center -(&svgimage;), end -(&svgimage;), before -(&svgimage;), center -(&svgimage;), after -(&svgimage;), start-before -(&svgimage;), start-center -(&svgimage;), start-after -(&svgimage;), center-before -(&svgimage;), center-center -(&svgimage;), center-after -(&svgimage;), end-before -(&svgimage;), end-center -(&svgimage;), end-after -(&svgimage;). - - - Align in Smaller Viewport - -Default align: -(&svgimage;), start -(&svgimage;), center -(&svgimage;), end -(&svgimage;), before -(&svgimage;), center -(&svgimage;), after -(&svgimage;), start-before -(&svgimage;), start-center -(&svgimage;), start-after -(&svgimage;), center-before -(&svgimage;), center-center -(&svgimage;), center-after -(&svgimage;), end-before -(&svgimage;), end-center -(&svgimage;), end-after -(&svgimage;). - - - Scaling - -Non-uniform -(&svgimage;), non-uniform -(&svgimage;), uniform -(&svgimage;), uniform -(&svgimage;). - - - - This section is only required to show that the layout still works. - - - - - - diff --git a/src/documentation/content/xdocs/fo/embed.pdf b/src/documentation/content/xdocs/fo/embed.pdf deleted file mode 100644 index 59dec77630d773bd829f39163860a8037d20a7b9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 8249 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 diff --git a/src/documentation/content/xdocs/fo/fonts.fo b/src/documentation/content/xdocs/fo/fonts.fo deleted file mode 100644 index 0c2646d05..000000000 --- a/src/documentation/content/xdocs/fo/fonts.fo +++ /dev/null @@ -1,1320 +0,0 @@ - - - - - - - - - - - - - - - - - - - - -Helvetica - - - - - - - - - - - - - - -&#x21; : ! -&#x22; : " -&#x23; : # -&#x24; : $ -&#x25; : % -&#x26; : & -&#x27; : ' -&#x28; : ( -&#x29; : ) -&#x2A; : * -&#x2B; : + -&#x2C; : , -&#x2D; : - -&#x2E; : . -&#x2F; : / -&#x30; : 0 -&#x31; : 1 -&#x32; : 2 -&#x33; : 3 -&#x34; : 4 -&#x35; : 5 -&#x36; : 6 -&#x37; : 7 -&#x38; : 8 -&#x39; : 9 -&#x3A; : : -&#x3B; : ; -&#x3C; : < -&#x3D; : = -&#x3E; : > -&#x3F; : ? -&#x40; : @ -&#x41; : A -&#x42; : B -&#x43; : C -&#x44; : D -&#x45; : E -&#x46; : F -&#x47; : G -&#x48; : H -&#x49; : I -&#x4A; : J -&#x4B; : K -&#x4C; : L -&#x4D; : M -&#x4E; : N -&#x4F; : O -&#x50; : P -&#x51; : Q -&#x52; : R -&#x53; : S -&#x54; : T -&#x55; : U - - - - - - - - -&#x56; : V -&#x57; : W -&#x58; : X -&#x59; : Y -&#x5A; : Z -&#x5B; : [ -&#x5C; : \ -&#x5D; : ] -&#x5E; : ^ -&#x5F; : _ -&#x60; : ` -&#x61; : a -&#x62; : b -&#x63; : c -&#x64; : d -&#x65; : e -&#x66; : f -&#x67; : g -&#x68; : h -&#x69; : i -&#x6A; : j -&#x6B; : k -&#x6C; : l -&#x6D; : m -&#x6E; : n -&#x6F; : o -&#x70; : p -&#x71; : q -&#x72; : r -&#x73; : s -&#x74; : t -&#x75; : u -&#x76; : v -&#x77; : w -&#x78; : x -&#x79; : y -&#x7A; : z -&#x7B; : { -&#x7C; : | -&#x7D; : } -&#x7E; : ~ -&#xA1; : ¡ -&#xA2; : ¢ -&#xA3; : £ -&#xA4; : ¤ -&#xA5; : ¥ -&#xA6; : ¦ -&#xA7; : § -&#xA8; : ¨ -&#xA9; : © -&#xAA; : ª -&#xAB; : « -&#xAC; : ¬ - - - - - - - - -&#xAE; : ® -&#xAF; : ¯ -&#xB0; : ° -&#xB1; : ± -&#xB2; : ² -&#xB3; : ³ -&#xB4; : ´ -&#xB5; : µ -&#xB6; : ¶ -&#xB7; : · -&#xB8; : ¸ -&#xB9; : ¹ -&#xBA; : º -&#xBB; : » -&#xBC; : ¼ -&#xBD; : ½ -&#xBE; : ¾ -&#xBF; : ¿ -&#xC0; : À -&#xC1; : Á -&#xC2; :  -&#xC3; : à -&#xC4; : Ä -&#xC5; : Å -&#xC6; : Æ -&#xC7; : Ç -&#xC8; : È -&#xC9; : É -&#xCA; : Ê -&#xCB; : Ë -&#xCC; : Ì -&#xCD; : Í -&#xCE; : Î -&#xCF; : Ï -&#xD0; : Ð -&#xD1; : Ñ -&#xD2; : Ò -&#xD3; : Ó -&#xD4; : Ô -&#xD5; : Õ -&#xD6; : Ö -&#xD7; : × -&#xD8; : Ø -&#xD9; : Ù -&#xDA; : Ú -&#xDB; : Û -&#xDC; : Ü -&#xDD; : Ý -&#xDE; : Þ -&#xDF; : ß -&#xE0; : à -&#xE1; : á -&#xE2; : â - - - - - - - - -&#xE3; : ã -&#xE4; : ä -&#xE5; : å -&#xE6; : æ -&#xE7; : ç -&#xE8; : è -&#xE9; : é -&#xEA; : ê -&#xEB; : ë -&#xEC; : ì -&#xED; : í -&#xEE; : î -&#xEF; : ï -&#xF0; : ð -&#xF1; : ñ -&#xF2; : ò -&#xF3; : ó -&#xF4; : ô -&#xF5; : õ -&#xF6; : ö -&#xF7; : ÷ -&#xF8; : ø -&#xF9; : ù -&#xFA; : ú -&#xFB; : û -&#xFC; : ü -&#xFD; : ý -&#xFE; : þ -&#xFF; : ÿ -&#x0152; : Œ -&#x0153; : œ -&#x0160; : Š -&#x0161; : š -&#x0178; : Ÿ -&#x017D; : Ž -&#x017E; : ž -&#x0192; : ƒ -&#x02DC; : ˜ -&#x2013; : – -&#x2014; : — -&#x2018; : ‘ -&#x2019; : ’ -&#x201A; : ‚ -&#x201C; : “ -&#x201D; : ” -&#x201E; : „ -&#x2020; : † -&#x2021; : ‡ -&#x2022; : • -&#x2026; : … -&#x2030; : ‰ -&#x2039; : ‹ -&#x203A; : › -&#x2122; : ™ - - - - - - - - -Times Roman - - - - - - - - - - - - - - -&#x21; : ! -&#x22; : " -&#x23; : # -&#x24; : $ -&#x25; : % -&#x26; : & -&#x27; : ' -&#x28; : ( -&#x29; : ) -&#x2A; : * -&#x2B; : + -&#x2C; : , -&#x2D; : - -&#x2E; : . -&#x2F; : / -&#x30; : 0 -&#x31; : 1 -&#x32; : 2 -&#x33; : 3 -&#x34; : 4 -&#x35; : 5 -&#x36; : 6 -&#x37; : 7 -&#x38; : 8 -&#x39; : 9 -&#x3A; : : -&#x3B; : ; -&#x3C; : < -&#x3D; : = -&#x3E; : > -&#x3F; : ? -&#x40; : @ -&#x41; : A -&#x42; : B -&#x43; : C -&#x44; : D -&#x45; : E -&#x46; : F -&#x47; : G -&#x48; : H -&#x49; : I -&#x4A; : J -&#x4B; : K -&#x4C; : L -&#x4D; : M -&#x4E; : N -&#x4F; : O -&#x50; : P -&#x51; : Q -&#x52; : R -&#x53; : S -&#x54; : T -&#x55; : U - - - - - - - - -&#x56; : V -&#x57; : W -&#x58; : X -&#x59; : Y -&#x5A; : Z -&#x5B; : [ -&#x5C; : \ -&#x5D; : ] -&#x5E; : ^ -&#x5F; : _ -&#x60; : ` -&#x61; : a -&#x62; : b -&#x63; : c -&#x64; : d -&#x65; : e -&#x66; : f -&#x67; : g -&#x68; : h -&#x69; : i -&#x6A; : j -&#x6B; : k -&#x6C; : l -&#x6D; : m -&#x6E; : n -&#x6F; : o -&#x70; : p -&#x71; : q -&#x72; : r -&#x73; : s -&#x74; : t -&#x75; : u -&#x76; : v -&#x77; : w -&#x78; : x -&#x79; : y -&#x7A; : z -&#x7B; : { -&#x7C; : | -&#x7D; : } -&#x7E; : ~ -&#xA1; : ¡ -&#xA2; : ¢ -&#xA3; : £ -&#xA4; : ¤ -&#xA5; : ¥ -&#xA6; : ¦ -&#xA7; : § -&#xA8; : ¨ -&#xA9; : © -&#xAA; : ª -&#xAB; : « -&#xAC; : ¬ - - - - - - - - -&#xAE; : ® -&#xAF; : ¯ -&#xB0; : ° -&#xB1; : ± -&#xB2; : ² -&#xB3; : ³ -&#xB4; : ´ -&#xB5; : µ -&#xB6; : ¶ -&#xB7; : · -&#xB8; : ¸ -&#xB9; : ¹ -&#xBA; : º -&#xBB; : » -&#xBC; : ¼ -&#xBD; : ½ -&#xBE; : ¾ -&#xBF; : ¿ -&#xC0; : À -&#xC1; : Á -&#xC2; :  -&#xC3; : à -&#xC4; : Ä -&#xC5; : Å -&#xC6; : Æ -&#xC7; : Ç -&#xC8; : È -&#xC9; : É -&#xCA; : Ê -&#xCB; : Ë -&#xCC; : Ì -&#xCD; : Í -&#xCE; : Î -&#xCF; : Ï -&#xD0; : Ð -&#xD1; : Ñ -&#xD2; : Ò -&#xD3; : Ó -&#xD4; : Ô -&#xD5; : Õ -&#xD6; : Ö -&#xD7; : × -&#xD8; : Ø -&#xD9; : Ù -&#xDA; : Ú -&#xDB; : Û -&#xDC; : Ü -&#xDD; : Ý -&#xDE; : Þ -&#xDF; : ß -&#xE0; : à -&#xE1; : á -&#xE2; : â - - - - - - - - -&#xE3; : ã -&#xE4; : ä -&#xE5; : å -&#xE6; : æ -&#xE7; : ç -&#xE8; : è -&#xE9; : é -&#xEA; : ê -&#xEB; : ë -&#xEC; : ì -&#xED; : í -&#xEE; : î -&#xEF; : ï -&#xF0; : ð -&#xF1; : ñ -&#xF2; : ò -&#xF3; : ó -&#xF4; : ô -&#xF5; : õ -&#xF6; : ö -&#xF7; : ÷ -&#xF8; : ø -&#xF9; : ù -&#xFA; : ú -&#xFB; : û -&#xFC; : ü -&#xFD; : ý -&#xFE; : þ -&#xFF; : ÿ -&#x0152; : Œ -&#x0153; : œ -&#x0160; : Š -&#x0161; : š -&#x0178; : Ÿ -&#x017D; : Ž -&#x017E; : ž -&#x0192; : ƒ -&#x02DC; : ˜ -&#x2013; : – -&#x2014; : — -&#x2018; : ‘ -&#x2019; : ’ -&#x201A; : ‚ -&#x201C; : “ -&#x201D; : ” -&#x201E; : „ -&#x2020; : † -&#x2021; : ‡ -&#x2022; : • -&#x2026; : … -&#x2030; : ‰ -&#x2039; : ‹ -&#x203A; : › -&#x2122; : ™ - - - - - - - - -Courier - - - - - - - - - - - - - - -&#x21; : ! -&#x22; : " -&#x23; : # -&#x24; : $ -&#x25; : % -&#x26; : & -&#x27; : ' -&#x28; : ( -&#x29; : ) -&#x2A; : * -&#x2B; : + -&#x2C; : , -&#x2D; : - -&#x2E; : . -&#x2F; : / -&#x30; : 0 -&#x31; : 1 -&#x32; : 2 -&#x33; : 3 -&#x34; : 4 -&#x35; : 5 -&#x36; : 6 -&#x37; : 7 -&#x38; : 8 -&#x39; : 9 -&#x3A; : : -&#x3B; : ; -&#x3C; : < -&#x3D; : = -&#x3E; : > -&#x3F; : ? -&#x40; : @ -&#x41; : A -&#x42; : B -&#x43; : C -&#x44; : D -&#x45; : E -&#x46; : F -&#x47; : G -&#x48; : H -&#x49; : I -&#x4A; : J -&#x4B; : K -&#x4C; : L -&#x4D; : M -&#x4E; : N -&#x4F; : O -&#x50; : P -&#x51; : Q -&#x52; : R -&#x53; : S -&#x54; : T -&#x55; : U - - - - - - - - -&#x56; : V -&#x57; : W -&#x58; : X -&#x59; : Y -&#x5A; : Z -&#x5B; : [ -&#x5C; : \ -&#x5D; : ] -&#x5E; : ^ -&#x5F; : _ -&#x60; : ` -&#x61; : a -&#x62; : b -&#x63; : c -&#x64; : d -&#x65; : e -&#x66; : f -&#x67; : g -&#x68; : h -&#x69; : i -&#x6A; : j -&#x6B; : k -&#x6C; : l -&#x6D; : m -&#x6E; : n -&#x6F; : o -&#x70; : p -&#x71; : q -&#x72; : r -&#x73; : s -&#x74; : t -&#x75; : u -&#x76; : v -&#x77; : w -&#x78; : x -&#x79; : y -&#x7A; : z -&#x7B; : { -&#x7C; : | -&#x7D; : } -&#x7E; : ~ -&#xA1; : ¡ -&#xA2; : ¢ -&#xA3; : £ -&#xA4; : ¤ -&#xA5; : ¥ -&#xA6; : ¦ -&#xA7; : § -&#xA8; : ¨ -&#xA9; : © -&#xAA; : ª -&#xAB; : « -&#xAC; : ¬ - - - - - - - - -&#xAE; : ® -&#xAF; : ¯ -&#xB0; : ° -&#xB1; : ± -&#xB2; : ² -&#xB3; : ³ -&#xB4; : ´ -&#xB5; : µ -&#xB6; : ¶ -&#xB7; : · -&#xB8; : ¸ -&#xB9; : ¹ -&#xBA; : º -&#xBB; : » -&#xBC; : ¼ -&#xBD; : ½ -&#xBE; : ¾ -&#xBF; : ¿ -&#xC0; : À -&#xC1; : Á -&#xC2; :  -&#xC3; : à -&#xC4; : Ä -&#xC5; : Å -&#xC6; : Æ -&#xC7; : Ç -&#xC8; : È -&#xC9; : É -&#xCA; : Ê -&#xCB; : Ë -&#xCC; : Ì -&#xCD; : Í -&#xCE; : Î -&#xCF; : Ï -&#xD0; : Ð -&#xD1; : Ñ -&#xD2; : Ò -&#xD3; : Ó -&#xD4; : Ô -&#xD5; : Õ -&#xD6; : Ö -&#xD7; : × -&#xD8; : Ø -&#xD9; : Ù -&#xDA; : Ú -&#xDB; : Û -&#xDC; : Ü -&#xDD; : Ý -&#xDE; : Þ -&#xDF; : ß -&#xE0; : à -&#xE1; : á -&#xE2; : â - - - - - - - - -&#xE3; : ã -&#xE4; : ä -&#xE5; : å -&#xE6; : æ -&#xE7; : ç -&#xE8; : è -&#xE9; : é -&#xEA; : ê -&#xEB; : ë -&#xEC; : ì -&#xED; : í -&#xEE; : î -&#xEF; : ï -&#xF0; : ð -&#xF1; : ñ -&#xF2; : ò -&#xF3; : ó -&#xF4; : ô -&#xF5; : õ -&#xF6; : ö -&#xF7; : ÷ -&#xF8; : ø -&#xF9; : ù -&#xFA; : ú -&#xFB; : û -&#xFC; : ü -&#xFD; : ý -&#xFE; : þ -&#xFF; : ÿ -&#x0152; : Œ -&#x0153; : œ -&#x0160; : Š -&#x0161; : š -&#x0178; : Ÿ -&#x017D; : Ž -&#x017E; : ž -&#x0192; : ƒ -&#x02DC; : ˜ -&#x2013; : – -&#x2014; : — -&#x2018; : ‘ -&#x2019; : ’ -&#x201A; : ‚ -&#x201C; : “ -&#x201D; : ” -&#x201E; : „ -&#x2020; : † -&#x2021; : ‡ -&#x2022; : • -&#x2026; : … -&#x2030; : ‰ -&#x2039; : ‹ -&#x203A; : › -&#x2122; : ™ - - - - - - - - - ZapfDingbats: - - - - - - - - - - - - - - -&#x2701; : ✁ -&#x2702; : ✂ -&#x2703; : ✃ -&#x2704; : ✄ -&#x260E; : ☎ -&#x2706; : ✆ -&#x2707; : ✇ -&#x2708; : ✈ -&#x2709; : ✉ -&#x261B; : ☛ -&#x261E; : ☞ -&#x270C; : ✌ -&#x270D; : ✍ -&#x270E; : ✎ -&#x270F; : ✏ -&#x2710; : ✐ -&#x2711; : ✑ -&#x2712; : ✒ -&#x2713; : ✓ -&#x2714; : ✔ -&#x2715; : ✕ -&#x2716; : ✖ -&#x2717; : ✗ -&#x2718; : ✘ -&#x2719; : ✙ -&#x271A; : ✚ -&#x271B; : ✛ -&#x271C; : ✜ -&#x271D; : ✝ -&#x271E; : ✞ -&#x271F; : ✟ -&#x2720; : ✠ -&#x2721; : ✡ -&#x2722; : ✢ -&#x2723; : ✣ -&#x2724; : ✤ -&#x2725; : ✥ -&#x2726; : ✦ -&#x2727; : ✧ -&#x2605; : ★ -&#x2729; : ✩ -&#x272A; : ✪ -&#x272B; : ✫ -&#x272C; : ✬ -&#x272D; : ✭ -&#x272E; : ✮ -&#x272F; : ✯ -&#x2730; : ✰ -&#x2731; : ✱ -&#x2732; : ✲ - - - - - - - - -&#x2733; : ✳ -&#x2734; : ✴ -&#x2735; : ✵ -&#x2736; : ✶ -&#x2737; : ✷ -&#x2738; : ✸ -&#x2739; : ✹ -&#x273A; : ✺ -&#x273B; : ✻ -&#x273C; : ✼ -&#x273D; : ✽ -&#x273E; : ✾ -&#x273F; : ✿ -&#x2740; : ❀ -&#x2741; : ❁ -&#x2742; : ❂ -&#x2743; : ❃ -&#x2744; : ❄ -&#x2745; : ❅ -&#x2746; : ❆ -&#x2747; : ❇ -&#x2748; : ❈ -&#x2749; : ❉ -&#x274A; : ❊ -&#x274B; : ❋ -&#x25CF; : ● -&#x274D; : ❍ -&#x25A0; : ■ -&#x274F; : ❏ -&#x2750; : ❐ -&#x2751; : ❑ -&#x2752; : ❒ -&#x25B2; : ▲ -&#x25BC; : ▼ -&#x25C6; : ◆ -&#x2756; : ❖ -&#x25D7; : ◗ -&#x2758; : ❘ -&#x2759; : ❙ -&#x275A; : ❚ -&#x275B; : ❛ -&#x275C; : ❜ -&#x275D; : ❝ -&#x275E; : ❞ -&#x2761; : ❡ -&#x2762; : ❢ -&#x2763; : ❣ -&#x2764; : ❤ -&#x2765; : ❥ -&#x2766; : ❦ - - - - - - - - -&#x2767; : ❧ -&#x2663; : ♣ -&#x2666; : ♦ -&#x2665; : ♥ -&#x2660; : ♠ -&#x2460; : ① -&#x2461; : ② -&#x2462; : ③ -&#x2463; : ④ -&#x2464; : ⑤ -&#x2465; : ⑥ -&#x2466; : ⑦ -&#x2467; : ⑧ -&#x2468; : ⑨ -&#x2469; : ⑩ -&#x2776; : ❶ -&#x2777; : ❷ -&#x2778; : ❸ -&#x2779; : ❹ -&#x277A; : ❺ -&#x277B; : ❻ -&#x277C; : ❼ -&#x277D; : ❽ -&#x277E; : ❾ -&#x277F; : ❿ -&#x2780; : ➀ -&#x2781; : ➁ -&#x2782; : ➂ -&#x2783; : ➃ -&#x2784; : ➄ -&#x2785; : ➅ -&#x2786; : ➆ -&#x2787; : ➇ -&#x2788; : ➈ -&#x2789; : ➉ -&#x278A; : ➊ -&#x278B; : ➋ -&#x278C; : ➌ -&#x278D; : ➍ -&#x278E; : ➎ -&#x278F; : ➏ -&#x2790; : ➐ -&#x2791; : ➑ -&#x2792; : ➒ -&#x2793; : ➓ -&#x2794; : ➔ -&#x2192; : → -&#x2194; : ↔ -&#x2195; : ↕ -&#x2798; : ➘ - - - - - - - - -&#x2799; : ➙ -&#x279A; : ➚ -&#x279B; : ➛ -&#x279C; : ➜ -&#x279D; : ➝ -&#x279E; : ➞ -&#x279F; : ➟ -&#x27A0; : ➠ -&#x27A1; : ➡ -&#x27A2; : ➢ -&#x27A3; : ➣ -&#x27A4; : ➤ -&#x27A5; : ➥ -&#x27A6; : ➦ -&#x27A7; : ➧ -&#x27A8; : ➨ -&#x27A9; : ➩ -&#x27AA; : ➪ -&#x27AB; : ➫ -&#x27AC; : ➬ -&#x27AD; : ➭ -&#x27AE; : ➮ -&#x27AF; : ➯ -&#x27B1; : ➱ -&#x27B2; : ➲ -&#x27B3; : ➳ -&#x27B4; : ➴ -&#x27B5; : ➵ -&#x27B6; : ➶ -&#x27B7; : ➷ -&#x27B8; : ➸ -&#x27B9; : ➹ -&#x27BA; : ➺ -&#x27BB; : ➻ -&#x27BC; : ➼ -&#x27BD; : ➽ -&#x27BE; : ➾ -&#xF8E0; :  -&#xF8DE; :  -&#xF8E3; :  -&#xF8DD; :  -&#xF8D7; :  -&#xF8E1; :  -&#xF8DB; :  -&#xF8D8; :  -&#xF8DF; :  -&#xF8DA; :  -&#xF8D9; :  -&#xF8DC; :  -&#xF8E4; :  -&#xF8E2; :  - - - - - - - - - Symbol: - - - - - - - - - - - - - - -&#x21; : ! -&#x23; : # -&#x25; : % -&#x26; : & -&#x28; : ( -&#x29; : ) -&#x2B; : + -&#x2C; : , -&#x2E; : . -&#x2F; : / -&#x30; : 0 -&#x31; : 1 -&#x32; : 2 -&#x33; : 3 -&#x34; : 4 -&#x35; : 5 -&#x36; : 6 -&#x37; : 7 -&#x38; : 8 -&#x39; : 9 -&#x3A; : : -&#x3B; : ; -&#x3C; : < -&#x3D; : = -&#x3E; : > -&#x3F; : ? -&#x5B; : [ -&#x5D; : ] -&#x5F; : _ -&#x6D; : m -&#x7B; : { -&#x7C; : | -&#x7D; : } -&#xAC; : ¬ -&#xB0; : ° -&#xB1; : ± -&#xB5; : µ -&#xD7; : × -&#xF7; : ÷ -&#x0192; : ƒ -&#x0391; : Α -&#x0392; : Β -&#x0393; : Γ -&#x0395; : Ε -&#x0396; : Ζ -&#x0397; : Η -&#x0398; : Θ - - - - - - - - -&#x0399; : Ι -&#x039A; : Κ -&#x039B; : Λ -&#x039C; : Μ -&#x039D; : Ν -&#x039E; : Ξ -&#x039F; : Ο -&#x03A0; : Π -&#x03A1; : Ρ -&#x03A3; : Σ -&#x03A4; : Τ -&#x03A5; : Υ -&#x03A6; : Φ -&#x03A7; : Χ -&#x03A8; : Ψ -&#x03B1; : α -&#x03B2; : β -&#x03B3; : γ -&#x03B4; : δ -&#x03B5; : ε -&#x03B6; : ζ -&#x03B7; : η -&#x03B8; : θ -&#x03B9; : ι -&#x03BA; : κ -&#x03BB; : λ -&#x03BD; : ν -&#x03BE; : ξ -&#x03BF; : ο -&#x03C0; : π -&#x03C1; : ρ -&#x03C2; : ς -&#x03C3; : σ -&#x03C4; : τ -&#x03C5; : υ -&#x03C6; : φ -&#x03C7; : χ -&#x03C8; : ψ -&#x03C9; : ω -&#x03D1; : ϑ -&#x03D2; : ϒ -&#x03D5; : ϕ -&#x03D6; : ϖ -&#x2022; : • -&#x2026; : … -&#x2032; : ′ -&#x2033; : ″ - - - - - - - - -&#x2044; : ⁄ -&#x2111; : ℑ -&#x2118; : ℘ -&#x211C; : ℜ -&#x2126; : Ω -&#x2135; : ℵ -&#x2190; : ← -&#x2191; : ↑ -&#x2192; : → -&#x2193; : ↓ -&#x2194; : ↔ -&#x21B5; : ↵ -&#x21D0; : ⇐ -&#x21D1; : ⇑ -&#x21D2; : ⇒ -&#x21D3; : ⇓ -&#x21D4; : ⇔ -&#x2200; : ∀ -&#x2202; : ∂ -&#x2203; : ∃ -&#x2205; : ∅ -&#x2206; : ∆ -&#x2207; : ∇ -&#x2208; : ∈ -&#x2209; : ∉ -&#x220B; : ∋ -&#x220F; : ∏ -&#x2211; : ∑ -&#x2212; : − -&#x2217; : ∗ -&#x221A; : √ -&#x221D; : ∝ -&#x221E; : ∞ -&#x2220; : ∠ -&#x2227; : ∧ -&#x2228; : ∨ -&#x2229; : ∩ -&#x222A; : ∪ -&#x222B; : ∫ -&#x2234; : ∴ -&#x223C; : ∼ -&#x2245; : ≅ -&#x2248; : ≈ -&#x2260; : ≠ -&#x2261; : ≡ -&#x2264; : ≤ -&#x2265; : ≥ - - - - - - - - -&#x2282; : ⊂ -&#x2283; : ⊃ -&#x2284; : ⊄ -&#x2286; : ⊆ -&#x2287; : ⊇ -&#x2295; : ⊕ -&#x2297; : ⊗ -&#x22A5; : ⊥ -&#x22C5; : ⋅ -&#x2320; : ⌠ -&#x2321; : ⌡ -&#x2329; : 〈 -&#x232A; : 〉 -&#x25CA; : ◊ -&#x2660; : ♠ -&#x2663; : ♣ -&#x2665; : ♥ -&#x2666; : ♦ -&#xF6D9; :  -&#xF6DA; :  -&#xF6DB; :  -&#xF8E5; :  -&#xF8E6; :  -&#xF8E7; :  -&#xF8E8; :  -&#xF8E9; :  -&#xF8EA; :  -&#xF8EB; :  -&#xF8EC; :  -&#xF8ED; :  -&#xF8EE; :  -&#xF8EF; :  -&#xF8F0; :  -&#xF8F1; :  -&#xF8F2; :  -&#xF8F3; :  -&#xF8F4; :  -&#xF8F5; :  -&#xF8F6; :  -&#xF8F7; :  -&#xF8F8; :  -&#xF8F9; :  -&#xF8FA; :  -&#xF8FB; :  -&#xF8FC; :  -&#xF8FD; :  -&#xF8FE; :  - - - - - - - - - Some special characters: - - -Euro ( dec 8364, hex 20AC): € - - - - - - - - - - - diff --git a/src/documentation/content/xdocs/fo/fonts.pdf b/src/documentation/content/xdocs/fo/fonts.pdf deleted file mode 100644 index 5c84a41b2a66683c311539e1520f7bfab623174d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 20432 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 JpToo+`xo=$E{y;H diff --git a/src/documentation/content/xdocs/fo/size.fo b/src/documentation/content/xdocs/fo/size.fo deleted file mode 100644 index 1de6b0245..000000000 --- a/src/documentation/content/xdocs/fo/size.fo +++ /dev/null @@ -1,138 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - -1. FOP test for images - - Normal - -The image () is placed normally. - - - - - Sized - -The image -() -has the content size set. - - - - - Sized - -The image -() -has the width and height set. - - - - - Sized - -The image -() -has the ipd and bpd set. - - - - - Clipped - -The image -() -is clipped with the content size double the viewport size. - - - - - Clipped - -The image -() -is clipped with the content size double the viewport size. -This has error-if-overflow -set so there should be an error reported, it can recover from the -error by clipping to the viewport. - - - - - Scaling - -The image -() -has non-uniform scaling. - - -The image -() -has non-uniform scaling. - - -The image -() -has uniform scaling. - - -The image -() -has uniform scaling. - - -The image -() -is scaled to fit the viewport. - - - - - - This section is only required to show that the layout still works. - - - - - - diff --git a/src/documentation/content/xdocs/fo/size.pdf b/src/documentation/content/xdocs/fo/size.pdf deleted file mode 100644 index add8fe87140618dad925df64e9b1a0c4a96322f3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 9508 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 - - - - -
- Apache™ FOP: Getting Help - Checklist for Finding Appropriate Resources - $Revision$ -
- -

The Apache™ FOP developer community is eager to help you maximize the usefulness of FOP. -However, to make wise use of its limited resources, support must be primarily self-service. -Go through the following checklist sequentially to determine what kind of help you need, -and where to get it:

-
- Understand Underlying Technologies -

If you have a questions about XML, XSLT, or XSL-FO that are not directly related to FOP, please consult resources that are appropriate for those questions. -FOP is an implementation of these technologies, and when you use FOP, there is a presumption that you have a working understanding of them. -We have included several useful links on our Resources page that may help you get started. -

-
-
- Understand FOP's Limitations -

FOP is a work in progress, and has some limitations.

-

FOP does not yet fully comply with the W3C XSL-FO standard. -The developers track which standard requirements have been implemented, and have documented these capabilities on the Compliance page. -FOP has other limitations regarding specific output formats, graphic formats, etc. -These limitations are noted in appropriate places in the documentation. -If these documents appear to be in error, continue down this checklist so that either the document or the software can be corrected. -Otherwise, please do not submit mailing list questions or bug reports regarding features documented in the standard, or documented as limitations in other parts of the documentation.

-

Please especially do not submit questions asking when a particular feature will be implemented. -There are too many unknowns to make even a reasonable estimate. -Every time a developer stops to answer such a question, the answer will inevitably be "I don't know", but the time taken to respond is time spent away from development. -The only sure way to get a feature implemented is to pitch in and help.

-
-
- Read the Documentation -

Review the documentation pages on this site. -There is information about how to run FOP, how to embed it, how to add custom fonts etc.

-
-
- Check the FAQs -

Consult the Frequently Asked Questions (FAQ) to see if your question has already been answered.

-
-
- Review FOP User Mailing List Archive -

It is possible that your question has already been answered but has not yet found its way into the FAQ. -Links to the FOP User mailing list archives are on the Mailing List page. -

-
-
- Look for an Existing Issue Report -

See Reported Issues for instructions on how to use the list of open issues. Review these open issues to see if any match your concerns. -If so, please do not post a mailing list question or report another issue, as these will only slow the development team down.

-
-
- Submit Question to FOP User Mailing List -

See FOP User Mailing List for details.

- Please don't write to any developer directly. Only if you submit questions to the FOP User Mailing List will other FOP users be able to profit from answers given to your question. Another point is that a developer may have gone inactive or is on holidays in which case you may not get an answer in time. -
-
- Enter an Issue Report -

If, and only if, you have followed all of the above steps, and believe that there is a bug or needed feature that you would like to report, please enter an issue in Bugzilla. Never use Bugzilla to post questions, only to enter issues that have already been asked on the user mailing list.

-

See Reporting New Issues for detailed instructions on how to enter an issue. -

-
-
- Find Out How <em>You</em> Can Help -
-

As stated above, the FOP development team is a limited resource. Most make their livings doing things other than writing and supporting FOP. Perhaps you need a feature from the XSL-FO standard to be implemented right away, or a bug fixed, or a new output format, or .... If so, there are several ways that you can help:

-
    -
  • Become a FOP developer.
    • -
  • Fund a developer (or part of one). There is usually at least one FOP developer who would be glad to devote more time to FOP development if funding were in place.
    • -
  • Help out on the user mailing list. Users giving good answers to other users allows developers to focus more on development and less on support.
    • -
- - diff --git a/src/documentation/content/xdocs/index.xml b/src/documentation/content/xdocs/index.xml deleted file mode 100644 index dad96a6b0..000000000 --- a/src/documentation/content/xdocs/index.xml +++ /dev/null @@ -1,82 +0,0 @@ - - - - - -
- Apache™ FOP - $Revision$ -
- -
- Introduction -

- Apache™ FOP (Formatting Objects Processor) is a print formatter driven by XSL - formatting objects (XSL-FO) and an output independent formatter. It is a Java - application that reads a formatting object (FO) tree and renders the resulting - pages to a specified output. Output formats - currently supported include PDF, PS, PCL, AFP, XML (area tree representation), - Print, AWT and PNG, and to a lesser extent, RTF and TXT. The primary output target is PDF. -

-

- The Apache™ FOP project is part of the Apache™ - Software Foundation, which is a wider community of users and developers of open source projects. -

-
-

- The latest version of FOP is available at FOP 1.1. -

-

- Support for each of the standard's objects and properties is detailed in FOP Compliance. - Download options include a precompiled version, source code, and many example files to get you started. Resources include links to XSL-FO introductions and many other useful references. A checklist for Getting Help will guide you toward maximizing the usefulness of FOP. -

-

FOP is proud to be part of Apache's XML Graphics project. -

-
- -
- Demonstration -
-

-This image is a demonstration of a real two page document. The XML data on the left -is formatted into the two pages on the right. The document contains static areas that appear on every page, an external graphic, a footnote on the first page, and a table that goes across both pages. -

-

-FOP uses the standard XSL-FO file format as input, lays the content out into pages, then renders it to the requested output. -One great advantage of using XSL-FO as input is that XSL-FO is itself an XML file, which means that it can be conveniently created from a variety of sources. -The most common method is to convert semantic XML to XSL-FO, using an XSLT transformation.

-
-
- FOP Objectives -

The goals of the Apache FOP project are to deliver an XSL-FO to PDF formatter that - is compliant to at least the Basic conformance level described in the W3C - Recommendation from 05 December 2006, and that complies with the November 2001 - Portable Document Format Specification (Version 1.4) from Adobe Systems. -

- -

Conformance to the XML 1.0 and 1.1 Recommendations, XSLT 1.0 and 2.0 Recommendations and the XML Namespaces Recommendation is - understood. Other relevant documents, such as the XPath and XLink Working Drafts, are referenced as necessary. The FOP - Project will attempt to use the latest version of evolving specifications. -

-
- - The PDF files on this site are created using Apache FOP. - - - - diff --git a/src/documentation/content/xdocs/knownissues.xml b/src/documentation/content/xdocs/knownissues.xml deleted file mode 100644 index d916f0171..000000000 --- a/src/documentation/content/xdocs/knownissues.xml +++ /dev/null @@ -1,80 +0,0 @@ - - - - - - - -]> - -
- Apache™ FOP: Known Issues - $Revision$ -
- -
- Known issues -

- This page lists currently known issues in the Apache™ FOP codebase. Please note that this list is generated - from data in FOP's code repository (Trunk) and may not exactly represent the list of issues in - the latest release. -

-

- Apache™ FOP has an extensive automated testing infrastructure. Parts of this infrastructure are several - sets of test cases. When a test case is listed in disabled-testcases.xml it is disabled in the JUnit - tests during the normal build process. This indicates a problem in the current codebase. When a bug is - fixed or a missing feature is added the entry for the relevant test case(s) are removed. -

-

- For additional information on known issues in Apache FOP, please have a look at the following pages, too: -

-
    -
  • the bug list in Bugzilla
    • -
  • the task list in the Wiki
    • -
-
- FO Tree -

- This section lists currently disabled test cases in the test suite for the FO tree tests. - The data for this section comes from - test/fotree/disabled-testcases.xml. -

- -
-
- Layout Engine -

- This section lists currently disabled test cases in the test suite for the layout engine tests. - The data for this section comes from - test/layoutengine/disabled-testcases.xml. -

- -
-
- Other known issues -

This section lists other known issues.

- - -
-
- - - diff --git a/src/documentation/content/xdocs/license.xml b/src/documentation/content/xdocs/license.xml deleted file mode 100644 index 95e8b455a..000000000 --- a/src/documentation/content/xdocs/license.xml +++ /dev/null @@ -1,47 +0,0 @@ - - - - - -
- Apache™ FOP License - $Revision$ -
- -
- License -

- All new Apache™ FOP releases will be licensed under the Apache™ License, version 2.0. - Releases up through version 0.20.5 were released under the Apache™ License, version 1.1. -

-

- To inspect the license terms please consult the LICENSE and NOTICE files in the root - directory of the distribution. The full license text can also be accessed via the web - from the Apache Licenses page. -

-

- Apache FOP comes with a number of libraries all of which are currently coming from within - the Apache Software Foundation. These libraries are all licensed under one of the - Apache License versions. There is one exception which is "xml-apis.jar" which contains - code licensed by the W3C. Please consult the - license files included with the libraries in the "lib" directory for details. -

-
- - - diff --git a/src/documentation/content/xdocs/maillist.xml b/src/documentation/content/xdocs/maillist.xml deleted file mode 100644 index eff0bb5cc..000000000 --- a/src/documentation/content/xdocs/maillist.xml +++ /dev/null @@ -1,130 +0,0 @@ - - - - - -
- Apache™ FOP: Mailing List Resources - $Revision$ -
- -
- General Information -

Before posting questions to any list:

-
    -
  • Review the Jakarta Mailing Lists - Guidelines for general principles about mailing lists.
    • -
  • Review "How To Ask Questions The Smart Way".
    • -
  • Send only plain text email messages to any mailing lists. -Please do not send html or rtf email, as they do not work well with the archive engines. -If you are using Microsoft Outlook, this setting can be found at the "Mail Format" tab of the Tools/Options menu.
    • -
  • Use a mail client that respects the References and/or In-Reply-To mail header entries. This is important for mail clients that can display threads as trees. Compliant mail clients include Microsoft Outlook, Becky!, KMail, Apple Mail, Ximian Evolution, Mozilla (version 1.2 or greater). Non-compliant mail clients include Microsoft Exchange, Lotus Notes, Internet Mail Service (MUA or MTA), and dtmail.
    • -
-

For help in understanding email acronyms, see the Lingo2Word Acronym List, or the Keno Internet Services Internet Glossary.

-
-
- Apache™ FOP Users Mailing List -

Use this forum to discuss topics of interest to FOP users.

-
- Archives -

To review the archives, you have several options:

-
    - -
  • The Apache Mailing List archive (mod_mbox archive, no full-text search, yet).
    • -
  • The Apache Mailing List archive (gzipped mbox files).
    • -
  • The Mailing list ARChives (MARC) at the AIMS group.
    • -
  • The Mail Archive.
    • -
  • The GMANE archive.
    • -
  • The Nabble archive (only posts after May 2005).
    • -
  • The MarkMail archive.
    • -
- - If you don't like mailing lists and prefer a forum-like system, have a look at - GMANE or - Nabble. They - allow you to post to the mailing list without having to subscribe. - -
-
- Subscription Information -
    -
  • See Apache XML Graphics Mailing Lists for detailed subscription information.
    • -
  • To subscribe (digest only): Send email to fop-users-digest-subscribe@xmlgraphics.apache.org.
    • -
  • To subscribe fully: Send email to fop-users-subscribe@xmlgraphics.apache.org.
    • -
  • To receive information about the mailing list: Send email to fop-users-help@xmlgraphics.apache.org.
    • -
  • To unsubscribe: Send email to fop-users-unsubscribe@xmlgraphics.apache.org.
    • -
-
- You can find the developer mailing list on the Development pages. -
- Submitting a Question -

FOP support is primarily self-service. The FOP User Mailing List serves as a backup to the self-service documentation for cases where either the documentation is deficient or where users have unusual circumstances. FOP developers and users are happy to help answer questions that are appropriate to the forum (i.e. FOP-specific), and that are submitted after appropriate preparation. To ensure that your question is not abusive of this policy, please use the following checklist:

-
    -
  • Have you followed the Getting Help checklist? If not, please do so before submitting your question.
    • -
  • Is your question appropriate to the forum? If it is really an XSL-FO question, XSLT question, or PDF question, please see the other resources on this page that are intended to help you get those questions answered.
    • -
  • Have you read Mailing List General Information? If not please do so before proceeding.
    • -
  • Have you stated the version of FOP you are using? Please do so. Usually, it's a good idea to state the JDK/JRE version and the operating system you're using, too.
    • -
  • Have you included any detailed error messages? Please do so.
    • -
  • Does a proper understanding of your question require inclusion of XSLT code, DocBook - source, or other semantic XML? If so, the question is almost certainly not - appropriate to this list. In general, the only input documents that are - appropriate on this list are XSL-FO snippets. See Running Xalan for instructions about capturing the XSL-FO document that is actually submitted to FOP. If you haven't examined the XSL-FO document yourself, then you are not yet prepared to formulate a FOP-specific question.
    • -
  • If you are providing one or more XSL-FO snippets: -
      -
    • Have you reduced them to the shortest possible complete, self-contained document that demonstrates the problem? Please do so.
      • -
    • Have you removed images that are not an integral part of the question? Please do so.
      • -
    • Have you filtered out confidential material? Please do so.
      • -
    -
    • -
  • If you are including a stack trace: -
      -
    • Is it helpful in finding the problem? If not, please do not submit it.
      • -
    • Have you included only those portions that are relevant to the question? If not, please do so.
      • -
    -
    • -
  • Are you attaching large PDF files or screen shots to your message? If so, please consider attaching a minimal, appropriate B&W GIF, JPG or PNG that conveys the necessary information instead. A good alternative is to put the files on a web server.
    • -
-
-
-
- XSL-FO Mailing List (at W3C) -

Use this forum to ask general XSL-FO questions.

-
    -
  • To review the archive: W3C XSL-FO Archives.
    • -
  • Before posting questions to any list, see "General Information".
    • -
  • Subscription administration information can be found at W3C Mailing List Administrativia. -After reviewing the instructions there, send your subscribe or unsubscribe request to www-xsl-fo-request@w3.org.
    • -
-
-
- XSL-FO Mailing List (at YahooGroups) -

Use this forum to ask general XSL-FO questions.

-
    -
  • Before posting questions to any list, see "General Information".
    • -
  • The home page for this groups is XSL-FO - discussion of XSL Formatting Objects.
    • -
-
-
- XSLT List (Mulberry Tech) -
    -
  • Before posting questions to any list, see "General Information".
    • -
  • Information for using and subscribing can be found at XSL-List -- Open Forum on XSL.
    • -
-
- - diff --git a/src/documentation/content/xdocs/news-data.xml b/src/documentation/content/xdocs/news-data.xml deleted file mode 100644 index 6ac7ac3f0..000000000 --- a/src/documentation/content/xdocs/news-data.xml +++ /dev/null @@ -1,226 +0,0 @@ - - - - - - - - -

Welcome Glenn Adams!

- - -

Welcome Mehdi Houshmand!

- - -

- The Apache™ FOP team is delighted to present you a production grade - release of the new FOP codebase. This release - contains many bug fixes and new features. See the Release Notes for a list of - the most important changes. -

- - -

Welcome Pascal Sancho!

- - -

- The Apache™ FOP team is delighted to present you a production grade - release of the new FOP codebase. This release - contains many bug fixes and new features. See the Release Notes for a list of - the most important changes. -

- - -

- The Apache™ FOP team is delighted to present you a beta version of the - next production grade release of the new FOP codebase. This release - contains many bug fixes and new features. See the Release Notes for a list of - the most important changes. -

- - -

Welcome Max Berger!

- - -

Welcome Adrian Cumiskey!

- - -

The Apache™ FOP team is pleased to present you the second production - grade release of the new FOP codebase. This release contains many bug - fixes and new features. See the Release Notes for a list of - the most important changes.

- - -

Welcome Jay Bryant!

- - -

- The Apache™ FOP team is proud to present to you the first - production grade release of the new FOP codebase. This release - has the new API first introduced in release 0.92 beta. It - contains again many bug fixes and new features. -

- - -

Welcome Vincent Hennebert!

- - -

- A second "beta" grade release of the new FOP codebase with a modified and - now considered stable API. The release contains many bug fixes as well as - new features mainly related to even more extensive support of the XSL-FO - specification. This is expected to be the last "beta" release before we - go to a 1.0 release! -

- - -

- One month after the initial release we're happy present a "beta" grade - release of the new FOP codebase. It's mostly a bug fix release but also - contains a few new features. Thanks to all those who sent us feedback - on the initial release! -

- - -

- The Apache™ FOP team is proud to present to you the largely rewritten - codebase which is finally in a state where you can start to use it. - It has taken over three years to get this far and over two years - without a new release from the FOP project. -

-

- Please see also the - announcement. - -

- - -

Welcome Manuel Mall!

- - -

- The Apache Board of Directors agreed to the creation of the - Apache™ XML Graphics - project which will be comprised of Batik and FOP. Both former - Apache™ XML subprojects are in this way complying with the Board's desire - to improve project oversight. Both project teams also see additional - benefits of working more closely together. -

- - -

Welcome Luca Furini!

- - -

Welcome Simon Pepping!

- - -

Welcome Web Maestro Clay Leeds!

- - -

Welcome Chris Bowditch and Andreas Delmelle!

- - -

Welcome Finn Bock!

- - -

Welcome Peter Herweg!

- - -

Changes since 0.20.4 include:

-
    -
  • Added support for PDF encryption
    • -
  • Perfomance tuning
    • -
  • Fixed link hotspot positioning
    • -
  • Fixed multi-threading issues
    • -
  • Added support for CCITT Group 4 encoded TIFF files
    • -
  • Dynamic JAI support
    • -
  • Added autoselecting portrait/landscape for PCL and PS Renderer
    • -
  • Added continued-label extension for tables
    • -
  • Improved AWT Font-measuring/rendering
    • -
  • Improved marker handling
    • -
  • Fixed problem with jpegs with icc profile and acrobat reader 5
    • -
  • Added a fontBaseDir property
    • -
  • TXTRenderer output encoding
    • -
  • border-spacing support
    • -
  • and a lot more bugfixes
    • -
-

- See also the full text of the - - announcement. - -

- - -

Welcome Glen Mazza!

- - -

- See the full text of the announcement. -

- - -

- See the full text of the announcement. -

- - -

- Jeremias Maerki and Peter B. West are now representing FOP on the XML PMC. -

- - -

We are looking for a new logo. FOP logo - contest is started!

- - -

- See FOP project pages at the ApacheWiki. -

- - -

- See the full text of the announcement. -

- - -

- The EXSLFO project is a community effort to define functional extensions - to thet XSL Formatting Objects specification. See the - EXSLFO website for details. -

- - -

Welcome Victor Mote!

- - -

Welcome Oleg Tkachenko!

- - diff --git a/src/documentation/content/xdocs/news.xml b/src/documentation/content/xdocs/news.xml deleted file mode 100644 index 688558226..000000000 --- a/src/documentation/content/xdocs/news.xml +++ /dev/null @@ -1,39 +0,0 @@ - - - - - - - -]> - -
- Apache™ FOP News - $Revision$ -
- -

- RSS Feed: Subproject News Feed -

- - - - diff --git a/src/documentation/content/xdocs/quickstartguide.xml b/src/documentation/content/xdocs/quickstartguide.xml deleted file mode 100644 index bb3822641..000000000 --- a/src/documentation/content/xdocs/quickstartguide.xml +++ /dev/null @@ -1,124 +0,0 @@ - - - - - -
- Apache™ FOP: Quick Start Guide - Everything you need to start using and appreciating Apache™ FOP quickly. - $Revision$ -
- -
- Apache™ FOP Essentials -

The goal of this Quick Start Guide is to help novice users get Apache FOP up and running quickly. Typically, you'll need to:

-
    -
  1. Download FOP
    2. -
  2. Build FOP (you can skip this step if you download the binary distribution!)
    3. -
  3. Configure FOP
    4. -
  4. Run FOP
    5. -
-

Here are some links to help you find out what FOP can do, as well as how and where to get help:

-
    -
  • Calling FOP from a Java Application
    • -
  • Using FOP in Servlets
    • -
  • Using FOP in an 'Ant' Build Script
    • -
  • XSL-FO Compliance (what FOP supports and what it doesn't)
    • -
  • FAQs
    • -
  • Getting Help
    • -
  • Mailing Lists
    • -
-

- Once you've familiarized yourself with the basics, you can get more detailed information, - in the detailed FOP product documentation. -

-
- -
- Hello World with FOP -

- This section walks you through a "Hello World!" page with Apache FOP. We're assuming you - download the binary distribution and that you have a Java Runtime Environment (version 1.4 - or later) installed. -

-
    -
  1. - Unpack the downloaded binary distribution to a directory of your choice (for example, - C:\FOP if you're on Windows). Let's call that - directory <fop-home>. -
    2. -
  2. - Get a command prompt in the <fop-home> directory and write:
    - Windows: fop -fo examples/fo/basic/readme.fo -awt
    - Unix: ./fop -fo examples/fo/basic/readme.fo -awt
    -
    3. -
  3. - If all went well, this should open a window showing you a "readme"-style document. - This is just to verify that FOP runs correctly. -
    4. -
  4. - Now, take your favorite XML editor and create a small XML file like the following. Replace - "Frank" with your own first name to make it a bit more personal and save it as - name.xml:
    - Frank]]> -
    5. -
  5. - To produce a PDF file from this XML file, we need an XSLT stylesheet that converts the - XML to XSL-FO. This is the first step in the processing chain. The second step will be - done by FOP when it reads the generated XSL-FO document and formats it to a PDF document. - You can copy the following minimal XSLT stylesheet, which takes your first name and - produces a "Hello World!"-style document (save it as name2fo.xsl):
    - - - - - - - - - - - - - - Hello, ! - - - - - -]]> - -
    6. -
  6. - Finally, let's put the previous two steps together: Go back to the command prompt and - enter the following command:
    - Windows: fop -xml name.xml -xsl name2fo.xsl -pdf name.pdf
    - Unix: ./fop -xml name.xml -xsl name2fo.xsl -pdf name.pdf
    -
    7. -
  7. - You've produced your first PDF with Apache FOP! Please open name.pdf - in your favorite PDF viewer. -
    8. -
-
- - diff --git a/src/documentation/content/xdocs/resources.xml b/src/documentation/content/xdocs/resources.xml deleted file mode 100644 index d976f9859..000000000 --- a/src/documentation/content/xdocs/resources.xml +++ /dev/null @@ -1,264 +0,0 @@ - - - - - - -
- Apache™ FOP: Other Resources - Resources useful for developing and using Apache™ FOP - $Revision$ -
- -
- Specifications -
- XSL-FO -
    -
  • XSL-FO Recommendation (05 December 2006)
    • -
  • Unofficial DTD for the XSL-FO Recommendation provided by N. Grigoriev from RenderX.
    • -
-
-
- XSLT -
    -
  • XSLT 1.0 Recommendation
    • -
  • XSLT 2.0 Recommendation
    • -
-
-
- XML -
    -
  • XML 1.0
    • -
  • XML 1.1
    • -
  • Simple API for XML (SAX)
    • -
  • Document Object Model (DOM)
    • -
  • Document Object Model (DOM) Level 2 Core Specification
    • -
  • Document Object Model (DOM) Level 3 Core Specification
    • -
  • Namespaces in XML 1.0
    • -
  • Namespaces in XML 1.1
    • -
-
-
- Java -
    -
  • Java 2 Platform, Standard Edition, v 1.4.2 API Specification
    • -
  • Java 2 Platform Standard Edition 5.0 API Specification
    • -
  • Java Platform, Standard Edition 6 API Specification
    • -
-
-
- PDF -
    -
  • Portable Document Format (PDF) Reference Manual -
    • -
-
-
- Unicode -
    -
  • UTR-14 (Unicode Standard Annex #14: Line Breaking Properties)
    • -
-
-
- Other -
    -
  • Supported SVG Recommendation (04 September 2001)
    • -
-
-
-
- Books, Tutorials, Articles -
- XSL-FO -
    -
  • [online book] The XML Bible, by Elliotte Rusty Harold. Chapter 18 of XSL Formatting Objects
    • - -
  • [online article] Using XSL Formatting Objects, by J. David Eisenberg.
    • -
  • [online reference] XSL FO reference, by Miloslav Nic.
    • -
  • [online reference] Dave Pawson's XSL-FO FAQ.
    • -
  • [book] XSL-FO, by Dave Pawson, O'Reilly & Associates, 2002, ISBN 0-596-00355-2. See online version above.
    • -
  • [book] Definitive XSL-FO, by G. Ken Holman, Prentice Hall PTR, 2003, ISBN 0-131-40374-5.
    • -
  • [book] XSL Formatting Objects Developer's Handbook, by Doug Lovell, Sams, 2002, ISBN 0-672-32281-1.
    • -
  • [book] Practical Formatting Using XSLFO, Crane Softwrights Ltd., 2003, ISBN 1-894049-11-X.
    • -
-
-
- XSLT -
    -
  • [online resource] Extensible Stylesheet Language Family (XSL), W3C XSL Family page.
    • -
  • [book] XSLT Programmer's Reference, by Michael H. Kay, Wrox Press, ISBN 1-861-00506-7.
    • -
  • [book] XSLT2 and XPath2 Programmer's Reference, by Michael H. Kay, Wrox Press, ISBN: 978-0-470-19274-0.
    • -
  • [book] XSLT, by Doug Tidwell, O'Reilly & Associates, 2001, ISBN 0-596-00053-7.
    • -
  • [book] XSLT Cookbook, by Sal Mangano, O'Reilly & Associates, 2002, ISBN 0-596-00372-2.
    • -
  • [article] Dave Pawson's XSL FAQ.
    • -
  • [book] XPath and XPointer: Locating Content in XML Documents, by John E. Simpson, O'Reilly & Associates, 2002, ISBN 0-596-00291-2.
    • -
  • [book] XSL Essentials, by Michael Fitzgerald, John Wiley & Sons, 2001, ISBN 0-471-41620-7.
    • -
  • [book] Java and XSLT, by Eric M. Burke, O'Reilly & Associates, 2001, ISBN 0-596-00143-6.
    • -
-
-
- XML -
    -
  • [online book] The XML Bible, by Elliotte Rusty Harold. See hardcopy version below.
    • -
  • [book] The XML Bible, by Elliotte Rusty Harold, John Wiley & Sons, ISBN 0-764-54760-7. See online version above.
    • -
  • [online resource] A great number of additional XML-related books and articles can be found at the O'Reilly XML Site.
    • -
-
-
- Java -
    -
  • [online resource] A great number of Java-related books and articles can be found at the O'Reilly Java Site.
    • -
-
-
- PDF -
    -
  • [online resource] Links to the various PDF file format specifications and numerous other documents can be found at Adobe Solutions Network, Acrobat Resources, Acrobat 5.0 SDK Documentation.
    • -
  • [online resource] A list of PDF technical resources can be found at Adobe Solutions Network, Acrobat Resources, Acrobat/PDF Technical Notes
    • -
  • [online resource] A list of Acrobat and PDF developer resources can be found at Adobe Solutions Network, Acrobat Resources, Resources for Developers.
    • -
-
-
- PostScript -
    -
  • [online resource] A list of PostScript-related technical resources can be found at Adobe Solutions Network, PostScript Language Technical Notes
    • -
  • [online resource] Additional PostScript-related developer resources can be found at Adobe Solutions Network, PostScript SDK Archive.
    • -
-
-
-
- Mailing Lists -

Before posting questions to any list:

-
    -
  • Review the Jakarta Mailing Lists - Guidelines for general principles about mailing lists.
    • -
  • Review "How To Ask Questions The Smart Way".
    • -
  • Send only plain text email messages to any mailing lists. Please do not send html or rtf email, as they do not work well with the archive engines. If you are using Microsoft Outlook, this setting can be found at the "Mail Format" tab of the Tools/Options menu.
    • -
  • Use a mail client that respects the References and/or In-Reply-To mail header entries. This is important for mail clients that can display threads as trees. Compliant mail clients include Microsoft Outlook, Becky!, KMail, Apple Mail, Ximian Evolution, Mozilla (version 1.2 or greater). Non-compliant mail clients include Microsoft Exchange, Lotus Notes, Internet Mail Service (MUA or MTA), and dtmail.
    • -
-

For help in understanding email acronyms, see the Lingo2Word Acronym List, or the Keno Internet Services Internet Glossary.

-
- Apache FOP Mailing List -
    -
  • [mailing list info] http://xml.apache.org/fop/maillist.html
    • -
      -
    • [fop-users mod_mbox archives] http://mail-archives.eu.apache.org/mod_mbox/xmlgraphics-fop-users/
      • -
    • [fop-users archives] http://marc.theaimsgroup.com/?l=fop-user
      • -
    • [fop-users gzip'd archives] http://xmlgraphics.apache.org/mail/fop-users/
      • -
    • [fop-users-subscribe] fop-users-subscribe@xmlgraphics.apache.org
      • -
    • [fop-users-digest-subscribe] fop-users-digest-subscribe@xmlgraphics.apache.org
      • -
    • [fop-users-unsubscribe] fop-users-subscribe@xmlgraphics.apache.org
      • -
    -
      -
    • [fop-dev mod_mbox archives] http://mail-archives.eu.apache.org/mod_mbox/xmlgraphics-fop-dev/
      • -
    • [fop-dev archives] http://marc.theaimsgroup.com/?l=fop-dev
      • -
    • [fop-dev gzip'd archives] http://xmlgraphics.apache.org/mail/fop-dev/
      • -
    • [fop-dev-subscribe] fop-dev-subscribe@xmlgraphics.apache.org
      • -
    • [fop-dev-digest-subscribe] fop-dev-digest-subscribe@xmlgraphics.apache.org
      • -
    • [fop-dev-unsubscribe] fop-dev-unsubscribe@xmlgraphics.apache.org
      • -
    -
-
-
- XSL-FO Mailing List (at W3C) -
    -
  • [mailing list info] http://www.w3.org/Mail/Request
    • -
  • [mailing list archives] http://lists.w3.org/Archives/Public/www-xsl-fo/
    • -
-
-
- XSL-FO Mailing List (at YahooGroups) -
    -
  • [mailing list info & archives] http://groups.yahoo.com/group/XSL-FO
    • -
-
-
- XSLT List (Mulberry Tech) -
    -
  • [mailing list info & archives] http://www.mulberrytech.com/xsl/xsl-list
    • -
-
-
-
- Related/Useful Products -
- FOP add-ons -
    -
  • [software] TIFFRenderer is a renderer for outputting multi-page TIFF: http://www.tkachenko.com/fop/tiffrenderer.html (MPL)
    • -
  • [software] The Mogwai Project includes a renderer for FOP that generates output for Okidata dot matrix printers (GPL).
    • -
  • [software] Barcode4J (formerly Krysalis Barcode) is a barcode generator which can be used with FOP (Apache license v2.0).
    • -
  • [software] JEuclid is a MathML implementation which can be used with FOP (Apache license v2.0).
    • -
  • [software] AFP Renderer renders formatted objects to AFP or (MO:DCA). (Has been integrated in FOP)
    • -
  • [software & tools] Objects For Formatting Objects hosts hyphenation patterns and (eventually) files other accessory data files & scripts.
    • -
-
-
- PDF post-processors -
    -
  • [software] Apache PDFBox (Apache License V2.0)
    • -
  • [software] iText (MPL and LGPL)
    • -
  • [software] PJX by Etymon (GPL)
    • -
  • [software] pdftk the pdf toolkit
    • -
-
-
- XSL-FO editors -
    -
  • [software] FOA (Formatting Objects Authoring) (MPL)
    • - -
  • [software] Scriptura by Inventive Designers (commercial)
    • -
  • [software] XSLfast by jCatalog Software AG (commercial)
    • -
  • [software] DIGIFORMS Document Designer by Metafocus (commercial)
    • -
-
-
- Other products -
    -
  • [software] FOray a renderer for converting XML files to PDF via XSL Formatting Object elements (FOP fork)
    • - -
  • [software] xmlroff an open source XSL-FO implementation written in C (BSD-style license)
    • - -
  • [commercial software developer] Antenna House - XSL Formatter, WordMLToFo, XML Editor...
    • -
  • [commercial software developer] RenderX XEP, EnMasse, Docbench...
    • - -
  • [software] html2fo is a converter from HTML to XSL-FO (GPL).
    • -
  • [software] wh2fo is a converter from Word HTML to XSL-FO (MPL).
    • -
  • [software] RTF2FO is a converter from RTF to XSL-FO by Novosoft (commercial).
    • -
  • [software] css2xslfo CSSToXSLFO - is a utility which can convert an XML document, together with a CSS2 style sheet, - into an XSLFO document, which can then be converted into PDF, PostScript, etc. with - an XSLFO-processor. It has special support for the XHTML vocabulary, because that - is the most obvious language it would be used for. The tool has a number of - page-related extensions. It also comes with an API in the form of an XML - filter (OSI-Approved Open Source - Public Domain).
    • -
  • - [software] FOP Bridge is an Eclipse plug-in - that allows to convert FO documents using Apache FOP directly inside the Eclipse workbench (LGPL). -
    • -
  • [software] Maven Doxia FO Module. Doxia is a content generation framework which aims to provide its users with powerful techniques for generating static and dynamic content: Doxia can be used in web-based publishing context to generate static sites, in addition to being incorporated into dynamic content generation systems like blogs, wikis and content management systems. Doxia provides a module providing XSL Formatting Objects.
    • -
-
-
- - diff --git a/src/documentation/content/xdocs/site.xml b/src/documentation/content/xdocs/site.xml deleted file mode 100644 index b5e9ad607..000000000 --- a/src/documentation/content/xdocs/site.xml +++ /dev/null @@ -1,297 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/src/documentation/content/xdocs/status.xml b/src/documentation/content/xdocs/status.xml deleted file mode 100644 index b774130e9..000000000 --- a/src/documentation/content/xdocs/status.xml +++ /dev/null @@ -1,135 +0,0 @@ - - - - - - -
- Apache™ FOP Status - Current Status of Apache™ FOP - $Revision$ -
- -
- Status -

Last updated 20 October 2012.

-

- Apache™ FOP Version 1.1 was released on 20 October 2012. -

-
-
- Development Status -

- The FOP code base is gradually evolving, from Version 0.90, - released on 22 November 2005, to Version 1.1, released on - 20 October 2012. Further releases in the 1.x series and beyond are expected. -

-

- FOP releases prior to version 0.90 were based on a different - code base. The last release in that series was version 0.20.5, - released on 18 July 2003. This earlier series is no longer maintained. -

-

- If you are looking for future release dates, keep in mind that FOP is an Open - Source project and we're a combination of volunteers (working in our free time) and - sponsored contributors (generally focusing on our sponsor's needs). What we have - is an idea where we want to go. How fast we get there depends on the - available time, on how well our ideas work out while developing and on you! - There's a document in the Wiki - where ideas for new developments may be registered and documented. -

-
- Status of the individual components -

- Not all the components of FOP currently have the same quality. The following - table tries to give you an overview: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ComponentStatus
APIstable
FO Treestable
Layout Enginestable
Area Treestable
Intermediate Format Supportstable (could use a speed upgrade)
PDF (Library and Renderer)stable
PostScriptstable
Java2D, AWT, Bitmap Renderersstable
Text Rendererstable (not much feedback)
RTF Handlerbeta, restricted functionality compared to PDF/PS
PCL Rendererstable (not much feedback)
AFP Rendererstatus unknown (not much feedback)
SVG Renderernon-functional in sandbox, help needed
Font Supportstable
Image Supportbeta (recently rewritten)
Hyphenation Subsystemstable
-
-
- - diff --git a/src/documentation/content/xdocs/tabs.xml b/src/documentation/content/xdocs/tabs.xml deleted file mode 100644 index e14d9409e..000000000 --- a/src/documentation/content/xdocs/tabs.xml +++ /dev/null @@ -1,28 +0,0 @@ - - - - - - - - - - - - diff --git a/src/documentation/content/xdocs/team.xml b/src/documentation/content/xdocs/team.xml deleted file mode 100644 index 2b1ef281b..000000000 --- a/src/documentation/content/xdocs/team.xml +++ /dev/null @@ -1,128 +0,0 @@ - - - - - -
- Apache™ FOP: Development Team - $Revision: 1364036 $ -
- -

- All lists on this page are in alphabetical order. Some of them may be incomplete. - If you know of an error or omission, please send a message to the - fop-dev mailing list.

-
- Active Committers - Please don't write to any developer directly if you need help on using FOP. Only if you submit questions to the FOP User Mailing List will other FOP users be able to profit from answers given to your question. Another point is that a developer may have gone inactive or is on holidays in which case you may not get an answer in time. -
    -
  • Glenn Adams (GA) - is an independent consultant. He is former technical director of the Unicode Consortium, - and a co-author of the Unicode Standard. He served on ISO JTC1/SC2 - (Coded Character Sets) and JTC1/SC18/WG8 (Document Processing) committees, and was actively - involved in the creation of ISO 8879 (SGML), ISO/IEC 9541 (Font Information Interchange), - ISO/IEC 10179 (DSSSL), ISO/IEC 10180 (SPDL), ISO/IEC 10646 (Universal Coded Character Set), - and, within the W3C, on XSL-FO 1.0.
    • -
  • Luis Bernardo (LB)
    • -
  • Chris Bowditch (CB) - is a Java/VB Programmer from England.
    • -
  • Adrian Cumiskey (AC) - is an XP/Agile practitioner with interests in open source content management and electronic - document generation. He is a UK expat now residing in Singapore.
    • - -
  • Peter Hancock - (PH) is a Java developer from England.
    • -
  • Vincent Hennebert - (VH), a Java developer from France; with an interest in typography, and in using - Fop as a pdf renderer for book-like documents.
    • -
  • Mehdi Houshmand (MH) - is a developer from the UK with a background in Physics. - Worked on Flow Cytometry for research and military uses, Telecoms systems and CMS software. - Programmed in C/C++, Java and currently learning Python
    • -
  • Clay Leeds (CL) - is a web/WAP/Palm developer from Laguna Beach, California, USA. A - recent XML/XSL-FO convert, he has been nit-picking FAQs & assorted web - pages since his first webmaster position @brain.com in 1996. Most - important creation? He's got a couple of cool kids.
    • -
  • Jeremias Märki (JM) - is an independent software engineer and consultant from Lucerne, Switzerland. He's also - the creator of Barcode4J. - See his home page for more information - about him. -
    • -
  • Simon Pepping (SP) came to FOP - from the TeX/LaTeX world. See his home - page for some of his private projects.
    • -
  • Jörg Pietschmann (JP)
    • -
  • Pascal Sancho (PS) - is an XML developper from Aix-en-Provence (France). He works on software solutions for - rendering various kind of documents on various supports, more specifically taking care - of PDF generation with FOP.
    • -
-
-
- Active Contributors -
    -
  • Georg Datterl is a software developer from Austria, currently working for - Geneon media solutions gmbh in Nuremberg, Germany. He needs FOP to wrestle gigabytes of - electronic data into thousands of printed pages.
    • -
  • Alexios Giotis holds a Ph.D. in the optimization of turbomachinery cascades - using evolutionary algorithms, neural networks and parallel processing. He is one of - the founding members of i-docs (software for enterprises) and he has been leading its - technical design & implementation based on open source libraries since its inception. - He is relying on Apache FOP for generating high volumes of documents on major banks and - telecom operators since FOP's 1.0 release. He lives in Athens, Greece.
    • -
-
-
- Founder -

FOP was originally created and donated to the Apache Software Foundation by James Tauber. - Information about him can be found at his website.

-
-
- Inactive Committers -
    -
  • Max Berger (MB)
    • -
  • Finn Bock (FB)
    • -
  • Jay Bryant (JB)
    • -
  • Kelly Campbell
    • -
  • Steven Coffman
    • -
  • Bertrand Delacretaz
    • -
  • Tore Engvig
    • - -
  • Luca Furini (LF)
    • -
  • Christian Geisert (CG)
    • -
  • Stanislav Gorkhover
    • -
  • Peter Herweg
    • -
  • Fotis Jannidis
    • -
  • Karen Lease
    • -
  • Keiron Liddle
    • -
  • Manuel Mall (MM)
    • -
  • Glen Mazza
    • -
  • Victor Mote
    • -
  • Jordan Naftolin
    • -
  • Arved Sandstrom
    • -
  • Eric Schaeffer
    • -
  • Oleg Tkachenko (OT)
    • -
  • Art Welch
    • -
  • Peter B. West
    • -
-
- - - diff --git a/src/documentation/content/xdocs/trunk/accessibility.xml b/src/documentation/content/xdocs/trunk/accessibility.xml deleted file mode 100644 index 412519d8b..000000000 --- a/src/documentation/content/xdocs/trunk/accessibility.xml +++ /dev/null @@ -1,167 +0,0 @@ - - - - - -
- Apache™ FOP: Accessibility -
- -
- Overview -

- This page describes the - accessibility - features of Apache™ FOP. - Section 508 defines accessibility in the context - of electronic documents for the USA but other countries have similar requirements. -

-

- 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. -

-
-
- Enabling accessibility -

There are 3 ways to enable accessibility:

-
    -
  1. - Command line: The command line option -a turns on accessibility: - fop -a -fo mydocument.fo -pdf mydocument.pdf -
    2. -
  2. - Embedding: userAgent.setAccessibility(true); -
    3. -
  3. - Optional setting in fop.xconf file: - 
    -          <fop version="1.0">
-              <accessibility>true</accessibility>
-              ...
-          </fop>
-
    -
    4. -
-

- 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. -

- 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 in order to generate really accessible documents: -

-
    -
  • Table cells must have a table row as their parent.
    • -
  • - Images must have an alternate text: use the fox:alt-text extension attribute - (in the fox namespace) on - fo:external-graphic and fo:instream-foreign-object to specify a - short text describing the image. -
    • -
  • - Ensure that the order of fo:block-container elements in a page corresponds to - the reading order. -
    • -
  • - Specify the natural language of the document using the language and country properties - (or via the xml:lang shorthand property). -
    • -
-
-
- Customized Tagging -

The PDF Reference defines a set of standard Structure Types to - tag content. For example, ‘P’ is used for identifying paragraphs, ‘H1’ to ‘H6’ for headers, - ‘L’ for lists, ‘Div’ for block-level groups of elements, etc. This standard set is aimed at - improving interoperability between applications producing or consuming PDF.

-

FOP provides a default mapping of Formatting Objects to elements from that standard set. - For example, fo:page-sequence is mapped to ‘Part’, fo:block is - mapped to ‘P’, fo:list-block to ‘L’, etc.

-

You may want to customize that mapping to improve the accuracy of the tagging or deal with - particular FO constructs. For example, you may want to make use of the ‘H1’ to ‘H6’ tags to - make the hierarchical structure of the document appear in the PDF. This is achieved by using - the role XSL-FO property:

- ... -<fo:block role="H1" font-weight="bold">I. A Level 1 Heading</fo:block> -<fo:block>This is the first paragraph of the first section...</fo:block> -... -

If a non-standard structure type is specified, FOP will issue a warning and fall back to - the default tag associated to the Formatting Object.

-
-
- Testing -

- 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 there are certain - limitations. Please help us identify and close any gaps. -

-
    -
  • - The natural language can currently only be specified at the page-sequence level. The - document language is derived from the language of the first page-sequence. It is - currently not possible to override the language inside the content below the - page-sequence level. -
    • -
  • - It's currently not possible to specify the expanded form of an abbreviation or acronym. -
    • -
  • - SVG graphics (or images in general) are treated as a single figure. Text contained in - SVGs is not accessible. It's only possible to work with fox:alt-text. -
    • -
  • - The side regions (region-before, region-after etc.) are currently not specially - identified. Screen readers may read their content at page changes. -
    • -
-
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/trunk/anttask.xml b/src/documentation/content/xdocs/trunk/anttask.xml deleted file mode 100644 index ba53fe7d1..000000000 --- a/src/documentation/content/xdocs/trunk/anttask.xml +++ /dev/null @@ -1,236 +0,0 @@ - - - - - -
- Apache™ FOP: Ant task - $Revision$ -
- -

- Apache™ FOP provides an Ant task for automating the document build process. -

-
- Description -

- The FOP Ant task will convert XSL-FO documents to PDF, PS, PCL etc. output - (see Output formats for available formats). -

-

- To call FOP tasks within Ant, first add a FOP task definition to your Ant build file. - One method of defining the task is as follows: -

- - - - - - - - - - - - - - ]]> -

- Then create FOP tasks within your Ant build file, using the FOP task parameters listed below.

-
- -
Parameters for FOP Ant task - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Parameters specified as attributes
AttributeDescriptionRequired
fofileXSL-FO file to be renderedYes, if no fileset nested element is used
xmlfileXML input fileYes, if no fofile is specified
xsltfileXSLT input fileYes, if no fofile is specified
outfileOutput filenameYes, when fofile is used. (This attribute is not valid for filesets.)
formatPossible output formats:
- application/X-fop-awt-preview
- application/X-fop-print
- application/X-fop-areatree
- application/pdf
- application/postscript
- application/mif
- application/rtf, - text/richtext, - text/rtf
- application/x-pcl, - application/vnd.hp-PCL
- application/x-afp, - application/vnd.ibm.modcap
- text/plain
- image/svg+xml
- image/gif
- image/png
- image/tiff
- 		No, defaults to application/pdf
outdirOutput directoryRequired if a fileset is used to specify the files to render; optional for fofile. (Can alternatively specify the full path in the fofile value.)
forceRecreate target files, even if they are newer than their corresponding - source files. Note: This attribute is available in post-0.20.5 - versions (0.20.x nightly build and 1.0dev) only; target files are - always generated (i.e., force=true) in 0.20.5 release. - No, default is false
basedirBase directory to resolve relative references (e.g., graphics files) within the - FO document. - No, for single FO File entry, default is to use the location - of that FO file. -
relativebaseFor fileset usage only. A value of true specifies using the location - of each .fo file as the base directory for resolving relative file references located - within that .fo file. A value of false specifies using the value of - basedir for all files within the fileset, or just the current working directory - if basedir is not specified. - No, default is false. -
userconfigUser configuration file (same as the FOP "-c" command line option).No
messagelevelLogging level
- Possible values: error, warn, info, verbose, debug. Currently doesn't work in FOP Trunk!!!		No, defaults to verbose
logFilesControls whether the names of the files that are processed are logged - (true) or not (false). Currently doesn't work in FOP Trunk!!!No, default is true
throwexceptionsControls whether or not an exception is thrown if an error occurs during rendering.Default is true
-

- - - - - - - - - - - -
Parameters specified as nested elements
AttributeDescriptionRequired
filesetFileSets - are used to specify multiple XSL-FO files to be rendered.Yes, if no fofile attribute is supplied
-

-
- Examples -

- The following example converts a single XSL-FO file to a PDF document: -

- - - - - ]]> -

- This example converts all XSL-FO files within an entire directory to PostScript: -

- - - - - - - - ]]> -

- The following example transforms and converts a single XML and XSLT file to an AFP document: -

- - - - ]]> -

- This example transforms and converts all XML files within an entire directory to PostScript: -

- - - - - - - - ]]> -
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/trunk/compiling.xml b/src/documentation/content/xdocs/trunk/compiling.xml deleted file mode 100644 index 7bfa165b5..000000000 --- a/src/documentation/content/xdocs/trunk/compiling.xml +++ /dev/null @@ -1,147 +0,0 @@ - - - - - -
- Apache™ FOP: Building from Source Code - $Revision$ -
- -
- Do You Need To Build? - - - - -

- Apache™ FOP snapshots are either pre-compiled binary or source. - If you are using a binary snapshot, it is already built and there is no need to build it again. - If you got the source code from a repository snapshot or via Subversion you will need to build FOP. - See the Download Instructions for information about where to obtain binary or repository snapshots, and whether a - binary or source snapshot is best for your needs. -

- -
-
- Set Up Your Environment -
- JDK -

- Building FOP requires a minimum Java Development Kit (JDK/SDK) of 1.4 - (A Java Runtime Environment is not sufficient). -

-
-
- CLASSPATH -

- There is generally no need to setup a classpath. All libraries needed to compile FOP are included - in the source distribution and are referenced by the build script. - You will only need to adjust the classpath if you build FOP in some other way. See the build - script build.xml for details. -

-
-
- JAVA_HOME -

- The build script uses Apache Ant, a popular - Java-based build tool, which usually requires that the environment variable JAVA_HOME point to - your local JDK root directory. This is true even if you use JDK 1.4 or above, which normally - does not need this setting. -

-
-
- Apache Ant -

- Apache Ant (Version 1.7 or later) must be installed in order to - build FOP. Following best practices we don't include Ant with FOP anymore. You can find the - instructions to install Ant in the Ant manual on the web. -

-
-
-
- Run the Build Script -

- Change to the FOP root directory and build FOP by executing the build script (build.xml) - using the "ant" command. -

- - The "ant" command is only available on your system if you've properly - installed Apache Ant and added Ant's location to the PATH - environment variable. - -

- The file build.xml in the FOP root directory is the blueprint that Ant uses for the build. It - contains information for numerous build targets, many of which are building blocks to more - useful target, and others which are primarily used by the FOP developers. - You may benefit from looking through this file to learn more about the various build targets. - To obtain a complete list of useful build targets: -

- ant -projecthelp -

The most useful targets are:

-
    -
  • - package: Generates the JAR files (default). This is the normal build that - produces a jar file usable for running FOP. -
    • -
  • - clean : Cleans the build directory. This is useful for making sure that - any build errors are cleaned up before starting a new build. It should not ordinarily be - needed, but may be helpful if you are having problems with the build process itself. -
    • -
  • - javadocs: Creates the FOP API documentation. - A minimum JDK version of 1.4.2 is required for generating the javadocs. -
    • -
-

To run the build:

- ant [target ...] -

For example to do a normal build for the "all" target (which is the default):

- ant -

OR

- ant all -

To clean the build directory first:

- ant clean all - - If you want to shorten the build time you can just call the "package" target which - doesn't perform any automated tests during the build. - -
-
- Troubleshooting -

If you have problems building FOP, please try the following:

-
    -
  • Run the build with the target of "clean", then rerun the build.
    • -
  • Delete the build directory completely, then rerun the build.
    • -
  • - Make sure you do not have a non-FOP version of xerces.jar, xalan.jar, batik.jar, - or another dependency product somewhere in your CLASSPATH. -
    • -
  • - If the build still fails, see the Getting Help - page for further help. -
    • -
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/trunk/complexscripts.xml b/src/documentation/content/xdocs/trunk/complexscripts.xml deleted file mode 100644 index c622fe192..000000000 --- a/src/documentation/content/xdocs/trunk/complexscripts.xml +++ /dev/null @@ -1,628 +0,0 @@ - - - - - -
- Apache™ FOP: Complex Scripts -
- -
- Overview -

- This page describes the - complex scripts - features of Apache™ FOP, which include: -

-
    -
  • Support for languages written with right-to-left scripts, such as Arabic and Hebrew scripts.
    • -
  • Support for languages written with South Asian and Southeast Asian scripts, such as Devanagari, - Khmer, Tamil, Thai, and others.
    • -
  • Support for advanced substitution, reordering, and positioning of glyphs according to language - and script sensitive rules.
    • -
  • Support for advanced number to string formatting.
    • -
-
-
- Disabling complex scripts -

Complex script features are enabled by default. If some application of FOP does not - require this support, then it can be disabled in three ways:

-
    -
  1. - Command line: The command line option -nocs turns off complex script - features: fop -nocs -fo mydocument.fo -pdf mydocument.pdf -
    2. -
  2. - Embedding: userAgent.setComplexScriptFeaturesEnabled(false); -
    3. -
  3. - Optional setting in fop.xconf file: - 
    -<fop version="1.0">
-  <complex-scripts disabled="true"/>
-  ...
-</fop>
-
    -
    4. -
-

- When complex scripts features are enabled, additional information related to bidirectional - level resolution, the association between characters and glyphs, and glyph position adjustments - are added to the internal, parsed representation of the XSL-FO tree and its corresponding - formatted area tree. This additional information will somewhat increase the memory requirements for - processing documents that use these features. -

- A document author need not make explicit use of any complex scripts feature in order - for this additional information to be created. For example, if the author makes use of a font - that contains OpenType GSUB and/or GPOS tables, then those tables will be automatically used - unless complex scripts features are disabled. -
-
- Changes to your XSL-FO input files -

- In most circumstances, XSL-FO content does not need to change in order to make use of - complex scripts features; however, in certain contexts, fully automatic processing is not - sufficient. In these cases, an author may make use of the following XSL-FO constructs: -

-
    -
  • The script property.
    • -
  • The language property.
    • -
  • The writing-mode property.
    • -
  • The number to string conversion properties: - format, - grouping-separator, - grouping-size, - letter-value, - and fox:number-conversion-features.
    • -
  • The fo:bidi-override element.
    • -
  • Explicit bidirectional control characters: U+200E LRM, U+200F RLM, U+202A LRE, - U+202B RLE, U+202C PDF, U+202D LRO, U+202E RLO.
    • -
  • Explicit join control characters: U+200C ZWNJ and U+200D ZWJ.
    • -
-
-
- Authoring Details -

The complex scripts related effects of the above enumerated XSL-FO constructs are more - fully described in the following sub-sections.

-
- Script Property -

In order to apply font specific complex script features, it is necessary to know - the script that applies to the text undergoing layout processing. This script is determined - using the following algorithm: -

-
    -
  1. If the FO element that governs the text specifies a - script - property and its value is not the empty string or "auto", then that script is used.
    2. -
  2. Otherwise, the dominant script of the text is determined automatically by finding the - script whose constituent characters appear most frequently in the text.
    3. -
-

In case the automatic algorithm does not produce the desired results, an author may - explicitly specify a script property with the desired script. If specified, - it must be one of the four-letter script code specified in - ISO 15924 Code List or - in the Extended Script Codes table. Comparison - of script codes is performed in a case-insensitive manner, so it does not matter what case - is used when specifying these codes in an XSL-FO document.

-
- Standard Script Codes -

The following table enumerates the standard ISO 15924 4-letter codes recognized by FOP.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
CodeScript
arabArabic
bengBengali
bopoBopomofo
cyrlCyrillic
devaDevanagari
ethiEthiopic
georGeorgian
grekGreek
gujrGujarati
guruGurmukhi
hangHangul
haniHan
hebrHebrew
hiraHiragana
kanaKatakana
kndaKannada
khmrKhmer
laooLao
latnLatin
mlymMalayalam
mymrBurmese
mongMongolian
oryaOriya
sinhSinhalese
tamlTamil
teluTelugu
thaiThai
tibtTibetan
zmthMath
zsymSymbol
zyyyUndetermined
zzzzUncoded
-
-
- Extended Script Codes -

The following table enumerates a number of non-standard extended script codes recognized by FOP.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
CodeScriptComments
bng2BengaliOpenType Indic Version 2 (May 2008 and following) behavior.
dev2DevanagariOpenType Indic Version 2 (May 2008 and following) behavior.
gur2GurmukhiOpenType Indic Version 2 (May 2008 and following) behavior.
gjr2GujaratiOpenType Indic Version 2 (May 2008 and following) behavior.
knd2KannadaOpenType Indic Version 2 (May 2008 and following) behavior.
mlm2MalayalamOpenType Indic Version 2 (May 2008 and following) behavior.
ory2OriyaOpenType Indic Version 2 (May 2008 and following) behavior.
tml2TamilOpenType Indic Version 2 (May 2008 and following) behavior.
tel2TeluguOpenType Indic Version 2 (May 2008 and following) behavior.
- - Explicit use of one of the above extended script codes is not portable, - and should be limited to use with FOP only. - - - When performing automatic script determination, FOP selects the OpenType Indic - Version 2 script codes by default. If the author requires Version 1 behavior, then - an explicit, non-extension script code should be specified in a governing script - property. - -
-
-
- Language Property -

Certain fonts that support complex script features can make use of language information in order for - language specific processing rules to be applied. For example, a font designed for the Arabic script may support - typographic variations according to whether the written language is Arabic, Farsi (Persian), Sindhi, Urdu, or - another language written with the Arabic script. In order to apply these language specific features, the author - may explicitly mark the text with a language - property.

-

When specifying the language property, the value of the property must be either an - ISO639-2 3-letter code or an - ISO639-1 2-letter code. Comparison of language - codes is performed in a case-insensitive manner, so it does not matter what case is used when specifying these - codes in an XSL-FO document.

-
-
- Writing Mode Property -
-
- Number Conversion Properties -
-
- Bidi Override Element -
-
- Bidi Control Characters -
-
- Join Control Characters -
-
-
- Supported Scripts -

Support for specific complex scripts is enumerated in the following table. Support - for those marked as not being supported is expected to be added in future revisions.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ScriptSupportTestedComments
Arabicfullfull
Bengalinonenone
Burmesenonenone
Devanagaripartialpartialjoin controls (ZWJ, ZWNJ) not yet supported
Khmernonenone
Gujaratipartialnonepre-alpha
Gurmukhipartialnonepre-alpha
Hebrewfullpartial
Kannadanonenone
Laononenone
Malayalamnonenone
Mongoliannonenone
Oriyanonenone
Tamilnonenone
Telugunonenone
Tibetannonenone
Thainonenone
-
-
- Supported Fonts -

Support for specific fonts is enumerated in the following sub-sections. If a given - font is not listed, then it has not been tested with these complex scripts features.

-
- Arabic Fonts - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FontVersionGlyphsComments
Arial Unicode MS1.0150377limited GPOS support
Lateef1.01147language features for Kurdish (KUR), Sindhi (SND), Urdu (URD)
Scheherazade1.01197language features for Kurdish (KUR), Sindhi (SND), Urdu (URD)
Simplified Arabic1.01 - contains invalid, out of order coverage table entries
Simplified Arabic5.00414lacks GPOS support
Simplified Arabic5.92473includes GPOS for advanced position adjustment
Traditional Arabic1.01530lacks GPOS support
Traditional Arabic5.00530lacks GPOS support
Traditional Arabic5.92589includes GPOS for advanced position adjustment
-
-
- Devanagari Fonts - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FontVersionGlyphsComments
Aparajita1.00706 -
Kokila1.00706 -
Mangal5.01885designed for use in user interfaces
Utsaah1.00706 -
-
-
-
- Other Limitations -

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

-
    -
  • Only the PDF output format fully supports complex scripts features at the present time.
    • -
  • Shaping context does not extend across an element boundary. This limitation prevents the use of - fo:character, fo:inline or fo:wrapper in order to colorize - individual Arabic letters without affecting shaping behavior across the element boundary.
    • -
-
- - - diff --git a/src/documentation/content/xdocs/trunk/configuration.xml b/src/documentation/content/xdocs/trunk/configuration.xml deleted file mode 100644 index 563ae9647..000000000 --- a/src/documentation/content/xdocs/trunk/configuration.xml +++ /dev/null @@ -1,559 +0,0 @@ - - - - - -
- Apache™ FOP: Configuration - $Revision$ -
- - -
- Configuration File Basics -

- The Apache™ FOP configuration file is an XML file containing a variety of settings that are useful - for controlling FOP's behavior, and for helping it find resources that you wish it to use. -

-

- The easiest way to get started using a FOP configuration file is to copy the sample found - at {fop-dir}/conf/fop.xconf to a location of your choice, and then to - edit it according to your needs. - It contains templates for the various configuration options, most of which are commented - out. Remove the comments and change the settings for entries that you wish to use. - Be sure to follow any instructions, including comments which specify the value range. - Also, since the configuration file is XML, be sure to keep it well-formed. -

-
- Making Configuration Available to FOP -

After creating your configuration file, you must tell FOP how to find it:

- -

- See Setting the Configuration Programmatically - for instructions on how to do so in an embedded environment. -

-
-
-
- Summary of the General Configuration Options - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ElementData Type (for the value)DescriptionDefault Value
baseURL or directorySpecifies the base URL based on which relative URL will be resolved.current directory
font-baseURL or directorySpecifies the base URL based on which relative font URLs will be resolved. - base URL/directory (above)
hyphenation-baseURL or directorySpecifies the base URL based on which relative URLs to hyphenation pattern - files will be resolved. If not specified, support for user-supplied hyphenation - patterns remains disabled. - disabled
Relative URIs for the above three properties are evaluated relative to the base URI of the configuration file. If the configuration is provided programmatically, the base URI can be set with FopFactory.setUserConfigBaseURI; default is the current working directory.
hyphenation-patternString, attribute lang, attribute country (optional)Register a file name for the hyphenation pattern for the mentioned language and country. Language ll and country CC must both consist of two letters.ll_CC
source-resolutionInteger, dpi - Resolution in dpi (dots per inch) which is used internally to determine the pixel - size for SVG images and bitmap images without resolution information. - 72 dpi
target-resolutionInteger, dpi - Resolution in dpi (dots per inch) used to specify the output resolution for bitmap - images generated by bitmap renderers (such as the TIFF renderer) and by bitmaps - generated by Apache Batik for filter effects and such. - 72 dpi
strict-configurationBoolean (true, false) - Setting this option to 'true' will cause FOP to strictly verify the contents of the - FOP configuration file to ensure that defined resources (such as fonts and base - URLs/directories) are valid and available to FOP. Any errors found will cause FOP to - immediately raise an exception.false
strict-validationBoolean (true, false) - Setting this option to 'false' causes FOP to be more forgiving about XSL-FO validity, - for example, you're allowed to specify a border on a region-body which is supported - by some FO implementations but is non-standard. Note that such a border would - currently have no effect in Apache FOP.true
break-indent-inheritanceBoolean (true, false) - Setting this option to 'true' causes FOP to use an alternative rule set to determine - text indents specified through margins, start-indent and end-indent. Many commercial - FO implementations have chosen to break the XSL specification in this aspect. This - option tries to mimic their behaviour. Please note that Apache FOP may still not - behave exactly like those implementations either because FOP has not fully matched - the desired behaviour and because the behaviour among the commercial implementations - varies. The default for this option (i.e. false) is to behave exactly like the - specification describes.false
complex-scriptsattribute disabled (optional) - If present and if an attribute 'disabled' is specified with the value 'false', then - complex script features are disabled. The same result can be obtained on an FOP - per-invocation basis by specifying a '-nocs' command line option when invoking FOP. - When complex script features are disabled, all bidirectional processing and complex - character to glyph mapping processing is disabled; in addition, the loading of - GDEF, GSUB, and GPOS advanced typographic tables is disabled for OpenType and - TrueType fonts. Unless disabled by this mechanism or by use of the '-nocs' command - line option, complex script features will be enabled by default. - n/a
default-page-settingsn/a - Specifies the default width and height of a page if "auto" is specified - for either or both values. Use "height" and "width" attributes on the - default-page-settings element to specify the two values."height" 11 inches, "width" 8.26 inches
use-cacheboolean (true, false)All fonts information that has been gathered as a result of "directory" - or "auto-detect" font configurations will be cached for future rendering runs. - This setting should improve performance on systems where - fonts have been configured using the "directory" or "auto-detect" tag mechanisms. - By default this option is switched on.true
cache-fileStringThis option specifies the file/directory path of the fop cache file. - This file is currently only used to cache font triplet information for future reference.${base}/conf/fop.cache
renderers(see text below)Contains the configuration for each renderer. See below.N/A
-

- This is an excerpt from the example configuration file coming with FOP: -

- - - - true - - - true - - - ./ - - - ./ - - - 72 - - 72 - - - - - - nl_Bel - - -]]> -
-
- Image Loading Customization -

- Apache FOP uses the image loading framework from - Apache XML Graphics Commons to load - images using various plug-ins. Every image loader plug-in has a hard-coded usage penalty - that influences which solution is chosen if there are multiple possibilities to load an image. - Sometimes, though, these penalties need to be tweaked and this can be done in the FOP - configuration. An example: -

- - [..] - - - - - ]]> -

- The first penalty element increases the penalty for the raw CCITT loader. This practically - forces the decoding of CCITT compressed TIFF images except if there are no TIFF codecs - available. -

-

- The second penalty element sets an "infinite" penalty for the TIFF loader using the internal - TIFF codec. This practically disables that plug-in as it will never be chosen as a possible - solution. -

-

- Negative penalties are possible to promote a plug-in but a negative penalty sum will be - treated as zero penalty in most cases. For more details on the image loading framework, - please consult the documentation there. -

-

- The ImageLoaderPNG and ImageLoaderRawPNG have a hard-coded penalty of 1000 and as such the - ImageLoaderImageIO image loader will be selected by default when loading PNGs unless - the latter is disabled by awarding a INFINITE penalty to it, or one of the former two is - promoted by awarding a strong negative penalty (say, -10000) to it. -

- - [..] - - - - - - ]]> -
-
- Renderer configuration -

- Each Renderer has its own configuration section which is identified by the - MIME type the Renderer is written for, ex. "application/pdf" for the PDF Renderer. -

-

- The configuration for the PDF Renderer could look like this: -

- - - - - flate - - - - - - - - - - - - - - - ]]> -

- The details on the font configuration can be found on the separate Fonts page. - Note especially the section entitled Register Fonts with FOP. -

-
- Special Settings for the PDF Renderer -

- The configuration element for the PDF renderer contains two elements. One is for the font configuration - (please follow the link above) and one is for the "filter list". The filter list controls how the - individual objects in a PDF file are encoded. By default, all objects get "flate" encoded (i.e. simply - compressed with the same algorithm that is also used in ZIP files). Most users don't need to change that - setting. For debugging purposes, it may be desired not to compress the internal objects at all so the - generated PDF commands can be read. In that case, you can simply use the following filter list. The - second filter list (type="image") ensures that all images still get compressed but also ASCII-85 encoded - so the produced PDF file is still easily readable in a text editor. -

- - - null - - - flate - ascii-85 - - - ]]> -

- Another (optional) setting specific to the PDF Renderer is an output color profile, an ICC - color profile which indicates the target color space the PDF file is generated for. This - setting is mainly used in conjunction with the PDF/X feature. - An example: -

- - C:\FOP\Color\EuropeISOCoatedFOGRA27.icc - - ]]> -

- Some people don't have high requirements on color fidelity but instead want the smallest - PDF file sizes possible. In this case it's possible to disable the default sRGB color space - which XSL-FO requires. This will cause RGB colors to be generated as device-specific RGB. - Please note that this option is unavailable (and will cause an error) if you enable - PDF/A or PDF/X functionality or if you specify an output profile. This setting will make the - PDF about 4KB smaller. To disable the sRGB color space add the following setting: -

- - true - - ]]> - -

FOP supports encryption of PDF output, thanks to Patrick C. Lankswert. - This feature is commonly used to prevent unauthorized viewing, printing, editing, copying text - from the document and doing annotations. It is also possible to ask the user for a password in - order to view the contents. Note that there already exist third party applications which can - decrypt an encrypted PDF without effort and allow the aforementioned operations, therefore the - degree of protection is limited. For further information about features and restrictions - regarding PDF encryption, look at the documentation coming with Adobe Acrobat or the technical - documentation on the Adobe web site.

- - - 128 - testuserpass - testownerpass - - - - - - - - - - ]]> -

- By default FOP produces PDF files of version 1.4, but this can be changed in order to benefit - from features that appeared in newer versions of PDF. At the moment, only a few features from - PDF 1.5 have been implemented, but the configuration element will accept any value between - 1.4 and 1.7. This is the value that will appear in the PDF header, although only features up - to 1.5 will actually be used. - - 1.5 - - ]]> -

- -
-
- Special Settings for the PostScript Renderer -

- Besides the normal font configuration (the same "fonts" element as for the PDF renderer) the PostScript - renderer has an additional setting to force landscape pages to be rotated to fit on a page inserted into - the printer in portrait mode. Set the value to "true" to activate this feature. The default is "false". - Example: -

- - true - - - - - - - - - - - - ]]> -
-
- Special Settings for the PCL Renderer -

- Non-standard fonts for the PCL renderer are made available through the Java2D subsystem which means that - you don't have to do any custom font configuration in this case but you have to use the font names - offered by Java. -

-

- Additionally, there are certain settings that control how the renderer handles various elements. -

- - quality - bitmap -]]> -

- The default value for the "rendering" setting is "speed" which causes borders - to be painted as plain rectangles. In this mode, no special borders (dotted, - dashed etc.) are available. If you want support for all border modes, set the - value to "quality" as indicated above. This will cause the borders to be painted - as bitmaps. -

-

- The default value for the "text-rendering" setting is "auto" which paints the - base fonts using PCL fonts. Non-base fonts are painted as bitmaps through Java2D. - If the mix of painting methods results in unwelcome output, you can set this - to "bitmap" which causes all text to be rendered as bitmaps. -

-
-
- Special Settings for the AFP Renderer -

-

-

- Additionally, there are certain settings that control how the renderer handles various elements. -

- - - 240 - 2.5 - - - resources.afp -]]> -

- The default value for the images "mode" setting is "b+w" (black and white). When the images "mode" setting is "b+w" a "bits-per-pixel" setting can be provided to aid the grayscale conversion process. With this setting all images referenced in your source document are converted to an IOCA FS45 grayscale bitmap image form. - When the setting is "color" all images are converted to an IOCA FS45 color bitmap image form. When "native" setting is "true", all images encountered (TIFF, GIF, JPEG and Encapsulated Postscript etc.) will be embedded directly in the datastream in their native form using a MO:DCA Object Container. -

-

- The default value for the "renderer-resolution" is 240 dpi. -

-

- The default line width is device dependent and may need to be fine tuned so that the output matches the expected result. The default correction value is 2.5. -

- -

- By default if there is no configuration definition for "resource-group-file", external resources will be placed in a file called resources.afp. -

-
-
- -
- When it does not work - -

FOP searches the configuration file for the information it -expects, at the position it expects. When that information is not -present, FOP will not complain, it will just continue. When there is -other information in the file, FOP will not complain, it will just -ignore it. That means that when your configuration information is in -the file but in a different XML element, or in a different XML path, -than FOP expects, it will be silently ignored.

- -

Check the following possibilities:

- -
    -
  • The format of the configuration file has changed -considerably between FOP 0.20.5 and FOP 1.0 and its beta versions. Did -you convert your file to the new format?
    • - -
  • The FOP distribution contains a schema for configuration -files, at src/foschema/fop-configuration.xsd. Did you validate your -configuration file against it? Add the following schema location to -the schema element: - -]]> - - -and run the configuration file through a validating schema -parser. Note that the schema cannot detect all errors, and that it is -stricter about the order of some elements than FOP itself is.
    • - -
  • Run FOP in debug mode (command line option --d). This makes FOP report which configuration -information it finds. Check if FOP finds what you expect.
    • - -
- -
- - diff --git a/src/documentation/content/xdocs/trunk/embedding.xml b/src/documentation/content/xdocs/trunk/embedding.xml deleted file mode 100644 index abdce8843..000000000 --- a/src/documentation/content/xdocs/trunk/embedding.xml +++ /dev/null @@ -1,735 +0,0 @@ - - - - - - -
- Apache™ FOP: Embedding - How to Embed FOP in a Java application - $Revision$ -
- - -
- Overview -

- Review Running Apache™ FOP for important information that applies - to embedded applications as well as command-line use, such as options and performance. -

-

- To embed Apache™ FOP in your application, first create a new - org.apache.fop.apps.FopFactory instance. This object can be used to launch multiple - rendering runs. For each run, create a new org.apache.fop.apps.Fop instance through - one of the factory methods of FopFactory. In the method call you specify which output - format (i.e. MIME type) to use and, if the selected output format requires an - OutputStream, which OutputStream to use for the results of the rendering. You can - customize FOP's behaviour in a rendering run by supplying your own FOUserAgent - instance. The FOUserAgent can, for example, be used to set your own document handler - instance (details below). Because the FOUserAgent holds FOP-run-specific configuration - data, it should only be used for a single run and not over multiple FOP invocations. - Finally, you retrieve a SAX DefaultHandler instance from the Fop object and use that - as the SAXResult of your transformation. -

-
-
- The API -

- FOP has many classes which express the "public" access modifier, however, this is not - indicative of their inclusion into the public API. Every attempt will be made to keep the - public API static, to minimize regressions for existing users, however, since the API is not - clearly defined, the list of classes below are the generally agreed public API: - -

-
-
- Basic Usage Pattern -

- Apache FOP relies heavily on JAXP. It uses SAX events exclusively to receive the XSL-FO - input document. It is therefore a good idea that you know a few things about JAXP (which - is a good skill anyway). Let's look at the basic usage pattern for FOP... -

-

Here is the basic pattern to render an XSL-FO file to PDF: -

- -

- Let's discuss these 5 steps in detail: -

-
    -
  • - Step 1: You create a new FopFactory instance. The FopFactory instance holds - references to configuration information and cached data. It is important to reuse this - instance if you plan to render multiple documents during a JVM's lifetime. URIs used within - FOP runs (images in the FO, fonts in the fop conf etc...) will be resolved against the base - URI given here. -
    • -
  • - Step 2: You set up an OutputStream that the generated document - will be written to. It's a good idea to buffer the OutputStream as demonstrated - to improve performance. -
    • -
  • - Step 3: You create a new Fop instance through one of the factory - methods on the FopFactory. You tell the FopFactory what your desired output format - is. This is done by using the MIME type of the desired output format (ex. "application/pdf"). - You can use one of the MimeConstants.* constants. The second parameter is the - OutputStream you've setup up in step 2. -
    • -
  • - Step 4 We recommend that you use JAXP Transformers even - if you don't do XSLT transformations to generate the XSL-FO file. This way - you can always use the same basic pattern. The example here sets up an - "identity transformer" which just passes the input (Source) unchanged to the - output (Result). You don't have to work with a SAXParser if you don't do any - XSLT transformations. -
    • -
  • - Step 5: Here you set up the input and output for the XSLT - transformation. The Source object is set up to load the "myfile.fo" file. - The Result is set up so the output of the XSLT transformation is sent to FOP. - The FO file is sent to FOP in the form of SAX events which is the most efficient - way. Please always avoid saving intermediate results to a file or a memory buffer - because that affects performance negatively. -
    • -
  • - Step 6: Finally, we start the XSLT transformation by starting - the JAXP Transformer. As soon as the JAXP Transformer starts to send its output - to FOP, FOP itself starts its processing in the background. When the - transform() method returns FOP will also have finished converting - the FO file to a PDF file and you can close the OutputStream. - - It's a good idea to enclose the whole conversion in a try..finally statement. If - you close the OutputStream in the finally section, this will make sure that the - OutputStream is properly closed even if an exception occurs during the conversion. - -
    • -
-

- If you're not totally familiar with JAXP Transformers, please have a look at the - Embedding examples below. The section contains examples - for all sorts of use cases. If you look at all of them in turn you should be able - to see the patterns in use and the flexibility this approach offers without adding - too much complexity. -

-

- This may look complicated at first, but it's really just the combination of an - XSL transformation and a FOP run. It's also easy to comment out the FOP part - for debugging purposes, for example when you're tracking down a bug in your - stylesheet. You can easily write the XSL-FO output from the XSL transformation - to a file to check if that part generates the expected output. An example for that - can be found in the Embedding examples (See "ExampleXML2FO"). -

-
- Logging -

- Logging is now a little different than it was in FOP 0.20.5. We've switched from - Avalon Logging to Jakarta Commons Logging. - While with Avalon Logging the loggers were directly given to FOP, FOP now retrieves - its logger(s) through a statically available LogFactory. This is similar to the - general pattern that you use when you work with Apache Log4J directly, for example. - We call this "static logging" (Commons Logging, Log4J) as opposed to "instance logging" - (Avalon Logging). This has a consequence: You can't give FOP a logger for each - processing run anymore. The log output of multiple, simultaneously running FOP instances - is sent to the same logger. -

-

- By default, Jakarta Commons Logging uses - JDK logging (available in JDKs 1.4 or higher) as its backend. You can configure Commons - Logging to use an alternative backend, for example Log4J. Please consult the - documentation for Jakarta Commons Logging on - how to configure alternative backends. -

-

- As a result of the above we differentiate between two kinds of "logging": -

- -

- The use of "feedback" instead of "logging" is intentional. Most people were using - log output as a means to get feedback from events within FOP. Therefore, FOP now - includes an event package which can be used to receive feedback from - the layout engine and other components within FOP per rendering run. - This feedback is not just some - text but event objects with parameters so these events can be interpreted by code. - Of course, there is a facility to turn these events into normal human-readable - messages. For details, please read on on the Events page. - This leaves normal logging to be mostly a thing used by the FOP developers - although anyone can surely activate certain logging categories but the feedback - from the loggers won't be separated by processing runs. If this is required, - the Events subsystem is the right approach. -

-
- -
- Processing XSL-FO -

- Once the Fop instance is set up, call getDefaultHandler() to obtain a SAX - DefaultHandler instance to which you can send the SAX events making up the XSL-FO - document you'd like to render. FOP processing starts as soon as the DefaultHandler's - startDocument() method is called. Processing stops again when the - DefaultHandler's endDocument() method is called. Please refer to the basic - usage pattern shown above to render a simple XSL-FO document. -

-
- -
- Processing XSL-FO generated from XML+XSLT -

- If you want to process XSL-FO generated from XML using XSLT we recommend - again using standard JAXP to do the XSLT part and piping the generated SAX - events directly through to FOP. The only thing you'd change to do that - on the basic usage pattern above is to set up the Transformer differently: -

- -
-
-
- Input Sources -

- The input XSL-FO document is always received by FOP as a SAX stream (see the - Parsing Design Document for the rationale). -

-

- However, you may not always have your input document available as a SAX stream. - But with JAXP it's easy to convert different input sources to a SAX stream so you - can pipe it into FOP. That sounds more difficult than it is. You simply have - to set up the right Source instance as input for the JAXP transformation. - A few examples: -

-
    -
  • - URL: Source src = new StreamSource("http://localhost:8080/testfile.xml"); -
    • -
  • - File: Source src = new StreamSource(new File("C:/Temp/myinputfile.xml")); -
    • -
  • - String: Source src = new StreamSource(new StringReader(myString)); // myString is a String -
    • -
  • - InputStream: Source src = new StreamSource(new MyInputStream(something)); -
    • -
  • - Byte Array: Source src = new StreamSource(new ByteArrayInputStream(myBuffer)); // myBuffer is a byte[] here -
    • -
  • - DOM: Source src = new DOMSource(myDocument); // myDocument is a Document or a Node -
    • -
  • - Java Objects: Please have a look at the Embedding examples which contain an example for this. -
    • -
-

- There are a variety of upstream data manipulations possible. - For example, you may have a DOM and an XSL stylesheet; or you may want to - set variables in the stylesheet. Interface documentation and some cookbook - solutions to these situations are provided in - Xalan Basic Usage Patterns. -

-
-
- Configuring Apache FOP Programmatically -

- Apache FOP provides two levels on which you can customize FOP's - behaviour: the FopFactoryBuilder and the user agent. -

-
- Customizing the FopFactory -

- The FopFactory holds configuration data and references to objects which are reusable over - multiple rendering runs. The FopFactoryBuilder allows users to set configuration and then - build the FopFactory so that the FopFactory doesn't change between runs. The FopFactory performs - some performance expensive operations (i.e. detecting system fonts), as such it only needs to be - built once and cane be reused every time to create new FOUserAgent and Fop instances. -

-

- The FopFactoryBuilder can be instantiated with three objects; the base URI, the ResourceResolver - and the EnvironmentProfile. The base URI and the ResourceResolver are used for resolving resource - URIs throughout the FOP invocation. The EnvironmentProfile will be discussed further below but, in - short, it gives users more control over FOPs system dependent services. -

-

- You can set all sorts of things on the FopFactoryBuilder: -

-
    -
  • -

    - Disable strict validation. When disabled FOP is less strict about the rules - established by the XSL-FO specification. Example: -

    - fopFactoryBuilder.setStrictFOValidation(false); -
    • -
  • -

    - Enable an alternative set of rules for text indents that tries to mimic the behaviour of many commercial - FO implementations, that chose to break the specification in this respect. The default of this option is - 'false', which causes Apache FOP to behave exactly as described in the specification. To enable the - alternative behaviour, call: -

    - fopFactoryBuilder.setBreakIndentInheritanceOnReferenceAreaBoundary(true); -
    • -
  • -

    - Set the source resolution for the document. This is used internally to determine the pixel - size for SVG images and bitmap images without resolution information. Default: 72 dpi. Example: -

    - fopFactoryBuilder.setSourceResolution(96); // =96dpi (dots/pixels per Inch) -
    • -
  • -

    - Manually add an ElementMapping instance. If you want to supply a special FOP extension - you can give the instance to the FOUserAgent. Normally, the FOP extensions can be automatically detected - (see the documentation on extension for more info). Example: -

    - fopFactoryBuilder.addElementMapping(myElementMapping); // myElementMapping is a org.apache.fop.fo.ElementMapping -
    • -
-

- Once the settings on the FopFactoryBuilder had been set, you can create a FopFactory by invoking the build method: -

- FopFactory factory = fopFactoryBuilder.build(); -
-
- Environment Profile -

- The EnvironmentProfile can be used to define the limitations and restrictions of FOPs access to system resources. FOP, for example, - can auto-detect system fonts which users may want control over. This environment profile also holds the base URI and the - ResourceResolver discussed previously, since they are intrinsically bound to the environment inwhich FOP is invoked. -

-
-
- Customizing the User Agent -

- The user agent is the entity that allows you to interact with a single rendering run, i.e. the processing of a single - document. If you wish to customize the user agent's behaviour, the first step is to create your own instance - of FOUserAgent using the appropriate factory method on FopFactory and pass that - to the factory method that will create a new Fop instance: -

- -

- You can do all sorts of things on the user agent: -

-
    -
  • -

    - Set the producer of the document. This is metadata information that can be used for certain output formats such as PDF. The default producer is "Apache FOP". Example: -

    - userAgent.setProducer("MyKillerApplication"); -
    • -
  • -

    - Set the creating user of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setCreator("John Doe"); -
    • -
  • -

    - Set the author of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setAuthor("John Doe"); -
    • -
  • -

    - Override the creation date and time of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setCreationDate(new Date()); -
    • -
  • -

    - Set the title of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setTitle("Invoice No 138716847"); -
    • -
  • -

    - Set the keywords of the document. This is metadata information that can be used for certain output formats such as PDF. Example: -

    - userAgent.setKeywords("XML XSL-FO"); -
    • -
  • -

    - Set the target resolution for the document. This is used to - specify the output resolution for bitmap images generated by bitmap renderers - (such as the TIFF renderer) and by bitmaps generated by Apache Batik for filter - effects and such. Default: 72 dpi. Example: -

    - userAgent.setTargetResolution(300); // =300dpi (dots/pixels per Inch) -
    • -
  • -

    - Set your own Document Handler. This feature can be used for several purposes, the most likey usage of which would probably be - binding a MIME type when the output is Intermediate Format (see Document Handlers). This also allows advanced - users to create their own implementation of the document handler. -

    - userAgent.setDocumentHandlerOverride(documentHandler) // documentHandler is an instance of org.apache.fop.render.intermediate.IFDocumentHandler -
    • -
  • -

    - Set your own FOEventHandler instance. If you want to supply your own FOEventHandler or - configure an FOEventHandler subclass in a special way you can give the instance to the FOUserAgent. Normally, - the FOEventHandler instance is created by FOP. Example: -

    - userAgent.setFOEventHandlerOverride(myFOEventHandler); // myFOEventHandler is an org.apache.fop.fo.FOEventHandler -
    • -
- - You should not reuse an FOUserAgent instance between FOP rendering runs although you can. Especially - in multi-threaded environment, this is a bad idea. - -
-
-
- Using a Configuration File -

- Instead of setting the parameters manually in code as shown above you can also set - many values from an XML configuration file: -

- -

- If however, you wish to override some of the configuration settings within the fop conf programmatically - then you can do so by using the FopConfParser. This allows the FopFactory to remain immutable and consistent - across multiple threads/invocations while still keeping the API flexible for the user. -

- -

- The layout of the configuration file is described on the Configuration page. -

-
-
- Document Handlers -

- The document handlers are classes that inherit from org.apache.fop.render.intermediate.IFDocumentHandler. This - is an interface for which a MIME type specific implementation can be created. This same handler is used either when XSL-FO - is used as the input or when Intermediate Format is used. Since IF is output format agnostic, if custom fonts or other - configuration information that affect layout (specific to a particular MIME type) are given then FOP needs that contextual - information. The document handler provides that context so that when the IF is rendered, it is more visually consistent with - FO rendering. The code below shows an example of how a document handler can be used to provide PDF configuration data to the - IFSerializer. - - The rest of the code is the same as in Basic Usage Patterns. -

-
-
- Hints -
- Object reuse -

- Fop instances shouldn't (and can't) be reused. Please recreate - Fop and FOUserAgent instances for each rendering run using the FopFactory. - This is a cheap operation as all reusable information is held in the - FopFactory. That's why it's so important to reuse the FopFactory instance. -

-
-
- AWT issues -

- If your XSL-FO files contain SVG then Apache Batik will be used. When Batik is - initialised it uses certain classes in java.awt that - intialise the Java AWT classes. This means that a daemon thread - is created by the JVM and on Unix it will need to connect to a - DISPLAY. -

-

- The thread means that the Java application may not automatically quit - when finished, you will need to call System.exit(). These - issues should be fixed in the JDK 1.4. -

-

- If you run into trouble running FOP on a head-less server, please see the - notes on Batik. -

-
-
- Getting information on the rendering process -

- To get the number of pages that were rendered by FOP you can call - Fop.getResults(). This returns a FormattingResults object - where you can look up the number of pages produced. It also gives you the - page-sequences that were produced along with their id attribute and their - numbers of pages. This is particularly useful if you render multiple - documents (each enclosed by a page-sequence) and have to know the number of - pages of each document. -

-
-
-
- Improving performance -

- There are several options to consider: -

-
    -
  • - Whenever possible, try to use SAX to couple the individual components involved - (parser, XSL transformer, SQL datasource etc.). -
    • -
  • - Depending on the target OutputStream (in case of a FileOutputStream, but not - for a ByteArrayOutputStream, for example) it may improve performance considerably - if you buffer the OutputStream using a BufferedOutputStream: - out = new java.io.BufferedOutputStream(out); -
    - Make sure you properly close the OutputStream when FOP is finished. -
    • -
  • - Cache the stylesheet. If you use the same stylesheet multiple times - you can set up a JAXP Templates object and reuse it each time you do - the XSL transformation. (More information can be found - here.) -
    • -
  • - Use an XSLT compiler like XSLTC - that comes with Xalan-J. -
    • -
  • - Fine-tune your stylesheet to make the XSLT process more efficient and to create XSL-FO that can - be processed by FOP more efficiently. Less is more: Try to make use of property inheritance where possible. -
    • -
  • - You may also wish to consider trying to reduce memory usage. -
    • -
-
-
- Multithreading FOP -

- Apache FOP may currently not be completely thread safe. - The code has not been fully tested for multi-threading issues, yet. - If you encounter any suspicious behaviour, please notify us. -

-

- There is also a known issue with fonts being jumbled between threads when using - the Java2D/AWT renderer (which is used by the -awt and -print output options). - In general, you cannot safely run multiple threads through the AWT renderer. -

-
-
- Examples -

- The directory "{fop-dir}/examples/embedding" contains several working examples. -

-
- ExampleFO2PDF.java -

This - - example -demonstrates the basic usage pattern to transform an XSL-FO -file to PDF using FOP. -

-
-
-
- ExampleXML2FO.java -

This - - example -has nothing to do with FOP. It is there to show you how an XML -file can be converted to XSL-FO using XSLT. The JAXP API is used to do the -transformation. Make sure you've got a JAXP-compliant XSLT processor in your -classpath (ex. Xalan). -

-
-
-
- ExampleXML2PDF.java -

This - - example -demonstrates how you can convert an arbitrary XML file to PDF -using XSLT and XSL-FO/FOP. It is a combination of the first two examples -above. The example uses JAXP to transform the XML file to XSL-FO and FOP to -transform the XSL-FO to PDF. -

-
-

-The output (XSL-FO) from the XSL transformation is piped through to FOP using -SAX events. This is the most efficient way to do this because the -intermediate result doesn't have to be saved somewhere. Often, novice users -save the intermediate result in a file, a byte array or a DOM tree. We -strongly discourage you to do this if it isn't absolutely necessary. The -performance is significantly higher with SAX. -

-
-
- ExampleObj2XML.java -

This - - example -is a preparatory example for the next one. It's an example that -shows how an arbitrary Java object can be converted to XML. It's an often -needed task to do this. Often people create a DOM tree from a Java object and -use that. This is pretty straightforward. The example here, however, shows how -to do this using SAX, which will probably be faster and not even more -complicated once you know how this works. -

-
-

-For this example we've created two classes: ProjectTeam and ProjectMember -(found in xml-fop/examples/embedding/java/embedding/model). They represent -the same data structure found in -xml-fop/examples/embedding/xml/xml/projectteam.xml. We want to serialize to XML a -project team with several members which exist as Java objects. -Therefore we created the two classes: ProjectTeamInputSource and -ProjectTeamXMLReader (in the same place as ProjectTeam above). -

-

-The XMLReader implementation (regard it as a special kind of XML parser) is -responsible for creating SAX events from the Java object. The InputSource -class is only used to hold the ProjectTeam object to be used. -

-

-Have a look at the source of ExampleObj2XML.java to find out how this is -used. For more detailed information see other resources on JAXP (ex. -An older JAXP tutorial). -

-
-
- ExampleObj2PDF.java -

This - - example -combines the previous and the third to demonstrate -how you can transform a Java object to a PDF directly in one smooth run -by generating SAX events from the Java object that get fed to an XSL -transformation. The result of the transformation is then converted to PDF -using FOP as before. -

-
-
-
- ExampleDOM2PDF.java -

This - - example -has FOP use a DOMSource instead of a StreamSource in order to -use a DOM tree as input for an XSL transformation. -

-
-
- ExampleSVG2PDF.java (PDF Transcoder example) -

This - - example -shows the usage of the PDF Transcoder, a sub-application within FOP. -It is used to generate a PDF document from an SVG file. -

-
-
- ExampleConcat.java (IF Concatenation example) -

-This can be found in the embedding.intermediate package within the -examples and describes how IF can be concatenated to produce a document. Because -IF has been through FOPs layout engine, it should be visually consistent with FO -rendered documents while allowing the user to merge numerous documents together. -

-
-
- Final notes -

-These examples should give you an idea of what's possible. It should be easy -to adjust these examples to your needs. Also, if you have other examples that you -think should be added here, please let us know via either the fop-users or fop-dev -mailing lists. Finally, for more help please send your questions to the fop-users -mailing list. -

-
-
- - diff --git a/src/documentation/content/xdocs/trunk/events.xml b/src/documentation/content/xdocs/trunk/events.xml deleted file mode 100644 index 27daad59b..000000000 --- a/src/documentation/content/xdocs/trunk/events.xml +++ /dev/null @@ -1,449 +0,0 @@ - - - - - -
- Apache™ FOP: Events/Processing Feedback - $Revision$ -
- -
- Introduction -

- In versions until 0.20.5, Apache™ FOP used - Avalon-style Logging where - it was possible to supply a logger per processing run. During the redesign - the logging infrastructure was switched over to - Commons Logging which is (like Log4J or - java.util.logging) a "static" logging framework (the logger is accessed through static - variables). This made it very difficult in a multi-threaded system to retrieve information - for a single processing run. -

-

- With FOP's event subsystem, we'd like to close this gap again and even go further. The - first point is to realize that we have two kinds of "logging". Firstly, we have the logging - infrastructure for the (FOP) developer who needs to be able to enable finer log messages - for certain parts of FOP to track down a certain problem. Secondly, we have the user who - would like to be informed about missing images, overflowing lines or substituted fonts. - These messages (or events) are targeted at less technical people and may ideally be - localized (translated). Furthermore, tool and solution builders would like to integrate - FOP into their own solutions. For example, an FO editor should be able to point the user - to the right place where a particular problem occurred while developing a document template. - Finally, some integrators would like to abort processing if a resource (an image or a font) - has not been found, while others would simply continue. The event system allows to - react on these events. -

-

- On this page, we won't discuss logging as such. We will show how the event subsystem can - be used for various tasks. We'll first look at the event subsystem from the consumer side. - Finally, the production of events inside FOP will be discussed (this is mostly interesting - for FOP developers only). -

-
-
- The consumer side -

- The event subsystem is located in the org.apache.fop.events package and its - base is the Event class. An instance is created for each event and is sent - to a set of EventListener instances by the EventBroadcaster. - An Event contains: -

-
    -
  • an event ID,
    • -
  • a source object (which generated the event),
    • -
  • a severity level (Info, Warning, Error and Fatal Error) and
    • -
  • a map of named parameters.
    • -
-

- The EventFormatter class can be used to translate the events into - human-readable, localized messages. -

-

- A full example of what is shown here can be found in the - examples/embedding/java/embedding/events directory in the FOP distribution. - The example can also be accessed - via the web. -

-
- Writing an EventListener -

- The following code sample shows a very simple EventListener. It basically just sends - all events to System.out (stdout) or System.err (stderr) depending on the event severity. -

- -

- You can see that for every event the method processEvent of the - EventListener will be called. Inside this method you can do whatever - processing you would like including throwing a RuntimeException, if you want - to abort the current processing run. -

-

- The code above also shows how you can turn an event into a human-readable, localized - message that can be presented to a user. The EventFormatter class does - this for you. It provides additional methods if you'd like to explicitly specify - the locale. -

-

- It is possible to gather all events for a whole processing run so they can be - evaluated afterwards. However, care should be taken about memory consumption since - the events provide references to objects inside FOP which may themselves have - references to other objects. So holding on to these objects may mean that whole - object trees cannot be released! -

-
-
- Adding an EventListener -

- To register the event listener with FOP, get the EventBroadcaster which - is associated with the user agent (FOUserAgent) and add it there: -

- -

- Please note that this is done separately for each processing run, i.e. for each - new user agent. -

-
-
- An additional listener example -

- Here's an additional example of an event listener: -

-

- By default, FOP continues processing even if an image wasn't found. If you have - more strict requirements and want FOP to stop if an image is not available, you can - do something like the following in the simplest case: -

- -

- Increasing the event severity to FATAL will signal the event broadcaster to throw - an exception and stop further processing. In the above case, all resource-related - events will cause FOP to stop processing. -

-

- You can also customize the exception to throw (you can may throw a RuntimeException - or subclass yourself) and/or which event to respond to: -

- -

- This throws a RuntimeException with the FileNotFoundException - as the cause. Further processing effectively stops in FOP. You can catch the exception - in your code and react as you see necessary. -

-
-
-
- The producer side (for FOP developers) -

- This section is primarily for FOP and FOP plug-in developers. It describes how to use - the event subsystem for producing events. -

- - The event package has been designed in order to be theoretically useful for use cases - outside FOP. If you think this is interesting independently from FOP, please talk to - us. - -
- Producing and sending an event -

- The basics are very simple. Just instantiate an Event object and fill - it with the necessary parameters. Then pass it to the EventBroadcaster - which distributes the events to the interested listeneners. Here's a code example: -

- -

- The Event.paramsBuilder() is a - fluent interface - to help with the build-up of the parameters. You could just as well instantiate a - Map (Map<String, Object>) and fill it with values. -

-
-
- The EventProducer interface -

- To simplify event production, the event subsystem provides the EventProducer - interface. You can create interfaces which extend EventProducer. These - interfaces will contain one method per event to be generated. By contract, each event - method must have as its first parameter a parameter named "source" (Type Object) which - indicates the object that generated the event. After that come an arbitrary number of - parameters of any type as needed by the event. -

-

- The event producer interface does not need to have any implementation. The implementation - is produced at runtime by a dynamic proxy created by DefaultEventBroadcaster. - The dynamic proxy creates Event instances for each method call against - the event producer interface. Each parameter (except "source") is added to the event's - parameter map. -

-

- To simplify the code needed to get an instance of the event producer interface it is - suggested to create a public inner provider class inside the interface. -

-

- Here's an example of such an event producer interface: -

- -

- To produce the same event as in the first example above, you'd use the following code: -

- -
-
- The event model -

- Inside an invocation handler for a dynamic proxy, there's no information about - the names of each parameter. The JVM doesn't provide it. The only thing you know is - the interface and method name. In order to properly fill the Event's - parameter map we need to know the parameter names. These are retrieved from an - event object model. This is found in the org.apache.fop.events.model - package. The data for the object model is retrieved from an XML representation of the - event model that is loaded as a resource. The XML representation is generated using an - Ant task at build time (ant resourcegen). The Ant task (found in - src/codegen/java/org/apache/fop/tools/EventProducerCollectorTask.java) - scans FOP's sources for descendants of the EventProducer interface and - uses QDox to parse these interfaces. -

-

- The event model XML files are generated during build by the Ant task mentioned above when - running the "resourcegen" task. So just run "ant resourcegen" if you receive - a MissingResourceException at runtime indicating that - "event-model.xml" is missing. -

-

- Primarily, the QDox-based collector task records the parameters' names and types. - Furthermore, it extracts additional attributes embedded as Javadoc comments from - the methods. At the moment, the only such attribute is "@event.severity" which indicates - the default event severity (which can be changed by event listeners). The example event - producer above shows the Javadocs for an event method. -

-

- There's one more information that is extracted from the event producer information for - the event model: an optional primary exception. The first exception in the "throws" - declaration of an event method is noted. It is used to throw an exception from - the invocation handler if the event has an event severity of "FATAL" when all - listeners have been called (listeners can update the event severity). Please note - that an implementation of - org.apache.fop.events.EventExceptionManager$ExceptionFactory has to be - registered for the EventExceptionManager to be able to construct the - exception from an event. -

-

- For a given application, there can be multiple event models active at the same time. - In FOP, each renderer is considered to be a plug-in and provides its own specific - event model. The individual event models are provided through an - EventModelFactory. This interface is implemented for each event model - and registered through the service provider mechanism - (see the plug-ins section for details). -

-
-
- Event severity -

- Four different levels of severity for events has been defined: -

-
    -
  1. INFO: informational only
    2. -
  2. WARN: a Warning
    3. -
  3. ERROR: an error condition from which FOP can recover. FOP will continue processing.
    4. -
  4. FATAL: a fatal error which causes an exception in the end and FOP will stop processing.
    5. -
-

- Event listeners can choose to ignore certain events based on their event severity. - Please note that you may recieve an event "twice" in a specific case: if there is - a fatal error an event is generated and sent to the listeners. After that an exception - is thrown with the same information and processing stops. If the fatal event is - shown to the user and the following exception is equally presented to the user it - may appear that the event is duplicated. Of course, the same information is just - published through two different channels. -

-
-
- Plug-ins to the event subsystem -

- The event subsystem is extensible. There are a number of extension points: -

-
    -
  • - org.apache.fop.events.model.EventModelFactory: Provides - an event model to the event subsystem. -
    • -
  • - org.apache.fop.events.EventExceptionManager$ExceptionFactory: - Creates exceptions for events, i.e. turns an event into a specific exception. -
    • -
-

- The names in bold above are used as filenames for the service provider files that - are placed in the META-INF/services directory. That way, they are - automatically detected. This is a mechanism defined by the - JAR file specification. -

-
-
- Localization (L10n) -

- One goal of the event subsystem was to have localized (translated) event messages. - The EventFormatter class can be used to convert an event to a - human-readable message. Each EventProducer can provide its own XML-based - translation file. If there is none, a central translation file is used, called - "EventFormatter.xml" (found in the same directory as the EventFormatter - class). -

-

- The XML format used by the EventFormatter is the same as - Apache Cocoon's catalog format. Here's an example: -

- - - - [ (See position {loc})| (See {#gatherContextInfo})| (No context info available)] - - - RTF output requires that all table-columns for a table are defined. Output will be incorrect.{{locator}} - - - Ignored deferred event for {node} ({start,if,start,end}).{{locator}} - - -]]> -

- The example (extracted from the RTF handler's event producer) has message templates for - two event methods. The class used to do variable replacement in the templates is - org.apache.fop.util.text.AdvancedMessageFormat which is more powerful - than the MessageFormat classes provided by the Java class library - (java.util.text package). -

-

- "locator" is a template that is reused by the other message templates - by referencing it through "{{locator}}". This is some kind of include command. -

-

- Normal event parameters are accessed by name inside single curly braces, for example: - "{node}". For objects, this format just uses the toString() method to turn - the object into a string, unless there is an ObjectFormatter registered - for that type (there's an example for org.xml.sax.Locator). -

-

- The single curly braces pattern supports additional features. For example, it is possible - to do this: "{start,if,start,end}". "if" here is a special field modifier that evaluates - "start" as a boolean and if that is true returns the text right after the second comma - ("start"). Otherwise it returns the text after the third comma ("end"). The "equals" - modifier is similar to "if" but it takes as an additional (comma-separated) parameter - right after the "equals" modifier, a string that is compared to the value of the variable. - An example: {severity,equals,EventSeverity:FATAL,,some text} (this adds "some text" if - the severity is not FATAL). -

-

- Additional such modifiers can be added by implementing the - AdvancedMessageFormat$Part and AdvancedMessageFormat$PartFactory - interfaces. -

-

- Square braces can be used to specify optional template sections. The whole section will - be omitted if any of the variables used within are unavailable. Pipe (|) characters can - be used to specify alternative sub-templates (see "locator" above for an example). -

-

- Developers can also register a function (in the above example: - {#gatherContextInfo}) - to do more complex information rendering. These functions are implementations of the - AdvancedMessageFormat$Function interface. Please take care that this is - done in a locale-independent way as there is no locale information available, yet. -

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/trunk/extensions.xml b/src/documentation/content/xdocs/trunk/extensions.xml deleted file mode 100644 index 02d83db96..000000000 --- a/src/documentation/content/xdocs/trunk/extensions.xml +++ /dev/null @@ -1,339 +0,0 @@ - - - - - -
- Standard Apache™ FOP Extensions - $Revision$ -
- -

- By "extension", we mean any data that can be placed in the input XML document that - is not addressed by the XSL-FO standard. - By having a mechanism for supporting extensions, Apache™ FOP is able to add features that - are not covered in the specification. -

-

- The extensions documented here are included with FOP, and are automatically available - to you. If you wish to add an extension of your own to FOP, please see the - Developers' Extension Page. -

- All extensions require the correct use of an appropriate namespace in your input document. -
- SVG -

- Please see the SVG documentation for more details. -

-
-
- FO Extensions -
- Namespace -

- By convention, FO extensions in FOP use the "fox" namespace prefix. - To use any of the FO extensions, add a namespace entry for - http://xmlgraphics.apache.org/fop/extensions to the root element: -

- ]]> -
-
- PDF Bookmarks -

- In old versions of Apache FOP there was a fox:outline element - which was used to create outlines in PDF files. The redesigned code makes use - of the bookmark feature defined in the W3C XSL 1.1 standard. -

-
-
- Anchors or Named Destinations -

Use the fox:destination element to define "named destinations" inside a PDF document. -These are useful as fragment identifiers, e.g. "http://server/document.pdf#anchor-name". -fox:destination elements can be placed almost anywhere in the fo document, including a child of -root, a block-level element, or an inline-level element. -For the destination to actually work, it must correspond to an "id" attribute on some fo element -within the document. In other words, the "id" attribute actually creates the "view" within the -PDF document. The fox:destination simply gives that view an independent name. -

- -... -Table of Contents]]> - It is possible that in some future release of FOP, all elements with -"id" attributes will generate named-destinations, which will eliminate the need for -fox:destination. -
-
- Table Continuation Label -

This extension element hasn't been reimplemented for the redesigned code, yet.

- -
-
- fox:orphan-content-limit and fox:widow-content-limit -

- The two proprietary extension properties, fox:orphan-content-limit and - fox:widow-content-limit, are used to improve the layout of list-blocks and tables. - If you have a table with many entries, you don't want a single row to be left over - on a page. You will want to make sure that at least two or three lines are kept - together. The properties take an absolute length which specifies the area at the - beginning (fox:widow-content-limit) or at the end (fox:orphan-content-limit) of a - table or list-block. The properties are inherited and only have an effect on fo:table - and fo:list-block. An example: fox:widow-content-limit="3 * 1.2em" would make sure - the you'll have at least three lines (assuming line-height="1.2") together on a table - or list-block. -

-
-
- fox:external-document - - This feature is incomplete. Support for multi-page documents will be added shortly. - At the moment, only single-page images will work. And this will not work with RTF output. - -

- This is a proprietary extension element which allows to add whole images as pages to - an FO document. For example, if you have a scanned document or a fax as multi-page TIFF - file, you can append or insert this document using the fox:external-document - element. Each page of the external document will create one full page in the target - format. -

-

- The fox:external-document element is structurally a peer to - fo:page-sequence, so wherever you can put an fo:page-sequence - you could also place a fox:external-document. - Therefore, the specified contents for fo:root change to: -

-

- - (layout-master-set, declarations?, bookmark-tree?, (page-sequence|page-sequence-wrapper|fox:external-document|fox:destination)+) - -

-
- Specification -

- The fox:external-document extension formatting object is used to specify - how to create a (sub-)sequence of pages within a document. The content of these pages - comes from the individual subimages/pages of an image or paged document (for example: - multi-page TIFF in the form of faxes or scanned documents, or PDF files). The - formatting object creates the necessary areas to display one image per page. -

-

- In terms of page numbers, the behaviour is the same as for - fo:page-sequence. The placement of the image inside the page is similar - to that of fo:external-graphic or fo:instream-foreign-object, - i.e. the viewport (and therefore the page size) is defined by either the intrinsic - size of the image or by the size properties that apply to this formatting object. -

-

Content: EMPTY

-

The following properties apply to this formatting object:

-
    -
  • (Common Accessibility Properties) (not implemented, yet)
    • -
  • (Common Aural Properties) (not implemented, yet)
    • -
  • block-progression-dimension
    • -
  • content-height
    • -
  • content-type
    • -
  • content-width
    • -
  • display-align
    • -
  • height
    • -
  • id
    • -
  • inline-progression-dimension
    • -
  • overflow
    • -
  • pages: <page-set> (see below) (not implemented, yet)
    • -
  • reference-orientation
    • -
  • scaling
    • -
  • scaling-method
    • -
  • src
    • -
  • text-align
    • -
  • width
    • -
-

- Datatype "page-set": Value: auto | <integer-range>, - Default: "auto" which means all pages/subimages of the document. - <integer-range> allows values such as "7" or "1-3" -

- - fox:external-document is not suitable for concatenating FO documents. - For this, XInclude is recommended. - -
-
-
- Free-form Transformation for fo:block-container -

- For fo:block-container elements whose absolute-position set to - "absolute" or "fixed" you can use the extension attribute fox:transform - to apply a free-form transformation to the whole block-container. The content of the - fox:transform attribute is the same as for - SVG's transform attribute. - The transformation specified here is performed in addition to other implicit - transformations of the block-container (resulting from top, left and other properties) - and after them. -

-

- Examples: fox:transform="rotate(45)" would rotate the block-container - by 45 degrees clock-wise around its upper-left corner. - fox:transform="translate(10000,0)" would move the block-container to the - right by 10 points (=10000 millipoints, FOP uses millipoints internally!). -

- - This extension attribute doesn't work for all output formats! It's currently only - supported for PDF, PS and Java2D-based renderers. - -
-
- Color functions -

- XSL-FO supports specifying color using the rgb(), rgb-icc() and system-color() functions. - Apache FOP provides additional color functions for special use cases. Please note that - using these functions compromises the interoperability of an FO document. -

-
- cmyk() -

color cmyk(numeric, numeric, numeric, numeric)

-

- This function will construct a color in device-specific CMYK color space. The numbers - must be between 0.0 and 1.0. For output formats that don't support device-specific - color space the CMYK value is converted to an sRGB value. -

-
-
- #CMYK pseudo-profile -

color rgb-icc(numeric, numeric, numeric, #CMYK, numeric, numeric, numeric, numeric)

-

- The rgb-icc function will respond to a pseudo-profile called "#CMYK" - which indicates a device-specific CMYK color space. The "#CMYK" profile is implicitely - available and doesn't have to be (and cannot be) defined through an - fo:color-profile element. It is provided for compatibility with certain - commercial XSL-FO implementations. Please note that this is not part of the official - specification but rather a convention. The following two color specifications are - equivalent: -

-
    -
  • cmyk(0%,0%,20%,40%)
    • -
  • rgb-icc(153, 153, 102, #CMYK, 0, 0, 0.2, 0.4)
    • -
-
-
-
- Prepress Support - -

- This section defines a number of extensions related to - prepress support. - fox:scale defines a general scale factor for the generated pages. - fox:bleed defines the - bleed area for a page. - fox:crop-offset defines the outer edges of the area in which crop marks, - registration marks, color bars and page information are placed. - For details, please read on below. -

- - Those extensions have been implemented in the PDF and Java2D renderers only. - - -
- fox:scale -

Value: <number>{1,2}

-

Initial: 1

-

Applies to: fo:simple-page-master

-

- This property specifies a scale factor along resp. the x and y axes. If only one number - is provided it is used for both the x and y scales. A scale factor smaller than 1 - shrinks the page. A scale factor greater than 1 enlarges the page. -

-
-
- fox:bleed -

- Value: <length>{1,4} -

-

- Initial: 0pt -

-

Applies to: fo:simple-page-master

-

- If there is only one value, it applies to all sides. If there are two values, the top and bottom - bleed widths are set to the first value and the right and left bleed widths are set to the second. - If there are three values, the top is set to the first value, the left and right are set to the second, - and the bottom is set to the third. If there are four values, they apply to the top, right, bottom, and - left, respectively. - (Corresponds to the definition of - padding). -

-

- This extension indirectly defines the BleedBox and is calculated by expanding the TrimBox by - the bleed widths. The lengths must be non-negative. -

-
-
- fox:crop-offset -

- Value: <length>{1,4} -

-

- Initial: bleed (see below) -

-

Applies to: fo:simple-page-master

-

- Same behaviour as with fox:bleed. The initial value is set to the same values as the - fox:bleed property. -

-

- This extension indirectly defines the MediaBox and is calculated by expanding - the TrimBox by the crop offsets. The lengths must be non-negative. -

-
-
- fox:crop-box -

- Value: [trim-box | bleed-box | media-box] -

-

- Initial: media-box -

-

Applies to: fo:simple-page-master

-

- The crop box controls how Acrobat displays the page (CropBox in PDF) or how the Java2DRenderer sizes - the output media. The PDF specification defines that the CropBox defaults to the MediaBox. This extension - follows that definition. To simplify usage and cover most use cases, the three supported enumeration - values "trim-box", "bleed-box" and "media-box" set the CropBox to one of those three other boxes. -

-

- If requested in the future, we could offer to specify the CropBox in absolute coordinates rather - than just by referencing another box. -

-
-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/trunk/fonts.xml b/src/documentation/content/xdocs/trunk/fonts.xml deleted file mode 100644 index ba607e40b..000000000 --- a/src/documentation/content/xdocs/trunk/fonts.xml +++ /dev/null @@ -1,579 +0,0 @@ - - - - - -
- Apache™ FOP: Fonts - $Revision$ - - - - - - -
- -
- Summary -

The following table summarizes the font capabilities of the various Apache� FOP renderers:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
RendererBase-14AWT/OSCustomCustom Embedding
PDFyesnoyesyes
PostScriptyesnoyesyes
PCLyes (modified)yes (painted as bitmaps)yes (painted as bitmaps)no
AFPnonoyesyes
Java2D/AWT/Bitmapif available from OSyesyesn/a (display only)
Printif available from OSyesyescontrolled by OS printer driver
RTFn/a (font metrics not needed)n/an/an/a
TXTyes (used for layout but not for output)noyes (used for layout but not for output)no
XMLyesnoyesn/a
-
-
- Base-14 Fonts -

- The Adobe PostScript and PDF Specification specify a set of 14 fonts that must be - available to every PostScript interpreter and PDF reader: - Helvetica (normal, bold, italic, bold italic), - Times (normal, bold, italic, bold italic), - Courier (normal, bold, italic, bold italic), - Symbol and ZapfDingbats. -

-

- The following font family names are hard-coded into FOP for the Base-14 font set: -

- - - - - - - - - - - - - - - - - - - - - - - - - -
Base-14 fontfont families
HelveticaHelvetica, sans-serif, SansSerif
TimesTimes, Times Roman, Times-Roman, serif, any
CourierCourier, monospace, Monospaced
SymbolSymbol
ZapfDingbatsZapfDingbats
-

- Please note that recent versions of Adobe Acrobat Reader replace - "Helvetica" with "Arial" and "Times" with "Times New Roman" internally. - GhostScript replaces "Helvetica" with "Nimbus Sans L" and "Times" with - "Nimbus Roman No9 L". Other document viewers may do similar font - substitutions. If you need to make sure that there are no such - substitutions, you need to specify an explicit font and embed it in - the target document. -

-
-
- Missing Fonts -

- When FOP does not have a specific font at its disposal (because it's - not installed in the operating system or set up in FOP's configuration), - the font is replaced with "any". "any" is internally mapped to the - Base-14 font "Times" (see above). -

-
-
- Missing Glyphs -

- Every font contains a particular set of - glyphs. If no glyph can be found for - a given character, FOP will issue a warning and use the glpyh for "#" (if available) - instead. Before it does that, it consults a (currently hard-coded) registry of - glyph substitution groups (see Glyphs.java in Apache XML Graphics Commons). - This registry can supply alternative glyphs in some cases (like using space when a no-break - space is requested). But there's no guarantee that the result will be as expected (for - example, in the case of hyphens and similar glyphs). A better way is to use a font that - has all the necessary glyphs. This glyph substitution is only a last resort. -

-
-
- Java2D/AWT/Operating System Fonts -

- The Java2D family of renderers (Java2D, AWT, Print, TIFF, PNG), use the - Java AWT subsystem for font metric information. Through operating system - registration, the AWT subsystem knows what fonts are available on the system, - and the font metrics for each one. -

-

- When working with one of these output formats and you're missing a font, just - install it in your operating system and they should be available for these - renderers. Please note that this is not true for other output formats such as - PDF or PostScript. -

-
-
- Custom Fonts -

- Support for custom fonts is highly output format dependent (see above table). - This section shows how to add Type 1 and TrueType fonts to the PDF, PostScript and - Java2D-based renderers. Other renderers (like AFP) support other font formats. Details - in this case can be found on the page about output formats. -

-

- In earlier FOP versions, it was always necessary to create an XML font metrics file - if you wanted to add a custom font. This unconvenient step has been removed and in - addition to that, FOP supports auto-registration of fonts, i.e. FOP can find fonts - installed in your operating system or can scan user-specified directories for fonts. - Font registration via XML font metrics file is still supported and may still be necessary - for some very special cases as fallback variant while we stabilize font auto-detection. -

-

- Basic information about fonts can be found at: -

- -
-
- Basic font configuration -

- If you want FOP to use custom fonts, you need to tell it where to find them. This - is done in the configuration file and once per renderer (because each output format - is a little different). In the basic form, you can either tell FOP to find your - operating system fonts or you can specify directories that it will search for - support fonts. These fonts will then automatically be registered. -

- - - - - C:\MyFonts1 - - - C:\MyFonts2 - - - - - -]]> - - Review the documentation for FOP Configuration - for instructions on making the FOP configuration available to FOP when it runs. - Otherwise, FOP has no way of finding your custom font information. It is currently - not possible to easily configure fonts from Java code. - -
-
- Advanced font configuration -

- The instructions found above should be sufficient for most users. Below are some - additional instructions in case the basic font configuration doesn't lead to - the desired results. -

-
- Type 1 Font Metrics -

FOP includes PFMReader, which reads the PFM file that normally comes with a Type 1 font, and generates an appropriate font metrics file for it. - To use it, run the class org.apache.fop.fonts.apps.PFMReader:

-

Windows:

- java -cp build\fop.jar;lib\avalon-framework.jar;lib\commons-logging.jar;lib\commons-io.jar - org.apache.fop.fonts.apps.PFMReader [options] pfm-file xml-file -

Unix:

- java -cp build/fop.jar:lib/avalon-framework.jar:lib/commons-logging.jar:lib/commons-io.jar - org.apache.fop.fonts.apps.PFMReader [options] pfm-file xml-file -

PFMReader [options]:

-
    -
  • -fn <fontname> By default, FOP uses the fontname from the - .pfm file when embedding the font. Use the "-fn" option to override this name with one you have - chosen. This may be useful in some cases to ensure that applications using the output document - (Acrobat Reader for example) use the embedded font instead of a local font with the same - name.
    • -
- The classpath in the above example has been simplified for readability. - You will have to adjust the classpath to the names of the actual JAR files in the lib directory. - xml-apis.jar, xercesImpl.jar, xalan.jar and serializer.jar are not necessary for JDK version 1.4 or later. - The tool will construct some values (FontBBox, StemV and ItalicAngle) based on assumptions and calculations which are only an approximation to the real values. - FontBBox and Italic Angle can be found in the human-readable part of the PFB file or in the AFM file. - The PFMReader tool does not yet interpret PFB or AFM files, so if you want to be correct, you may have to adjust the values in the XML file manually. - The constructed values however appear to have no visible influence. -
-
- TrueType Font Metrics -

FOP includes TTFReader, which reads the TTF file and generates an appropriate font metrics file for it. - Use it in a similar manner to PFMReader. - For example, to create such a metrics file in Windows from the TrueType font at c:\myfonts\cmr10.ttf:

- java -cp build\fop.jar;lib\avalon-framework.jar;lib\commons-logging.jar;lib\commons-io.jar - org.apache.fop.fonts.apps.TTFReader [options] - C:\myfonts\cmr10.ttf ttfcm.xml -

TTFReader [options]:

-
    -
  • -d <DEBUG | INFO > Sets the debug level (default is - INFO).
    • -
  • -fn <fontname> Same as for PFMReader.
    • -
  • -ttcname <fontname> If you're reading data from a - TrueType Collection (.ttc file) you must specify which font from the collection you will read - metrics from. - If you read from a .ttc file without this option, the fontnames will be listed for you.
    • -
  • -enc ansi Creates a WinAnsi-encoded font metrics file. - Without this option, a CID-keyed font metrics file is created. - The table below summarizes the differences between these two encoding options as currently - used within FOP. - Please note that this information only applies to TrueType fonts and TrueType collections:
    • -
- - - - - - - - - - - - - - - - -
IssueWinAnsiCID-keyed
Usable Character SetLimited to WinAnsi character set, which is roughly equivalent to iso-8889-1.Limited only by the characters in the font itself.
Embedding the FontOptional.Mandatory. Not embedding the font produces invalid PDF documents.
- - You may experience failures with certain TrueType fonts, especially if they don't contain - the so-called Unicode "cmap" table. TTFReader can currently not deal with font like this. - -
-
- TrueType Collections -

TrueType collections (.ttc files) contain more than one font. - To create metrics files for these fonts, you must specify which font in the collection should be generated, by using the "-ttcname" option with the TTFReader.

-

To get a list of the fonts in a collection, just start the TTFReader as if it were a normal TrueType file (without the -ttcname option). - It will display all of the font names and exit with an Exception.

-

Here is an example of generating a metrics file for a .ttc file:

- java -cp build\fop.jar;lib\avalon-framework.jar;lib\commons-logging.jar;lib\commons-io.jar - org.apache.fop.fonts.apps.TTFReader -ttcname "MS Mincho" - msmincho.ttc msminch.xml -

- Alternatively, the individual sub-fonts of a TrueType Collections can be selected - using the "sub-font" attribute on the "font" element. That means that generating - an XML font metrics file for TrueType collections is not necessary anymore. Example: -

- - -]]> -
-
- Register Fonts with FOP -

You must tell FOP how to find and use the font metrics files by registering them in the FOP Configuration. Add entries for your custom fonts, regardless of font type, to the configuration file in a manner similar to the following:

- - - - - - - - - - C:\MyFonts1 - - - C:\MyFonts2 - - - - - -]]> -
    -
  • - URLs are used to access the font metric and font files. - Relative URLs are resolved relative to the font-base property (or base) if available. - See FOP: Configuration for more information. -
    • -
  • The "metrics-url" attribute is generally not necessary except if you run into problems with certain fonts.
    • -
  • Either an "embed-url" or a "metrics-url" must be specified for font tag configurations.
    • -
  • The font "kerning" attribute is optional. Default is "true".
    • -
  • If embedding is off (i.e. embed-url is not set), the output will position the text correctly (from the metrics file), but it will not be displayed or printed correctly unless the viewer has the applicable font available to their local system.
    • -
  • When setting the "embed-url" attribute for Type 1 fonts, be sure to specify the PFB (actual font data), not PFM (font metrics) file that you used to generate the XML font metrics file.
    • -
  • The attribute "encoding-mode" is optional an may have the following values: -
      -
    • auto: default font encoding mode ("cid" for Truetype, "single-byte" for Type 1)
      • -
    • single-byte: use single-byte encodings in the target format (if applicable)
      • -
    • cid: encode as CID-keyed font (currently only supported for PDF output with TrueType fonts)
      • -
    -
    • -
  • The fonts "directory" tag can be used to register fonts contained within a single or list of directory paths. The "recursive" attribute can be specified to recursively add fonts from all sub directories.
    • -
  • The fonts "auto-detect" tag can be used to automatically register fonts that are found to be installed on the native operating system.
    • -
  • Fonts registered with "font" tag configurations override fonts found by means of "directory" tag definitions.
    • -
  • Fonts found as a result of a "directory" tag configuration override fonts found as a result of the "auto-detect" tag being specified.
    • -
  • - If relative URLs are specified, they are evaluated relative to the value of the - "font-base" setting. If there is no "font-base" setting, the fonts are evaluated - relative to the base directory. -
    • -
- -
-
- Auto-Detect and auto-embed feature -

When the "auto-detect" flag is set in the configuration, FOP will automatically search for fonts in the default paths for your operating system.

-

FOP will also auto-detect fonts which are available in the classpath, if they are described as "application/x-font" in the MANIFEST.MF file. For example, if your .jar file contains font/myfont.ttf:

- Manifest-Version: 1.0 - - Name: font/myfont.ttf - Content-Type: application/x-font -

This feature allows you to create JAR files containing fonts. The JAR files can be added to fop by providem them in the classpath, e.g. copying them into the lib/ directory.

-
- The font cache -

- Apache FOP maintains a cache file that is used to speed up auto-detection. This file - is usually found in the ".fop" directory under the user's home directory. It's called - "fop-fonts.cache". When the user's home directory is not writable, the font cache file - is put in the directory for temporary files. -

-

- If there was a problem loading a particular font, it is flagged in the cache file so - it is not loaded anymore. So, if a font is actually around but is still not found - by Apache FOP, it's worth a try to delete the font cache file which forces Apache FOP - to reparse all fonts. -

-
-
-
- Embedding -

- By default, all fonts are embedded if an output format supports font embedding. In some - cases, however, it is preferred that some fonts are only referenced. When working - with referenced fonts it is important to be in control of the target environment where - the produced document is consumed, i.e. the necessary fonts have to be installed there. -

-

- There are two different ways how you can specify that a font should be referenced: -

-
    -
  1. - When using the old-style "font" element to configure a single font, font referencing - is controlled by the embed-url attribute. If you don't specify the embed-url attribute - the font will not be embedded, but will only be referenced. -
    2. -
  2. - For automatically configured fonts there's a different mechanism to specify which - fonts should be referenced rather than embedded. This is done in the "referenced-fonts" - element in the configuration. Here's an example: -
    3. -
- - - - - - - -]]> -

- At the moment, you can only match fonts against their font-family. It is possible to use - regular expressions as is shown in the second example above ("DejaVu.*"). The syntax for - the regular expressions used here are the one used by the - java.util.regex package. - So, in the above snippet "Helvetica" and all variants of the "DejaVu" font family are - referenced. If you want to reference all fonts, just specify font-family=".*". -

-

- The referenced-fonts element can be placed either inside the general - fonts element (right under the root) or in the fonts element - under the renderer configuration. In the first case, matches apply to all renderers. - In the second case, matches only apply to the renderer where the element was specified. - Both cases can be used at the same time. -

-

- Various notes related to embedded fonts: -

-
    -
  • The font is simply embedded into the output file, it is not converted.
    • -
  • When FOP embeds a font in a PDF file, it adds a prefix to the fontname to ensure that - the name will not match the fontname of an installed font. This is helpful with older - versions of Acrobat Reader that preferred installed fonts over embedded fonts.
    • -
  • When embedding PostScript fonts, the entire font is always embedded.
    • -
  • When embedding TrueType fonts (ttf) or TrueType Collections (ttc), a subset of the - original font, containing only the glyphs used, is embedded in the output document. - That's the default, but if you specify encoding-mode="single-byte" (see above), the - complete font is embedded.
    • -
-
-
- Substitution -

When a <substitutions/> section is defined in the configuration, FOP will re-map any font-family references found in your FO input to a given substitution font.

-
    -
  • If a <substitution/> is declared, it is mandatory that both a <from/> and <to/> child element is declared with a font-family attribute.
    • -
  • Both font-weight and font-style are optional attributes, if they are provided then a value of 'normal' is assumed.
    • -
-

For example you could make all FO font-family references to 'Arial' with weights between 700 and 900 reference the normal 'Arial Black' font.

- - - - - - - - - - - - - -]]> -
- -
-
- Font Selection Strategies -

- There are two font selection strategies: character-by-character or auto. The default is auto.

-

Auto selected the first font from the list which is able to display the most characters in a given word. This means (assume font A has characters for abclmn, font B for lnmxyz, fontlist is A,B):

-
    -
  • aaa lll xxx would be displayed in fonts A A B
    • -
  • aaaxx would be displayed in font A
    • -
  • aaaxxx would be displayed in font A
    • -
  • aaaxxxx would be displayed in font B
    • -
-

Character-by-Character is NOT yet supported!

-
-
- Font List Command-Line Tool -

- FOP contains a small command-line tool that lets you generate a list of all configured - fonts. Its class name is: org.apache.fop.tools.fontlist.FontListMain. - Run it with the "-?" parameter to get help for the various options. -

-
- - diff --git a/src/documentation/content/xdocs/trunk/graphics.xml b/src/documentation/content/xdocs/trunk/graphics.xml deleted file mode 100644 index eb05013b7..000000000 --- a/src/documentation/content/xdocs/trunk/graphics.xml +++ /dev/null @@ -1,593 +0,0 @@ - - - - - -
- Apache™ FOP: Graphics Formats - $Revision$ -
- -
- Introduction -

- Some noteworthy features of the image handling subsystem are: -

-
    -
  • - The image libraries Jimi and JAI are not supported. Instead, Apache™ FOP uses the - Image I/O API that was introduced with Java 1.4 for all bitmap codecs. -
    • -
  • - Some bitmap images are not converted to a standardized 24 bit RGB image but are - instead handled in their native format. -
    • -
  • - A plug-in mechanism offers a possibility to add support for new formats without changing - the FOP's source code. -
    • -
-

- The actual image loading framework - does not reside in Apache FOP, but in - XML Graphics Commons. -

-
-
- Overview of Graphics Support -

- The table below summarizes the theoretical support for graphical formats - within FOP. In other words, within the constraints of the limitations listed here, - these formats should work. However, many of them have not been tested, - and there may be limitations that have not yet been discovered or documented. - The packages needed to support some formats are not included in the FOP distribution - and must be installed separately. Follow the links in the "Support Through" columns - for more details. -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FormatTypeSupport Through
Apache FOP (native)Apache BatikImage I/O
BMP (Microsoft Windows Bitmap)bitmap - - X [1]
EMF (Windows Enhanced Metafile)vector (with embedded bitmaps)(X) - -
EPS (Encapsulated PostScript)metafile (both bitmap and vector), most frequently used for vector drawings(X) - -
GIF (Graphics Interchange Format)bitmap - - X
JPEG (Joint Photographic Experts Group)bitmap(X) - X
PNG (Portable Network Graphic)bitmap(X) - X
SVG (Scalable Vector Graphics)vector (with embedded bitmaps) - X -
TIFF (Tag Image Format File)bitmap(X) - X [1]
WMF (Windows Metafile)vector (with embedded bitmaps) - (X) -
-

- Legend: -

-
    -
  • "(X)" means restricted support. Please see the details below.
    • -
  • - [1]: Requires the presence of JAI Image I/O Tools - (or an equivalent Image I/O compatible codec) in the classpath. JAI Image I/O Tools also - adds support for JPEG 2000, WBMP, RAW and PNM. Other Image I/O codecs may provide - support for additional formats. -
    • -
- - JAI Image I/O Tools is not the same as the - JAI library! The - former simply exposes JAI's codecs using the Image&nbsp;I/O API but does not include all - the image manipulation functionality. - -
- Map of supported image formats by output format -

- Not all image formats are supported for all output formats! For example, while you can - use EPS (Encapsulated PostScript) files when you generate PostScript output, this format - will not be supported by any other output format. Here's an overview of which image - formats are supported by which output format: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Image FormatPDFPostScriptJava2D, PNG, TIFF, AWTPCLAFPRTF
BMP (Microsoft Windows Bitmap)XXXXXX
EMF (Windows Enhanced Metafile) - - - - - X [1]
EPS (Encapsulated PostScript) - X [1] - - - -
GIF (Graphics Interchange Format)XXXXXX
JPEG (Joint Photographic Experts Group)X [1]X [1]XXX [1]X
PNG (Portable Network Graphic)X [2]X [2]XXXX
SVG (Scalable Vector Graphics)XXXXXX
TIFF (Tag Image Format File)X [2]X [2]XXX [2]X
WMF (Windows Metafile)XXXXXX
-

- Legend: -

-
    -
  • - [1]: Supported without the need to decode the image. -
    • -
  • - [2]: Supported without the need to decode the image, but only for certain subtypes. -
    • -
-
-
-
- Graphics Packages -
- XML Graphics Commons Native -

- XML Graphics Commons supports a number - of graphic file formats natively as basic functionality: all bitmap formats for which - there are Image I/O codecs available (JPEG, PNG, GIF, TIFF, etc.), EPS and EMF. -

-
-
- FOP Native -

- FOP has no native image plug-ins for the image loading framework of its own but currently - hosts the Batik-dependent SVG and WMF plug-ins until they can be moved to - Apache Batik. -

-
-
- Apache Batik -

- Apache Batik will later receive the - SVG and WMF plug-ins for the image loading framework that are currently hosted inside - FOP. -

-

- Current FOP distributions include a distribution of the - Apache Batik. - Because Batik's API changes frequently, it is highly recommended that you use the - version that ships with FOP, at least when running FOP. -

- Batik must be run in a graphical environment. -

- Batik must be run in a graphical environment. - It uses AWT classes for rendering SVG, which in turn require an X server on Unixish - systems. If you run a server without X, or if you can't connect to the X server due to - security restrictions or policies (a so-called "headless" environment), SVG rendering - will fail. -

-

Here are some workarounds:

-
    -
  • - Start Java with the -Djava.awt.headless=true command line option. -
    • -
  • - Install an X server which provides an in-memory framebuffer without actually using a - screen device or any display hardware. One example is Xvfb. -
    • -
  • - Install a toolkit which emulates AWT without the need for an underlying X server. One - example is the PJA toolkit, which is free - and comes with detailed installation instructions. -
    • -
-
-
- Image I/O -

- The image loading framework in XML Graphics Commons - provides a wrapper to load images through the - JDK's Image I/O API (JSR 015). - Image I/O allows to dynamically add additional image codecs. An example of such an - add-on library are the - JAI Image I/O Tools - available from Sun. -

-
-
-
- Details on image formats -
- BMP -

- BMP images are supported through an Image I/O codec. There may be limitations of the - codec which are outside the control of Apache FOP. -

-
-
- EMF -

- Windows Enhanced Metafiles (EMF) are only supported in RTF output where they are - embedded without decoding. -

-
-
- EPS -

Apache FOP allows to use EPS files when generating PostScript output only.

-

- Other output targets can't be supported at the moment because - FOP lacks a PostScript interpreter. Furthermore, FOP is currently not able - to parse the preview bitmaps sometimes contained in EPS files. -

-
-
- GIF -

- GIF images are supported through an Image&nbsp;I/O codec. Transparency is supported but - not guaranteed to work with every output format. -

-
-
- JPEG -

- FOP native support (i.e. the handling of undecoded images) of JPEG does not include all - variants, especially those containing unusual color lookup tables and color profiles. - If you have trouble with a JPEG image in FOP, try opening it with an image processing - program (such as Photoshop or Gimp) and then saving it. Specifying 24-bit color output - may also help. For the PDF and PostScript renderers most JPEG images can be passed - through without decompression. User reports indicate that grayscale, RGB, and - CMYK color spaces are all rendered properly. However, for other output formats, the - JPEG images have to be decompressed. Tests have shown that there are some limitation - in some Image&nbsp;I/O codecs concerning images in the CMYK color space. Work-arounds are - in place but may not always work as expected. -

-
-
- PNG -

- FOP native support of PNG only includes the variants with 8 bits per channel and without - interlacing. Native support requires using the ImageLoaderRawPNG image loader. - Support through a Image I/O codec can use either the internal XGC PNG codec or the JRE PNG - codec. The associated image loaders are, respectively, ImageLoaderPNG and ImageLoaderImageIO. - Transparency is supported but not guaranteed to work with every output format. -

-
-
- SVG -
- Introduction -

FOP uses Apache Batik for SVG support. - This format can be handled as an fo:instream-foreign-object or in a separate - file referenced with fo:external-graphic.

- - Batik's SVG Rasterizer utility may also be used to convert standalone SVG - documents into PDF. For more information please see the - SVG Rasterizer documentation - on the Batik site. - -
-
- Placing SVG Graphics into PDF -

- The SVG is rendered into PDF by using PDF commands to draw and fill - lines and curves. This means that the graphical objects created with - this remain as vector graphics. The same applies to PostScript output. - For other output formats the SVG graphic may be converted to a bitmap - image. -

-

- There are a number of SVG things that cannot be converted directly into - PDF. Parts of the graphic such as effects, patterns and images are inserted - into the PDF as a raster graphic. The resolution of these raster images can - be controlled through the "target resolution" setting in the - configuration.

-

- Currently transparency is limited in PDF so some SVG images that - contain effects or graphics with transparent areas may not be displayed - correctly. -

-
-
- Placing SVG Text into PDF and PostScript -

If possible, Batik will use normal PDF or PostScript text when inserting text. It does - this by checking if the text can be drawn normally and the font is - supported. This example svg text.svg / - text.pdf / text.png - shows how various types and effects with text are handled. - Note that SVG font support is not yet implemented. Furthermore, text handling in - PostScript output is inferior to PDF output - more text will be painted as shapes in - PS than in PDF. -

-

- When there's no support to paint text using native text operations, - text is converted and drawn as a set of shapes by Batik, using the - stroking text painter. This means that a typical character will - have about 10 curves (each curve consists of at least 20 characters). - This can make the output files large and when it is viewed the - viewer may not normally draw those fine curves very well (In Adobe Acrobat, turning on - "Smooth Line Art" in the preferences will fix this). Copy/paste functionality - will not be supported in this case. - If the text is inserted into the output file using the inbuilt text commands - it will use a single character. -

-

- Note that because SVG text can be rendered as either text or a vector graphic, you - may need to consider settings in your viewer for both. The Acrobat viewer has both - "smooth line art" and "smooth text" settings that may need to be set for SVG images - to be displayed nicely on your screen (see Edit / Preferences / Display). - This setting will not affect the printing of your document, which should be OK in - any case, but will only affect the quality of the screen display. -

-
-
- Font selection notes -

- Apache Batik uses the AWT/Java2D subsystem as font source while FOP has its own font - subsystem. Great care has been taken that font selection does the best possible choices. - But it must be noted when creating PDF or PostScript that a font used in SVG graphics - needs to be registered with the operating system as well as in FOP's configuration. - By using FOP's font auto-detection, you simply have to install the font in the operating - system and not care about anything else. This is less of an issue if you create - formats like TIFFs, PNGs or PCL because in these cases SVG graphics are usually rendered - to bitmaps which means that on both sides (Batik and FOP), AWT/Java2D is used as the - single font source. -

-

- Whenever an SVG is converted into a PDF or PostScript file, the font that has been used - inside Batik has to be mapped to a font used by the actual output format. Features like - font substitution in FOP may need to be taken into account but can also be an advantage - when working around font mapping issues. Like for XSL-FO content, you'll get a warning - if a particular font could not be found and had to be substituted, or if a particular - glyph is missing in a font. -

-
-
- Scaling -

- Currently, SVG images are rendered with the dimensions specified in the SVG - file, within the viewport specified in the fo:external-graphic element. - For everything to work properly, the two should be equal. The SVG standard leaves - this issue as an implementation detail. Additional scaling options are available - through XSL-FO means. -

-

- If you use pixels to specify the size of an SVG graphic the "source resolution" setting - in the configuration will be used to determine the - size of a pixel. The use of pixels to specify sizes is discouraged as they may - be interpreted differently in different environments. -

-
-
- Known Problems -
    -
  • - Soft mask transparency is combined with white so that it looks better - on PDF 1.3 viewers but this causes the soft mask to be slightly lighter - or darker on PDF 1.4 viewers. -
    • -
  • - There is some problem with a gradient inside a pattern which may cause a PDF - error when viewed in Acrobat 5. -
    • -
  • - Text is not always handled correctly, it may select the wrong font - especially if characters have multiple fonts in the font list. -
    • -
  • - Uniform transparency for images and other SVG elements that are converted - into a raster graphic are not drawn properly in PDF. The image is opaque. -
    • -
-
-
-
- TIFF -

- FOP can embed TIFF images without decompression into PDF, PostScript and AFP if they - have either CCITT T.4, CCITT T.6, or JPEG compression. Otherwise, a TIFF-capable - Image&nbsp;I/O codec is necessary for decoding the image. -

-

- There may be some limitation concerning images in the CMYK color space. -

-
-
- WMF -

- Windows Metafiles (WMF) are supported through classes in - Apache Batik. At the moment, support - for this format is experimental and may not always work as expected. -

-
-
-
- Graphics Resolution -

- Some bitmapped image file formats store a dots-per-inch (dpi) or other resolution - values. FOP tries to use this resolution information whenever possible to determine - the image's intrinsic size. This size is used during the layout process when it is not - superseded by an explicit size on fo:external-graphic (content-width and content-height - properties). -

-

- Please note that not all images contain resolution information. If it's not available - the source resolution set on the FopFactory (or through the user configuration XML) is used. - The default here is 72 dpi. -

-

- Bitmap images are generally embedded into the output format at their original resolution - (as is). No resampling of the image is performed. Explicit resampling is on our wishlist, - but hasn't been implemented, yet. Bitmaps included in SVG graphics may be resampled to - the resolution specified in the "target resolution" setting in the - configuration if SVG filters are applied. This can be - used as a work-around to resample images in FO documents. -

-
-
- Page selection for multi-page formats -

- Some image formats such as TIFF support multiple pages/sub-images per file. You can - select a particular page using a special URI fragment in the form: - <uri>#page=<nr> - (for example: http://localhost/images/myimage.tiff#page=3) -

-
-
- Image caching -

- FOP caches images between runs. There is one cache per FopFactory instance. The URI is - used as a key to identify images which means that when a particular URI appears again, - the image is taken from the cache. If you have a servlet that generates a different - image each time it is called with the same URI you need to use a constantly - changing dummy parameter on the URI to avoid caching. -

-

- The image cache has been improved considerably in the redesigned code. Therefore, - resetting the image cache should be a thing of the past. If you - still experience OutOfMemoryErrors, please notify us. -

-

- If all else fails, the image cache can be cleared like this: - fopFactory.getImageManager().getCache().clearCache(); -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/trunk/hyphenation.xml b/src/documentation/content/xdocs/trunk/hyphenation.xml deleted file mode 100644 index e6f666826..000000000 --- a/src/documentation/content/xdocs/trunk/hyphenation.xml +++ /dev/null @@ -1,237 +0,0 @@ - - - - - -
- Apache™ FOP: Hyphenation - $Revision$ -
- -
- Hyphenation Support -
- Introduction -

Apache™ FOP uses Liang's hyphenation algorithm, well known from TeX. It needs - language specific pattern and other data for operation.

-

Because of licensing issues (and for - convenience), all hyphenation patterns for FOP are made available through - the Objects For - Formatting Objects project.

- If you have made improvements to an existing Apache™ FOP hyphenation pattern, - or if you have created one from scratch, please consider contributing these - to OFFO so that they can benefit other FOP users as well. - Please inquire on the FOP User - mailing list. -
-
- License Issues -

Many of the hyphenation files distributed with TeX and its offspring are - licenced under the LaTeX - Project Public License (LPPL), which prevents them from being - distributed with Apache software. The LPPL puts restrictions on file names - in redistributed derived works which we feel can't guarantee. Some - hyphenation pattern files have other or additional restrictions, for - example against use for commercial purposes.

-

Although Apache FOP cannot redistribute hyphenation pattern files that do - not conform with its license scheme, that does not necessarily prevent users - from using such hyphenation patterns with FOP. However, it does place on - the user the responsibility for determining whether the user can rightly use - such hyphenation patterns under the hyphenation pattern license.

- The user is responsible to settle license issues for hyphenation - pattern files that are obtained from non-Apache sources. -
-
- Sources of Custom Hyphenation Pattern Files -

The most important source of hyphenation pattern files is the - CTAN TeX - Archive.

-
-
- Installing Custom Hyphenation Patterns -

To install a custom hyphenation pattern for use with FOP:

-
    -
  1. Convert the TeX hyphenation pattern file to the FOP format. The FOP - format is an xml file conforming to the DTD found at - {fop-dir}/hyph/hyphenation.dtd.
    2. -
  2. Name this new file following this schema: - languageCode_countryCode.xml. The country code is - optional, and should be used only if needed. For example: -
      -
    • en_US.xml would be the file name for American - English hyphenation patterns.
      • -
    • it.xml would be the file name for Italian - hyphenation patterns.
      • -
    - The language and country codes must match the XSL-FO input, which - follows ISO - 639 (languages) and ISO - 3166 (countries). NOTE: The ISO 639/ISO 3166 convention is that - language names are written in lower case, while country codes are written - in upper case. FOP does not check whether the language and country specified - in the FO source are actually from the current standard, but it relies - on it being two letter strings in a few places. So you can make up your - own codes for custom hyphenation patterns, but they should be two - letter strings too (patches for proper handling extensions are welcome)
    3. -
  3. There are basically three ways to make the FOP-compatible hyphenation pattern - file(s) accessible to FOP: -
      -
    • Download the precompiled JAR from OFFO - and place it either in the {fop-dir}/lib directory, or - in a directory of your choice (and append the full path to the JAR to - the environment variable FOP_HYPHENATION_PATH).
      • -
    • Download the desired FOP-compatible hyphenation pattern file(s) from - OFFO, - and/or take your self created hyphenation pattern file(s), -
        -
      • place them in the directory {fop-dir}/hyph,
        • -
      • or place them in a directory of your choice and set the Ant variable - user.hyph.dir to point to that directory (in - build-local.properties),
        • -
      - and run Ant with build target - jar-hyphenation. This will create a JAR containing the - compiled patterns in {fop-dir}/build that will be added to the - classpath on the next run. - (When FOP is built from scratch, and there are pattern source file(s) - present in the directory pointed to by the - user.hyph.dir variable, this JAR will automatically - be created from the supplied pattern(s)).
      • -
    • Put the pattern source file(s) into a directory of your choice and - configure FOP to look for custom patterns in this directory, by setting the - <hyphenation-base> - configuration option.
      • -
    -
    4. -
- - Either of these three options will ensure hyphenation is working when using - FOP from the command-line. If FOP is being embedded, remember to add the location(s) - of the hyphenation JAR(s) to the CLASSPATH (option 1 and 2) or to set the - <hyphenation-dir> - configuration option programmatically (option 3). - -
-
-
- Hyphenation Patterns -

If you would like to build your own hyphenation pattern files, or modify - existing ones, this section will help you understand how to do so. Even - when creating a pattern file from scratch, it may be beneficial to start - with an existing file and modify it. See - OFFO's Hyphenation page for examples. - Here is a brief explanation of the contents of FOP's hyphenation patterns:

- The remaining content of this section should be considered "draft" - quality. It was drafted from theoretical literature, and has not been - tested against actual FOP behavior. It may contain errors or omissions. - Do not rely on these instructions without testing everything stated here. - If you use these instructions, please provide feedback on the - FOP User mailing list, either - confirming their accuracy, or raising specific problems that we can - address. -
    -
  • The root of the pattern file is the <hyphenation-info> element.
    • -
  • <hyphen-char>: its attribute "value" contains the character signalling - a hyphen in the <exceptions> section. It has nothing to do with the - hyphenation character used in FOP, use the XSLFO hyphenation-character - property for defining the hyphenation character there. At some points - a dash U+002D is hardwired in the code, so you'd better use this too - (patches to rectify the situation are welcome). There is no default, - if you declare exceptions with hyphenations, you must declare the - hyphen-char too.
    • -
  • <hyphen-min> contains two attributes: -
      -
    • before: the minimum number of characters in a word allowed to exist - on a line immediately preceding a hyphenated word-break.
      • -
    • after: the minimum number of characters in a word allowed to exist - on a line immediately after a hyphenated word-break.
      • -
    - This element is unused and not even read. It should be considered a - documentation for parameters used during pattern generation. -
    • -
  • <classes> contains whitespace-separated character sets. The members - of each set should be treated as equivalent for purposes of hyphenation, - usually upper and lower case of the same character. The first character - of the set is the canonical character, the patterns and exceptions - should only contain these canonical representation characters (except - digits for weight, the period (.) as word delimiter in the patterns and - the hyphen char in exceptions, of course).
    • -
  • <exceptions> contains whitespace-separated words, each of which - has either explicit hyphen characters to denote acceptable breakage - points, or no hyphen characters, to indicate that this word should - never be hyphenated, or contain explicit <hyp> elements for specifying - changes of spelling due to hyphenation (like backen -> bak-ken or - Stoffarbe -> Stoff-farbe in the old german spelling). Exceptions override - the patterns described below. Explicit <hyp> declarations don't work - yet (patches welcome). Exceptions are generally a bit brittle, test - carefully.
    • -
  • <patterns> includes whitespace-separated patterns, which are what - drive most hyphenation decisions. The characters in these patterns are - explained as follows: -
      -
    • non-numeric characters represent characters in a sub-word to be - evaluated
      • -
    • the period character (.) represents a word boundary, i.e. either - the beginning or ending of a word
      • -
    • numeric characters represent a scoring system for indicating the - acceptability of a hyphen in this location. Odd numbers represent an - acceptable location for a hyphen, with higher values overriding lower - inhibiting values. Even numbers indicate an unacceptable location, with - higher values overriding lower values indicating an acceptable position. - A value of zero (inhibiting) is implied when there is no number present. - Generally patterns are constructed so that valuse greater than 4 are rare. - Due to a bug currently patterns with values of 8 and greater don't - have an effect, so don't wonder.
      • -
    - Here are some examples from the English patterns file: -
      -
    • Knuth (The TeXBook, Appendix H) uses the example hach4, which indicates that it is extremely undesirable to place a hyphen after the substring "hach", for example in the word "toothach-es".
      • -
    • .leg5e indicates that "leg-e", when it occurs at the beginning of a word, is a very good place to place a hyphen, if one is needed. Words like "leg-end" and "leg-er-de-main" fit this pattern.
      • -
    - Note that the algorithm that uses this data searches for each of the word's substrings in the patterns, and chooses the highest value found for letter combination. -
    • -
-

If you want to convert a TeX hyphenation pattern file, you have to undo - the TeX encoding for non-ASCII text. FOP uses Unicode, and the patterns - must be proper Unicode too. You should be aware of the XML encoding issues, - preferably use a good Unicode editor.

-

Note that FOP does not do Unicode character normalization. If you use - combining chars for accents and other character decorations, you must - declare character classes for them, and use the same sequence of base character - and combining marks in the XSLFO source, otherwise the pattern wouldn't match. - Fortunately, Unicode provides precomposed characters for all important cases - in common languages, until now nobody run seriously into this issue. Some dead - languages and dialects, especially ancient ones, may pose a real problem - though.

-

If you want to generate your own patterns, an open-source utility called - patgen can be used to assist in creating pattern files from dictionaries. - It is available in many Unix/Linux distributions and every TeX distribution. - Pattern creation for languages like english or german is an art. Read - Frank Liang's original paper "Word - Hy-phen-a-tion by Com-pu-ter" (yes, with hyphens) for details. - The original patgen.web source, included in the TeX source distributions, - contains valuable comments, unfortunately technical details often obscure the - high level issues. Another important source of information is - The - TeX Book, appendix H (either read the TeX source, or run it through - TeX to typeset it). Secondary articles, for example the works by Petr Sojka, - may also give some much needed insight into problems arising in automated - hyphenation.

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/trunk/index.xml b/src/documentation/content/xdocs/trunk/index.xml deleted file mode 100644 index 91a3ec65e..000000000 --- a/src/documentation/content/xdocs/trunk/index.xml +++ /dev/null @@ -1,50 +0,0 @@ - - - - - -
- Apache™ FOP Trunk (Development code) - $Revision$ -
- -
- Introduction -

- Apache™ FOP Trunk is the name for the current - development code as found in the Subversion repository. This - section of the FOP web site provides the documentation for - this version. -

-

- The Apache FOP team is proud to present to you this production quality codebase. It has taken - over three years to get this far and over two years without a new release from the FOP - project. We're still in the process of adding new features. We welcome any feedback you - might have and even more, any other form of help to get the project forward. -

-
-
- Upgrading from an earlier version -

- If you're upgrading to this version from an earlier version of FOP, please read the - information contained on the Upgrading page! -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/trunk/intermediate.xml b/src/documentation/content/xdocs/trunk/intermediate.xml deleted file mode 100644 index 171ae4e6a..000000000 --- a/src/documentation/content/xdocs/trunk/intermediate.xml +++ /dev/null @@ -1,331 +0,0 @@ - - - - - -
- Apache™ FOP: Intermediate Format - $Revision$ -
- - - Please note that the intermediate formats described here are - advanced features and can be ignored by most users of Apache FOP. - -
- Introduction -

- Apache™ FOP now provides two different so-called intermediate formats. The first one - (let's call it the area tree XML format) is basically a 1:1 XML representation of FOP's - area tree as generated by the layout engine. The area tree is conceptually defined in the - XSL-FO specification in chapter 1.1.2. - Even though the area tree is mentioned in the XSL-FO specification, this part is not - standardized. Therefore, the area tree XML format is a FOP-proprietary XML file format. - The area tree XML can be generated through the area tree XML Renderer (the XMLRenderer). -

-

- The second intermediate format (which we shall name exactly like this: the intermediate - format) - is a recent addition which tries to meet a slightly different set of goals. It is highly - optimized for speed. -

-

- The intermediate format can be used to generate intermediate documents that are modified - before they are finally rendered to their ultimate output format. Modifications include - adjusting and changing trait values, adding or modifying area objects, inserting prefabricated - pages, overlays, imposition (n-up, rotation, scaling etc.). Multiple IF files can be combined - to a single output file. -

-
-
- Which Intermediate Format to choose? -

- Both formats have their use cases, so the choice you will make will depend on your - particular situation. Here is a list of strengths and use cases for both formats: -

-
- Area Tree XML (AT XML) -
    -
  • 1:1 representation of FOP's area tree in XML.
    • -
  • Contains more structure information than the new intermediate format.
    • -
  • Used in FOP's layout engine test suite for regression testing.
    • -
-
-
- Intermediate Format (IF) -
    -
  • Highly optimized for speed.
    • -
  • Smaller XML files.
    • -
  • Easier to post-process.
    • -
  • XML Schema is available.
    • -
  • - Recommended for use cases where documents are formatted concurrently and later - concatenated to a single print job. -
    • -
-
-

- More technical information about the two formats can be found on the - FOP Wiki. -

-
-
- Architectural Overview -
-
-
- Usage of the Area Tree XML format (AT XML) -

- As already mentioned, the area tree XML format is generated by using the - XMLRenderer (MIME type: application/X-fop-areatree). - So, you basically set the right MIME type for the output format and process your FO files - as if you would create a PDF file. -

-

- However, there is an important detail to consider: The - various Renderers don't all use the same font sources. To be able to create the right - area tree for the ultimate output format, you need to create the area tree XML file using - the right font setup. This is achieved by telling the XMLRenderer to mimic another - renderer. This is done by calling the XMLRenderer's mimicRenderer() method with an - instance of the ultimate target renderer as the single parameter. This has a consequence: - An area tree XML file rendered with the Java2DRenderer may not look as expected when it - was actually generated for the PDF renderer. For renderers that use the same font setup, - this restriction does not apply (PDF and PS, for example). Generating the area tree XML - format file is the first step. -

-

- The second step is to reparse the file using the AreaTreeParser which is - found in the org.apache.fop.area package. The pages retrieved from the area tree XML file - are added to an AreaTreeModel instance from where they are normally rendered using one of - the available Renderer implementations. You can find examples for the area tree XML - processing in the - examples/embedding - directory in the FOP distribution. -

-

- The basic pattern to parse the area tree XML format looks like this: -

- -

- This example simply reads an area tree file and renders it to a PDF file. Please note, that in normal - FOP operation you're shielded from having to instantiate the FontInfo object yourself. This - is normally a task of the AreaTreeHandler which is not present in this scenario. The same - applies to the AreaTreeModel instance, in this case an instance of a subclass called - RenderPagesModel. RenderPagesModel is ideal in this case as it has very little overhead - processing the individual pages. An important line in the example is the call to - endDocument() on the AreaTreeModel. This lets the Renderer know that the processing - is now finished. -

-

- The area tree XML format can also be used from the command-line - by using the "-atin" parameter for specifying the area tree XML as input file. You can also - specify a "mimic renderer" by inserting a MIME type between "-at" and the output file. -

-
- Concatenating Documents -

- This initial example is obviously not very useful. It would be faster to create the PDF file - directly. As the ExampleConcat.java - example shows you can easily parse multiple area tree files in a row and add the parsed pages to the - same AreaTreeModel instance which essentially concatenates all the input document to one single - output document. -

-
-
- Modifying Documents -

- One of the most important use cases for this format is obviously modifying the area - tree XML before finally rendering it to the target format. You can easily use XSLT to process - the AT XML file according to your needs. Please note, that we will currently not formally describe - the area tree XML format. You need to have a good understanding its structure so you don't - create any non-parseable files. We may add an XML Schema and more detailed documentation at a - later time. You're invited to help us with that. -

- - The area tree XML format is sensitive to changes in whitespace. If you're not careful, - the modified file may not render correctly. - -
-
- Advanced Use -

- The generation of the area tree format as well as it parsing process has been designed to allow - for maximum flexibility and optimization. Please note that you can call setTransformerHandler() on - XMLRenderer to give the XMLRenderer your own TransformerHandler instance in case you would like to - do custom serialization (to a W3C DOM, for example) and/or to directly modify the area tree using - XSLT. The AreaTreeParser on the other side allows you to retrieve a ContentHandler instance where - you can manually send SAX events to to start the parsing process (see getContentHandler()). -

-
-
-
- Usage of the Intermediate Format (IF) -

- The Intermediate Format (IF) is generated by the IFSerializer - (MIME type: application/X-fop-intermediate-format). - So, you basically set the right MIME type for the output format and process your FO files - as if you would create a PDF file. -

-

- The IFSerializer is an implementation of the IFDocumentHandler and - IFPainter interfaces. The IFRenderer class is responsible - for converting FOP's area tree into calls against these two interfaces. -

-
    -
  • - IFDocumentHandler: This interface is used on the document-level and defines the - overall structure of the Intermediate Format. -
    • -
  • - IFPainter: This interface is used to generate graphical page content like text, images - and borders. -
    • -
-

- As with the AT XML, there is an important detail to consider: The various output - implementations don't all use the same font sources. To be able - to create the right IF for the ultimate output file, you need to create the IF file using - the right font setup. This is achieved by telling the IFRenderer (responsible for - converting the area tree into calls to the IFDocumentHandler and IFPainter interfaces) - to mimic another renderer. This is done by calling the IFSerializer's - mimicDocumentHandler() method with an instance of the ultimate target document handler - as the single parameter. This has a consequence: An IF file rendered with the - Java2DDocumentHandler may not look as expected when it was actually generated for the PDF - implementation. For implementations that use the same font setup, - this restriction does not apply (PDF and PS, for example). Generating the Intermediate - Format file is the first step. -

-

- The second step is to reparse the file using the IFParser which is - found in the org.apache.fop.render.intermediate package. The IFParser simply takes an - IFDocumentHandler instance against which it generates the appropriate calls. The IFParser - is implemented as a SAX ContentHandler so you're free to choose the method for - post-processing the IF file(s). You can use XSLT or write SAX- or DOM-based code to - manipulate the contents. You can find examples for the Intermediate Format - processing in the - examples/embedding - directory in the FOP distribution. -

-

- The basic pattern to parse the intermediate format looks like this: -

- -

- This example simply reads an intermediate file and renders it to a PDF file. Here - IFParser.parse() is used, but you can also just get a SAX ContentHandler by using the - IFParser.getContentHandler() method. -

-
- Concatenating Documents -

- This initial example is obviously not very useful. It would be faster to create the PDF file - directly (without the intermediate step). As the - ExampleConcat.java - example shows you can easily parse multiple intermediate files in a row and use the - IFConcatenator class to concatenate page sequences from multiple source files to a single - output file. This particular example does the concatenation on the level of the - IFDocumentHandler interface. You could also do this in XSLT or using SAX on the XML level. - Whatever suits your process best. -

-
-
- Modifying Documents -

- One of the most important use cases for this format is obviously modifying the - intermediate format before finally rendering it to the target format. You can easily use - XSLT to process the IF file according to your needs. -

-

- There is an XML Schema (located under - src/documentation/intermediate-format-ng) - that helps you verify that your modified content is correct. -

-

- For certain output formats there's a caveat: Formats like AFP and PCL do not support - arbitrary transformations on the IF's "viewport" and "g" elements. Possible are - only rotations in 90 degree steps and translations. -

-
-
- Advanced Use -

- The generation of the intermediate format as well as it parsing process has been - designed to allow for maximum flexibility and optimization. So rather than just passing - in a StreamResult to IFSerializer's setResult() method, you can also use a SAXResult - or a DOMResult. And as you've already seen , the IFParser on the other side allows you - to retrieve a ContentHandler instance where you can manually send SAX events to - start the parsing process (see getContentHandler()). -

-
-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/trunk/metadata.xml b/src/documentation/content/xdocs/trunk/metadata.xml deleted file mode 100644 index 5d4185533..000000000 --- a/src/documentation/content/xdocs/trunk/metadata.xml +++ /dev/null @@ -1,243 +0,0 @@ - - - - - -
- Apache™ FOP: Metadata -
- -
- Overview -

- Document metadata is an important tool for categorizing and finding documents. - Various formats support different kinds of metadata representation and to - different levels. One of the more popular and flexible means of representing - document or object metadata is - XMP (eXtensible Metadata Platform, specified by Adobe). - PDF 1.4 introduced the use of XMP. The XMP specification lists recommendation for - embedding XMP metdata in other document and image formats. Given its flexibility it makes - sense to make use this approach in the XSL-FO context. Unfortunately, unlike SVG which - also refers to XMP, XSL-FO doesn't recommend a preferred way of specifying document and - object metadata. Therefore, there's no portable way to represent metadata in XSL-FO - documents. Each implementation does it differently. -

-
-
- Embedding XMP in an XSL-FO document -

- As noted above, there's no officially recommended way to embed metadata in XSL-FO. - Apache™ FOP supports embedding XMP in XSL-FO. Currently, only support for document-level - metadata is implemented. Object-level metadata will be implemented when there's - interest. -

-

- Document-level metadata can be specified in the fo:declarations element. - XMP specification recommends to use x:xmpmeta, rdf:RDF, and - rdf:Description elements as shown in example below. Both - x:xmpmeta and rdf:RDF elements are recognized as the top-level - element introducing an XMP fragment (as per the XMP specification). -

-
- Example - - - - - - - Document title - Document author - Document subject - - - - Tool used to make the PDF - - - - - - - fo:declarations must be declared after - fo:layout-master-set and before the first page-sequence. - -
-
-
- Implementation in Apache FOP -

- Currently, XMP support is only available for PDF output. -

-

- Originally, you could set some metadata information through FOP's FOUserAgent by - using its set*() methods (like setTitle(String) or setAuthor(String). These values are - directly used to set value in the PDF Info object. Since PDF 1.4, adding metadata as an - XMP document to a PDF is possible. That means that there are now two mechanisms in PDF - that hold metadata. -

-

- Apache FOP now synchronizes the Info and the Metadata object in PDF, i.e. when you - set the title and the author through the FOUserAgent, the two values will end up in - the (old) Info object and in the new Metadata object as XMP content. If instead of - FOUserAgent, you embed XMP metadata in the XSL-FO document (as shown above), the - XMP metadata will be used as-is in the PDF Metadata object and some values from the - XMP metadata will be copied to the Info object to maintain backwards-compatibility - for PDF readers that don't support XMP metadata. -

-

- The mapping between the Info and the Metadata object used by Apache FOP comes from - the PDF/A-1 specification. - For convenience, here's the mapping table: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Document information dictionaryXMP
EntryPDF typePropertyXMP typeCategory
Titletext stringdc:titleTextExternal
Authortext stringdc:creatorseq TextExternal
Subjecttext stringdc:description["x-default"]TextExternal
Keywordstext stringpdf:KeywordsTextExternal
Creatortext stringxmp:CreatorToolTextExternal
Producertext stringpdf:ProducerTextInternal
CreationDatedatexmp:CreationDateDateInternal
ModDatedatexmp:ModifyDateDateInternal
- - "Internal" in the Category column means that the user should not set this value. - It is set by the application. - - - The "Subject" used to be mapped to dc:subject in the initial publication of - PDF/A-1 (ISO 19005-1). In the - Technical Corrigendum 1 - this was changed to map to dc:description["x-default"]. - -
- Namespaces -

- Metadata is made of property sets where each property set uses a different namespace URI. -

-

- The following is a listing of namespaces that Apache FOP recognizes and acts upon, - mostly to synchronize the XMP metadata with the PDF Info dictionary: -

- - - - - - - - - - - - - - - - - - - - - -
Set/SchemaNamespace PrefixNamespace URI
Dublin Coredchttp://purl.org/dc/elements/1.1/
XMP Basicxmphttp://ns.adobe.com/xap/1.0/
Adobe PDF Schemapdfhttp://ns.adobe.com/pdf/1.3/
-

- Please refer to the XMP Specification - for information on other metadata namespaces. -

-

- Property sets (Namespaces) not listed here are simply passed through to the final - document (if supported). That is useful if you want to specify a custom metadata - schema. -

-
-
- - - \ No newline at end of file diff --git a/src/documentation/content/xdocs/trunk/output.xml b/src/documentation/content/xdocs/trunk/output.xml deleted file mode 100644 index 96792cd4c..000000000 --- a/src/documentation/content/xdocs/trunk/output.xml +++ /dev/null @@ -1,1411 +0,0 @@ - - - - - - -
- Apache™ FOP Output Formats - $Revision$ - - - - -
- - -

- Apache™ FOP supports multiple output formats by using a different renderer for each format. - The renderers do not all have the same set of capabilities, sometimes because of - the output format itself, sometimes because some renderers get more development - attention than others. -

-
- General Information -
- Fonts -

- Most FOP renderers use a FOP-specific system for font registration. - However, the Java2D/AWT and print renderers use the Java AWT package, which gets its - font information from the operating system registration. - This can result in several differences, including actually using different fonts, - and having different font metrics for the same font. - The net effect is that the layout of a given FO document can be quite different between - renderers that do not use the same font information. -

-

- Theoretically, there's some potential to make the output of the PDF/PS renderers match - the output of the Java2D-based renderers. If FOP used the font metrics from its own - font subsystem but still used Java2D for text painting in the Java2D-based renderers, - this could probably be achieved. However, this approach hasn't been implemented, yet. -

-

- With a work-around, it is possible to match the PDF/PS output in a Java2D-based - renderer pretty closely. The clue is to use the - intermediate format. The trick is to layout the - document using FOP's own font subsystem but then render the document using Java2D. - Here are the necessary steps (using the command-line): -

-
    -
  1. - Produce an IF file: fop -fo myfile.fo -at application/pdf myfile.at.xml
    - Specifying "application/pdf" for the "-at" parameter causes FOP to use FOP's own - font subsystem (which is used by the PDF renderer). Note that no PDF file is created - in this step. -
    2. -
  2. Render to a PDF file: fop -atin myfile.at.xml -pdf myfile.pdf
    3. -
  3. Render to a Java2D-based renderer: -
      -
    • fop -atin myfile.at.xml -print
      • -
    • fop -atin myfile.at.xml -awt
      • -
    • fop -atin myfile.at.xml -tiff myfile.tiff
      • -
    -
    4. -
-
-
- Output to a Printer or Other Device -

- The most obvious way to print your document is to use the FOP - print renderer, which uses the Java2D API (AWT). - However, you can also send output from the Postscript renderer directly to a Postscript - device, or output from the PCL renderer directly to a PCL device. -

-

- Here are Windows command-line examples for Postscript and PCL: -

- - -

- Here is some Java code to accomplish the task in UNIX: -

- -

- Set the output MIME type to "application/x-pcl" (MimeConstants.MIME_PCL) and - it happily sends the PCL to the UNIX printer queue. -

-
-
-
- PDF -

- PDF is the best supported output format. It is also the most accurate - with text and layout. This creates a PDF document that is streamed out - as each page is rendered. This means that the internal page index - information is stored near the end of the document. - The PDF version supported is 1.4. PDF versions are forwards/backwards - compatible. -

-

- Note that FOP does not currently support PDF/A-1a. - Support for Tagged PDF, PDF/A-1b - and PDF/X has recently been added, however. -

-
- Fonts -

- PDF has a set of fonts that are always available to all PDF viewers; - to quote from the PDF Specification: - - "PDF prescribes a set of 14 standard fonts that can be used without prior - definition. - These include four faces each of three Latin text typefaces (Courier, - Helvetica, and Times), as well as two symbolic fonts (Symbol and ITC Zapf - Dingbats). These fonts, or suitable substitute fonts with the same metrics, are - guaranteed to be available in all PDF viewer applications." -

-
-
- Post-processing -

- FOP does not currently support several desirable PDF features: watermarks and signatures. - One workaround is to use Adobe Acrobat (the full version, not the Reader) to process - the file manually or with scripting that it supports. -

-

- Another popular post-processing tool is iText, - which has tools for adding security features, document properties, watermarks, and many - other features to PDF files. -

- - Caveat: iText may swallow PDF bookmarks. But - Jens Stavnstrup tells us - that this doesn't happen if you use iText's PDFStamper. - -

- Here is some sample code that uses iText to encrypt a FOP-generated PDF. (Note that FOP now - supports PDF encryption. However the principles for using - iText for other PDF features are similar.) -

- -

- Check the iText tutorial and documentation for setting access flags, password, - encryption strength and other parameters. -

-
-
- Watermarks -

- In addition to the PDF Post-processing options, consider the following workarounds: -

-
    -
  • - Use a background image for the body region. -
    • -
  • - (submitted by Trevor Campbell) Place an image in a - region that overlaps the flowing text. For example, make - region-before large enough to contain your image. Then include a - block (if necessary, use an absolutely positioned block-container) - containing the watermark image in the static-content for the - region-before. Note that the image will be drawn on top of the - normal content. -
    • -
-
-
- Extensions -

The PDF Renderer supports some PDF specific extensions which can be embedded - into the input FO document. To use the extensions the appropriate namespace must - be declared in the fo:root element like this:

- - ]]> -
- Embedded Files -

- It is possible to attach/embed arbitrary files into a PDF file. You can give a name and - a description of the file. Example: -

- - - - - ]]> -

- pdf:embedded-file must be a child of fo:declarations. - The "src" property is used to reference the file that is to be embedded. This property - uses the "uri-specification" datatype from the XSL-FO specification. - The "filename" property is optional. If it is missing the filename is automatically set - from the URI/IRI of the "src" property. An optional description can also be added to - further describe the file attachment. -

-

- It is also possible to reference an embedded file from an fo:basic-link. - Use the special "embedded-file:" URI scheme with the filename as single argument after - the URI scheme. Example: -

- Attached Image -]]> -

- Note: Not all PDF Viewers (including some Acrobat Versions) will open the embedded file - when clicking on the link. In that case, the user will have to open he attachment via - the separate list of file attachments. -

-
-
-
-
- PostScript -

- The PostScript renderer has been brought up to a similar quality as the - PDF renderer, but may still be missing certain features. It provides good - support for most text and layout. - Images and SVG are not fully supported, yet. Currently, the PostScript - renderer generates PostScript Level 3 with most DSC comments. Actually, - the only Level 3 features used are the FlateDecode and DCTDecode - filter (the latter is used for 1:1 embedding of JPEG images), everything - else is Level 2. -

-
- Configuration -

- The PostScript renderer configuration currently allows the following settings: -

- - false - 3 - false - false - true - quality -]]> -

- The default value for the "auto-rotate-landscape" setting is "false". Setting it - to "true" will automatically rotate landscape pages and will mark them as landscape. -

-

- The default value for the "language-level" setting is "3". This setting specifies - the PostScript language level which should be used by FOP. Set this to "2" - only if you don't have a Level 3 capable interpreter. -

-

- The default value for the "optimize-resources" setting is "false". Setting it - to "true" will produce the PostScript file in two steps. A temporary file will be - written first which will then be processed to add only the fonts which were really - used and images are added to the stream only once as PostScript forms. This will - reduce file size but can potentially increase the memory needed in the interpreter - to process. -

-

- The default value for the "safe-set-page-device" setting is "false". Setting it - to "true" will cause the renderer to invoke a postscript macro which guards against - the possibility of invalid/unsupported postscript key/values being issued to the - implementing postscript page device. -

-

- The default value for the "dsc-compliant" setting is "true". Setting it - to "false" will break DSC compliance by minimizing the number of setpagedevice - calls in the postscript document output. This feature may be useful when unwanted - blank pages are experienced in your postscript output. This problem is caused by - the particular postscript implementation issuing unwanted postscript subsystem - initgraphics/erasepage calls on each setpagedevice call. -

-

- The default value for the "rendering" setting is "quality". Setting it to "size" - optimizes rendering for smaller file sizes which can involve minor compromises in - rendering quality. For example, solid borders are then painted as plain rectangles - instead of the elaborate painting instructions required for mixed-color borders. -

-
-
- Limitations -
    -
  • Images and SVG may not be displayed correctly. SVG support is far from being complete. No image transparency is available.
    • -
  • PPD support is still missing.
    • -
-
-
-
- PCL -

- This format is for the Hewlett-Packard PCL printers and other printers - supporting PCL. It should produce output as close to identical as possible - to the printed output of the PDFRenderer within the limitations of the - renderer, and output device. -

-

- The output created by the PCLRenderer is generic PCL 5, HP GL/2 and PJL. - This should allow any device fully supporting PCL 5 to be able to - print the output generated by the PCLRenderer. PJL is used to control the - print job and switch to the PCL language. PCL 5 is used for text, raster - graphics and rectangular fill graphics. HP GL/2 is used for more complex - painting operations. Certain painting operations are done off-screen and - rendered to PCL as bitmaps because of limitations in PCL 5. -

-
- References - -
-
- Limitations -
    -
  • - Text or graphics outside the left or top of the printable area are not - rendered properly. This is a limitation of PCL, not FOP. In general, - things that should print to the left of the printable area are shifted - to the right so that they start at the left edge of the printable area. -
    • -
  • - The Helvetica and Times fonts are not well supported among PCL printers - so Helvetica is mapped to Arial and Times is mapped to Times New. This - is done in the PCLRenderer, no changes are required in the FO's. The - metrics and appearance for Helvetica/Arial and Times/Times New are - nearly identical, so this has not been a problem so far. -
    • -
  • For the non-symbol fonts, the ISO 8859-1 symbol set is used (PCL set "0N").
    • -
  • - All fonts available to the Java2D subsystem are usable. The texts are - painted as bitmap much like the Windows PCL drivers do. -
    • -
  • Multibyte characters are not supported.
    • -
  • - At the moment, only monochrome output is supported. PCL5c color extensions - will only be implemented on demand. Color and grayscale images are converted - to monochrome bitmaps (1-bit). Dithering only occurs if the JAI image library - is available. -
    • -
  • - Images are scaled up to the next resolution level supported by PCL (75, - 100, 150, 200, 300, 600 dpi). For color and grayscale images an even - higher PCL resolution is selected to give the dithering algorithm a chance - to improve the bitmap quality. -
    • -
  • - Currently, there's no support for clipping and image transparency, largely - because PCL 5 has certain limitations. -
    • -
-
-
- Configuration -

- The PCL renderer configuration currently allows the following settings: -

- - quality - bitmap - false -]]> -

- The default value for the "rendering" setting is "speed" which causes borders - to be painted as plain rectangles. In this mode, no special borders (dotted, - dashed etc.) are available. If you want support for all border modes, set the - value to "quality" as indicated above. This will cause the borders to be painted - as bitmaps. -

-

- The default value for the "text-rendering" setting is "auto" which paints the - base fonts using PCL fonts. Non-base fonts are painted as bitmaps through Java2D. - If the mix of painting methods results in unwelcome output, you can set this - to "bitmap" which causes all text to be rendered as bitmaps. -

-

- The default value for the "disable-pjl" setting is "false". This means that - the PCL renderer usually generates PJL commands before and after the document - in order to switch a printer into PCL language. PJL commands can be disabled - if you set this value to "true". -

-

- You can control the output resolution for the PCL using the "target resolution" - setting on the FOUserAgent. The actual value will be rounded up to the next - supported PCL resolution. Currently, only 300 and 600 dpi are supported which - should be enough for most use cases. Note that this setting directly affects - the size of the output file and the print quality. -

-
-
- Extensions -

The PCL Renderer supports some PCL specific extensions which can be embedded - into the input FO document. To use the extensions the appropriate namespace must - be declared in the fo:root element like this:

- -]]> -
- Page Source (Tray selection) -

- The page-source extension attribute on fo:simple-page-master allows to - select the paper tray the sheet for a particular simple-page-master is - to be taken from. Example: -

- - - ... - - -]]> -

- Note: the tray number is a positive integer and the value depends on - the target printer. Not all PCL printers support the same paper trays. - Usually, - "1" is the default tray, - "2" is the manual paper feed, - "3" is the manual envelope feed, - "4" is the "lower" tray and - "7" is "auto-select". - Consult the technical reference for your printer for all available values. -

-
-
- Output Bin -

- The output-bin extension attribute on fo:simple-page-master allows to - select the output bin into which the printed output should be fed. Example: -

- - - ... - - -]]> -

- Note: the output bin number is a positive integer and the value depends on - the target printer. Not all PCL printers support the same output bins. - Usually, - "1" is the upper output bin, - "2" is the lower (rear) output bin. - Consult the technical reference for your printer for all available values. -

-
-
- Page Duplex Mode -

- The duplex-mode extension attribute on fo:simple-page-master allows to - select the duplex mode to be used for a particular simple-page-master. - Example: -

- - - ... - - -]]> -

- Note: the duplex is a positive integer and the value depends on - the target printer. Not all PCL printers support duplexing. - Usually, - "0" is simplex, - "1" is duplex (long-edge binding), - "2" is duplex (short-edge binding). - - Consult the technical reference for your printer for all available values. -

-
-
-
-
- AFP -

- The FOP AFP Renderer deals with creating documents conforming to the IBM AFP document architecture - also refered to as MO:DCA (Mixed Object Document Content Architecture). -

-

- The mapping of XSL-FO elements to the major MO:DCA structures is as follows: -

- - - - - - - - - - - - - - - - - -
XSL-FO elementMO:DCA-P object
fo:rootDocument
fo:page-sequencePage Group
fo:simple-page-masterPage
-

- FOP creates exactly one Document per Printfile with an optional Resource Group at the - beginning. FOP does not create document indices. -

-
- References - -
-
- Limitations -

This list is most likely badly incomplete.

-
    -
  • - Clipping of text and graphics is not supported. -
    • -
  • - Only IBM outline and raster fonts and to a limited extend the original fonts built into FOP are supported. - Support for TrueType fonts may be added later. -
    • -
-
-
- Deployment in older environments -

- There are still a big number of older (or limited) MO:DCA/IPDS environments in production - out there. AFP has grown in functionality over time and not every environment supports the - latest features. We're trying to make AFP output work in as many environments as possible. - However, to make AFP output work on older environments it is recommended to set to - configuration to 1 bit per pixel (see below on how to do this). In this case, all images - are converted to bi-level images using IOCA function set 10 (FS10) and are enclosed in - page-segments since some implementation cannot deal with IOCA objects directly. - If a higher number of bits per pixel is configured, FOP has to switch to at least FS11 - which may not work everywhere. -

-
-
- Configuration -
- Fonts -

The AFP Renderer requires special configuration particularly related to fonts. - AFP Render configuration is done through the normal FOP configuration file. The MIME type - for the AFP Renderer is application/x-afp which means the AFP Renderer section in the FOP configuration file - looks like:

- - - ... -]]> -

There are 4 font configuration variants supported:

-
    -
  1. IBM Raster fonts
    2. -
  2. IBM Outline fonts
    3. -
  3. IBM CID-keyed (Type 0) fonts
    4. -
  4. FOP built-in Base14 fonts
    5. -
-

A typical raster font configuration looks like:

- - - - - - - - - - - - - - - - - - - - - - - - ]]> -

An outline font configuration is simpler as the individual font size entries are not required. - However, the characterset definition is now required within the afp-font element.

- - - - - - -]]> -

- If "base-uri" is missing or a relative URI, the fonts are resolved relative to - the font base URI specified in the configuration (or on the FopFactory). -

- - Previously, the location of the font files was given by the "path" attribute. This is still - supported for the time being, but you should move to using the more flexible "base-uri" - attribute so you can profit from the power of URI resolvers. - -

A CID-keyed font (Type 0, double-byte outline font) configuration is much the same as an outline font. - However, the characterset definition is now required within the afp-font element.

- - - - -]]> -

-Note that the value of the encoding attribute in the example is the double-byte encoding 'UnicodeBigUnmarked' (UTF-16BE). -

-

Experimentation has shown that the font metrics for the FOP built-in Base14 fonts are actually - very similar to some of the IBM outline and raster fonts. In cases were the IBM font files are not - available the base-uri attribute in the afp-font element can be replaced by a base14-font attribute - giving the name of the matching Base14 font. In this case the AFP Renderer will take the - font metrics from the built-in font.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ]]> -

- By default, all manually configured fonts are embedded, unless they are matched in the - referenced-fonts section of the configuration file. - However, the default fonts shown above will not be embedded. -

-

- For double byte EBCDIC encoded character sets, there is an optional tag that must be set to prevent - characters from being miscoded. This defaults to "false" if not specified.

- ]]> - -
-
- Output Resolution -

By default the AFP Renderer creates output with a resolution of 240 dpi. - This can be overridden by the <renderer-resolution/> configuration element. Example:

- 240]]> -
-
- Line Width Correction -

The default line width in AFP is device dependent. This means that a line width specified in, say, - a SVG source file may not render the way it was intended. The output AFP line with can be corrected - by the <line-width-correction/> configuration element. Example:

- 2.5]]> -
-
- Images -

By default the AFP Renderer converts all images to 8 bit grey level. - This can be overridden by the <images/> configuration element. Example:

- -]]> -

This will put images as RGB images into the AFP output stream. The default setting is:

- -]]> -

Only the values "color" and "b+w" are allowed for the mode attribute.

-

The bits-per-pixel attribute is ignored if mode is "color". For "b+w" mode is must be 1, 4, or 8.

- -]]> -

When the native attribute is specified and set to "true", all image resources will be natively injected - into the datastream using an object container rather than being converted into an IOCA FS45 image. - Support for native image formats (e.g. JPEG, TIFF, GIF) is not always available on printer implementations - so by default this configuration option is set to "false".

-

- Setting cmyk="true" on the images element will enable CMYK - colors. This will only have an effect if the color mode is set to "color". Example: -

- ]]> -

- When the color mode is set to 1 bit (bi-level), the "dithering-quality" attribute can - be used to select the level of quality to use when converting images to bi-level images. - Valid values for this attribute are floating point numbers from 0.0 (fastest) to - 1.0 (best), or special values: "minimum" (=0.0), "maximum" (1.0), - "medium" (0.5, the default). For the higher settings to work as expected, JAI needs to - be present in the classpath. If JAI is present, 0.0 results in a minimal darkness-level - switching between white and black. 0.5 does bayer-based dithering and 1.0 will use - error-diffusion dithering. The higher the value, the higher the quality and the slower - the processing of the images. -

- ]]> -

- When the boolean attribute pseg (default false) is set to true, non-inline FS11 and FS45 IOCA images are wrapped in page segment. - This option is provided to support printers/print servers that require this MO:DCA structure. -

- ]]> -

- Setting the boolean attribute fs45 to true (default false) will force all images to FS45. -

- ]]> -

- By default, JPEG images are rasterized to a bitmap and the bitmap is included in the AFP doc. - However it is possible to encode in a lossless way to maintain maximum quality. But due - to lack of support for compression schemes like LZW (patent concerns), bitmap data is currently - not compressed resulting in large AFP files. Using the "allow-embedding" attribute on jpeg child - element allows the user to pass the JPEG as is in the document. The default is set to "false" since - there are compatibility concerns as some AFP printers don't support JPEG decoding. Using the - "bitmap-encoding-quality" attribute it is possible to enable lossy compression (JPEG baseline - DCT). The default is "1.0" which means lossless encoding. Setting a value lower than 1.0, JPEG - compression is enabled and the setting is used as the quality setting when encoding bitmap data. - Note that this setting does not always have an effect. Bi-level (1 bit) bitmaps are not compressed - using JPEG. Example: -

- - - ]]> -
-
- GOCA (Vector Graphics) -

- Not all AFP implementations support GOCA. Some also have bugs related to GOCA. Therefore, - it is desirable to have some control over the generation of GOCA graphics. -

-

- GOCA is enabled by default. You can disable GOCA entirely in which case the AFP support - falls back to generating bitmaps for vector graphics. Example: -

- ]]> -

- Some AFP implementations have trouble rendering text in GOCA. You can instruct the AFP - support to render text as shapes (i.e. use vector graphics to paint text). Example: -

- ]]> -

- If you disable GOCA or let text render as shapes, the size of the generated AFP usually - increases considerably. -

-
-
- Shading -

- By default, filled rectangles are painted using their given color using a PTOCA I-axis rule - (DIR). But not all environments handle these colors correctly. That's why a setting is - supported that paints the rectangles using an ordered dither pattern (bi-level) with - an inline IOCA FS10 image that is used together with the "replicate and trim" mapping. - The optional "shading" element can be used to control the shading mode. Its default value - is "color". To enable the dithered mode, use "dithered". Example: -

- dithered -]]> -
-
- Resource Group File -

By default the AFP Renderer will place all data resource objects such as images within - the document of the main output datastream. An external resource group file where document resources - may be specified with the <resource-group-file/> configuration element. Example:

- external_resources.afp -]]> - Be careful when using this option not to overwrite existing resource files from previous rendering runs. -
-
- Resource Level Defaults -

- By default, bitmap image objects (or page segments derived from them) are put in the - print-file-level resource group and GOCA graphics are inlined for compatibility with - the AFP Workbench tool. -

-

- It is possible to override these defaults, either per image (see the - afp:resource-level - extension attribute below) or by specifying different defaults in the configuration: -

- ]]> -

- "goca" refers to GOCA graphics and "bitmap" refers to IOCA images. The possible values - for the attributes are "inline" and "print-file". In the future, - additional possibilities may be added. -

-
-
-
- Extensions -

The AFP Renderer supports some AFP specific extensions which can be embedded into the input - fo document. To use the extensions the appropriate namespace must be declared in the fo:root element like this:

- -]]> -
- Page Overlay (IPO) Extension -

The include-page-overlay extension element allows to define on a per simple-page-master basis a page overlay resource. Example:

- - - - ... - - -]]> -

The mandatory name attribute must refer to an 8 character (space padded) resource name that - must be known in the AFP processing environment. Optional x and y attributes can be specified - to place the Overlay at an offset from the top left of the page.

-
-
- Page Segment (IPS) Extension -

The include-page-segment extension element allows to define resource substitution for fo:external-graphics elements. - Example:

- - - - - - - -]]> -

The include-page-segment extension element can only occur within a simple-page-master. - Multiple include-page-segment extension elements within a simple-page-master are allowed. - The mandatory name attribute must refer to an 8 character - (space padded) resource name that must be known in the AFP processing environment. - The value of the mandatory src attribute is compared against the value of the src attribute in - fo:external-graphic elements and if it is identical (string matching is used) in the generated - AFP the external graphic is replaced by a reference to the given resource. -

-

- The effect here is that whenever FOP encounters the URI specified in the extension, - it will effectively generate code to include the page segment with the given name - instead of embedding the image referenced by the URI. The URI is still required as - the underlying image serves as a provider for the intrinsic size of the image - (At the moment, FOP is unable to extract the intrinsic size of the page segment from - an AFP resource file). For the image to appear in an AFP viewer or to be printed, the - AFP resource must be available on the target device. FOP does not embed the page - segment in the generated file. Please also note that page segments cannot be scaled. - They are always rendered in their intrinsic size. -

-

- The include-page-segment extension element has the optional attribute - resource-file. The value of this is a URI to a resource containing a page - segment with the declared name. In this case FOP embeds the page segment into the - generated document so that the external resource does not have to be supplied in the - print job. -

-
-
- Tag Logical Element (TLE) Extension -

The tag-logical-element extension element allows to injects TLEs into the AFP output stream. Example:

- - - - - - - - [..] - - - - [..] -]]> -

- The tag-logical-element extension element can appear within a simple-page-master - (page level) or it can appear as child of page-sequence (page group level). - Multiple tag-logical-element extension elements within a simple-page-master or - page-sequence are allowed. The name and value attributes are mandatory. The encoding attribute specifying a CCSID encoding is optional. -

-
-
- No Operation (NOP) Extension -

The no-operation extension provides the ability to carry up to 32K of comments or any other type - of unarchitected data into the AFP output stream. Example:

- - - - insert up to 32k of character data here! - - -]]> -

The no-operation extension element can appear as child of - simple-page-master (appears after "Begin Page" BPG), - page-sequence (appears after "Begin Named Page Group" BNG - and declarations (appears after "Begin Document" BDT). - Multiple no-operation extension elements inside the same formatting object are allowed. - Each NOP will appear right after the respective "Begin" field indicated above even if it - is specified as the last child under its parent. The order inside the parent - will be maintained. - The "placement" attribute can be used to have the NOP appear before - the "End" field of the object rather than after the "Begin" field. Specify - placement="before-end" to do that. Please note that, at the moment, this only - has an effect for NOPs that are children of the page-sequence formatting - object. - The "name" attribute is mandatory but will not appear inside the AFP stream. -

-
-
- Invoke Medium Map (IMM) Extension -

- The invoke-medium-map extension allows to generate IMM fields (Invoke Medium Map) in the - generated AFP output. Example: -

- - [..] - - - - [..] -]]> -

- The invoke-medium-map element is allowed as child of fo:page-sequence (page group - level) or fo:simple-page-master. It is NOT supported on document level (fo:root), yet. - FOP also doesn't support specifying medium maps inside XML (using BMM/EMM). It can - only reference an existing medium map by name. The medium map has to be constructed - through different means and available on the target platform. -

-
-
- Form Maps/Defs -

- Apache FOP supports embedding an external form map resource in the - generated AFP output. This is done using the afp:include-form-map - extension. An example: -

- - [..] - - - -]]> -

- The afp:include-form-map is to be placed as a direct child of - fo:declarations. The name is an AFP resource name - (max. 8 characters) and the src attribute is the URI identifying the - external form map resource. When such a form map is embedded, you can use the - afp:invoke-medium-map extension (described above) to invoke any medium - map included in the form map. -

- - Apache FOP doesn't support a way to define a form map or medium map using XML means - inside an XSL-FO document. You will have to build the form map with some third-party - tool. - -
-
-
- Foreign Attributes -
- Resource -

The resource foreign attributes provides the ability to name and control where data object resources - (e.g. images/scalable vector graphics) will reside in the AFP output. - The afp foreign attributes are only used in conjuntion with <fo:external-graphic/> and <instream-foreign-object/>. - Example:

- - ... - - - - - - - - - - - - - - -]]> -

The resource-level attribute where the resource object will reside in the AFP output datastream. - The possible values for this are "inline", "print-file" and "external". - When "external" is used a resource-group-file attribute must also be specified. - Please refer to the Resource Level Defaults - above to see what is used if the resource-level attribute is not specified. -

-

-

-
-
-
- RTF -

- JFOR, an open source XSL-FO to RTF converter has been integrated into Apache FOP. - This will create an RTF (rich text format) document that will - attempt to contain as much information from the XSL-FO document as - possible. It should be noted that is not possible (due to RTF's limitations) to map all - XSL-FO features to RTF. For complex documents, the RTF output will never reach the feature - level from PDF, for example. Thus, using RTF output is only recommended for simple documents - such as letters. -

-

- The RTF output follows Microsoft's RTF specifications - and produces best results on Microsoft Word. -

- RTF output is currently unmaintained and lacks many features compared to other output - formats. Using other editable formats like Open Document Format, instead of producing XSL-FO - then RTF through FOP, might give better results. -

- These are some known restrictions compared to other supported output formats (not a complete list): -

-
    -
  • - Not supported/implemented: -
      -
    • break-before/after (supported by the RTF library but not tied into the RTFHandler)
      • -
    • fo:page-number-citation-last
      • -
    • keeps (supported by the RTF library but not tied into the RTFHandler)
      • -
    • region-start/end (RTF limitation)
      • -
    • multiple columns
      • -
    -
    • -
  • Only a single page-master is supported
    • -
  • Not all variations of fo:leader are supported (RTF limitation)
    • -
  • percentages are not supported everywhere
    • -
-
-
- XML (Area Tree XML) -

- This is primarily for testing and verification. The XML created is simply - a representation of the internal area tree put into XML. We use that to verify - the functionality of FOP's layout engine. -

-

- The other use case of the Area Tree XML is as FOP's "intermediate format". More information - on that can be found on the page dedicated to the Intermediate Format. -

-
-
- Java2D/AWT -

- The Java2DRenderer provides the basic functionality for all - Java2D-based output formats (AWT viewer, direct print, PNG, TIFF). -

-

- The AWT viewer shows a window with the pages displayed inside a - Java graphic. It displays one page at a time. - The fonts used for the formatting and viewing depend on the fonts - available to your JRE. -

-
-
- Print -

- It is possible to directly print the document from the command line. - This is done with the same code that renders to the Java2D/AWT renderer. -

- -
-
- Bitmap (TIFF/PNG) -

- It is possible to directly create bitmap images from the individual - pages generated by the layout engine. - This is done with the same code that renders to the Java2D/AWT renderer. -

-

- Currently, two output formats are supported: PNG and TIFF. TIFF produces - one file with multiple pages, while PNG output produces one file per - page. Note: FOP can only produce multiple files (with PNG output) if - you can set a java.io.File indicating the primary PNG file - using the FOUserAgent.setOutputFile(File) method. -

-

- The quality of the bitmap depends on the target resolution setting - on the FOUserAgent and on further settings described below. -

-
- Configuration -

- The TIFF and PNG renderer configuration currently allows the following settings: -

- - rgba - true - white - true - quality - -]]> -

- The default value for the "color-mode" setting is "rgba" which - is equivalent to a 24bit RGB image with an 8bit alpha channel for transparency. - Valid values are: -

-
    -
  • rgba: RGB with alpha channel (24bit + 8bit = 32bit)
    • -
  • rgb: RGB (24bit)
    • -
  • gray: gray (8bit)
    • -
  • bi-level (or binary): bi-level (1bit)
    • -
-

- Please note that there is currently no dithering or error diffusion available for bi-level - bitmap output. -

-

- The default value for the "transparent-page-background" setting is - "false" which paints an opaque, white background for the whole image. - If you set this to "true", - no such background will be painted and you will get a transparent image if - an alpha channel is available in the output format. -

-

- The default value for the "background-color" setting is "white". - The color specifies in which color the page background is painted. It will only be - painted if "transparent-page-background" is not set to "true". - All XSL-FO colors (including color functions) can be used. -

-

- The default value for the "anti-aliasing" setting is "true". - You can set this value to "false" to disable anti-aliasing and - thus improve rendering speeds a bit at the loss of some image quality. -

-

- The default value for the "rendering" setting is "true". - You can set this value to "false" to improve rendering speeds a bit - at the loss of some image quality. If this setting has an actual effect depends - on the JVM's Java2D backend. -

-
-
- TIFF-specific Configuration -

- In addition to the above values the TIFF renderer configuration allows some additional - settings: -

- - true - CCITT T.6 - true - default - -]]> -

- The default value for the "compression" setting is "PackBits" which - which is a widely supported RLE compression scheme for TIFF. The set of compression - names to be used here matches the set that the Image I/O API uses. Note that - not all compression schemes may be available during runtime. This depends on the - actual codecs being available. Here is a list of possible values: -

-
    -
  • NONE (no compression)
    • -
  • PackBits (RLE, run-length encoding)
    • -
  • JPEG
    • -
  • Deflate
    • -
  • LZW
    • -
  • ZLib
    • -
  • CCITT T.4 (Fax Group 3)
    • -
  • CCITT T.6 (Fax Group 4)
    • -
-

- This setting may override any setting made using the "color-mode". For example, if - "CCITT T.6" is selected, the color mode is automatically forced to "bi-level" because - this compression format only supports bi-level images. -

- - If you want to use CCITT compression, please make sure you've got - - Java Advanced Imaging Image I/O Tools - - in your classpath. The Sun JRE doesn't come with a TIFF codec built in, so it has to be - added separately. The internal TIFF codec from XML Graphics Commons only supports PackBits, - Deflate and JPEG compression for writing. - -

- The default value for the "single-strip" is "false" resulting in the RowsPerStrip Tiff Tag equal to the number of rows. - If set to true RowsPerStrip is set to 1. -

-

- The default value for "endianness" is "default", which results in the - default endianness for the output format being generated. Note that not all image formats allow - specifying the endianness. -

-
-
- Runtime Rendering Options -

- The IF-based bitmap output implementations support a rendering option with the key - "target-bitmap-size" (value: java.awt.Dimension) that allows to force the pages to - be proportionally fit into a bitmap of a given size. This can be used to produce - thumbnails or little preview images of the individual pages. An example: -

- -
-
-
- TXT -

- The text renderer produces plain ASCII text output - that attempts to match the output of the PDFRenderer as closely as - possible. This was originally developed to accommodate an archive system - that could only accept plain text files, and is primarily useful for getting - a quick-and-dirty view of the document text. The renderer is very limited, - so do not be surprised if it gives unsatisfactory results. -

- -

- Because FOP lays the text onto a grid during layout, there are frequently - extra or missing spaces between characters and lines, which is generally - unsatisfactory. - Users have reported that the optimal settings to avoid such spacing problems are: -

-
    -
  • font-family="Courier"
    • -
  • font-size="10pt"
    • -
  • line-height="10pt"
    • -
-
-
- Output Formats in the Sandbox -

- Due to the state of certain renderers we moved some of them to a "sandbox" area until - they are ready for more serious use. The renderers and FOEventHandlers in the sandbox - can be found under src/sandbox and are compiled into build/fop-sandbox.jar during the - main build. The output formats in the sandbox are marked as such below. -

-
- MIF - The MIF handler is in the sandbox and not yet functional in FOP Trunk!!! Please help us ressurrect this feature. -

- This format is the Maker Interchange Format which is used by - Adobe Framemaker. -

-
-
- SVG - The SVG renderer is in the sandbox and may not work as expected in FOP Trunk!!! Please help us improve this feature. -

- This format creates an SVG document that has links between the pages. - This is primarily for slides and creating svg images of pages. - Large documents will create SVG files that are far too large for - an SVG viewer to handle. Since FO documents usually have text the - SVG document will have a large number of text elements. - The font information for the text is obtained from the JVM in the - same way as for the AWT viewer. If the SVG is viewed on a - system where the fonts are different, such as another platform, - then the page may look wrong. -

-
-
-
- Wish list -

- Apache FOP is easily extensible and allows you to add new output formats to enhance FOP's functionality. There's a number of output formats - which are on our wish list. We're looking for volunteers to help us implement them. -

- -
- - - diff --git a/src/documentation/content/xdocs/trunk/pdfa.xml b/src/documentation/content/xdocs/trunk/pdfa.xml deleted file mode 100644 index 0b8399121..000000000 --- a/src/documentation/content/xdocs/trunk/pdfa.xml +++ /dev/null @@ -1,168 +0,0 @@ - - - - - -
- Apache™ FOP: PDF/A (ISO 19005) - $Revision$ - - - -
- -
- Overview -

- PDF/A is a standard which turns PDF into an "electronic document file - format for long-term preservation". PDF/A-1 is the first part of the - standard and is documented in - ISO 19005-1:2005(E). - Work on PDF/A-2 is in progress at - AIIM. -

-

- Design documentation on PDF/A can be found on FOP's Wiki on the - PDFA1ConformanceNotes page. -

-
-
- Implementation Status -

- PDF/A-1b is implemented to the degree that FOP supports - the creation of the elements described in ISO 19005-1. -

-

- Tests have been performed against jHove and Adobe Acrobat 7.0.7 (Preflight function). - FOP does not validate completely against Apago's PDF Appraiser. Reasons unknown due to - lack of a full license to get a detailed error protocol. -

-

- PDF/A-1a is based on PDF-A-1b and adds accessibility features - (such as Tagged PDF). This format is available within the limitation described on - the Accessibility page. -

-
-
- Usage (command line) -

- To activate PDF/A-1b from the command-line, specify "-pdfprofile PDF/A-1b" - as a parameter. If there is a violation of one of the validation rules for - PDF/A, an error message is presented and the processing stops. -

-

- PDF/A-1a is enabled by specifying "-pdfprofile PDF/A-1a". -

-
-
- Usage (embedded) -

- When FOP is embedded in another Java application you can set a special option - on the renderer options in the user agent to activate the PDF/A-1b profile. - Here's an example: -

- -

- If one of the validation rules of PDF/A is violated, an PDFConformanceException - (descendant of RuntimeException) is thrown. -

-

- For PDF/A-1a, just use the string "PDF/A-1a" instead of "PDF/A-1b". -

-
-
- PDF/A in Action -

- There are a number of things that must be looked after if you activate a PDF/A - profile. If you receive a PDFConformanceException, have a look at the following - list (not necessarily comprehensive): -

-
    -
  • - Make sure all (!) fonts are embedded. If you use base 14 fonts (like Helvetica) - you need to obtain a license for them and embed them like any other font. -
    • -
  • - Don't use PDF encryption. PDF/A doesn't allow it. -
    • -
  • - Don't use CMYK images without an ICC color profile. PDF/A doesn't allow mixing - color spaces and FOP currently only properly supports the sRGB color space. Please - note that FOP embeds a standard sRGB ICC profile (sRGB IEC61966-2.1) as the - primary output intent for the PDF if no other output intent has been specified - in the configuration. -
    • -
  • - Don't use non-RGB colors in SVG images. Same issue as with CMYK images. -
    • -
  • - Don't use EPS graphics with fo:external-graphic. Embedding EPS graphics in PDF - is deprecated since PDF 1.4 and prohibited by PDF/A. -
    • -
  • - PDF is forced to version 1.4 if PDF/A-1 is activated. -
    • -
  • - No filter must be specified explicitely for metadata objects. Metadata must be - embedded in clear text so non-PDF-aware applications can extract the XMP metadata. -
    • -
- - There are additional requirements if you want to enabled PDF/A-1a (Tagged PDF). This is - particularly the specification of the natural language and alternative descriptions for - images. Please refer to the Accessibility page for details. - -
-
- PDF profile compatibility -

- The PDF profiles "PDF/X-3:2003" and "PDF/A-1b" (or "PDF/A-1a") are compatible and can - both be activated at the same time. -

-
-
- Interoperability -

- There has been some confusion about the namespace for the PDF/A indicator in the XMP - metadata. At least three variants have been seen in the wild: -

- - - - - - - - - - - - - -
http://www.aiim.org/pdfa/ns/id.htmlobsolete, from an early draft of ISO-19005-1, used by Adobe Acrobat 7.x
http://www.aiim.org/pdfa/ns/idobsolete, found in the original ISO 19005-1:2005 document
http://www.aiim.org/pdfa/ns/id/correct, found in the technical corrigendum 1 of ISO 19005-1:2005
-

- If you get an error validating a PDF/A file in Adobe Acrobat 7.x it doesn't mean that - FOP did something wrong. It's Acrobat that is at fault. This is fixed in Adobe Acrobat 8.x - which uses the correct namespace as described in the technical corrigendum 1. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/trunk/pdfencryption.xml b/src/documentation/content/xdocs/trunk/pdfencryption.xml deleted file mode 100644 index 2d8fdfb10..000000000 --- a/src/documentation/content/xdocs/trunk/pdfencryption.xml +++ /dev/null @@ -1,301 +0,0 @@ - - - - - -
- Apache™ FOP: PDF encryption. - $Revision$ - - - - -
- -
- Overview -

- Apache™ FOP supports encryption of PDF output, thanks to Patrick - C. Lankswert. This feature is commonly used to prevent - unauthorized viewing, printing, editing, copying text from the - document and doing annotations. It is also possible to ask the - user for a password in order to view the contents. Note that - there already exist third party applications which can decrypt - an encrypted PDF without effort and allow the aforementioned - operations, therefore the degree of protection is limited. -

-

- For further information about features and restrictions regarding PDF - encryption, look at the documentation coming with Adobe Acrobat or the - technical documentation on the Adobe web site. -

-
-
- Usage (command line) -

- Encryption is enabled by supplying any of the encryption related - options. -

-

- An owner password is set with the -o option. This - password is actually used as encryption key. Many tools for - PDF processing ask for this password to disregard any - restriction imposed on the PDF document. -

-

- If no owner password has been supplied but FOP was asked to apply some - restrictions, a random password is used. In this case it is obviously - impossiible to disregard restrictions in PDF processing tools. -

-

- A user password, supplied with the -u option, will - cause the PDF display software to ask the reader for this password in - order to view the contents of the document. If no user password was - supplied, viewing the content is not restricted. -

-

- Further restrictions can be imposed by using the following command-line options: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OptionDescription
-noprintdisable printing
-nocopydisable copy/paste of content
-noeditdisable editing in Adobe Acrobat
-noannotationsdisable editing of annotations
-nofillinformsdisable filling in forms
-noaccesscontentdisable text and graphics extraction for accessibility purposes
-noassembledocdisable assembling documents
-noprinthqdisable high quality printing
-

-
-
- Usage (embedded) -

- When FOP is embedded in another Java application you need to set an - options map on the renderer. These are the supported options: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OptionDescriptionValuesDefault
encryption-lengthThe encryption length in bitAny multiple of 8 between 40 and 12840
ownerPasswordThe owner passwordString -
userPasswordThe user passwordString -
allowPrintAllows/disallows printing of the PDF"TRUE" or "FALSE""TRUE"
allowCopyContentAllows/disallows copy/paste of content"TRUE" or "FALSE""TRUE"
allowEditContentAllows/disallows editing in Adobe Acrobat"TRUE" or "FALSE""TRUE"
allowEditAnnotationsAllows/disallows editing of annotations"TRUE" or "FALSE""TRUE"
allowFillInFormsAllows/disallows filling in forms"TRUE" or "FALSE""TRUE"
allowAccessContentAllows/disallows text and graphics extraction for accessibility purposes"TRUE" or "FALSE""TRUE"
allowAssembleDocumentAllows/disallows assembling document"TRUE" or "FALSE""TRUE"
allowPrintHqAllows/disallows high quality printing"TRUE" or "FALSE""TRUE"
- - Encryption is enabled as soon as one of these options is set. - -

- An example to enable PDF encryption in Java code: -

- -

- The parameters for the constructor of PDFEncryptionParams are: -

-
    -
  1. userPassword: String, may be null
    2. -
  2. ownerPassword: String, may be null
    3. -
  3. allowPrint: true if printing is allowed
    4. -
  4. allowCopyContent: true if copying content is allowed
    5. -
  5. allowEditContent: true if editing content is allowed
    6. -
  6. allowEditAnnotations: true if editing annotations is allowed
    7. -
  7. allowFillInForms: true if filling in forms is allowed.
    8. -
  8. allowAccessContent: true if extracting text and graphics is allowed
    9. -
  9. allowAssembleDocument: true if assembling document is allowed
    10. -
  10. allowPrintHq: true if printing to high quality is allowed
    11. -
-

- Alternatively, you can set each value separately in the Map provided by - FOUserAgent.getRendererOptions() by using the following keys: -

-
    -
  1. user-password: String
    2. -
  2. owner-password: String
    3. -
  3. noprint: Boolean or "true"/"false"
    4. -
  4. nocopy: Boolean or "true"/"false"
    5. -
  5. noedit: Boolean or "true"/"false"
    6. -
  6. noannotations: Boolean or "true"/"false"
    7. -
  7. nofillinforms: Boolean or "true"/"false"
    8. -
  8. noaccesscontent: Boolean or "true"/"false"
    9. -
  9. noassembledoc: Boolean or "true"/"false"
    10. -
  10. noprinthq: Boolean or "true"/"false"
    11. -
-
-
- Environment -

- In order to use PDF encryption, FOP has to be compiled with - cryptography support. Currently, only JCE - is supported. JCE is part of JDK 1.4. For earlier JDKs, it can - be installed separately. The build process automatically - detects JCE presence and installs PDF encryption support if - possible, otherwise a stub is compiled in. -

-

- Cryptography support must also be present at run time. In particular, a - provider for the RC4 cipher is needed. Unfortunately, the sample JCE - provider in Sun's JDK 1.4 does not provide RC4. If you - get a message saying -

- "Cannot find any provider supporting RC4" -

- then you don't have the needed infrastructure. -

-

- There are several commercial and a few Open Source packages which - provide RC4. A pure Java implementation is produced by The Legion of the Bouncy - Castle. Mozilla - JSS is an interface to a native implementation. -

-
-
- Installing a crypto provider -

- The pure Java implementation from Bouncy Castle is easy to - install. -

-
    -
  1. - Download the binary distribution for your JDK version. -
    2. -
  2. - Unpack the distribution. Add the jar file to your classpath. A - convenient way to use the jar on Linux is to simply drop it into the - FOP lib directory, it will be automatically picked up by - fop.sh. -
    3. -
  3. - Open the java.security file and add
    - security.provider.6=org.bouncycastle.jce.provider.BouncyCastleProvider,
    - preferably at the end of the block defining the other crypto - providers. For JDK 1.4 this is detailed on Sun's web site. -
    4. -
-

- If you have any experience with Mozilla JSS or any other - cryptography provider, please post it to the fop-user list. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/trunk/pdfx.xml b/src/documentation/content/xdocs/trunk/pdfx.xml deleted file mode 100644 index bef2fce2a..000000000 --- a/src/documentation/content/xdocs/trunk/pdfx.xml +++ /dev/null @@ -1,136 +0,0 @@ - - - - - -
- Apache™ FOP: PDF/X (ISO 15930) - $Revision$ - - - -
- -
- Overview - - Support for PDF/X is available beginning with version 0.93. This feature is new and - may not be 100% complete, yet. Feedback is welcome. - -

- PDF/X is a standard which faciliates prepress digital data exchange using PDF. - Currently, only PDF/X-3:2003 is implemented out of the many different flavours of PDF/X - profiles. PDF/X-3:2003 is documented in - ISO 15930-6:2003(E). - More info on PDF/X can be found on the - PDF/X info site. -

-
-
- Implementation Status -

- PDF/X-3:2003 is implemented to the degree that FOP supports - the creation of the elements described in ISO 15930-6. -

-

- An important restriction of the current implementation is that all normal - RGB colors specified in XSL-FO and SVG are left unchanged in the sRGB color - space (XSL-FO and SVG both use sRGB as their default color space). - There's no conversion to a CMYK color space. Although sRGB is a - calibrated color space, its color space has a different size than a CMYK - color space which makes the conversion a lossy conversion and can lead to - unwanted results. Although the use of the calibrated sRGB has been promoted - for years, print shops usually prefer to convert an sRGB PDF to CMYK prior - to production. Until there's full CMYK support in FOP you will have to - work closely with your print service provider to make sure you get the - intended result. -

-

- Tests have been performed against Adobe Acrobat 7.0.7 (Preflight function). - Note that there are bugs in Adobe Acrobat which cause false alarms if both - PDF/A-1b and PDF/X-3:2003 are activated at the same time. -

-
-
- Usage (command line) -

- To activate PDF/X-3:2003 from the command-line, specify "-pdfprofile PDF/X-3:2003" - as a parameter. If there is a violation of one of the validation rules for - PDF/X, an error message is presented and the processing stops. -

-
-
- Usage (embedded) -

- When FOP is embedded in another Java application you can set a special option - on the renderer options in the user agent to activate the PDF/A-1b profile. - Here's an example: -

- -

- If one of the validation rules of PDF/X is violated, an PDFConformanceException - (descendant of RuntimeException) is thrown. -

-
-
- PDF/X in Action -

- There are a number of things that must be looked after if you activate a PDF/X - profile. If you receive a PDFConformanceException, have a look at the following - list (not necessarily comprehensive): -

-
    -
  • - Make sure all (!) fonts are embedded. If you use base 14 fonts (like Helvetica) - you need to obtain a license for them and embed them like any other font. -
    • -
  • - Don't use PDF encryption. PDF/X doesn't allow it. -
    • -
  • - Don't use CMYK images without an ICC color profile. PDF/X doesn't allow mixing - color spaces and FOP currently only properly supports the sRGB color space. However, - you will need to specify an - output device profile - (usually a CMYK profile) in the configuration. sRGB won't work here since it's a - display device profile, not an output device profile. -
    • -
  • - Don't use non-RGB colors in SVG images. Same issue as with CMYK images. -
    • -
  • - Don't use EPS graphics with fo:external-graphic. Embedding EPS graphics in PDF - is deprecated since PDF 1.4 and prohibited by PDF/X-3:2003. -
    • -
  • - PDF is forced to version 1.4 if PDF/X-3:2003 is activated. -
    • -
-
-
- PDF profile compatibility -

- The PDF profiles "PDF/X-3:2003" and "PDF/A-1b" are compatible and can both be - activated at the same time. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/trunk/running.xml b/src/documentation/content/xdocs/trunk/running.xml deleted file mode 100644 index 5e30bb25e..000000000 --- a/src/documentation/content/xdocs/trunk/running.xml +++ /dev/null @@ -1,370 +0,0 @@ - - - - - -
- Running Apache™ FOP - $Revision$ -
- - -
- System Requirements -

The following software must be installed:

-
    -
  • - Java 1.4.x or later Runtime Environment. -
      -
    • - Many JREs >=1.4 contain older JAXP implementations (which often contain bugs). It's - usually a good idea to replace them with a current implementation. -
      • -
    -
    • -
  • - Apache™ FOP. The FOP distribution includes all libraries that you will - need to run a basic FOP installation. These can be found in the [fop-root]/lib directory. These - libraries include the following: - -
    • -
-

The following software is optional, depending on your needs:

-
    -
  • - Graphics libraries. Generally, FOP contains direct support for the most important - bitmap image formats (including PNG, JPEG and GIF). See - FOP: Graphics Formats for details. -
    • -
  • - PDF encryption. See FOP: PDF Encryption for details. -
    • -
-

In addition, the following system requirements apply:

-
    -
  • - If you will be using FOP to process SVG, you must do so in a graphical environment. - See FOP: Graphics (Batik) for details. -
    • -
-
-
- Installation -
- Instructions -

- Basic FOP installation consists of first unzipping the .gz file that is the - distribution medium, then unarchiving the resulting .tar file in a - directory/folder that is convenient on your system. Please consult your operating system - documentation or Zip application software documentation for instructions specific to your - site. -

-
-
- Problems -

- Some Mac OSX users have experienced filename truncation problems using Stuffit to unzip - and unarchive their distribution media. This is a legacy of older Mac operating systems, - which had a 31-character pathname limit. Several Mac OSX users have recommended that - Mac OSX users use the shell command tar -xzf instead. -

-
-
-
- Starting FOP as a Standalone Application -
- Using the fop script or batch file -

- The usual and recommended practice for starting FOP from the command line is to run the - batch file fop.bat (Windows) or the shell script fop (Unix/Linux). - These scripts require that the environment variable JAVA_HOME be - set to a path pointing to the appropriate Java installation on your system. Macintosh OSX - includes a Java environment as part of its distribution. We are told by Mac OSX users that - the path to use in this case is /Library/Java/Home. Caveat: - We suspect that, as Apple releases new Java environments and as FOP upgrades the minimum - Java requirements, the two will inevitably not match on some systems. Please see - Java on Mac OSX FAQ for information as - it becomes available. -

- - [OPTIONS] - -version print FOP version and exit - -d debug mode - -x dump configuration settings - -q quiet mode - -c cfg.xml use additional configuration file cfg.xml - -l lang the language to use for user information - -nocs disable complex script features - -r relaxed/less strict validation (where available) - -dpi xxx target resolution in dots per inch (dpi) where xxx is a number - -s for area tree XML, down to block areas only - -v run in verbose mode (currently simply print FOP version and continue) - - -o [password] PDF file will be encrypted with option owner password - -u [password] PDF file will be encrypted with option user password - -noprint PDF file will be encrypted without printing permission - -nocopy PDF file will be encrypted without copy content permission - -noedit PDF file will be encrypted without edit content permission - -noannotations PDF file will be encrypted without edit annotation permission - -nofillinforms PDF file will be encrypted without fill in forms permission - -noaccesscontent PDF file will be encrypted without extract text and graphics permission - -noassembledoc PDF file will be encrypted without assemble the document permission - -noprinthq PDF file will be encrypted without print high quality permission - -a enables accessibility features (Tagged PDF etc., default off) - -pdfprofile prof PDF file will be generated with the specified profile - (Examples for prof: PDF/A-1b or PDF/X-3:2003) - - -conserve enable memory-conservation policy (trades memory-consumption for disk I/O) - (Note: currently only influences whether the area tree is serialized.) - - -cache specifies a file/directory path location - -flush flushes the current font cache file - - [INPUT] - infile xsl:fo input file (the same as the next) - (use '-' for infile to pipe input from stdin) - -fo infile xsl:fo input file - -xml infile xml input file, must be used together with -xsl - -atin infile area tree input file - -ifin infile intermediate format input file - -imagein infile image input file (piping through stdin not supported) - -xsl stylesheet xslt stylesheet - - -param name value to use for parameter in xslt stylesheet - (repeat '-param name value' for each parameter) - - -catalog use catalog resolver for input XML and XSLT files - [OUTPUT] - outfile input will be rendered as PDF into outfile - (use '-' for outfile to pipe output to stdout) - -pdf outfile input will be rendered as PDF (outfile req'd) - -pdfa1b outfile input will be rendered as PDF/A-1b compliant PDF - (outfile req'd, same as "-pdf outfile -pdfprofile PDF/A-1b") - -awt input will be displayed on screen - -rtf outfile input will be rendered as RTF (outfile req'd) - -pcl outfile input will be rendered as PCL (outfile req'd) - -ps outfile input will be rendered as PostScript (outfile req'd) - -afp outfile input will be rendered as AFP (outfile req'd) - -tiff outfile input will be rendered as TIFF (outfile req'd) - -png outfile input will be rendered as PNG (outfile req'd) - -txt outfile input will be rendered as plain text (outfile req'd) - -at [mime] out representation of area tree as XML (outfile req'd) - specify optional mime output to allow the AT to be converted - to final format later - -if [mime] out representation of document in intermediate format XML (outfile req'd) - specify optional mime output to allow the IF to be converted - to final format later - -print input file will be rendered and sent to the printer - see options with "-print help" - -out mime outfile input will be rendered using the given MIME type - (outfile req'd) Example: "-out application/pdf D:\out.pdf" - (Tip: "-out list" prints the list of supported MIME types) - -svg outfile input will be rendered as an SVG slides file (outfile req'd) - Experimental feature - requires additional fop-sandbox.jar. - - -foout outfile input will only be XSL transformed. The intermediate - XSL-FO file is saved and no rendering is performed. - (Only available if you use -xml and -xsl parameters) - - - [Examples] - fop foo.fo foo.pdf - fop -fo foo.fo -pdf foo.pdf (does the same as the previous line) - fop -xml foo.xml -xsl foo.xsl -pdf foo.pdf - fop -xml foo.xml -xsl foo.xsl -foout foo.fo - fop -xml - -xsl foo.xsl -pdf - - fop foo.fo -mif foo.mif - fop foo.fo -rtf foo.rtf - fop foo.fo -print - fop foo.fo -awt]]> -

- PDF encryption is only available if FOP was compiled with encryption support - and if compatible encryption support is available at run time. - Currently, only the JCE is supported. Check the Details. -

-
-
- Writing your own script -

FOP's entry point for your own scripts is the class -org.apache.fop.cli.Main. The general pattern for the - command line is: java -classpath <CLASSPATH> - org.apache.fop.cli.Main <arguments>. The arguments - consist of the options and infile and outfile specifications - as shown above for the standard scripts. You may wish to review - the standard scripts to make sure that - you get your environment properly configured. -

-
-
- Running with java's <code>-jar</code> option -

- As an alternative to the start scripts you can run java - -jar path/to/build/fop.jar <arguments>, relying on - FOP to build the classpath for running FOP dynamically, see below. If you use hyphenation, - you must put fop-hyph.jar in the lib - directory. -

- -

You can also run java -jar path/to/fop.jar - <arguments>, relying on the Class-Path - entry in the manifest file. This works if you put - fop.jar and all jar files from the lib - directory in a single directory. If you use hyphenation, you - must also put fop-hyph.jar in that directory.

- -

In both cases the arguments consist of the options and - infile and outfile specifications as shown above for the - standard scripts.

-
-
- FOP's dynamical classpath construction - -

If FOP is started without a proper classpath, it tries to - add its dependencies dynamically. If the system property - fop.home contains the name of a directory, then - FOP uses that directory as the base directory for its - search. Otherwise the current working directory is the base - directory. If the base directory is called build, - then its parent directory becomes the base directory.

- -

FOP expects to find fop.jar in the - build subdirectory of the base directory, and - adds it to the classpath. Subsequently FOP adds all - jar files in the lib directory to the - classpath. The lib directory is either the lib - subdirectory of the base directory, or, if that does not - exist, the base directory itself.

- -

If the system property fop.optional.lib - contains the name of a directory, then all jar - files in that directory are also added to the classpath. See - the methods getJARList and - checkDependencies in - org.apache.fop.cli.Main.

- -
-
-
- Using Xalan to Check XSL-FO Input -

- FOP sessions that use -xml and -xsl input instead of -fo input are actually - controlling two distinct conversions: Tranforming XML to XSL-FO, then formatting - the XSL-FO to PDF (or another FOP output format). - Although FOP controls both of these processes, the first is included merely as - a convenience and for performance reasons. - Only the second is part of FOP's core processing. - If a user has a problem running FOP, it is important to determine which of these - two processes is causing the problem. - If the problem is in the first process, the user's stylesheet is likely the cause. - The FOP development team does not have resources to help with stylesheet issues, - although we have included links to some useful - Specifications and - Books/Articles. - If the problem is in the second process, FOP may have a bug or an unimplemented - feature that does require attention from the FOP development team. -

- The user is always responsible to provide correct XSL-FO code to FOP. -

- In the case of using -xml and -xsl input, although the user is responsible for - the XSL-FO code that is FOP's input, it is not visible to the user. To make the - intermediate FO file visible, the FOP distribution includes the "-foout" option - which causes FOP to run only the first (transformation) step, and write the - results to a file. (See also the Xalan command-line below) -

- - When asking for help on the FOP mailing lists, never attach XML and - XSL to illustrate the issue. Always run the XSLT step (-foout) and send the - resulting XSL-FO file instead. Of course, be sure that the XSL-FO file is - correct before sending it. - -

- The -foout option works the same way as if you would call the - Xalan command-line: -

-

- java org.apache.xalan.xslt.Process -IN xmlfile -XSL file -OUT outfile -

-

- Note that there are some subtle differences between the FOP and Xalan command-lines. -

-
-
- Memory Usage -

- FOP can consume quite a bit of memory, even though this has been continually improved. - This is partly inherent to the formatting process and partly caused by implementation choices. - All FO processors currently on the market have memory problems with certain layouts. -

-

- If you are running out of memory when using FOP, here are some ideas that may help: -

-
    -
  • - Increase memory available to the JVM. See - the -Xmx option - for more information. - - It is usually unwise to increase the memory allocated to the JVM beyond the amount of - physical RAM, as this will generally cause significantly slower performance. - -
    • -
  • - Avoid forward references. - Forward references are references to some later part of a document. - Examples include page number citations which refer to pages which follow the citation, - tables of contents at the beginning of a document, and page numbering schemes that - include the total number of pages in the document - ("page N of TOTAL"). - Forward references cause all subsequent pages to be held in memory until the reference - can be resolved, i.e. until the page with the referenced element is encountered. - Forward references may be required by the task, but if you are getting a memory - overflow, at least consider the possibility of eliminating them. - A table of contents could be replaced by PDF bookmarks instead or moved to the end of - the document (reshuffle the paper could after printing). -
    • -
  • - Avoid large images, especially if they are scaled down. - If they need to be scaled, scale them in another application upstream from FOP. - For many image formats, memory consumption is driven mainly by the size of the image - file itself, not its dimensions (width*height), so increasing the compression rate - may help. -
    • -
  • - Use multiple page sequences. - FOP starts rendering after the end of a page sequence is encountered. - While the actual rendering is done page-by-page, some additional memory is - freed after the page sequence has been rendered. - This can be substantial if the page sequence contains lots of FO elements. -
    • -
-
-
- Problems -

If you have problems running FOP, please see the "How to get Help" page.

-
- - diff --git a/src/documentation/content/xdocs/trunk/servlets.xml b/src/documentation/content/xdocs/trunk/servlets.xml deleted file mode 100644 index dd2df4351..000000000 --- a/src/documentation/content/xdocs/trunk/servlets.xml +++ /dev/null @@ -1,325 +0,0 @@ - - - - - -
- Apache™ FOP: Servlets - How to use Apache™ FOP in a Servlet - $Revision$ -
- -
- Overview -

- This page discusses topic all around using Apache™ FOP in a servlet environment. -

-
-
- Example Servlets in the FOP distribution -

- In the directory {fop-dir}/src/java/org/apache/fop/servlet, you'll find a working example - of a FOP-enabled servlet. -

-

- The servlet is automatically built when you build Apache FOP using the supplied Ant script. After building - the servlet, drop fop.war into the webapps directory of Apache Tomcat (or any other web container). Then, you can use - URLs like the following to generate PDF files: -

-
    -
  • http://localhost:8080/fop/fop?fo=/home/path/to/fofile.fo
    • -
  • http://localhost:8080/fop/fop?xml=/home/path/to/xmlfile.xml&xsl=/home/path/to/xslfile.xsl
    • -
-

-

The source code for the servlet can be found under {fop-dir}/src/java/org/apache/fop/servlet/FopServlet.java.

- - This example servlet should not be used on a public web server connected to the Internet as it does not contain - any measures to prevent Denial-of-Service-Attacks. It is provided as an example and as a starting point for - your own servlet. - -
-
- Create your own Servlet - - This section assumes you are familiar with embedding FOP. - -
- A minimal Servlet -

- Here is a minimal code snippet to demonstrate the basics: -

- private FopFactory fopFactory = FopFactory.newInstance(); -private TransformerFactory tFactory = TransformerFactory.newInstance(); - -public void doGet(HttpServletRequest request, - HttpServletResponse response) throws ServletException { - try { - response.setContentType("application/pdf"); - Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, response.getOutputStream()); - Transformer transformer = tFactory.newTransformer(); - Source src = new StreamSource("foo.fo"); - Result res = new SAXResult(fop.getDefaultHandler()); - transformer.transform(src, res); - } catch (Exception ex) { - throw new ServletException(ex); - } -} - - There are numerous problems with the code snippet above. - Its purpose is only to demonstrate the basic concepts. - See below for details. - -
-
- Adding XSL tranformation (XSLT) -

- A common requirement is to transform an XML source to - XSL-FO using an XSL transformation. It is recommended to use - JAXP for this task. The following snippet shows the basic - code: -

- private FopFactory fopFactory = FopFactory.newInstance(); -private TransformerFactory tFactory = TransformerFactory.newInstance(); - -public void init() throws ServletException { - //Optionally customize the FopFactory and TransformerFactory here -} - -[..] - - //Setup a buffer to obtain the content length - ByteArrayOutputStream out = new ByteArrayOutputStream(); - - //Setup FOP - Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, out); - - //Setup Transformer - Source xsltSrc = new StreamSource(new File("foo-xml2fo.xsl")); - Transformer transformer = tFactory.newTransformer(xsltSrc); - - //Make sure the XSL transformation's result is piped through to FOP - Result res = new SAXResult(fop.getDefaultHandler()); - - //Setup input - Source src = new StreamSource(new File("foo.xml")); - - //Start the transformation and rendering process - transformer.transform(src, res); - - //Prepare response - response.setContentType("application/pdf"); - response.setContentLength(out.size()); - - //Send content to Browser - response.getOutputStream().write(out.toByteArray()); - response.getOutputStream().flush(); - - Buffering the generated PDF in a ByteArrayOutputStream is done to avoid potential - problems with the Acrobat Reader Plug-in in Microsoft Internet Explorer. - -

- The Source instance used above is simply an - example. If you have to read the XML from a string, supply - a new StreamSource(new - StringReader(xmlstring)). Constructing and reparsing - an XML string is generally less desirable than using a - SAXSource if you generate your XML. You can alternatively - supply a DOMSource as well. You may also use dynamically - generated XSL if you like. -

-

- Because you have an explicit Transformer object, you can also use it to - explicitely set parameters for the transformation run. -

-
-
- Custom configuration -

- You can easily set up your own FOUserAgent as demonstrated on the Embedding page. -

-
-
- Improving performance -

- There are several options to consider: -

-
    -
  • - Instead of java.io.ByteArrayOutputStream consider using the ByteArrayOutputStream - implementation from the Jakarta Commons IO project which allocates less memory. - The full class name is: org.apache.commons.io.output.ByteArrayOutputStream -
    • -
  • - In certain cases it can help to write the generated PDF to a temporary file so - you can quickly reuse the file. This is especially useful, if Internet Explorer - calls the servlet multiple times with the same request or if you often generate - equal PDFs. -
    • -
-

- Of course, the - performance hints from the Embedding page - apply here, too. -

-
-
- Accessing resources in your web application -

- Often, you will want to use resources (stylesheets, images etc.) which are bundled with - your web application. FOP provides a URIResolver implementation that lets you access - files via the Servlet's ServletContext. The class is called - org.apache.fop.servlet.ServletContextURIResolver. -

-

- Here's how to set it up in your servlet. Instantiate a new instance in the servlet's - init() method: -

- -

- The ServletContextURIResolver reacts on URIs beginning with "servlet-context:". If you - want to access an image in a subdirectory of your web application, you could, for - example, use: "servlet-context:/images/myimage.png". Don't forget the leading slash - after the colon! -

-

- Further down, you can use the URIResolver for various things: -

-
    -
  • - With the Transformer (JAXP/XSLT) so things like document() functions can resolver - "servlet-context:" URIs. -
    • -
  • - With the FopFactory so every resource FOP loads can be loaded using a "servlet-context:" - URI. -
    • -
  • - You can the ServletContextURIResolver yourself in your servlet code to access - stylesheets or XML files bundled with your web application. -
    • -
-

- Here are some example snippets: -

- -
-
-
- Notes on Microsoft Internet Explorer -

- Some versions of Internet Explorer will not automatically show the PDF or call the servlet multiple times. - These are well-known limitations of Internet Explorer and are not a problem of the servlet. - However, Internet Explorer can still be used to download the PDF so that it can be viewed later. - Here are some suggestions in this context: -

-
    -
  • - Use an URL ending in .pdf, like - http://myserver/servlet/stuff.pdf. Yes, the servlet can - be configured to handle this. If the URL has to contain parameters, - try to have both the base URL as well as the last parameter end in - .pdf, if necessary append a dummy parameter, like - http://myserver/servlet/stuff.pdf?par1=a&par2=b&d=.pdf. The - effect may depend on IEx version. -
    • -
  • - Give IEx the opportunity to cache. In particular, ensure the - server does not set any headers causing IEx not to cache the - content. This may be a real problem if the document is sent - over HTTPS, because most IEx installations will by default - not cache any content retrieved over HTTPS. - Setting the Expires header entry may help in - this case:
    response.setDateHeader("Expires", - System.currentTimeMillis() + cacheExpiringDuration * - 1000);
    Consult your server manual and the - relevant RFCs for further details on HTTP headers and - caching. -
    • -
  • - Cache in the server. It may help to include a parameter in - the URL which has a timestamp as the value min order to - decide whether a request is repeated. IEx is reported to - retrieve a document up to three times, but never more often. -
    • -
-
-
- Servlet Engines -

- When using a servlet engine, there are potential CLASSPATH issues, and potential conflicts - with existing XML/XSLT libraries. Servlet containers also often use their own classloaders - for loading webapps, which can cause bugs and security problems. -

-
- Tomcat -

- Check Tomcat's documentation for detailed instructions about installing FOP and Cocoon. - There are known bugs that must be addressed, particularly for Tomcat 4.0.3. -

-
-
- WebSphere 3.5 -

- Put a copy of a working parser in some directory where WebSphere can access it. - For example, if /usr/webapps/yourapp/servlets is the CLASSPATH for your servlets, - copy the Xerces jar into it (any other directory would also be fine). - Do not add the jar to the servlet CLASSPATH, but add it to the CLASSPATH of the - application server which contains your web application. - In the WebSphere administration console, click on the "environment" button in the - "general" tab. In the "variable name" box, enter "CLASSPATH". - In the "value" box, enter the correct path to the parser jar file - (/usr/webapps/yourapp/servlets/Xerces.jar in our example here). - Press "OK", then apply the change and restart the application server. -

-
-
-
- Handling complex use cases -

- Sometimes the requirements for a servlet get quite sophisticated: SQL data sources, - multiple XSL transformations, merging of several datasources etc. In such a case - consider using Apache Cocoon instead - of a custom servlet to accomplish your goal. -

-
- - \ No newline at end of file diff --git a/src/documentation/content/xdocs/trunk/upgrading.xml b/src/documentation/content/xdocs/trunk/upgrading.xml deleted file mode 100644 index 3376a42d7..000000000 --- a/src/documentation/content/xdocs/trunk/upgrading.xml +++ /dev/null @@ -1,122 +0,0 @@ - - - - - -
- Upgrading from an Earlier Version of Apache™ FOP - $Revision$ -
- -
- Important! -

- If you're planning to upgrade to the latest Apache™ FOP version there are a few very important things - to consider: -

-
    -
  • - The API of FOP has changed considerably and is not - backwards-compatible with versions 0.20.5 and - 0.91beta. Version 0.92 introduced the new stable - API. -
    • -
  • - Since version 0.92 some deprecated methods which were part - of the old API have been removed. If you upgrade from 0.91 - beta, you will need to adjust your Java code. Similarly if - you upgrade from 0.92 and use deprecated methods. -
    • -
  • - If you are using a configuration file for version 0.20.5, you have to rebuild it in the new format. The format - of the configuration files has changed since version 0.20.5. See conf/fop.xconf for - an example configuration file. A XML Schema file can be found under - src/foschema/fop-configuration.xsd. -
    • -
  • - Beginning with version 0.94 you can skip the generation of - font metric files and remove the "font-metrics" attribute - in the font configuration. In the unlikely case that due to - a bug you still need to use font metrics files you will need - to regenerate the font metrics file if yours are from a FOP - version before 0.93. -
    • -
  • -

    - The new code is much more strict about the interpretation of the XSL-FO 1.1 specification. - Things that worked fine in version 0.20.5 might start to produce warnings or even errors - now. FOP 0.20.5 contains many bugs which have been corrected in the new code. -

    - - While FOP 0.20.5 allowed you to have empty fo:table-cell elements, the new code - will complain about that (unless relaxed validation is enabled) because the specification - demands at least one block-level element ((%block;)+, see - XSL-FO 1.1, 6.7.10) - inside an fo:table-cell element. - -
    • -
  • - Extensions and Renderers written for version 0.20.5 will not work with the new code! The new FOP - extension for Barcode4J is available since - January 2007. -
    • -
  • - The SVG Renderer and the MIF Handler have not been resurrected, yet! They are currently non-functional - and hope for someone to step up and reimplement them. -
    • -
-
-
- What you need to know when you upgrade! -

- When you use your existing FO files or XML/XSL files which work fine with FOP version - 0.20.5 against this FOP version some things may not work as expected. The following - list will hopefully help you to identify and correct those problems. -

-
    -
  • - Check the Compliance page for the feature causing - trouble. It may contain the necessary information to understand and resolve the problem. -
    • -
  • - Not all 0.20.5 output formats are supported. PDF and Postscript should be fully supported. - See Output Targets for a more complete description. -
    • -
  • - As stated above empty table cells <fo:table-cell></fo:table-cell> - are not allowed by the specification. The same applies to empty static-content - and block-container elements, for example. -
    • -
  • - 0.20.5 is not XSL-FO compliant with respect to sizing images (external-graphic) - or instream-foreign-object - objects. If images or SVGs are sized differently in your outputs with the new FOP version - check Bug 37136 - as it contains some hints on what to do. The file - - "examples/fo/basic/images.fo" has - a number of good examples that show the new, more correct behaviour. -
    • -
  • - The fox:outline extension is not implemented in this version anymore. - It has been superseded by the new bookmark elements from XSL-FO 1.1. -
    • -
-
- - \ No newline at end of file diff --git a/src/documentation/intermediate-format-ng/README.txt b/src/documentation/intermediate-format-ng/README.txt deleted file mode 100644 index d2da38b26..000000000 --- a/src/documentation/intermediate-format-ng/README.txt +++ /dev/null @@ -1,7 +0,0 @@ -IMPORTANT! This is "WORK IN PROGRESS"! - -This directory contains the draft XML schema for a new intermediate format for Apache FOP. -The design is described on the FOP Wiki at: -http://wiki.apache.org/xmlgraphics-fop/AreaTreeIntermediateXml/NewDesign - -Help and feedback is welcome. \ No newline at end of file diff --git a/src/documentation/intermediate-format-ng/example1.xml b/src/documentation/intermediate-format-ng/example1.xml deleted file mode 100644 index eec5ff8b9..000000000 --- a/src/documentation/intermediate-format-ng/example1.xml +++ /dev/null @@ -1,73 +0,0 @@ - - - - -
- - - - New Intermediate Format Demo Document - - - Jeremias Märki - - - - - - - - Table of Contents - - - Chapter 1 - - -
- - - - - %FOPTestPSSetupCode: General - setup code here! - - - - - - Hello - - - - - - - - - - - - - - diff --git a/src/documentation/intermediate-format-ng/fop-intermediate-format-ng-content.xsd b/src/documentation/intermediate-format-ng/fop-intermediate-format-ng-content.xsd deleted file mode 100644 index d6f0c694c..000000000 --- a/src/documentation/intermediate-format-ng/fop-intermediate-format-ng-content.xsd +++ /dev/null @@ -1,165 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/src/documentation/intermediate-format-ng/fop-intermediate-format-ng-datatypes.xsd b/src/documentation/intermediate-format-ng/fop-intermediate-format-ng-datatypes.xsd deleted file mode 100644 index e25556f9b..000000000 --- a/src/documentation/intermediate-format-ng/fop-intermediate-format-ng-datatypes.xsd +++ /dev/null @@ -1,124 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/src/documentation/intermediate-format-ng/fop-intermediate-format-ng-nav.xsd b/src/documentation/intermediate-format-ng/fop-intermediate-format-ng-nav.xsd deleted file mode 100644 index ff6697cdf..000000000 --- a/src/documentation/intermediate-format-ng/fop-intermediate-format-ng-nav.xsd +++ /dev/null @@ -1,124 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/src/documentation/intermediate-format-ng/fop-intermediate-format-ng.xsd b/src/documentation/intermediate-format-ng/fop-intermediate-format-ng.xsd deleted file mode 100644 index 6e17c793b..000000000 --- a/src/documentation/intermediate-format-ng/fop-intermediate-format-ng.xsd +++ /dev/null @@ -1,102 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/src/documentation/intermediate-format-ng/xmp-metadata.xsd b/src/documentation/intermediate-format-ng/xmp-metadata.xsd deleted file mode 100644 index e05d0615c..000000000 --- a/src/documentation/intermediate-format-ng/xmp-metadata.xsd +++ /dev/null @@ -1,35 +0,0 @@ - - - - - - - - - - - - - - diff --git a/src/documentation/intermediate-format-ng/xmp-rdf-metadata.xsd b/src/documentation/intermediate-format-ng/xmp-rdf-metadata.xsd deleted file mode 100644 index b3cef703c..000000000 --- a/src/documentation/intermediate-format-ng/xmp-rdf-metadata.xsd +++ /dev/null @@ -1,36 +0,0 @@ - - - - - - - - - - - - - diff --git a/src/documentation/poster/README.txt b/src/documentation/poster/README.txt deleted file mode 100644 index d5ef2c0a2..000000000 --- a/src/documentation/poster/README.txt +++ /dev/null @@ -1,12 +0,0 @@ -$Id$ - -This directory contains a poster on Apache FOP. It was initially -created for OpenExpo '06 (http://www.openexpo.ch). - -To create the PDF just call go.bat. - -The fully reconstruct the PDF you need some fonts installed in -your operating system: Verdana and Lucida Console which are -available in every Windows installation. - -You will also need English hyphenation patterns. \ No newline at end of file diff --git a/src/documentation/poster/cfg/fop.xconf b/src/documentation/poster/cfg/fop.xconf deleted file mode 100644 index 788d58920..000000000 --- a/src/documentation/poster/cfg/fop.xconf +++ /dev/null @@ -1,30 +0,0 @@ - - - - - 72 - 300 - - - - - - - - - diff --git a/src/documentation/poster/go.bat b/src/documentation/poster/go.bat deleted file mode 100644 index 46588852b..000000000 --- a/src/documentation/poster/go.bat +++ /dev/null @@ -1,3 +0,0 @@ -@ECHO OFF -rem ..\..\..\fop -c cfg/fop.xconf -xml xml/fop-poster.xml -xsl xslt/fop-poster.xsl -pdf fop-poster.pdf -pdfprofile PDF/X-3:2003 -..\..\..\fop -c cfg/fop.xconf -xml xml/fop-poster.xml -xsl xslt/fop-poster.xsl -pdf fop-poster.pdf \ No newline at end of file diff --git a/src/documentation/poster/svg/asf-logo.svg b/src/documentation/poster/svg/asf-logo.svg deleted file mode 100644 index f79c01373..000000000 --- a/src/documentation/poster/svg/asf-logo.svg +++ /dev/null @@ -1,2050 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/src/documentation/poster/svg/fop-logo-reconstructed.svg b/src/documentation/poster/svg/fop-logo-reconstructed.svg deleted file mode 100644 index f424b8d0e..000000000 --- a/src/documentation/poster/svg/fop-logo-reconstructed.svg +++ /dev/null @@ -1,954 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/src/documentation/poster/svg/fop-transformation-chain.svg b/src/documentation/poster/svg/fop-transformation-chain.svg deleted file mode 100644 index a33e4f974..000000000 --- a/src/documentation/poster/svg/fop-transformation-chain.svg +++ /dev/null @@ -1,71 +0,0 @@ - - - - - - - - - - - - - - - Data - Source - - XML - - XSL-FO - - Target - File - - Paper - - - - - - - - - - - - - - - - - - - - - Generation - Transformation - (XSLT) - Layout - Printing - - - XSLT - Stylesheet - - diff --git a/src/documentation/poster/svg/pepe-business-card.svg b/src/documentation/poster/svg/pepe-business-card.svg deleted file mode 100644 index 559c87abe..000000000 --- a/src/documentation/poster/svg/pepe-business-card.svg +++ /dev/null @@ -1,33 +0,0 @@ - - - - - - - Pepé Le Pew - Expert d'Amour - 13 Pleasantstreet - Acme Acres - +1 (23) 456-7890 - pepe@looney.toon - - - - diff --git a/src/documentation/poster/xml/business-card-demo.xml b/src/documentation/poster/xml/business-card-demo.xml deleted file mode 100644 index 9b7f80029..000000000 --- a/src/documentation/poster/xml/business-card-demo.xml +++ /dev/null @@ -1,110 +0,0 @@ - - - -
- An Example -

- The XML file (a business card): -

- - - Pepé Le Pew - Expert d'Amour - 13 Pleasantstreet - Acme Acres - +1 (23) 456-7890 - pepe@looney.toon -]]> - -

The result:

-

- - - - - - - -

- - - - - - - - - - - - - - - - - - -

The XSLT stylesheet which contains the rules to convert the business card XML to XSL-FO:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -]]> - - - -
diff --git a/src/documentation/poster/xml/fop-foreign-xml-support.xml b/src/documentation/poster/xml/fop-foreign-xml-support.xml deleted file mode 100644 index 1755fe1bc..000000000 --- a/src/documentation/poster/xml/fop-foreign-xml-support.xml +++ /dev/null @@ -1,28 +0,0 @@ - - - -
- Foreign XML Support -
    -
  • SVG (Vector Graphics, Apache Batik, built-in)
    • -
  • Barcodes (Barcode4J, optional)
    • -
  • MathML (JEuclid, optional)
    • -
  • XMP (Metadata)
    • -
  • ... or your own format!
    • -
-
diff --git a/src/documentation/poster/xml/fop-getting-help.xml b/src/documentation/poster/xml/fop-getting-help.xml deleted file mode 100644 index 5b9e6ddce..000000000 --- a/src/documentation/poster/xml/fop-getting-help.xml +++ /dev/null @@ -1,30 +0,0 @@ - - - -
- Support -

- What if you need help? -

-
    -
  • Find out if your problem is about XSL-FO or XSLT.
    • -
  • The FOP website contains links to forums and mailing lists on XSLT.
    • -
  • The “fop-users” mailing list helps you with Apache FOP.
    • -
  • Be sure to check the FAQ and the mailing list archives before you ask on the mailing list.
    • -
-
diff --git a/src/documentation/poster/xml/fop-history.xml b/src/documentation/poster/xml/fop-history.xml deleted file mode 100644 index 0baa6340f..000000000 --- a/src/documentation/poster/xml/fop-history.xml +++ /dev/null @@ -1,50 +0,0 @@ - - - -
- Project History -

- The initial code for the Formatting Objects Processor (FOP) was contributed to the - Apache Software Foundation by James Tauber in 1999. -

-

- The project evolved with the W3C specification and was quickly adopted by many. In July of 2003, - the most famous version of FOP, 0.20.5, was released. It is now used to produce documents all - over the globe. -

-

- Even before release 0.20.5 a redesign effort commenced to address short-comings - that prevented important features from being implemented using the current design. -

-

- In October 2004, Batik and FOP joined forces and together formed the XML Graphics project. - This change was made to scale down the old Apache XML project, to improve - project oversight, and to allow for better collaboration because Batik and - FOP share many similarities. -

-

- In 2005, the redesign finally took a leap forward, which resulted in the first release from - the new codebase (FOP 0.90alpha). The project team has published a number of releases - since then. FOP made big steps forward. -

-

- The next version, to be released in March 2008, will be 0.95. Although FOP still carries - pre 1.0 version numbers it is production-ready. Some features are still missing before - version 1.0 can be released. -

-
diff --git a/src/documentation/poster/xml/fop-image-support.xml b/src/documentation/poster/xml/fop-image-support.xml deleted file mode 100644 index 4789cc930..000000000 --- a/src/documentation/poster/xml/fop-image-support.xml +++ /dev/null @@ -1,32 +0,0 @@ - - - -
- Image Support -
    -
  • -

    PNG

    -
    • -
  • TIFF
    • -
  • JPEG
    • -
  • BMP
    • -
  • GIF
    • -
  • EPS (PostScript output only)
    • -
  • EMF (RTF output only)
    • -
-
diff --git a/src/documentation/poster/xml/fop-output-formats.xml b/src/documentation/poster/xml/fop-output-formats.xml deleted file mode 100644 index b5f9e277c..000000000 --- a/src/documentation/poster/xml/fop-output-formats.xml +++ /dev/null @@ -1,41 +0,0 @@ - - - -
- Output Formats -

- Apache Fop supports a range of different output formats: -

-
    -
  • -

    PDF (Portable Document Format)

    -
      -
    • PDF/X-3:2003
      • -
    • PDF/A-1b
      • -
    -
    • -
  • PostScript
    • -
  • PCL 5
    • -
  • AFP (MO:DCA)
    • -
  • Java2D (Direct Print, TIFF, PNG, AWT/Swing Preview Dialog)
    • -
  • RTF (Rich Text Format, compatible with MS Word)
    • -
  • Plain Text
    • -
  • Area Tree XML (Intermediate Format)
    • -
  • ... or your own format!
    • -
-
diff --git a/src/documentation/poster/xml/fop-overview.xml b/src/documentation/poster/xml/fop-overview.xml deleted file mode 100644 index dc889ad80..000000000 --- a/src/documentation/poster/xml/fop-overview.xml +++ /dev/null @@ -1,42 +0,0 @@ - - - -
- What is Apache FOP? -

- Apache FOP (Formatting Objects Processor) is the most popular XSL-FO implementation. - It is used to create documents in PDF, PostScript and other formats. -

-

- XSL (eXtensible Stylesheet Language) is a W3C standard which consists of two parts: -

-
    -
  1. XSL Transformations (XSLT)
    2. -
  2. XSL Formatting Objects (XSL-FO)
    3. -
-

- Apache FOP currently supports a large subset of XSL-FO 1.0 and some of the new features - to be introduced with XSL-FO 1.1. Details on the compliance levels can be found on the FOP - website. -

-

- The software is written in Java and published under a liberal license, the - Apache License version 2.0, which allows commercial use and redistribution. - For details, please read the license text and the license FAQ on the ASF website. -

-
diff --git a/src/documentation/poster/xml/fop-poster.xml b/src/documentation/poster/xml/fop-poster.xml deleted file mode 100644 index 419378b27..000000000 --- a/src/documentation/poster/xml/fop-poster.xml +++ /dev/null @@ -1,31 +0,0 @@ - - - - - Apache FOP -
-
-
-
-
-
-
-
- -
- diff --git a/src/documentation/poster/xml/fop-transformation-chain.xml b/src/documentation/poster/xml/fop-transformation-chain.xml deleted file mode 100644 index 58c8de856..000000000 --- a/src/documentation/poster/xml/fop-transformation-chain.xml +++ /dev/null @@ -1,33 +0,0 @@ - - - -
- Transformation Chain - - - -

- This diagram shows a complete transformation chain (exemplary). It begins with your data source, - from which the data for the document is extracted as an XML file. The generated XML is then - converted to XSL-FO using XSLT (based on the transformation rules in an XSLT stylesheet, see the - example below). - Apache FOP receives the XSL-FO document and converts/formats it to the desired target format. - If you create a PDF you might stream it to the user's browser or send it to your client by - e-mail, or if you create a PostScript file, you might print it on a printer. -

-
diff --git a/src/documentation/poster/xml/fop-use-cases.xml b/src/documentation/poster/xml/fop-use-cases.xml deleted file mode 100644 index d2f4878a5..000000000 --- a/src/documentation/poster/xml/fop-use-cases.xml +++ /dev/null @@ -1,64 +0,0 @@ - - - -
- Use Cases - - - - - -

Business Documents

- - -

Book-style Documents

- - - - - - -
    -
  • Invoices
    • -
  • Letters
    • -
  • Insurance Policies
    • -
  • Forms
    • -
  • Reports
    • -
  • Business Cards
    • -
  • etc. etc.
    • -
- - -
    -
  • Books
    • -
  • Manuals
    • -
  • White Papers
    • -
  • Technical Specifications
    • -
  • Web Pages as PDF
    • -
  • etc. etc.
    • -
- - - - -

- Apache FOP is actively used by all sorts of people and organisations: Insurance companies, - banks, other commercial firms, governments, technical writers, web publishers, in web shops, - etc. -

-
diff --git a/src/documentation/poster/xml/hello-world-in-fo.xml b/src/documentation/poster/xml/hello-world-in-fo.xml deleted file mode 100644 index bfa4c9758..000000000 --- a/src/documentation/poster/xml/hello-world-in-fo.xml +++ /dev/null @@ -1,41 +0,0 @@ - - - -
- Hello World in XSL-FO -

- XSL-FO is for print documents what HTML is for browsers. Here's what a minimal XSL-FO - document looks like: -

- - - - - - - - - - Hello World! - - -]]> -
diff --git a/src/documentation/poster/xslt/common.xsl b/src/documentation/poster/xslt/common.xsl deleted file mode 100644 index 5b02f52fd..000000000 --- a/src/documentation/poster/xslt/common.xsl +++ /dev/null @@ -1,100 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 6pt - - - - - - - - - - - - - - - - - - 6pt - - - • - - - - - - - - - - - \ No newline at end of file diff --git a/src/documentation/poster/xslt/fop-poster.xsl b/src/documentation/poster/xslt/fop-poster.xsl deleted file mode 100644 index dca0f6cfc..000000000 --- a/src/documentation/poster/xslt/fop-poster.xsl +++ /dev/null @@ -1,159 +0,0 @@ - - - - - - - - - - - - - - - - - - - Apache FOP Poster - Apache FOP Plakat - - - - - Jeremias Märki - - - Apache FOP Poster - Apache FOP Plakat - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Apache FOP - The leading open source XSL-FO formatter - - - A product of the Apache XML Graphics Project - - - - For more details, please visit: http://xmlgraphics.apache.org/fop/ - - - - Poster generated with Apache FOP and Apache Batik - - - The sources for the poster are available under: http://svn.apache.org/repos/asf/xmlgraphics/fop/trunk/src/documentation/poster - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/src/documentation/poster/xslt/poster.xsl b/src/documentation/poster/xslt/poster.xsl deleted file mode 100644 index f3933abc4..000000000 --- a/src/documentation/poster/xslt/poster.xsl +++ /dev/null @@ -1,41 +0,0 @@ - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/src/documentation/resources/images/EmbeddingExampleFO2PDF.png b/src/documentation/resources/images/EmbeddingExampleFO2PDF.png deleted file mode 100644 index 47551f4daff90e9d34e028f0a6fc59a8c1ad9556..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1311 zcmV+)1>pLLP)pF33NqRbVF}#ZDnqB004<9jRpV!1iVQ^K~#90?N|Fx990+KcJ*(bdi?yf!3Dzh-r=PCbT6&TQmw?O`$%a zY8xyTU1_1KX;Vxgu?uv0v+VJ^cOE-CGYiuS(H}g?-1+XeXU{$J-Mw?~I;u+)TnFJ} zId+sl!9e|NI|6ddvtbkh9Rs`@Km%iPR^iH7g{wkzmDqs%1I2VJQ@V^dE}peO zG%=cn0n`Vd&aQh#8(T*mjc*Vg5}#Eaax@8Q9>eo4h3ba$f&_XXqQ3H|j;g4#)ljHW zBXm@KI+UnEaxwH3G1o;y5SQ_pF=@%fm_?45+dM#)BzgsSJn>NnZ%XNksLYWqK$?WT zO}zeJ>X<=lHeS$a&LGYL5|e9k-!LX=vZD+5w1UG_&uHSqq_oA{n=xRK3s~e7ecPJ# z!C)^CLi>cvmgaYFP(`udnQqA7eXYVku&e2qJ^i?;q4@N~mkcHlR||-xFO5W~OlZ$E6kFwzkBzGooM9zyfagAl=>NUqb1u$slGnO%TgUH?R zQF}L`IqM#I0o6eKfU3EPu6PbGSpcg!a>rCny0+hF1J=Q3c=qOWV2bS;)_iX8`y=Q1 zTIb8I(zrC68S`kGpB(0z=LUUzIqNh%?rDBI_@dA(EEGP^_9&WWpDai9*>I{KT=V#_ z!RLvKRMOljAY1?JpdIh#ZcEK+=$>6@N`_~TJAHtJ~un$2%&3Fm0j zuG{@C?OGqz)*d=Js<)YX9#SH@^fv2{@pdvROzqLV@X~2uF7vMh@xNlTfU0@Fvxvt- ztKeOm?J2sVBmP61q0TvR|1m_(@K=pLh?(lTrKk6G%HZ)_sHN#AE1RO4D6gHz@YYX7 zHItBJ^Jfyf)H_1a1VvrFVvj&r8D_@9CJsv9(`hT?JzB+5<2EO$%* z_$96Q4?3C@t_T@zYM3#e-S17CY~~k_jg8)ZTdJp5<(aY3@WnhQ3HsK^!^Ev@BJ8ZH zaP#whGYgC>IfKnjO3=qzhvYEMl{kk-^b3(J(#;(FA ziD52V+w{7Ix+L1nV!PyjWUo3CHs7kMs`?^P&D+umIXINAEMhy=bT`F}lU}Mus?CZu z3s+F6Ev1wX<6KfNYirIVP2Asy1==iM6Nu`vR+JAVgl;JVErTOLNd`fnP3 V{y5?h-lhNm002ovPDHLkV1hZwf64#= diff --git a/src/documentation/resources/images/EmbeddingExampleObj2PDF.png b/src/documentation/resources/images/EmbeddingExampleObj2PDF.png deleted file mode 100644 index 3d853d50019670633516d1b04893d348c0c2a23a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2822 zcmV+h3;FbkP)e700009a7bBm000id z000id0mpBsWB>pF33NqRbVF}#ZDnqB004<9jRpV!3ZqFxK~#90?OF>|6xSKP3#uc$=PXj6@1H5)X>Qou|8kY1*EC=dg3zhF1O4aZRF@G3?u zcT~l;X$OX)m8{YM4E$(@q{R+w2&$MPX}t(4gL&E?Jo{;eHdmsy7MEmvXlM@u4pl4s zPtnjTEd<5oV2w(`dk%$1a=-N%@QSsECLrNJzyW1w;pV&y-9wPcjxkt@S8oz#rlGTm z{NXWVkh?#aA8nsLJB33&t#c^OBG(+cO{~g>tEVYm44-@hH1X&Q4 zdg&=Z+B#ZTgFINIS7~T3j5{t1-Jbpq&6YTEjftbVm8=L|z+Vhshr-A;7%ICso`v2> z+fZ*0{nOLuo}%t87Au-b6D)}&Pq0fCcwhaxLp|oGq3q8bs3p*`>3uy$FQjSL0VO9Sq+iTMeK#)k z36wo5*&5unA}FATgmk?>5Ms?Y_;ts+a?V;w2pNyH?mpv0(zKtQ>oEx8+{%;oBIF4= zk`lui#L_x73ep*$QwEV32oEg2$V~k11t96p*iiv zei&)u7L@>j57d+I2e1&VPxHsDcyHca(;ohqNw~%Nh<7b=}A5+`$EC)tjmB zPW0PTt7VMPb?>ijF4L_b;*6G2KLM(oah|cZ5Me+c%;k+vIM;trmN)8P0PTh5-uw{i zD(60CGlpkGVe8ffP30Vrjr%vI;Z_h_;*3wGASt1aau!y>u5;dfcnKZbaHl+`iJVJl z20v$d8h=`3bB*&;LD+#!jp0n&3nYlW*aglSizZIzE?sXXpkZwh{H2^*0KdEA{VMQj zGdjFWIM27?*~6hGv=5MSj<|~IK?rV33hnoy^BO^eSD;(9gfk-hWhpsRzj^Fuq)Z(^8oUjZyn?d=CP8OHr@ZR-SzGO#*$>RmDgp~6K8XM!zRV}J=8{$Vq4rj4puHH>&Z!@Ccn{nC5=1H9|t+*4!zCM1sI zTtn!%?i-RVK2MU8vJ+itVUCq@R@I9l#=&;Z4~Ve3X_t~xrr?}oGVZj#^Og;>{D_Xu zVa6*$J{zcuHzuXx;X0GCyw0m8Z)b-LH}3Y4k!9Q+y3oIuZJIi}6$v^INzLFJ>Y>y* zftvf{>&-B@u}FHHFWd9E_pLimQO?bcYR*^by0WAWtClCGap#P4#Q^v{*t?A_iln*G z(#jXqoG(L?8=TXp82z-$>ZijQ0%!9Iy1v=yjgQkPXWBCsNjT@) zj$6@rB7#vYa%RK~h$k)2G4CilXAB`B(BupSXVQ8Z)cLG|#?6Dd6R!m2kqjWlhZ_%)*=JPX`O;|9sB4t2F-{oKLE^y#lm3>$>Z#k-pQdAVTx)Oth~1 zNfND3S{H*go1=+{;zy2tS*P{dh&lS`{56oFxro;kvk`)wplg2pgw};a=ezH{ynx$8 zE&YaWZr?5f9xSYsx<)+eYY|9iryrKnDd+pYp*Cg8f?QzPb>Lzm!*bCj#)S^!0?vp! zr?B`ZfIY8G+)@Y3OH6!gw^icV7{RKVsB^v7E#Si=bRyl<_cT2pH}8{(I+<(JbVf;s zvqQGhO)(WS?Mnm|a>kL;SND%y=RVw9&CKq!9d!eC!ILgDzv&_I{3Ub-PA>dSm$OJ8 zaqX-R4RkO3$#S`C6LrR+7O$~G&f)=`Pyd^A{^RV~EAhrMR^Ao^&yE3sV=qfQAB)a4 zmU2B`2}GT*`{w~~CzQ0O5C3q8ZF}$g^#fPQTpc>!x8!lh8F3=JI6nh5LxZjY{WyqJBxLhIAgRzOUoN=YS-i zZw2^`h(G+|E54 zu#QOcrjoo{!El?>FfOWrbyw@Y!gDyIo(FF!*G~KmWrBH4uc#>haT?i<405odJa<=6 zn~OkfSMD|y;ul0sog3!3x9dd4+RBZ8rIt;eRd*+ofDVRP4lkG18)3v4e?>lSBpcFN zPh|z~q)2w$7Mkp;&KigzhOq_Gabs$Woz0S2A*h$|#$2WI8lg0|xgg@ep8QcmXBDD| z+xQ}d&fJ~^fiYBP{%h5QR#wD@Dr#!#e2Kj)C?M(BXSjeO!x8+*zHS~Oj_%!0y(L#8 zjBcYm6Q7Zd&wnPr<@%C$QklnolpBjRb=KO!YaoW+z$0$BLucFX$xD3cYUS+*o$AS(2#p#mN+vj(lF?eu+EQ1rOm3F6Hw`rkqwj z1ES6Yy2D96Pi*sLR=<|_F{*W8!-+tWN=<{FU>p1J;45`U{Kyw#wMW^fICP$FWK2#r zi{*62C>ER3x$SO-v!bI+=k9dfydsSKe@X0o)Px;D@M`n6s7c~=yUq*SG6&jOg=@p-R-M>shrMIJofdoGyD(gjHP~^=cD)6w3OFs)d0Fk zPwQ6mf1S0^#T3t{f)K&&ry3>CwZRUU-xy%xMIFt(*SE)f>)ej9@eW Y1swNCD;l0BA^-pY07*qoM6N<$f(Kl6B>(^b diff --git a/src/documentation/resources/images/EmbeddingExampleObj2XML.png b/src/documentation/resources/images/EmbeddingExampleObj2XML.png deleted file mode 100644 index f87bfc3fd5397f023e78c796080c30d5f01cd4a9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1198 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 FV1i{c`2PR^ diff --git a/src/documentation/resources/images/EmbeddingExampleXML2PDF.png b/src/documentation/resources/images/EmbeddingExampleXML2PDF.png deleted file mode 100644 index 967b8e3aeb861e9a085e1455cce0fd776a940dc9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2148 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 ift3e9;AhzwiBDMXBn_M01yk - - - - - - - - - - - - - - - Cell 1/1 - - - Cell 2/1 - - - - - Cell 1/2 - - - Cell 2/2 - - - - - - - - - - - - Cell 1/1 - - - Cell 2/1 - - - - - Cell 1/2 - - - Cell 2/2 - - - - - - - diff --git a/src/documentation/resources/images/apache-xml-graphics.gif b/src/documentation/resources/images/apache-xml-graphics.gif deleted file mode 100644 index 273ca90d3fcb69d4dbb4d8e8e6c61fe04ce66126..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 7317 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 EKjA8aA^-pY diff --git a/src/documentation/resources/images/apache-xml-graphics.png b/src/documentation/resources/images/apache-xml-graphics.png deleted file mode 100644 index 177f67af9c3393eb2bd7a69ab14ec28341480d5b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 20382 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 N002ovPDHLkV1m~dH{JjM diff --git a/src/documentation/resources/images/apache-xml-graphics.svg b/src/documentation/resources/images/apache-xml-graphics.svg deleted file mode 100755 index 2122671ec..000000000 --- a/src/documentation/resources/images/apache-xml-graphics.svg +++ /dev/null @@ -1,580 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - The Apache™ - - - - - - - - XML Graphics Project - - - - - <?xml version - <!DOCTYPE - - - - - - - http://xmlgraphics.apache.org/ - - diff --git a/src/documentation/resources/images/design/alt.design/AbsolutePosition.png b/src/documentation/resources/images/design/alt.design/AbsolutePosition.png deleted file mode 100644 index ed8a3691b67ad0801e6966e7877dfc817e575c8d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 4890 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 EUx>^_q5uE@ diff --git a/src/documentation/resources/images/design/alt.design/PropNames.png b/src/documentation/resources/images/design/alt.design/PropNames.png deleted file mode 100644 index 8287e087570f0902801bf2deb31fef943909164b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3428 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 diff --git a/src/documentation/resources/images/design/alt.design/PropertyStaticsOverview.png b/src/documentation/resources/images/design/alt.design/PropertyStaticsOverview.png deleted file mode 100644 index fdda19e74e1cb6c2aadbd4e77280d23a9a8776a4..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 7503 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 KXymF{hW=mim;2)Y diff --git a/src/documentation/resources/images/design/alt.design/XMLEventQueue.png b/src/documentation/resources/images/design/alt.design/XMLEventQueue.png deleted file mode 100644 index 477abd79a63924d490c445f6865aeb3eef8f9a3f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 11643 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 Jd6I^H{{v+pZ=e7G diff --git a/src/documentation/resources/images/design/alt.design/block-stacking-constraints.png b/src/documentation/resources/images/design/alt.design/block-stacking-constraints.png deleted file mode 100644 index 2387a815add7d66ebc7b3ecd2ff79cec58cb5c11..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 5358 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 ZaG}aZ{?U_$^}jdeR24O$W%94z{s-hjl2-r# diff --git a/src/documentation/resources/images/design/alt.design/block-stacking.png b/src/documentation/resources/images/design/alt.design/block-stacking.png deleted file mode 100644 index afc2b0a66d5c09f4872f9125ce8543c8c2d8fca3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 5956 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 diff --git a/src/documentation/resources/images/design/alt.design/coroutines.png b/src/documentation/resources/images/design/alt.design/coroutines.png deleted file mode 100644 index d00478a6a7fcfe0e44cbaa1d0ff006d5416f8042..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6025 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 OgJh)?KUPW@2me1|ljI!$ diff --git a/src/documentation/resources/images/design/alt.design/galley-preprocessing.png b/src/documentation/resources/images/design/alt.design/galley-preprocessing.png deleted file mode 100644 index 3a87d58f394598eec9f415e61d4254efef59ecb1..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 20744 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 UJQ4$*f5*V!>FVdQ&MBb@00`Z{u>b%7 diff --git a/src/documentation/resources/images/design/alt.design/initial-column-values.png b/src/documentation/resources/images/design/alt.design/initial-column-values.png deleted file mode 100644 index 103887e078a99847f04f9a7618d88ab51c52d775..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10965 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 XLw&Gs#2)xRRfwvhmO_EtgO~pSmqsc$ diff --git a/src/documentation/resources/images/design/alt.design/line-area-5.png b/src/documentation/resources/images/design/alt.design/line-area-5.png deleted file mode 100644 index 6c467be244abe61f496f4913fb489a487336733f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 22400 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 diff --git a/src/documentation/resources/images/design/alt.design/line-area-6.png b/src/documentation/resources/images/design/alt.design/line-area-6.png deleted file mode 100644 index 0001a0a4be2a580abe228a9792e6990dbe616033..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 20801 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 a(D@Y%>E1id#RM+U0;H;>g+MDj4EaAus@Mbo diff --git a/src/documentation/resources/images/design/alt.design/processPlumbing.png b/src/documentation/resources/images/design/alt.design/processPlumbing.png deleted file mode 100644 index 182d3c68ee4adfec1b012b8782feea153721c9b8..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 8689 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 jaxbfG5@Ih?|HYw{uQDOLGIj;u;eey;1 diff --git a/src/documentation/resources/images/design/alt.design/property-super-classes-full.png b/src/documentation/resources/images/design/alt.design/property-super-classes-full.png deleted file mode 100644 index dea871d3c2d85881574640db7af87667d9c9ed71..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 89360 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�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

- Apache™ FOP 1.1 contains bug fixes and a number of new features. See - Release Notes for a list of - the most important changes. -