From 06a4ad36f67612273f489f1b6468805b9d5871c7 Mon Sep 17 00:00:00 2001 From: Keiron Liddle Date: Mon, 28 Oct 2002 08:41:01 +0000 Subject: [PATCH] updated docs for dev version using new forrest docs git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@195365 13f79535-47bb-0310-9956-ffa450edef68 --- forrest.properties | 27 + src/documentation/content/xdocs/book.xml | 14 + src/documentation/content/xdocs/dev/book.xml | 16 + .../content/xdocs/dev/configuration.xml | 45 + .../content/xdocs/dev/examples.xml | 14 + .../content/xdocs/dev/extensions.xml | 95 ++ .../content/xdocs/dev/fo/embedding.fo | 1106 +++++++++++++++++ src/documentation/content/xdocs/dev/index.xml | 92 ++ src/documentation/content/xdocs/dev/svg.xml | 234 ++++ .../content/xdocs/dev/svg/images.svg | 41 + .../content/xdocs/dev/svg/link.svg | 30 + .../content/xdocs/dev/svg/paints.svg | 83 ++ .../content/xdocs/dev/svg/text.svg | 131 ++ .../content/xdocs/dev/svg/transparency.svg | 48 + src/documentation/content/xdocs/index.xml | 14 + src/documentation/content/xdocs/tabs.xml | 12 + .../resources/images/group-logo.gif | Bin 0 -> 6945 bytes src/documentation/resources/images/logo.jpg | Bin 0 -> 2721 bytes src/documentation/sitemap.xmap | 527 ++++++++ src/documentation/skinconf.xml | 93 ++ 20 files changed, 2622 insertions(+) create mode 100644 forrest.properties create mode 100644 src/documentation/content/xdocs/book.xml create mode 100644 src/documentation/content/xdocs/dev/book.xml create mode 100644 src/documentation/content/xdocs/dev/configuration.xml create mode 100644 src/documentation/content/xdocs/dev/examples.xml create mode 100644 src/documentation/content/xdocs/dev/extensions.xml create mode 100644 src/documentation/content/xdocs/dev/fo/embedding.fo create mode 100644 src/documentation/content/xdocs/dev/index.xml create mode 100644 src/documentation/content/xdocs/dev/svg.xml create mode 100644 src/documentation/content/xdocs/dev/svg/images.svg create mode 100644 src/documentation/content/xdocs/dev/svg/link.svg create mode 100644 src/documentation/content/xdocs/dev/svg/paints.svg create mode 100644 src/documentation/content/xdocs/dev/svg/text.svg create mode 100644 src/documentation/content/xdocs/dev/svg/transparency.svg create mode 100644 src/documentation/content/xdocs/index.xml create mode 100644 src/documentation/content/xdocs/tabs.xml create mode 100644 src/documentation/resources/images/group-logo.gif create mode 100644 src/documentation/resources/images/logo.jpg create mode 100644 src/documentation/sitemap.xmap create mode 100644 src/documentation/skinconf.xml diff --git a/forrest.properties b/forrest.properties new file mode 100644 index 000000000..e6839f1d9 --- /dev/null +++ b/forrest.properties @@ -0,0 +1,27 @@ +############## +# Properties used by forrest.build.xml for building the website +############## + +# 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 + +# Properties that must be set to override the default locations +#project.status=status.xml +project.content-dir=src/documentation +#project.conf-dir=${project.content-dir}/conf +project.sitemap=${project.content-dir}/sitemap.xmap +#project.xdocs-dir=${project.content-dir}/content/xdocs +#project.stylesheets-dir=${project.content-dir}/resources/stylesheets +#project.images-dir=${project.content-dir}/resources/images +#project.schema-dir=${project.content-dir}/resources/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 + diff --git a/src/documentation/content/xdocs/book.xml b/src/documentation/content/xdocs/book.xml new file mode 100644 index 000000000..e1c2550be --- /dev/null +++ b/src/documentation/content/xdocs/book.xml @@ -0,0 +1,14 @@ + + + + + + + + + + + diff --git a/src/documentation/content/xdocs/dev/book.xml b/src/documentation/content/xdocs/dev/book.xml new file mode 100644 index 000000000..e17c4895d --- /dev/null +++ b/src/documentation/content/xdocs/dev/book.xml @@ -0,0 +1,16 @@ + + + + + + + + + + + + + diff --git a/src/documentation/content/xdocs/dev/configuration.xml b/src/documentation/content/xdocs/dev/configuration.xml new file mode 100644 index 000000000..894da78ca --- /dev/null +++ b/src/documentation/content/xdocs/dev/configuration.xml @@ -0,0 +1,45 @@ + + + +
+ Configuration +
+ +
+ Configuring FOP +

+In the directory xml-fop/conf you will find an example +configuration file. It contains the default values of various +configurable options available in FOP. +

+

The file fop.xconf is not read automatically, the user + must specify it on the command line or if embedding then + configure the appropriate classes. +

+
+
+ Setting up Hyphenation +

Fop comes already with some hyphenation patterns. If you + need a hyphenation pattern which isn't included in the + distribution, do the following: +

+

1. get the TeX hyphenation pattern file and turn it into an xml file which conforms + to the hyphenation.dtd in the sub directory /hyph +

+

2. name this new file following this schema: languageCode_countryCode.xml. If you don't need + a country code, leave it out, e.g the file name for an American english hyphenation pattern + would look like this: en_US.xml. For an Italian file: it.xml. Language and country codes must be + the same as in xsl:fo, that is follow + ISO 639 + and ISO 3166 + respectively. NOTE: The ISO 639/ISO 3166 convention is that language names are + written in lower case, while country codes are written in upper case. +

+

3. If you have build your new hyphenation pattern file + successfully you put the file into the /hyph directoy + and rebuild Fop. The file will be picked up and added + to the fop.jar. +

+
+ + diff --git a/src/documentation/content/xdocs/dev/examples.xml b/src/documentation/content/xdocs/dev/examples.xml new file mode 100644 index 000000000..89975a21d --- /dev/null +++ b/src/documentation/content/xdocs/dev/examples.xml @@ -0,0 +1,14 @@ + + + +
+ FO Examples +
+ +
+ +

+

+
+ + diff --git a/src/documentation/content/xdocs/dev/extensions.xml b/src/documentation/content/xdocs/dev/extensions.xml new file mode 100644 index 000000000..bc6ceeb5a --- /dev/null +++ b/src/documentation/content/xdocs/dev/extensions.xml @@ -0,0 +1,95 @@ + + + +
+ Extensions to FOP +
+ +
+ Overview +

+If the default funtionality of FOP needs to be extended for +some reason then you can write an extensions. +

+

+There are three types of extensions possible. An output document +extensions such as the PDF bookmarks, an instream-foreign-object +extensions such as SVG and an fo extension that creates an +area in the area tree where normal xsl:fo is not possible. +

+
+
+ Default Extensions +

+These extension are available by default. They are automatically loaded +and you only need to provide the correct namespace for your embedded +xml markup. +

+
+ SVG +

+Please see the SVG page for more details. +

+

+The SVG extensions gets all the xml elements in the SVG namespace +and builds an SVG DOM with batik. The SVG DOM is then rendered +to the output format using a handler for the XML content of +the instream-foreign-object. +

+
+
+ PDF Bookmarks +

+To use this standard Fop extension, you need to add a namespace entry for + http://xml.apache.org/fop/extensions on the root element.

+ +

You can provide outlines inside the root object (but outside + any page-sequences or + other formatting objects). Here's an example of an outline entry:

+ + + + + Running FOP + + + Prerequisites + + + +]]> +

It works similarly to a basic-link. There is also an external-destination + property, but it isn't supported currently. See the pdfoutline.pdf for a more complete example. +

+
+
+
+ Adding Your Own +

+To add your own extension you need to do the following things. +

+

+Write code that implements your extension functionality. +There are some examples in the contrib/ directory. +

+

+Create a jar file with your classes, it must also include the +following file "/META-INF/services/org.apache.fop.fo.ElementMapping". +In this file you need to put the fully qualified classname of +your element mappings class. This class must implement the +"org.apache.fop.fo.ElementMapping" interface. +

+

+Create your fo file with the extra xml data embedded in the file +with the correct name space. The examples for svg and +pdfoutline.pdf +show how this can be done. +

+

+Put your jar file in the classpath and then run fop over the fo file. +

+
+ + + diff --git a/src/documentation/content/xdocs/dev/fo/embedding.fo b/src/documentation/content/xdocs/dev/fo/embedding.fo new file mode 100644 index 000000000..4570ad057 --- /dev/null +++ b/src/documentation/content/xdocs/dev/fo/embedding.fo @@ -0,0 +1,1106 @@ + + + + + + + + + + + + + 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/index.xml b/src/documentation/content/xdocs/dev/index.xml new file mode 100644 index 000000000..73aa550f9 --- /dev/null +++ b/src/documentation/content/xdocs/dev/index.xml @@ -0,0 +1,92 @@ + + + +
+ FOP 1.0 development +
+ +
+ Introduction +

+These pages contain information that is relevant to the +current development of FOP. +

+

FOP is the world's first print formatter driven by XSL formatting + objects and the world's first output independent formatter. It is a + Java application that reads a formatting object tree and then + renders the resulting pages to a specified output. Output formats + currently supported are PDF, PCL, PS, SVG, XML (area tree representation), + Print, AWT, MIF and TXT. + The primary output target is PDF. +

+ +FOP - someone who is overly concerned with style, also conveniently +can mean Formatting Object Processor. + +

+

+

+

The latest version of Fop is 0.20.4 and it supports the + XSL-FO Version 1.0 + W3C Recommendation. + You can download + Fop including a precompiled version, the source code and many example files to + get you started. Pointers to introductions into xsl:fo can be found in the + resources section. Please be aware, that + Fop is at the moment not a full implementation of the basic conformance level + of the xsl:fo standard. You can find a list of supported flow objects and properties + in the section Features and in section + Limitations in what way this support is + limited. +

+

FOP is part of Apache's XML project. The homepage of FOP is + http://xml.apache.org/fop. + Here you can find information about using and developing with FOP. +

+

Users can subscribe to fop-user@xml.apache.org by sending an email + to fop-user-subscribe@xml.apache.org + this is where user specific topics are discussed. +

+
+
+ Formatting +

+

+

+

+This image is a demonstration of a two page document. The xml data on the left +is formatted into the two pages on the right. The document contains static areasthat appear on every page, an external graphic in this case an svg document. +There is a footnote on the first page and a table that goes across both pages. +

+

+The advantage of XSL is the ability to take an XML document and to format +the information into a page layout. The XML document can be generated +in any way, the most common would be to use XSLT. FOP takes the XML +and formats the data into pages. The pages are then rendered to the +requested output. +

+

+This is a real document. The image was created by rendering the document +to the svg renderer then putting the rendered pages into an svg document +along with the xml. +

+
+
+ FOP Objectives +

+The goals of the Apache XML FOP Project are to deliver an XSL FO->PDF formatter that is compliant to at least the Basic + conformance level described in the W3C Recommendation from 15 October 2001, and that complies with the 11 March 1999 Portable Document + Format Specification (Version 1.3) from Adobe Systems. +

+ +

Conformance to the XML 1.0 Recommendation, XSLT 1.0 Recommendation 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. +

+ +

To reach this aim currently the layout system is being redesigned to +better handle the formatting of all different types of formatting objects. +

+
+ + diff --git a/src/documentation/content/xdocs/dev/svg.xml b/src/documentation/content/xdocs/dev/svg.xml new file mode 100644 index 000000000..9205cc5bc --- /dev/null +++ b/src/documentation/content/xdocs/dev/svg.xml @@ -0,0 +1,234 @@ + + + +
+ SVG in FOP +
+ +
+ Introduction +

+FOP uses the SVG library from +Batik to handle SVG. +This format can be handled as an fo:instream-foreign-object +or in a separate file referenced with fo:external-graphic. +Either way the SVG document will be read in and converted into a +DOM in Batik. This DOM will then be used by the renderer to +create the graphical image. +

+

+The AWT and Print renderers simply use batik to draw the SVG into a graphic. +

+

+In the case of the PDF renderer there is a PDFGraphics2D class that Batik uses +to render the image into. This class converts the drawing instructions into +PDF markup which is placed into the current PDF document. +

+
+
+ Converting SVG to a PDF Document +

+It is possible to convert a standalone SVG document directly +into a simple page PDF document. +This is possible through the use of Batik's transcoder mechanism.
+java org.apache.batik.apps.rasterizer.Main -m application/pdf document.svg +
+This will output the svg document as "document.pdf" containing +a PDF rendering of the SVG file. +

+

+It is also possible to specify the width and/or height +of the PDF document on the command line with -w and -h or if +you are using the transcoder api you can use the transcoding hints. +

+

+Currently the SVG image is drawn at the SVG document size and +simply scaled in PDF to the new size. So the result may not be +the best possible. For example if you have any images or effects +it will draw them at the original resolution of the svg document. +When this is viewed in the pdf it will have an incorrect resolution +for the size of the pdf. +

+

+The size of the pdf file will also remain the same regardless of +what size the page is. +

+

+For more information see Batik +for how transcoders work. +

+
+
+ 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. + + + + + + + + + + + + + +
XSL:FO to PDF examples
fo filepdf result
embedding svgembedding.foembedding.fo.pdf
+

+
+
+ Important Notes +

+The svg is inserted 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. +

+

+There are a number of SVG things that cannot be converted directly into +PDF. Parts of the graphic such as effects and images are inserted +into the PDF as a raster graphic. The resolution of this graphic may not +be ideal depending on the FOP dpi (72dpi) and the scaling for that graphic. +

+

+Another important note is that text may be converted and drawn as a +set of shapes by batik. +If possible it will use normal PDF 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. +

+

+If the text cannot be drawn normally then it uses shapes. +This means that a typical character will have about 10 curves +(each curve consists of at least 20 characters). +This can make the pdf files large and when the pdf is viewed the +viewer does not normally draw those fine curves very well (turning on +Smooth Line Art in the Acrobat preferences will fix this). +If the text is inserted into the PDF using the inbuilt text commands +for PDF it will use a single character. +

+
+
+ 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 causing 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 +
    • +
  • +more pdf text handling could be implemented +It could draw the string using the attributed character iterator +to handle tspans and other simple changes of text. +
    • +
  • +JPEG images are not inserted directly into the pdf document +This area has not been implemented yet since the appropriate +method in batik is static +
    • +
  • +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. +
    • +
+

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

+
+
+ + diff --git a/src/documentation/content/xdocs/dev/svg/images.svg b/src/documentation/content/xdocs/dev/svg/images.svg new file mode 100644 index 000000000..4337bfa87 --- /dev/null +++ b/src/documentation/content/xdocs/dev/svg/images.svg @@ -0,0 +1,41 @@ + + + + + +Images in SVG + +Jpeg + + + +Effect or Bitmap + + + + + + + + + + + + +Transparency + +SEE + + + +Scaled + + + + + + + + diff --git a/src/documentation/content/xdocs/dev/svg/link.svg b/src/documentation/content/xdocs/dev/svg/link.svg new file mode 100644 index 000000000..5a6d28264 --- /dev/null +++ b/src/documentation/content/xdocs/dev/svg/link.svg @@ -0,0 +1,30 @@ + + + + + + + +GREEN + + + + +FOP + + + + +Another +file + + + + +RED + + + + + + diff --git a/src/documentation/content/xdocs/dev/svg/paints.svg b/src/documentation/content/xdocs/dev/svg/paints.svg new file mode 100644 index 000000000..ee0122e3b --- /dev/null +++ b/src/documentation/content/xdocs/dev/svg/paints.svg @@ -0,0 +1,83 @@ + + + + + +Paints - Patterns & Gradients + +Gradient + + + + + + + + + + + + + + + + + + + + + + + + + + +Pattern + + + + + + + + + + + + + + Patt + + + + + + + + + + + + + + + + + + + + + + + +Pattern in Pattern + + + + + + + + + diff --git a/src/documentation/content/xdocs/dev/svg/text.svg b/src/documentation/content/xdocs/dev/svg/text.svg new file mode 100644 index 000000000..8ac73ec51 --- /dev/null +++ b/src/documentation/content/xdocs/dev/svg/text.svg @@ -0,0 +1,131 @@ + + + + + +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.svg b/src/documentation/content/xdocs/dev/svg/transparency.svg new file mode 100644 index 000000000..ec3753b02 --- /dev/null +++ b/src/documentation/content/xdocs/dev/svg/transparency.svg @@ -0,0 +1,48 @@ + + + + + +Transparency in SVG (to PDF) + +Shapes + + + + + + + + + + + + + +Image + +SEE + + + + + +Text + +SEE +THROUGH + +Uniform Image Transparency + + + + + + + + + + + diff --git a/src/documentation/content/xdocs/index.xml b/src/documentation/content/xdocs/index.xml new file mode 100644 index 000000000..4c10c9510 --- /dev/null +++ b/src/documentation/content/xdocs/index.xml @@ -0,0 +1,14 @@ + + + +
+ FOP +
+ +
+ Introduction +

+

+
+ + diff --git a/src/documentation/content/xdocs/tabs.xml b/src/documentation/content/xdocs/tabs.xml new file mode 100644 index 000000000..c431ae015 --- /dev/null +++ b/src/documentation/content/xdocs/tabs.xml @@ -0,0 +1,12 @@ + + + + + + + + + diff --git a/src/documentation/resources/images/group-logo.gif b/src/documentation/resources/images/group-logo.gif new file mode 100644 index 0000000000000000000000000000000000000000..57e4b36a16e071d0141f657e3820de361e2d0f03 GIT binary patch literal 6945 zcmWlb_ghkpn_}^2LE!j?jjhW@xEt3rA(9 zg)=lWG%G7B8dmmZ(R{0S`2BpJAD%zpzOLuGAO8S97gx>#;0gQ%0Or2&D=RC!tmx$2 z%8ujb|D3dX;*c@rSoS%Y_K{^&X_3?w7QTckeP$o@0h2%78?dYqDUN11`^O5?H-y+# z8qtg|1r@(GjjRhQs*DJXX2wLjZ;50kr)T9k`KHG?B=>}KR~`U@v>Hc`tYvLxWOVeH zwOwW7`Kx*r%R0^`mX4O5F&hF?%p84P94lj8(&JpCmQ~`8hbL5)M%SBGEWqXMS^j5@ zE621dDs4BNJ{FnfU(5`M?KWebJ=6NZY;|_Q(U+#&;h_8ry~EO}`}6%C%WlSFLCI!r ztYv+(xXAFi`ws#F^6Fg6hC-s99i4)`1dUD2_ijI^GB5XDyW1}!e$=PrR^Wz|Z5wmk z55&2Yga>6C86aN^4C4aAPPSZ3@=Q2h-*|9W(NLuGhS1n$(oTMH>4U@0&CZ^SZ~km| zFB|c3ePikt>B1XNa=V@Hn#j!0cZluQPxFb{W5VB=@?P@tpETtNc&54its_G1wluhaKX!*5}KY z?=zH&m!roN}USI-qU@ZHO|hV8GFJb?ja#17F8Lx<#S1E;%tQdl3TB|N^&F8 z=O4@G)+c?PGH9yknDdDC@L|>NJ8tW{ZMXjhuXXO*61FCX2EB?m`#p!x@=v{bFk|Hz z@J1(7=9%A;zFSazW>lE+)U0TyZ8|5Ge>2qkaCNP@4|`a0cfD8Ur%~M;=MW3uICGyk zb5rv`A4Y=#?|Rp$x!1N=+2-cHak9;8Y;7G(j8|LvY+J+RSoy`7nAy^;tj}NUsx12B z-rbq!kDl+c&Ap!E`Pa{19~EDpA#_1d_>aGS{y3*Up0V$K8)EIAxBThL`k?J|kzqf7 z{kHLs+vy%*?-}-JSb2oHe~MLbJ38g+g$qUo1{DRTUf9xQEc&tP3d3Iz@c*&;|N8$; z0PqR`!g@@xXs8%gwb&vRH;){k8U;2oyIRJ|wd_+Dq+O?P72kiqUoW8h%)}Apb4?)wOWzzsG0|`S}Tw2&QtI#t$6kzHoVqcK^z4-wODM-#jfc8H+6B z<@T~xdEI9WA2QbWQ64j>soSLsv>8{AQoc9Gd%1m+0L9raQ{)005Q|j(VU?B5E;f2)XtfQ2Yfr)aQG)Z1_f|gZ^Cx}vPp}CLRwzS7pe=OQhS5q8x(Gc6 zzW@yWGUHpeSfonMVclQ%r__OLPBD3LfKzFf8N?Vbxr?o!wo~#g&csBNfB|co>OQ|V zaip`yK$0F~7x^y)<#*8_990TWD@#V253cDyX`|}H_D3~-c-if!%4Ct9QwZr_8BFTx z49qh`L(Moz_#z;vP|h#L?9r?AHmY1GWUe0Hrzo@={1!HW(-i|)l5Wl*NO8}(Ff_ld zuBa5Ba;f=;mh$V{m&k{<TG2oe?DQo6CxbA;@SWO=`QJ)nSbwgbSp$vvsv9VEI(l=qO%t1doX`nwZ+n{uAx z52*%;%2WbN;>UqjvrRo8>S@gZL$hJJs`hFrU6U3uIYpCdJPAN9WDQJ{m5Cz7@N(84gHK)>}c)&Z1pKZ|im-GCT5M z)9KSi;$Z>0Ug?j(nc=r*ILOF+6=|g-zDK})4R8CrLiI@!m;4u& zEcXMzm3>tdF>9sh;c`|z<=5)mebI*uKibu0b3>42sno$7z3S$Y_cmh&am`UlO9E@i z;gbeggI`GIN1e`1`dt2d^N>51!QeUjol6sMD z43Ao$?15Hf?_3w&VGVbk5tRrXf*d~>DnI@?f?(yP)0}rbkyK5l)f9>QE7<0JDB0Mm zNJ-aG%ewAGA%`&A32I^0>xO3c9zvSHd9+@Wk${q8PY!!BpDlh+uBS!Fw$VwoJ;p-0 zPE*$s49{d2xl%jga+S&|LiFL1pepk6AHA(vZ)KT=`Ji=e8n^Z$k%6 zr6cL}5|Ra#Q(ECNZj_`0q*D1hPK*3qXvu&l2}QcaQX{>r$C@)e_3q>;#j9JIpY}7< zG}GV%HnAuxVKbrUDJSvL*E#g|+=0c#8N!s}0G-#e>iav!8lTON={a)K`}A$9ZFGT! z*AOO%J*0Y80NtAAY8h!2Rt^S0G%F)YkZ4#VzaFbJFz5P@@G%iJROV3OwL;PnXI+wF zPktJ^hubEB;y0f!i+6lQ>XeUatq~FTyPFEf^k}=|v`^eY<@itXON@VuNQvJJ2^_eX za>eoS)1i@+666_KA;JWO0fZp_Ekc}LTNICR+u@t!T=s2J-!%Q`=c6dSekFzbf{1MUw;E$VpMZnHU2!7s$I&MRs!jI-d8yDkiuj@%I5YBD1g3s*v0Ag>( z$x#^!BRQ4n$21&olJmt4d(GbJ=~k?#>-Nsf6mL#pUs+j^6vb@^DLa|!3l-9;)9ruj zY{)D=R|7mg*~vQmjqo-Wi_}t68978alWzC9_iDXWW|EUIgz|u|#~*vg1J;XQZ2OHUt#cVOe;`!aYW9OtVd7nemZPt4f2$29 z3#NJqAL*V>^kZ0tU?j#BrSqv3tfHHD1yb(HPKpp2ekzeo+o~pzBrjnk$hK= z*b{<_m7!wAz$$L=$oU@k%>`4r0BQHM%g>>rH~7uh-WMr7I3Hw-GDAKRqXC@+Zpucn z3icwLfGf4AD*reW^!)gT-AXq_oh2NLm=4Yg!lar-A8jTnQHMdDLbT%opPv!EWb{~$ zbIHkqx_?LrEz>I+XGKbnS-8s_;sTOp#LfL#n;7GVv7$#!0T2yA5yn9-J+MH5N*edg zl0k!VT>L2bAbZ_bBaST#PhjBJ$f1&MlkFqu3l476{OEZ5;)zIZHY-YFit zL8cBc)I4xNzYt|E#%pr(?5LzMab6@BXC`zh0&oH$-hmGn$ukc#Fk7V1W`JTX!duA6 zk69pi7Ii{cdV)o9mxl&%`B8s`+AuH{_p!UrVz>yLZw9XwVzwl>I0#+pS#T{2E~Yw$ zy|U8-u;YO1;EJ4Z6mX06qUcD#W8!t|82BZj(zNVg(>u&)nAIT>yg0JaiHUVKw7B~c zUkMt>`Q~*9jn4)5qdbi@Xl9|EpfLI6qdvL z2msbf;;w%hSc9OeQ=)g&uG>Zz)`^nGT8LK}!a4@lT_UvXjYtAbyzQw9A>hZxH3(5r zSr|`l!4SV(iJggX0biV8RGM((NL3J)QO3nj^D61C8UpZ$x`JFT&)>N6z^CqL@ZTdI zF$#~MQrz&7sxoRm4Iwhki6RmEu!Pbr#N~+$E+dY5G8`l(-KG<05^#`#&yt}D+@m5n zUYA7_agQf!V?Ono$>pm=V#hduz@d|JVruV(Y3A60u$UMxg#5}%YH`FjdkT~QlxJ@qnkL@-#EzgR z1LOS31|neA9@dA#TfgZs5;w~1l-Pu}ckCev*ZUAQA5B7ekxTk`EzIjN+h#27zW~2!L(y*#+hf?G1Z?0cim<-eC{I2>wwY){EOKugOu6OD*_JnRl}?{?|%! zyb(PpkB$oWWxEoNr8ot($M{(!b{yvWc1}=kI{77@@!aKXV$SM{l0%wY6Tg&_-QrF+ z5!zm1OU%kPVe7#xrB1{EFQ=#xVLu+G2LKE6pg>+hPuTe}db_%J&0rbWf_15Wgy$it zWB0lX72SJ`_}1(QeaRo8$?>a1{`*F~|KY?}NFZDdHsf1vwa)51{)sTLKTTG~X8Bz* z$L#~ai5+#fADL=WDWxpnrh=F+!eLmDy^wg}z5XNu9ATZylwsoDW0g~JyAj&IT+C%2 z7$P$bOaY3u+lTn)bIaQ`81S#%=#My;y`9)4_^cKmzDRe*XOyt)pPGiH(5Xx z3(A)eFP+0x$zc-~`Q|T8N^9J)&~q&aAujex-yxFLUXvcy<;!Mffm+ZV%l4eLIkz95 z|DA-fTc~S#2u*ilgB5vYRJc$ADiHARw|_k2ms*SZn0mQ4Iowcxel~q4mY3W8Mv1^o zyG1R0>7#Vh{%`?9=^g{t5Mll9!OHQOKjp-W=WxC(NadgYp1%RoKg0=|GqD@>zYk7M z(_3VdkQYmungr1s@K8(}C{3j}l_UxUu<~T6v8g1KZ1A z8y{VHKYDboPj=6x)VGoRNS<#n2C)EK5Ia>(SizOm|EGE)7$NzJr!WejOFVVEaS9`z z>S7I1WuN4Qv(hI6~+6eC*s3wNm`wf{|ezdyHNSE|j6 z*?}QyPQ#w_B}jC=aNxvgj)mfyw$eW~l#ja;d|w2N`7k zBPnV#>tTJzjG7Qb8=M+oK@)M3SQ?@XbvJ3zO7O^(~3;54?3 zQFA;Uoc(p5y&vr$y6eKlrHZgxl5QKad$;5#D z(%L92>Z65t8MvfknX~uq@d_}QcfW1{*5FUvPXjN=%0;E1*+dK4_{4!?7|MT;oPjUd z5Uj3%qUmUR@nts_)CJ7nL7thNoHE@%)kVGThJe}&`gZ}!H3l(|rPLzBJWyccP5|Ew z2ZsNo{P-6wl~JPhVoWLqddmh<-G~Abh-FXP@u$%R5cl?+J^?iljmC+kSM*5^K{=81 zcH=;J=d*GR(beHfIPNK=#eeZ&Lhct2mdOS$$_a&h{8$S#3p{OFQ6U@`#m)aaTQoTP z`s7rVcuK5$F0}}H#I{vsDUEZ;UoxQoBuZ+V=-M(=bo=_tkzkABo>dg()z>C z4Io@-=UVysf8{s?BCN96`RvV=jLggWAMT|&NUcx43cKr~Xw1t8=F(1@u|c99s!Iq{ z8sRPF7>iQOaRv135Y{IV-`(9B9(-9X6V#z3qf@sKsgdxiZfoD}Bw9UW3tBY}{6_(Y9jM;-+`=?Y@O9u9kWaFo2 zm`pbM_nIq>qSwk2yebji?@E)habtKmF>pYtK>L-E3az9e+~(ILutzL?_t)dzzGm); z^6rz;w>T1}NqXsvdb@7bXKouYv*ngrYNK*+|<7YiT7?9LYdYl<6jRA ztCz7OOV)AEj8w0zs&mhUrH&&r?KFGn^=oqxbhUHhm~Ha2g$`?cuSVWE|I#YwV1?SC za_hT;4!$Y3W4z^lnl>}@F4u;VMx}=bl?--4|C`mB~JF4+UF2F_u_1Mzhy% zwfH%%vMGVS*sx!An_Xz>#5r9Uqa!q=D#gBHQ#dL^7vOCLzXWa39|98EwN+xeO7bI_ zldd{xyU*|iWqiQ)2fGSzswM*+Mkm}B?!UoXy^rv@JK_|BptnAAxR14}RJ1?O zxFf=Agc*KRb$Z+ zksvX+o?DnB{n;VV5W-n+)mzdyn9cNN-y@B=K}umYMG| E0B2`!4*&oF literal 0 HcmV?d00001 diff --git a/src/documentation/resources/images/logo.jpg b/src/documentation/resources/images/logo.jpg new file mode 100644 index 0000000000000000000000000000000000000000..1e1ef8fa3b47fa187caa57e5a127479bbde53bb6 GIT binary patch literal 2721 zcmb7?c{J1w7sr2NOk^Ls?93=M$D#S!0UiHU&-t+$V-uuTr_k8d9-gD3WoXnmq0bIrgMg{-~1Ol8+6F4~r z1oUvO&OWX#68;z;cL@u3R|!KS(_1I=fF8iY#B`SF49i*Ov#hKvY@9+|oE#jSV*CQ! zLNEy#xU__{)CGk4NKg zmaMd_*8d$RodA>>&;h7mkQBfG1%aWUlefS*0AK*0Uh!YS$N+|%`K6(`01%jg0m8(5 zmJ$4W0CYOc2!%+V;pS2F=H=75?HpDkrKGHDj!#aJzJk;= z|Kt73knvQJg8o(*K#>3J1~EXvl8W3sQc60v8J$n&0557Vq^Oz5`)5!RXYVW9WGcMbVMu2ycd;BnW2EYb}{$^B%L-+)tvnIeaav*Wimrn+@ zhsQ}&(ljqzne3b$8cZ634$?a6P)_v*h`S=}*YsXFi}{#ae~}I|r3DFwaGIDP#iPyo z5hjtj_n0i8!Mz5p7VWMwGA}N96^n12 zF=D$TLE=bvdU4xYd_pTTQYCTf(J+i|ucXXkV+gaHoHaGU6hz&JB@fm*xx)*HB7d7b zBNwQZI`rZ)il*#R4Vl}MJPa|nVS~J>S4|^D9$4(ggm$SFP)#z)wgBs{ag{lGpN$&|5{E(&xMj<-|h5M?#ws0wzFhM;60 zuEPVIAM5FT2`R+0-kIBpltr`kuF^kH2$vo3k%|i!G?i^ytwb-e#+r{Wr>RuG(YAA} z#Ym&#i*0RVpCMwWkn<4^+M-?eJS)ak)*j4ezQq_dQkuSyFOvno`ZYsm^O6M0V5&Ti z0uoUFLKcLrEj(WnXkL4v!y%%WCyt+IZy7_e^xcP{&k@T`qxkl>C`9xk}^7O6V<5Ytrn# zMqCJsyBmCqNNE;6u$N`t7n2*I>oC5FrSj+Jp8z`H+u|$yF2CB6{Q6xtj>9L2sg{i$ z-Ds?P6Z-m4(pXb?igkM0asmqHHK`69Tq?aLS>N!@@BM`c;iL4c zqy)!0Tw_h{o-)igV6>nFRBr)x>r3ceI3HIHj5*a+XFP74XkHlCY|e*c&XZl@i>8@% z`HUhQz7rqSa8m?5#|89=7LUe*1>E2~+N5VZ-f#X1*s|N9`Ji;*2w(Yxz8l~~W6_KR z1o=2okF#u*x6*rYyx!{ssC56i8*~RHwvb?N2OdteQt{`jiT;T(+R9mJXdAh{X6=_3 zTu$6K?1kk`yl$|_U;j>IOE}ZpP4lLs-jFXP8Eh~e`9obw*9*^wdYH~!cAXBq7g_c4 zL5>oVwWYsWzD90SCjyUN4#f{wB2O38kQ_J?TE(@ z-yTtFc~8;Z*0>uw?$70#4fDNE%Tz*Ajdkj}N0+=~A3e>G`r~}ZGFHvRQt)|~OkM4p z@}_VP?zSgf>ORnIBi(g^ysa2QBmai(;e=qX!H_w($jW%&KB7-fe{*4c+=Byc8yA=x zU5hi&n5EjR`l*uOPA2PlU07No9L@oa>gTz8eb^oTg#%0$h5S}9v@N=z0_a#0zqgl| z=#Z5?7gsy_*r@IB?g=m+%JOzKycRjxWANR@>;52Sb_T#TOV~?{7<^#Se%VsR-}Z;p z&v09z>n!L*HEFt#aOkUFy+4CvFsL_~~kY>)T5%DqmdF`?k_oH?>@H(pw5G z5fMU)nv@2%$*m9ko{pWkY}x!JpFA!H7JfjU0jaK$;``l2HYGNFU$F_DlJidVu zwRGphCA5>F+H|1z4rHLk23Any#^UvkQvb+Jr(@V%h^W|!0MS}b0AktO3Z_NyA;YUD zYp*WOYiitDb)%@S8aE`mmXgA`UbJF8bFlU@?@UkM{Sb3#;`LdCU=c+~g9+be*Ua8_ zu1xM+C@FlP37&Cw3fv^U?yLBE*Y66QKG7Svv9U29#xJQmWlmLKH{MeaFTz4#?KROT zX;Yph_T6k(15fKO tE2VFUAhw{}bG?bFc8( + + + + + + + + + + + + + + + + + + + + + false + false + false + + + + + + + + + + + + -//W3C//DTD HTML 4.01 Transitional//EN + ISO-8859-1 + + + + ISO-8859-1 + + + + + + + ISO-8859-1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/skinconf.xml b/src/documentation/skinconf.xml new file mode 100644 index 000000000..82d35a62f --- /dev/null +++ b/src/documentation/skinconf.xml @@ -0,0 +1,93 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ]> + + + + false + xml.apache.org + Apache XML + + + FOP + http://xml.apache.org/fop/ + images/logo.jpg + + Apache XML + http://xml.apache.org/ + images/group-logo.gif + + + + + + 1999-2002 + The Apache Software Foundation. + + + + + + + + + + + + Built with Cocoon + http://xml.apache.org/cocoon/ + skin/images/built-with-cocoon.gif + 88 + 31 + + + Krysalis Centipede + http://www.krysalis.org/centipede/ + skin/images/centipede-logo-small.gif + 138 + 31 + + + -- 2.39.5