You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xmlgraphics.apache.org by sp...@apache.org on 2010/07/21 09:08:43 UTC
svn commit: r966110 [8/29] - in /xmlgraphics/site/deploy/fop: 0.95/ 1.0/
1.0/images/
Added: xmlgraphics/site/deploy/fop/1.0/compiling.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/1.0/compiling.html?rev=966110&view=auto
==============================================================================
--- xmlgraphics/site/deploy/fop/1.0/compiling.html (added)
+++ xmlgraphics/site/deploy/fop/1.0/compiling.html Wed Jul 21 07:08:39 2010
@@ -0,0 +1,408 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.8">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Apache FOP: Building from Source Code</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |header
+ +-->
+<div class="header">
+<!--+
+ |start group logo
+ +-->
+<div class="grouplogo">
+<a href="http://xmlgraphics.apache.org/"><img class="logoImage" alt="Apache XML Graphics" src="../images/group-logo.gif" title="Apache XML Graphics is responsible for the creation and maintenance of software for managing the conversion of XML formats to graphical output, and the creation and maintenance of related software components, based on software licensed to the Foundation"></a>
+</div>
+<!--+
+ |end group logo
+ +-->
+<!--+
+ |start Project Logo
+ +-->
+<div class="projectlogo">
+<a href="http://xmlgraphics.apache.org/fop/"><img class="logoImage" alt="Apache FOP" src="../images/logo.jpg" title="Apache FOP (Formatting Objects Processor) is the world's first output independent formatter. Output formats currently supported include PDF, PCL, PS, SVG, XML (area tree representation), Print, AWT, MIF and TXT. The primary output target is PDF."></a>
+</div>
+<!--+
+ |end Project Logo
+ +-->
+<!--+
+ |start Search
+ +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="xmlgraphics.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">
+ <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+ |end search
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="unselected" href="../index.html">Home</a>
+</li>
+<li>
+<a class="unselected" href="../0.95/index.html">Version 0.95</a>
+</li>
+<li class="current">
+<a class="selected" href="../1.0/index.html">Version 1.0</a>
+</li>
+<li>
+<a class="unselected" href="../trunk/index.html">FOP Trunk</a>
+</li>
+<li>
+<a class="unselected" href="../dev/index.html">Development</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs"></div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache.org</a> > <a href="http://xml.apache.org/">XML Federation</a> > <a href="http://xmlgraphics.apache.org/">xmlgraphics.apache.org</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">FOP 1.0</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../1.0/index.html">About</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/releaseNotes_1.0.html">Release Notes</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/changes_1.0.html">Changes (1.0)</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/knownissues_overview.html">Known Issues</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/upgrading.html">Upgrading</a>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.1.6', '../skin/')" id="menu_selected_1.1.6Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Using FOP</div>
+<div id="menu_selected_1.1.6" class="selectedmenuitemgroup" style="display: block;">
+<div class="menupage">
+<div class="menupagetitle">Build</div>
+</div>
+<div class="menuitem">
+<a href="../1.0/configuration.html">Configure</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/running.html">Run</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/embedding.html">Embed</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/servlets.html">Servlets</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/anttask.html">Ant Task</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.7', '../skin/')" id="menu_1.1.7Title" class="menutitle">Features</div>
+<div id="menu_1.1.7" class="menuitemgroup">
+<div class="menuitem">
+<a href="../1.0/output.html">Output Targets</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/intermediate.html">Intermediate Format</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/pdfencryption.html">PDF Encryption</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/pdfa.html">PDF/A</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/pdfx.html">PDF/X</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/graphics.html">Graphics</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/fonts.html">Fonts</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/hyphenation.html">Hyphenation</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/extensions.html">Extensions</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/events.html">Events</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/metadata.html">Metadata</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/accessibility.html">Accessibility</a>
+</div>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+ |alternative credits
+ +-->
+<div id="credit2"></div>
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<div title="raw XML" class="xmllink">
+<a class="dida" href="compiling.xml"><img alt="XML - icon" src="../skin/images/xmldoc.gif" class="skin"><br>
+ XML</a>
+</div>
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="compiling.pdf"><img alt="PDF -icon" src="../skin/images/pdfdoc.gif" class="skin"><br>
+ PDF</a>
+</div>
+<div class="trail">Font size:
+ <input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">
+ <input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+ <input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
+</div>
+<h1>Apache FOP: Building from Source Code</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#build-needed">Do You Need To Build?</a>
+</li>
+<li>
+<a href="#env">Set Up Your Environment</a>
+<ul class="minitoc">
+<li>
+<a href="#env-jdk">JDK</a>
+</li>
+<li>
+<a href="#env-classpath">CLASSPATH</a>
+</li>
+<li>
+<a href="#env-java-home">JAVA_HOME</a>
+</li>
+<li>
+<a href="#env-ant">Apache Ant</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#build-script">Run the Build Script</a>
+</li>
+<li>
+<a href="#problems">Troubleshooting</a>
+</li>
+</ul>
+</div>
+
+<a name="N10011"></a><a name="build-needed"></a>
+<h2 class="underlined_10">Do You Need To Build?</h2>
+<div class="section">
+<p>
+ FOP distributions are either pre-compiled binary or source.
+ If you are using a binary distribution, it is already built and there is no need to build it again.
+ See the <a href="../download.html">Download Instructions</a> for information about whether a
+ binary or source distribution is best for your needs.
+ </p>
+<p>
+ If you got the source code from a repository snapshot or via Subversion you will need to build FOP
+ in any case.
+ </p>
+</div>
+
+<a name="N10022"></a><a name="env"></a>
+<h2 class="underlined_10">Set Up Your Environment</h2>
+<div class="section">
+<a name="N10028"></a><a name="env-jdk"></a>
+<h3 class="underlined_5">JDK</h3>
+<p>
+ Building FOP requires a minimum Java Development Kit (JDK/SDK) of 1.4
+ (A Java Runtime Environment is not sufficient).
+ </p>
+<a name="N10032"></a><a name="env-classpath"></a>
+<h3 class="underlined_5">CLASSPATH</h3>
+<p>
+ There is generally no need to setup a classpath. All libraries needed to compile FOP are included
+ in the source distribution and are referenced by the build script.
+ You will only need to adjust the classpath if you build FOP in some other way. See the build
+ script build.xml for details.
+ </p>
+<a name="N1003C"></a><a name="env-java-home"></a>
+<h3 class="underlined_5">JAVA_HOME</h3>
+<p>
+ The build script uses <a class="external" href="http://ant.apache.org/">Apache Ant</a>, a popular
+ Java-based build tool, which usually requires that the environment variable JAVA_HOME point to
+ your local JDK root directory. This is true even if you use JDK 1.4 or above, which normally
+ does not need this setting.
+ </p>
+<a name="N1004A"></a><a name="env-ant"></a>
+<h3 class="underlined_5">Apache Ant</h3>
+<p>
+
+<a class="external" href="http://ant.apache.org/">Apache Ant</a> (Version 1.7 or later) must be installed in order to
+ build FOP. Following best practices we don't include Ant with FOP anymore. You can find the
+ <a class="external" href="http://ant.apache.org/manual/">instructions to install Ant in the Ant manual</a> on the web.
+ </p>
+</div>
+
+<a name="N1005D"></a><a name="build-script"></a>
+<h2 class="underlined_10">Run the Build Script</h2>
+<div class="section">
+<p>
+ Change to the FOP root directory and build FOP by executing the build script (build.xml)
+ using the "ant" command.
+ </p>
+<div class="note">
+<div class="label">Note</div>
+<div class="content">
+ The "ant" command is only available on your system if you've properly
+ <a class="external" href="http://ant.apache.org/manual/">installed Apache Ant</a> and added Ant's location to the PATH
+ environment variable.
+ </div>
+</div>
+<p>
+ The file build.xml in the FOP root directory is the blueprint that Ant uses for the build. It
+ contains information for numerous build targets, many of which are building blocks to more
+ useful target, and others which are primarily used by the FOP developers.
+ You may benefit from looking through this file to learn more about the various build targets.
+ To obtain a complete list of useful build targets:
+ </p>
+<pre class="code">ant -projecthelp</pre>
+<p>The most useful targets are:</p>
+<ul>
+
+<li>
+
+<strong>package</strong>: Generates the JAR files (default). This is the normal build that
+ produces a jar file usable for running FOP.
+ </li>
+
+<li>
+
+<strong>clean </strong>: Cleans the build directory. This is useful for making sure that
+ any build errors are cleaned up before starting a new build. It should not ordinarily be
+ needed, but may be helpful if you are having problems with the build process itself.
+ </li>
+
+<li>
+
+<strong>javadocs</strong>: Creates the FOP API documentation.
+ <div class="note">
+<div class="label">Note</div>
+<div class="content">A minimum JDK version of 1.4.2 is required for generating the javadocs.</div>
+</div>
+
+</li>
+
+</ul>
+<p>To run the build:</p>
+<pre class="code">ant [target ...]</pre>
+<p>For example to do a normal build for the "all" target (which is the default):</p>
+<pre class="code">ant</pre>
+<p>OR</p>
+<pre class="code">ant all</pre>
+<p>To clean the build directory first:</p>
+<pre class="code">ant clean all</pre>
+<div class="note">
+<div class="label">Note</div>
+<div class="content">
+ If you want to shorten the build time you can just call the "package" target which
+ doesn't perform any automated tests during the build.
+ </div>
+</div>
+</div>
+
+<a name="N100AF"></a><a name="problems"></a>
+<h2 class="underlined_10">Troubleshooting</h2>
+<div class="section">
+<p>If you have problems building FOP, please try the following:</p>
+<ul>
+
+<li>Run the build with the target of "clean", then rerun the build.</li>
+
+<li>Delete the build directory completely, then rerun the build.</li>
+
+<li>
+ Make sure you do not have a non-FOP version of xerces.jar, xalan.jar, batik.jar,
+ or another dependency product somewhere in your CLASSPATH.
+ </li>
+
+<li>
+ If the build still fails, see the <a href="../gethelp.html">Getting Help</a>
+ page for further help.
+ </li>
+
+</ul>
+</div>
+
+<span class="version">
+ version 964711</span>
+</div>
+<!--+
+ |end content
+ +-->
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<!--+
+ |start bottomstrip
+ +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright ©
+ 1999-2009 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Propchange: xmlgraphics/site/deploy/fop/1.0/compiling.html
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: xmlgraphics/site/deploy/fop/1.0/compiling.html
------------------------------------------------------------------------------
svn:keywords = Id
Added: xmlgraphics/site/deploy/fop/1.0/compiling.pdf
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/1.0/compiling.pdf?rev=966110&view=auto
==============================================================================
--- xmlgraphics/site/deploy/fop/1.0/compiling.pdf (added)
+++ xmlgraphics/site/deploy/fop/1.0/compiling.pdf Wed Jul 21 07:08:39 2010
@@ -0,0 +1,541 @@
+%PDF-1.3
+%ª«¬
+4 0 obj
+<< /Type /Info
+/Producer (FOP 0.20.5) >>
+endobj
+5 0 obj
+<< /Length 740 /Filter [ /ASCII85Decode /FlateDecode ]
+ >>
+stream
+Gb!#Z9lK#F&A@7.ps9++XGO]U?<3b...@jIr7GjltGP>GKQU5#"B*=fpr\VDb(W;CVjmM-q'kA4JFOn<Y]2W<L@'Y<TclX^7:!7<FK"=1Xi.l/e7AsH[l:]!_PGHE[MpP#8`8N.>dRZ`Ne+D@7`(8p=j&0dF[D#d9=k2QRq5Kj[bCoJ8MqGf461"QLkH9+n&I8_Lm90N4@Ksshbe7q$:QK;$;9FXp(6gi.)CAS(RCt&hrLod?OtrS/B!*g,:Ohd'4*041\AgU"O9_d"<VY4V?WL0He*XlN=,V*&/@/jhVmRTpb=-V-MlnB$&&]k7<r~>
+endstream
+endobj
+6 0 obj
+<< /Type /Page
+/Parent 1 0 R
+/MediaBox [ 0 0 612 792 ]
+/Resources 3 0 R
+/Contents 5 0 R
+/Annots 7 0 R
+>>
+endobj
+7 0 obj
+[
+8 0 R
+10 0 R
+12 0 R
+14 0 R
+16 0 R
+18 0 R
+20 0 R
+22 0 R
+24 0 R
+25 0 R
+]
+endobj
+8 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 84.0 582.166 209.984 570.166 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A 9 0 R
+/H /I
+>>
+endobj
+10 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 84.0 563.966 218.324 551.966 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A 11 0 R
+/H /I
+>>
+endobj
+12 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 90.0 545.766 127.496 533.766 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A 13 0 R
+/H /I
+>>
+endobj
+14 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 90.0 527.566 174.176 515.566 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A 15 0 R
+/H /I
+>>
+endobj
+16 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 90.0 509.366 177.488 497.366 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A 17 0 R
+/H /I
+>>
+endobj
+18 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 90.0 491.166 163.148 479.166 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A 19 0 R
+/H /I
+>>
+endobj
+20 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 84.0 472.966 191.012 460.966 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A 21 0 R
+/H /I
+>>
+endobj
+22 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 84.0 454.766 171.332 442.766 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A 23 0 R
+/H /I
+>>
+endobj
+24 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 232.25 719.0 361.75 709.0 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (http://xmlgraphics.apache.org/fop/)
+/S /URI >>
+/H /I
+>>
+endobj
+25 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 221.685 707.75 372.315 697.75 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (http://xmlgraphics.apache.org/fop/)
+/S /URI >>
+/H /I
+>>
+endobj
+26 0 obj
+<< /Length 3223 /Filter [ /ASCII85Decode /FlateDecode ]
+ >>
+stream
+GatlSgMYb*p,ub+bY)/Jb"*e#lcUJhg6lYfB=^f\JAl]:TPZa@65D_q,a6"#6]p@[ZD4d@J6M-'4?&i^jgWiSk9'7CTdYr([qB]&F-]3Kr$>4#!LMmo8k9_'n"YBI9[Kj(2,7Ys^Ut9Sq-RU8^i,`]/9L81HTP4"k&7Gts$YH\ce`$$rHT0R,"_>VK$Okg'L#/pdNj_(S*9X6?[dmXZuGTJ/4sD$rp(h\s'$PHcMhhWp0)H,7YQ<>l...@jX>&50lgPW[uR!ifH6$-*[<8,]p)Kt=f/glpleFRP=Cqglh\%M*m?02:(X6SD*3kd!;KmfQP>(\jT/"gWhm8]r1RrVKgSE-,]I'Tt\!r^qhMW,JRmFWk;=55gWIic7+ka^]1k-f"nZfb'_N--e-Js6q]\F-1=Fk;hQ6o;_dkl^n+SGn&`.%U!S)h=!9T:SuX=<:C$M3pWW3N5jqUVnc4'[\4lS/,MBJgbc]G!sm%<-C93_GD:biKjL(<%[Q$,kI[WePuESn)6I9>CY$H^ZDj_-qA7GT.1r^.d_P
2Fnt:f.h=;A*ge&gCqD[Os3&d]eXk)U#gEYi#Ak1$@HUNj,FgEu@CrYm'eK@\b)<)V?_S6^WD"XGEhhmTY8:8AT.d?sIR]Bmdckb[e>"FC3bOf.*+b$j.`p%J]BcG[.C$:LHG8>IDcpB'>Eil;oWrFK'\#5%FM&\*(1d,Y?*g[qY^V?YmUFD7)Q9]:bM%ht5+c>TFAlod.MO5LSn?6Y*]ubhit1%k]3,Q_Y:X=d&5L+Qe7)FY3!$.f^?&QQFgL5UK%7P_eg4+A1"?[9G3cRtoZ/6+oV-o9&1L.,[6o'd9:CWTK\QEC(b>J'IreF%<GgnM7*6?DD4u<#Ub^c-!qjCnfQ:;V:@+Np7/0L$*P;(2Qa9SH43pTg/,1%][BGY`0cSuUWpUqQ"sei;JeV-A+Dtc$puCAK5QC`WpWo398;^95PGQr_5lAZGq9j(ETLmE!gnY&!M,L:t"X2B!ej12>3k1mDh;Z^D.1"uV%%K&rW3R)Wd+Qja+MM^XY[ec./e2^rKR"sW6qRY$)2rl@Zm@PW&jR/2b"8=k8p789P3L0FOi,UhQN$*?'(`ql3".Z[IAEs]Y?0(`DB<qR?ALZ#E4;n!]?iD>>so[.e"X>TGH;<0Z[%t[A"&YCIeecm!VX[\[noZKWocLrM,Y:>&666t%-SV$`Z9u:`L><XH.cZ<LfT=^mKPLTbIIcOq!4K]7*q;4L7'jE#$SA\fX#uK[?#i?S[E1%_m$.XWjP[69f6fE_^%pU\,8`D?0fruD&:F*\pr(`<q'U9=lWf(ofKX4K8-+UVYAL9%,rL0Uf2`>:4Af*J:X>8\A9%V-[9@"`Yeda8+Q<4q*`W',pJ^C1.gI,`gstS*[DCXo.N_3M?2?Y`UoY*BIFK!#m([$*uAqud=;?2L%b6d;,\@0Xe&:oBf(CG/;BJE>Pe$S+8.#]_?:e@>_Y]8_<NA`J2QY<4&/0Z\(;Xe6*.R$<__15`2K!H_$59Fgh3J;3_OR0*Xr
=b0B=?G?&Ldmg$2*ALj*Oc]!'[pcs#elD#V3q+&?=PfL@\N'Ia*L=*[@pi')0D";c&ZWLhRJoR2QbYi^Bf>'7AlZ+;0gLc&sq`3rRW\]$\qVNatXj;?Cj:boU(KmCC_AJ=2Fmn+$pa*cFTlbt.dVS5/j6Aj4PKS3!SqBY,Z/@8P/5#0U4Jsrg%B$s\Gl4Yk7XMG(`'<IN...@LftF.6qh2>b7eK<S3aM'OF4>])<'?DN`,2FF!i>f]Kd!Vj\s=\?OiKLK"ZNS,)6XfNJro:K_A:[2-qsR8DfjTR,,'JesAnP+rA\Z5mHcF]:SIS(>E6qMd)8!TbRgh9#cdEO:7Qk$G+,@KC8Vma;89HkU2<?;e_gcGmKi%3];,8dA>h+_FX3iB84WM<4jMFI1gS%JLE%4j$\l1Auh]X'CR\CAs.QL"bqJe:*Bp$g70F'VlFI3X4-E@#)2u<Q+=XdL]Y"^n&,V98A4L:6f
)hJG?b>2ekcbM_<8HEo`>p*cuP;$cb6WTmV?Z`K-C)j>N%$NW$k3$dh96edQc.2o)90j+!.KL)\:o?34DHWdh.MJ1;Ai(W-@9_:#+HGU\^0:J[Sa+-ZI/+QaW&RE&^KY8<h7=_J$3ZUZPN#T^4u=Pe-Vc"A@a]!.FNekg,S;7M1Q`rjJ?iqPRmL@WcU]*Qo/Z/Y%#?=SbRN7aU64\Yd.-qnnopF6FHY>'AOulOL1^&/+BTq,SK\X[2ps,JYGH~>
+endstream
+endobj
+27 0 obj
+<< /Type /Page
+/Parent 1 0 R
+/MediaBox [ 0 0 612 792 ]
+/Resources 3 0 R
+/Contents 26 0 R
+/Annots 28 0 R
+>>
+endobj
+28 0 obj
+[
+29 0 R
+30 0 R
+31 0 R
+32 0 R
+33 0 R
+34 0 R
+35 0 R
+]
+endobj
+29 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 363.22 641.466 472.876 629.466 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (../download.html)
+/S /URI >>
+/H /I
+>>
+endobj
+30 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 193.004 341.873 250.652 329.873 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (http://ant.apache.org/)
+/S /URI >>
+/H /I
+>>
+endobj
+31 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 72.0 258.72 129.648 246.72 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (http://ant.apache.org/)
+/S /URI >>
+/H /I
+>>
+endobj
+32 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 351.272 245.52 562.28 233.52 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (http://ant.apache.org/manual/)
+/S /URI >>
+/H /I
+>>
+endobj
+33 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 369.28 114.176 436.824 106.176 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (http://ant.apache.org/manual/)
+/S /URI >>
+/H /I
+>>
+endobj
+34 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 232.25 719.0 361.75 709.0 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (http://xmlgraphics.apache.org/fop/)
+/S /URI >>
+/H /I
+>>
+endobj
+35 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 221.685 707.75 372.315 697.75 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (http://xmlgraphics.apache.org/fop/)
+/S /URI >>
+/H /I
+>>
+endobj
+36 0 obj
+<< /Length 2518 /Filter [ /ASCII85Decode /FlateDecode ]
+ >>
+stream
+Gau0E968iG&AII3E,oYRPJ@=rp<?0...@jMeBT8i>.\7E[c9KVPQN9o[5l;+j["&U+?DXsD^^D!Q+oHHZU5>ViKp$RmcaHHu;\`@Q;3e?Ofpik>p5E82j83])gtG\3M372R@PaCrjRR2]=="4LbMcWTo=E5eF<@I,Mq'59+X=)+;1`R_UB6?@&d>s+h,p/pN?B-[Y0uYKc%/&/1gJtb[,\c\%a/as'&Q,)GHa4rZ[^(8NH1%\>DPVIdgF@$Q-@W0PO_JDga`B=he]E_'\fZ!fa(3!6JN'IegW.h@K'gb\17?KnW+RXKrh>(B[#(\mf8l<6Sm-/@/$mc5LRm%dC+)C*"92Qs)oj_>p_&.<L/qAM`+tfqgIs-l>USOBbR%169fJma!D>j,1aCr0]P--iuJ*gb6MZlJ>@j@WA,Q9BI1[:Trq.L2Ys"8&ure2D3>4]<l*BL-#XrXD+1lh9&f2P01$nHpf;"_3t:4+`5I1VYZBb0^DT2?)<g6<Ze7:WK"XEk+HX*&+R6>gn`:eKL^B!<a+cq4]nRWeA11c@njr-GEq?+L1a.o$r!"Ngc0MJ-p*5S\F%l3S4go=WADrAidcJ?)^iui*M>'J:I*7eW,'FN)*1YFm`#sf?dG^ct^QDB9;4(=U-Qr5H;bd`F#eNa"(dpRX])@tW)N#s[dY*:ID[R^9^2;ql!BgF+?cLE4feC8pUiLos!EI]1UY-^<`Gf'.Tp/OMWBiPEYt^mhleSL(6V;"sbsJM6jBBF:X=R@Kp_;_
:TG^)Y,;PtJar7<d8...@F>N$Q6Ya92P.189IrBAESb:G((f&,RYK0%?3^Kn\7PT`:"D=K!U#-O[?6cnk.d$FS:AM1sZ9''mS6/(@@YeOjW)9+//J^tI4jji:k!rE]`q84nXA6WN-i_c`hH33pF7+7S#'hcMGa'/<enbZ2MJ&K$a_Pn[g"")cSAC+`SKFFCg)A.I*.)^.h$?*^K\EFR>'Apq/HO(8G11D4jpn8XMiA.?cn?nA@m2_ne^6eI,)#][qY&jmWpLu^1uO*nH5@BAk=__-^A'/2DcXXel*`!8F9Tl]SChmUa)RS5^^>gW6ha:A)/FIh2G4K'b6]"q%`3,nGtgp*/J-LYBBP8@I4#Yp^aXG62jd.[)hcUZ"%0@O1qXN#B"`L$qGBFDh<=-b8g;Mc''oOP_[B\TMVD`p
3))!g&cqf_\M@bk>YArltiI;T$ArW;uPOEedZht\;,V6R1aXK]]Tf=H.1j5&_2`G;N@TBq=SKNa7rgiA+1HJfYo#'1/cII7;\Qr<OMrEa%$k(UZ<VoJ4kfSO&`MC%hZ^>m0+9emOZYS],,hr=f(B]HS:h0f1tq.BWt8Vb\!!pfuD2:%?FSZ-!JWta0R2,COk+]aJ/:uc*Q#'&Ep7:u+nf2G/Y5aR.T:2uIAElb'XT#d?W*CS2do2TGPUT68O]ed!%[C>d\W"."hP\.?JNFq^VB'1]_&!fm3OWIkLDpD[l2s9B'>7XD3=;'g4q^6UT[gAi.ijr/O\FJrs+)_RDOadp[&X4li&p&C#*(,KU'TjXJ=^-BYXbf!87-uA6YNtlq?Qo94p.B8bb)R`$<3&8']QC[fU]ZP#d8@#s6,o$ag-ZX!]G[AtZ6*I&Tk_ElILOern"2eYHf$:i\&l.nG$O\RqWgoT*oR`qmM=5C+cK82`W>^)TU8l3>?/<$X/h"<gF0c<DH7D,/juMh>cm,UWe]V!):M[j~>
+endstream
+endobj
+37 0 obj
+<< /Type /Page
+/Parent 1 0 R
+/MediaBox [ 0 0 612 792 ]
+/Resources 3 0 R
+/Contents 36 0 R
+/Annots 38 0 R
+>>
+endobj
+38 0 obj
+[
+39 0 R
+40 0 R
+41 0 R
+]
+endobj
+39 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 229.992 188.146 292.32 176.146 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (../gethelp.html)
+/S /URI >>
+/H /I
+>>
+endobj
+40 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 232.25 719.0 361.75 709.0 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (http://xmlgraphics.apache.org/fop/)
+/S /URI >>
+/H /I
+>>
+endobj
+41 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 221.685 707.75 372.315 697.75 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (http://xmlgraphics.apache.org/fop/)
+/S /URI >>
+/H /I
+>>
+endobj
+43 0 obj
+<<
+ /Title (\376\377\0\61\0\40\0\104\0\157\0\40\0\131\0\157\0\165\0\40\0\116\0\145\0\145\0\144\0\40\0\124\0\157\0\40\0\102\0\165\0\151\0\154\0\144\0\77)
+ /Parent 42 0 R
+ /Next 44 0 R
+ /A 9 0 R
+>> endobj
+44 0 obj
+<<
+ /Title (\376\377\0\62\0\40\0\123\0\145\0\164\0\40\0\125\0\160\0\40\0\131\0\157\0\165\0\162\0\40\0\105\0\156\0\166\0\151\0\162\0\157\0\156\0\155\0\145\0\156\0\164)
+ /Parent 42 0 R
+ /First 45 0 R
+ /Last 48 0 R
+ /Prev 43 0 R
+ /Next 49 0 R
+ /Count -4
+ /A 11 0 R
+>> endobj
+45 0 obj
+<<
+ /Title (\376\377\0\62\0\56\0\61\0\40\0\112\0\104\0\113)
+ /Parent 44 0 R
+ /Next 46 0 R
+ /A 13 0 R
+>> endobj
+46 0 obj
+<<
+ /Title (\376\377\0\62\0\56\0\62\0\40\0\103\0\114\0\101\0\123\0\123\0\120\0\101\0\124\0\110)
+ /Parent 44 0 R
+ /Prev 45 0 R
+ /Next 47 0 R
+ /A 15 0 R
+>> endobj
+47 0 obj
+<<
+ /Title (\376\377\0\62\0\56\0\63\0\40\0\112\0\101\0\126\0\101\0\137\0\110\0\117\0\115\0\105)
+ /Parent 44 0 R
+ /Prev 46 0 R
+ /Next 48 0 R
+ /A 17 0 R
+>> endobj
+48 0 obj
+<<
+ /Title (\376\377\0\62\0\56\0\64\0\40\0\101\0\160\0\141\0\143\0\150\0\145\0\40\0\101\0\156\0\164)
+ /Parent 44 0 R
+ /Prev 47 0 R
+ /A 19 0 R
+>> endobj
+49 0 obj
+<<
+ /Title (\376\377\0\63\0\40\0\122\0\165\0\156\0\40\0\164\0\150\0\145\0\40\0\102\0\165\0\151\0\154\0\144\0\40\0\123\0\143\0\162\0\151\0\160\0\164)
+ /Parent 42 0 R
+ /Prev 44 0 R
+ /Next 50 0 R
+ /A 21 0 R
+>> endobj
+50 0 obj
+<<
+ /Title (\376\377\0\64\0\40\0\124\0\162\0\157\0\165\0\142\0\154\0\145\0\163\0\150\0\157\0\157\0\164\0\151\0\156\0\147)
+ /Parent 42 0 R
+ /Prev 49 0 R
+ /A 23 0 R
+>> endobj
+51 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F1
+/BaseFont /Helvetica
+/Encoding /WinAnsiEncoding >>
+endobj
+52 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F5
+/BaseFont /Times-Roman
+/Encoding /WinAnsiEncoding >>
+endobj
+53 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F3
+/BaseFont /Helvetica-Bold
+/Encoding /WinAnsiEncoding >>
+endobj
+54 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F2
+/BaseFont /Helvetica-Oblique
+/Encoding /WinAnsiEncoding >>
+endobj
+55 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F9
+/BaseFont /Courier
+/Encoding /WinAnsiEncoding >>
+endobj
+56 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F7
+/BaseFont /Times-Bold
+/Encoding /WinAnsiEncoding >>
+endobj
+1 0 obj
+<< /Type /Pages
+/Count 3
+/Kids [6 0 R 27 0 R 37 0 R ] >>
+endobj
+2 0 obj
+<< /Type /Catalog
+/Pages 1 0 R
+ /Outlines 42 0 R
+ /PageMode /UseOutlines
+ >>
+endobj
+3 0 obj
+<<
+/Font << /F1 51 0 R /F5 52 0 R /F3 53 0 R /F2 54 0 R /F9 55 0 R /F7 56 0 R >>
+/ProcSet [ /PDF /ImageC /Text ] >>
+endobj
+9 0 obj
+<<
+/S /GoTo
+/D [27 0 R /XYZ 67.0 695.0 null]
+>>
+endobj
+11 0 obj
+<<
+/S /GoTo
+/D [27 0 R /XYZ 67.0 570.866 null]
+>>
+endobj
+13 0 obj
+<<
+/S /GoTo
+/D [27 0 R /XYZ 67.0 528.732 null]
+>>
+endobj
+15 0 obj
+<<
+/S /GoTo
+/D [27 0 R /XYZ 67.0 458.779 null]
+>>
+endobj
+17 0 obj
+<<
+/S /GoTo
+/D [27 0 R /XYZ 67.0 375.626 null]
+>>
+endobj
+19 0 obj
+<<
+/S /GoTo
+/D [27 0 R /XYZ 67.0 292.473 null]
+>>
+endobj
+21 0 obj
+<<
+/S /GoTo
+/D [27 0 R /XYZ 67.0 209.32 null]
+>>
+endobj
+23 0 obj
+<<
+/S /GoTo
+/D [37 0 R /XYZ 67.0 298.48 null]
+>>
+endobj
+42 0 obj
+<<
+ /First 43 0 R
+ /Last 50 0 R
+>> endobj
+xref
+0 57
+0000000000 65535 f
+0000012810 00000 n
+0000012882 00000 n
+0000012974 00000 n
+0000000015 00000 n
+0000000071 00000 n
+0000000902 00000 n
+0000001022 00000 n
+0000001110 00000 n
+0000013108 00000 n
+0000001244 00000 n
+0000013171 00000 n
+0000001380 00000 n
+0000013237 00000 n
+0000001516 00000 n
+0000013303 00000 n
+0000001652 00000 n
+0000013369 00000 n
+0000001788 00000 n
+0000013435 00000 n
+0000001924 00000 n
+0000013501 00000 n
+0000002060 00000 n
+0000013566 00000 n
+0000002196 00000 n
+0000002378 00000 n
+0000002564 00000 n
+0000005880 00000 n
+0000006003 00000 n
+0000006072 00000 n
+0000006241 00000 n
+0000006417 00000 n
+0000006588 00000 n
+0000006768 00000 n
+0000006950 00000 n
+0000007132 00000 n
+0000007318 00000 n
+0000009929 00000 n
+0000010052 00000 n
+0000010093 00000 n
+0000010261 00000 n
+0000010443 00000 n
+0000013631 00000 n
+0000010629 00000 n
+0000010841 00000 n
+0000011122 00000 n
+0000011242 00000 n
+0000011412 00000 n
+0000011582 00000 n
+0000011743 00000 n
+0000011966 00000 n
+0000012148 00000 n
+0000012256 00000 n
+0000012366 00000 n
+0000012479 00000 n
+0000012595 00000 n
+0000012701 00000 n
+trailer
+<<
+/Size 57
+/Root 2 0 R
+/Info 4 0 R
+>>
+startxref
+13682
+%%EOF
Added: xmlgraphics/site/deploy/fop/1.0/compiling.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/1.0/compiling.xml?rev=966110&view=auto
==============================================================================
--- xmlgraphics/site/deploy/fop/1.0/compiling.xml (added)
+++ xmlgraphics/site/deploy/fop/1.0/compiling.xml Wed Jul 21 07:08:39 2010
@@ -0,0 +1,137 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+--><!-- $Id$ --><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "document-v13.dtd">
+<document>
+ <header>
+ <title>Apache FOP: Building from Source Code</title>
+ <version>$Revision: 964711 $</version>
+ </header>
+ <body>
+ <section id="build-needed">
+ <title>Do You Need To Build?</title>
+ <p>
+ FOP distributions are either pre-compiled binary or source.
+ If you are using a binary distribution, it is already built and there is no need to build it again.
+ See the <link href="../download.html">Download Instructions</link> for information about whether a
+ binary or source distribution is best for your needs.
+ </p>
+ <p>
+ If you got the source code from a repository snapshot or via Subversion you will need to build FOP
+ in any case.
+ </p>
+ </section>
+ <section id="env">
+ <title>Set Up Your Environment</title>
+ <section id="env-jdk">
+ <title>JDK</title>
+ <p>
+ Building FOP requires a minimum Java Development Kit (JDK/SDK) of 1.4
+ (A Java Runtime Environment is not sufficient).
+ </p>
+ </section>
+ <section id="env-classpath">
+ <title>CLASSPATH</title>
+ <p>
+ There is generally no need to setup a classpath. All libraries needed to compile FOP are included
+ in the source distribution and are referenced by the build script.
+ You will only need to adjust the classpath if you build FOP in some other way. See the build
+ script build.xml for details.
+ </p>
+ </section>
+ <section id="env-java-home">
+ <title>JAVA_HOME</title>
+ <p>
+ The build script uses <link href="ext:ant">Apache Ant</link>, a popular
+ Java-based build tool, which usually requires that the environment variable JAVA_HOME point to
+ your local JDK root directory. This is true even if you use JDK 1.4 or above, which normally
+ does not need this setting.
+ </p>
+ </section>
+ <section id="env-ant">
+ <title>Apache Ant</title>
+ <p>
+ <link href="ext:ant">Apache Ant</link> (Version 1.7 or later) must be installed in order to
+ build FOP. Following best practices we don't include Ant with FOP anymore. You can find the
+ <link href="ext:ant/manual/">instructions to install Ant in the Ant manual</link> on the web.
+ </p>
+ </section>
+ </section>
+ <section id="build-script">
+ <title>Run the Build Script</title>
+ <p>
+ Change to the FOP root directory and build FOP by executing the build script (build.xml)
+ using the "ant" command.
+ </p>
+ <note>
+ The "ant" command is only available on your system if you've properly
+ <link href="ext:ant/manual/">installed Apache Ant</link> and added Ant's location to the PATH
+ environment variable.
+ </note>
+ <p>
+ The file build.xml in the FOP root directory is the blueprint that Ant uses for the build. It
+ contains information for numerous build targets, many of which are building blocks to more
+ useful target, and others which are primarily used by the FOP developers.
+ You may benefit from looking through this file to learn more about the various build targets.
+ To obtain a complete list of useful build targets:
+ </p>
+ <source xml:space="preserve"><![CDATA[ant -projecthelp]]></source>
+ <p>The most useful targets are:</p>
+ <ul>
+ <li>
+ <strong>package</strong>: Generates the JAR files (default). This is the normal build that
+ produces a jar file usable for running FOP.
+ </li>
+ <li>
+ <strong>clean </strong>: Cleans the build directory. This is useful for making sure that
+ any build errors are cleaned up before starting a new build. It should not ordinarily be
+ needed, but may be helpful if you are having problems with the build process itself.
+ </li>
+ <li>
+ <strong>javadocs</strong>: Creates the FOP API documentation.
+ <note>A minimum JDK version of 1.4.2 is required for generating the javadocs.</note>
+ </li>
+ </ul>
+ <p>To run the build:</p>
+ <source xml:space="preserve"><![CDATA[ant [target ...]]]></source>
+ <p>For example to do a normal build for the "all" target (which is the default):</p>
+ <source xml:space="preserve"><![CDATA[ant]]></source>
+ <p>OR</p>
+ <source xml:space="preserve"><![CDATA[ant all]]></source>
+ <p>To clean the build directory first:</p>
+ <source xml:space="preserve"><![CDATA[ant clean all]]></source>
+ <note>
+ If you want to shorten the build time you can just call the "package" target which
+ doesn't perform any automated tests during the build.
+ </note>
+ </section>
+ <section id="problems">
+ <title id="Troubleshooting">Troubleshooting</title>
+ <p>If you have problems building FOP, please try the following:</p>
+ <ul>
+ <li>Run the build with the target of "clean", then rerun the build.</li>
+ <li>Delete the build directory completely, then rerun the build.</li>
+ <li>
+ Make sure you do not have a non-FOP version of xerces.jar, xalan.jar, batik.jar,
+ or another dependency product somewhere in your CLASSPATH.
+ </li>
+ <li>
+ If the build still fails, see the <link href="../gethelp.html">Getting Help</link>
+ page for further help.
+ </li>
+ </ul>
+ </section>
+ </body>
+</document>
Propchange: xmlgraphics/site/deploy/fop/1.0/compiling.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: xmlgraphics/site/deploy/fop/1.0/compiling.xml
------------------------------------------------------------------------------
svn:keywords = Id
Added: xmlgraphics/site/deploy/fop/1.0/configuration.html
URL: http://svn.apache.org/viewvc/xmlgraphics/site/deploy/fop/1.0/configuration.html?rev=966110&view=auto
==============================================================================
--- xmlgraphics/site/deploy/fop/1.0/configuration.html (added)
+++ xmlgraphics/site/deploy/fop/1.0/configuration.html Wed Jul 21 07:08:39 2010
@@ -0,0 +1,785 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.8">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Apache FOP: Configuration</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |header
+ +-->
+<div class="header">
+<!--+
+ |start group logo
+ +-->
+<div class="grouplogo">
+<a href="http://xmlgraphics.apache.org/"><img class="logoImage" alt="Apache XML Graphics" src="../images/group-logo.gif" title="Apache XML Graphics is responsible for the creation and maintenance of software for managing the conversion of XML formats to graphical output, and the creation and maintenance of related software components, based on software licensed to the Foundation"></a>
+</div>
+<!--+
+ |end group logo
+ +-->
+<!--+
+ |start Project Logo
+ +-->
+<div class="projectlogo">
+<a href="http://xmlgraphics.apache.org/fop/"><img class="logoImage" alt="Apache FOP" src="../images/logo.jpg" title="Apache FOP (Formatting Objects Processor) is the world's first output independent formatter. Output formats currently supported include PDF, PCL, PS, SVG, XML (area tree representation), Print, AWT, MIF and TXT. The primary output target is PDF."></a>
+</div>
+<!--+
+ |end Project Logo
+ +-->
+<!--+
+ |start Search
+ +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="xmlgraphics.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">
+ <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+ |end search
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="unselected" href="../index.html">Home</a>
+</li>
+<li>
+<a class="unselected" href="../0.95/index.html">Version 0.95</a>
+</li>
+<li class="current">
+<a class="selected" href="../1.0/index.html">Version 1.0</a>
+</li>
+<li>
+<a class="unselected" href="../trunk/index.html">FOP Trunk</a>
+</li>
+<li>
+<a class="unselected" href="../dev/index.html">Development</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs"></div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache.org</a> > <a href="http://xml.apache.org/">XML Federation</a> > <a href="http://xmlgraphics.apache.org/">xmlgraphics.apache.org</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', '../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">FOP 1.0</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../1.0/index.html">About</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/releaseNotes_1.0.html">Release Notes</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/changes_1.0.html">Changes (1.0)</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/knownissues_overview.html">Known Issues</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/upgrading.html">Upgrading</a>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.1.6', '../skin/')" id="menu_selected_1.1.6Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Using FOP</div>
+<div id="menu_selected_1.1.6" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../1.0/compiling.html">Build</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Configure</div>
+</div>
+<div class="menuitem">
+<a href="../1.0/running.html">Run</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/embedding.html">Embed</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/servlets.html">Servlets</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/anttask.html">Ant Task</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.7', '../skin/')" id="menu_1.1.7Title" class="menutitle">Features</div>
+<div id="menu_1.1.7" class="menuitemgroup">
+<div class="menuitem">
+<a href="../1.0/output.html">Output Targets</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/intermediate.html">Intermediate Format</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/pdfencryption.html">PDF Encryption</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/pdfa.html">PDF/A</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/pdfx.html">PDF/X</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/graphics.html">Graphics</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/fonts.html">Fonts</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/hyphenation.html">Hyphenation</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/extensions.html">Extensions</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/events.html">Events</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/metadata.html">Metadata</a>
+</div>
+<div class="menuitem">
+<a href="../1.0/accessibility.html">Accessibility</a>
+</div>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+ |alternative credits
+ +-->
+<div id="credit2"></div>
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<div title="raw XML" class="xmllink">
+<a class="dida" href="configuration.xml"><img alt="XML - icon" src="../skin/images/xmldoc.gif" class="skin"><br>
+ XML</a>
+</div>
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="configuration.pdf"><img alt="PDF -icon" src="../skin/images/pdfdoc.gif" class="skin"><br>
+ PDF</a>
+</div>
+<div class="trail">Font size:
+ <input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">
+ <input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+ <input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
+</div>
+<h1>Apache FOP: Configuration</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#general">Configuration File Basics</a>
+<ul class="minitoc">
+<li>
+<a href="#general-available">Making Configuration Available to FOP</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#general-elements">Summary of the General Configuration Options</a>
+</li>
+<li>
+<a href="#image-loading">Image Loading Customization</a>
+</li>
+<li>
+<a href="#renderers">Renderer configuration</a>
+<ul class="minitoc">
+<li>
+<a href="#pdf-renderer">Special Settings for the PDF Renderer</a>
+</li>
+<li>
+<a href="#ps-renderer">Special Settings for the PostScript Renderer</a>
+</li>
+<li>
+<a href="#pcl-renderer">Special Settings for the PCL Renderer</a>
+</li>
+<li>
+<a href="#afp-renderer">Special Settings for the AFP Renderer</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#When+it+does+not+work">When it does not work</a>
+</li>
+</ul>
+</div>
+
+<a name="N10011"></a><a name="general"></a>
+<h2 class="underlined_10">Configuration File Basics</h2>
+<div class="section">
+<p>
+ The FOP configuration file is an XML file containing a variety of settings that are useful
+ for controlling FOP's behavior, and for helping it find resources that you wish it to use.
+ </p>
+<p>
+ The easiest way to get started using a FOP configuration file is to copy the sample found
+ at <span class="codefrag">{fop-dir}/conf/fop.xconf</span> to a location of your choice, and then to
+ edit it according to your needs.
+ It contains templates for the various configuration options, most of which are commented
+ out. Remove the comments and change the settings for entries that you wish to use.
+ Be sure to follow any instructions, including comments which specify the value range.
+ Also, since the configuration file is XML, be sure to keep it well-formed.
+ </p>
+<a name="N10020"></a><a name="general-available"></a>
+<h3 class="underlined_5">Making Configuration Available to FOP</h3>
+<p>After creating your configuration file, you must tell FOP how to find it:</p>
+<ul>
+
+<li>
+ If running FOP from the command-line, see the "-c" command-line option in
+ <a href="running.html">Running FOP</a>.
+ </li>
+
+<li>
+ If running FOP as an embedded application, see
+ <a href="embedding.html#config-external">Embedding, Using a Configuration File</a>.
+ </li>
+
+</ul>
+<p>
+ See <a href="embedding.html#config-internal">Setting the Configuration Programmatically</a>
+ for instructions on how to do so in an embedded environment.
+ </p>
+</div>
+
+<a name="N10043"></a><a name="general-elements"></a>
+<h2 class="underlined_10">Summary of the General Configuration Options</h2>
+<div class="section">
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+
+<tr>
+
+<th colspan="1" rowspan="1">Element</th>
+ <th colspan="1" rowspan="1">Data Type (for the value)</th>
+ <th colspan="1" rowspan="1">Description</th>
+ <th colspan="1" rowspan="1">Default Value</th>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">base</td>
+ <td colspan="1" rowspan="1">URL or directory</td>
+ <td colspan="1" rowspan="1">Specifies the base URL based on which relative URL will be resolved.</td>
+ <td colspan="1" rowspan="1">current directory</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">font-base</td>
+ <td colspan="1" rowspan="1">URL or directory</td>
+ <td colspan="1" rowspan="1">Specifies the base URL based on which relative font URLs will be resolved.
+ </td>
+ <td colspan="1" rowspan="1">base URL/directory (above)</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">hyphenation-base</td>
+ <td colspan="1" rowspan="1">URL or directory</td>
+ <td colspan="1" rowspan="1">Specifies the base URL based on which relative URLs to hyphenation pattern
+ files will be resolved. If not specified, support for user-supplied hyphenation
+ patterns remains disabled.
+ </td>
+ <td colspan="1" rowspan="1">disabled</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">source-resolution</td>
+ <td colspan="1" rowspan="1">Integer, dpi</td>
+ <td colspan="1" rowspan="1">
+ Resolution in dpi (dots per inch) which is used internally to determine the pixel
+ size for SVG images and bitmap images without resolution information.
+ </td>
+ <td colspan="1" rowspan="1">72 dpi</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">target-resolution</td>
+ <td colspan="1" rowspan="1">Integer, dpi</td>
+ <td colspan="1" rowspan="1">
+ Resolution in dpi (dots per inch) used to specify the output resolution for bitmap
+ images generated by bitmap renderers (such as the TIFF renderer) and by bitmaps
+ generated by Apache Batik for filter effects and such.
+ </td>
+ <td colspan="1" rowspan="1">72 dpi</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">strict-configuration</td>
+ <td colspan="1" rowspan="1">Boolean (true, false)</td>
+ <td colspan="1" rowspan="1">
+ Setting this option to 'true' will cause FOP to strictly verify the contents of the
+ FOP configuration file to ensure that defined resources (such as fonts and base
+ URLs/directories) are valid and available to FOP. Any errors found will cause FOP to
+ immediately raise an exception.</td>
+ <td colspan="1" rowspan="1">false</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">strict-validation</td>
+ <td colspan="1" rowspan="1">Boolean (true, false)</td>
+ <td colspan="1" rowspan="1">
+ Setting this option to 'false' causes FOP to be more forgiving about XSL-FO validity,
+ for example, you're allowed to specify a border on a region-body which is supported
+ by some FO implementations but is non-standard. Note that such a border would
+ currently have no effect in Apache FOP.</td>
+ <td colspan="1" rowspan="1">true</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">break-indent-inheritance</td>
+ <td colspan="1" rowspan="1">Boolean (true, false)</td>
+ <td colspan="1" rowspan="1">
+ Setting this option to 'true' causes FOP to use an alternative rule set to determine
+ text indents specified through margins, start-indent and end-indent. Many commercial
+ FO implementations have chosen to break the XSL specification in this aspect. This
+ option tries to mimic their behaviour. Please note that Apache FOP may still not
+ behave exactly like those implementations either because FOP has not fully matched
+ the desired behaviour and because the behaviour among the commercial implementations
+ varies. The default for this option (i.e. false) is to behave exactly like the
+ specification describes.</td>
+ <td colspan="1" rowspan="1">false</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">default-page-settings</td>
+ <td colspan="1" rowspan="1">n/a</td>
+ <td colspan="1" rowspan="1">
+ Specifies the default width and height of a page if "auto" is specified
+ for either or both values. Use "height" and "width" attributes on the
+ default-page-settings element to specify the two values.</td>
+ <td colspan="1" rowspan="1">"height" 11 inches, "width" 8.26 inches</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">prefer-renderer</td>
+ <td colspan="1" rowspan="1">boolean (true, false)</td>
+ <td colspan="1" rowspan="1">
+ By default, FOP prefers the newer output implementations based on the
+ <span class="codefrag">IFDocumentHandler</span> interface. If no such implementation can be found for
+ a given MIME type, it looks for an implementation of the <span class="codefrag">Renderer</span> interface.
+ If necessary, you can invert the lookup order to prefer the Renderer variant over the
+ IFDocumentHandler variant by setting this value to true.
+ </td>
+ <td colspan="1" rowspan="1">false</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">use-cache</td>
+ <td colspan="1" rowspan="1">boolean (true, false)</td>
+ <td colspan="1" rowspan="1">All fonts information that has been gathered as a result of "directory"
+ or "auto-detect" font configurations will be cached for future rendering runs.
+ This setting should improve performance on systems where
+ fonts have been configured using the "directory" or "auto-detect" tag mechanisms.
+ By default this option is switched on.</td>
+ <td colspan="1" rowspan="1">true</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">cache-file</td>
+ <td colspan="1" rowspan="1">String</td>
+ <td colspan="1" rowspan="1">This options specifies the file/directory path of the fop cache file.
+ This option can also be specified on the command-line using the -cache option.
+ This file is currently only used to cache font triplet information for future reference.</td>
+ <td colspan="1" rowspan="1">${base}/conf/fop.cache</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">renderers</td>
+ <td colspan="1" rowspan="1">(see text below)</td>
+ <td colspan="1" rowspan="1">Contains the configuration for each renderer. See below.</td>
+ <td colspan="1" rowspan="1">N/A</td>
+
+</tr>
+
+</table>
+<p>
+ This is an excerpt from the example configuration file coming with FOP:
+ </p>
+<pre class="code">
+<fop version="1.0">
+
+ <!-- Strict user configuration -->
+ <strict-configuration>true</strict-configuration>
+
+ <!-- Strict FO validation -->
+ <strict-validation>true</strict-validation>
+
+ <!-- Base URL for resolving relative URLs -->
+ <base>./</base>
+
+ <!-- Font Base URL for resolving relative font URLs -->
+ <font-base>./</font-base>
+
+ <!-- Source resolution in dpi (dots/pixels per inch) for determining the size of pixels in SVG and bitmap images, default: 72dpi -->
+ <source-resolution>72</source-resolution>
+ <!-- Target resolution in dpi (dots/pixels per inch) for specifying the target resolution for generated bitmaps, default: 72dpi -->
+ <target-resolution>72</target-resolution>
+
+ <!-- default page-height and page-width, in case
+ value is specified as auto -->
+ <default-page-settings height="11in" width="8.26in"/>
+
+ <!-- etc. etc..... -->
+</fop></pre>
+</div>
+
+<a name="N1019C"></a><a name="image-loading"></a>
+<h2 class="underlined_10">Image Loading Customization</h2>
+<div class="section">
+<p>
+ Apache FOP uses the image loading framework from
+ <a href="http://xmlgraphics.apache.org/commons/">Apache XML Graphics Commons</a> to load
+ images using various plug-ins. Every image loader plug-in has a hard-coded usage penalty
+ that influences which solution is chosen if there are multiple possibilities to load an image.
+ Sometimes, though, these penalties need to be tweaked and this can be done in the FOP
+ configuration. An example:
+ </p>
+<pre class="code"><fop version="1.0">
+ [..]
+ <image-loading>
+ <penalty value="10000"
+ class="org.apache.xmlgraphics.image.loader.impl.ImageLoaderRawCCITTFax"/>
+ <penalty value="INFINITE"
+ class="org.apache.xmlgraphics.image.loader.impl.ImageLoaderInternalTIFF"/>
+ </image-loading>
+ <renderers....
+</fop></pre>
+<p>
+ The first penalty element increases the penalty for the raw CCITT loader. This practically
+ forces the decoding of CCITT compressed TIFF images except if there are no TIFF codecs
+ available.
+ </p>
+<p>
+ The second penalty element sets an "infinite" penalty for the TIFF loader using the internal
+ TIFF codec. This practically disables that plug-in as it will never be chosen as a possible
+ solution.
+ </p>
+<p>
+ Negative penalties are possible to promote a plug-in but a negative penalty sum will be
+ treated as zero penalty in most cases. For more details on the image loading framework,
+ please consult the documentation there.
+ </p>
+</div>
+
+<a name="N101B7"></a><a name="renderers"></a>
+<h2 class="underlined_10">Renderer configuration</h2>
+<div class="section">
+<p>
+ Each Renderer has its own configuration section which is identified by the
+ MIME type the Renderer is written for, ex. "application/pdf" for the PDF Renderer.
+ </p>
+<p>
+ The configuration for the PDF Renderer could look like this:
+ </p>
+<pre class="code">
+ <renderers>
+ <renderer mime="application/pdf">
+ <filterList>
+ <!-- provides compression using zlib flate (default is on) -->
+ <value>flate</value>
+ </filterList>
+ <fonts>
+ <font metrics-url="arial.xml" kerning="yes" embed-url="arial.ttf">
+ <font-triplet name="Arial" style="normal" weight="normal"/>
+ <font-triplet name="ArialMT" style="normal" weight="normal"/>
+ </font>
+ <font metrics-url="arialb.xml" kerning="yes" embed-url="arialb.ttf">
+ <font-triplet name="Arial" style="normal" weight="bold"/>
+ <font-triplet name="ArialMT" style="normal" weight="bold"/>
+ </font>
+ </fonts>
+ </renderer>
+
+ <renderer mime="application/postscript">
+ <!-- etc. etc..... --></pre>
+<p>
+ The details on the font configuration can be found on the separate <a href="fonts.html">Fonts</a> page.
+ Note especially the section entitled <a href="fonts.html#register">Register Fonts with FOP</a>.
+ </p>
+<a name="N101D2"></a><a name="pdf-renderer"></a>
+<h3 class="underlined_5">Special Settings for the PDF Renderer</h3>
+<p>
+ The configuration element for the PDF renderer contains two elements. One is for the font configuration
+ (please follow the link above) and one is for the "filter list". The filter list controls how the
+ individual objects in a PDF file are encoded. By default, all objects get "flate" encoded (i.e. simply
+ compressed with the same algorithm that is also used in ZIP files). Most users don't need to change that
+ setting. For debugging purposes, it may be desired not to compress the internal objects at all so the
+ generated PDF commands can be read. In that case, you can simply use the following filter list. The
+ second filter list (type="image") ensures that all images still get compressed but also ASCII-85 encoded
+ so the produced PDF file is still easily readable in a text editor.
+ </p>
+<pre class="code">
+ <renderer mime="application/pdf">
+ <filterList>
+ <value>null</value>
+ </filterList>
+ <filterList type="image">
+ <value>flate</value>
+ <value>ascii-85</value>
+ </filterList>
+
+ <fonts....
+ </renderer></pre>
+<p>
+ Another (optional) setting specific to the PDF Renderer is an output color profile, an ICC
+ color profile which indicates the target color space the PDF file is generated for. This
+ setting is mainly used in conjunction with the <a href="pdfx.html">PDF/X</a> feature.
+ An example:
+ </p>
+<pre class="code">
+ <renderer mime="application/pdf">
+ <filterList...
+
+ <output-profile>C:\FOP\Color\EuropeISOCoatedFOGRA27.icc</output-profile>
+
+ <fonts....
+ </renderer></pre>
+<p>
+ Some people don't have high requirements on color fidelity but instead want the smallest
+ PDF file sizes possible. In this case it's possible to disable the default sRGB color space
+ which XSL-FO requires. This will cause RGB colors to be generated as device-specific RGB.
+ Please note that this option is unavailable (and will cause an error) if you enable
+ PDF/A or PDF/X functionality or if you specify an output profile. This setting will make the
+ PDF about 4KB smaller. To disable the sRGB color space add the following setting:
+ </p>
+<pre class="code">
+ <renderer mime="application/pdf">
+ <filterList...
+
+ <disable-srgb-colorspace>true</disable-srgb-colorspace>
+
+ <fonts....
+ </renderer></pre>
+<p>FOP supports encryption of PDF output, thanks to Patrick C. Lankswert.
+ This feature is commonly used to prevent unauthorized viewing, printing, editing, copying text
+ from the document and doing annotations. It is also possible to ask the user for a password in
+ order to view the contents. Note that there already exist third party applications which can
+ decrypt an encrypted PDF without effort and allow the aforementioned operations, therefore the
+ degree of protection is limited. For further information about features and restrictions
+ regarding PDF encryption, look at the documentation coming with Adobe Acrobat or the technical
+ documentation on the Adobe web site.</p>
+<pre class="code">
+ <renderer mime="application/pdf">
+ <encryption-params>
+ <user-password>testuserpass</user-password>
+ <owner-password>testownerpass</owner-password>
+ <noprint/>
+ <nocopy/>
+ <noedit/>
+ <noannotations/>
+ </encryption-params>
+ </renderer></pre>
+<a name="N101F9"></a><a name="ps-renderer"></a>
+<h3 class="underlined_5">Special Settings for the PostScript Renderer</h3>
+<p>
+ Besides the normal font configuration (the same "fonts" element as for the PDF renderer) the PostScript
+ renderer has an additional setting to force landscape pages to be rotated to fit on a page inserted into
+ the printer in portrait mode. Set the value to "true" to activate this feature. The default is "false".
+ Example:
+ </p>
+<pre class="code">
+ <renderer mime="application/postscript">
+ <auto-rotate-landscape>true</auto-rotate-landscape>
+
+ <fonts>
+ <font metrics-url="arial.xml" kerning="yes" embed-url="arial.ttf">
+ <font-triplet name="Arial" style="normal" weight="normal"/>
+ <font-triplet name="ArialMT" style="normal" weight="normal"/>
+ </font>
+ <font metrics-url="arialb.xml" kerning="yes" embed-url="arialb.ttf">
+ <font-triplet name="Arial" style="normal" weight="bold"/>
+ <font-triplet name="ArialMT" style="normal" weight="bold"/>
+ </font>
+ </fonts>
+ </renderer></pre>
+<a name="N10207"></a><a name="pcl-renderer"></a>
+<h3 class="underlined_5">Special Settings for the PCL Renderer</h3>
+<p>
+ Non-standard fonts for the PCL renderer are made available through the Java2D subsystem which means that
+ you don't have to do any custom font configuration in this case but you have to use the font names
+ offered by Java.
+ </p>
+<p>
+ Additionally, there are certain settings that control how the renderer handles various elements.
+ </p>
+<pre class="code"><renderer mime="application/vnd.hp-PCL">
+ <rendering>quality</rendering>
+ <text-rendering>bitmap</text-rendering>
+</renderer></pre>
+<p>
+ The default value for the "rendering" setting is "speed" which causes borders
+ to be painted as plain rectangles. In this mode, no special borders (dotted,
+ dashed etc.) are available. If you want support for all border modes, set the
+ value to "quality" as indicated above. This will cause the borders to be painted
+ as bitmaps.
+ </p>
+<p>
+ The default value for the "text-rendering" setting is "auto" which paints the
+ base fonts using PCL fonts. Non-base fonts are painted as bitmaps through Java2D.
+ If the mix of painting methods results in unwelcome output, you can set this
+ to "bitmap" which causes all text to be rendered as bitmaps.
+ </p>
+<a name="N1021E"></a><a name="afp-renderer"></a>
+<h3 class="underlined_5">Special Settings for the AFP Renderer</h3>
+<p>
+
+</p>
+<p>
+ Additionally, there are certain settings that control how the renderer handles various elements.
+ </p>
+<pre class="code"><renderer mime="application/x-afp">
+ <images mode="b+w" bits-per-pixel="8" native="true"/>
+ <renderer-resolution>240</renderer-resolution>
+
+ <!-- a default external resource group file -->
+ <resource-group-file>resources.afp</resource-group-file>
+</renderer></pre>
+<p>
+ The default value for the images "mode" setting is "b+w" (black and white). When the images "mode" setting is "b+w" a "bits-per-pixel" setting can be provided to aid the grayscale conversion process. With this setting all images referenced in your source document are converted to an IOCA FS45 grayscale bitmap image form.
+ When the setting is "color" all images are converted to an IOCA FS45 color bitmap image form. When "native" setting is "true", all images encountered (TIFF, GIF, JPEG and Encapsulated Postscript etc.) will be embedded directly in the datastream in their native form using a MO:DCA Object Container.
+ </p>
+<p>
+ The default value for the "renderer-resolution" is 240 dpi.
+ </p>
+<p>
+ By default if there is no configuration definition for "resource-group-file", external resources will be placed in a file called resources.afp.
+ </p>
+</div>
+
+
+<a name="N1023B"></a><a name="When+it+does+not+work"></a>
+<h2 class="underlined_10">When it does not work</h2>
+<div class="section">
+<p>FOP searches the configuration file for the information it
+expects, at the position it expects. When that information is not
+present, FOP will not complain, it will just continue. When there is
+other information in the file, FOP will not complain, it will just
+ignore it. That means that when your configuration information is in
+the file but in a different XML element, or in a different XML path,
+than FOP expects, it will be silently ignored.</p>
+<p>Check the following possibilities:</p>
+<ul>
+
+<li>The format of the configuration file has changed
+considerably between FOP 0.20.5 and FOP 1.0 and its beta versions. Did
+you convert your file to the new format?</li>
+
+
+<li>The FOP distribution contains a schema for configuration
+files, at src/foschema/fop-configuration.xsd. Did you validate your
+configuration file against it? Add the following schema location to
+the <span class="codefrag">schema</span> element:
+
+<pre class="code"><fop
+xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+xsi:noNamespaceSchemaLocation=
+"http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/foschema/fop-configuration.xsd?view=co">
+</pre>
+
+and run the configuration file through a validating schema
+parser. Note that the schema cannot detect all errors, and that it is
+stricter about the order of some elements than FOP itself is.</li>
+
+
+<li>Run FOP in debug mode (command line option
+<span class="codefrag">-d</span>). This makes FOP report which configuration
+information it finds. Check if FOP finds what you expect.</li>
+
+
+</ul>
+</div>
+
+<span class="version">
+ version 964711</span>
+</div>
+<!--+
+ |end content
+ +-->
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<!--+
+ |start bottomstrip
+ +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright ©
+ 1999-2009 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Propchange: xmlgraphics/site/deploy/fop/1.0/configuration.html
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: xmlgraphics/site/deploy/fop/1.0/configuration.html
------------------------------------------------------------------------------
svn:keywords = Id
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: commits-help@xmlgraphics.apache.org