</p>
</section>
</section>
+ <section id="fonts">
+ <title>Apache FOP Font Config</title>
+ <p>
+ Apache FOP has special Font considerations, which are explained in detail
+ on the <a href="fonts.html">Fonts</a> page.
+ </p>
+ </section>
<section>
<title>When it does not work</title>
msmincho.ttc msminch.xml</source>
</section>
<section id="register">
- <title>Register Fonts with FOP</title>
+ <title>Register Fonts with FOP - Auto-Detect Fonts</title>
<p>You must tell FOP how to find and use the font metrics files by registering them in the <a href="configuration.html">FOP Configuration</a>. Add entries for your custom fonts, regardless of font type, to the configuration file in a manner similar to the following:</p>
<source><![CDATA[
<fonts>
<!-- automatically detect operating system installed fonts -->
<auto-detect/>
</fonts>]]></source>
- <note>Review the documentation for <a href="configuration.html">FOP Configuration</a> for instructions on making the FOP configuration available to FOP when it runs. Otherwise, FOP has no way of finding your custom font information.</note>
+ <note>
+ Review the documentation for <a href="configuration.html">FOP Configuration</a> for
+ instructions on making the FOP configuration available to FOP when it runs. Otherwise,
+ FOP has no way of finding your custom font information.
+ </note>
+ The Unix autodetect feature looks in the following locations for fonts it can use:
+ <ul>
+ <li><code>java user.home + "/.fonts"</code></li>
+ <li><code>"/usr/local/fonts"</code></li>
+ <li><code>"/usr/share/fonts"</code></li>
+ <li><code>"/usr/X11R6/lib/X11/fonts"</code></li>
+ </ul>
<ul>
<li>
URLs are used to access the font metric and font files.
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
<document>
<header>
- <title>Apache FOP Trunk (Development code)</title>
+ <title>Apache FOP Version 0.94</title>
<version>$Revision: 201586 $</version>
</header>
<body>
<section id="intro">
<title>Introduction</title>
<p>
- <strong>FOP Trunk</strong> is the name for the current
- development code as found in the <a
- href="ext:svn-repo/trunk">Subversion repository</a>. This
- section of the FOP web site provides the documentation for
- this version.
+ The Apache FOP team is proud to present to you this production quality release.
+ We're still in the process of adding new features. We welcome any feedback you
+ might have and even more, any other form of help to get the project forward.
</p>
<p>
- The Apache FOP team is proud to present to you this production quality codebase. It has taken
- over three years to get this far and over two years without a new release from the FOP
- project. We're still in the process of adding new features. We welcome any feedback you
- might have and even more, any other form of help to get the project forward.
+ This fifth release contains many bug fix release and new features compared
+ to 0.92beta. To see what has changed since the last release, please visit the
+ <a href="changes_0.94.html">Changes Page</a> and the <a href="releaseNotes_0.94.html">Release Notes</a>.
</p>
</section>
<section id="upgrading">
information contained on the <a href="upgrading.html">Upgrading page</a>!
</p>
</section>
+ <section id="download">
+ <title>Download</title>
+ <p>
+ To download this version, please visit the <a href="../download.html">download page</a>.
+ </p>
+ </section>
</body>
</document>
<section id="overview">
<title>Overview</title>
<warning>
- Support for PDF/X is available beginning with version 0.93. This feature is new and
- may not be 100% complete, yet. Feedback is welcome.
+ Support for PDF/X was made available beginning with version 0.93.
+ This feature is new and may not be 100% complete, yet. Feedback is welcome.
</warning>
<p>
PDF/X is a standard which faciliates prepress digital data exchange using PDF.
</p>
<ul>
<li>
- More than half of the codebase has been rewritten over the last three years. With version 0.93 the code has reached <strong>production level</strong>.
+ More than half of the codebase has been rewritten over the last three years. With version 0.93 the code has reached <strong>production level</strong>, and
+ the tradition continues with version 0.94.
</li>
<li>
The API of FOP has changed considerably and is not
<li>Determine whether further testing is required.</li>
<li>Commit any outstanding changes</li>
<li>Create a branch called <code>branches/fop-v_vv</code></li>
- <li>Edit release notes (README and status.xml in the root).</li>
- <li>Update the index.xml and site.xml for the new version.</li>
+ <li>Edit release notes (<code>README</code> and <code>status.xml</code> in the root).</li>
+ <li>Update the <code>index.xml</code> and <code>site.xml</code> for the new version.</li>
<li>Update the version numbers in the release column on the
- compliance page; update the compliance in the release column
+ compliance page (<code>compliance.xml</code>); update the compliance in the release column
to the current state (development column).</li>
- <li>Update version number in build.xml (not to be merged back
+ <li>Update version number in <code>build.xml</code> (not to be merged back
into trunk).</li>
<li>Copy trunk documentation directory to a new directory with
the version number, and update any links and the .htaccess
<code>people.apache.org</code></li>
<li>Ask on fop-dev to check the branch and the generated dist
files for errors.</li>
- <li>Tag the source tree with the release ID. For example, if the release is 0.93:
- <code>svn copy https://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-0_93 https://svn.apache.org/repos/asf/xmlgraphics/fop/tags/fop-0_93</code></li>
+ <li>Tag the source tree with the release ID. For example, if the release is 0.94:
+ <code>svn copy https://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-0_94 https://svn.apache.org/repos/asf/xmlgraphics/fop/tags/fop-0_94</code></li>
<li>Make a fresh checkout with the just created tag:
- <code>svn co https://svn.apache.org/repos/asf/xmlgraphics/fop/tags/fop-0_93</code></li>
+ <code>svn co https://svn.apache.org/repos/asf/xmlgraphics/fop/tags/fop-0_94</code></li>
<li>Copy jimi and jai to lib/ (jimi-1.0.jar, jai_core.jar, jai_codec.jar)</li>
<li>Copy jce-jdk13-119.jar from <link href="http://www.bouncycastle.org/latest_releases.html">
from http://www.bouncycastle.org/latest_releases.html</link> to lib/</li>
<li>Alternatively, create a build-local.properties file that points to the above libs.</li>
<li>Run build[.sh] dist. Do this once using Sun JDK 1.3.1_15 or later and once with Sun JDK 1.4.2_08 or later. A Forrest installation is needed.</li>
<li>Create signatures. Don't forget to upload your KEY:
- <code>gpg -a -b --force-v3-sigs fop-0.93-src.tar.gz</code> etc.</li>
+ <code>gpg -a -b --force-v3-sigs fop-0.94-src.tar.gz</code> etc.</li>
<li>Upload the dist and signature files to your web directory
on people.apache.org (An account on minotaur is needed):
- <code>scp fop-0.93*.tar.gz*
+ <code>scp fop-0.94*.tar.gz*
chrisg@people.apache.org:public_html/</code></li>
<li>Check permissions:
<code>chmod 664 ... ; chgrp xmlgraphics ...</code></li>
- <li>Add MD5 sums: <code>md5 fop-0.93-src.tar.gz >
- fop-0.93-src.tar.gz.md5</code> etc.</li>
+ <li>Add MD5 sums: <code>md5 fop-0.94-src.tar.gz >
+ fop-0.94-src.tar.gz.md5</code> etc.</li>
<li>Make a test download.</li>
<li>Start a vote for the release on
<code>general@xmlgraphics.a.o</code>. The message should point
<p>
When it's ready and the committers have enough time to go through
the time-consuming process of creating a release. We
- released version 0.93 on 9 January 2007, and intend to
- release version 1.0 later in 2007. If you
- want to speed up the process, consider to
- <link href="dev/index.html#involved">contribute</link> to FOP.</p>
+ released version 0.94 on XX August 2007, and intend to
+ release version 1.0 later in late 2007 or early 2008. If you
+ want to speed up the process, consider
+ <link href="dev/index.html#involved">contributing</link> to FOP.</p>
</answer>
</faq>
<faq id="redesign">
If you run FOP embedded in your servlet, web application or
other Java application, check the classpath of the
application. Check the also the information pertaining to <link
- href="0.93/servlets.html#servlet-engine">servlet engines</link>
+ href="0.94/servlets.html#servlet-engine">servlet engines</link>
for further hints.
</p>
<p>
<question>I get an OutOfMemoryException.</question>
<answer>
<p>
- See <link href="0.93/running.html#memory">FOP Memory</link>.
+ See <link href="0.94/running.html#memory">FOP Memory</link>.
</p>
</answer>
</faq>
<p>
If you use XSLT, problems in your style sheet and in your
source XML also can produce a NullPointerException. <link
- href="0.93/running.html#check-input">Run the transformation
+ href="0.94/running.html#check-input">Run the transformation
separately</link> to check for this, usually you'll get a
detailed error message from the XSLT processor.
</p>
</p>
<p>
Try also setting the <link
- href="0.93/configuration.html#general-elements">font-base
+ href="0.94/configuration.html#general-elements">font-base
configuration</link>.
</p>
</answer>
<part id="part-output">
<title>Problems with FOP output</title>
<faq id="leader-expansion">
- <question>Leaders don't work anymore in 0.93. Instead of
+ <question>Leaders don't work anymore in 0.94. Instead of
filling the line, only three dots or a short ruler is
output.</question>
<answer>
<p>Other possibilities:</p>
<ul>
<li>The image format is not supported or not supported completely.
- See <link href="0.93/graphics.html">FOP Graphics Formats</link> for a
+ See <link href="0.94/graphics.html">FOP Graphics Formats</link> for a
list of supported formats and related issues.</li>
<li>The graphic may be too large to fit into the intended space.</li>
<li>There may be something (static content) that is obscuring the
<faq id="png-fails">
<question>My graphical images do not work properly.</question>
<answer>
- <p>See <link href="0.93/graphics.html">FOP Graphics Formats</link> for a
+ <p>See <link href="0.94/graphics.html">FOP Graphics Formats</link> for a
list of supported graphics formats and related issues.</p>
</answer>
</faq>
<faq id="graphic-resolution">
<question>Why is my graphic rendered at a different resolution than it was created?</question>
<answer>
- <p>See <link href="0.93/graphics.html#resolution">Graphics Resolution</link>.</p>
+ <p>See <link href="0.94/graphics.html#resolution">Graphics Resolution</link>.</p>
</answer>
</faq>
<faq id="keep-with">
<answer>
<p>Make sure you have set the language and optionally the country attributes for an appropriate XSL-FO element (fo:page-sequence, fo:block or fo:character):</p>
<source><![CDATA[<fo:page-sequence language="fi">]]></source>
- <p>See <link href="0.93/hyphenation.html#support">Hyphenation Support</link> for details and instructions on using hyphenation with FOP.</p>
+ <p>See <link href="0.94/hyphenation.html#support">Hyphenation Support</link> for details and instructions on using hyphenation with FOP.</p>
<p>Explicitly enable hyphenation for an appropriate XSL-FO element (fo:block, fo:character):</p>
<source><![CDATA[<fo:block hyphenate="true">]]></source>
</answer>
<question>How do I use FOP in a servlet?</question>
<answer>
<p>
- See <link href="0.93/servlets.html">Using FOP in a Servlet</link>.
+ See <link href="0.94/servlets.html">Using FOP in a Servlet</link>.
</p>
</answer>
</faq>
transformation?</question>
<answer>
<p>
- See <link href="0.93/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</link>.
+ See <link href="0.94/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</link>.
</p>
</answer>
</faq>
<question>How do I pass parameters to the XSLT transformation?</question>
<answer>
<p>
- See <link href="0.93/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</link>.
+ See <link href="0.94/servlets.html#xslt">Using FOP in a Servlet with XSLT Transformation</link>.
</p>
</answer>
</faq>
<question>How do I set the baseDir property in a servlet environment?</question>
<answer>
<p>
- See <link href="0.93/embedding.html#config-internal">Setting the Configuration Programmatically</link>.
+ See <link href="0.94/embedding.html#config-internal">Setting the Configuration Programmatically</link>.
</p>
</answer>
</faq>
<question>How do I use a user configuration file from a servlet?</question>
<answer>
<p>
- See <link href="0.93/embedding.html#config-external">Using a Configuration File in an Embedded App</link>.
+ See <link href="0.94/embedding.html#config-external">Using a Configuration File in an Embedded App</link>.
</p>
</answer>
</faq>
get FOP working for various servlet engines?</question>
<answer>
<p>
- See <link href="0.93/servlets.html#servlet-engine">Servlet Engines</link>.
+ See <link href="0.94/servlets.html#servlet-engine">Servlet Engines</link>.
</p>
</answer>
</faq>
<question>Can FOP be used in multithreaded environments?</question>
<answer>
<p>
- See <link href="0.93/embedding.html#multithreading">Multithreading FOP</link>.
+ See <link href="0.94/embedding.html#multithreading">Multithreading FOP</link>.
</p>
</answer>
</faq>
<question>The rendering of SVG text in my PDF is of poor quality.
Can I control this?</question>
<answer>
- <p>See <link href="0.93/graphics.html#svg-pdf-text">Placing SVG Text into PDF</link>.</p>
+ <p>See <link href="0.94/graphics.html#svg-pdf-text">Placing SVG Text into PDF</link>.</p>
</answer>
</faq>
<faq id="svg-headless">
<question>How do I use FOP with SVG on headless servers?</question>
<answer>
- <p>See <link href="0.93/graphics.html#batik">FOP: Graphics (Batik)</link>.</p>
+ <p>See <link href="0.94/graphics.html#batik">FOP: Graphics (Batik)</link>.</p>
</answer>
</faq>
<faq id="svghangs">
<faq id="svg-scaling">
<question>Why is my SVG rendered at a size different from that specified in my fo:external-graphic element?</question>
<answer>
- <p>See <link href="0.93/graphics.html#svg-scaling">SVG Scaling</link>.</p>
+ <p>See <link href="0.94/graphics.html#svg-scaling">SVG Scaling</link>.</p>
</answer>
</faq>
<faq id="svg-attribute-required">
<question>How do I embed fonts in PDF?</question>
<answer>
<p>
- See the <link href="0.93/fonts.html">Fonts</link> page for information
+ See the <link href="0.94/fonts.html">Fonts</link> page for information
about embedding fonts.
</p>
</answer>
set. For a variety of reasons, even those are not completely
guaranteed to work, for example you can't use the fi
ligature from the standard serif font. Check the <link
- href="0.93/output.html#pdf-fonts">overview</link> for the default
+ href="0.94/output.html#pdf-fonts">overview</link> for the default
PDF fonts.
</p>
<p>
the desired character. Furthermore the font must be
available on the machine where the PDF is viewed or it must
have been embedded in the PDF file. See <link
- href="0.93/fonts.html">embedding fonts</link>.
+ href="0.94/fonts.html">embedding fonts</link>.
</p>
<p>
For most symbols, it is better to select the symbol font
<faq id="pdf-postprocess">
<question>What tools are available for post-processing my PDF document?</question>
<answer>
- <p>See <link href="0.93/output.html#pdf-postprocess">PDF Post-processing</link>.</p>
+ <p>See <link href="0.94/output.html#pdf-postprocess">PDF Post-processing</link>.</p>
</answer>
</faq>
<faq id="pdf-security">
to my PDF document?</question>
<answer>
<p>
- See <link href="0.93/pdfencryption.html">PDF Encryption</link>.
- See also <link href="0.93/output.html#pdf-postprocess">PDF Post-processing</link>.
+ See <link href="0.94/pdfencryption.html">PDF Encryption</link>.
+ See also <link href="0.94/output.html#pdf-postprocess">PDF Post-processing</link>.
</p>
</answer>
</faq>
<question>How do I add document properties (title, author, etc.) to my
PDF document?</question>
<answer>
- <p>See <link href="0.93/output.html#pdf-postprocess">PDF Post-processing</link>.</p>
+ <p>See <link href="0.94/output.html#pdf-postprocess">PDF Post-processing</link>.</p>
</answer>
</faq>
<faq id="pdf-watermark">
<question>How do I add watermarks to my PDF document?</question>
<answer>
- <p>See <link href="0.93/output.html#pdf-watermark">PDF Watermarks</link>.</p>
+ <p>See <link href="0.94/output.html#pdf-watermark">PDF Watermarks</link>.</p>
</answer>
</faq>
<faq id="pdf-print-contortion">
<answer>
<p>
This is a problem of Internet Explorer requesting the content several
- times. Please see the <link href="0.93/servlets.html#ie">notes on Internet Explorer</link>
+ times. Please see the <link href="0.94/servlets.html#ie">notes on Internet Explorer</link>
for more information.
</p>
</answer>
application that reads a formatting object (FO) tree and renders the resulting
pages to a specified output. <link href="0.94/output.html">Output formats</link>
currently supported include PDF, PS, PCL, AFP, XML (area tree representation),
- Print, AWT, PNG and TXT. The primary output target is PDF.
+ Print, AWT and PNG, and to a lesser extent, RTF and TXT. The primary output target is PDF.
</p>
<figure width="480" height="260" src="images/document.jpg" alt="Render Diagram" />
<p>
</li>
<li>
The API has changed between 0.91beta this release.
- Please consult the <a href="0.93/upgrading.html">"Upgrading"</a> page for details.
+ Please consult the <a href="0.94/upgrading.html">"Upgrading"</a> page for details.
</li>
<li>
You may experience different behaviour compared to version 0.20.5.
- Please consult the <a href="0.93/upgrading.html">"Upgrading"</a> page for details.
+ Please consult the <a href="0.94/upgrading.html">"Upgrading"</a> page for details.
</li>
</ul>
<p>Known Issues:</p>
</li>
<li>
You may experience different behaviour compared to version 0.20.5.
- Please consult the <a href="0.93/upgrading.html">"Upgrading"</a> page indicated above for details.
+ Please consult the <a href="0.94/upgrading.html">"Upgrading"</a> page indicated above for details.
</li>
</ul>
<p>Known Issues:</p>
</li>
<li>
You may experience different behaviour compared to version 0.20.5.
- Please consult the <a href="0.93/upgrading.html">"Upgrading"</a> page indicated above for details.
+ Please consult the <a href="0.94/upgrading.html">"Upgrading"</a> page indicated above for details.
</li>
</ul>
<p>Known Issues:</p>
</section>
<section>
<title>FOP 0.20.5</title>
- <p>This is the last planned release in the 0.20.x series (aka maintenance branch).</p>
+ <p>This was the last release in the 0.20.x series (aka maintenance branch).</p>
<p>Important changes since the last release (0.20.4):</p>
<ul>
<li>Some hyphenation patterns (cs, da, de, de_DR, el, en, en_US, fr, nl,
<li>Links in PDF won't generate multiple link rectangles anymore. If this causes
a problem you can set the system property "links.merge" to "no".
</li>
- <li>FOP has been compiled with cryptography support. See <a href="0.20.5/pdfencryption.html">
+ <li>FOP has been compiled with cryptography support. See
+ <a href="0.94/pdfencryption.html">
PDF encryption</a> for details about installation and usage.
</li>
<li>The behaviour of leader has changed. See
support for additional truetype fonts in AWT Viewer.
</li>
<li>Logging has been changed from LogKit to Avalon's Logger Interface.
- (see <a href="0.20.5/embedding.html">Embedding</a> for details).
+ (see <a href="0.94/embedding.html">Embedding</a> for details).
</li>
<li>Building under JDK 1.4:
You need to add a method in
-->
<!--
- BEGIN Version 0.20.5 tab
+ BEGIN Version 0.93 documentation tab
-->
- <v0205 label="Version 0.20.5" href="0.20.5/" tab="maintenanceversion">
+ <trunk label="FOP 0.93" href="0.93/" tab="stableversion">
<about label="About" href="index.html"/>
-
+ <release label="Release Notes" href="releaseNotes_0.93.html"/>
+ <changes label="Changes" href="changes_0.93.html"/>
+ <knownissues label="Known Issues" href="knownissues_overview.html"/>
+ <upgrading label="Upgrading" href="upgrading.html"/>
+
<using label="Using FOP">
<build label="Build" href="compiling.html"/>
<config label="Configure" href="configuration.html"/>
<servlet label="Servlets" href="servlets.html"/>
<ant label="Ant Task" href="anttask.html"/>
</using>
-
+
<features label="Features">
<output label="Output Targets" href="output.html"/>
+ <if label="Intermediate Format" href="intermediate.html"/>
<pdfencryption label="PDF Encryption" href="pdfencryption.html"/>
+ <pdfa label="PDF/A" href="pdfa.html"/>
+ <pdfx label="PDF/X" href="pdfx.html"/>
<graphics label="Graphics" href="graphics.html"/>
<fonts label="Fonts" href="fonts.html"/>
<hyphenation label="Hyphenation" href="hyphenation.html"/>
<extensions label="Extensions" href="extensions.html"/>
</features>
- </v0205>
-
+ </trunk>
<!--
- END Version 0.20.5 tab
+ END Version 0.93 documentation tab
-->
<!--
- BEGIN Version 0.93 documentation tab
+ BEGIN Version 0.94 documentation tab
-->
- <trunk label="FOP 0.93" href="0.93/" tab="stableversion">
+ <trunk label="FOP 0.94" href="0.94/" tab="develversion">
<about label="About" href="index.html"/>
- <release label="Release Notes" href="releaseNotes_0.93.html"/>
- <changes label="Changes" href="changes_0.93.html"/>
+ <release label="Release Notes" href="releaseNotes_0.94.html"/>
+ <changes label="Changes" href="changes_0.94.html"/>
<knownissues label="Known Issues" href="knownissues_overview.html"/>
<upgrading label="Upgrading" href="upgrading.html"/>
</trunk>
<!--
- END Version 0.93 documentation tab
+ END Version 0.94 documentation tab
-->
<!--
</p>
<ul>
<li>
- More than half of the codebase has been rewritten over the last three years. With version 0.93 the code has reached <strong>production level</strong>.
+ More than half of the codebase has been rewritten over the
+ last three years. With version 0.93 the code has reached
+ <strong>production level</strong>, and continues to improve..
</li>
<li>
The API of FOP has changed considerably and is not
projects / xmlgraphics-fop.git / commitdiff