- redesign of properties handling, support for computed, compound and shorthand properties,
supporting docs [Karen Lease]
- redesign of font handling for AWTRenderer [Dorothea Wiarda]
+- added: support for leader-alignment, leader-pattern-width, leader-pattern (dots,space) [Fotis Jannidis]
- fixed: unnecessary dependence on jdk 1.2 features [Christian Geisert]
- fixed: unicode problem in UserMessage [Ross Golder]
- fixed: broken buildFOTree [Marcus Holmberg]
- fixed: renamed: inline-sequence -> inline, simple-link -> basic-link,
white-space-treatment -> white-space-collapse [Fotis Jannidis]
- fixed: images were rendered only half size (Mikko Honkala)
+- fixed: pdf file in XalanCommandFile explicitly closed [Dharamveer Salecha]
+- fixed: lists containing list do not keep their indentation correctly
+ over a page boundary [Dorothea Wiarda]
Done since 0.13 release
- pagination updated to 03/27/2000 XSL WD [Arved Sandstrom]
SVG support [Keiron Liddle][Torsten Friebe]
smooth shading in PDF [Steven Coffman]
tables [Karen Lease]
+hyphenation [Carlos Villegas]
docs [Fotis Jannidis]
**** THINGS TO DO ****
-Support XSL Working Draft 18 October 2000
+Support XSL Candidate Release
+
+first target is basic conformance
1.One category of tasks will be to implement missing formatting objects.
basic
fo:character
fo:declarations
- fo:leader [at the moment only partially]
fo:multi-case
fo:table-and-caption
fo:table-header
fo:table-footer
fo:title
-2. done
-3. done
-4.A fourth, and not insignificant, category of tasks is to decide upon and
+2. A not insignificant, category of tasks is to decide upon and
implement all reasonable properties required by the specification. This
also means that at this point, until further review, no FO can be considered
to be compliant.
+ This are the properties which must be implemented to reach basic conformance
a) CHANGED
space-after.optimum (Incomplete)
space-before.optimum (Incomplete)
- white-space-treatment has to be renamed to white-space-collapse and adjusted
keep-with-next (Changed)
b) NEW
- 1.alignment-adjust 26.min-width
- 2.baseline-identifier 27.number-columns-repeated
- 3.baseline-shift 28.number-columns-spanned
- 4.block-progression-dimension 29.number-rows-spanned
- 5.character 30.orphans
- 6.clip 31.overflow
- 7.column-number 32.page-break-after
- 8.content-type 33.page-break-before
- 9.direction 34.precedence
- 10.display-align 35.ref-id
- 11.dominant-baseline 36.reference-orientation
- 12.font-variant 37.region-name
- 13.format 38.relative-align
- 14.grouping-separator 39.role
- 15.grouping-size 40.rule-style
- 16.inline-progression-dimension 41.source-document
- 17.keep-with-previous 42.space-after
- 18.leader-length 43.space-before
- 19.leader-pattern 44.space-end
- 20.letter-value 45.space-start
- 21.line-stacking-strategy
- 22.master-name 47.visibility
- 23.max-height 48.widows
- 24.max-width 49.writing-mode
- 25.min-height 50.z-index
-
-5.A fifth category of tasks is the ongoing effort to promote maintainability,
-write
- more and better documentation, and to refine the build process.
- a) Add the property files to the source code (how is the vote on this?)
- b) add examples so that all the FOs supported are used in some example
-
-6. Redo or work on the classes/properties which have been fixed only in a superficial way
- to conform to the latest working draft
- - leader is just a renamed display-rule and must be rewritten:
- it is now (wd 3.2000) generating inline-areas and not block areas
- and has a more complex function
- - inline is just a renamed inline-sequence and must be worked on:
- it is now (wd 3.2000) generating an inline-area itself
+ alignment-adjust
+ alignment-baseline
+ azimuth
+ baseline-shift
+ block-progression-dimension
+ border-after-precedence
+ border-before-precedence
+ border-end-precedence
+ border-start-precedence
+ character
+ clip
+ column-number
+ content-type
+ cue-after
+ cue-before
+ direction
+ display-align
+ dominant-baseline
+ font-variant
+ format
+ grouping-separator
+ grouping-size
+ inline-progression-dimension
+ keep-with-next
+ keep-with-previous
+ letter-value
+ line-stacking-strategy
+ number-columns-repeated
+ number-columns-spanned
+ number-rows-spanned
+ orphans
+ overflow
+ reference-orientation
+ relative-align
+ role
+ rule-style
+ source-document
+ space-after (full)
+ space-before (full)
+ space-end
+ space-start
+ visibility
+ widows
+ writing-mode
+ z-index
+
+3. A third category of tasks is the ongoing effort to promote maintainability,
+ write more and better documentation, and to refine the build process.
+ a) add examples. In examples/fo there should be at least one file for each
+ supported flow object showing the use of all properties applying to it.
**** Bugs ****
- colour not continued onto subsequent pages if coloured block goes over page
- keep-next doesn't work and doubles the text lines which should be moved to the next page
-- lists containing list do not keep their indentation correctly over a page boundary
- border width in fo:table is added to the start position of the next block or
table (see page 6 in table.fo for a test case)
<P><CODE><FONT face="courier, monospaced">driver.setRenderer("org.apache.fop.render.pdf.PDFRenderer", version);</FONT></CODE></P>
<P><CODE><FONT face="courier, monospaced">driver.addElementMapping("org.apache.fop.fo.StandardElementMapping");</FONT></CODE></P>
<P><CODE><FONT face="courier, monospaced">driver.addElementMapping("org.apache.fop.svg.SVGElementMapping");</FONT></CODE></P>
+<P><CODE><FONT face="courier, monospaced">driver.addPropertyList("org.apache.fop.fo.StandardPropertyListMapping");</FONT></CODE></P>
+<P><CODE><FONT face="courier, monospaced">driver.addPropertyList("org.apache.fop.svg.SVGPropertyListMapping");</FONT></CODE></P>
<P><CODE><FONT face="courier, monospaced">driver.setWriter(new PrintWriter(new FileWriter(args[1])));</FONT></CODE></P>
<P></P>
<P><CODE><FONT face="courier, monospaced">driver.buildFOTree(parser, fileInputSource(args[0]));</FONT></CODE></P>
<P><CODE><FONT face="courier, monospaced">Block</FONT></CODE></P>
-<P><CODE><FONT face="courier, monospaced">InlineSequence</FONT></CODE></P>
-<P><CODE><FONT face="courier, monospaced">SimpleLink</FONT></CODE></P>
+<P><CODE><FONT face="courier, monospaced">Inline</FONT></CODE></P>
+<P><CODE><FONT face="courier, monospaced">BasicLink</FONT></CODE></P>
</FONT></TD></TR></TABLE><BR>
</P>
</FONT></TD></TR></TABLE><BR>
+<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>SVG</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
+
+<P>
+FOP supports some svg rendering. SVG is supported as an instream-foreign-object
+embedded in an FO document. FOP also supports rendering of an external SVG image.
+</P>
+
+<P>
+Since the intream object that contains the SVG returns a single fo area then
+the construction of the SVG document is handled differently. The SVG is created
+by calling the <CODE><FONT face="courier, monospaced">createGraphic()</FONT></CODE> on each SVG element. The element is then
+responsible for loading the necessary information and child elements and creating
+the corresponding SVG DOM element. When the FO tree is being layed out the
+SVG tree is turned into the SVG DOM document which is stored for later rendering.
+</P>
+
+<P>
+The SVG document is then held as a DOM tree which is then rendered by going through
+the elements of the tree and rendering then in turn.
+</P>
+
+<P>
+For more information see the SVG documentation.
+</P>
+</FONT></TD></TR></TABLE><BR>
</TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD bgcolor="#0086b2"><IMG height="1" src="images/dot.gif" width="1"></TD></TR><TR><TD align="center"><FONT color="#0086b2" size="-1"><I>
Copyright © 1999 The Apache Software Foundation.
All Rights Reserved.
file with your report, which just demonstrates the problem. Thanks for your help!</P>
</FONT></TD></TR></TABLE><BR>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Known bugs</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <UL>
- <LI>Colour not continued onto subsequent pages, if coloured block goes over page.</LI>
- <LI>SVG linearGradients don't appear the same as in other SVG Viewers</LI>
- <LI>colour not continued onto subsequent pages if coloured block goes over page </LI>
- <LI>no SVG support in AWTCommandLine </LI>
- <LI>keep-next doesn't work and doubles the text lines which should be moved to the next page</LI>
- <LI>lists containing list do not keep their indentation correctly over a page boundary</LI>
- </UL>
+ <P>A list of known bugs can be found at the end of the file
+ <A href="http://xml.apache.org/websrc/cvsweb.cgi/xml-fop/">Status</A> in the root
+ of the Fop distribution.</P>
</FONT></TD></TR></TABLE><BR>
</TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD bgcolor="#0086b2"><IMG height="1" src="images/dot.gif" width="1"></TD></TR><TR><TD align="center"><FONT color="#0086b2" size="-1"><I>
Copyright © 1999 The Apache Software Foundation.
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B></B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
<P>You can download the latest release version from the <A href="http://xml.apache.org/dist/fop/">distribution directory</A>. </P>
<P>The file contains also the documentation (including some example fo files) and the source. </P>
+ <P>If you want to work with the latest and nicest code, you can use the cvs version. See the section
+ on AnonCVS in the <A href="http://xml.apache.org/cvs.html">xml.apache.org documentation</A> for details.
+ Sometimes people have difficulties to access the cvs server; in this case you can download
+ a snapshot from the cvs files <A href="http://xml.apache.org/from-cvs/xml-fop/">here</A>.
+ In both cases you have to build Fop yourself - see <A href="compiling.html">Compiling Fop</A> for details.
+ </P>
<P>To run FOP from the command line, see <A href="running.html">Running FOP</A>. If you are
interested in embedding FOP in a Java application of your own, see
<A href="embedding.html">Embedding FOP</A>.
<P><CODE><FONT face="courier, monospaced">driver.setRenderer("org.apache.fop.render.pdf.PDFRenderer", version);</FONT></CODE></P>
<P><CODE><FONT face="courier, monospaced">driver.addElementMapping("org.apache.fop.fo.StandardElementMapping");</FONT></CODE></P>
<P><CODE><FONT face="courier, monospaced">driver.addElementMapping("org.apache.fop.svg.SVGElementMapping");</FONT></CODE></P>
+ <P><CODE><FONT face="courier, monospaced">driver.addPropertyList("org.apache.fop.fo.StandardPropertyListMapping");</FONT></CODE></P>
+ <P><CODE><FONT face="courier, monospaced">driver.addPropertyList("org.apache.fop.svg.SVGPropertyListMapping");</FONT></CODE></P>
<P><CODE><FONT face="courier, monospaced">driver.setWriter(new PrintWriter(new FileWriter(args[1])));</FONT></CODE></P>
<P><CODE><FONT face="courier, monospaced">driver.buildFOTree(parser, fileInputSource(args[0]));</FONT></CODE></P>
<P><CODE><FONT face="courier, monospaced">driver.format();</FONT></CODE></P>
</LI>
<LI>normal.fo - a simple file showing the use of a 2 level of headings, normal text and a header.
</LI>
- <LI>table.fo - a simple table
+ <LI>table.fo - some table examples
</LI>
- <LI>list.fo - a simple list
- </LI>
- <LI>list2.fo - some list examples
+ <LI>list.fo - a short tutorial how to use list fo's and properties
</LI>
<LI>images.fo - shows how to embed gif and jpg images into the xsl:fo file using external-graphic.
</LI>
<LI>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.
</LI>
- <LI>leader.fo - a very simple example of a rule
+ <LI>leader.fo - shows different uses of fo:leader, p.e. as rule or in a table of content
</LI>
<LI>normalex.fo - shows the use of computed property values
</LI>
</LI>
<LI>instream.fo - shows the use of fo:instream-foreign-object together with svg
</LI>
- <LI>inhprop.fo - shows the use of inherited property values
- </LI>
<LI>textdeko.fo - shows the use of the property textdecoration
</LI>
+ <LI>readme.fo - uses an old version of Fop documentation for a longer example
+ </LI>
<LI>Look also into the directory examples/svg. There you find some very extensive svg examples.
Just start makedoc.
<IMG border="0" height="14" hspace="0" src="resources/close.gif" vspace="0" width="120"><BR></TD><TD align="left" valign="top" width="500"><TABLE border="0" cellpadding="3" cellspacing="0"><TR><TD>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>What's Implemented?</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
<P>The following formatting objects and properties of the xsl-fo
- working draft (12 October 2000) are implemented.Please have also a look at the
+ candidate recommendation are implemented.Please have also a look at the
section on <A href="limitations.html">limitations</A>
</P>
</FONT></TD></TR></TABLE><BR>
<LI>external-graphic</LI>
<LI>inline</LI>
<LI>instream-foreign-object</LI>
- <LI>leader, but see <A href="limitations.html">limitations</A></LI>
+ <LI>leader</LI>
<LI>page-number </LI>
<LI>page-number-citation, see <A href="limitations.html">limitations</A></LI>
</UL>
<LI>initial-page-number</LI>
<LI>internal-destination</LI>
<LI>keep-with-next (broken)</LI>
+ <LI>leader-alignment (not value "page")</LI>
+ <LI>leader-length (no percentage values)</LI>
+ <LI>leader-pattern (not value "use-content")</LI>
+ <LI>leader-pattern-width</LI>
<LI>left</LI>
<LI>line-height </LI>
<LI>margin-bottom (only on pages and regions) </LI>
<LI>provisional-distance-between-starts </LI>
<LI>provisional-label-separation </LI>
<LI>ref-id </LI>
+ <LI>region-name</LI>
<LI>right</LI>
<LI>rule-thickness </LI>
<LI>space-after.optimum </LI>
<LI>space-before.optimum </LI>
<LI>src </LI>
<LI>start-indent </LI>
- <LI>textdecoration (only value 'underline' is supported)</LI>
+ <LI>textdecoration (only value "underline")</LI>
<LI>text-align </LI>
<LI>text-align-last </LI>
<LI>text-indent </LI>
<LI>top</LI>
- <LI>white-space-treatment (broken)</LI>
+ <LI>white-space-collapse</LI>
<LI>width</LI>
<LI>wrap-option</LI>
</UL>
like XT or Xalan) or can be passed in memory as a DOM Document or (in
the case of XT) SAX events.
</P>
+ <P>The latest version of Fop is 0.15 and it supports the xsl:fo candidate release.
+ You can <A href="download.html">download</A>
+ 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
+ section <A href="specs.html">specifications</A>. 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 <A href="implemented.html">Features</A> and in section
+ <A href="limitations.html">Limitations</A> in what way this support is
+ limited.
+ </P>
<P>FOP is part of Apache's XML project. The homepage of FOP is
<A href="http://xml.apache.org/fop">http://xml.apache.org/fop</A>. A list
- of the committers to this project and the tasks they are working on can be found
- in the file <A href="http://xml.apache.org/websrc/cvsweb.cgi/xml-fop/">Status</A>
+ of known bugs, the committers to this project and the tasks they are working on can be found
+ in the file <A href="http://xml.apache.org/websrc/cvsweb.cgi/xml-fop/">Status</A> in the
+ root of your Fop distribution.
</P>
</FONT></TD></TR></TABLE><BR>
to <A href="mailto:fop-dev-subscribe@xml.apache.org">fop-dev-subscribe@xml.apache.org</A></P>
<P>Sending bug reports and feature requests to the list is a welcome and important contribution to
developing Fop. </P>
- <P>Read also the <A href="http://xml-archive.webweaving.org/xml-archive-fop/">archive</A>
+ <P>Read also the <A href="http://archive.covalent.net/">archive</A>
of the discussion list fop-dev to get an idea of the issues being discussed. </P>
</FONT></TD></TR></TABLE><BR>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Look at the developer's code using cvs</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
<P>Between releases the newest code can be accessed via cvs. To do this you need to install a cvs
- client on your computer if it is not already there. An explanation how to connect to the
+ client on your computer, if it is not already there. An explanation how to connect to the
Fop source repository can be found at <A href="http://xml.apache.org/cvs.html">http://xml.apache.org/cvs.html</A>.
An introduction into cvs and the cvs manual can be found in the
<A href="http://xml.apache.org/library.html">reference library</A>.</P>
in <A href="implemented.html">features</A>, sometimes it does so only in a limited way.
</P>
- <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>leader</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <P>fo:leader is only supported in a very limited way: you can use it to draw simple rules.
- Only the property value leader-pattern="rule" is supported. leader-length can be set,
- but the value is not used. You should wrap leader into a block element.
- </P>
- </FONT></TD></TR></TABLE><BR>
-
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>page-number-citation</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
<P>Only works for table of contents without any problems. The case where the page number doesn't
fit on a line isn't handled, and any text on the same line and after the page-number might not
</P>
<P>c) Fop supports SVG (see <A href="implemented.html">Features</A> for further information) and
needs the w3c.jar library. This library comes with Fop (xml-fop/lib) and must
- be included in your classpath
+ be included in your classpath. The jar file w3c.jar contains the compiled classes for the
+ java svg bindings with some other DOM classes that are used by the SVG DOM bindings.
+ The source for the svg java binding classes can be found at - <A href="http://www.w3.org/TR/2000/CR-SVG-20000802/java.html">
+ SVG Java bindings</A>, currently they correspond to the CR-SVG-20000802 specification document.
+ The other required files can be found at <A href="http://www.w3.org/TR/2000/CR-DOM-Level-2-20000510/java-binding.html">W3C DOM Java binding</A>.
</P>
<P>d) Optional: Fop supports the jimi library for image processing, if it is in your classpath
- when you build Fop.
+ when you build Fop. You can find it at <A href="http://java.sun.com/products/jimi/">java.sun.com</A>
</P>
</FONT></TD></TR></TABLE><BR>
<TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Starting FOP as an standalone application</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
<A href="license.html" onMouseOut="rolloverOff('side-license');" onMouseOver="rolloverOn('side-license');"><IMG alt="License" border="0" height="12" hspace="0" name="side-license" onLoad="rolloverLoad('side-license','graphics/license-label-2.jpg','graphics/license-label-3.jpg');" src="graphics/license-label-3.jpg" vspace="0" width="120"></A><BR>
<IMG border="0" height="14" hspace="0" src="resources/close.gif" vspace="0" width="120"><BR></TD><TD align="left" valign="top" width="500"><TABLE border="0" cellpadding="3" cellspacing="0"><TR><TD>
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Specifications</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
<UL>
- <LI><A href="http://www.w3.org/TR/WD-xsl/">Latest XSL-FO Working Draft (27 March 2000)</A></LI>
- <LI><A href="http://www.renderx.com/Tests/validator/fo2000.dtd.html">A dtd for the XSL-FO Working Draft (27 March 2000) provided by N. Grigoriev from RenderX</A></LI>
- <LI><A href="http://www.w3.org/TR/1999/WD-xsl-19990421/">XSL-FO Working Draft 21 Apr 1999 </A></LI>
+ <LI><A href="http://www.w3.org/TR/2000/CR-xsl-20001121/">XSL-FO Candidate Recommendation (21 November 2000)</A></LI>
+ <LI><A href="http://www.renderx.com/Tests/validator/fo2000.dtd.html">A dtd for the XSL-FO WD from October provided by N. Grigoriev from RenderX</A></LI>
<LI><A href="http://www.w3.org/TR/SVG">Latest SVG Working draft</A></LI>
- <LI><A href="http://www.w3.org/TR/2000/WD-SVG-20000629/index.html">Supported SVG Working Draf</A></LI>
+ <LI><A href="http://www.w3.org/TR/2000/CR-SVG-20000802/index.html">Supported SVG Candidate Recommendation</A></LI>
<LI><A href="http://www.w3.org/TR/REC-xml">XML Recommendation</A></LI>
<LI><A href="http://www.w3.org/TR/xslt">XSLT Recommendation</A></LI>
<LI><A href="http://partners.adobe.com/asn/developer/acrosdk/DOCS/pdfspec.pdf">Portable Document Format (PDF) 1.3 Reference Manual </A></LI>
<LI><A href="http://www.w3.org/TR/REC-xml-names/">Namespaces in XML Recommendation</A></LI>
<LI><A href="http://java.sun.com/products/jdk/1.1/docs/index.html">Java JDK 1.1 Documentation</A></LI>
</UL>
+ </FONT></TD></TR></TABLE><BR>
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Tutorials/Articles</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
+ <UL>
+ <LI><A href="http://www.ibiblio.org/xml/books/bible/updates/15.html">Elliotte Rusty Harold: Chapter 15 on xsl:fo from his excellent xml book</A></LI>
+ <LI><A href="http://www.sun.com/software/xml/developers/slides-dtd/">Paul Sandoz: Using formatting objects with the slides dtd</A></LI>
+ </UL>
+ </FONT></TD></TR></TABLE><BR>
</TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD bgcolor="#0086b2"><IMG height="1" src="images/dot.gif" width="1"></TD></TR><TR><TD align="center"><FONT color="#0086b2" size="-1"><I>
Copyright © 1999 The Apache Software Foundation.
All Rights Reserved.
<p><code>Block</code></p>
<p><code>Inline</code></p>
-<p><code>SimpleLink</code></p>
+<p><code>BasicLink</code></p>
</s2>
file with your report, which just demonstrates the problem. Thanks for your help!</p>
</s2>
<s2 title="Known bugs">
- <ul>
- <li>Colour not continued onto subsequent pages, if coloured block goes over page.</li>
- <li>SVG linearGradients don't appear the same as in other SVG Viewers</li>
- <li>colour not continued onto subsequent pages if coloured block goes over page </li>
- <li>no SVG support in AWTCommandLine </li>
- <li>keep-next doesn't work and doubles the text lines which should be moved to the next page</li>
- <li>lists containing list do not keep their indentation correctly over a page boundary</li>
- </ul>
+ <p>A list of known bugs can be found at the end of the file
+ <jump href="http://xml.apache.org/websrc/cvsweb.cgi/xml-fop/">Status</jump> in the root
+ of the Fop distribution.</p>
</s2>
</s1>
</li>
<li>normal.fo - a simple file showing the use of a 2 level of headings, normal text and a header.
</li>
- <li>table.fo - a simple table
+ <li>table.fo - some table examples
</li>
- <li>list.fo - a simple list
- </li>
- <li>list2.fo - some list examples
+ <li>list.fo - a short tutorial how to use list fo's and properties
</li>
<li>images.fo - shows how to embed gif and jpg images into the xsl:fo file using external-graphic.
</li>
<li>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.
</li>
- <li>leader.fo - a very simple example of a rule
+ <li>leader.fo - shows different uses of fo:leader, p.e. as rule or in a table of content
</li>
<li>normalex.fo - shows the use of computed property values
</li>
</li>
<li>instream.fo - shows the use of fo:instream-foreign-object together with svg
</li>
- <li>inhprop.fo - shows the use of inherited property values
- </li>
<li>textdeko.fo - shows the use of the property textdecoration
</li>
+ <li>readme.fo - uses an old version of Fop documentation for a longer example
+ </li>
<li>Look also into the directory examples/svg. There you find some very extensive svg examples.
Just start makedoc.
<s1 title="Features">
<s2 title="What's Implemented?">
<p>The following formatting objects and properties of the xsl-fo
- working draft (12 October 2000) are implemented.Please have also a look at the
+ candidate recommendation are implemented.Please have also a look at the
section on <jump href="limitations.html">limitations</jump>
</p>
</s2>
<li>external-graphic</li>
<li>inline</li>
<li>instream-foreign-object</li>
- <li>leader, but see <jump href="limitations.html">limitations</jump></li>
+ <li>leader</li>
<li>page-number </li>
<li>page-number-citation, see <jump href="limitations.html">limitations</jump></li>
</ul>
<li>initial-page-number</li>
<li>internal-destination</li>
<li>keep-with-next (broken)</li>
+ <li>leader-alignment (not value "page")</li>
+ <li>leader-length (no percentage values)</li>
+ <li>leader-pattern (not value "use-content")</li>
+ <li>leader-pattern-width</li>
<li>left</li>
<li>line-height </li>
<li>margin-bottom (only on pages and regions) </li>
<li>provisional-distance-between-starts </li>
<li>provisional-label-separation </li>
<li>ref-id </li>
+ <li>region-name</li>
<li>right</li>
<li>rule-thickness </li>
<li>space-after.optimum </li>
<li>space-before.optimum </li>
<li>src </li>
<li>start-indent </li>
- <li>textdecoration (only value 'underline' is supported)</li>
+ <li>textdecoration (only value "underline")</li>
<li>text-align </li>
<li>text-align-last </li>
<li>text-indent </li>
<li>top</li>
- <li>white-space-treatment (broken)</li>
+ <li>white-space-collapse</li>
<li>width</li>
<li>wrap-option</li>
</ul>
</s2>
<s2 title="Look at the developer's code using cvs">
<p>Between releases the newest code can be accessed via cvs. To do this you need to install a cvs
- client on your computer if it is not already there. An explanation how to connect to the
+ client on your computer, if it is not already there. An explanation how to connect to the
Fop source repository can be found at <jump href="http://xml.apache.org/cvs.html">http://xml.apache.org/cvs.html</jump>.
An introduction into cvs and the cvs manual can be found in the
<jump href="http://xml.apache.org/library.html">reference library</jump>.</p>
in <jump href="implemented.html">features</jump>, sometimes it does so only in a limited way.
</p>
- <s2 title="leader">
- <p>fo:leader is only supported in a very limited way: you can use it to draw simple rules.
- Only the property value leader-pattern="rule" is supported. leader-length can be set,
- but the value is not used. You should wrap leader into a block element.
- </p>
- </s2>
-
<s2 title="page-number-citation">
<p>Only works for table of contents without any problems. The case where the page number doesn't
fit on a line isn't handled, and any text on the same line and after the page-number might not
<?xml version="1.0" standalone="no"?>
-<!-- $Id$ -->
<!--
Authors:
James Tauber
like XT or Xalan) or can be passed in memory as a DOM Document or (in
the case of XT) SAX events.
</p>
- <p>The latest version of Fop is 0.14 and it supports partially the xsl:fo working draft
- from March 2000. You can <jump href="download.html">download</jump>
- Fop including a precompiled version the source code and many example files to
+ <p>The latest version of Fop is 0.15 and it supports the xsl:fo candidate release.
+ You can <jump href="download.html">download</jump>
+ 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
- section <jump href="specs.html">specifications</jump>.
+ section <jump href="specs.html">specifications</jump>. 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 <jump href="implemented.html">Features</jump> and in section
+ <jump href="limitations.html">Limitations</jump> in what way this support is
+ limited.
</p>
<p>FOP is part of Apache's XML project. The homepage of FOP is
<jump href="http://xml.apache.org/fop">http://xml.apache.org/fop</jump>. A list
of known bugs, the committers to this project and the tasks they are working on can be found
- in the file <jump href="http://xml.apache.org/websrc/cvsweb.cgi/xml-fop/">Status</jump>
+ in the file <jump href="http://xml.apache.org/websrc/cvsweb.cgi/xml-fop/">Status</jump> in the
+ root of your Fop distribution.
</p>
</s2>
</p>
<p>c) Fop supports SVG (see <jump href="implemented.html">Features</jump> for further information) and
needs the w3c.jar library. This library comes with Fop (xml-fop/lib) and must
- be included in your classpath. The jar file w3c.jar is the compiled classes for the
+ be included in your classpath. The jar file w3c.jar contains the compiled classes for the
java svg bindings with some other DOM classes that are used by the SVG DOM bindings.
The source for the svg java binding classes can be found at - <jump href="http://www.w3.org/TR/2000/CR-SVG-20000802/java.html">
SVG Java bindings</jump>, currently they correspond to the CR-SVG-20000802 specification document.
<s1 title="FOP Relevant Specifications and Links">
<s2 title="Specifications">
<ul>
- <li><jump href="http://www.w3.org/TR/WD-xsl/">Latest XSL-FO Working Draft (27 March 2000)</jump></li>
- <li><jump href="http://www.renderx.com/Tests/validator/fo2000.dtd.html">A dtd for the XSL-FO Working Draft (27 March 2000) provided by N. Grigoriev from RenderX</jump></li>
- <li><jump href="http://www.w3.org/TR/1999/WD-xsl-19990421/">XSL-FO Working Draft 21 Apr 1999 </jump></li>
+ <li><jump href="http://www.w3.org/TR/2000/CR-xsl-20001121/">XSL-FO Candidate Recommendation (21 November 2000)</jump></li>
+ <li><jump href="http://www.renderx.com/Tests/validator/fo2000.dtd.html">A dtd for the XSL-FO WD from October provided by N. Grigoriev from RenderX</jump></li>
<li><jump href="http://www.w3.org/TR/SVG">Latest SVG Working draft</jump></li>
<li><jump href="http://www.w3.org/TR/2000/CR-SVG-20000802/index.html">Supported SVG Candidate Recommendation</jump></li>
<li><jump href="http://www.w3.org/TR/REC-xml">XML Recommendation</jump></li>
<li><jump href="http://java.sun.com/products/jdk/1.1/docs/index.html">Java JDK 1.1 Documentation</jump></li>
</ul>
</s2>
- <s2 title="Tutorials">
+ <s2 title="Tutorials/Articles">
<ul>
<li><jump href="http://www.ibiblio.org/xml/books/bible/updates/15.html">Elliotte Rusty Harold: Chapter 15 on xsl:fo from his excellent xml book</jump></li>
+ <li><jump href="http://www.sun.com/software/xml/developers/slides-dtd/">Paul Sandoz: Using formatting objects with the slides dtd</jump></li>
</ul>
</s2>
</s1>
* @return the version string
*/
public static String getVersion() {
- return "FOP 1.0 [dev]";
+ return "FOP 0.15";
}
}
projects / xmlgraphics-fop.git / commitdiff
