xmlgraphics-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r1008691 [14/16] - in /websites/staging/xmlgraphics/trunk/content: ./ fop/2.2/ fop/2.2/images/
Date Mon, 20 Mar 2017 14:58:10 GMT
Added: websites/staging/xmlgraphics/trunk/content/fop/2.2/running.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/fop/2.2/running.html (added)
+++ websites/staging/xmlgraphics/trunk/content/fop/2.2/running.html Mon Mar 20 14:58:09 2017
@@ -0,0 +1,675 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <title>Running Apache&amp;trade; FOP</title>
+
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+<!--
+    <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+-->
+    <link rel="stylesheet" type="text/css" media="screen" href="//www.apache.org/css/code.css">
+    <link href="/css/profile.css" rel="stylesheet" type="text/css" />
+    <link href="/css/xmlgraphics.css" rel="stylesheet" type="text/css" />
+    <link href="/css/print.css" rel="stylesheet" type="text/css" media="print" />
+
+    <script src="//code.jquery.com/jquery.min.js"></script>
+	<script type="text/javascript" src="/js/jquery.stoc.js"></script>
+    <script>
+    $(document).ready(function(){
+        $('ul#navigation a').each(function() {
+		    if (this.href === window.location.href)
+			    { $(this). attr('id', 'forefront');} 
+        });
+        $('ul#navigation a#forefront').each(function() {
+        	
+        });
+    })
+	$(function(){
+		$("#items").stoc({ search: "#content", stocTitle: "<h3>Page Contents</h3>" });
+	});
+    </script>
+
+    
+
+    
+    
+	<style>
+	.highlight {color: red;}
+	</style>
+
+  </head>
+
+  <body>
+
+	<div id="banner">&nbsp;
+	</div>
+
+	<div id="navigation">
+	<style type="text/css">
+/* The following code is added by mdx_elementid.py
+   It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+  visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p><a href="/"><img alt="Apache XML Graphics Project Logo" src="/images/apache-xml-graphics.gif" title="Apache XML Graphics Project" /></a></p>
+<h1 id="apache-fop">Apache&trade; FOP<a class="headerlink" href="#apache-fop" title="Permanent link">&para;</a></h1>
+<ul>
+<li><a href="/fop/">FOP Home</a></li>
+<li><a href="/fop/download.html">Download</a></li>
+<li><a href="/fop/quickstartguide.html">Quick Start Guide</a></li>
+<li><a href="/fop/compliance.html">Compliance</a></li>
+<li><a href="/fop/gethelp.html">Getting Help</a></li>
+<li><a href="/fop/faq.html">FAQs</a></li>
+<li><a href="/fop/maillist.html">Mailing Lists</a></li>
+<li><a href="/fop/license.html">License</a></li>
+<li>
+<h2 id="resources">Resources<a class="headerlink" href="#resources" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/fo.html">XSL-FO</a></li>
+<li><a href="/fop/examples.html">Examples</a></li>
+<li><a href="/fop/bugs.html">Bugs</a></li>
+<li><a href="http://wiki.apache.org/xmlgraphics-fop/FrontPage">Wiki</a></li>
+<li><a href="/fop/resources.html">Other</a></li>
+</ul>
+</li>
+<li>
+<h2 id="project">Project<a class="headerlink" href="#project" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/news.html">News</a></li>
+<li><a href="/fop/team.html">Who We Are</a></li>
+<li><a href="/fop/status.html">Status</a></li>
+<li><a href="/fop/knownissues.html">Known Issues</a></li>
+<li><a href="/fop/changes.html">Changes</a></li>
+</ul>
+</li>
+<li>
+<h2 id="versions">Versions<a class="headerlink" href="#versions" title="Permanent link">&para;</a></h2>
+<ul>
+<li>
+<h2 id="fop-trunk-dev">FOP Trunk (dev)<a class="headerlink" href="#fop-trunk-dev" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/trunk/">Overview</a></li>
+<li><a href="/fop/trunk/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop">Using Apache&trade; FOP<a class="headerlink" href="#using-apache-fop" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="/fop/trunk/compiling.html">Build</a></li>
+<li><a href="/fop/trunk/configuration.html">Configure</a></li>
+<li><a href="/fop/trunk/running.html">Run</a></li>
+<li><a href="/fop/trunk/embedding.html">Embed</a></li>
+<li><a href="/fop/trunk/servlets.html">Servlets</a></li>
+<li><a href="/fop/trunk/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features">Features<a class="headerlink" href="#features" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="/fop/trunk/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/trunk/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/trunk/events.html">Events</a></li>
+<li><a href="/fop/trunk/extensions.html">Extensions</a></li>
+<li><a href="/fop/trunk/fonts.html">Fonts</a></li>
+<li><a href="/fop/trunk/graphics.html">Graphics</a></li>
+<li><a href="/fop/trunk/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/trunk/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/trunk/metadata.html">Metadata</a></li>
+<li><a href="/fop/trunk/output.html">Output Targets</a></li>
+<li><a href="/fop/trunk/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/trunk/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/trunk/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/fop-pdf-images.html">PDF Images</a></li>
+<li><a href="/fop/trunk/whitespacemanagement.html">Whitespace Management</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="fop-21">FOP 2.1<a class="headerlink" href="#fop-21" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/2.1/">FOP 2.1 Overview</a></li>
+<li><a href="/fop/2.1/releaseNotes_2.1.html">Release Notes</a></li>
+<li><a href="/fop/2.1/changes_2.1.html">Changes (2.1)</a></li>
+<li><a href="/fop/2.1/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/2.1/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-21">Using Apache FOP 2.1<a class="headerlink" href="#using-apache-fop-21" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="/fop/2.1/compiling.html">Build</a></li>
+<li><a href="/fop/2.1/configuration.html">Configure</a></li>
+<li><a href="/fop/2.1/running.html">Run</a></li>
+<li><a href="/fop/2.1/embedding.html">Embed</a></li>
+<li><a href="/fop/2.1/servlets.html">Servlets</a></li>
+<li><a href="/fop/2.1/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_1">Features<a class="headerlink" href="#features_1" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="/fop/2.1/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/2.1/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/2.1/events.html">Events</a></li>
+<li><a href="/fop/2.1/extensions.html">Extensions</a></li>
+<li><a href="/fop/2.1/fonts.html">Fonts</a></li>
+<li><a href="/fop/2.1/graphics.html">Graphics</a></li>
+<li><a href="/fop/2.1/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/2.1/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/2.1/metadata.html">Metadata</a></li>
+<li><a href="/fop/2.1/output.html">Output Targets</a></li>
+<li><a href="/fop/2.1/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/2.1/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/2.1/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/fop-pdf-images.html">PDF Images</a></li>
+<li><a href="/fop/2.1/whitespacemanagement.html">Whitespace Management</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="fop-20">FOP 2.0<a class="headerlink" href="#fop-20" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/2.0/">FOP 2.0 Overview</a></li>
+<li><a href="/fop/2.0/releaseNotes_2.0.html">Release Notes</a></li>
+<li><a href="/fop/2.0/changes_2.0.html">Changes (2.0)</a></li>
+<li><a href="/fop/2.0/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/2.0/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-20">Using Apache FOP 2.0<a class="headerlink" href="#using-apache-fop-20" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="/fop/2.0/compiling.html">Build</a></li>
+<li><a href="/fop/2.0/configuration.html">Configure</a></li>
+<li><a href="/fop/2.0/running.html">Run</a></li>
+<li><a href="/fop/2.0/embedding.html">Embed</a></li>
+<li><a href="/fop/2.0/servlets.html">Servlets</a></li>
+<li><a href="/fop/2.0/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_2">Features<a class="headerlink" href="#features_2" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="/fop/2.0/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/2.0/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/2.0/events.html">Events</a></li>
+<li><a href="/fop/2.0/extensions.html">Extensions</a></li>
+<li><a href="/fop/2.0/fonts.html">Fonts</a></li>
+<li><a href="/fop/2.0/graphics.html">Graphics</a></li>
+<li><a href="/fop/2.0/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/2.0/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/2.0/metadata.html">Metadata</a></li>
+<li><a href="/fop/2.0/output.html">Output Targets</a></li>
+<li><a href="/fop/2.0/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/2.0/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/2.0/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/fop-pdf-images.html">PDF Images</a></li>
+<li><a href="/fop/2.0/whitespacemanagement.html">Whitespace Management</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="fop-11">FOP 1.1<a class="headerlink" href="#fop-11" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/1.1/">FOP 1.1 Overview</a></li>
+<li><a href="/fop/1.1/releaseNotes_1.1.html">Release Notes</a></li>
+<li><a href="/fop/1.1/changes_1.1.html">Changes (1.1)</a></li>
+<li><a href="/fop/1.1/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/1.1/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-11">Using Apache FOP 1.1<a class="headerlink" href="#using-apache-fop-11" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="/fop/1.1/compiling.html">Build</a></li>
+<li><a href="/fop/1.1/configuration.html">Configure</a></li>
+<li><a href="/fop/1.1/running.html">Run</a></li>
+<li><a href="/fop/1.1/embedding.html">Embed</a></li>
+<li><a href="/fop/1.1/servlets.html">Servlets</a></li>
+<li><a href="/fop/1.1/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_3">Features<a class="headerlink" href="#features_3" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="/fop/1.1/accessibility.html">Accessibility</a></li>
+<li><a href="/fop/1.1/complexscripts.html">Complex Scripts</a></li>
+<li><a href="/fop/1.1/events.html">Events</a></li>
+<li><a href="/fop/1.1/extensions.html">Extensions</a></li>
+<li><a href="/fop/1.1/fonts.html">Fonts</a></li>
+<li><a href="/fop/1.1/graphics.html">Graphics</a></li>
+<li><a href="/fop/1.1/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/1.1/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/1.1/metadata.html">Metadata</a></li>
+<li><a href="/fop/1.1/output.html">Output Targets</a></li>
+<li><a href="/fop/1.1/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/1.1/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/1.1/pdfencryption.html">PDF Encryption</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="fop-10">FOP 1.0<a class="headerlink" href="#fop-10" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/1.0/">FOP 1.0 Overview</a></li>
+<li><a href="/fop/1.0/releaseNotes_1.0.html">Release Notes</a></li>
+<li><a href="/fop/1.0/changes_1.0.html">Changes (1.0)</a></li>
+<li><a href="/fop/1.0/knownissues_overview.html">Known Issues</a></li>
+<li><a href="/fop/1.0/upgrading.html">Upgrading</a></li>
+<li>
+<h3 id="using-apache-fop-10">Using Apache FOP 1.0<a class="headerlink" href="#using-apache-fop-10" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="/fop/1.0/compiling.html">Build</a></li>
+<li><a href="/fop/1.0/configuration.html">Configure</a></li>
+<li><a href="/fop/1.0/running.html">Run</a></li>
+<li><a href="/fop/1.0/embedding.html">Embed</a></li>
+<li><a href="/fop/1.0/servlets.html">Servlets</a></li>
+<li><a href="/fop/1.0/anttask.html">Ant Task</a></li>
+</ul>
+</li>
+<li>
+<h3 id="features_4">Features<a class="headerlink" href="#features_4" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="/fop/1.0/output.html">Output Targets</a></li>
+<li><a href="/fop/1.0/intermediate.html">Intermediate Format</a></li>
+<li><a href="/fop/1.0/pdfencryption.html">PDF Encryption</a></li>
+<li><a href="/fop/1.0/pdfa.html">PDF/A</a></li>
+<li><a href="/fop/1.0/pdfx.html">PDF/X</a></li>
+<li><a href="/fop/1.0/graphics.html">Graphics</a></li>
+<li><a href="/fop/1.0/fonts.html">Fonts</a></li>
+<li><a href="/fop/1.0/hyphenation.html">Hyphenation</a></li>
+<li><a href="/fop/1.0/extensions.html">Extensions</a></li>
+<li><a href="/fop/1.0/events.html">Events</a></li>
+<li><a href="/fop/1.0/metadata.html">Metadata</a></li>
+<li><a href="/fop/1.0/accessibility.html">Accessibility</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<h2 id="fop-development">FOP Development<a class="headerlink" href="#fop-development" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/dev/">General Info</a></li>
+<li>
+<h2 id="design">Design<a class="headerlink" href="#design" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/dev/design/">Design Info</a></li>
+</ul>
+</li>
+<li>
+<h2 id="core-process">Core Process<a class="headerlink" href="#core-process" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/dev/design/startup.html">Startup</a></li>
+<li><a href="/fop/dev/design/parsing.html">XML Parsing</a></li>
+<li><a href="/fop/dev/design/fotree.html">FO Tree</a></li>
+<li><a href="/fop/dev/design/properties.html">Properties</a></li>
+<li><a href="/fop/dev/design/layout.html">Layout</a></li>
+<li><a href="/fop/dev/design/breakpos.html">Break Possibility</a></li>
+<li><a href="/fop/dev/design/areas.html">Area Tree</a></li>
+<li><a href="/fop/dev/design/renderers.html">Renderers</a></li>
+</ul>
+</li>
+<li>
+<h2 id="miscellaneous">Miscellaneous<a class="headerlink" href="#miscellaneous" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/dev/design/images.html">Images</a></li>
+<li><a href="/fop/dev/design/pdf-library.html">PDF Library</a></li>
+<li><a href="/fop/dev/design/svg.html">SVG</a></li>
+<li><a href="/fop/dev/design/embedding.html">Embedding</a></li>
+<li><a href="/fop/dev/design/extending.html">Extending</a></li>
+<li><a href="/fop/dev/design/optimise.html">Optimisations</a></li>
+<li><a href="/fop/dev/design/useragent.html">User Agent</a></li>
+</ul>
+</li>
+<li><a href="http://wiki.apache.org/xmlgraphics-fop/FOPProjectPages">Unresolved (Wiki)</a></li>
+<li><a href="/fop/dev/svg.html">SVG</a></li>
+<li><a href="/fop/dev/extensions.html">Extensions</a></li>
+<li>
+<h2 id="develop">Develop<a class="headerlink" href="#develop" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/dev/implement.html">Walk-Thru</a></li>
+<li><a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20FOP%20AND%20description%20~%20%22\%22[patch]\%22%22%20AND%20status%20in%20%28Open%2C%20%22In%20Progress%22%2C%20Reopened%29">Patch Queue</a></li>
+<li><a href="/fop/dev/conventions.html">Conventions</a></li>
+</ul>
+</li>
+<li>
+<h2 id="test">Test<a class="headerlink" href="#test" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/dev/testing.html">Testing</a></li>
+</ul>
+</li>
+<li>
+<h2 id="deploy">Deploy<a class="headerlink" href="#deploy" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/dev/doc.html">Doc Mgmt</a></li>
+<li><a href="/fop/dev/release.html">Release</a></li>
+<li><a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20FOP%20AND%20issuetype%20%3D%20Bug%20AND%20status%20in%20%28Open%2C%20%22In%20Progress%22%2C%20Reopened%29">Bugs</a></li>
+</ul>
+</li>
+<li>
+<h2 id="resources_1">Resources<a class="headerlink" href="#resources_1" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/dev/faq.html">FAQs</a></li>
+<li><a href="/fop/dev/tools.html">Tools</a></li>
+<li><a href="http://svn.apache.org/viewvc/xmlgraphics/fop">ViewVC</a></li>
+</ul>
+</li>
+<li>
+<h2 id="subpackages">SubPackages<a class="headerlink" href="#subpackages" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/fop/dev/rtflib.html">RTFlib</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+<h1 id="apache-xml-graphics">Apache&trade; XML Graphics<a class="headerlink" href="#apache-xml-graphics" title="Permanent link">&para;</a></h1>
+<ul>
+<li>
+<h2 id="project-overview">Project Overview<a class="headerlink" href="#project-overview" title="Permanent link">&para;</a></h2>
+<ul>
+<li><a href="/team.html">Who We Are</a></li>
+<li><a href="/legal.html">Legal Stuff</a></li>
+<li><a href="/charter.html">Project Charter</a></li>
+<li><a href="/mail.html">Mailing Lists</a></li>
+<li><a href="/repo.html">Code Repositories</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html">ASF Sponsorship Program</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">ASF Thanks</a></li>
+<li><a href="http://www.apache.org/licenses/">Licenses</a></li>
+<li><a href="/security.html">Apache XML Graphics Security</a></li>
+<li><a href="http://www.apache.org/security/">ASF Security</a></li>
+</ul>
+</li>
+</ul>
+<h1 id="sub-projects">Sub Projects<a class="headerlink" href="#sub-projects" title="Permanent link">&para;</a></h1>
+<ul>
+<li><a href="/batik/">Apache Batik</a></li>
+<li><a href="/commons/">Apache XML Graphics Commons</a></li>
+</ul>
+<h3 id="search-apache-xml-graphics">Search Apache XML Graphics<a class="headerlink" href="#search-apache-xml-graphics" title="Permanent link">&para;</a></h3>
+<form name="search" id="search" action="https://www.google.com/search" method="get">
+  <input value="xmlgraphics.apache.org" name="sitesearch" type="hidden"/>
+  <input type="text" name="q" id="query" />
+  <input type="submit" id="submit" value="Search" />
+</form>
+
+<h3 id="apachecon-n-america">ApacheCon N. America<a class="headerlink" href="#apachecon-n-america" title="Permanent link">&para;</a></h3>
+<p><a href="http://na.apachecon.com/"><img alt="ApacheCon North America" src="https://farm8.staticflickr.com/7566/15408186664_d08f3881c9_t.jpg" title="ApacheCon North America" /></a></p>
+<ul>
+<li><strong><a href="http://na.apachecon.com/">ApacheCon NA</a></strong></li>
+</ul>
+<p>Hope to see you there!</p>
+<h3 id="apachecon-europe">ApacheCon Europe<a class="headerlink" href="#apachecon-europe" title="Permanent link">&para;</a></h3>
+<!--
+<a href="http://apachecon.eu/" title="ApacheCon Europe"><img alt="ApacheCon Europe" src="http://www.apache.org/ads/ApacheCon/2014-eu-234x60.png" width="225" /></a>
+-->
+
+<ul>
+<li><strong><a href="http://apachecon.eu/">ApacheCon Europe</a></strong></li>
+</ul>
+<p>Hope to see you there!</p>
+<p><a title="Apache Software Foundation Logo" href="http://www.apache.org"><img id="asf_logo_url" alt="Apache Software Foundation " src="/images/asf_logo_url.png" width="200" /></a></p>
+<script>
+$(document).ready(function () {
+    $('#navigation :header').click(function () {
+        var text = $(this).siblings('ul');
+        if (text.is(':hidden')) {
+            text.slideDown('200');
+        } else {
+            text.slideUp('200');
+        }
+    });
+    if ($('#navigation :header').siblings('ul')) {
+      $('#navigation :header').not('#search-apache-xml-graphics, #apachewzxhzdk3-xml-graphics, #sub-projects').append(' &raquo;');
+    }
+  $('#navigation > ul > li > ul > li ul').hide();
+  $('#project-overview').next().hide();
+  $('#versions').next().show();
+  var str=location.href.toLowerCase();
+  $("#navigation li a").each(function() {
+    if (str.indexOf(this.href.toLowerCase()) > -1) {
+      $(this).parents().slideDown('200');
+      $("li.highlight").removeClass("highlight");
+      $(this).parent().addClass("highlight");
+    }
+  });
+})
+</script>
+	</div>
+
+	<div id="bannertext" style="border-bottom: 2px dashed #666666; height: 70px;">
+	  <a href="/fop/"><img src="/images/apache-fop-logo.jpg" alt="The Apache FOP Project" width="120" height="65" style="float:left; margin-right: 15px;" /></a>
+	  <h2>The Apache&trade; FOP Project</h2>
+	</div><!-- <h1>Running Apache&amp;trade; FOP</h1> -->
+
+
+      
+      <div id="content" class="grid_16">
+        <div id="items">
+        </div>
+      	<!-- <div id="breadcrumb"><a href="/">Home</a>&nbsp;&raquo&nbsp;<a href="/fop/">Fop</a>&nbsp;&raquo&nbsp;<a href="/fop/2.2/">2.2</a></div> -->
+      	<div class="section-content"><style type="text/css">
+/* The following code is added by mdx_elementid.py
+   It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+  visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="running-apache-fop">Running Apache&trade; FOP<a class="headerlink" href="#running-apache-fop" title="Permanent link">&para;</a></h1>
+<h2 id="require">System Requirements<a class="headerlink" href="#require" title="Permanent link">&para;</a></h2>
+<p>The following software must be installed:</p>
+<ul>
+<li>
+<p>Java 1.6 or later Runtime Environment.</p>
+</li>
+<li>
+<p>Apache&trade; FOP. The <a href="../download.html">FOP distribution</a> includes all libraries that you will need to run a basic FOP installation. These can be found in the [fop-root]/lib directory. These libraries include the following:</p>
+<ul>
+<li>
+<p><a href="http://xmlgraphics.apache.org/commons/">Apache XML Graphics Commons</a>, an shared library for Batik and FOP.</p>
+</li>
+<li>
+<p><a href="http://xmlgraphics.apache.org/batik/">Apache Batik</a>, an SVG library.</p>
+</li>
+<li>
+<p><a href="http://commons.apache.org/logging/">Apache Commons Logging</a>, a logger abstraction kit.</p>
+</li>
+<li>
+<p><a href="http://commons.apache.org/io/">Apache Commons IO</a>, a library with I/O utilities.</p>
+</li>
+<li>
+<p><a href="http://excalibur.apache.org/framework/">Apache Excalibur/Avalon Framework</a>, for XML configuration handling.</p>
+</li>
+</ul>
+</li>
+</ul>
+<p>The following software is optional, depending on your needs:</p>
+<ul>
+<li>
+<p>Graphics libraries. Generally, FOP contains direct support for the most important bitmap image formats (including PNG, JPEG and GIF). See <a href="graphics.html">FOP: Graphics Formats</a> for details.</p>
+</li>
+<li>
+<p>PDF encryption. See <a href="pdfencryption.html">FOP: PDF Encryption</a> for details.</p>
+</li>
+</ul>
+<p>In addition, the following system requirements apply:</p>
+<ul>
+<li>If you will be using FOP to process SVG, you must do so in a graphical environment. See <a href="graphics.html#batik">FOP: Graphics (Batik)</a> for details.</li>
+</ul>
+<h2 id="install">Installation<a class="headerlink" href="#install" title="Permanent link">&para;</a></h2>
+<h3 id="install-instruct">Instructions<a class="headerlink" href="#install-instruct" title="Permanent link">&para;</a></h3>
+<p>Basic FOP installation consists of first unzipping the <code>.gz</code> file that is the distribution medium, then unarchiving the resulting <code>.tar</code> file in a directory/folder that is convenient on your system. Please consult your operating system documentation or Zip application software documentation for instructions specific to your site.</p>
+<h3 id="install-problems">Problems<a class="headerlink" href="#install-problems" title="Permanent link">&para;</a></h3>
+<p>Some Mac OSX users have experienced filename truncation problems using Stuffit to unzip and unarchive their distribution media. This is a legacy of older Mac operating systems, which had a 31-character pathname limit. Several Mac OSX users have recommended that Mac OSX users use the shell command <code>tar -xzf</code> instead.</p>
+<h2 id="standalone-start">Starting FOP as a Standalone Application<a class="headerlink" href="#standalone-start" title="Permanent link">&para;</a></h2>
+<h3 id="fop-script">Using the fop script or batch file<a class="headerlink" href="#fop-script" title="Permanent link">&para;</a></h3>
+<p>The usual and recommended practice for starting FOP from the command line is to run the batch file fop.bat (Windows) or the shell script fop (Unix/Linux). These scripts require that the environment variable JAVA_HOME be set to a path pointing to the appropriate Java installation on your system. Macintosh OSX includes a Java environment as part of its distribution. We are told by Mac OSX users that the path to use in this case is <code>/Library/Java/Home</code>. <strong>Caveat:</strong> We suspect that, as Apple releases new Java environments and as FOP upgrades the minimum Java requirements, the two will inevitably not match on some systems. Please see <a href="https://java.com/en/download/faq/java_mac.xml">Java on Mac OSX FAQ</a> for information as it becomes available.</p>
+<div class="codehilite"><pre><span class="n">USAGE</span>
+<span class="n">Fop</span> <span class="p">[</span><span class="n">options</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">fo</span><span class="o">|-</span><span class="n">xml</span><span class="p">]</span> <span class="n">infile</span> <span class="p">[</span><span class="o">-</span><span class="n">xsl</span> <span class="n">file</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">awt</span><span class="o">|-</span><span class="n">pdf</span><span class="o">|-</span><span class="n">mif</span><span class="o">|-</span><span class="n">rtf</span><span class="o">|-</span><span class="n">tiff</span><span class="o">|-</span><span class="n">png</span><span class="o">|-</span><span class="n">pcl</span><span class="o">|-</span><span class="n">ps</span><span class="o">|-</span><span class="n">txt</span><span class="o">|-</span><span class="n">at</span> <span class="p">[</span><span class="n">mime</span><
 span class="p">]</span><span class="o">|-</span><span class="n">print</span><span class="p">]</span> <span class="o">&lt;</span><span class="n">outfile</span><span class="o">&gt;</span>
+ <span class="p">[</span><span class="n">OPTIONS</span><span class="p">]</span>
+  <span class="o">-</span><span class="n">version</span>          <span class="n">print</span> <span class="n">FOP</span> <span class="n">version</span> <span class="n">and</span> <span class="n">exit</span>
+  <span class="o">-</span><span class="n">d</span>                <span class="n">debug</span> <span class="n">mode</span>
+  <span class="o">-</span><span class="n">x</span>                <span class="n">dump</span> <span class="n">configuration</span> <span class="n">settings</span>
+  <span class="o">-</span><span class="n">q</span>                <span class="n">quiet</span> <span class="n">mode</span>
+  <span class="o">-</span><span class="n">c</span> <span class="n">cfg</span><span class="p">.</span><span class="n">xml</span>        <span class="n">use</span> <span class="n">additional</span> <span class="n">configuration</span> <span class="n">file</span> <span class="n">cfg</span><span class="p">.</span><span class="n">xml</span>
+  <span class="o">-</span><span class="n">l</span> <span class="n">lang</span>           <span class="n">the</span> <span class="n">language</span> <span class="n">to</span> <span class="n">use</span> <span class="k">for</span> <span class="n">user</span> <span class="n">information</span>
+  <span class="o">-</span><span class="n">nocs</span>             <span class="n">disable</span> <span class="nb">complex</span> <span class="n">script</span> <span class="n">features</span>
+  <span class="o">-</span><span class="n">r</span>                <span class="n">relaxed</span><span class="o">/</span><span class="n">less</span> <span class="n">strict</span> <span class="n">validation</span> <span class="p">(</span><span class="n">where</span> <span class="n">available</span><span class="p">)</span>
+  <span class="o">-</span><span class="n">dpi</span> <span class="n">xxx</span>          <span class="n">target</span> <span class="n">resolution</span> <span class="n">in</span> <span class="n">dots</span> <span class="n">per</span> <span class="n">inch</span> <span class="p">(</span><span class="n">dpi</span><span class="p">)</span> <span class="n">where</span> <span class="n">xxx</span> <span class="n">is</span> <span class="n">a</span> <span class="n">number</span>
+  <span class="o">-</span><span class="n">s</span>                <span class="k">for</span> <span class="n">area</span> <span class="n">tree</span> <span class="n">XML</span><span class="p">,</span> <span class="n">down</span> <span class="n">to</span> <span class="n">block</span> <span class="n">areas</span> <span class="n">only</span>
+  <span class="o">-</span><span class="n">v</span>                <span class="n">run</span> <span class="n">in</span> <span class="n">verbose</span> <span class="n">mode</span> <span class="p">(</span><span class="n">currently</span> <span class="n">simply</span> <span class="n">print</span> <span class="n">FOP</span> <span class="n">version</span> <span class="n">and</span> <span class="k">continue</span><span class="p">)</span>
+
+  <span class="o">-</span><span class="n">o</span> <span class="p">[</span><span class="n">password</span><span class="p">]</span>     <span class="n">PDF</span> <span class="n">file</span> <span class="n">will</span> <span class="n">be</span> <span class="n">encrypted</span> <span class="n">with</span> <span class="n">option</span> <span class="n">owner</span> <span class="n">password</span>
+  <span class="o">-</span><span class="n">u</span> <span class="p">[</span><span class="n">password</span><span class="p">]</span>     <span class="n">PDF</span> <span class="n">file</span> <span class="n">will</span> <span class="n">be</span> <span class="n">encrypted</span> <span class="n">with</span> <span class="n">option</span> <span class="n">user</span> <span class="n">password</span>
+  <span class="o">-</span><span class="n">noprint</span>          <span class="n">PDF</span> <span class="n">file</span> <span class="n">will</span> <span class="n">be</span> <span class="n">encrypted</span> <span class="n">without</span> <span class="n">printing</span> <span class="n">permission</span>
+  <span class="o">-</span><span class="n">nocopy</span>           <span class="n">PDF</span> <span class="n">file</span> <span class="n">will</span> <span class="n">be</span> <span class="n">encrypted</span> <span class="n">without</span> <span class="n">copy</span> <span class="n">content</span> <span class="n">permission</span>
+  <span class="o">-</span><span class="n">noedit</span>           <span class="n">PDF</span> <span class="n">file</span> <span class="n">will</span> <span class="n">be</span> <span class="n">encrypted</span> <span class="n">without</span> <span class="n">edit</span> <span class="n">content</span> <span class="n">permission</span>
+  <span class="o">-</span><span class="n">noannotations</span>    <span class="n">PDF</span> <span class="n">file</span> <span class="n">will</span> <span class="n">be</span> <span class="n">encrypted</span> <span class="n">without</span> <span class="n">edit</span> <span class="n">annotation</span> <span class="n">permission</span>
+  <span class="o">-</span><span class="n">nofillinforms</span>    <span class="n">PDF</span> <span class="n">file</span> <span class="n">will</span> <span class="n">be</span> <span class="n">encrypted</span> <span class="n">without</span> <span class="n">fill</span> <span class="n">in</span> <span class="n">forms</span> <span class="n">permission</span>
+  <span class="o">-</span><span class="n">noaccesscontent</span>  <span class="n">PDF</span> <span class="n">file</span> <span class="n">will</span> <span class="n">be</span> <span class="n">encrypted</span> <span class="n">without</span> <span class="n">extract</span> <span class="n">text</span> <span class="n">and</span> <span class="n">graphics</span> <span class="n">permission</span>
+  <span class="o">-</span><span class="n">noassembledoc</span>    <span class="n">PDF</span> <span class="n">file</span> <span class="n">will</span> <span class="n">be</span> <span class="n">encrypted</span> <span class="n">without</span> <span class="n">assemble</span> <span class="n">the</span> <span class="n">document</span> <span class="n">permission</span>
+  <span class="o">-</span><span class="n">noprinthq</span>        <span class="n">PDF</span> <span class="n">file</span> <span class="n">will</span> <span class="n">be</span> <span class="n">encrypted</span> <span class="n">without</span> <span class="n">print</span> <span class="n">high</span> <span class="n">quality</span> <span class="n">permission</span>
+  <span class="o">-</span><span class="n">a</span>                <span class="n">enables</span> <span class="n">accessibility</span> <span class="n">features</span> <span class="p">(</span><span class="n">Tagged</span> <span class="n">PDF</span> <span class="n">etc</span><span class="p">.,</span> <span class="n">default</span> <span class="n">off</span><span class="p">)</span>
+  <span class="o">-</span><span class="n">pdfprofile</span> <span class="n">prof</span>  <span class="n">PDF</span> <span class="n">file</span> <span class="n">will</span> <span class="n">be</span> <span class="n">generated</span> <span class="n">with</span> <span class="n">the</span> <span class="n">specified</span> <span class="n">profile</span>
+                    <span class="p">(</span><span class="n">Examples</span> <span class="k">for</span> <span class="n">prof</span><span class="p">:</span> <span class="n">PDF</span><span class="o">/</span><span class="n">A</span><span class="o">-</span>1<span class="n">b</span> <span class="n">or</span> <span class="n">PDF</span><span class="o">/</span><span class="n">X</span><span class="o">-</span>3<span class="p">:</span>2003<span class="p">)</span>
+
+  <span class="o">-</span><span class="n">conserve</span>         <span class="n">enable</span> <span class="n">memory</span><span class="o">-</span><span class="n">conservation</span> <span class="n">policy</span> <span class="p">(</span><span class="n">trades</span> <span class="n">memory</span><span class="o">-</span><span class="n">consumption</span> <span class="k">for</span> <span class="n">disk</span> <span class="n">I</span><span class="o">/</span><span class="n">O</span><span class="p">)</span>
+                    <span class="p">(</span><span class="n">Note</span><span class="p">:</span> <span class="n">currently</span> <span class="n">only</span> <span class="n">influences</span> <span class="n">whether</span> <span class="n">the</span> <span class="n">area</span> <span class="n">tree</span> <span class="n">is</span> <span class="n">serialized</span><span class="p">.)</span>
+
+  <span class="o">-</span><span class="n">cache</span>            <span class="n">specifies</span> <span class="n">a</span> <span class="n">file</span><span class="o">/</span><span class="n">directory</span> <span class="n">path</span> <span class="n">location</span>
+  <span class="o">-</span><span class="n">flush</span>            <span class="n">flushes</span> <span class="n">the</span> <span class="n">current</span> <span class="n">font</span> <span class="n">cache</span> <span class="n">file</span>
+
+ <span class="p">[</span><span class="n">INPUT</span><span class="p">]</span>
+  <span class="n">infile</span>            <span class="n">xsl</span><span class="p">:</span><span class="n">fo</span> <span class="n">input</span> <span class="n">file</span> <span class="p">(</span><span class="n">the</span> <span class="n">same</span> <span class="n">as</span> <span class="n">the</span> <span class="n">next</span><span class="p">)</span>
+                    <span class="p">(</span><span class="n">use</span> <span class="s">&#39;-&#39;</span> <span class="k">for</span> <span class="n">infile</span> <span class="n">to</span> <span class="n">pipe</span> <span class="n">input</span> <span class="n">from</span> <span class="n">stdin</span><span class="p">)</span>
+  <span class="o">-</span><span class="n">fo</span>  <span class="n">infile</span>       <span class="n">xsl</span><span class="p">:</span><span class="n">fo</span> <span class="n">input</span> <span class="n">file</span>
+  <span class="o">-</span><span class="n">xml</span> <span class="n">infile</span>       <span class="n">xml</span> <span class="n">input</span> <span class="n">file</span><span class="p">,</span> <span class="n">must</span> <span class="n">be</span> <span class="n">used</span> <span class="n">together</span> <span class="n">with</span> <span class="o">-</span><span class="n">xsl</span>
+  <span class="o">-</span><span class="n">atin</span> <span class="n">infile</span>      <span class="n">area</span> <span class="n">tree</span> <span class="n">input</span> <span class="n">file</span>
+  <span class="o">-</span><span class="n">ifin</span> <span class="n">infile</span>      <span class="n">intermediate</span> <span class="n">format</span> <span class="n">input</span> <span class="n">file</span>
+  <span class="o">-</span><span class="n">imagein</span> <span class="n">infile</span>   <span class="n">image</span> <span class="n">input</span> <span class="n">file</span> <span class="p">(</span><span class="n">piping</span> <span class="n">through</span> <span class="n">stdin</span> <span class="n">not</span> <span class="n">supported</span><span class="p">)</span>
+  <span class="o">-</span><span class="n">xsl</span> <span class="n">stylesheet</span>   <span class="n">xslt</span> <span class="n">stylesheet</span>
+
+  <span class="o">-</span><span class="n">param</span> <span class="n">name</span> <span class="n">value</span> <span class="o">&lt;</span><span class="n">value</span><span class="o">&gt;</span> <span class="n">to</span> <span class="n">use</span> <span class="k">for</span> <span class="n">parameter</span> <span class="o">&lt;</span><span class="n">name</span><span class="o">&gt;</span> <span class="n">in</span> <span class="n">xslt</span> <span class="n">stylesheet</span>
+                    <span class="p">(</span><span class="n">repeat</span> <span class="s">&#39;-param name value&#39;</span> <span class="k">for</span> <span class="n">each</span> <span class="n">parameter</span><span class="p">)</span>
+
+  <span class="o">-</span><span class="n">catalog</span>          <span class="n">use</span> <span class="n">catalog</span> <span class="n">resolver</span> <span class="k">for</span> <span class="n">input</span> <span class="n">XML</span> <span class="n">and</span> <span class="n">XSLT</span> <span class="n">files</span>
+ <span class="p">[</span><span class="n">OUTPUT</span><span class="p">]</span>
+  <span class="n">outfile</span>           <span class="n">input</span> <span class="n">will</span> <span class="n">be</span> <span class="n">rendered</span> <span class="n">as</span> <span class="n">PDF</span> <span class="n">into</span> <span class="n">outfile</span>
+                    <span class="p">(</span><span class="n">use</span> <span class="s">&#39;-&#39;</span> <span class="k">for</span> <span class="n">outfile</span> <span class="n">to</span> <span class="n">pipe</span> <span class="n">output</span> <span class="n">to</span> <span class="n">stdout</span><span class="p">)</span>
+  <span class="o">-</span><span class="n">pdf</span> <span class="n">outfile</span>      <span class="n">input</span> <span class="n">will</span> <span class="n">be</span> <span class="n">rendered</span> <span class="n">as</span> <span class="n">PDF</span> <span class="p">(</span><span class="n">outfile</span> <span class="n">req</span><span class="o">&#39;</span><span class="n">d</span><span class="p">)</span>
+  <span class="o">-</span><span class="n">pdfa1b</span> <span class="n">outfile</span>   <span class="n">input</span> <span class="n">will</span> <span class="n">be</span> <span class="n">rendered</span> <span class="n">as</span> <span class="n">PDF</span><span class="o">/</span><span class="n">A</span><span class="o">-</span>1<span class="n">b</span> <span class="n">compliant</span> <span class="n">PDF</span>
+                    <span class="p">(</span><span class="n">outfile</span> <span class="n">req</span><span class="o">&#39;</span><span class="n">d</span><span class="p">,</span> <span class="n">same</span> <span class="n">as</span> &quot;<span class="o">-</span><span class="n">pdf</span> <span class="n">outfile</span> <span class="o">-</span><span class="n">pdfprofile</span> <span class="n">PDF</span><span class="o">/</span><span class="n">A</span><span class="o">-</span>1<span class="n">b</span>&quot;<span class="p">)</span>
+  <span class="o">-</span><span class="n">awt</span>              <span class="n">input</span> <span class="n">will</span> <span class="n">be</span> <span class="n">displayed</span> <span class="n">on</span> <span class="n">screen</span>
+  <span class="o">-</span><span class="n">rtf</span> <span class="n">outfile</span>      <span class="n">input</span> <span class="n">will</span> <span class="n">be</span> <span class="n">rendered</span> <span class="n">as</span> <span class="n">RTF</span> <span class="p">(</span><span class="n">outfile</span> <span class="n">req</span><span class="o">&#39;</span><span class="n">d</span><span class="p">)</span>
+  <span class="o">-</span><span class="n">pcl</span> <span class="n">outfile</span>      <span class="n">input</span> <span class="n">will</span> <span class="n">be</span> <span class="n">rendered</span> <span class="n">as</span> <span class="n">PCL</span> <span class="p">(</span><span class="n">outfile</span> <span class="n">req</span><span class="o">&#39;</span><span class="n">d</span><span class="p">)</span>
+  <span class="o">-</span><span class="n">ps</span> <span class="n">outfile</span>       <span class="n">input</span> <span class="n">will</span> <span class="n">be</span> <span class="n">rendered</span> <span class="n">as</span> <span class="n">PostScript</span> <span class="p">(</span><span class="n">outfile</span> <span class="n">req</span><span class="o">&#39;</span><span class="n">d</span><span class="p">)</span>
+  <span class="o">-</span><span class="n">afp</span> <span class="n">outfile</span>      <span class="n">input</span> <span class="n">will</span> <span class="n">be</span> <span class="n">rendered</span> <span class="n">as</span> <span class="n">AFP</span> <span class="p">(</span><span class="n">outfile</span> <span class="n">req</span><span class="o">&#39;</span><span class="n">d</span><span class="p">)</span>
+  <span class="o">-</span><span class="n">tiff</span> <span class="n">outfile</span>     <span class="n">input</span> <span class="n">will</span> <span class="n">be</span> <span class="n">rendered</span> <span class="n">as</span> <span class="n">TIFF</span> <span class="p">(</span><span class="n">outfile</span> <span class="n">req</span><span class="o">&#39;</span><span class="n">d</span><span class="p">)</span>
+  <span class="o">-</span><span class="n">png</span> <span class="n">outfile</span>      <span class="n">input</span> <span class="n">will</span> <span class="n">be</span> <span class="n">rendered</span> <span class="n">as</span> <span class="n">PNG</span> <span class="p">(</span><span class="n">outfile</span> <span class="n">req</span><span class="o">&#39;</span><span class="n">d</span><span class="p">)</span>
+  <span class="o">-</span><span class="n">txt</span> <span class="n">outfile</span>      <span class="n">input</span> <span class="n">will</span> <span class="n">be</span> <span class="n">rendered</span> <span class="n">as</span> <span class="n">plain</span> <span class="n">text</span> <span class="p">(</span><span class="n">outfile</span> <span class="n">req</span><span class="o">&#39;</span><span class="n">d</span><span class="p">)</span>
+  <span class="o">-</span><span class="n">at</span> <span class="p">[</span><span class="n">mime</span><span class="p">]</span> <span class="n">out</span>    <span class="n">representation</span> <span class="n">of</span> <span class="n">area</span> <span class="n">tree</span> <span class="n">as</span> <span class="n">XML</span> <span class="p">(</span><span class="n">outfile</span> <span class="n">req</span><span class="o">&#39;</span><span class="n">d</span><span class="p">)</span>
+                    <span class="n">specify</span> <span class="n">optional</span> <span class="n">mime</span> <span class="n">output</span> <span class="n">to</span> <span class="n">allow</span> <span class="n">the</span> <span class="n">AT</span> <span class="n">to</span> <span class="n">be</span> <span class="n">converted</span>
+                    <span class="n">to</span> <span class="n">final</span> <span class="n">format</span> <span class="n">later</span>
+  <span class="o">-</span><span class="k">if</span> <span class="p">[</span><span class="n">mime</span><span class="p">]</span> <span class="n">out</span>    <span class="n">representation</span> <span class="n">of</span> <span class="n">document</span> <span class="n">in</span> <span class="n">intermediate</span> <span class="n">format</span> <span class="n">XML</span> <span class="p">(</span><span class="n">outfile</span> <span class="n">req</span><span class="o">&#39;</span><span class="n">d</span><span class="p">)</span>
+                    <span class="n">specify</span> <span class="n">optional</span> <span class="n">mime</span> <span class="n">output</span> <span class="n">to</span> <span class="n">allow</span> <span class="n">the</span> <span class="n">IF</span> <span class="n">to</span> <span class="n">be</span> <span class="n">converted</span>
+                    <span class="n">to</span> <span class="n">final</span> <span class="n">format</span> <span class="n">later</span>
+  <span class="o">-</span><span class="n">print</span>            <span class="n">input</span> <span class="n">file</span> <span class="n">will</span> <span class="n">be</span> <span class="n">rendered</span> <span class="n">and</span> <span class="n">sent</span> <span class="n">to</span> <span class="n">the</span> <span class="n">printer</span>
+                    <span class="n">see</span> <span class="n">options</span> <span class="n">with</span> &quot;<span class="o">-</span><span class="n">print</span> <span class="n">help</span>&quot;
+  <span class="o">-</span><span class="n">out</span> <span class="n">mime</span> <span class="n">outfile</span> <span class="n">input</span> <span class="n">will</span> <span class="n">be</span> <span class="n">rendered</span> <span class="n">using</span> <span class="n">the</span> <span class="n">given</span> <span class="n">MIME</span> <span class="n">type</span>
+                    <span class="p">(</span><span class="n">outfile</span> <span class="n">req</span><span class="o">&#39;</span><span class="n">d</span><span class="p">)</span> <span class="n">Example</span><span class="p">:</span> &quot;<span class="o">-</span><span class="n">out</span> <span class="n">application</span><span class="o">/</span><span class="n">pdf</span> <span class="n">D</span><span class="p">:</span><span class="o">\</span><span class="n">out</span><span class="p">.</span><span class="n">pdf</span>&quot;
+                    <span class="p">(</span><span class="n">Tip</span><span class="p">:</span> &quot;<span class="o">-</span><span class="n">out</span> <span class="n">list</span>&quot; <span class="n">prints</span> <span class="n">the</span> <span class="n">list</span> <span class="n">of</span> <span class="n">supported</span> <span class="n">MIME</span> <span class="n">types</span><span class="p">)</span>
+  <span class="o">-</span><span class="n">svg</span> <span class="n">outfile</span>      <span class="n">input</span> <span class="n">will</span> <span class="n">be</span> <span class="n">rendered</span> <span class="n">as</span> <span class="n">an</span> <span class="n">SVG</span> <span class="n">slides</span> <span class="n">file</span> <span class="p">(</span><span class="n">outfile</span> <span class="n">req</span><span class="o">&#39;</span><span class="n">d</span><span class="p">)</span>
+                    <span class="n">Experimental</span> <span class="n">feature</span> <span class="o">-</span> <span class="n">requires</span> <span class="n">additional</span> <span class="n">fop</span><span class="o">-</span><span class="n">sandbox</span><span class="p">.</span><span class="n">jar</span><span class="p">.</span>
+
+  <span class="o">-</span><span class="n">foout</span> <span class="n">outfile</span>    <span class="n">input</span> <span class="n">will</span> <span class="n">only</span> <span class="n">be</span> <span class="n">XSL</span> <span class="n">transformed</span><span class="p">.</span> <span class="n">The</span> <span class="n">intermediate</span>
+                    <span class="n">XSL</span><span class="o">-</span><span class="n">FO</span> <span class="n">file</span> <span class="n">is</span> <span class="n">saved</span> <span class="n">and</span> <span class="n">no</span> <span class="n">rendering</span> <span class="n">is</span> <span class="n">performed</span><span class="p">.</span>
+                    <span class="p">(</span><span class="n">Only</span> <span class="n">available</span> <span class="k">if</span> <span class="n">you</span> <span class="n">use</span> <span class="o">-</span><span class="n">xml</span> <span class="n">and</span> <span class="o">-</span><span class="n">xsl</span> <span class="n">parameters</span><span class="p">)</span>
+
+
+ <span class="p">[</span><span class="n">Examples</span><span class="p">]</span>
+  <span class="n">fop</span> <span class="n">foo</span><span class="p">.</span><span class="n">fo</span> <span class="n">foo</span><span class="p">.</span><span class="n">pdf</span>
+  <span class="n">fop</span> <span class="o">-</span><span class="n">fo</span> <span class="n">foo</span><span class="p">.</span><span class="n">fo</span> <span class="o">-</span><span class="n">pdf</span> <span class="n">foo</span><span class="p">.</span><span class="n">pdf</span> <span class="p">(</span><span class="n">does</span> <span class="n">the</span> <span class="n">same</span> <span class="n">as</span> <span class="n">the</span> <span class="n">previous</span> <span class="n">line</span><span class="p">)</span>
+  <span class="n">fop</span> <span class="o">-</span><span class="n">xml</span> <span class="n">foo</span><span class="p">.</span><span class="n">xml</span> <span class="o">-</span><span class="n">xsl</span> <span class="n">foo</span><span class="p">.</span><span class="n">xsl</span> <span class="o">-</span><span class="n">pdf</span> <span class="n">foo</span><span class="p">.</span><span class="n">pdf</span>
+  <span class="n">fop</span> <span class="o">-</span><span class="n">xml</span> <span class="n">foo</span><span class="p">.</span><span class="n">xml</span> <span class="o">-</span><span class="n">xsl</span> <span class="n">foo</span><span class="p">.</span><span class="n">xsl</span> <span class="o">-</span><span class="n">foout</span> <span class="n">foo</span><span class="p">.</span><span class="n">fo</span>
+  <span class="n">fop</span> <span class="o">-</span><span class="n">xml</span> <span class="o">-</span> <span class="o">-</span><span class="n">xsl</span> <span class="n">foo</span><span class="p">.</span><span class="n">xsl</span> <span class="o">-</span><span class="n">pdf</span> <span class="o">-</span>
+  <span class="n">fop</span> <span class="n">foo</span><span class="p">.</span><span class="n">fo</span> <span class="o">-</span><span class="n">mif</span> <span class="n">foo</span><span class="p">.</span><span class="n">mif</span>
+  <span class="n">fop</span> <span class="n">foo</span><span class="p">.</span><span class="n">fo</span> <span class="o">-</span><span class="n">rtf</span> <span class="n">foo</span><span class="p">.</span><span class="n">rtf</span>
+  <span class="n">fop</span> <span class="n">foo</span><span class="p">.</span><span class="n">fo</span> <span class="o">-</span><span class="n">print</span>
+  <span class="n">fop</span> <span class="n">foo</span><span class="p">.</span><span class="n">fo</span> <span class="o">-</span><span class="n">awt</span>
+</pre></div>
+
+
+<p>PDF encryption is only available if FOP was compiled with encryption support <strong>and</strong> if compatible encryption support is available at run time. Currently, only the JCE is supported. Check the <a href="pdfencryption.html">Details</a>.</p>
+<h3 id="your-own-script">Writing your own script<a class="headerlink" href="#your-own-script" title="Permanent link">&para;</a></h3>
+<p>FOP's entry point for your own scripts is the class <code>org.apache.fop.cli.Main</code>. The general pattern for the command line is: <code>java -classpath &lt;CLASSPATH&gt;
+        org.apache.fop.cli.Main &lt;arguments&gt;</code>. The arguments consist of the options and infile and outfile specifications as shown above for the standard scripts. You may wish to review the standard scripts to make sure that you get your environment properly configured.</p>
+<h3 id="jar-option">Running with java's -jar option<a class="headerlink" href="#jar-option" title="Permanent link">&para;</a></h3>
+<p>As an alternative to the start scripts you can run <code>java
+        -jar path/to/build/fop.jar &lt;arguments&gt;</code>, relying on FOP to build the classpath for running FOP dynamically, see <a href="#dynamical-classpath">below</a>. If you use hyphenation, you must put <code>fop-hyph.jar</code> in the <code>lib</code> directory.</p>
+<p>You can also run <code>java -jar path/to/fop.jar
+      &lt;arguments&gt;</code>, relying on the <code>Class-Path</code> entry in the manifest file. This works if you put <code>fop.jar</code> and all jar files from the <code>lib</code> directory in a single directory. If you use hyphenation, you must also put <code>fop-hyph.jar</code> in that directory.</p>
+<p>In both cases the arguments consist of the options and infile and outfile specifications as shown above for the standard scripts.</p>
+<h3 id="dynamical-classpath">FOP's dynamical classpath construction<a class="headerlink" href="#dynamical-classpath" title="Permanent link">&para;</a></h3>
+<p>If FOP is started without a proper classpath, it tries to add its dependencies dynamically. If the system property <code>fop.home</code> contains the name of a directory, then FOP uses that directory as the base directory for its search. Otherwise the current working directory is the base directory. If the base directory is called <code>build</code>, then its parent directory becomes the base directory.</p>
+<p>FOP expects to find <code>fop.jar</code> in the <code>build</code> subdirectory of the base directory, and adds it to the classpath. Subsequently FOP adds all <code>jar</code> files in the lib directory to the classpath. The lib directory is either the <code>lib</code> subdirectory of the base directory, or, if that does not exist, the base directory itself.</p>
+<p>If the system property <code>fop.optional.lib</code> contains the name of a directory, then all <code>jar</code> files in that directory are also added to the classpath. See the methods <code>getJARList</code> and <code>checkDependencies</code> in <code>org.apache.fop.cli.Main</code>.</p>
+<h2 id="check-input">Using Xalan to Check XSL-FO Input<a class="headerlink" href="#check-input" title="Permanent link">&para;</a></h2>
+<p>FOP sessions that use -xml and -xsl input instead of -fo input are actually controlling two distinct conversions: Tranforming XML to XSL-FO, then formatting the XSL-FO to PDF (or another FOP output format). Although FOP controls both of these processes, the first is included merely as a convenience and for performance reasons. Only the second is part of FOP's core processing. If a user has a problem running FOP, it is important to determine which of these two processes is causing the problem. If the problem is in the first process, the user's stylesheet is likely the cause. The FOP development team does not have resources to help with stylesheet issues, although we have included links to some useful <a href="../resources.html#specs">Specifications</a> and <a href="../resources.html#articles">Books/Articles</a>. If the problem is in the second process, FOP may have a bug or an unimplemented feature that does require attention from the FOP development team.</p>
+<p><note>The user is always responsible to provide correct XSL-FO code to FOP.</note></p>
+<p>In the case of using -xml and -xsl input, although the user is responsible for the XSL-FO code that is FOP's input, it is not visible to the user. To make the intermediate FO file visible, the FOP distribution includes the "-foout" option which causes FOP to run only the first (transformation) step, and write the results to a file. (See also the Xalan command-line below)</p>
+<p><note>When asking for help on the FOP mailing lists, <em>never</em> attach XML and XSL to illustrate the issue. Always run the XSLT step (-foout) and send the resulting XSL-FO file instead. Of course, be sure that the XSL-FO file is correct before sending it.</note></p>
+<p>The -foout option works the same way as if you would call the <a href="http://xml.apache.org/xalan-j/commandline.html">Xalan command-line</a>:</p>
+<p><code>java org.apache.xalan.xslt.Process -IN xmlfile -XSL file -OUT outfile</code></p>
+<p>Note that there are some subtle differences between the FOP and Xalan command-lines.</p>
+<h2 id="memory">Memory Usage<a class="headerlink" href="#memory" title="Permanent link">&para;</a></h2>
+<p>FOP can consume quite a bit of memory, even though this has been continually improved. This is partly inherent to the formatting process and partly caused by implementation choices. All FO processors currently on the market have memory problems with certain layouts.</p>
+<p>If you are running out of memory when using FOP, here are some ideas that may help:</p>
+<ul>
+<li>
+<p>Increase memory available to the JVM. See <a href="http://docs.oracle.com/javase/1.5.0/docs/tooldocs/solaris/java.html">the -Xmx option</a> for more information.<warning>It is usually unwise to increase the memory allocated to the JVM beyond the amount of physical RAM, as this will generally cause significantly slower performance.</warning></p>
+</li>
+<li>
+<p>Avoid forward references. Forward references are references to some later part of a document. Examples include page number citations which refer to pages which follow the citation, tables of contents at the beginning of a document, and page numbering schemes that include the total number of pages in the document (<a href="../faq.html#pagenum">"page N of TOTAL"</a>). Forward references cause all subsequent pages to be held in memory until the reference can be resolved, i.e. until the page with the referenced element is encountered. Forward references may be required by the task, but if you are getting a memory overflow, at least consider the possibility of eliminating them. A table of contents could be replaced by PDF bookmarks instead or moved to the end of the document (reshuffle the paper could after printing).</p>
+</li>
+<li>
+<p>Avoid large images, especially if they are scaled down. If they need to be scaled, scale them in another application upstream from FOP. For many image formats, memory consumption is driven mainly by the size of the image file itself, not its dimensions (width*height), so increasing the compression rate may help.</p>
+</li>
+<li>
+<p>Use multiple page sequences. FOP starts rendering after the end of a page sequence is encountered. While the actual rendering is done page-by-page, some additional memory is freed after the page sequence has been rendered. This can be substantial if the page sequence contains lots of FO elements.</p>
+</li>
+</ul>
+<h2 id="problems">Problems<a class="headerlink" href="#problems" title="Permanent link">&para;</a></h2>
+<p>If you have problems running FOP, please see the <a href="../gethelp.html">"How to get Help" page</a>.</p></div>
+      </div>
+      
+      <div class="clear"></div>
+
+	  <div id="footer">
+		<div class="copyright">
+		  <div style="float:left; padding: 7px;">
+			<a title="Apache Software Foundation" href="http://www.apache.org"><img id="asf-feather-logo" alt="Apache Software Foundation" src="/images/asf_logo_url.png" width="200" /></a>
+        </div>
+		  <p>
+			Copyright &copy; 2016 The Apache Software Foundation, Licensed under
+			the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+			<br />
+			Apache, Apache XML Graphics, Apache FOP, Apache Batik, the Apache feather logo, and the
+			Apache XML Graphics logos are trademarks of <a href="http://www.apache.org">The Apache
+			Software Foundation</a>. All other marks mentioned may be trademarks or registered
+			trademarks of their respective owners.
+			<br />
+		  </p>
+		</div> 
+	  </div>
+	
+
+  </body>
+</html>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: commits-help@xmlgraphics.apache.org


Mime
View raw message