From: Clay Leeds Date: Sat, 6 Nov 2004 16:57:40 +0000 (+0000) Subject: Updates to achieve a /forrest/ BUILD SUCCESSSFUL for the xml-fop web site. X-Git-Tag: Root_Temp_KnuthStylePageBreaking~384 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=1319a24f5f6950fa3131f8bac811f639c6675263;p=xmlgraphics-fop.git Updates to achieve a /forrest/ BUILD SUCCESSSFUL for the xml-fop web site. git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@198123 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/forrest.properties b/forrest.properties index 03bb7b526..349990f19 100644 --- a/forrest.properties +++ b/forrest.properties @@ -1,5 +1,20 @@ +# Copyright 2002-2004 The Apache Software Foundation +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + ############## # Properties used by forrest.build.xml for building the website +# These are the defaults, un-comment them if you need to change them. ############## # Prints out a summary of Forrest settings for this project @@ -10,25 +25,81 @@ project.name=fop-project # Specifies name of Forrest skin to use #project.skin=forrest-site +project.skin=crust +#project.skin=pelt + +# comma separated list, file:// is supported +#forrest.skins.descriptors=http://forrest.apache.org/skins/skins.xml,file:///c:/myskins/skins.xml + +############## +# behavioural properties +#project.menu-scheme=tab_attributes +#project.menu-scheme=directories + +############## +# layout properties + +# Properties that can be set to override the default locations +# +# Parent properties must be set. This usually means uncommenting +# project.content-dir if any other property using it is uncommented -# Properties that must be set to override the default locations #project.status=status.xml -project.content-dir=src/documentation +#project.content-dir=src/documentation +#project.raw-content-dir=${project.content-dir}/content #project.conf-dir=${project.content-dir}/conf -project.sitemap=${project.content-dir}/sitemap.xmap +#project.sitemap-dir=${project.content-dir} #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.resources-dir=${project.content-dir}/resources +#project.stylesheets-dir=${project.resources-dir}/stylesheets +#project.images-dir=${project.resources-dir}/images +#project.schema-dir=${project.resources-dir}/schema #project.skins-dir=${project.content-dir}/skins -project.skinconf=${project.content-dir}/skinconf.xml +#project.skinconf=${project.content-dir}/skinconf.xml #project.lib-dir=${project.content-dir}/lib #project.classes-dir=${project.content-dir}/classes +#project.translations-dir=${project.content-dir}/translations -forrest.validate=true -forrest.validate.xdocs=${forrest.validate} -forrest.validate.xdocs.excludes=**/RCS/**/* **/.* **/*~ -forrest.validate.skinconf=${forrest.validate} +############## +# validation properties + +#forrest.validate=true +#forrest.validate.xdocs=${forrest.validate} +#forrest.validate.skinconf=${forrest.validate} +#forrest.validate.sitemap=${forrest.validate} +#forrest.validate.stylesheets=${forrest.validate} +#forrest.validate.skins=${forrest.validate} +#forrest.validate.skins.stylesheets=${forrest.validate.skins} + +# *.failonerror=(true|false) - stop when an XML file is invalid +#forrest.validate.failonerror=true -forrest.validate.failonerror=true +# *.excludes=(pattern) - comma-separated list of path patterns to not validate +# e.g. +#forrest.validate.xdocs.excludes=samples/subdir/**, samples/faq.xml +#forrest.validate.xdocs.excludes= + + +############## +# General Forrest properties +# The URL to start crawling from +#project.start-uri=linkmap.html +# Set logging level for messages printed to the console +# (DEBUG, INFO, WARN, ERROR, FATAL_ERROR) +#project.debuglevel=ERROR +# Max memory to allocate to Java +#forrest.maxmemory=64m +# Any other arguments to pass to the JVM. For example, to run on an X-less +# server, set to -Djava.awt.headless=true +#forrest.jvmargs= +# The bugtracking URL - the issue number will be appended +#project.bugtracking-url=http://issues.apache.org/bugzilla/show_bug.cgi?id= +#project.bugtracking-url=http://issues.apache.org/jira/browse/ +# The issues list as rss +#project.issues-rss-url= +#I18n Property only works for the "forrest run" target. +#project.i18n=true +# The names of plugins that are required to build the project +# comma separated list (no spaces) +# project.required.plugins= diff --git a/src/documentation/content/xdocs/compliance.xml b/src/documentation/content/xdocs/compliance.xml index c02c2dffd..cb9457873 100644 --- a/src/documentation/content/xdocs/compliance.xml +++ b/src/documentation/content/xdocs/compliance.xml @@ -16,7 +16,7 @@ --> + "compliance-v10.dtd"> @@ -26,9 +26,9 @@ -

One of FOP's design goals is conformance to the W3C XSL-FO 1.0 standard, which specifies three levels of "conformance": basic, extended, and complete. +

One of FOP's design goals is conformance to the W3C XSL-FO 1.0 standard, which specifies three levels of "conformance": basic, extended, and complete. Although FOP does not currently conform to any of these levels, it is nevertheless a useful work-in-progress for many applications. -The information presented here demonstrates FOP's progress toward the goal of conformance, which progress consists of implementation of specific objects and properties in the standard. +The information presented here demonstrates FOP's progress toward the goal of conformance, which progress consists of implementation of specific objects and properties in the standard. The information presented is useful not only to the developers as a sort of "to do" list, but also for setting proper expectations for users and potential users.

In the tables below, "yes" indicates conformance, "no" indicates a lack of conformance, "partial" indicates partial conformance, and "na" indicates that the item is "not applicable" to FOP. The color-coding indicates conformance at a specific conformance level, with blue indicating conformance, red indicating non-conformance, and gray indicating partial conformance. @@ -36,7 +36,7 @@ So, for example, a given item may be blue either because it is not required at t -

The following is a summary of FOP's current support for the standard XSL-FO objects.

+

The following is a summary of FOP's current support for the standard XSL-FO objects.

 @@ -63,7 +63,7 @@ So, for example, a given item may be blue either because it is not required at t Currently only works as direct child of fo:flow. - For absolute positioning, use 'position="absolute"' (as 'absolute-position="absolute"' is not implemented), and specify all four of "left", "top", "width" and "height" + For absolute positioning, use 'position="absolute"' (as 'absolute-position="absolute"' is not implemented), and specify all four of "left", "top", "width" and "height" @@ -78,7 +78,7 @@ So, for example, a given item may be blue either because it is not required at t 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 +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 appear exactly where you want it to. @@ -127,7 +127,7 @@ want it to. -

The following is a summary of FOP's current support for the standard XSL-FO properties.

+

The following is a summary of FOP's current support for the standard XSL-FO properties.

 @@ -212,7 +212,7 @@ want it to. only one value allowed only implemented for blocks - can't be used to make extra space (use indents + spaces instead) + can't be used to make extra space (use indents + spaces instead) can be used to control how much the background-color extends beyond the content rectangle @@ -435,7 +435,7 @@ want it to. - "last" isn't implemented! + "last" isn't implemented! @@ -509,7 +509,7 @@ want it to. only one value allowed only implemented for blocks - can't be used to make extra space (use indents + spaces instead) + can't be used to make extra space (use indents + spaces instead) can be used to control how much the background-color extends beyond the content rectangle diff --git a/src/documentation/content/xdocs/graphics.xml b/src/documentation/content/xdocs/graphics.xml index df28d517c..ea9774405 100644 --- a/src/documentation/content/xdocs/graphics.xml +++ b/src/documentation/content/xdocs/graphics.xml @@ -185,7 +185,7 @@ correctly.

If possible, Batik 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 +text.pdf shows how various types and effects with text are handled. Note that tspan and outlined text are not yet implemented.

diff --git a/src/documentation/content/xdocs/resources.xml b/src/documentation/content/xdocs/resources.xml index f553f1386..d8da243db 100644 --- a/src/documentation/content/xdocs/resources.xml +++ b/src/documentation/content/xdocs/resources.xml @@ -30,48 +30,48 @@

XSL-FO
XSLT
XML
Java
PDF
Unicode
Other
@@ -80,57 +80,57 @@
XSL-FO
    -
  • [online book] The XML Bible, by Elliotte Rusty Harold. Chapter 18 of XSL Formatting Objects
    • -
  • [online article] Using Formatting Objects with the Slides DTD, by Paul Sandoz.
    • -
  • [online article] Using XSL Formatting Objects, by J. David Eisenberg.
    • -
  • [online reference] XSL FO reference, by Miloslav Nic.
    • -
  • [online reference] Dave Pawson's XSL-FO FAQ.
    • -
  • [online book] An introduction to XSL Formatting Objects, by Dave Pawson. See hardcopy version below.
    • -
  • [book] XSL-FO, by Dave Pawson, O'Reilly & Associates, 2002, ISBN 0-596-00355-2. See online version above.
    • -
  • [book] Definitive XSL-FO, by G. Ken Holman, Prentice Hall PTR, 2003, ISBN 0-131-40374-5.
    • -
  • [book] XSL Formatting Objects Developer's Handbook, by Doug Lovell, Sams, 2002, ISBN 0-672-32281-1.
    • -
  • [book] Practical Formatting Using XSLFO, Crane Softwrights Ltd., 2003, ISBN 1-894049-11-X.
    • +
  • [online book] The XML Bible, by Elliotte Rusty Harold. Chapter 18 of XSL Formatting Objects
    • +
  • [online article] Using Formatting Objects with the Slides DTD, by Paul Sandoz.
    • +
  • [online article] Using XSL Formatting Objects, by J. David Eisenberg.
    • +
  • [online reference] XSL FO reference, by Miloslav Nic.
    • +
  • [online reference] Dave Pawson's XSL-FO FAQ.
    • +
  • [online book] An introduction to XSL Formatting Objects, by Dave Pawson. See hardcopy version below.
    • +
  • [book] XSL-FO, by Dave Pawson, O'Reilly & Associates, 2002, ISBN 0-596-00355-2. See online version above.
    • +
  • [book] Definitive XSL-FO, by G. Ken Holman, Prentice Hall PTR, 2003, ISBN 0-131-40374-5.
    • +
  • [book] XSL Formatting Objects Developer's Handbook, by Doug Lovell, Sams, 2002, ISBN 0-672-32281-1.
    • +
  • [book] Practical Formatting Using XSLFO, Crane Softwrights Ltd., 2003, ISBN 1-894049-11-X.
XSLT
    -
  • [book] XSLT Programmer's Reference, by Michael H. Kay, Wrox Press, ISBN 1-861-00506-7.
    • -
  • [book] XSLT, by Doug Tidwell, O'Reilly & Associates, 2001, ISBN 0-596-00053-7.
    • -
  • [book] XSLT Cookbook, by Sal Mangano, O'Reilly & Associates, 2002, ISBN 0-596-00372-2.
    • -
  • [article] Dave Pawson's XSL FAQ.
    • -
  • [book] XPath and XPointer: Locating Content in XML Documents, by John E. Simpson, O'Reilly & Associates, 2002, ISBN 0-596-00291-2.
    • -
  • [book] XSL Essentials, by Michael Fitzgerald, John Wiley & Sons, 2001, ISBN 0-471-41620-7.
    • -
  • [book] Java and XSLT, by Eric M. Burke, O'Reilly & Associates, 2001, ISBN 0-596-00143-6.
    • +
  • [book] XSLT Programmer's Reference, by Michael H. Kay, Wrox Press, ISBN 1-861-00506-7.
    • +
  • [book] XSLT, by Doug Tidwell, O'Reilly & Associates, 2001, ISBN 0-596-00053-7.
    • +
  • [book] XSLT Cookbook, by Sal Mangano, O'Reilly & Associates, 2002, ISBN 0-596-00372-2.
    • +
  • [article] Dave Pawson's XSL FAQ.
    • +
  • [book] XPath and XPointer: Locating Content in XML Documents, by John E. Simpson, O'Reilly & Associates, 2002, ISBN 0-596-00291-2.
    • +
  • [book] XSL Essentials, by Michael Fitzgerald, John Wiley & Sons, 2001, ISBN 0-471-41620-7.
    • +
  • [book] Java and XSLT, by Eric M. Burke, O'Reilly & Associates, 2001, ISBN 0-596-00143-6.
XML
    -
  • [online book] The XML Bible, by Elliotte Rusty Harold. See hardcopy version below.
    • -
  • [book] The XML Bible, by Elliotte Rusty Harold, John Wiley & Sons, ISBN 0-764-54760-7. See online version above.
    • -
  • [online resource] A great number of additional XML-related books and articles can be found at the O'Reilly XML Site.
    • +
  • [online book] The XML Bible, by Elliotte Rusty Harold. See hardcopy version below.
    • +
  • [book] The XML Bible, by Elliotte Rusty Harold, John Wiley & Sons, ISBN 0-764-54760-7. See online version above.
    • +
  • [online resource] A great number of additional XML-related books and articles can be found at the O'Reilly XML Site.
Java
    -
  • [online resource] A great number of Java-related books and articles can be found at the O'Reilly Java Site.
    • +
  • [online resource] A great number of Java-related books and articles can be found at the O'Reilly Java Site.
PDF
    -
  • [online resource] Links to the various PDF file format specifications and numerous other documents can be found at Adobe Solutions Network, Acrobat Resources, Acrobat 5.0 SDK Documentation.
    • -
  • [online resource] A list of PDF technical resources can be found at Adobe Solutions Network, Acrobat Resources, Acrobat/PDF Technical Notes
    • -
  • [online resource] A list of Acrobat and PDF developer resources can be found at Adobe Solutions Network, Acrobat Resources, Resources for Developers.
    • +
  • [online resource] Links to the various PDF file format specifications and numerous other documents can be found at Adobe Solutions Network, Acrobat Resources, Acrobat 5.0 SDK Documentation.
    • +
  • [online resource] A list of PDF technical resources can be found at Adobe Solutions Network, Acrobat Resources, Acrobat/PDF Technical Notes
    • +
  • [online resource] A list of Acrobat and PDF developer resources can be found at Adobe Solutions Network, Acrobat Resources, Resources for Developers.
PostScript
    -
  • [online resource] A list of PostScript-related technical resources can be found at Adobe Solutions Network, PostScript Language Technical Notes
    • -
  • [online resource] Additional PostScript-related developer resources can be found at Adobe Solutions Network, PostScript SDK Archive.
    • +
  • [online resource] A list of PostScript-related technical resources can be found at Adobe Solutions Network, PostScript Language Technical Notes
    • +
  • [online resource] Additional PostScript-related developer resources can be found at Adobe Solutions Network, PostScript SDK Archive.
@@ -139,37 +139,40 @@
FOP add-ons
    -
  • [software] TIFFRenderer is a renderer for outputting multi-page TIFF: http://www.tkachenko.com/fop/tiffrenderer.html (MPL)
    • -
  • [software] AFP Renderer / Batch Assembler for FOP: http://mypage.bluewin.ch/huanderegg/ (open source, license unclear)
    • -
  • [software] The Mogwai Project includes a renderer for FOP that generates output for Okidata dot matrix printers (GPL).
    • -
  • [software] Barcode4J (formerly Krysalis Barcode) is a barcode generator which can be used with FOP (Apache-style license).
    • +
  • [software] TIFFRenderer is a renderer for outputting multi-page TIFF: http://www.tkachenko.com/fop/tiffrenderer.html (MPL)
    • +
  • [software] AFP Renderer / Batch Assembler for FOP: http://mypage.bluewin.ch/huanderegg/ (open source, license unclear)
    • +
  • [software] The Mogwai Project includes a renderer for FOP that generates output for Okidata dot matrix printers (GPL).
    • +
  • [software] Barcode4J (formerly Krysalis Barcode) is a barcode generator which can be used with FOP (Apache-style license).
    • +
  • [software] AFP Renderer renders formatted objects to AFP or (MO:DCA).
    • +
  • [software & tools] Objects For Formatting Objects hosts hyphenation patterns and (eventually) files other accessory data files & scripts.
PDF post-processors
    -
  • [software] iText (MPL and LGPL)
    • -
  • [software] PJ Classic by Etymon (GPL)
    • -
  • [software] PJ Professional by Etymon (commercial)
    • +
  • [software] iText (MPL and LGPL)
    • +
  • [software] PJ Classic by Etymon (GPL)
    • +
  • [software] PJ Professional by Etymon (commercial)
XSL-FO editors
    -
  • [software] FOA (Formatting Objects Authoring) (MPL)
    • -
  • [software] FOEditor by Scruffy Software (Shareware)
    • -
  • [software] Scriptura by Inventive Designers (commercial)
    • -
  • [software] XSLfast by jCatalog Software AG (commercial)
    • -
  • [software] XML Report Styler by Rubico (commercial)
    • +
  • [software] FOA (Formatting Objects Authoring) (MPL)
    • +
  • [software] FOEditor by Scruffy Software (Shareware)
    • +
  • [software] Scriptura by Inventive Designers (commercial)
    • +
  • [software] XSLfast by jCatalog Software AG (commercial)
    • +
  • [software] XML Report Styler by Rubico (commercial)
Other products
    -
  • [software] html2fo is a converter from HTML to XSL-FO (GPL).
    • -
  • [software] wh2fo is a converter from Word HTML to XSL-FO (MPL).
    • -
  • [software] RTF2FO is a converter from RTF to XSL-FO by Novosoft (commercial).
    • -
  • [software] The XPath Visualizer. +
  • [software] html2fo is a converter from HTML to XSL-FO (GPL).
    • +
  • [software] wh2fo is a converter from Word HTML to XSL-FO (MPL).
    • +
  • [software] RTF2FO is a converter from RTF to XSL-FO by Novosoft (commercial).
    • +
  • [software] html2fo is a converter from HTML to XSL-FO (GPL).
    • +
  • [software] The XPath Visualizer. Web site says: "This is a full blown Visual XPath Interpreter for the evaluation of any XPath expression and visual presentation of the resulting nodeset or scalar value." Requires Internet Explorer 5+. (freeware)
    • diff --git a/src/documentation/content/xdocs/site.xml b/src/documentation/content/xdocs/site.xml index 3c2c4e61c..6fc07b97d 100644 --- a/src/documentation/content/xdocs/site.xml +++ b/src/documentation/content/xdocs/site.xml @@ -18,11 +18,15 @@ + + + + + + - - @@ -42,14 +46,10 @@ - - - - diff --git a/src/documentation/resources/images/group-logo.gif b/src/documentation/resources/images/group-logo.gif index 57e4b36a1..8c56dc678 100644 Binary files a/src/documentation/resources/images/group-logo.gif and b/src/documentation/resources/images/group-logo.gif differ diff --git a/src/documentation/resources/images/logo.jpg b/src/documentation/resources/images/logo.jpg index 1e1ef8fa3..05cc83cc2 100644 Binary files a/src/documentation/resources/images/logo.jpg and b/src/documentation/resources/images/logo.jpg differ diff --git a/src/documentation/sitemap.xmap b/src/documentation/sitemap.xmap index 36ddf1ca4..c0cb01324 100644 --- a/src/documentation/sitemap.xmap +++ b/src/documentation/sitemap.xmap @@ -1,136 +1,14 @@ - - - - - - - - - - - - - - - //*[local-name() = 'section'] - title/text() - - - - - - /site// - /@href - - - - - false - false - false - - - - - - - - - - -//W3C//DTD HTML 4.01 Transitional//EN - http://www.w3.org/TR/html4/loose.dtd - ISO-8859-1 - - - ISO-8859-1 - - - -//Netscape Communications//DTD RSS 0.91//EN - http://my.netscape.com/publish/formats/rss-0.91.dtd - ISO-8859-1 - - - - ISO-8859-1 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -146,358 +24,26 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -509,270 +55,22 @@ - + - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/src/documentation/skinconf.xml b/src/documentation/skinconf.xml index f5002f840..3878cce79 100644 --- a/src/documentation/skinconf.xml +++ b/src/documentation/skinconf.xml @@ -1,12 +1,12 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ]> - + - - false - xml.apache.org - Apache XML + + + + + true + + false + + true + + true + + + true + + + false + + false + + true + .at. + + + true + + FOP + FOP (Formatting Objects Processor) is the world's first print formatter driven by XSL formatting objects (XSL-FO) and the world's first output independent formatter. It is a Java application that reads a formatting object (FO) tree and renders the resulting pages to a specified output. Output formats currently supported include PDF, PCL, PS, SVG, XML (area tree representation), Print, AWT, MIF and TXT. The primary output target is PDF. http://xml.apache.org/fop/ images/logo.jpg + + Apache XML + MyGroup Description http://xml.apache.org/ images/group-logo.gif + - + + + + + 1999-2003 The Apache Software Foundation. + - - + - + + + + + + + + + + + p.quote { + margin-left: 2em; + padding: .5em; + background-color: #f0f0f0; + font-family: monospace; + } + + + + + + + + + + + + + + + + + + + + + + + + + 1in + 1in + 1in + 1in + + + + false + + + false + + + + + Built with Apache Forrest + http://forrest.apache.org/ + images/built-with-forrest-button.png + 88 + 31 + PDF created by FOP - http://xml.apache.org/fop + http://xml.apache.org/fop/ images/logo.jpg 138 31