From ff1e921c8d093574053b8aa82b592c336ba6f5f5 Mon Sep 17 00:00:00 2001 From: Keiron Liddle Date: Thu, 1 Nov 2001 11:33:52 +0000 Subject: [PATCH] some updates to links for xsl, svg and sax updated faq to use faq dtd git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@194531 13f79535-47bb-0310-9956-ffa450edef68 --- docs/xml-docs/fop.xml | 2 +- docs/xml-docs/fop/faq.xml | 115 +++++++++++++++++++----------- docs/xml-docs/fop/implemented.xml | 4 +- docs/xml-docs/fop/readme.xml | 7 +- docs/xml-docs/fop/resources.xml | 6 +- docs/xml-docs/makedoc.sh | 3 +- 6 files changed, 87 insertions(+), 50 deletions(-) diff --git a/docs/xml-docs/fop.xml b/docs/xml-docs/fop.xml index bc484d152..bb18c6711 100644 --- a/docs/xml-docs/fop.xml +++ b/docs/xml-docs/fop.xml @@ -22,7 +22,7 @@ - + diff --git a/docs/xml-docs/fop/faq.xml b/docs/xml-docs/fop/faq.xml index f235c49cd..b9fa59aad 100644 --- a/docs/xml-docs/fop/faq.xml +++ b/docs/xml-docs/fop/faq.xml @@ -1,8 +1,9 @@ - - - - + + + + About the FAQ +

Here we have some answers to common questions about FOP. This only covers general information about getting started with FOP and pointers to more @@ -13,21 +14,11 @@ The site uses Jyve to provide an interactive FAQ: http://www.OWAL.co.uk:8090/

- - -
    -
  • What is FOP?
    • -
  • How does FOP interact with other Apache Projects?
    • -
  • What is XSL (FO)?
    • -
  • What can I do with FOP?
    • -
  • How can I contribute?
    • -
  • How do I author XSL documents?
    • -
  • How can I see a demo?
    • -
- - - - + + + + What is FOP? +

FOP is a print formatter for XSL formatting objects.

@@ -36,9 +27,11 @@ into a page layout. The main target is PDF but other rendering targets are supported, such as AWT, PCL, text and direct printing.

- - - + + + + How does FOP interact with other Apache Projects? +

FOP is distributed with Cocoon as a PDF serializer for XSL (FO) documents.

@@ -46,34 +39,76 @@ Batik can be used with FOP to transcode an SVG image into a PDF document. The mime type for PDF is "application/pdf".

- - - + + + + + What is XSL (FO)? +

+XSL is an XML format that is used to specify a pagination and other +styling for page layout output. XSL can be used in conjunction with +XSLT to convert from any XML format into a paginated layout ready for +printing or displaying.

- - -

+XSL defines a set of formatting objects in xml that describes the +way pages are set up. The contents of the pages are filled from +flows which. There can be static flows that appear on every page +and the main flow which fills the body of the page.

- - - + + + + + What can I do with FOP? +

+FOP is an application or library that converts an XSL FO document +into the paginated output. It is possible to render the output +to different targets, the main target is PDF. FOP can be run from +the command line or embedded into your Java application.

- - -

+The XSL FO can be delivered to FOP with XML(XSL FO), XML+XSL or +SAX events. +

+ + + + + How can I contribute? + +

+There is always plenty of things to do.

- - - + + + + + How do I author XSL documents? + +

+Often XSL FO is created from XML and XSLT. There are some +standard XML markups such as Docbook that can be converted +into XSL FO and other XML formats. +

+

+There are some XSL authoring tools that may help you to +author XSL FO documents or the XML and XSLT documents. +

+ + + + + How can I see a demo? +

There will be a Java Webstart demo sometime in the future. +This will use the AWT viewer to display FO documents.

- - + + - + diff --git a/docs/xml-docs/fop/implemented.xml b/docs/xml-docs/fop/implemented.xml index 3de5b5233..2cf614707 100644 --- a/docs/xml-docs/fop/implemented.xml +++ b/docs/xml-docs/fop/implemented.xml @@ -39,8 +39,8 @@
  • block
    • +
  • block-container (limited)
-

Not implemented: block-container

 @@ -97,8 +97,8 @@
  • wrapper
    • +
  • marker, retrieve marker
-

Not implemented: marker, retrieve-marker

 diff --git a/docs/xml-docs/fop/readme.xml b/docs/xml-docs/fop/readme.xml index bc7cbc57d..7811795c8 100644 --- a/docs/xml-docs/fop/readme.xml +++ b/docs/xml-docs/fop/readme.xml @@ -16,8 +16,11 @@

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 renders the resulting pages to a specified output. + objects and the world's first output indepent 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, SVG, XML (area tree representation), + Print, AWT and TXT. The primary output target is PDF.

diff --git a/docs/xml-docs/fop/resources.xml b/docs/xml-docs/fop/resources.xml index 03214711c..ad9516a25 100644 --- a/docs/xml-docs/fop/resources.xml +++ b/docs/xml-docs/fop/resources.xml @@ -6,13 +6,13 @@

    -
  • XSL-FO Candidate Recommendation (21 November 2000)
    • +
  • XSL-FO Recommendation (15 October 2001)
  • A dtd for the XSL-FO CR from November provided by N. Grigoriev from RenderX
    • -
  • Supported SVG Candidate Recommendation (02 November 2000)
    • +
  • Supported SVG Recommendation (04 September 2001)
  • XML Recommendation
  • XSLT Recommendation
  • Portable Document Format (PDF) 1.3 Reference Manual
    • -
  • Simple API for XML (SAX)
    • +
  • Simple API for XML (SAX)
  • Document Object Model (DOM)
  • Namespaces in XML Recommendation
  • Java JDK 1.1 Documentation
    • diff --git a/docs/xml-docs/makedoc.sh b/docs/xml-docs/makedoc.sh index 192a37bf3..a0ff6da34 100755 --- a/docs/xml-docs/makedoc.sh +++ b/docs/xml-docs/makedoc.sh @@ -1,7 +1,6 @@ #!/bin/sh #This file should be executable - echo echo "Converting Fop's xml documentation into a pdf file, creating html docs" echo "----------------" @@ -16,7 +15,7 @@ if [ "$JAVA_HOME" = "" ] ; then fi LIBDIR=../../lib -LOCALCLASSPATH=$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/classes.zip:$LIBDIR/ant.jar:$LIBDIR/batik.jar:$LIBDIR/buildtools.jar:$LIBDIR/xerces-1.2.3.jar:$LIBDIR/xalan-2.0.0.jar:$LIBDIR/bsf.jar:$LIBDIR/avalon-framework-4.0.jar:$LIBDIR/logkit-1.0b4.jar:$LIBDIR/jimi-1.0.jar:$LIBDIR/stylebook.jar:$LIBDIR/../build/fop.jar +LOCALCLASSPATH=$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/classes.zip:$LIBDIR/ant.jar:$LIBDIR/batik.jar:$LIBDIR/buildtools.jar:$LIBDIR/xerces-1.4.3.jar:$LIBDIR/xalan-2.2D11.jar:$LIBDIR/logkit-1.0.jar:$LIBDIR/jimi-1.0.jar:$LIBDIR/stylebook.jar:$LIBDIR/../build/fop.jar ANT_HOME=$LIBDIR echo Building with classpath $LOCALCLASSPATH:$CLASSPATH -- 2.39.5