FOP

From 4ec330105da5bdd8cee819f51aa9e21424d7800a Mon Sep 17 00:00:00 2001 From: Keiron Liddle Date: Fri, 5 Oct 2001 09:44:34 +0000 Subject: updated stylebook stuff to a more recent version changed the front page - added some images and made text clearer git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@194487 13f79535-47bb-0310-9956-ffa450edef68 --- docs/xml-docs/fop/document.jpg | Bin 0 -> 16366 bytes docs/xml-docs/fop/layout.jpg | Bin 0 -> 21176 bytes docs/xml-docs/fop/readme.xml | 83 +++++++++++++++++++++++++---------------- docs/xml-docs/fop/running.xml | 2 +- docs/xml-docs/fop/title.jpg | Bin 0 -> 5312 bytes docs/xml-docs/fop/todo.xml | 7 ---- 6 files changed, 52 insertions(+), 40 deletions(-) create mode 100644 docs/xml-docs/fop/document.jpg create mode 100644 docs/xml-docs/fop/layout.jpg create mode 100644 docs/xml-docs/fop/title.jpg (limited to 'docs/xml-docs/fop') diff --git a/docs/xml-docs/fop/document.jpg b/docs/xml-docs/fop/document.jpg new file mode 100644 index 000000000..e441833d8 Binary files /dev/null and b/docs/xml-docs/fop/document.jpg differ diff --git a/docs/xml-docs/fop/layout.jpg b/docs/xml-docs/fop/layout.jpg new file mode 100644 index 000000000..3c519baa2 Binary files /dev/null and b/docs/xml-docs/fop/layout.jpg differ diff --git a/docs/xml-docs/fop/readme.xml b/docs/xml-docs/fop/readme.xml index d9a15dddf..bc7cbc57d 100644 --- a/docs/xml-docs/fop/readme.xml +++ b/docs/xml-docs/fop/readme.xml @@ -2,16 +2,28 @@ + +

+ FOP + XSL Formatter - Renderer in Java + + +

+ + - +

FOP is the world's first print formatter driven by XSL formatting objects. It is a Java application that reads a formatting object - tree and then turns it into a PDF document. The formatting object - tree, can be in the form of an XML document (output by an XSLT engine - like XT or Xalan) or can be passed in memory as a DOM Document or (in - the case of XT) SAX events. + tree and then renders the resulting pages to a specified output. + The primary output target is PDF.

The latest version of Fop is 0.20.1 and it supports the xsl:fo candidate release. +

The latest version of Fop is 0.20.2 and it supports the xsl:fo candidate release. 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 @@ -23,14 +35,35 @@ limited.

FOP is part of Apache's XML project. The homepage of FOP is - http://xml.apache.org/fop. A list - of known bugs, the committers to this project and the tasks they are working on can be found - in the file Status in the - root of your Fop distribution. A history of the latest changes to the project can be found in CHANGES. + http://xml.apache.org/fop. +Here you can find information about using and developing with FOP.

- + - + +

+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 areas +that 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. +

+ +

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 Candidate Recommendation 21 November 2000, and that complies with the 11 March 1999 Portable Document Format Specification (Version 1.3) from Adobe Systems. @@ -38,28 +71,14 @@

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

- -

Secondary goals of the FOP Project (also, "FOP") are desirable requirements that also have a high priority. -

- -

One secondary goal of the FOP Project is to deliver a follow-on version of the formatter that is compliant to the Extended - conformance level described in the XSL FO. Any formatting objects that cannot be translated into PDF will be explicitly - identified as such. -

- -

Another secondary goal is to improve the conversion of SVG into PDF. - This includes the use of FOP to work as a transcoder for Batik to convert - an SVG document into a PDF document and the fully support embedding SVG inside - fo documents in an fo:instream-foreign-object. + Project will attempt to use the latest version of evolving specifications.

A final secondary goal is the continued refinement of the FOP design and implementation. In particular, maintaining the - separation between formatting and rendering, continuing to support the AWT Viewer renderer (backend), and providing - new renderers, are all desirable objectives. +

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/docs/xml-docs/fop/running.xml b/docs/xml-docs/fop/running.xml index 8ee55f348..1e1fa7965 100644 --- a/docs/xml-docs/fop/running.xml +++ b/docs/xml-docs/fop/running.xml @@ -6,7 +6,7 @@

Following software must be installed:

a) Java 1.1.x or later (If you want to use the previewer (option -awt), you need Swing or Java 2)

a) Java 1.2.x or later

b) All libraries you need are part of the Fop distribution and can be found in the xml-fop/lib directory. Look at the batch/shell script fop.bat/fop.sh to see, how Fop can be invoked easily. These libraries are included: diff --git a/docs/xml-docs/fop/title.jpg b/docs/xml-docs/fop/title.jpg new file mode 100644 index 000000000..f7df45bf1 Binary files /dev/null and b/docs/xml-docs/fop/title.jpg differ diff --git a/docs/xml-docs/fop/todo.xml b/docs/xml-docs/fop/todo.xml index b2e12c8af..c7940fe3c 100644 --- a/docs/xml-docs/fop/todo.xml +++ b/docs/xml-docs/fop/todo.xml @@ -116,13 +116,6 @@ support (better) the direct rendering of text into pdf graphics and other similair outputs

- -

-Create an SVGRenderer that will render all pages onto a single -svg document suitable for slide show presentations (with batik) -suggested by Vincent Hardy. -

Support for different encoding on different types of streams -- cgit v1.2.3