| <!DOCTYPE html> |
| <html lang="en"> |
| <head> |
| |
| |
| <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="https://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="https://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"> |
| </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™ FOP<a class="headerlink" href="#apache-fop" title="Permanent link">¶</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="https://cwiki.apache.org/confluence/display/XMLGRAPHICSFOP">FOP Wiki</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">¶</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="https://cwiki.apache.org/confluence/display/XMLGRAPHICSFOP/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">¶</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">¶</a></h2> |
| <ul> |
| <li> |
| <h2 id="fop-trunk-dev">FOP Trunk (dev)<a class="headerlink" href="#fop-trunk-dev" title="Permanent link">¶</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™ FOP<a class="headerlink" href="#using-apache-fop" title="Permanent link">¶</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">¶</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-25">FOP 2.5<a class="headerlink" href="#fop-25" title="Permanent link">¶</a></h2> |
| <ul> |
| <li><a href="/fop/2.5/">FOP 2.5 Overview</a></li> |
| <li><a href="/fop/2.5/releaseNotes_2.5.html">Release Notes</a></li> |
| <li><a href="/fop/2.5/changes_2.5.html">Changes (2.5)</a></li> |
| <li><a href="/fop/2.5/knownissues_overview.html">Known Issues</a></li> |
| <li><a href="/fop/2.5/upgrading.html">Upgrading</a></li> |
| <li> |
| <h3 id="using-apache-fop-25">Using Apache FOP 2.5<a class="headerlink" href="#using-apache-fop-25" title="Permanent link">¶</a></h3> |
| <ul> |
| <li><a href="/fop/2.5/compiling.html">Build</a></li> |
| <li><a href="/fop/2.5/configuration.html">Configure</a></li> |
| <li><a href="/fop/2.5/running.html">Run</a></li> |
| <li><a href="/fop/2.5/embedding.html">Embed</a></li> |
| <li><a href="/fop/2.5/servlets.html">Servlets</a></li> |
| <li><a href="/fop/2.5/anttask.html">Ant Task</a></li> |
| </ul> |
| </li> |
| <li> |
| <h3 id="features_1">Features<a class="headerlink" href="#features_1" title="Permanent link">¶</a></h3> |
| <ul> |
| <li><a href="/fop/2.5/accessibility.html">Accessibility</a></li> |
| <li><a href="/fop/2.5/complexscripts.html">Complex Scripts</a></li> |
| <li><a href="/fop/2.5/events.html">Events</a></li> |
| <li><a href="/fop/2.5/extensions.html">Extensions</a></li> |
| <li><a href="/fop/2.5/fonts.html">Fonts</a></li> |
| <li><a href="/fop/2.5/graphics.html">Graphics</a></li> |
| <li><a href="/fop/2.5/hyphenation.html">Hyphenation</a></li> |
| <li><a href="/fop/2.5/intermediate.html">Intermediate Format</a></li> |
| <li><a href="/fop/2.5/metadata.html">Metadata</a></li> |
| <li><a href="/fop/2.5/output.html">Output Targets</a></li> |
| <li><a href="/fop/2.5/pdfa.html">PDF/A</a></li> |
| <li><a href="/fop/2.5/pdfx.html">PDF/X</a></li> |
| <li><a href="/fop/2.5/pdfencryption.html">PDF Encryption</a></li> |
| <li><a href="/fop/fop-pdf-images.html">PDF Images</a></li> |
| <li><a href="/fop/2.5/whitespacemanagement.html">Whitespace Management</a> </li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li> |
| <h2 id="fop-24">FOP 2.4<a class="headerlink" href="#fop-24" title="Permanent link">¶</a></h2> |
| <ul> |
| <li><a href="/fop/2.4/">FOP 2.4 Overview</a></li> |
| <li><a href="/fop/2.4/releaseNotes_2.4.html">Release Notes</a></li> |
| <li><a href="/fop/2.4/changes_2.4.html">Changes (2.4)</a></li> |
| <li><a href="/fop/2.4/knownissues_overview.html">Known Issues</a></li> |
| <li><a href="/fop/2.4/upgrading.html">Upgrading</a></li> |
| <li> |
| <h3 id="using-apache-fop-24">Using Apache FOP 2.4<a class="headerlink" href="#using-apache-fop-24" title="Permanent link">¶</a></h3> |
| <ul> |
| <li><a href="/fop/2.4/compiling.html">Build</a></li> |
| <li><a href="/fop/2.4/configuration.html">Configure</a></li> |
| <li><a href="/fop/2.4/running.html">Run</a></li> |
| <li><a href="/fop/2.4/embedding.html">Embed</a></li> |
| <li><a href="/fop/2.4/servlets.html">Servlets</a></li> |
| <li><a href="/fop/2.4/anttask.html">Ant Task</a></li> |
| </ul> |
| </li> |
| <li> |
| <h3 id="features_2">Features<a class="headerlink" href="#features_2" title="Permanent link">¶</a></h3> |
| <ul> |
| <li><a href="/fop/2.4/accessibility.html">Accessibility</a></li> |
| <li><a href="/fop/2.4/complexscripts.html">Complex Scripts</a></li> |
| <li><a href="/fop/2.4/events.html">Events</a></li> |
| <li><a href="/fop/2.4/extensions.html">Extensions</a></li> |
| <li><a href="/fop/2.4/fonts.html">Fonts</a></li> |
| <li><a href="/fop/2.4/graphics.html">Graphics</a></li> |
| <li><a href="/fop/2.4/hyphenation.html">Hyphenation</a></li> |
| <li><a href="/fop/2.4/intermediate.html">Intermediate Format</a></li> |
| <li><a href="/fop/2.4/metadata.html">Metadata</a></li> |
| <li><a href="/fop/2.4/output.html">Output Targets</a></li> |
| <li><a href="/fop/2.4/pdfa.html">PDF/A</a></li> |
| <li><a href="/fop/2.4/pdfx.html">PDF/X</a></li> |
| <li><a href="/fop/2.4/pdfencryption.html">PDF Encryption</a></li> |
| <li><a href="/fop/fop-pdf-images.html">PDF Images</a></li> |
| <li><a href="/fop/2.4/whitespacemanagement.html">Whitespace Management</a> </li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li> |
| <h2 id="fop-23">FOP 2.3<a class="headerlink" href="#fop-23" title="Permanent link">¶</a></h2> |
| <ul> |
| <li><a href="/fop/2.3/">FOP 2.3 Overview</a></li> |
| <li><a href="/fop/2.3/releaseNotes_2.3.html">Release Notes</a></li> |
| <li><a href="/fop/2.3/changes_2.3.html">Changes (2.3)</a></li> |
| <li><a href="/fop/2.3/knownissues_overview.html">Known Issues</a></li> |
| <li><a href="/fop/2.3/upgrading.html">Upgrading</a></li> |
| <li> |
| <h3 id="using-apache-fop-23">Using Apache FOP 2.3<a class="headerlink" href="#using-apache-fop-23" title="Permanent link">¶</a></h3> |
| <ul> |
| <li><a href="/fop/2.3/compiling.html">Build</a></li> |
| <li><a href="/fop/2.3/configuration.html">Configure</a></li> |
| <li><a href="/fop/2.3/running.html">Run</a></li> |
| <li><a href="/fop/2.3/embedding.html">Embed</a></li> |
| <li><a href="/fop/2.3/servlets.html">Servlets</a></li> |
| <li><a href="/fop/2.3/anttask.html">Ant Task</a></li> |
| </ul> |
| </li> |
| <li> |
| <h3 id="features_3">Features<a class="headerlink" href="#features_3" title="Permanent link">¶</a></h3> |
| <ul> |
| <li><a href="/fop/2.3/accessibility.html">Accessibility</a></li> |
| <li><a href="/fop/2.3/complexscripts.html">Complex Scripts</a></li> |
| <li><a href="/fop/2.3/events.html">Events</a></li> |
| <li><a href="/fop/2.3/extensions.html">Extensions</a></li> |
| <li><a href="/fop/2.3/fonts.html">Fonts</a></li> |
| <li><a href="/fop/2.3/graphics.html">Graphics</a></li> |
| <li><a href="/fop/2.3/hyphenation.html">Hyphenation</a></li> |
| <li><a href="/fop/2.3/intermediate.html">Intermediate Format</a></li> |
| <li><a href="/fop/2.3/metadata.html">Metadata</a></li> |
| <li><a href="/fop/2.3/output.html">Output Targets</a></li> |
| <li><a href="/fop/2.3/pdfa.html">PDF/A</a></li> |
| <li><a href="/fop/2.3/pdfx.html">PDF/X</a></li> |
| <li><a href="/fop/2.3/pdfencryption.html">PDF Encryption</a></li> |
| <li><a href="/fop/fop-pdf-images.html">PDF Images</a></li> |
| <li><a href="/fop/2.3/whitespacemanagement.html">Whitespace Management</a> </li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li> |
| <h2 id="fop-22">FOP 2.2<a class="headerlink" href="#fop-22" title="Permanent link">¶</a></h2> |
| <ul> |
| <li><a href="/fop/2.2/">FOP 2.2 Overview</a></li> |
| <li><a href="/fop/2.2/releaseNotes_2.2.html">Release Notes</a></li> |
| <li><a href="/fop/2.2/changes_2.2.html">Changes (2.2)</a></li> |
| <li><a href="/fop/2.2/knownissues_overview.html">Known Issues</a></li> |
| <li><a href="/fop/2.2/upgrading.html">Upgrading</a></li> |
| <li> |
| <h3 id="using-apache-fop-22">Using Apache FOP 2.2<a class="headerlink" href="#using-apache-fop-22" title="Permanent link">¶</a></h3> |
| <ul> |
| <li><a href="/fop/2.2/compiling.html">Build</a></li> |
| <li><a href="/fop/2.2/configuration.html">Configure</a></li> |
| <li><a href="/fop/2.2/running.html">Run</a></li> |
| <li><a href="/fop/2.2/embedding.html">Embed</a></li> |
| <li><a href="/fop/2.2/servlets.html">Servlets</a></li> |
| <li><a href="/fop/2.2/anttask.html">Ant Task</a></li> |
| </ul> |
| </li> |
| <li> |
| <h3 id="features_4">Features<a class="headerlink" href="#features_4" title="Permanent link">¶</a></h3> |
| <ul> |
| <li><a href="/fop/2.2/accessibility.html">Accessibility</a></li> |
| <li><a href="/fop/2.2/complexscripts.html">Complex Scripts</a></li> |
| <li><a href="/fop/2.2/events.html">Events</a></li> |
| <li><a href="/fop/2.2/extensions.html">Extensions</a></li> |
| <li><a href="/fop/2.2/fonts.html">Fonts</a></li> |
| <li><a href="/fop/2.2/graphics.html">Graphics</a></li> |
| <li><a href="/fop/2.2/hyphenation.html">Hyphenation</a></li> |
| <li><a href="/fop/2.2/intermediate.html">Intermediate Format</a></li> |
| <li><a href="/fop/2.2/metadata.html">Metadata</a></li> |
| <li><a href="/fop/2.2/output.html">Output Targets</a></li> |
| <li><a href="/fop/2.2/pdfa.html">PDF/A</a></li> |
| <li><a href="/fop/2.2/pdfx.html">PDF/X</a></li> |
| <li><a href="/fop/2.2/pdfencryption.html">PDF Encryption</a></li> |
| <li><a href="/fop/fop-pdf-images.html">PDF Images</a></li> |
| <li><a href="/fop/2.2/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">¶</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">¶</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_5">Features<a class="headerlink" href="#features_5" title="Permanent link">¶</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">¶</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">¶</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_6">Features<a class="headerlink" href="#features_6" title="Permanent link">¶</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">¶</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">¶</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_7">Features<a class="headerlink" href="#features_7" title="Permanent link">¶</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">¶</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">¶</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_8">Features<a class="headerlink" href="#features_8" title="Permanent link">¶</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">¶</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">¶</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">¶</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">¶</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="https://cwiki.apache.org/confluence/display/XMLGRAPHICSFOP/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">¶</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">¶</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">¶</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">¶</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">¶</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™ XML Graphics<a class="headerlink" href="#apache-xml-graphics" title="Permanent link">¶</a></h1> |
| <ul> |
| <li> |
| <h2 id="project-overview">Project Overview<a class="headerlink" href="#project-overview" title="Permanent link">¶</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="https://www.apache.org/foundation/sponsorship.html">ASF Sponsorship Program</a></li> |
| <li><a href="https://www.apache.org/foundation/thanks.html">ASF Thanks</a></li> |
| <li><a href="https://www.apache.org/licenses/">Licenses</a></li> |
| <li><a href="/security.html">Apache XML Graphics Security</a></li> |
| <li><a href="https://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">¶</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">¶</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">¶</a></h3> |
| <p><a title="ApacheCon North America" href="https://www.apachecon.com"><img class="apachecon_logo" alt="ApacheCon North America" src="https://www.apachecon.com/images/landingpage/apachecon-logo.png" width="200" /></a><br /><br /></p> |
| <ul> |
| <li><strong><a href="https://www.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">¶</a></h3> |
| <p><a title="ApacheCon Europe" href="https://www.apachecon.com"><img class="apachecon_logo" alt="ApacheCon Europe" src="https://www.apachecon.com/images/landingpage/apachecon-logo.png" width="200" /></a><br /><br /></p> |
| <ul> |
| <li><strong><a href="https://www.apachecon.com/">ApacheCon Europe</a></strong></li> |
| </ul> |
| <p>Hope to see you there!</p> |
| <p><a title="Apache Software Foundation" href="https://www.apache.org"><img id="asf_logo_url" alt="Apache Software Foundation " src="/images/asf_logo_url.png" width="200" /></a><br /><br /></p> |
| <p><a title="Support the Apache Software Foundation" href="https://donate.apache.org/"><img id="asf_support_url" alt="Support the Apache Software Foundation " src="https://blogs.apache.org/foundation/mediaresource/d67ca611-a57c-462d-ac23-95063f81d175" 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(' »'); |
| } |
| $('#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™ FOP Project</h2> |
| </div> |
| |
| <h1>Apache(tm) FOP: Metadata</h1> |
| Translations: |
| <a href="/fop/2.0/metadata.html">en</a> |
| <a href="/fop/2.5/metadata.html">en</a> |
| <a href="/fop/trunk/metadata.html">en</a> |
| <a href="/fop/1.1/metadata.html">en</a> |
| <a href="/fop/2.2/metadata.html">en</a> |
| <a href="/fop/2.1/metadata.html">en</a> |
| <a href="/fop/2.3/metadata.html">en</a> |
| <a href="/fop/2.4/metadata.html">en</a> |
| <a href="/fop/1.0/metadata.html">en</a> |
| |
| |
| <h1>Apache™ FOP: Metadata</h1> |
| <h2 id="overview">Overview</h2> |
| <p>Document metadata is an important tool for categorizing and finding documents. Various formats support different kinds of metadata representation and to different levels. One of the more popular and flexible means of representing document or object metadata is <a href="http://www.adobe.com/products/xmp/">XMP (eXtensible Metadata Platform, specified by Adobe)</a>. PDF 1.4 introduced the use of XMP. The XMP specification lists recommendation for embedding XMP metdata in other document and image formats. Given its flexibility it makes sense to make use this approach in the XSL-FO context. Unfortunately, unlike SVG which also refers to XMP, XSL-FO doesn't recommend a preferred way of specifying document and object metadata. Therefore, there's no portable way to represent metadata in XSL-FO documents. Each implementation does it differently.</p> |
| <h2 id="xmp-in-fo">Embedding XMP in an XSL-FO document</h2> |
| <p>As noted above, there's no officially recommended way to embed metadata in XSL-FO. Apache™ FOP supports embedding XMP in XSL-FO. Currently, only support for document-level metadata is implemented. Object-level metadata will be implemented when there's interest.</p> |
| <p>Document-level metadata can be specified in the <code>fo:declarations</code> element. XMP specification recommends to use <code>x:xmpmeta</code>, <code>rdf:RDF</code>, and <code>rdf:Description</code> elements as shown in example below. Both <code>x:xmpmeta</code> and <code>rdf:RDF</code> elements are recognized as the top-level element introducing an XMP fragment (as per the XMP specification).</p> |
| <h3 id="xmp-example">Example</h3> |
| <div class="highlight"><pre><span></span>[..] |
| <span class="nt"></fo:layout-master-set></span> |
| <span class="nt"><fo:declarations></span> |
| <span class="nt"><x:xmpmeta</span> <span class="na">xmlns:x=</span><span class="s">"adobe:ns:meta/"</span><span class="nt">></span> |
| <span class="nt"><rdf:RDF</span> <span class="na">xmlns:rdf=</span><span class="s">"http://www.w3.org/1999/02/22-rdf-syntax-ns#"</span><span class="nt">></span> |
| <span class="nt"><rdf:Description</span> <span class="na">rdf:about=</span><span class="s">""</span> |
| <span class="na">xmlns:dc=</span><span class="s">"http://purl.org/dc/elements/1.1/"</span><span class="nt">></span> |
| <span class="c"><!-- Dublin Core properties go here --></span> |
| <span class="nt"><dc:title></span>Document title<span class="nt"></dc:title></span> |
| <span class="nt"><dc:creator></span>Document author<span class="nt"></dc:creator></span> |
| <span class="nt"><dc:description></span>Document subject<span class="nt"></dc:description></span> |
| <span class="nt"></rdf:Description></span> |
| <span class="nt"><rdf:Description</span> <span class="na">rdf:about=</span><span class="s">""</span> |
| <span class="na">xmlns:xmp=</span><span class="s">"http://ns.adobe.com/xap/1.0/"</span><span class="nt">></span> |
| <span class="c"><!-- XMP properties go here --></span> |
| <span class="nt"><xmp:CreatorTool></span>Tool used to make the PDF<span class="nt"></xmp:CreatorTool></span> |
| <span class="nt"></rdf:Description></span> |
| <span class="nt"></rdf:RDF></span> |
| <span class="nt"></x:xmpmeta></span> |
| <span class="nt"></fo:declarations></span> |
| <span class="nt"><fo:page-sequence</span> <span class="err">...</span> |
| <span class="err">[..]</span> |
| </pre></div> |
| |
| |
| <p><code>fo:declarations</code> <strong>must</strong> be declared after <code>fo:layout-master-set</code> and before the first <code>page-sequence</code>.</p> |
| <h2 id="xmp-impl-in-fop">Implementation in Apache FOP</h2> |
| <p>Currently, XMP support is only available for PDF output.</p> |
| <p>Originally, you could set some metadata information through FOP's FOUserAgent by using its set*() methods (like setTitle(String) or setAuthor(String). These values are directly used to set value in the PDF Info object. Since PDF 1.4, adding metadata as an XMP document to a PDF is possible. That means that there are now two mechanisms in PDF that hold metadata.</p> |
| <p>Apache FOP now synchronizes the Info and the Metadata object in PDF, i.e. when you set the title and the author through the FOUserAgent, the two values will end up in the (old) Info object and in the new Metadata object as XMP content. If instead of FOUserAgent, you embed XMP metadata in the XSL-FO document (as shown above), the XMP metadata will be used as-is in the PDF Metadata object and some values from the XMP metadata will be copied to the Info object to maintain backwards-compatibility for PDF readers that don't support XMP metadata.</p> |
| <p>The mapping between the Info and the Metadata object used by Apache FOP comes from the <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=38920">PDF/A-1 specification</a>. For convenience, here's the mapping table:</p> |
| <table> |
| <thead> |
| <tr> |
| <th>Document information dictionary<br/>Entry</th> |
| <th>PDF type</th> |
| <th>XMP Property</th> |
| <th>XMP type</th> |
| <th>XMP Category</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td>Title</td> |
| <td>text string</td> |
| <td>dc:title</td> |
| <td>Text</td> |
| <td>External</td> |
| </tr> |
| <tr> |
| <td>Author</td> |
| <td>text string</td> |
| <td>dc:creator</td> |
| <td>seq Text</td> |
| <td>External</td> |
| </tr> |
| <tr> |
| <td>Subject</td> |
| <td>text string</td> |
| <td>dc:description["x-default"]</td> |
| <td>Text</td> |
| <td>External</td> |
| </tr> |
| <tr> |
| <td>Keywords</td> |
| <td>text string</td> |
| <td>pdf:Keywords</td> |
| <td>Text</td> |
| <td>External</td> |
| </tr> |
| <tr> |
| <td>Creator</td> |
| <td>text string</td> |
| <td>xmp:CreatorTool</td> |
| <td>Text</td> |
| <td>External</td> |
| </tr> |
| <tr> |
| <td>Producer</td> |
| <td>text string</td> |
| <td>pdf:Producer</td> |
| <td>Text</td> |
| <td>Internal</td> |
| </tr> |
| <tr> |
| <td>CreationDate</td> |
| <td>date</td> |
| <td>xmp:CreationDate</td> |
| <td>Date</td> |
| <td>Internal</td> |
| </tr> |
| <tr> |
| <td>ModDate</td> |
| <td>date</td> |
| <td>xmp:ModifyDate</td> |
| <td>Date</td> |
| <td>Internal</td> |
| </tr> |
| <tr> |
| <td>"Internal" in the Category column means that the user should not set this value. It is set by the application.The "Subject" used to be mapped to <code>dc:subject</code> in the initial publication of PDF/A-1 (ISO 19005-1). In the <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=45613">Technical Corrigendum 1</a> this was changed to map to <code>dc:description["x-default"]</code>.</td> |
| <td></td> |
| <td></td> |
| <td></td> |
| <td></td> |
| </tr> |
| </tbody> |
| </table> |
| <h3 id="namespaces">Namespaces</h3> |
| <p>Metadata is made of property sets where each property set uses a different namespace URI.</p> |
| <p>The following is a listing of namespaces that Apache FOP recognizes and acts upon, mostly to synchronize the XMP metadata with the PDF Info dictionary:</p> |
| <table> |
| <thead> |
| <tr> |
| <th>Set/Schema</th> |
| <th>Namespace Prefix</th> |
| <th>Namespace URI</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td>Dublin Core</td> |
| <td>dc</td> |
| <td>http://purl.org/dc/elements/1.1/</td> |
| </tr> |
| <tr> |
| <td>XMP Basic</td> |
| <td>xmp</td> |
| <td>http://ns.adobe.com/xap/1.0/</td> |
| </tr> |
| <tr> |
| <td>Adobe PDF Schema</td> |
| <td>pdf</td> |
| <td>http://ns.adobe.com/pdf/1.3/</td> |
| </tr> |
| </tbody> |
| </table> |
| <p>Please refer to the <a href="http://partners.adobe.com/public/developer/en/xmp/sdk/XMPspecification.pdf">XMP Specification</a> for information on other metadata namespaces.</p> |
| <p>Property sets (Namespaces) not listed here are simply passed through to the final document (if supported). That is useful if you want to specify a custom metadata schema.</p> |
| <h2 id="links">Links</h2> |
| <ul> |
| <li> |
| <p><a href="http://www.adobe.com/products/xmp/">Adobe's Extensible Metadata Platform (XMP) website</a></p> |
| </li> |
| <li> |
| <p><a href="http://partners.adobe.com/public/developer/en/xmp/sdk/XMPspecification.pdf">Adobe XMP Specification</a></p> |
| </li> |
| <li> |
| <p><a href="http://partners.adobe.com/public/developer/en/xmp/sdk/XMPspecification.pdf">Adobe XMP Specification</a></p> |
| </li> |
| <li> |
| <p><a href="http://dublincore.org/">http://dublincore.org/</a></p> |
| </li> |
| </ul> |
| |
| <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 © 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> |
