You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pdfbox.apache.org by ms...@apache.org on 2015/11/16 19:57:36 UTC
[1/6] pdfbox-docs git commit: Site checkin for project Apache PDFBox
Website
Repository: pdfbox-docs
Updated Branches:
refs/heads/asf-site 3f67f8b81 -> aa929f46c
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/index.html
----------------------------------------------------------------------
diff --git a/content/index.html b/content/index.html
new file mode 100644
index 0000000..7c86662
--- /dev/null
+++ b/content/index.html
@@ -0,0 +1,256 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | A Java PDF Library</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="apache-pdfbox-a-java-pdf-library">Apache PDFBox - A Java PDF Library</h1>
+
+<p class="lead">The Apache PDFBox™ library is an open source Java tool for working with
+ PDF documents. This project allows creation of new PDF documents, manipulation of existing
+ documents and the ability to extract content from documents.
+
+ Apache PDFBox also includes several command line utilities.
+ Apache PDFBox is published under the Apache License v2.0.</p>
+
+
+<h2 id="news">News</h2>
+
+<p>With the initial discussions starting 3 years ago PDFBox 2.0.0 is in the works for quite some time now - <strong>and we are in the final stages!</strong> To give you the opportunity to provide feedback a <a href="http://pdfbox.apache.org/download.cgi">PDFBox 2.0.0-RC1 Release Candidate</a> is now available. The <a href="http://pdfbox.apache.org/2.0/migration.html">Migration Guide</a> shall give users coming from PDFBox 1.8 or earlier an overview about things to look at when switching over. More details to come.</p>
+
+<h2 id="getting-help">Getting Help</h2>
+
+<p>To get help on using PDFBox, please <a href="mailto:users-subscribe@pdfbox.apache.org">Subscribe to the Users Mailing List</a> and post your
+questions there. We're happy to help.</p>
+
+<p>The project is a volunteer effort and we're always looking for interested people to help
+us improve PDFBox. There are a multitude of ways that you can help us depending on your
+skills. Subscribe to the <a href="/mailinglists.html">Mailing Lists</a> and find out how you can help.</p>
+
+<h2 id="features">Features</h2>
+
+<div class="row">
+ <div class="col-md-3">
+ <header><h4><span class="oi oi-box"></span>Extract Text</h4></header>
+ <p>Extract Unicode text from PDF files.</p>
+ </div>
+ <div class="col-md-3">
+ <header><h4><span class="oi oi-box"></span>Split & Merge</h4></header>
+ <p>Split a single PDF into many files or merge multiple PDF files.</p>
+ </div>
+ <div class="col-md-3">
+ <header><h4><span class="oi oi-box"></span>Fill Forms</h4></header>
+ <p>Extract data from PDF forms or fill a PDF form.</p>
+ </div>
+ <div class="col-md-3">
+ <header><h4><span class="oi oi-box"></span>Preflight</h4></header>
+ <p>Validate PDF files against the PDF/A-1b standard.</p>
+ </div>
+</div>
+
+<div class="row">
+ <div class="col-md-3">
+ <header><h4><span class="oi oi-box"></span>Print</h4></header>
+ <p>Print a PDF file using the standard Java printing API.</p>
+ </div>
+ <div class="col-md-3">
+ <header><h4><span class="oi oi-box"></span>Save as Image</h4></header>
+ <p>Save PDFs as image files, such as PNG or JPEG.</p>
+ </div>
+ <div class="col-md-3">
+ <header><h4><span class="oi oi-box"></span>Create PDFs</h4></header>
+ <p>Create a PDF from scratch, with embedded fonts and images.</p>
+ </div>
+ <div class="col-md-3">
+ <header><h4><span class="oi oi-box"></span>Signing</h4></header>
+ <p>Digitally sign PDF files.</p>
+ </div>
+</div>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/mailinglists.html
----------------------------------------------------------------------
diff --git a/content/mailinglists.html b/content/mailinglists.html
new file mode 100644
index 0000000..0240197
--- /dev/null
+++ b/content/mailinglists.html
@@ -0,0 +1,251 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Mailing Lists</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="mailing-lists">Mailing Lists</h1>
+
+<p>Mailing Lists are the primary communication channels for all projects at
+The Apache Software Foundation. Therefore, this applies to Apache PDFBox, too. </p>
+
+<p><strong>Please read the <a href="http://www.apache.org/foundation/public-archives.html">public forum archive policy</a> carefully before subscribing to one of our list.</strong></p>
+
+<p>If you have any questions about or problems with Apache PDFBox, you can get them addressed
+on the <strong>Users Mailing List</strong>. </p>
+
+<p>If you like to participate in the development of Apache PDFBox,
+the <strong>Developers Mailing List</strong> is the place to be. </p>
+
+<p>If you like to keep track of what's being changed inside the project, you can subscribe
+to the <strong>Commit Mailing List</strong>.</p>
+
+<p class="alert alert-info">Please use the Users Mailing List if you are unsure which list to use</p>
+
+<table><thead>
+<tr>
+<th>Name</th>
+<th>Address</th>
+<th>Subscribe</th>
+<th>Unsubscribe</th>
+<th>Help</th>
+<th>Archive</th>
+<th>MarkMail</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>Users</td>
+<td><a href="mailto:users@pdfbox.apache.org">users@pdfbox.apache.org</a></td>
+<td><a href="mailto:users-subscribe@pdfbox.apache.org">Subscribe</a></td>
+<td><a href="mailto:users-unsubscribe@pdfbox.apache.org">Unsubscribe</a></td>
+<td><a href="mailto:users-help@pdfbox.apache.org">Help</a></td>
+<td><a href="http://mail-archives.apache.org/mod_mbox/pdfbox-users/">Archive</a></td>
+<td><a href="http://pdfbox-users.markmail.org/">MarkMail</a></td>
+</tr>
+<tr>
+<td>Developers</td>
+<td><a href="mailto:dev@pdfbox.apache.org">dev@pdfbox.apache.org</a></td>
+<td><a href="mailto:dev-subscribe@pdfbox.apache.org">Subscribe</a></td>
+<td><a href="mailto:dev-unsubscribe@pdfbox.apache.org">Unsubscribe</a></td>
+<td><a href="mailto:dev-help@pdfbox.apache.org">Help</a></td>
+<td><a href="http://mail-archives.apache.org/mod_mbox/pdfbox-dev/">Archive</a></td>
+<td><a href="http://pdfbox-dev.markmail.org/">MarkMail</a></td>
+</tr>
+<tr>
+<td>Commits List</td>
+<td><a href="mailto:commits@pdfbox.apache.org">commits@pdfbox.apache.org</a></td>
+<td><a href="mailto:commits-subscribe@pdfbox.apache.org">Subscribe</a></td>
+<td><a href="mailto:commits-unsubscribe@pdfbox.apache.org">Unsubscribe</a></td>
+<td><a href="mailto:commits-help@pdfbox.apache.org">Help</a></td>
+<td><a href="http://mail-archives.apache.org/mod_mbox/pdfbox-commits/">Archive</a></td>
+<td><a href="http://pdfbox-commits.markmail.org/">MarkMail</a></td>
+</tr>
+</tbody></table>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/references.html
----------------------------------------------------------------------
diff --git a/content/references.html b/content/references.html
new file mode 100644
index 0000000..493145a
--- /dev/null
+++ b/content/references.html
@@ -0,0 +1,360 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | External Links</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="external-links">External Links</h1>
+
+<p>This page lists projects that utilize PDFBox and articles that have been written about PDFBox.
+Please file an <a href="https://issues.apache.org/jira/browse/PDFBOX">improvement issue</a> to get new projects or articles added to this page, or to update the information on existing links.</p>
+
+<h2 id="projects">Projects</h2>
+
+<table><thead>
+<tr>
+<th>Project Name</th>
+<th>License</th>
+<th>Project Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td><a href="http://www.alfresco.org/">Alfresco</a></td>
+<td>LGPL - commercial services/support/training is available</td>
+<td>Alfresco is an open source, open-standards content repository built by the most experienced content management team that includes the co-founder of Documentum.</td>
+</tr>
+<tr>
+<td><a href="http://nutch.apache.org/">Apache Nutch</a></td>
+<td>Apache License V2.0</td>
+<td>Apache Nutch is open source web-search software. It builds on Apache Lucene, adding web-specifics, such as a crawler, a link-graph database, parsers for HTML and other document formats, etc.</td>
+</tr>
+<tr>
+<td><a href="http://tika.apache.org/">Apache Tika</a></td>
+<td>Apache License V2.0</td>
+<td>Apache Tika is a toolkit for detecting and extracting metadata and structured text content from various documents using existing parser libraries.</td>
+</tr>
+<tr>
+<td><a href="http://www.centriccrm.com/">Centric CRM</a></td>
+<td>Free To Use But Restricted/Commercial</td>
+<td>The Most Advanced Open Source CRM Software.</td>
+</tr>
+<tr>
+<td><a href="http://webtest.canoo.com/webtest/manual/WebTestHome.html">Canoo Webtest</a></td>
+<td>BSD Like</td>
+<td>Free OpenSource tool for XP-style acceptance testing of Java-based Web applications.</td>
+</tr>
+<tr>
+<td><a href="http://webtest.canoo.com/webtest/manual/WebTestHome.html">contineo</a></td>
+<td>GPL</td>
+<td>Contineo is a web based document management system.</td>
+</tr>
+<tr>
+<td><a href="http://www.rewoo.de/">ECM REWOO Scope</a></td>
+<td>Commercial</td>
+<td>REWOO Scope is an Enterprise Content Management (ECM) software to organize, structure and consolidate enterprise data. Apache PDFBox is an integral part to read and index PDF documents.</td>
+</tr>
+<tr>
+<td><a href="http://www.jahia.org/">Jahia</a></td>
+<td>collaborative source license</td>
+<td>The Jahia product is currently the most powerful, ready-to-use and affordable integrated midrange Java Content Management and Corporate Portal Server.</td>
+</tr>
+<tr>
+<td><a href="http://jlibrary.sourceforge.net/">jLibrary</a></td>
+<td>BSD</td>
+<td>jLibrary is a Document Management System, oriented for personal and enterprise use.</td>
+</tr>
+<tr>
+<td><a href="http://jomic.sourceforge.net/">Jomic</a></td>
+<td>GPL</td>
+<td>Jomic is a viewer for comic book archives.</td>
+</tr>
+<tr>
+<td><a href="http://jpdfunit.sourceforge.net/">JpdfUnit</a></td>
+<td>Apache License V2.0</td>
+<td>pdfUnit is a framework for testing a generated pdf document with the JUnit Test Framework.</td>
+</tr>
+<tr>
+<td><a href="http://www.liferay.com/">Liferay Portal</a></td>
+<td>MIT</td>
+<td>Liferay Portal is an open source portal that helps organizations collaborate more efficiently by providing a consolidated view of disparate applications.</td>
+</tr>
+<tr>
+<td><a href="http://www.bibl.ulaval.ca/lius/index.en.html">LIUS</a></td>
+<td>GPL</td>
+<td>LIUS is an indexing Java framework based on the Jakarta Lucene project. The LIUS framework adds to Lucene many files format indexing fonctionalities as: Ms World, Ms Excel, Ms PowerPoint, RTF, PDF, XML, HTML, TXT, Open Office suite and JavaBeans.</td>
+</tr>
+<tr>
+<td><a href="http://gmod.org/wiki/LuceGene">LuceGene</a></td>
+<td>Artistic License</td>
+<td>LuceGene is an open-source document/object search and retrieval system specially tuned for bioinformatics text databases and documents.</td>
+</tr>
+<tr>
+<td><a href="http://www.lutece.paris.fr/">Lutece</a></td>
+<td>BSD-like</td>
+<td>Lutece is a portal engine which allows you to easily create your websites or intranets based upon HTML,XML content.</td>
+</tr>
+<tr>
+<td><a href="http://mmapps.sourceforge.net/lucenemodule/">MMBase Lucene Module</a></td>
+<td>MPL</td>
+<td>Lucenemodule is a plugin (module) for the MMBase content management system that enables Lucene full text search through it's content, and thanks to PDFBox also PDF content.</td>
+</tr>
+<tr>
+<td><a href="http://www.opencms.org/">OpenCms</a></td>
+<td>Custom</td>
+<td>OpenCms is a professional level Open Source Website Content Management System.</td>
+</tr>
+<tr>
+<td><a href="http://www.open-search-server.com/">OpenSearchServer</a></td>
+<td>GPLv3</td>
+<td>An open source search engine and crawler based on best open source technologies. It is a modern search engine and a suite of high-powered full text search algorithms.</td>
+</tr>
+<tr>
+<td><a href="http://forge.objectweb.org/projects/ops">Orbeon PresentationServer</a></td>
+<td>LGPL</td>
+<td>Orbeon PresentationServer (OPS) is an open source J2EE-based platform for XML-centric web applications. OPS is built around XHTML, XForms, XSLT, XML pipelines, and Web Services, which makes it ideal for applications that capture, process and present XML data. Commercial consulting/training/support is available through orbeon.</td>
+</tr>
+<tr>
+<td><a href="http://pdfcat.sourceforge.net/">PDFcat</a></td>
+<td>LGPL</td>
+<td>PDFcat is multi-platform catalog manager that provides searching capability over documents among virtual catalogs.</td>
+</tr>
+<tr>
+<td><a href="http://www.searchblox.com/">SearchBlox</a></td>
+<td>Commercial</td>
+<td>SearchBlox is a high-performance corporate search software designed for the Java 2 Enterprise Edition (J2EE) platform.</td>
+</tr>
+<tr>
+<td><a href="http://www.simplexrepaginator.com/">SimplexRepaginator</a></td>
+<td>Apache License V2.0</td>
+<td>Simplex Repaginator converts simplex-scanned PDFs into properly duplex-paginated PDFs and vice versa.</td>
+</tr>
+<tr>
+<td><a href="http://ir.dcs.gla.ac.uk/terrier/">Terrier</a></td>
+<td>MPL</td>
+<td>Terrier is software for the rapid development of Web, intranet and desktop search engines.</td>
+</tr>
+<tr>
+<td><a href="http://www.triboni.com/">Triboni GinkGO</a></td>
+<td>Commercial</td>
+<td>Triboni GinkGO is a highly scalable J2EE services platform that is based on a simple XML business object defintion and scripting language. Toghether with XSLT content centric web applications can be configured in a very short time.</td>
+</tr>
+<tr>
+<td><a href="http://www.zilverline.org/">Zilverline</a></td>
+<td>Collaborative Source License</td>
+<td>Zilverline is a search engine that offers web access to your personal or intranet content.</td>
+</tr>
+</tbody></table>
+
+<h2 id="articles-books">Articles/Books</h2>
+
+<table><thead>
+<tr>
+<th>Article Name</th>
+<th>Article Abstract</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>Build an eDoc Reader for your iPod <br/> <a href="http://www.oreillynet.com/pub/a/mac/2004/12/14/ipod_reader.html">Part 1 - User Interface</a> <br/> <a href="http://www.oreillynet.com/pub/a/mac/2004/12/17/ipod_reader.html">Part 2 - Document Reading Engine</a> <br/> <a href="http://www.oreillynet.com/pub/a/mac/2005/01/07/ipod_reader.html">Part 3 - <em>Integration with PDFBox</em></a></td>
+<td>A three part article that discusses the implementation of the PodReader application. PodReader is Cocoa application written in Objective-C and article discusses how to use the Cocoa-Java bridge to integrate with the Java version of PDFBox.</td>
+</tr>
+<tr>
+<td><a href="http://www.manning.com/hatcher2/">Lucene In Action</a></td>
+<td>A book that discusses integrating with the lucene search engine. One chapter discusses how to index various file formats and highlights PDFBox for indexing PDF documents.</td>
+</tr>
+<tr>
+<td><a href="http://java.sys-con.com/node/48543">Java Developers Journal - March 2005</a></td>
+<td>An article written by the lead developer of PDFBox discussing text extraction and AcroForm integration using PDFBox functionality.</td>
+</tr>
+<tr>
+<td><a href="http://www.dcs.bbk.ac.uk/research/techreps/2005/bbkcs-05-02.pdf">Refactoring trends across N versions of N Java open source systems: an empirical study</a></td>
+<td>This article describes an empirical study of multiple versions of a range of open source Java systems in an attempt to understand whether refactoring occur and, if so, which types of refactoring were most (and least) common. PDFBox is used as a case study.</td>
+</tr>
+</tbody></table>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/siteupdate.html
----------------------------------------------------------------------
diff --git a/content/siteupdate.html b/content/siteupdate.html
new file mode 100644
index 0000000..05db7c0
--- /dev/null
+++ b/content/siteupdate.html
@@ -0,0 +1,263 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Updating the Website</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="updating-the-pdfbox-website">Updating the PDFBox Website</h1>
+
+<p>The content for the PDFBox website is kept in a <a href="https://git-wip-us.apache.org/repos/asf/pdfbox-docs">git repository</a> which is also mirrored to <a href="https://github.com/apache/pdfbox-docs">GitHub</a>. The site is split into two parts: the static content and the Javadoc for the PDFBox API. Both parts are build independently as further described below.</p>
+
+<h2 id="project-info">Project info</h2>
+
+<p>The site is based on <a href="http://jekyllrb.com">Jekyll</a>. So you have to be familiar with the <a href="http://daringfireball.net/projects/markdown/syntax">Markdown</a> template language and have Jekyll (ver. 2+) installed to contribute to the project.</p>
+
+<h2 id="contribute">Contribute</h2>
+
+<p>If you would like to enhance the website content you can submit a patch. To do so please open a ticket at our <a href="https://issues.apache.org/jira/browse/PDFBOX">Issue Tracker</a>, use <code>Documentation</code> for the <code>Component</code> and add your patch to the ticket.</p>
+
+<h2 id="development">Development</h2>
+
+<h3 id="install-jekyll">Install Jekyll</h3>
+
+<p>Follow the instructions available on the <a href="http://jekyllrb.com">Jekyll</a> website.</p>
+
+<h3 id="check-out-from-the-git-repository">Check out from the git repository</h3>
+
+<p>Before you can edit the site, you need to check it out from the git repository:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">git clone https://git-wip-us.apache.org/repos/asf/pdfbox-docs
+</code></pre></div>
+<h3 id="local-changes">Local changes</h3>
+
+<p>You can now do the changes and additions to the sources of the PDFBox website. To test these locally use</p>
+<div class="highlight"><pre><code class="language-" data-lang="">jekyll serve
+</code></pre></div>
+<p>which will compile the changes and run a local webserver at </p>
+<div class="highlight"><pre><code class="language-" data-lang="">http://localhost:4000
+</code></pre></div>
+<h3 id="publish-the-website-for-comitters-only">Publish the website (for comitters only)</h3>
+
+<p>After you have done the local changes follow these steps to publish the content:</p>
+
+<p>Add the following server configuration in your ~/.m2/settings.xml file</p>
+<div class="highlight"><pre><code class="language-" data-lang=""><server>
+ <id>pdfbox-site</id>
+ <username>** USERNAME **</username>
+ <password>** PASSWORD **</password>
+</server>
+</code></pre></div>
+<p><code>pdfbox-site</code> is referenced from the PDFBox pom.xml file.</p>
+
+<p class="alert alert-warning">The password should be encrypted following <a href="https://maven.apache.org/guides/mini/guide-encryption.html">Maven Password Encryption</a></p>
+
+<p>Ensure that the new website content is build locally</p>
+<div class="highlight"><pre><code class="language-" data-lang="">jekyll build
+</code></pre></div>
+<p>This will read the sources and generate the new content in the <code>./staging</code> directory.</p>
+
+<p>Upload the new content to the production site</p>
+<div class="highlight"><pre><code class="language-" data-lang="">mvn scm-publish:publish-scm
+</code></pre></div>
+<p>This will checkout the current content into the <code>./target</code>directory, apply the changes from <code>./staging</code> and publish
+the changes to the PDFBox production website.</p>
+
+<h3 id="update-the-javadocs-for-pdfbox-2-x">Update the JavaDocs for PDFBOX 2.x</h3>
+
+<p>To publish the javadocs follow these steps:</p>
+
+<p>Run</p>
+<div class="highlight"><pre><code class="language-" data-lang="">$ mvn clean javadoc:aggregate scm-publish:publish-scm
+</code></pre></div>
+<p>from the <code><SVN_ROOT>/../pdfbox</code> directory.</p>
+
+<p>It uses the same <code>pdfbox-site</code> settings from above to connect to the repository.</p>
+
+<p class="alert alert-info">As <code>mvn clean</code> will delete the javadoc files download from the Apache CMS it's advised to configure <code>${svn.scmJavadocCheckoutDirectory}</code> to a local directory not below <code>./target</code>.</p>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/support.html
----------------------------------------------------------------------
diff --git a/content/support.html b/content/support.html
new file mode 100644
index 0000000..619bc49
--- /dev/null
+++ b/content/support.html
@@ -0,0 +1,247 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Support</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="support">Support</h1>
+
+<h2 id="questions-about-how-to-use-pdfbox">Questions about How to use PDFBox</h2>
+
+<p>If you have questions about how to use PDFBox do ask on the <a href="/mailinglists.html" title="Subscribe to Mailing List">Users Mailing List</a>. This will get you help from the entire community.</p>
+
+<p>The PDFBox examples and the test code in the sources will also provide additional information.</p>
+
+<p>And there are additonal resources available on sites such as <a href="http://stackoverflow.com/search?q=pdfbox" title="Stack Overflow">Stack Overflow</a>.</p>
+
+<h2 id="filing-a-bug-report-or-enhancement-request">Filing a bug report or enhancement request</h2>
+
+<p class="alert alert-info">Please refrain from immediately opening a ticket in the issue tracker unless
+you are really certain it's a problem in the PDFBox software. Try using the Mailing Lists
+before.</p>
+
+<p>If you are sure you have found a bug the please report the problem in our
+<a href="https://issues.apache.org/jira/browse/PDFBOX">Issue Tracker</a>. </p>
+
+<p><strong>Before you submit a bug there are several things you can try first</strong></p>
+
+<ul>
+<li>for issues with text extraction try if Adobe Reader can extract the text</li>
+<li>try the latest SNAPSHOT to see if it's fixed in the pre-release</li>
+<li>search the mailing list to see if has been discussed before</li>
+<li>check the issue tracker to see if the issue has already been reported</li>
+</ul>
+
+<p><strong>To help us resolving a bug quicker</strong></p>
+
+<ul>
+<li>attach the PDF that makes trouble by using "More", "Attach files" in the issue tracker</li>
+<li>if your file is too large, upload it to a sharehoster, or use the PDFSplit application to isolate the troublesome page</li>
+<li>mention the PDFBox version you are using.</li>
+<li>attach the shortest possible code that reproduces the problem. Insert java code between {code}...{code}. Or try to reproduce the problem with the command line applications.</li>
+<li>mention what you were doing, what was the expected behaviour, and what happened instead</li>
+<li>provide a stack trace of an exception if there is one</li>
+<li>try using the non-sequential parser (loadNonSeq() instead of load(), and "-nonSeq" with the command line applications)</li>
+<li>search JIRA if your problem has been mentioned before.</li>
+<li>Be patient: all the people here are unpaid volunteers who work for you in their free time</li>
+</ul>
+
+<p><strong>And please DON'T</strong></p>
+
+<ul>
+<li>upload files to a hoster that requires registration to read the file.</li>
+<li>create an issue in JIRA and then go on vacation so you won't repond to our questions / suggestions.</li>
+<li>ask "how to" questions in JIRA. Ask such questions on the mailing lists, on stackoverflow.com, and look at the sample and the test code in the sources.</li>
+<li>attach PDF files with confidential and/or personal data (name, DoB, bank data, health data, SSN) without getting permission from the client and/or the people mentioned on the PDF</li>
+<li>create issues about obsolete PDFBox versions</li>
+</ul>
+
+<p class="alert alert-info">We can sometimes solve problems without having the PDF, but it is difficult.</p>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/team.html
----------------------------------------------------------------------
diff --git a/content/team.html b/content/team.html
new file mode 100644
index 0000000..caa2db9
--- /dev/null
+++ b/content/team.html
@@ -0,0 +1,318 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Project Team</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="project-team">Project Team</h1>
+
+<p>A successful project requires many people to play many roles. Some members write code or documentation, while others are valuable as testers,
+submitting patches and suggestions.</p>
+
+<p>The team is comprised of Members and Contributors. Members have direct access to the source of a project and actively evolve the code-base.
+Contributors improve the project through submission of patches and suggestions to the Members. The number of Contributors to the project is unbounded.
+Get involved today. All contributions to the project are greatly appreciated.</p>
+
+<h2 id="members">Members</h2>
+
+<p>The following is a list of developers with commit privileges that have directly contributed to the project in one way or another.</p>
+
+<table><thead>
+<tr>
+<th>Id</th>
+<th>Name</th>
+<th>Roles</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>adam</td>
+<td>Adam Nichols</td>
+<td>PMC Member</td>
+</tr>
+<tr>
+<td>lehmi</td>
+<td>Andreas Lehmkühler</td>
+<td>PMC Chair</td>
+</tr>
+<tr>
+<td>blitchfield</td>
+<td>Ben Litchfield</td>
+<td>PMC Member</td>
+</tr>
+<tr>
+<td>carrier</td>
+<td>Brian Carrier</td>
+<td>PMC Member</td>
+</tr>
+<tr>
+<td>danielwilson</td>
+<td>Daniel Wilson</td>
+<td>PMC Member</td>
+</tr>
+<tr>
+<td>gbailleul</td>
+<td>Guillaume Bailleul</td>
+<td>PMC Member</td>
+</tr>
+<tr>
+<td>jeremias</td>
+<td>Jeremias Maerki</td>
+<td>PMC Member</td>
+</tr>
+<tr>
+<td>koch</td>
+<td>Johannes Koch</td>
+<td>PMC Member</td>
+</tr>
+<tr>
+<td>jahewson</td>
+<td>John Hewson</td>
+<td>PMC Member</td>
+</tr>
+<tr>
+<td>kjackson</td>
+<td>Kevin Jackson</td>
+<td>PMC Member</td>
+</tr>
+<tr>
+<td>msahyoun</td>
+<td>Maruan Sahyoun</td>
+<td>PMC Member</td>
+</tr>
+<tr>
+<td>pkoch</td>
+<td>Phillipp Koch</td>
+<td>PMC Member</td>
+</tr>
+<tr>
+<td>tchojecki</td>
+<td>Thomas Chojecki</td>
+<td>PMC Member</td>
+</tr>
+<tr>
+<td>tboehme</td>
+<td>Timo Boehme</td>
+<td>PMC Member</td>
+</tr>
+<tr>
+<td>tilman</td>
+<td>Tilman Hausherr</td>
+<td>PMC Member</td>
+</tr>
+<tr>
+<td>vfed</td>
+<td>Villu Ruusmann</td>
+<td>PMC Member</td>
+</tr>
+</tbody></table>
+
+<h2 id="emeritus-members">Emeritus members</h2>
+
+<p>The following is a list of former developers going emeritus from the PDFBox PMC.</p>
+
+<table><thead>
+<tr>
+<th>Id</th>
+<th>Name</th>
+<th>Roles</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>leleueri</td>
+<td>Eric Leleu</td>
+<td></td>
+</tr>
+<tr>
+<td>jukka</td>
+<td>Jukka Zitting</td>
+<td></td>
+</tr>
+</tbody></table>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
[5/6] pdfbox-docs git commit: Site checkin for project Apache PDFBox
Website
Posted by ms...@apache.org.
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/1.8/cookbook/pdfacreation.html
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/pdfacreation.html b/content/1.8/cookbook/pdfacreation.html
new file mode 100644
index 0000000..382c1fc
--- /dev/null
+++ b/content/1.8/cookbook/pdfacreation.html
@@ -0,0 +1,239 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Create a valid PDF/A document</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="pdf-a-creation">PDF/A Creation</h1>
+
+<p>The Apache PDFBox API can be used to create a PDF/A File. PDF/A is a PDF file with some constraints to ensure its
+long time conservation. These constraints are described in ISO 19005.</p>
+
+<p>This small sample shows what should be added during creation of a PDF file to transform it in a valid PDF/A
+document. The current example creates a valid PDF/A-1b document.</p>
+
+<h2 id="load-all-the-fonts-used-in-document">Load all the fonts used in document</h2>
+
+<p>The PDF/A specification enforces that the fonts used in the document are present in the PDF File. You
+have to load them. As an example:</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">InputStream</span> <span class="n">fontStream</span> <span class="o">=</span> <span class="n">CreatePDFA</span><span class="o">.</span><span class="na">class</span><span class="o">.</span><span class="na">getResourceAsStream</span><span class="o">(</span><span class="s">"/org/apache/pdfbox/resources/ttf/ArialMT.ttf"</span><span class="o">);</span>
+<span class="n">PDFont</span> <span class="n">font</span> <span class="o">=</span> <span class="n">PDTrueTypeFont</span><span class="o">.</span><span class="na">loadTTF</span><span class="o">(</span><span class="n">doc</span><span class="o">,</span> <span class="n">fontStream</span><span class="o">);</span>
+</code></pre></div>
+<h2 id="including-xmp-metadata-block">Including XMP metadata block</h2>
+
+<p>It is imposed to have xmp metadata defined in the PDF. At least, the PDFA Schema (giving details on the version
+of PDF/A specification reached by the document) must be present. These lines create the xmp metadata for a
+PDF/A-1b document:</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">XMPMetadata</span> <span class="n">xmp</span> <span class="o">=</span> <span class="k">new</span> <span class="n">XMPMetadata</span><span class="o">();</span>
+<span class="n">XMPSchemaPDFAId</span> <span class="n">pdfaid</span> <span class="o">=</span> <span class="k">new</span> <span class="n">XMPSchemaPDFAId</span><span class="o">(</span><span class="n">xmp</span><span class="o">);</span>
+<span class="n">xmp</span><span class="o">.</span><span class="na">addSchema</span><span class="o">(</span><span class="n">pdfaid</span><span class="o">);</span>
+<span class="n">pdfaid</span><span class="o">.</span><span class="na">setConformance</span><span class="o">(</span><span class="s">"B"</span><span class="o">);</span>
+<span class="n">pdfaid</span><span class="o">.</span><span class="na">setPart</span><span class="o">(</span><span class="mi">1</span><span class="o">);</span>
+<span class="n">pdfaid</span><span class="o">.</span><span class="na">setAbout</span><span class="o">(</span><span class="s">""</span><span class="o">);</span>
+<span class="n">metadata</span><span class="o">.</span><span class="na">importXMPMetadata</span><span class="o">(</span><span class="n">xmp</span><span class="o">);</span>
+</code></pre></div>
+<h2 id="including-color-profile">Including color profile</h2>
+
+<p>It is mandatory to include the color profile used by the document. Different profiles can be used. This
+example takes one present in pdfbox:</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="c1">// create output intent</span>
+<span class="n">InputStream</span> <span class="n">colorProfile</span> <span class="o">=</span> <span class="n">CreatePDFA</span><span class="o">.</span><span class="na">class</span><span class="o">.</span><span class="na">getResourceAsStream</span><span class="o">(</span><span class="s">"/org/apache/pdfbox/resources/pdfa/sRGB Color Space Profile.icm"</span><span class="o">);</span>
+<span class="n">PDOutputIntent</span> <span class="n">oi</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDOutputIntent</span><span class="o">(</span><span class="n">doc</span><span class="o">,</span> <span class="n">colorProfile</span><span class="o">);</span>
+<span class="n">oi</span><span class="o">.</span><span class="na">setInfo</span><span class="o">(</span><span class="s">"sRGB IEC61966-2.1"</span><span class="o">);</span>
+<span class="n">oi</span><span class="o">.</span><span class="na">setOutputCondition</span><span class="o">(</span><span class="s">"sRGB IEC61966-2.1"</span><span class="o">);</span>
+<span class="n">oi</span><span class="o">.</span><span class="na">setOutputConditionIdentifier</span><span class="o">(</span><span class="s">"sRGB IEC61966-2.1"</span><span class="o">);</span>
+<span class="n">oi</span><span class="o">.</span><span class="na">setRegistryName</span><span class="o">(</span><span class="s">"http://www.color.org"</span><span class="o">);</span>
+<span class="n">cat</span><span class="o">.</span><span class="na">addOutputIntent</span><span class="o">(</span><span class="n">oi</span><span class="o">);</span>
+</code></pre></div>
+<h2 id="complete-example">Complete example</h2>
+
+<p>The complete example can be found in pdfbox-example. The source file is</p>
+<div class="highlight"><pre><code class="language-" data-lang="">src/main/java/org/apache/pdfbox/examples/pdfa/CreatePDFA.java
+</code></pre></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/1.8/cookbook/pdfavalidation.html
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/pdfavalidation.html b/content/1.8/cookbook/pdfavalidation.html
new file mode 100644
index 0000000..2f15089
--- /dev/null
+++ b/content/1.8/cookbook/pdfavalidation.html
@@ -0,0 +1,299 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Cookbook - PDF/A Validation</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="pdf-a-validation">PDF/A Validation</h1>
+
+<p>The Apache Preflight library is a Java tool that implements a parser compliant with the ISO-19005 specification (aka PDF/A-1).
+Check Compliance with PDF/A-1b</p>
+
+<p>This small sample shows how to check the compliance of a file with the PDF/A-1b specification.</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">ValidationResult</span> <span class="n">result</span> <span class="o">=</span> <span class="kc">null</span><span class="o">;</span>
+
+<span class="n">FileDataSource</span> <span class="n">fd</span> <span class="o">=</span> <span class="k">new</span> <span class="n">FileDataSource</span><span class="o">(</span><span class="n">args</span><span class="o">[</span><span class="mi">0</span><span class="o">]);</span>
+<span class="n">PreflightParser</span> <span class="n">parser</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PreflightParser</span><span class="o">(</span><span class="n">fd</span><span class="o">);</span>
+<span class="k">try</span>
+<span class="o">{</span>
+
+ <span class="cm">/* Parse the PDF file with PreflightParser that inherits from the NonSequentialParser.
+ * Some additional controls are present to check a set of PDF/A requirements.
+ * (Stream length consistency, EOL after some Keyword...)
+ */</span>
+ <span class="n">parser</span><span class="o">.</span><span class="na">parse</span><span class="o">();</span>
+
+ <span class="cm">/* Once the syntax validation is done,
+ * the parser can provide a PreflightDocument
+ * (that inherits from PDDocument)
+ * This document process the end of PDF/A validation.
+ */</span>
+ <span class="n">PreflightDocument</span> <span class="n">document</span> <span class="o">=</span> <span class="n">parser</span><span class="o">.</span><span class="na">getPreflightDocument</span><span class="o">();</span>
+ <span class="n">document</span><span class="o">.</span><span class="na">validate</span><span class="o">();</span>
+
+ <span class="c1">// Get validation result</span>
+ <span class="n">result</span> <span class="o">=</span> <span class="n">document</span><span class="o">.</span><span class="na">getResult</span><span class="o">();</span>
+ <span class="n">document</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+
+<span class="o">}</span>
+<span class="k">catch</span> <span class="o">(</span><span class="n">SyntaxValidationException</span> <span class="n">e</span><span class="o">)</span>
+<span class="o">{</span>
+ <span class="cm">/* the parse method can throw a SyntaxValidationException
+ * if the PDF file can't be parsed.
+ * In this case, the exception contains an instance of ValidationResult
+ */</span>
+ <span class="n">result</span> <span class="o">=</span> <span class="n">e</span><span class="o">.</span><span class="na">getResult</span><span class="o">();</span>
+<span class="o">}</span>
+
+<span class="c1">// display validation result</span>
+<span class="k">if</span> <span class="o">(</span><span class="n">result</span><span class="o">.</span><span class="na">isValid</span><span class="o">())</span>
+<span class="o">{</span>
+ <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"The file "</span> <span class="o">+</span> <span class="n">args</span><span class="o">[</span><span class="mi">0</span><span class="o">]</span> <span class="o">+</span> <span class="s">" is a valid PDF/A-1b file"</span><span class="o">);</span>
+<span class="o">}</span>
+<span class="k">else</span>
+<span class="o">{</span>
+ <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"The file"</span> <span class="o">+</span> <span class="n">args</span><span class="o">[</span><span class="mi">0</span><span class="o">]</span> <span class="o">+</span> <span class="s">" is not valid, error(s) :"</span><span class="o">);</span>
+ <span class="k">for</span> <span class="o">(</span><span class="n">ValidationError</span> <span class="n">error</span> <span class="o">:</span> <span class="n">result</span><span class="o">.</span><span class="na">getErrorsList</span><span class="o">())</span>
+ <span class="o">{</span>
+ <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="n">error</span><span class="o">.</span><span class="na">getErrorCode</span><span class="o">()</span> <span class="o">+</span> <span class="s">" : "</span> <span class="o">+</span> <span class="n">error</span><span class="o">.</span><span class="na">getDetails</span><span class="o">());</span>
+ <span class="o">}</span>
+<span class="o">}</span>
+</code></pre></div>
+<h2 id="categories-of-validation-error">Categories of Validation Error</h2>
+
+<p>If a validation fails, the ValidationResult object contains all causes of the failure.
+In order to help in the failure understanding, all error codes have the following form X[.Y[.Z]] where :</p>
+
+<ul>
+<li>'X' is the category (ex : Font validation error...)</li>
+<li>'Y' represent a subsection of the category (ex : "Font with Glyph error")</li>
+<li>'Z' represent the cause of the error (ex : "Font with a missing Glyph")</li>
+</ul>
+
+<p>Category ('Y') and cause ('Z') may be missing according to the difficulty to identify the error detail.</p>
+
+<p>Here after, you can find all Categories (for detailed cause, see constants in the <code>PreflightConstants</code> interface) :</p>
+
+<table><thead>
+<tr>
+<th>Category</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>1[.y[.z]]</td>
+<td>Syntax Error</td>
+</tr>
+<tr>
+<td>2[.y[.z]]</td>
+<td>Graphic Error</td>
+</tr>
+<tr>
+<td>3[.y[.z]]</td>
+<td>Font Error</td>
+</tr>
+<tr>
+<td>4[.y[.z]]</td>
+<td>Transparency Error</td>
+</tr>
+<tr>
+<td>5[.y[.z]]</td>
+<td>Annotation Error</td>
+</tr>
+<tr>
+<td>6[.y[.z]]</td>
+<td>Action Error</td>
+</tr>
+<tr>
+<td>7[.y[.z]]</td>
+<td>Metadata Error</td>
+</tr>
+</tbody></table>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/1.8/cookbook/rendering.html
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/rendering.html b/content/1.8/cookbook/rendering.html
new file mode 100644
index 0000000..e70c066
--- /dev/null
+++ b/content/1.8/cookbook/rendering.html
@@ -0,0 +1,233 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Cookbook - Rendering</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="document-rendering">Document Rendering</h1>
+
+<h2 id="convert-a-document-to-images">Convert a document to images</h2>
+
+<p>This small sample shows how to render (convert to images) a PDF document using PDFBox.</p>
+<div class="highlight"><pre><code class="language-" data-lang="">:::java
+ String filename = "YOURFILENAMEHERE.pdf";
+
+ // open the document
+ PDDocument doc = PDDocument.loadNonSeq(new File(filename), null);
+
+ boolean b;
+ List<PDPage> pages = doc.getDocumentCatalog().getAllPages();
+ for (int p = 0; p < pages.size(); ++p)
+ {
+ // RGB image with 300 dpi
+ BufferedImage bim = pages.get(p).convertToImage(BufferedImage.TYPE_INT_RGB, 300);
+
+ // save as PNG with default metadata
+ b = ImageIO.write(bim, "png", new File("rgbpage" + (p+1) + ".png"));
+ if (!b)
+ {
+ // error handling
+ }
+
+ // B/W image with 300 dpi
+ bim = pages.get(p).convertToImage(BufferedImage.TYPE_BYTE_BINARY, 300);
+
+ // save as TIF with dpi in the metadata
+ // PDFBox will choose the best compression for you - here: CCITT G4
+ // you need to add jai_imageio.jar to your classpath for this to work
+ b = ImageIOUtil.writeImage(bim, "bwpage-" + (p+1) + ".tif", 300);
+ if (!b)
+ {
+ // error handling
+ }
+ }
+
+ doc.close();
+</code></pre></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/1.8/cookbook/textextraction.html
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/textextraction.html b/content/1.8/cookbook/textextraction.html
new file mode 100644
index 0000000..a7ed24b
--- /dev/null
+++ b/content/1.8/cookbook/textextraction.html
@@ -0,0 +1,320 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Cookbook - Textextraction</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="textextraction">Textextraction</h1>
+
+<h2 id="extracting-text">Extracting Text</h2>
+
+<p>See class:org.apache.pdfbox.util.PDFTextStripper<br>
+See class:org.apache.pdfbox.searchengine.lucene.LucenePDFDocument<br>
+See command line app:ExtractText </p>
+
+<p>One of the main features of PDFBox is its ability to quickly and accurately extract text
+from a variety of PDF documents. This functionality is encapsulated in the
+org.apache.pdfbox.util.PDFTextStripper and can be easily executed on the command line with
+org.apache.pdfbox.ExtractText.</p>
+
+<h2 id="lucene-integration">Lucene Integration</h2>
+
+<p>Lucene is an open source text search library from the Apache Jakarta Project. In order for
+Lucene to be able to index a PDF document it must first be converted to text. PDFBox provides
+a simple approach for adding PDF documents into a Lucene index.</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">Document</span> <span class="n">luceneDocument</span> <span class="o">=</span> <span class="n">LucenePDFDocument</span><span class="o">.</span><span class="na">getDocument</span><span class="o">(</span> <span class="o">...</span> <span class="o">);</span>
+</code></pre></div>
+<p>Now that you hava a Lucene Document object, you can add it to the Lucene index just like
+you would if it had been created from a text or HTML file. The LucenePDFDocument automatically
+extracts a variety of metadata fields from the PDF to be added to the index, the javadoc
+shows details on those fields. This approach is very simple and should be sufficient for
+most users, if not then you can use some of the advanced text extraction techniques
+described in the next section.</p>
+
+<h2 id="advanced-text-extraction">Advanced Text Extraction</h2>
+
+<p>Some applications will have complex text extraction requiments and neither the command
+line application nor the LucenePDFDocument will be able to fulfill those requirements.
+It is possible for users to utilize or extend the PDFTextStripper class to meet some of
+these requirements.</p>
+
+<h3 id="limiting-the-extracted-text">Limiting The Extracted Text</h3>
+
+<p>There are several ways that we can limit the text that is extracted during the extraction
+process. The simplest is to specify the range of pages that you want to be extracted.
+For example, to only extract text from the second and third pages of the PDF document
+you could do this:</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">PDFTextStripper</span> <span class="n">stripper</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDFTextStripper</span><span class="o">();</span>
+<span class="n">stripper</span><span class="o">.</span><span class="na">setStartPage</span><span class="o">(</span> <span class="mi">2</span> <span class="o">);</span>
+<span class="n">stripper</span><span class="o">.</span><span class="na">setEndPage</span><span class="o">(</span> <span class="mi">3</span> <span class="o">);</span>
+<span class="n">stripper</span><span class="o">.</span><span class="na">writeText</span><span class="o">(</span> <span class="o">...</span> <span class="o">);</span>
+</code></pre></div>
+<p>NOTE: The startPage and endPage properties of PDFTextStripper are 1 based and inclusive.</p>
+
+<p>If you wanted to start on page 2 and extract to the end of the document then you would just
+set the startPage property. By default all pages in the pdf document are extracted.</p>
+
+<p>It is also possible to limit the extracted text to be between two bookmarks in the page.
+If you are not familiar with how to use bookmarks in PDFBox then you should review the
+Bookmarks page. Similar to the startPage/endPage properties, PDFTextStripper also has
+startBookmark/endBookmark properties. There are some caveats to be aware of when using this
+feature of the PDFTextStripper. Not all bookmarks point to a page in the current PDF document. </p>
+
+<p>The possible states of a bookmark are:</p>
+
+<ul>
+<li>null - The property was not set, this is the default.</li>
+<li>Points to page in the PDF - The property was set and points to a valid page in the PDF</li>
+<li>Bookmark does not point to anything - The property was set but the bookmark does not point to any page</li>
+<li>Bookmark points to external action - The property was set, but it points to a page in a different PDF or performs an action when activated</li>
+</ul>
+
+<p>The table below will describe how PDFBox behaves in the various scenarios:</p>
+
+<table><thead>
+<tr>
+<th>Start Bookmark</th>
+<th>End Bookmark</th>
+<th>Result</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>null</td>
+<td>null</td>
+<td>This is the default, the properties have no effect on the text extraction.</td>
+</tr>
+<tr>
+<td>Points to a page in the PDF</td>
+<td>null</td>
+<td>Text extraction will begin on the page that this bookmark points to and go until the end of the document.</td>
+</tr>
+<tr>
+<td>null</td>
+<td>Points to a page in the PDF</td>
+<td>Text extraction will begin on the first page and stop at the end of the page that this bookmark points to.</td>
+</tr>
+<tr>
+<td>Bookmark does not point to anything</td>
+<td>null</td>
+<td>Because the PDFTextStripper cannot determine a start page based on the bookmark, it will start on the first page and go until the end of the document.</td>
+</tr>
+<tr>
+<td>null</td>
+<td>Bookmark does not point to anything</td>
+<td>Because the PDFTextStripper cannot determine a end page based on the bookmark, it will start on the first page and go until the end of the document.</td>
+</tr>
+<tr>
+<td>Bookmark does not point to anything</td>
+<td>Bookmark does not point to anything</td>
+<td>This is a special case! If the startBookmark and endBookmark are exactly the same then no text will be extracted. If they are different then it is not possible for the PDFTextStripper to determine that pages so it will include the entire document.</td>
+</tr>
+<tr>
+<td>Bookmark points to external action</td>
+<td>Bookmark points to external action</td>
+<td>If either the startBookmark or the endBookmark refer to an external page or execute an action then an OutlineNotLocalException will be thrown to indicate to the user that the bookmark is not valid.</td>
+</tr>
+</tbody></table>
+
+<p>NOTE: PDFTextStripper will check both the startPage/endPage and the startBookmark/endBookmark to determine if text should be extracted from the current page.</p>
+
+<h3 id="external-glyph-list">External Glyph List</h3>
+
+<p>Some PDF files need to map between glyph names and Unicode values during text extraction.
+PDFBox comes with an Adobe Glyph List, but you may encounter files with glyph names that
+are not in that map. To use your own glyphlist file, supply the file name to the <code>glyphlist_ext</code> JVM property.</p>
+
+<h3 id="right-to-left-text">Right to Left Text</h3>
+
+<p>Extracting text in languages whose text goes from right to left (such as Arabic and Hebrew)
+in PDF files can result in text that is backwards. PDFBox can normalize and reverse the text
+if the ICU4J jar file has been placed on the classpath (it is an optional dependency).
+Note that you should also enable sorting with either org.apache.pdfbox.util.PDFTextStripper
+or org.apache.pdfbox.ExtractText to ensure accurate output.</p>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/1.8/cookbook/workingwithattachments.html
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/workingwithattachments.html b/content/1.8/cookbook/workingwithattachments.html
new file mode 100644
index 0000000..ab8a431
--- /dev/null
+++ b/content/1.8/cookbook/workingwithattachments.html
@@ -0,0 +1,240 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Cookbook - Working with Attachments</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="working-with-attachments">Working with Attachments</h1>
+
+<h2 id="the-pdf-file-specification">The PDF File Specification</h2>
+
+<p>See package:org.apache.pdfbox.pdmodel.common.filespecification<br>
+See example:EmbeddedFiles </p>
+
+<p>A PDF can contain references to external files via the file system or a URL to a remote
+location. It is also possible to embed a binary file into a PDF document.</p>
+
+<p>There are two classes that can be used when referencing a file. <code>PDSimpleFileSpecification</code>
+is a simple string reference to a file(e.g. "./movies/BigMovie.avi"). The simple file
+specification does not allow for any parameters to be set. </p>
+
+<p>The <code>PDComplexFileSpecification</code> is more feature rich and allows for advanced settings on
+the file reference.</p>
+
+<p>It is also possible to embed a file directly into a PDF. Instead of setting the file
+attribute of the <code>PDComplexFileSpecification</code>, the <code>EmbeddedFile</code> attribute can be used instead.</p>
+
+<h2 id="adding-a-file-attachment">Adding a File Attachment</h2>
+
+<p>PDF documents can contain file attachments that are accessed from the Document->File Attachments
+menu. PDFBox allows attachments to be added to and extracted from PDF documents.
+Attachments are part of the named tree that is attached to the document catalog.</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">PDEmbeddedFilesNameTreeNode</span> <span class="n">efTree</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDEmbeddedFilesNameTreeNode</span><span class="o">();</span>
+
+<span class="c1">//first create the file specification, which holds the embedded file</span>
+<span class="n">PDComplexFileSpecification</span> <span class="n">fs</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDComplexFileSpecification</span><span class="o">();</span>
+<span class="n">fs</span><span class="o">.</span><span class="na">setFile</span><span class="o">(</span> <span class="s">"Test.txt"</span> <span class="o">);</span>
+<span class="n">InputStream</span> <span class="n">is</span> <span class="o">=</span> <span class="o">...;</span>
+<span class="n">PDEmbeddedFile</span> <span class="n">ef</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDEmbeddedFile</span><span class="o">(</span><span class="n">doc</span><span class="o">,</span> <span class="n">is</span> <span class="o">);</span>
+<span class="c1">//set some of the attributes of the embedded file</span>
+<span class="n">ef</span><span class="o">.</span><span class="na">setSubtype</span><span class="o">(</span> <span class="s">"test/plain"</span> <span class="o">);</span>
+<span class="n">ef</span><span class="o">.</span><span class="na">setSize</span><span class="o">(</span> <span class="n">data</span><span class="o">.</span><span class="na">length</span> <span class="o">);</span>
+<span class="n">ef</span><span class="o">.</span><span class="na">setCreationDate</span><span class="o">(</span> <span class="k">new</span> <span class="n">GregorianCalendar</span><span class="o">()</span> <span class="o">);</span>
+<span class="n">fs</span><span class="o">.</span><span class="na">setEmbeddedFile</span><span class="o">(</span> <span class="n">ef</span> <span class="o">);</span>
+
+<span class="c1">//now add the entry to the embedded file tree and set in the document.</span>
+<span class="n">Map</span> <span class="n">efMap</span> <span class="o">=</span> <span class="k">new</span> <span class="n">HashMap</span><span class="o">();</span>
+<span class="n">efMap</span><span class="o">.</span><span class="na">put</span><span class="o">(</span> <span class="s">"My first attachment"</span><span class="o">,</span> <span class="n">fs</span> <span class="o">);</span>
+<span class="n">efTree</span><span class="o">.</span><span class="na">setNames</span><span class="o">(</span> <span class="n">efMap</span> <span class="o">);</span>
+<span class="c1">//attachments are stored as part of the "names" dictionary in the document catalog</span>
+<span class="n">PDDocumentNameDictionary</span> <span class="n">names</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDDocumentNameDictionary</span><span class="o">(</span> <span class="n">doc</span><span class="o">.</span><span class="na">getDocumentCatalog</span><span class="o">()</span> <span class="o">);</span>
+<span class="n">names</span><span class="o">.</span><span class="na">setEmbeddedFiles</span><span class="o">(</span> <span class="n">efTree</span> <span class="o">);</span>
+<span class="n">doc</span><span class="o">.</span><span class="na">getDocumentCatalog</span><span class="o">().</span><span class="na">setNames</span><span class="o">(</span> <span class="n">names</span> <span class="o">);</span>
+</code></pre></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
[6/6] pdfbox-docs git commit: Site checkin for project Apache PDFBox
Website
Posted by ms...@apache.org.
Site checkin for project Apache PDFBox Website
Project: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/commit/aa929f46
Tree: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/tree/aa929f46
Diff: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/diff/aa929f46
Branch: refs/heads/asf-site
Commit: aa929f46c95f9607589e3e7a4a6f2e24e32ed4b9
Parents: 3f67f8b
Author: Maruan Sahyoun <sa...@fileaffairs.de>
Authored: Mon Nov 16 19:57:32 2015 +0100
Committer: Maruan Sahyoun <sa...@fileaffairs.de>
Committed: Mon Nov 16 19:57:32 2015 +0100
----------------------------------------------------------------------
content/1.8/architecture.html | 342 +++++++++
content/1.8/commandline.html | 750 +++++++++++++++++++
content/1.8/cookbook/documentcreation.html | 240 ++++++
content/1.8/cookbook/encryption.html | 221 ++++++
content/1.8/cookbook/fill-form-field.html | 234 ++++++
content/1.8/cookbook/pdfacreation.html | 239 ++++++
content/1.8/cookbook/pdfavalidation.html | 299 ++++++++
content/1.8/cookbook/rendering.html | 233 ++++++
content/1.8/cookbook/textextraction.html | 320 ++++++++
.../1.8/cookbook/workingwithattachments.html | 240 ++++++
content/1.8/cookbook/workingwithfonts.html | 355 +++++++++
content/1.8/cookbook/workingwithmetadata.html | 248 ++++++
content/1.8/dependencies.html | 288 +++++++
content/1.8/faq.html | 320 ++++++++
content/2.0/commandline.html | 695 +++++++++++++++++
content/2.0/cookbook/encryption.html | 221 ++++++
content/2.0/dependencies.html | 247 ++++++
content/2.0/examples.html | 199 +++++
content/2.0/getting-started.html | 220 ++++++
content/2.0/migration.html | 369 +++++++++
content/building.html | 264 +++++++
content/codingconventions.html | 306 ++++++++
content/errors/403.html | 206 +++++
content/errors/404.html | 206 +++++
content/ideas.html | 280 +++++++
content/index.html | 256 +++++++
content/mailinglists.html | 251 +++++++
content/references.html | 360 +++++++++
content/siteupdate.html | 263 +++++++
content/support.html | 247 ++++++
content/team.html | 318 ++++++++
31 files changed, 9237 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/1.8/architecture.html
----------------------------------------------------------------------
diff --git a/content/1.8/architecture.html b/content/1.8/architecture.html
new file mode 100644
index 0000000..8f33bbe
--- /dev/null
+++ b/content/1.8/architecture.html
@@ -0,0 +1,342 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Architecture</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="architecture">Architecture</h1>
+
+<p>In order to get the most out of PDFBox it is neccessary to understand how a PDF document
+is organized as PDFBox was architected around the concepts layed out in the
+ISO-32000 (PDF) Specification</p>
+
+<ul>
+<li><a href="http://www.iso.org/iso/catalogue_detail.htm?csnumber=51502">ISO Site</a></li>
+<li><a href="http://wwwimages.adobe.com/www.adobe.com/content/dam/Adobe/en/devnet/pdf/pdfs/PDF32000_2008.pdf">Adobe Version</a></li>
+</ul>
+
+<h2 id="quick-introduction-to-the-pdf-format">Quick Introduction to the PDF format</h2>
+
+<p>A PDF file is made up of a sequence of bytes. These bytes, grouped into tokens,
+make up the basic objects upon which higher level objects and structures are built [see ISO-32000 7.3].</p>
+
+<p class="alert alert-info">PDFBox makes these basic objects available in the
+*org.apache.pdfbox.cos* package (The COS Model).
+</p>
+
+<p>The organization of these objects, how to they are read and how to write them is defined in the file structure of the
+PDF [see ISO-32000 7.5]. In addition a file can be encrpyted to protect the document's content [see ISO-32000 7.5].</p>
+
+<p class="alert alert-info">PDFBox handles the reading in the *org.apache.pdfbox.pdfparser* package.
+Writing of PDF files is handled in the *org.apache.pdfbox.pdfwriter* package.
+</p>
+
+<p>Within the file structure basic objects are used to create a document structure building higher level objects such
+as pages, bookmarks, annotations [see ISO-32000 7.7].</p>
+
+<p class="alert alert-info">PDFBox makes these higher level objects available through the
+*org.apache.pdfbox.pdfmodel* package (The PD Model).
+</p>
+
+<p>In addition there is a COS representation available for the PD model if there is a need to
+inspect the underlying structure or to handle special cases where the higher level PD model
+doesn't provide the functionality needed.</p>
+
+<p class="alert alert-info">It's always the COS model which is represented in the PDF file.</p>
+
+<h2 id="the-cos-model">The COS Model</h2>
+
+<p>As outlined above the basic PDF objects are represented in PDFBox in the org.apache.pdfbox.cos package.</p>
+
+<table><thead>
+<tr>
+<th>PDF Type</th>
+<th>Description</th>
+<th>Example</th>
+<th>PDFBox class</th>
+<th>ISO 32000</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>Boolean</td>
+<td>Standard True/False values</td>
+<td>true</td>
+<td>org.apache.pdfbox.cos.COSBoolean</td>
+<td>7.3.2</td>
+</tr>
+<tr>
+<td>Number</td>
+<td>Integer and floating point numbers</td>
+<td>1 2.3</td>
+<td>org.apache.pdfbox.cos.COSInteger<br/>org.apache.pdfbox.cos.COSFloat</td>
+<td>7.3.3</td>
+</tr>
+<tr>
+<td>String</td>
+<td>A sequence of characters</td>
+<td>(This is a string)</td>
+<td>org.apache.pdfbox.cos.COSString</td>
+<td>7.3.4</td>
+</tr>
+<tr>
+<td>Name</td>
+<td>A predefined value in a PDF document, typically used as a key in a dictionary</td>
+<td>/Type</td>
+<td>org.apache.pdfbox.cos.COSName</td>
+<td>7.3.5</td>
+</tr>
+<tr>
+<td>Array</td>
+<td>Arrays are one-dimensional lists of objects accessed by a numeric index. Within an array each basic object is permitted as an entry.</td>
+<td>[549 3.14 false (Ralph) /SomeName]</td>
+<td>org.apache.pdfbox.cos.COSArray</td>
+<td>7.3.6</td>
+</tr>
+<tr>
+<td>Dictionary</td>
+<td>A map of name value pairs</td>
+<td><<<br/>/Type /XObject<br/>/Name (Name)</br>/Size 1</br>>></td>
+<td>org.apache.pdfbox.cos.COSDictionary</td>
+<td>7.3.7</td>
+</tr>
+<tr>
+<td>Stream</td>
+<td>A stream of data, typically compressed. This is used for page contents, images and embedded font streams.</td>
+<td>12 0 obj << /Type /XObject >> stream 030004040404040404 endstream</td>
+<td>org.apache.pdfbox.cos.COSStream</td>
+<td>7.3.8</td>
+</tr>
+<tr>
+<td>Object</td>
+<td>A wrapper to any of the other objects, this can be used to reference an object multiple times. An object is referenced by using two numbers, an object number and a generation number. Initially the generation number will be zero unless the object got replaced later in the stream.</td>
+<td>12 0 obj << /Type /XObject >> endobj</td>
+<td>org.apache.pdfbox.cos.COSObject</td>
+<td></td>
+</tr>
+</tbody></table>
+
+<p>A page in a pdf document is represented with a COSDictionary. The entries that are available for a page can be seen in the PDF Reference and an example of a page looks like this:</p>
+<div class="highlight"><pre><code class="language-text" data-lang="text"><<
+ /Type /Page
+ /MediaBox [0 0 612 915]
+ /Contents 56 0 R
+>>
+</code></pre></div>
+<p>The information within the dictionary can be accessed using the COS model</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">COSDictionary</span> <span class="n">page</span> <span class="o">=</span> <span class="o">...;</span>
+<span class="n">COSArray</span> <span class="n">mediaBox</span> <span class="o">=</span> <span class="o">(</span><span class="n">COSArray</span><span class="o">)</span><span class="n">page</span><span class="o">.</span><span class="na">getDictionaryObject</span><span class="o">(</span> <span class="s">"MediaBox"</span> <span class="o">);</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span> <span class="s">"Width:"</span> <span class="o">+</span> <span class="n">mediaBox</span><span class="o">.</span><span class="na">get</span><span class="o">(</span> <span class="mi">3</span> <span class="o">)</span> <span class="o">);</span>
+</code></pre></div>
+<p>As can be seen from that little example the COS model provides a low level API to access
+information within the PDF. In order to use the COS model successfully a good knowledge of
+the PDF specification is needed.</p>
+
+<h2 id="the-pd-model">The PD Model</h2>
+
+<p>The COS Model allows access to all aspects of a PDF document. This type of programming is
+tedious and error prone though because the user must know all of the names of the
+parameters and no helper methods are available. The PD Model was created to help
+alleviate this problem. Each type of object(page, font, image) has a set of defined
+attributes that can be available in the dictionary.
+A PD Model class is available for each of these so that strongly typed methods are
+available to access the attributes. </p>
+
+<p>The same code from above to get the page width can be rewritten to use PD Model classes.</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">PDPage</span> <span class="n">page</span> <span class="o">=</span> <span class="o">...;</span>
+<span class="n">PDRectangle</span> <span class="n">mediaBox</span> <span class="o">=</span> <span class="n">page</span><span class="o">.</span><span class="na">getMediaBox</span><span class="o">();</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span> <span class="s">"Width:"</span> <span class="o">+</span> <span class="n">mediaBox</span><span class="o">.</span><span class="na">getWidth</span><span class="o">()</span> <span class="o">);</span>
+</code></pre></div>
+<p>PD Model objects sit on top of COS model. Typically, the classes in the PD Model will only
+store a COS object and all setter/getter methods will modify data that is stored in the
+COS object. For example, when you call PDPage.getLastModified() the method will do a
+lookup in the COSDictionary with the key "LastModified", if it is found the value is then
+converter to a java.util.Calendar. When PDPage.setLastModified( Calendar ) is called then
+the Calendar is converted to a string in the COSDictionary.</p>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/1.8/commandline.html
----------------------------------------------------------------------
diff --git a/content/1.8/commandline.html b/content/1.8/commandline.html
new file mode 100644
index 0000000..61e2930
--- /dev/null
+++ b/content/1.8/commandline.html
@@ -0,0 +1,750 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Command Line Tools</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="command-line-tools">Command Line Tools</h1>
+
+<p>PDFBox comes with a series of command line utilities. They are available as standard Java applications.</p>
+
+<p>See the Dependencies page for instructions on how to set your classpath in order to run
+PDFBox tools as Java applications.</p>
+
+<p><strong>Table of Contents</strong><br>
+<a href="#decrypt">Decrypt</a>
+<a href="#encrypt">Encrypt</a>
+<a href="#extracttext">ExtractText</a>
+<a href="#overlaypdf">OverlayPDF</a>
+<a href="#printpdf">PrintPDF</a>
+<a href="#pdfdebugger">PDFDebugger</a>
+<a href="#pdfreader">PDFReader</a>
+<a href="#pdfmerger">PDFMerger</a>
+<a href="#pdfsplit">PDFSplit</a>
+<a href="#pdftoimage">PDFToImage</a>
+<a href="#texttopdf">TextToPDF</a>
+<a href="#writedecodeddoc">WriteDecodedDoc</a></p>
+
+<h2 id="decrypt">Decrypt</h2>
+
+<p>This application will decrypt a PDF document.</p>
+
+<p>NOTE: You must have the owner password to decrypt the document!</p>
+
+<p>usage: <code>java -jar pdfbox-app-x.y.z.jar Decrypt [OPTIONS] <inputfile> [outputfile]</code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td>Password to the PDF or certificate in keystore.</td>
+</tr>
+<tr>
+<td>-keyStore</td>
+<td>Path to keystore that holds certificate to decrypt the document. This is only required if the document is encrypted with a certificate, otherwise only the password is required.</td>
+</tr>
+<tr>
+<td>-alias</td>
+<td>The alias to the certificate in the keystore.</td>
+</tr>
+<tr>
+<td>inputfile</td>
+<td>The PDF file to decrypt.</td>
+</tr>
+<tr>
+<td>outputfile</td>
+<td>The file to save the decrypted document to. If left blank then it will be the same as the input file.</td>
+</tr>
+</tbody></table>
+
+<h2 id="encrypt">Encrypt</h2>
+
+<p>This application will encrypt a PDF document.</p>
+
+<p>usage: <code>java -jar pdfbox-app-x.y.z.jar Encrypt [OPTIONS] <password> <inputfile></code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-O</td>
+<td></td>
+<td>The owner password to the PDF, ignored if -certFile is specified.</td>
+</tr>
+<tr>
+<td>-U</td>
+<td></td>
+<td>The user password to the PDF, ignored if -certFile is specified.</td>
+</tr>
+<tr>
+<td>-certFile</td>
+<td></td>
+<td>Path to X.509 cert file.</td>
+</tr>
+<tr>
+<td>-canAssemble</td>
+<td>true</td>
+<td>Set the assemble permission.</td>
+</tr>
+<tr>
+<td>-canExtractContent</td>
+<td>true</td>
+<td>Set the extraction permission.</td>
+</tr>
+<tr>
+<td>-canExtractForAccessibility</td>
+<td>true</td>
+<td>Set the extraction permission.</td>
+</tr>
+<tr>
+<td>-canFillInForm</td>
+<td>true</td>
+<td>Set the fill in form permission.</td>
+</tr>
+<tr>
+<td>-canModify</td>
+<td>true</td>
+<td>Set the modify permission.</td>
+</tr>
+<tr>
+<td>-canModifyAnnotations</td>
+<td>true</td>
+<td>Set the modify annots permission.</td>
+</tr>
+<tr>
+<td>-canPrint</td>
+<td>true</td>
+<td>Set the print permission.</td>
+</tr>
+<tr>
+<td>-canPrintDegraded</td>
+<td>true</td>
+<td>Set the print degraded permission.</td>
+</tr>
+<tr>
+<td>-keyLength</td>
+<td>40 or 128</td>
+<td>The number of bits for the encryption key. For 128 bits <a href="http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html">Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files</a> must be installed.</td>
+</tr>
+<tr>
+<td>inputfile</td>
+<td></td>
+<td>The PDF file to encrypt.</td>
+</tr>
+<tr>
+<td>outputfile</td>
+<td></td>
+<td>The file to save the encrypted document to. If left blank then it will be the same as the input file.</td>
+</tr>
+</tbody></table>
+
+<h2 id="extracttext">ExtractText</h2>
+
+<p>This application will extract all text from the given PDF document.</p>
+
+<p>usage: <code>java -jar pdfbox-app-x.y.z.jar ExtractText [OPTIONS] <inputfile> [Text file]</code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td></td>
+<td>The password to the PDF document.</td>
+</tr>
+<tr>
+<td>-encoding</td>
+<td>default encoding</td>
+<td>The encoding type of the text file, e.g. ISO-8859-1, UTF-8, UTF-16BE.</td>
+</tr>
+<tr>
+<td>-console</td>
+<td>false</td>
+<td>Send text to console instead of file.</td>
+</tr>
+<tr>
+<td>-html</td>
+<td>false</td>
+<td>Output in HTML format instead of raw text.</td>
+</tr>
+<tr>
+<td>-sort</td>
+<td>false</td>
+<td>Sort the text before writing.</td>
+</tr>
+<tr>
+<td>-ignoreBeads</td>
+<td>false</td>
+<td>Disables the separation by beads.</td>
+</tr>
+<tr>
+<td>-force</td>
+<td>false</td>
+<td>Enables pdfbox to ignore corrupt objects.</td>
+</tr>
+<tr>
+<td>-debug</td>
+<td>false</td>
+<td>Enables debug output about the time consumption of every stage.</td>
+</tr>
+<tr>
+<td>-startPage</td>
+<td>1</td>
+<td>The first page to extract, one based.</td>
+</tr>
+<tr>
+<td>-endPage</td>
+<td>Integer.MAX_INT</td>
+<td>The last page to extract, one based.</td>
+</tr>
+<tr>
+<td>-nonSeq</td>
+<td>false</td>
+<td>Use the new non sequential parser.</td>
+</tr>
+</tbody></table>
+
+<h2 id="overlaypdf">OverlayPDF</h2>
+
+<p>This application will overlay one document with the content of another document</p>
+
+<p>usage: <code>java -jar pdfbox-app-x.y.z.jar OverlayPDF <input.pdf> [OPTIONS] <output.pdf></code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>inputfile</td>
+<td></td>
+<td>The PDF file to be overlayed.</td>
+</tr>
+<tr>
+<td>defaultOverlay.pdf</td>
+<td></td>
+<td>Default overlay file.</td>
+</tr>
+<tr>
+<td>-odd oddPageOverlay.pdf</td>
+<td></td>
+<td>Overlay file used for odd pages.</td>
+</tr>
+<tr>
+<td>-even evenPageOverlay.pdf</td>
+<td></td>
+<td>Overlay file used for even pages.</td>
+</tr>
+<tr>
+<td>-first firstPageOverlay.pdf</td>
+<td></td>
+<td>Overlay file used for the first page.</td>
+</tr>
+<tr>
+<td>-last lastPageOverlay.pdf</td>
+<td></td>
+<td>Overlay file used for the last pages.</td>
+</tr>
+<tr>
+<td>-page pageNumber specificPageOverlay.pdf</td>
+<td></td>
+<td>overlay file used for the given page number, may occur more than once.</td>
+</tr>
+<tr>
+<td>-position</td>
+<td>background</td>
+<td>Where to put the overlay, foreground or background.</td>
+</tr>
+<tr>
+<td>-nonSeq</td>
+<td>false</td>
+<td>Use the new non sequential parser.</td>
+</tr>
+<tr>
+<td>outputfile</td>
+<td></td>
+<td>The resulting pdf file.</td>
+</tr>
+</tbody></table>
+
+<p>Examples:</p>
+
+<ul>
+<li>OverlayPDF input.pdf overlay.pdf -nonSeq output.pdf</li>
+<li>OverlayPDF input.pdf defaultOverlay.pdf -page 10 overlayForPage10.pdf -position foreground -nonSeq output.pdf</li>
+<li>OverlayPDF input.pdf -odd oddOverlay.pdf -even evenOverlay.pdf -nonSeq output.pdf</li>
+</ul>
+
+<h2 id="printpdf">PrintPDF</h2>
+
+<p>This application will send a pdf document to the printer.</p>
+
+<p class="alert alert-info">You must have the correct permissions to print the document!</p>
+
+<p>usage: <code>java -jar pdfbox-app-x.y.z.jar PrintPDF [OPTIONS] <inputfile></code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td>The password to decrypt the PDF.</td>
+</tr>
+<tr>
+<td>-silentPrint</td>
+<td>Print the PDF without prompting for a printer.</td>
+</tr>
+<tr>
+<td>inputfile</td>
+<td>The PDF file to print.</td>
+</tr>
+</tbody></table>
+
+<h2 id="pdfdebugger">PDFDebugger</h2>
+
+<p>This application will take an existing PDF document and allows to analyze and inspect the internal structure</p>
+
+<p>usage: <code>java -jar pdfbox-app-x.y.z.jar PDFDebugger [inputfile]</code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td></td>
+<td>The password to the PDF document.</td>
+</tr>
+<tr>
+<td>-nonSeq</td>
+<td>false</td>
+<td>Use the new non sequential parser.</td>
+</tr>
+<tr>
+<td>inputfile</td>
+<td></td>
+<td>the name of an optional PDF file to open.</td>
+</tr>
+</tbody></table>
+
+<h2 id="pdfreader">PDFReader</h2>
+
+<p>An application to read PDF documents. This will provide Acrobat Reader like functionality.</p>
+
+<p>usage: <code>java -jar pdfbox-app-x.y.z.jar PDFReader [PDF file]</code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td></td>
+<td>The password to the PDF document.</td>
+</tr>
+<tr>
+<td>-nonSeq</td>
+<td>false</td>
+<td>Use the new non sequential parser.</td>
+</tr>
+<tr>
+<td>PDF file</td>
+<td></td>
+<td>the name of an optional PDF file to open</td>
+</tr>
+</tbody></table>
+
+<h2 id="pdfmerger">PDFMerger</h2>
+
+<p>This application will take a list of pdf documents and merge them, saving the result in a new document.</p>
+
+<p>usage: <code>java -jar pdfbox-app-x.y.z.jar PDFMerger <Source PDF files (2 ..n)> <Target PDF file></code></p>
+
+<h2 id="pdfsplit">PDFSplit</h2>
+
+<p>This application will take an existing PDF document and split it into a number of other documents</p>
+
+<p>usage: <code>java -jar pdfbox-app-x.y.z.jar PDFSplit [OPTIONS] <PDF file></code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td></td>
+<td>The password to the PDF document.</td>
+</tr>
+<tr>
+<td>-split</td>
+<td></td>
+<td>Number of pages of every splitted part of the pdf.</td>
+</tr>
+<tr>
+<td>-startPage</td>
+<td></td>
+<td>The page to start at.</td>
+</tr>
+<tr>
+<td>-endPage</td>
+<td></td>
+<td>The page to stop at.</td>
+</tr>
+<tr>
+<td>-nonSeq</td>
+<td>false</td>
+<td>Use the new non sequential parser.</td>
+</tr>
+</tbody></table>
+
+<p>Examples:</p>
+
+<ul>
+<li>PDFSplit -split 2 sample_with_13_pages.pdf will split the pdf in pieces of 2 pages each except the last which will contain 1 page only.</li>
+<li>PDFSplit -startPage 5 sample_with_13_pages.pdf will provide a pdf containing all pages of the source pdf starting at page 5</li>
+<li>PDFSplit -startPage 5 -endPage 10 sample_with_13_pages.pdf will provide a pdf containing all pages from 5 to 10 of the source pdf</li>
+<li>PDFSplit -split 2 -startPage 5 -endPage 10 sample_with_13_pages.pdf will provide 3 pdfs containing all pages from 5 to 10 of the source pdf 2 pages each</li>
+</ul>
+
+<h2 id="pdftoimage">PDFToImage</h2>
+
+<p>This application will create an image for every page in the PDF document.</p>
+
+<p>usage: <code>java -jar pdfbox-app-x.y.z.jar PDFToImage [OPTIONS] <PDF file></code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td></td>
+<td>The password to the PDF document.</td>
+</tr>
+<tr>
+<td>-imageType</td>
+<td>jpg</td>
+<td>The image type to write to. Currently only jpg or png.</td>
+</tr>
+<tr>
+<td>-outputPrefix</td>
+<td>Name of PDF document</td>
+<td>The prefix to the image file.</td>
+</tr>
+<tr>
+<td>-startPage</td>
+<td>1</td>
+<td>The first page to convert, one based.</td>
+</tr>
+<tr>
+<td>-endPage</td>
+<td>Integer.MAX_INT</td>
+<td>The last page to convert, one based.</td>
+</tr>
+<tr>
+<td>-nonSeq</td>
+<td>false</td>
+<td>Use the new non sequential parser.</td>
+</tr>
+</tbody></table>
+
+<h2 id="texttopdf">TextToPDF</h2>
+
+<p>This application will create a PDF document from a text file.</p>
+
+<p>usage: <code>java -jar pdfbox-app-x.y.z.jar TextToPDF [OPTIONS] <outputfile> <textfile></code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-standardFont</td>
+<td>Helvetica</td>
+<td>The font to use for the text. Either this or -ttf should be specified but not both.</td>
+</tr>
+<tr>
+<td>-ttf</td>
+<td></td>
+<td>The TTF font to use for the text. Either this or -standardFont should be specified but not both.</td>
+</tr>
+<tr>
+<td>-fontSize</td>
+<td>10</td>
+<td>The size of the font to use.</td>
+</tr>
+</tbody></table>
+
+<p>The following font names can be used for the parameter <code>standardFont</code>:</p>
+
+<ul>
+<li>Courier</li>
+<li>Courier-Bold</li>
+<li>Courier-Oblique</li>
+<li>Courier-BoldOblique</li>
+<li>Helvetica</li>
+<li>Helvetica-Bold</li>
+<li>Helvetica-Oblique</li>
+<li>Helvetica-BoldOblique</li>
+<li>Symbol</li>
+<li>Times-Bold</li>
+<li>Times-Roman</li>
+<li>Times-Italic</li>
+<li>Times-BoldItalic</li>
+<li>ZapfDingbats</li>
+</ul>
+
+<h2 id="writedecodeddoc">WriteDecodedDoc</h2>
+
+<p>An application to decompress PDF documents.</p>
+
+<p>usage: <code>java -jar pdfbox-app-x.y.z.jar WriteDecodedDoc <input-file> <output-file></code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td></td>
+<td>The password to the PDF document.</td>
+</tr>
+<tr>
+<td>-nonSeq</td>
+<td>false</td>
+<td>Use the new non sequential parser.</td>
+</tr>
+<tr>
+<td><input-file></td>
+<td></td>
+<td>The PDF file to decompress</td>
+</tr>
+<tr>
+<td><output-file></td>
+<td></td>
+<td>The destination PDF file</td>
+</tr>
+</tbody></table>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/1.8/cookbook/documentcreation.html
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/documentcreation.html b/content/1.8/cookbook/documentcreation.html
new file mode 100644
index 0000000..53d990c
--- /dev/null
+++ b/content/1.8/cookbook/documentcreation.html
@@ -0,0 +1,240 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Cookbook - Document Creation</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="document-creation">Document Creation</h1>
+
+<h2 id="create-a-blank-pdf">Create a blank PDF</h2>
+
+<p>This small sample shows how to create a new PDF document using PDFBox.</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="c1">// Create a new empty document</span>
+<span class="n">PDDocument</span> <span class="n">document</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDDocument</span><span class="o">();</span>
+
+<span class="c1">// Create a new blank page and add it to the document</span>
+<span class="n">PDPage</span> <span class="n">blankPage</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDPage</span><span class="o">();</span>
+<span class="n">document</span><span class="o">.</span><span class="na">addPage</span><span class="o">(</span> <span class="n">blankPage</span> <span class="o">);</span>
+
+<span class="c1">// Save the newly created document</span>
+<span class="n">document</span><span class="o">.</span><span class="na">save</span><span class="o">(</span><span class="s">"BlankPage.pdf"</span><span class="o">);</span>
+
+<span class="c1">// finally make sure that the document is properly</span>
+<span class="c1">// closed.</span>
+<span class="n">document</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+</code></pre></div>
+<h2 id="hello-world-using-a-pdf-base-font">Hello World using a PDF base font</h2>
+
+<p>This small sample shows how to create a new document and print the text "Hello World" using one of the PDF base fonts.</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="c1">// Create a document and add a page to it</span>
+<span class="n">PDDocument</span> <span class="n">document</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDDocument</span><span class="o">();</span>
+<span class="n">PDPage</span> <span class="n">page</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDPage</span><span class="o">();</span>
+<span class="n">document</span><span class="o">.</span><span class="na">addPage</span><span class="o">(</span> <span class="n">page</span> <span class="o">);</span>
+
+<span class="c1">// Create a new font object selecting one of the PDF base fonts</span>
+<span class="n">PDFont</span> <span class="n">font</span> <span class="o">=</span> <span class="n">PDType1Font</span><span class="o">.</span><span class="na">HELVETICA_BOLD</span><span class="o">;</span>
+
+<span class="c1">// Start a new content stream which will "hold" the to be created content</span>
+<span class="n">PDPageContentStream</span> <span class="n">contentStream</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDPageContentStream</span><span class="o">(</span><span class="n">document</span><span class="o">,</span> <span class="n">page</span><span class="o">);</span>
+
+<span class="c1">// Define a text content stream using the selected font, moving the cursor and drawing the text "Hello World"</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">beginText</span><span class="o">();</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">setFont</span><span class="o">(</span> <span class="n">font</span><span class="o">,</span> <span class="mi">12</span> <span class="o">);</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">moveTextPositionByAmount</span><span class="o">(</span> <span class="mi">100</span><span class="o">,</span> <span class="mi">700</span> <span class="o">);</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">drawString</span><span class="o">(</span> <span class="s">"Hello World"</span> <span class="o">);</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">endText</span><span class="o">();</span>
+
+<span class="c1">// Make sure that the content stream is closed:</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+
+<span class="c1">// Save the results and ensure that the document is properly closed:</span>
+<span class="n">document</span><span class="o">.</span><span class="na">save</span><span class="o">(</span> <span class="s">"Hello World.pdf"</span><span class="o">);</span>
+<span class="n">document</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+</code></pre></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/1.8/cookbook/encryption.html
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/encryption.html b/content/1.8/cookbook/encryption.html
new file mode 100644
index 0000000..34226c3
--- /dev/null
+++ b/content/1.8/cookbook/encryption.html
@@ -0,0 +1,221 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Cookbook - Encrypting a file</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="encrypting-a-file">Encrypting a file</h1>
+
+<p>PDF encryption requires two passwords: the "user password" to open and view the file with restricted permissions, the "owner password" to access the file with all permission.</p>
+
+<h2 id="load-and-save-encrypted">Load and save encrypted</h2>
+
+<p>This small sample shows how to encrypt a file so that it can be viewed, but not printed..</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">PDDocument</span> <span class="n">doc</span> <span class="o">=</span> <span class="n">PDDocument</span><span class="o">.</span><span class="na">load</span><span class="o">(</span><span class="s">"filename.pdf"</span><span class="o">);</span>
+
+<span class="c1">// Define the length of the encryption key.</span>
+<span class="c1">// Possible values are 40 or 128 (256 will be available in PDFBox 2.0).</span>
+<span class="kt">int</span> <span class="n">keyLength</span> <span class="o">=</span> <span class="mi">128</span><span class="o">;</span>
+
+<span class="n">AccessPermission</span> <span class="n">ap</span> <span class="o">=</span> <span class="k">new</span> <span class="n">AccessPermission</span><span class="o">();</span>
+
+<span class="c1">// disable printing, everything else is allowed</span>
+<span class="n">ap</span><span class="o">.</span><span class="na">setCanPrint</span><span class="o">(</span><span class="kc">false</span><span class="o">);</span>
+
+<span class="c1">// owner password (to open the file with all permissions) is "12345"</span>
+<span class="c1">// user password (to open the file but with restricted permissions, is empty here) </span>
+<span class="n">StandardProtectionPolicy</span> <span class="n">spp</span> <span class="o">=</span> <span class="k">new</span> <span class="n">StandardProtectionPolicy</span><span class="o">(</span><span class="s">"12345"</span><span class="o">,</span> <span class="s">""</span><span class="o">,</span> <span class="n">ap</span><span class="o">);</span>
+<span class="n">spp</span><span class="o">.</span><span class="na">setEncryptionKeyLength</span><span class="o">(</span><span class="n">keyLength</span><span class="o">);</span>
+<span class="n">spp</span><span class="o">.</span><span class="na">setPermissions</span><span class="o">(</span><span class="n">ap</span><span class="o">);</span>
+<span class="n">doc</span><span class="o">.</span><span class="na">protect</span><span class="o">(</span><span class="n">spp</span><span class="o">);</span>
+
+<span class="n">doc</span><span class="o">.</span><span class="na">save</span><span class="o">(</span><span class="s">"filename-encrypted.pdf"</span><span class="o">);</span>
+<span class="n">doc</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+</code></pre></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/1.8/cookbook/fill-form-field.html
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/fill-form-field.html b/content/1.8/cookbook/fill-form-field.html
new file mode 100644
index 0000000..20a47cc
--- /dev/null
+++ b/content/1.8/cookbook/fill-form-field.html
@@ -0,0 +1,234 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Cookbook - Fill a Form Field</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="fill-a-form-field">Fill a Form Field</h1>
+
+<p>Form fields within a PDF are defined as part of the AcroForm entry within the PDF's document catalog.
+Form there individual fields can be accessed. Fields might be organized in a tree structure so it might
+be neccessary to walk through the tree to get an individual field.</p>
+
+<p>Load the PDF document.</p>
+<div class="highlight"><pre><code class="language-" data-lang="">:::java
+// load the document
+PDDocument pdfDocument = PDDocument.loadNonSeq(new File(... ), null);
+</code></pre></div>
+<p>Get the docoument catalog and the AcroForm which might be contained within.</p>
+<div class="highlight"><pre><code class="language-" data-lang="">:::java
+// get the document catalog
+PDDocumentCatalog docCatalog = pdfDocument.getDocumentCatalog();
+PDAcroForm acroForm = docCatalog.getAcroForm();
+</code></pre></div>
+<p>Retrieve an individual field and set its value.</p>
+<div class="highlight"><pre><code class="language-" data-lang="">:::java
+// as there might not be an AcroForm entry a null check is necessary
+if (acroForm != null)
+{
+ PDField field = (PDField) acroForm.getField( "fieldName" );
+ field.setValue("new field value");
+}
+</code></pre></div>
+<p>If a field is nested within the form tree a fully qualified name might be provided
+to access the field.</p>
+<div class="highlight"><pre><code class="language-" data-lang="">:::java
+// as there might not be an AcroForm entry a null check is neccessary
+if (acroForm != null)
+{
+ PDField field = (PDField) acroForm.getField( "fieldsParentName.fieldName" );
+ field.setValue("new field value");
+}
+</code></pre></div>
+<p>Save and close the filled out form.</p>
+<div class="highlight"><pre><code class="language-" data-lang="">:::java
+doc.save(filledForm);
+doc.close();
+</code></pre></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
[2/6] pdfbox-docs git commit: Site checkin for project Apache PDFBox
Website
Posted by ms...@apache.org.
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/2.0/migration.html
----------------------------------------------------------------------
diff --git a/content/2.0/migration.html b/content/2.0/migration.html
new file mode 100644
index 0000000..8e5a665
--- /dev/null
+++ b/content/2.0/migration.html
@@ -0,0 +1,369 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | PDFBox 2.0.0 Migration Guide</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="migration-to-pdfbox-2-0-0">Migration to PDFBox 2.0.0</h1>
+
+<h2 id="environment">Environment</h2>
+
+<p>PDFBox 2.0.0 requires at least Java 6</p>
+
+<h2 id="packages">Packages</h2>
+
+<p>There are some significant changes to the package structure of PDFBox:</p>
+
+<ul>
+<li>Jempbox is no longer supported and was removed in favour of Xmpbox</li>
+<li>all examples were moved to the new package "pdfbox-examples"</li>
+<li>all commandline tools were moved to the new package "pdfbox-tools"</li>
+<li>all debugger related stuff was moved to the new package "pdfbox-debugger"</li>
+<li>the new package "debugger-app" provides a standalone pre built binary for the debugger</li>
+</ul>
+
+<h2 id="dependency-updates">Dependency updates</h2>
+
+<p>All libraries on which PDFBox depends are updated to their latest stable versions:</p>
+
+<ul>
+<li>Bouncy Castle 1.53</li>
+<li>Apache Commons Logging 1.2</li>
+</ul>
+
+<p>For test support the libraries are updated to</p>
+
+<ul>
+<li>JUnit 4.12</li>
+<li>JAI Image Core 1.2</li>
+<li>Levigo JBIG ImageIO Plugin 1.6.3</li>
+</ul>
+
+<h2 id="breaking-changes-to-the-library">Breaking Changes to the Library</h2>
+
+<h3 id="deprecated-api-calls">Deprecated API calls</h3>
+
+<p>Most deprecated API calls in PDFBox 1.8.x have been removed for PDFBox 2.0.0 </p>
+
+<h3 id="api-changes">API Changes</h3>
+
+<p>The API changes are reflected in the Javadoc for PDFBox 2.0.0. The most notable changes are:</p>
+
+<ul>
+<li><code>getCOSDictionary()</code> is no longer used. Instead <code>getCOSObject</code> now returns the matching <code>COSBase</code> subtype.</li>
+<li><code>PDXObjectForm</code> was renamed to <code>PDFormXObject</code> to be more in line with the PDF specification.</li>
+<li><code>PDXObjectImage</code> was renamed to <code>PDImageXObject</code> to be more in line with the PDF specification.</li>
+<li><code>PDPage.getContents().createInputStream()</code>was simplified to <code>PDPage.getContents()</code>.</li>
+</ul>
+
+<h3 id="general-behaviour">General Behaviour</h3>
+
+<p>PDFBox 2.0.0 is now parsing PDF files following the Xref information in the PDF. This is similar to the functionality using
+<code>PDDocument.loadNonSeq</code> with PDFBox 1.8.x. Users still using <code>PDDocument.load</code> with PDFBox 1.8.x might experience different
+results when switching to PDFBox 2.0.0.</p>
+
+<h3 id="font-handling">Font Handling</h3>
+
+<p>Font handling now has full Unicode support and supports font subsetting.</p>
+
+<p>TrueType fonts shall now be loaded using</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">PDType0Font</span><span class="o">.</span><span class="na">load</span>
+</code></pre></div>
+<p>to leverage that. </p>
+
+<h3 id="pdf-resources-handling">PDF Resources Handling</h3>
+
+<p>The individual calls to add resources such as <code>PDResource.addFont(PDFont font)</code> and <code>PDResource.addXObject(PDXObject xobject, String prefix)</code>
+have been replaced with <code>PDResource.add(resource type)</code> where <code>resource type</code> represents the different resource classes such as <code>PDFont</code>, <code>PDAbstractPattern</code>
+and so on. The <code>add</code> method now supports all the different type of resources available.</p>
+
+<h3 id="working-with-images">Working with Images</h3>
+
+<p>The individual classes <code>PDJpeg()</code>, <code>PDPixelMap()</code> and <code>PDCCitt()</code> to import images have been replaced with <code>PDImageXObject.createFromFile</code> which works for JPG, TIFF (only G4 compression), PNG, BMP and GIF.</p>
+
+<p>In addition there are some specialized classes:</p>
+
+<ul>
+<li><code>JPEGFactory.createFromStream</code> which preserve the JPEG data and embed it in the PDF file without modification. (This is best if you have a JPEG file).</li>
+<li><code>CCITTFactory.createFromFile</code> (for bitonal TIFF images with G4 compression).</li>
+<li><code>LosslessFactory.createFromImage</code> (this is best if you start with a BufferedImage).</li>
+</ul>
+
+<h3 id="iterating-pages">Iterating Pages</h3>
+
+<p>With PDFBox 2.0.0 the prefered way to iterate through the pages of a document is</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="k">for</span><span class="o">(</span><span class="n">PDPage</span> <span class="n">page</span> <span class="o">:</span> <span class="n">document</span><span class="o">.</span><span class="na">getPages</span><span class="o">())</span>
+<span class="o">{</span>
+ <span class="o">...</span> <span class="o">(</span><span class="k">do</span> <span class="n">something</span><span class="o">)</span>
+<span class="o">}</span>
+</code></pre></div>
+<h3 id="pdf-rendering">PDF Rendering</h3>
+
+<p>With PDFBox 2.0.0 <code>PDPage.convertToImage</code> has been removed. Instead the new <code>PDFRenderer</code> class shall be used.</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">PDDocument</span> <span class="n">document</span> <span class="o">=</span> <span class="n">PDDocument</span><span class="o">.</span><span class="na">load</span><span class="o">(</span><span class="k">new</span> <span class="n">File</span><span class="o">(</span><span class="n">pdfFilename</span><span class="o">));</span>
+<span class="n">PDFRenderer</span> <span class="n">pdfRenderer</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDFRenderer</span><span class="o">(</span><span class="n">document</span><span class="o">);</span>
+<span class="kt">int</span> <span class="n">pageCounter</span> <span class="o">=</span> <span class="mi">0</span><span class="o">;</span>
+<span class="k">for</span> <span class="o">(</span><span class="n">PDPage</span> <span class="n">page</span> <span class="o">:</span> <span class="n">document</span><span class="o">.</span><span class="na">getPages</span><span class="o">())</span>
+<span class="o">{</span>
+ <span class="n">pdfRenderer</span><span class="o">.</span><span class="na">renderImageWithDPI</span><span class="o">(</span><span class="n">pageCounter</span><span class="o">,</span> <span class="mi">300</span><span class="o">,</span> <span class="n">ImageType</span><span class="o">.</span><span class="na">RGB</span><span class="o">);</span>
+
+ <span class="c1">// suffix in filename will be used as the file format</span>
+ <span class="n">ImageIOUtil</span><span class="o">.</span><span class="na">writeImage</span><span class="o">(</span><span class="n">bim</span><span class="o">,</span> <span class="n">pdfFilename</span> <span class="o">+</span> <span class="s">"-"</span> <span class="o">+</span> <span class="o">(</span><span class="n">pageCounter</span><span class="o">++)</span> <span class="o">+</span> <span class="s">".png"</span><span class="o">,</span> <span class="mi">300</span><span class="o">);</span>
+<span class="o">}</span>
+<span class="n">document</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+</code></pre></div>
+<p><code>ImageIOUtil</code> has been moved into the <code>org.apache.pdfbox.tools.imageio</code> package.</p>
+
+<p class="alert alert-warning">Important notice when using PDFBox with Java 8
+</p>
+
+<p>Due to the change of the java color management module towards "LittleCMS", users can experience slow performance in color operations.
+Solution: disable LittleCMS in favour of the old KCMS (Kodak Color Management System):</p>
+
+<ul>
+<li>start with <code>-Dsun.java2d.cmm=sun.java2d.cmm.kcms.KcmsServiceProvider</code>or call</li>
+<li><code>System.setProperty("sun.java2d.cmm", "sun.java2d.cmm.kcms.KcmsServiceProvider");</code></li>
+</ul>
+
+<p>Sources:<br>
+<a href="http://www.subshell.com/en/subshell/blog/Wrong-Colors-in-Images-with-Java8-100.html">http://www.subshell.com/en/subshell/blog/Wrong-Colors-in-Images-with-Java8-100.html</a><br>
+<a href="https://bugs.openjdk.java.net/browse/JDK-8041125">https://bugs.openjdk.java.net/browse/JDK-8041125</a></p>
+
+<h3 id="pdf-printing">PDF Printing</h3>
+
+<p>With PDFBox 2.0.0 <code>PDFPrinter</code> has been removed.</p>
+
+<p>Users of <code>PDFPrinter.silentPrint()</code> should now use this code:</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">PrinterJob</span> <span class="n">job</span> <span class="o">=</span> <span class="n">PrinterJob</span><span class="o">.</span><span class="na">getPrinterJob</span><span class="o">();</span>
+<span class="n">job</span><span class="o">.</span><span class="na">setPageable</span><span class="o">(</span><span class="k">new</span> <span class="n">PDFPageable</span><span class="o">(</span><span class="n">document</span><span class="o">));</span>
+<span class="n">job</span><span class="o">.</span><span class="na">print</span><span class="o">();</span>
+</code></pre></div>
+<p>While users of <code>PDFPrinter.print()</code> should now use this code:</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">PrinterJob</span> <span class="n">job</span> <span class="o">=</span> <span class="n">PrinterJob</span><span class="o">.</span><span class="na">getPrinterJob</span><span class="o">();</span>
+<span class="n">job</span><span class="o">.</span><span class="na">setPageable</span><span class="o">(</span><span class="k">new</span> <span class="n">PDFPageable</span><span class="o">(</span><span class="n">document</span><span class="o">));</span>
+<span class="k">if</span> <span class="o">(</span><span class="n">job</span><span class="o">.</span><span class="na">printDialog</span><span class="o">())</span> <span class="o">{</span>
+ <span class="n">job</span><span class="o">.</span><span class="na">print</span><span class="o">();</span>
+<span class="o">}</span>
+</code></pre></div>
+<p>Advanced use case examples can be found in th examples package under org/apache/pdfbox/examples/printing/Printing.java</p>
+
+<h3 id="text-extraction">Text Extraction</h3>
+
+<p>In 1.8, to get the text colors, one method was to pass an expanded .properties file to the PDFStripper constructor. To achieve the same
+in PDFBox 2.0 you can extend <code>PDFTextStripper</code>and add the following <code>Operators</code> to the constructor:</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">addOperator</span><span class="o">(</span><span class="k">new</span> <span class="n">SetStrokingColorSpace</span><span class="o">());</span>
+<span class="n">addOperator</span><span class="o">(</span><span class="k">new</span> <span class="n">SetNonStrokingColorSpace</span><span class="o">());</span>
+<span class="n">addOperator</span><span class="o">(</span><span class="k">new</span> <span class="n">SetStrokingDeviceCMYKColor</span><span class="o">());</span>
+<span class="n">addOperator</span><span class="o">(</span><span class="k">new</span> <span class="n">SetNonStrokingDeviceCMYKColor</span><span class="o">());</span>
+<span class="n">addOperator</span><span class="o">(</span><span class="k">new</span> <span class="n">SetNonStrokingDeviceRGBColor</span><span class="o">());</span>
+<span class="n">addOperator</span><span class="o">(</span><span class="k">new</span> <span class="n">SetStrokingDeviceRGBColor</span><span class="o">());</span>
+<span class="n">addOperator</span><span class="o">(</span><span class="k">new</span> <span class="n">SetNonStrokingDeviceGrayColor</span><span class="o">());</span>
+<span class="n">addOperator</span><span class="o">(</span><span class="k">new</span> <span class="n">SetStrokingDeviceGrayColor</span><span class="o">());</span>
+<span class="n">addOperator</span><span class="o">(</span><span class="k">new</span> <span class="n">SetStrokingColor</span><span class="o">());</span>
+<span class="n">addOperator</span><span class="o">(</span><span class="k">new</span> <span class="n">SetStrokingColorN</span><span class="o">());</span>
+<span class="n">addOperator</span><span class="o">(</span><span class="k">new</span> <span class="n">SetNonStrokingColor</span><span class="o">());</span>
+<span class="n">addOperator</span><span class="o">(</span><span class="k">new</span> <span class="n">SetNonStrokingColorN</span><span class="o">());</span>
+</code></pre></div>
+<h3 id="interactive-forms">Interactive Forms</h3>
+
+<p>Large parts of the support for interactive forms (AcroForms) has been rewritten. The most notable change from 1.8.x is that
+there is a clear distinction between fields and the annotations representing them visually. Intermediate nodes in a field
+tree are now represented by the <code>PDNonTerminalField</code> class.</p>
+
+<p>With PDFBox 2.0.0 the prefered way to iterate through the fields is now</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">PDAcroForm</span> <span class="n">form</span><span class="o">;</span>
+<span class="o">...</span>
+<span class="k">for</span> <span class="o">(</span><span class="n">PDField</span> <span class="n">field</span> <span class="o">:</span> <span class="n">form</span><span class="o">.</span><span class="na">getFieldTree</span><span class="o">())</span>
+<span class="o">{</span>
+ <span class="o">...</span> <span class="o">(</span><span class="k">do</span> <span class="n">something</span><span class="o">)</span>
+<span class="o">}</span>
+</code></pre></div>
+<p>Most <code>PDField</code> subclasses now accept Java generic types such as <code>String</code> as parameters instead of the former <code>COSBase</code> subclasses.</p>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/building.html
----------------------------------------------------------------------
diff --git a/content/building.html b/content/building.html
new file mode 100644
index 0000000..f75cf43
--- /dev/null
+++ b/content/building.html
@@ -0,0 +1,264 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Building PDFBox</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="building-from-source">Building from Source</h1>
+
+<p>Building PDFBox from source is only necessary if you're wanting to contribute code to the PDFBox project. Most users should use the <a href="http://pdfbox.apache.org/download.cgi">binary releases</a> instead.</p>
+
+<h2 id="obtaining-the-source">Obtaining the Source</h2>
+
+<p>You can obtain the latest source of PDFBox from our <a href="http://pdfbox.apache.org/download.cgi">SVN repo</a> The current trunk is v2.0.0-SNAPSHOT. There is a seperate branch for the 1.8.x series. You can fetch the latest 2.0 trunk using Subversion:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">svn checkout http://svn.apache.org/repos/asf/pdfbox/trunk/
+cd trunk
+</code></pre></div>
+<h2 id="build-dependencies">Build dependencies</h2>
+
+<h3 id="pdfbox-1-8">PDFBox 1.8</h3>
+
+<ul>
+<li>JDK 5 or 6</li>
+<li> <a href="http://maven.apache.org/">Maven 2</a></li>
+</ul>
+
+<h3 id="pdfbox-2-0">PDFBox 2.0</h3>
+
+<ul>
+<li>JDK 6+</li>
+<li>Java Cryptography Extension (JCE) [see below]</li>
+<li> <a href="http://maven.apache.org/">Maven 2</a></li>
+</ul>
+
+<h3 id="java-cryptography-extension-jce">Java Cryptography Extension (JCE)</h3>
+
+<p>Building PDFBox 2.0 requires a JDK with "unlimited strength" cryptography, which requires extra files to be installed. For JDK 7, see <a href="http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html">Java Cryptography Extension (JCE)</a>. If these files are not installed, building PDFBox will fail the following test:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">TestPublicKeyEncryption.setUp:70 JCE unlimited strength jurisdiction policy files are not installed
+</code></pre></div>
+<h2 id="building-with-maven">Building with Maven</h2>
+
+<p>In the root directory of PDFBox:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">mvn clean install
+</code></pre></div>
+<hr>
+
+<h2 id="building-with-ant-deprecated-removed-in-2-0-0">Building with Ant (Deprecated, removed in 2.0.0)</h2>
+
+<p>The old Ant build is still available, and can be used especially for
+building .NET binaries with IKVM:</p>
+
+<ol>
+<li> Install <a href="http://ant.apache.org/">ANT</a>. PDFBox currently uses 1.6.2
+but other versions probably work as well.</li>
+<li><p>(optional) Setup IKVM, if you want to build the .NET DLL version of
+PDFBox.</p>
+
+<ol>
+<li> <a href="http://www.ikvm.net/">IKVM</a> binaries</li>
+<li> In the build.properties, set the ikvm.dir property:\
+ <code>ikvm.dir=C:\\javalib\\ikvm-12-07-2004\\ikvm</code></li>
+</ol></li>
+<li><p>Run "<code>ant</code>" from the root PDFBox directory. This will create the
+.zip package distribution. See the build file for other ant targets.</p></li>
+</ol>
+
+<p>NOTE: If you want to run PDFBox from an IDE them you will need to add
+the 'Resources' directory to the project classpath in your IDE.</p>
+
+<h3 id="dependencies-for-ant-builds">Dependencies for Ant Builds</h3>
+
+<p>The above instructions expect that you're using <a href="http://maven.apache.org/">Maven</a> or another build tool like <a href="http://ant.apache.org/ivy/">Ivy</a> that supports Maven dependencies.
+If you instead use tools like <a href="http://ant.apache.org/">Ant</a> where you need to explicitly include all the required library jars in your application, you'll need to do
+something different.</p>
+
+<p>The easiest approach is to run <code>mvn dependency:copy-dependencies</code> inside the pdfbox directory of the latest PDFBox source release. This will copy all the required and optional
+libraries discussed above into the pdfbox/target/dependencies directory. You can then simply copy all the libraries you need from this directory to your application.</p>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/codingconventions.html
----------------------------------------------------------------------
diff --git a/content/codingconventions.html b/content/codingconventions.html
new file mode 100644
index 0000000..9a7ea71
--- /dev/null
+++ b/content/codingconventions.html
@@ -0,0 +1,306 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Coding Conventions</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="coding-conventions">Coding Conventions</h1>
+
+<p>Over the years the PDFBox project has come to adopt a number of coding conventions. These are not always followed in old code but new code should try to follow these rules where possible.</p>
+
+<h3 id="formatting">Formatting</h3>
+
+<ul>
+<li><p>Braces go on their own line.</p></li>
+<li><p>Always use braces with control flow statements.</p></li>
+<li><p>No lines longer than 100 characters, including JavaDoc.</p></li>
+<li><p>Wrapped lines should use either an indent of 4 or 8 characters or align with the expression at the same level on the previous line.</p></li>
+<li><p>Wrapped lines should be broken after operators, not before.</p></li>
+<li><p>Prefer aligned wrapped lines.</p></li>
+<li><p>Prefer aligned wrapped parameter lists.</p></li>
+</ul>
+
+<h3 id="whitespace">Whitespace</h3>
+
+<ul>
+<li><p>Four spaces for indents, no tabs.</p></li>
+<li><p>Do not use spaces around parenthesis.</p></li>
+<li><p>Use spaces after control flow keywords.</p></li>
+<li><p>Prefer using blank lines to separate logical blocks of code, but do not be excessive.</p></li>
+<li><p>Prefer not following casts with a blank space.</p></li>
+</ul>
+
+<h3 id="structure">Structure</h3>
+
+<ul>
+<li><p>Do not use package imports (e.g. <code>import java.util.*</code>)</p></li>
+<li><p>Static fields and methods must appear at the top of a class, before any other code.</p></li>
+<li><p>Within a class, definitions should be ordered as follows:</p>
+
+<p>Class (static) variables<br>
+Instance variables<br>
+Constructors<br>
+Methods </p></li>
+</ul>
+
+<h3 id="javadoc">JavaDoc</h3>
+
+<ul>
+<li><p>Public and protected methods and fields must have JavaDoc.</p></li>
+<li><p>Don't use <code>@version</code> tags.</p></li>
+<li><p>Don't use <code>@since</code> tags.</p></li>
+<li><p>Don't include your e-mail address in <code>@author</code> tags.</p></li>
+<li><p>You may omit <code>@return</code> tags for getters as long as you include a summary which begins with the word "Returns".</p></li>
+<li><p>Private methods do not require JavaDoc but may have partial JavaDoc if it adds valuable information.</p></li>
+</ul>
+
+<h3 id="comments">Comments</h3>
+
+<ul>
+<li><p>Only use line comments within code, never block comments.</p></li>
+<li><p>Prefer comments on their own line, rather than trailing, unless the latter is more readable.</p></li>
+<li><p>Prefix line comments by a space <code>// like this</code>.</p></li>
+</ul>
+
+<h3 id="variables">Variables</h3>
+
+<ul>
+<li><p>Prefer initializing variables when they are declared, rather than C-style declaration before use.</p></li>
+<li><p>Always use final fields when possible.</p></li>
+</ul>
+
+<h3 id="control-flow">Control Flow</h3>
+
+<ul>
+<li><p>Prefer multiple return statements over additional control flow logic.</p></li>
+<li><p>Prefer switch statements over multi-clause if-then statements.</p></li>
+</ul>
+
+<h3 id="api-design">API Design</h3>
+
+<ul>
+<li><p>Give variables and methods meaningful names. Keep these short but don't use abbreviations. Prefer using the same terminology as the PDF spec.</p></li>
+<li><p>Prefer final classes and final protected methods for non-final public classes, this reduces the surface area of the public API.</p></li>
+<li><p>Avoid non-final protected variables in public classes. Prefer protected getters over protected variables when protected fields are necessery in public classes.</p></li>
+<li><p>Minimize the API. Don't make everything public just because you can.</p></li>
+<li><p>Don't expose implementation details unless there is a clear need: allowing subclassing means that the behaviour of protected methods becomes part of the contract of the public AP.</p></li>
+<li><p>Avoid unnecesary abstraction. While you're encouraged to avoid brittle designs, it's unlikey that an API designed for "future use" will have the correct API without any code which actually uses it.</p></li>
+</ul>
+
+<h3 id="example">Example</h3>
+
+<p>Here's an example of PDFBox's formatting style:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">public class Foo extends Bar
+{
+ public static void main(String args[])
+ {
+ try
+ {
+ for (int i = 0; i < args.length; i++)
+ {
+ System.out.println(Integer.parseInt(args[i]));
+ }
+ }
+ catch (NumberFormatException e)
+ {
+ e.printStackTrace();
+ }
+ }
+}
+</code></pre></div>
+<h2 id="eclipse-formatter">Eclipse Formatter</h2>
+
+<p>Eclipse users may download this preferences file: pdfbox-eclipse-formatter.xml and import this into Eclipse.
+(Window->Preferences, go to Java->Code Style->Formatter and click "Import...").
+Once you have done this you can reformat your code by using Source->Format (Ctrl+Shift+F).</p>
+
+<p>Also note that Eclipse will automatically format your import statements appropriately when
+you invoke Source -> Organize Imports (Ctrl+Shift+O).</p>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/errors/403.html
----------------------------------------------------------------------
diff --git a/content/errors/403.html b/content/errors/403.html
new file mode 100644
index 0000000..2c150d8
--- /dev/null
+++ b/content/errors/403.html
@@ -0,0 +1,206 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Forbidden (403)</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="403">403</h1>
+
+<p>We're sorry, but the page you requested cannot be accessed. </p>
+
+<p>Maybe you </p>
+
+<ul>
+<li>typed the address incorrectly</li>
+<li>followed a link from another site that pointed to this page.</li>
+</ul>
+
+<p>If you came by following a broken link, please report the <a href="https://issues.apache.org/jira/browse/pdfbox">issue</a>.</p>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/errors/404.html
----------------------------------------------------------------------
diff --git a/content/errors/404.html b/content/errors/404.html
new file mode 100644
index 0000000..02f2811
--- /dev/null
+++ b/content/errors/404.html
@@ -0,0 +1,206 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Page Not Found</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="404">404</h1>
+
+<p>We're sorry, but the page you requested cannot be found. </p>
+
+<p>Maybe you </p>
+
+<ul>
+<li>typed the address incorrectly</li>
+<li>followed a link from another site that pointed to this page.</li>
+</ul>
+
+<p>If you came by following a broken link, please report the <a href="https://issues.apache.org/jira/browse/pdfbox">issue</a>.</p>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/ideas.html
----------------------------------------------------------------------
diff --git a/content/ideas.html b/content/ideas.html
new file mode 100644
index 0000000..ce64dc1
--- /dev/null
+++ b/content/ideas.html
@@ -0,0 +1,280 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Ideas</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="ideas">Ideas</h1>
+
+<p>There are several ideas to enhance PDFBox. These are outlined below together with
+comments and the releases they are planned for as soon as there is agreement to do the
+implementation.</p>
+
+<h2 id="enhance-type-safety">Enhance type safety</h2>
+
+<p>Enhance the type safety of PDFBox and add more generic collections and code cleanup.</p>
+
+<h2 id="remove-all-deprecated-methods">Remove all deprecated methods</h2>
+
+<p>This is an ongoing effort and most/all deprecated methods will be removed in PDFBox 2.0.0</p>
+
+<h2 id="handle-large-pdf-files">Handle large PDF files</h2>
+
+<p>In addition to the PDF parsing pdfbox does not always handle large PDF files well as some
+of the references are implemented as int instead of long</p>
+
+<h2 id="switch-to-java-1-6"><span class="complete">Switch to Java 1.6</span></h2>
+
+<p><span class="complete">PDFBox 2.0.0 has Java 6 as minimum requirement.</span></p>
+
+<h2 id="break-pdfbox-into-modules"><span class="complete">Break PDFBox into modules</span></h2>
+
+<p><span class="complete">In order to support different use cases and provide a minimal toolset PDFBox 2.0.0 should be
+separated into different modules. This goes inline with rearranging some of the code
+e.g. remove AWT from PDDocument.
+</span></p>
+
+<h2 id="enhance-the-font-rendering"><span class="complete">Enhance the font rendering</span></h2>
+
+<p><span class="complete">PDFBox 2.0.0 will render most of the fonts without using AWT.</span></p>
+
+<h2 id="replace-enhance-pdf-parsing">Replace/enhance PDF parsing</h2>
+
+<p><span class="complete">The old "classic" PDF parser in PDFBox is not in line with the PDF specification as it parses
+a PDF from top to bottom instead of respecting the XRef information.</span> The NonSequentialParser
+enhanced that situation but there is a need to have a cleaner foundation broken into several levels</p>
+
+<ul>
+<li>io</li>
+<li>tokenization</li>
+<li>parsing according to structure</li>
+<li>COS level document</li>
+<li>PD level document</li>
+<li>add some self healing mechanism to process corrupt files</li>
+</ul>
+
+<p>In addition handling documents which are not conforming shouldn't be part of the core parser
+but of a extentable approach e.g. by adding hooks to allow for handling parsing exceptions.</p>
+
+<h2 id="add-the-ability-to-create-pdfs-using-unicode-encoded-text"><span class="complete">Add the ability to create PDFs using unicode encoded text</span></h2>
+
+<p><span class="complete">The recent PDFBox version is limited to WinANSI encoded text. 2.0.0 should have unicode support as well.</span></p>
+
+<h2 id="rearchitect-the-cos-level-objects">Rearchitect the COS level objects</h2>
+
+<p>The COS level objects need to be refactored to be in line with the new parser. In addition
+method signatures, constructing ... should be made similar across the COS objects</p>
+
+<h2 id="parsing-on-demand">Parsing on demand</h2>
+
+<p>Instead of always parsing the complete document PDFs should be parsable on demand making
+objects only available as they are needed to enhance performance and minimize memory footprint.</p>
+
+<p>This might be achieved by providing a layered approach where a base (non caching) parser provides
+the on demand parsing and a caching parser built on top caches objects for use cases where
+this is beneficial e.g. rendering, debugging ...</p>
+
+<ul>
+<li>the lexer would be the low level component delivering tokens to the parser.
+A sample implementation exists as part of PDFBOX-1000. The benefit would be a clean low
+level handling of tokens. The current implementation needs to be (slightly ?) revised though</li>
+<li>the incremental (non caching) parser would allow for page by page processing moving forward
+only to support text extraction, merging, splitting … - the benefit would be a lower memory
+consumption as well as a potential faster processing</li>
+<li>the caching parser would support applications such a PDFDebugger or PDFReader </li>
+</ul>
+
+<h2 id="handling-of-pdf-versions">Handling of PDF versions</h2>
+
+<p>The current implementation is a mix of PDF 1.4 and some adhoc additions without a clear
+distinction what is and is not supported. We could ad some support for explicitly handling
+versions in PDFBox e.g. my marking certain methods and properties to the PDF version support
+level. This could in addition be a good basis for PDF/A and other compliance checks. </p>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
[3/6] pdfbox-docs git commit: Site checkin for project Apache PDFBox
Website
Posted by ms...@apache.org.
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/2.0/commandline.html
----------------------------------------------------------------------
diff --git a/content/2.0/commandline.html b/content/2.0/commandline.html
new file mode 100644
index 0000000..651be03
--- /dev/null
+++ b/content/2.0/commandline.html
@@ -0,0 +1,695 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Command Line Tools</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="command-line-tools">Command Line Tools</h1>
+
+<p>PDFBox comes with a series of command line utilities. They are available as standard Java applications.</p>
+
+<p>See the Dependencies page for instructions on how to set your classpath in order to run
+PDFBox tools as Java applications.</p>
+
+<p><strong>Table of Contents</strong><br>
+<a href="#decrypt">Decrypt</a>
+<a href="#encrypt">Encrypt</a>
+<a href="#extracttext">ExtractText</a>
+<a href="#overlaypdf">OverlayPDF</a>
+<a href="#pdfdebugger">PDFDebugger</a>
+<a href="#pdfmerger">PDFMerger</a>
+<a href="#pdfsplit">PDFSplit</a>
+<a href="#pdftoimage">PDFToImage</a>
+<a href="#printpdf">PrintPDF</a>
+<a href="#texttopdf">TextToPDF</a>
+<a href="#writedecodeddoc">WriteDecodedDoc</a></p>
+
+<h2 id="decrypt">Decrypt</h2>
+
+<p>This application will decrypt a PDF document.</p>
+
+<p>NOTE: You must have the owner password to decrypt the document!</p>
+
+<p>usage: <code>java -jar pdfbox-app-2.y.z.jar Decrypt [OPTIONS] <inputfile> [outputfile]</code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td>Password to the PDF or certificate in keystore.</td>
+</tr>
+<tr>
+<td>-keyStore</td>
+<td>Path to keystore that holds certificate to decrypt the document. This is only required if the document is encrypted with a certificate, otherwise only the password is required.</td>
+</tr>
+<tr>
+<td>-alias</td>
+<td>The alias to the certificate in the keystore.</td>
+</tr>
+<tr>
+<td>inputfile</td>
+<td>The PDF file to decrypt.</td>
+</tr>
+<tr>
+<td>outputfile</td>
+<td>The file to save the decrypted document to. If left blank then it will be the same as the input file.</td>
+</tr>
+</tbody></table>
+
+<h2 id="encrypt">Encrypt</h2>
+
+<p>This application will encrypt a PDF document.</p>
+
+<p>usage: <code>java -jar pdfbox-app-2.y.z.jar Encrypt [OPTIONS] <password> <inputfile></code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-O</td>
+<td></td>
+<td>The owner password to the PDF, ignored if -certFile is specified.</td>
+</tr>
+<tr>
+<td>-U</td>
+<td></td>
+<td>The user password to the PDF, ignored if -certFile is specified.</td>
+</tr>
+<tr>
+<td>-certFile</td>
+<td></td>
+<td>Path to X.509 cert file.</td>
+</tr>
+<tr>
+<td>-canAssemble</td>
+<td>true</td>
+<td>Set the assemble permission.</td>
+</tr>
+<tr>
+<td>-canExtractContent</td>
+<td>true</td>
+<td>Set the extraction permission.</td>
+</tr>
+<tr>
+<td>-canExtractForAccessibility</td>
+<td>true</td>
+<td>Set the extraction permission.</td>
+</tr>
+<tr>
+<td>-canFillInForm</td>
+<td>true</td>
+<td>Set the fill in form permission.</td>
+</tr>
+<tr>
+<td>-canModify</td>
+<td>true</td>
+<td>Set the modify permission.</td>
+</tr>
+<tr>
+<td>-canModifyAnnotations</td>
+<td>true</td>
+<td>Set the modify annots permission.</td>
+</tr>
+<tr>
+<td>-canPrint</td>
+<td>true</td>
+<td>Set the print permission.</td>
+</tr>
+<tr>
+<td>-canPrintDegraded</td>
+<td>true</td>
+<td>Set the print degraded permission.</td>
+</tr>
+<tr>
+<td>-keyLength</td>
+<td>40, 128 or 256</td>
+<td>The number of bits for the encryption key. For 128 and above bits <a href="http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html">Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files</a> must be installed.</td>
+</tr>
+<tr>
+<td>inputfile</td>
+<td></td>
+<td>The PDF file to encrypt.</td>
+</tr>
+<tr>
+<td>outputfile</td>
+<td></td>
+<td>The file to save the encrypted document to. If left blank then it will be the same as the input file.</td>
+</tr>
+</tbody></table>
+
+<h2 id="extracttext">ExtractText</h2>
+
+<p>This application will extract all text from the given PDF document.</p>
+
+<p>usage: <code>java -jar pdfbox-app-2.y.z.jar ExtractText [OPTIONS] <inputfile> [Text file]</code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td></td>
+<td>The password to the PDF document.</td>
+</tr>
+<tr>
+<td>-encoding</td>
+<td>default encoding</td>
+<td>The encoding type of the text file, e.g. ISO-8859-1, UTF-8, UTF-16BE.</td>
+</tr>
+<tr>
+<td>-console</td>
+<td>false</td>
+<td>Send text to console instead of file.</td>
+</tr>
+<tr>
+<td>-html</td>
+<td>false</td>
+<td>Output in HTML format instead of raw text.</td>
+</tr>
+<tr>
+<td>-sort</td>
+<td>false</td>
+<td>Sort the text before writing.</td>
+</tr>
+<tr>
+<td>-ignoreBeads</td>
+<td>false</td>
+<td>Disables the separation by beads.</td>
+</tr>
+<tr>
+<td>-force</td>
+<td>false</td>
+<td>Enables pdfbox to ignore corrupt objects.</td>
+</tr>
+<tr>
+<td>-debug</td>
+<td>false</td>
+<td>Enables debug output about the time consumption of every stage.</td>
+</tr>
+<tr>
+<td>-startPage</td>
+<td>1</td>
+<td>The first page to extract, one based.</td>
+</tr>
+<tr>
+<td>-endPage</td>
+<td>Integer.MAX_INT</td>
+<td>The last page to extract, one based.</td>
+</tr>
+</tbody></table>
+
+<h2 id="overlaypdf">OverlayPDF</h2>
+
+<p>This application will overlay one document with the content of another document</p>
+
+<p>usage: <code>java -jar pdfbox-app-2.y.z.jar OverlayPDF <input.pdf> [OPTIONS] <output.pdf></code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>inputfile</td>
+<td></td>
+<td>The PDF file to be overlayed.</td>
+</tr>
+<tr>
+<td>defaultOverlay.pdf</td>
+<td></td>
+<td>Default overlay file.</td>
+</tr>
+<tr>
+<td>-odd oddPageOverlay.pdf</td>
+<td></td>
+<td>Overlay file used for odd pages.</td>
+</tr>
+<tr>
+<td>-even evenPageOverlay.pdf</td>
+<td></td>
+<td>Overlay file used for even pages.</td>
+</tr>
+<tr>
+<td>-first firstPageOverlay.pdf</td>
+<td></td>
+<td>Overlay file used for the first page.</td>
+</tr>
+<tr>
+<td>-last lastPageOverlay.pdf</td>
+<td></td>
+<td>Overlay file used for the last pages.</td>
+</tr>
+<tr>
+<td>-page pageNumber specificPageOverlay.pdf</td>
+<td></td>
+<td>overlay file used for the given page number, may occur more than once.</td>
+</tr>
+<tr>
+<td>-position</td>
+<td>background</td>
+<td>Where to put the overlay, foreground or background.</td>
+</tr>
+<tr>
+<td>outputfile</td>
+<td></td>
+<td>The resulting pdf file.</td>
+</tr>
+</tbody></table>
+
+<p>Examples:</p>
+
+<ul>
+<li>OverlayPDF input.pdf overlay.pdf output.pdf</li>
+<li>OverlayPDF input.pdf defaultOverlay.pdf -page 10 overlayForPage10.pdf -position foreground output.pdf</li>
+<li>OverlayPDF input.pdf -odd oddOverlay.pdf -even evenOverlay.pdf output.pdf</li>
+</ul>
+
+<h2 id="pdfdebugger">PDFDebugger</h2>
+
+<p>This application will take an existing PDF document and allows to analyze and inspect the internal structure.
+It is used as replacement for the PDFReader which was removed in 2.0.0.</p>
+
+<p>usage: <code>java -jar pdfbox-app-2.y.z.jar PDFDebugger [inputfile]</code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td></td>
+<td>The password to the PDF document.</td>
+</tr>
+<tr>
+<td>-viewstructure</td>
+<td></td>
+<td>Activates the "view structure" view on startup.</td>
+</tr>
+<tr>
+<td>inputfile</td>
+<td></td>
+<td>the name of an optional PDF file to open.</td>
+</tr>
+</tbody></table>
+
+<h2 id="pdfmerger">PDFMerger</h2>
+
+<p>This application will take a list of pdf documents and merge them, saving the result in a new document.</p>
+
+<p>usage: <code>java -jar pdfbox-app-2.y.z.jar PDFMerger <Source PDF files (2 ..n)> <Target PDF file></code></p>
+
+<h2 id="pdfsplit">PDFSplit</h2>
+
+<p>This application will take an existing PDF document and split it into a number of other documents</p>
+
+<p>usage: <code>java -jar pdfbox-app-2.y.z.jar PDFSplit [OPTIONS] <PDF file></code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td></td>
+<td>The password to the PDF document.</td>
+</tr>
+<tr>
+<td>-split</td>
+<td></td>
+<td>Number of pages of every splitted part of the pdf.</td>
+</tr>
+<tr>
+<td>-startPage</td>
+<td></td>
+<td>The page to start at.</td>
+</tr>
+<tr>
+<td>-endPage</td>
+<td></td>
+<td>The page to stop at.</td>
+</tr>
+</tbody></table>
+
+<p>Examples:</p>
+
+<ul>
+<li>PDFSplit -split 2 sample_with_13_pages.pdf will split the pdf in pieces of 2 pages each except the last which will contain 1 page only.</li>
+<li>PDFSplit -startPage 5 sample_with_13_pages.pdf will provide a pdf containing all pages of the source pdf starting at page 5</li>
+<li>PDFSplit -startPage 5 -endPage 10 sample_with_13_pages.pdf will provide a pdf containing all pages from 5 to 10 of the source pdf</li>
+<li>PDFSplit -split 2 -startPage 5 -endPage 10 sample_with_13_pages.pdf will provide 3 pdfs containing all pages from 5 to 10 of the source pdf 2 pages each</li>
+</ul>
+
+<h2 id="pdftoimage">PDFToImage</h2>
+
+<p>This application will create an image for every page in the PDF document.</p>
+
+<p>usage: <code>java -jar pdfbox-app-2.y.z.jar PDFToImage [OPTIONS] <PDF file></code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td></td>
+<td>The password to the PDF document.</td>
+</tr>
+<tr>
+<td>-imageType</td>
+<td>jpg</td>
+<td>The image type to write to. Currently only jpg or png.</td>
+</tr>
+<tr>
+<td>-outputPrefix</td>
+<td>Name of PDF document</td>
+<td>The prefix to the image file.</td>
+</tr>
+<tr>
+<td>-startPage</td>
+<td>1</td>
+<td>The first page to convert, one based.</td>
+</tr>
+<tr>
+<td>-endPage</td>
+<td>Integer.MAX_INT</td>
+<td>The last page to convert, one based.</td>
+</tr>
+</tbody></table>
+
+<h2 id="printpdf">PrintPDF</h2>
+
+<p>This application will send a pdf document to the printer.</p>
+
+<p class="alert alert-info">You must have the correct permissions to print the document!</p>
+
+<p>usage: <code>java -jar pdfbox-app-2.y.z.jar PrintPDF [OPTIONS] <inputfile></code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td>The password to decrypt the PDF.</td>
+</tr>
+<tr>
+<td>-silentPrint</td>
+<td>Print the PDF without prompting for a printer.</td>
+</tr>
+<tr>
+<td>inputfile</td>
+<td>The PDF file to print.</td>
+</tr>
+</tbody></table>
+
+<h2 id="texttopdf">TextToPDF</h2>
+
+<p>This application will create a PDF document from a text file.</p>
+
+<p>usage: <code>java -jar pdfbox-app-2.y.z.jar TextToPDF [OPTIONS] <outputfile> <textfile></code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-standardFont</td>
+<td>Helvetica</td>
+<td>The font to use for the text. Either this or -ttf should be specified but not both.</td>
+</tr>
+<tr>
+<td>-ttf</td>
+<td></td>
+<td>The TTF font to use for the text. Either this or -standardFont should be specified but not both.</td>
+</tr>
+<tr>
+<td>-fontSize</td>
+<td>10</td>
+<td>The size of the font to use.</td>
+</tr>
+</tbody></table>
+
+<p>The following font names can be used for the parameter <code>standardFont</code>:</p>
+
+<ul>
+<li>Courier</li>
+<li>Courier-Bold</li>
+<li>Courier-Oblique</li>
+<li>Courier-BoldOblique</li>
+<li>Helvetica</li>
+<li>Helvetica-Bold</li>
+<li>Helvetica-Oblique</li>
+<li>Helvetica-BoldOblique</li>
+<li>Symbol</li>
+<li>Times-Bold</li>
+<li>Times-Roman</li>
+<li>Times-Italic</li>
+<li>Times-BoldItalic</li>
+<li>ZapfDingbats</li>
+</ul>
+
+<h2 id="writedecodeddoc">WriteDecodedDoc</h2>
+
+<p>An application to decompress PDF documents.</p>
+
+<p>usage: <code>java -jar pdfbox-app-2.y.z.jar WriteDecodedDoc <input-file> <output-file></code></p>
+
+<table><thead>
+<tr>
+<th>Command Line Parameter</th>
+<th>Default</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>-password</td>
+<td></td>
+<td>The password to the PDF document.</td>
+</tr>
+<tr>
+<td><input-file></td>
+<td></td>
+<td>The PDF file to decompress</td>
+</tr>
+<tr>
+<td><output-file></td>
+<td></td>
+<td>The destination PDF file</td>
+</tr>
+</tbody></table>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/2.0/cookbook/encryption.html
----------------------------------------------------------------------
diff --git a/content/2.0/cookbook/encryption.html b/content/2.0/cookbook/encryption.html
new file mode 100644
index 0000000..b17bdf0
--- /dev/null
+++ b/content/2.0/cookbook/encryption.html
@@ -0,0 +1,221 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Cookbook - Encrypting a file</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="encrypting-a-file">Encrypting a file</h1>
+
+<p>PDF encryption requires two passwords: the "user password" to open and view the file with restricted permissions, the "owner password" to access the file with all permission.</p>
+
+<h2 id="load-and-save-encrypted">Load and save encrypted</h2>
+
+<p>This small sample shows how to encrypt a file so that it can be viewed, but not printed..</p>
+<div class="highlight"><pre><code class="language-" data-lang="">PDDocument doc = PDDocument.load("filename.pdf");
+
+// Define the length of the encryption key.
+// Possible values are 40, 128 or 256.
+int keyLength = 256;
+
+AccessPermission ap = new AccessPermission();
+
+// disable printing, everything else is allowed
+ap.setCanPrint(false);
+
+// owner password (to open the file with all permissions) is "12345"
+// user password (to open the file but with restricted permissions, is empty here)
+StandardProtectionPolicy spp = new StandardProtectionPolicy("12345", "", ap);
+spp.setEncryptionKeyLength(keyLength);
+spp.setPermissions(ap);
+doc.protect(spp);
+
+doc.save("filename-encrypted.pdf");
+doc.close();
+</code></pre></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/2.0/dependencies.html
----------------------------------------------------------------------
diff --git a/content/2.0/dependencies.html b/content/2.0/dependencies.html
new file mode 100644
index 0000000..972b947
--- /dev/null
+++ b/content/2.0/dependencies.html
@@ -0,0 +1,247 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Dependencies</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <p class="alert alert-warning">This is an unreleased development preview and may change without notice.</p>
+
+<h1 id="dependencies">Dependencies</h1>
+
+<p>PDFBox has the following basic dependencies:</p>
+
+<ul>
+<li>Java 6</li>
+<li><a href="http://commons.apache.org/logging/">commons-logging</a></li>
+</ul>
+
+<p>Commons Logging is a generic wrapper around different logging frameworks, so you'll either need to also use a logging library like <a href="http://logging.apache.org/log4j/">log4j</a>
+or let commons-logging fall back to the standard <a href="http://java.sun.com/j2se/1.4.2/docs/guide/util/logging/overview.html">java.util.logging API</a>
+included in the Java platform.</p>
+
+<h2 id="optional-components">Optional components</h2>
+
+<p>PDFBox does not ship with all features enabled. Third party compoenets are necessary to get full support for certain functionality.</p>
+
+<h3 id="jai-image-i-o">JAI Image I/O</h3>
+
+<p>PDF supports embedded image files, however support for some formats require third party libraries which are distributed under terms incompatible with the Apache 2.0 license:</p>
+
+<ul>
+<li>Reading <strong>JBIG2</strong> images: <a href="https://github.com/levigo/jbig2-imageio">JBIG2 ImageIO</a> or <a href="https://github.com/Borisvl/JBIG2-Image-Decoder">JBIG2-Image-Decoder
+</a></li>
+<li>Reading <strong>JPEG 2000 (JPX)</strong> images: <a href="https://java.net/projects/jai-imageio-core">JAI Image I/O Tools Core</a></li>
+<li>Writing <strong>TIFF</strong> images requires <em>JAI Image I/O Tools Core</em> also.</li>
+</ul>
+
+<p>These libraries are optional and will be loaded if present on the classpath, otherwise support for these image formats will be disable and a warning will be logged when an unsupported image is encountered.</p>
+
+<p>Maven dependencies for these components can be found in <a href="https://svn.apache.org/viewvc/pdfbox/trunk/parent/pom.xml?view=markup">parent/pom.xml</a>. Please make sure that any third party licenses are suitable for your project.</p>
+
+<h3 id="encryption-and-signing">Encryption and Signing</h3>
+
+<p>Encrypting and sigining PDFs requires the <em>bcprov</em> and <em>bcmail</em> libraries from the <a href="http://www.bouncycastle.org/">Legion of the Bouncy Castle</a>. These can be included in your Maven project using the following dependencies:</p>
+<div class="highlight"><pre><code class="language-" data-lang=""><dependency>
+ <groupId>org.bouncycastle</groupId>
+ <artifactId>bcprov-jdk15on</artifactId>
+ <version>1.53</version>
+</dependency>
+
+<dependency>
+ <groupId>org.bouncycastle</groupId>
+ <artifactId>bcmail-jdk15on</artifactId>
+ <version>1.53</version>
+</dependency>
+</code></pre></div>
+<h3 id="java-cryptography-extension-jce">Java Cryptography Extension (JCE)</h3>
+
+<p>256-bit AES encryption requires a JDK with "unlimited strength" cryptography, which requires extra files to be installed. For JDK 7, see <a href="http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html">Java Cryptography Extension (JCE)</a>. If these files are not installed, building PDFBox will throw an exception with the following message:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">JCE unlimited strength jurisdiction policy files are not installed
+</code></pre></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/2.0/examples.html
----------------------------------------------------------------------
diff --git a/content/2.0/examples.html b/content/2.0/examples.html
new file mode 100644
index 0000000..1379c4e
--- /dev/null
+++ b/content/2.0/examples.html
@@ -0,0 +1,199 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Examples</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <p class="alert alert-warning">This is an unreleased development preview and may change without notice.</p>
+
+<h1 id="examples">Examples</h1>
+
+<p>This content is under construction. Please look at our <a href="https://svn.apache.org/viewvc/pdfbox/trunk/examples/src/main/java/org/apache/pdfbox/examples/">examples</a> directory in SVN.</p>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/2.0/getting-started.html
----------------------------------------------------------------------
diff --git a/content/2.0/getting-started.html b/content/2.0/getting-started.html
new file mode 100644
index 0000000..59963f0
--- /dev/null
+++ b/content/2.0/getting-started.html
@@ -0,0 +1,220 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Getting Started</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <p class="alert alert-warning">This is an unreleased development preview and may change without notice.</p>
+
+<h1 id="getting-started">Getting Started</h1>
+
+<p>This content is under construction.</p>
+
+<h2 id="maven">Maven</h2>
+
+<p>To use the latest 2.0 snapshot release from the SVN trunk, you'll need to add the following dependency:</p>
+<div class="highlight"><pre><code class="language-" data-lang=""><dependency>
+ <groupId>org.apache.pdfbox</groupId>
+ <artifactId>pdfbox</artifactId>
+ <version>2.0.0-SNAPSHOT</version>
+</dependency>
+</code></pre></div>
+<p>You'll also need to add the following repository:</p>
+<div class="highlight"><pre><code class="language-" data-lang=""><repository>
+ <id>ApacheSnapshot</id>
+ <name>Apache Repository</name>
+ <url>https://repository.apache.org/content/groups/snapshots/</url>
+ <snapshots>
+ <enabled>true</enabled>
+ </snapshots>
+</repository>
+</code></pre></div>
+<p>Please note that this will use the latest <strong>unstable</strong> development snapshot.</p>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
[4/6] pdfbox-docs git commit: Site checkin for project Apache PDFBox
Website
Posted by ms...@apache.org.
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/1.8/cookbook/workingwithfonts.html
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/workingwithfonts.html b/content/1.8/cookbook/workingwithfonts.html
new file mode 100644
index 0000000..5156ffe
--- /dev/null
+++ b/content/1.8/cookbook/workingwithfonts.html
@@ -0,0 +1,355 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Cookbook - Working with Fonts</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="working-with-fonts">Working with Fonts</h1>
+
+<h2 id="standard-14-fonts">Standard 14 Fonts</h2>
+
+<p>The PDF specification states that a standard set of 14 fonts will always be available when consuming PDF documents. In PDFBox these are defined as constants in the PDType1Font class.</p>
+
+<table><thead>
+<tr>
+<th>Standard Font</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>PDType1Font.TIMES_ROMAN</td>
+<td>Times regular</td>
+</tr>
+<tr>
+<td>PDType1Font.TIMES_BOLD</td>
+<td>Times bold</td>
+</tr>
+<tr>
+<td>PDType1Font.TIMES_ITALIC</td>
+<td>Times italic</td>
+</tr>
+<tr>
+<td>PDType1Font.TIMES_BOLD_ITALIC</td>
+<td>Times bold italic</td>
+</tr>
+<tr>
+<td>PDType1Font.HELVETICA</td>
+<td>Helvetica regular</td>
+</tr>
+<tr>
+<td>PDType1Font.HELVETICA_BOLD</td>
+<td>Helvetica bold</td>
+</tr>
+<tr>
+<td>PDType1Font.HELVETICA_OBLIQUE</td>
+<td>Helvetica italic</td>
+</tr>
+<tr>
+<td>PDType1Font.HELVETICA_BOLD_OBLIQUE</td>
+<td>Helvetica bold italic</td>
+</tr>
+<tr>
+<td>PDType1Font.COURIER</td>
+<td>Courier</td>
+</tr>
+<tr>
+<td>PDType1Font.COURIER_BOLD</td>
+<td>Courier bold</td>
+</tr>
+<tr>
+<td>PDType1Font.COURIER_OBLIQUE</td>
+<td>Courier italic</td>
+</tr>
+<tr>
+<td>PDType1Font.COURIER_BOLD_OBLIQUE</td>
+<td>Courier bold italic</td>
+</tr>
+<tr>
+<td>PDType1Font.SYMBOL</td>
+<td>Symbol Set</td>
+</tr>
+<tr>
+<td>PDType1Font.ZAPF_DINGBATS</td>
+<td>Dingbat Typeface</td>
+</tr>
+</tbody></table>
+
+<h2 id="hello-world-using-a-pdf-base-font">Hello World using a PDF base font</h2>
+
+<p>This small sample shows how to create a new document and print the text "Hello World" using one of the PDF base fonts.</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="c1">// Create a document and add a page to it</span>
+<span class="n">PDDocument</span> <span class="n">document</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDDocument</span><span class="o">();</span>
+<span class="n">PDPage</span> <span class="n">page</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDPage</span><span class="o">();</span>
+<span class="n">document</span><span class="o">.</span><span class="na">addPage</span><span class="o">(</span> <span class="n">page</span> <span class="o">);</span>
+
+<span class="c1">// Create a new font object selecting one of the PDF base fonts</span>
+<span class="n">PDFont</span> <span class="n">font</span> <span class="o">=</span> <span class="n">PDType1Font</span><span class="o">.</span><span class="na">HELVETICA_BOLD</span><span class="o">;</span>
+
+<span class="c1">// Start a new content stream which will "hold" the to be created content</span>
+<span class="n">PDPageContentStream</span> <span class="n">contentStream</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDPageContentStream</span><span class="o">(</span><span class="n">document</span><span class="o">,</span> <span class="n">page</span><span class="o">);</span>
+
+<span class="c1">// Define a text content stream using the selected font, moving the cursor and drawing the text "Hello World"</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">beginText</span><span class="o">();</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">setFont</span><span class="o">(</span> <span class="n">font</span><span class="o">,</span> <span class="mi">12</span> <span class="o">);</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">moveTextPositionByAmount</span><span class="o">(</span> <span class="mi">100</span><span class="o">,</span> <span class="mi">700</span> <span class="o">);</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">drawString</span><span class="o">(</span> <span class="s">"Hello World"</span> <span class="o">);</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">endText</span><span class="o">();</span>
+
+<span class="c1">// Make sure that the content stream is closed:</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+
+<span class="c1">// Save the results and ensure that the document is properly closed:</span>
+<span class="n">document</span><span class="o">.</span><span class="na">save</span><span class="o">(</span> <span class="s">"Hello World.pdf"</span><span class="o">);</span>
+<span class="n">document</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+</code></pre></div>
+<h2 id="hello-world-using-a-truetype-font">Hello World using a TrueType font</h2>
+
+<p>This small sample shows how to create a new document and print the text "Hello World" using a TrueType font.</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="c1">// Create a document and add a page to it</span>
+<span class="n">PDDocument</span> <span class="n">document</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDDocument</span><span class="o">();</span>
+<span class="n">PDPage</span> <span class="n">page</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDPage</span><span class="o">();</span>
+<span class="n">document</span><span class="o">.</span><span class="na">addPage</span><span class="o">(</span> <span class="n">page</span> <span class="o">);</span>
+
+<span class="c1">// Create a new font object by loading a TrueType font into the document</span>
+<span class="n">PDFont</span> <span class="n">font</span> <span class="o">=</span> <span class="n">PDTrueTypeFont</span><span class="o">.</span><span class="na">loadTTF</span><span class="o">(</span><span class="n">document</span><span class="o">,</span> <span class="s">"Arial.ttf"</span><span class="o">);</span>
+
+<span class="c1">// Start a new content stream which will "hold" the to be created content</span>
+<span class="n">PDPageContentStream</span> <span class="n">contentStream</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDPageContentStream</span><span class="o">(</span><span class="n">document</span><span class="o">,</span> <span class="n">page</span><span class="o">);</span>
+
+<span class="c1">// Define a text content stream using the selected font, moving the cursor and drawing the text "Hello World"</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">beginText</span><span class="o">();</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">setFont</span><span class="o">(</span> <span class="n">font</span><span class="o">,</span> <span class="mi">12</span> <span class="o">);</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">moveTextPositionByAmount</span><span class="o">(</span> <span class="mi">100</span><span class="o">,</span> <span class="mi">700</span> <span class="o">);</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">drawString</span><span class="o">(</span> <span class="s">"Hello World"</span> <span class="o">);</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">endText</span><span class="o">();</span>
+
+<span class="c1">// Make sure that the content stream is closed:</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+
+<span class="c1">// Save the results and ensure that the document is properly closed:</span>
+<span class="n">document</span><span class="o">.</span><span class="na">save</span><span class="o">(</span> <span class="s">"Hello World.pdf"</span><span class="o">);</span>
+<span class="n">document</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+</code></pre></div>
+<p>While it is recommended to embed all fonts for greatest portability not all PDF producer
+applications will do this. When displaying a PDF it is necessary to find an external font to use.
+PDFBox will look for a mapping file to use when substituting fonts.</p>
+
+<p>PDFBox will load Resources/PDFBox_External_Fonts.properties off of the classpath to map font
+names to TTF font files. The UNKNOWN_FONT property in that file will tell PDFBox which font to
+use when no mapping exists. </p>
+
+<h2 id="hello-world-using-a-postscript-type1-font">Hello World using a Postscript Type1 font</h2>
+
+<p>This small sample shows how to create a new document and print the text "Hello World" using a Postscript Type1 font.</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="c1">// Create a document and add a page to it</span>
+<span class="n">PDDocument</span> <span class="n">document</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDDocument</span><span class="o">();</span>
+<span class="n">PDPage</span> <span class="n">page</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDPage</span><span class="o">();</span>
+<span class="n">document</span><span class="o">.</span><span class="na">addPage</span><span class="o">(</span> <span class="n">page</span> <span class="o">);</span>
+
+<span class="c1">// Create a new font object by loading a Postscript Type 1 font into the document</span>
+<span class="n">PDFont</span> <span class="n">font</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDType1AfmPfbFont</span><span class="o">(</span><span class="n">doc</span><span class="o">,</span><span class="s">"cfm.afm"</span><span class="o">);</span>
+
+<span class="c1">// Start a new content stream which will "hold" the to be created content</span>
+<span class="n">PDPageContentStream</span> <span class="n">contentStream</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDPageContentStream</span><span class="o">(</span><span class="n">document</span><span class="o">,</span> <span class="n">page</span><span class="o">);</span>
+
+<span class="c1">// Define a text content stream using the selected font, moving the cursor and drawing the text "Hello World"</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">beginText</span><span class="o">();</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">setFont</span><span class="o">(</span> <span class="n">font</span><span class="o">,</span> <span class="mi">12</span> <span class="o">);</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">moveTextPositionByAmount</span><span class="o">(</span> <span class="mi">100</span><span class="o">,</span> <span class="mi">700</span> <span class="o">);</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">drawString</span><span class="o">(</span> <span class="s">"Hello World"</span> <span class="o">);</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">endText</span><span class="o">();</span>
+
+<span class="c1">// Make sure that the content stream is closed:</span>
+<span class="n">contentStream</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+
+<span class="c1">// Save the results and ensure that the document is properly closed:</span>
+<span class="n">document</span><span class="o">.</span><span class="na">save</span><span class="o">(</span> <span class="s">"Hello World.pdf"</span><span class="o">);</span>
+<span class="n">document</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+</code></pre></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/1.8/cookbook/workingwithmetadata.html
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/workingwithmetadata.html b/content/1.8/cookbook/workingwithmetadata.html
new file mode 100644
index 0000000..7282671
--- /dev/null
+++ b/content/1.8/cookbook/workingwithmetadata.html
@@ -0,0 +1,248 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Cookbook - Working with Metadata</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="working-with-metadata">Working with Metadata</h1>
+
+<h2 id="introduction">Introduction</h2>
+
+<p>PDF documents can contain information describing the document itself or certain objects
+within the document such as the author of the document or it's creation date.
+Basic information can be set and retrieved using the PDDocumentInformation object.</p>
+
+<p>In addition to that more metadata can be retrieved using the XML metadata as decribed below.
+Getting basic Metadata</p>
+
+<p>To set or retrieve basic information about the document the PDDocumentInformation object
+provides a high level API to that information:</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">PDDocumentInformation</span> <span class="n">info</span> <span class="o">=</span> <span class="n">document</span><span class="o">.</span><span class="na">getDocumentInformation</span><span class="o">();</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span> <span class="s">"Page Count="</span> <span class="o">+</span> <span class="n">document</span><span class="o">.</span><span class="na">getNumberOfPages</span><span class="o">()</span> <span class="o">);</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span> <span class="s">"Title="</span> <span class="o">+</span> <span class="n">info</span><span class="o">.</span><span class="na">getTitle</span><span class="o">()</span> <span class="o">);</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span> <span class="s">"Author="</span> <span class="o">+</span> <span class="n">info</span><span class="o">.</span><span class="na">getAuthor</span><span class="o">()</span> <span class="o">);</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span> <span class="s">"Subject="</span> <span class="o">+</span> <span class="n">info</span><span class="o">.</span><span class="na">getSubject</span><span class="o">()</span> <span class="o">);</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span> <span class="s">"Keywords="</span> <span class="o">+</span> <span class="n">info</span><span class="o">.</span><span class="na">getKeywords</span><span class="o">()</span> <span class="o">);</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span> <span class="s">"Creator="</span> <span class="o">+</span> <span class="n">info</span><span class="o">.</span><span class="na">getCreator</span><span class="o">()</span> <span class="o">);</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span> <span class="s">"Producer="</span> <span class="o">+</span> <span class="n">info</span><span class="o">.</span><span class="na">getProducer</span><span class="o">()</span> <span class="o">);</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span> <span class="s">"Creation Date="</span> <span class="o">+</span> <span class="n">info</span><span class="o">.</span><span class="na">getCreationDate</span><span class="o">()</span> <span class="o">);</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span> <span class="s">"Modification Date="</span> <span class="o">+</span> <span class="n">info</span><span class="o">.</span><span class="na">getModificationDate</span><span class="o">());</span>
+<span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span> <span class="s">"Trapped="</span> <span class="o">+</span> <span class="n">info</span><span class="o">.</span><span class="na">getTrapped</span><span class="o">()</span> <span class="o">);</span>
+</code></pre></div>
+<h2 id="accessing-pdf-metadata">Accessing PDF Metadata</h2>
+
+<p>See class:org.apache.pdfbox.pdmodel.common.PDMetadata<br>
+See example:AddMetadataFromDocInfo<br>
+See Adobe Documentation:XMP Specification </p>
+
+<p>PDF documents can have XML metadata associated with certain objects within a PDF document.
+For example, the following PD Model objects have the ability to contain metadata:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">PDDocumentCatalog
+PDPage
+PDXObject
+PDICCBased
+PDStream
+</code></pre></div>
+<p>The metadata that is stored in PDF objects conforms to the XMP specification, it is
+recommended that you review that specification. Currently there is no high level API for
+managing the XML metadata, PDFBox uses standard java InputStream/OutputStream to retrieve
+or set the XML metadata.</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">PDDocument</span> <span class="n">doc</span> <span class="o">=</span> <span class="n">PDDocument</span><span class="o">.</span><span class="na">load</span><span class="o">(</span> <span class="o">...</span> <span class="o">);</span>
+<span class="n">PDDocumentCatalog</span> <span class="n">catalog</span> <span class="o">=</span> <span class="n">doc</span><span class="o">.</span><span class="na">getDocumentCatalog</span><span class="o">();</span>
+<span class="n">PDMetadata</span> <span class="n">metadata</span> <span class="o">=</span> <span class="n">catalog</span><span class="o">.</span><span class="na">getMetadata</span><span class="o">();</span>
+
+<span class="c1">//to read the XML metadata</span>
+<span class="n">InputStream</span> <span class="n">xmlInputStream</span> <span class="o">=</span> <span class="n">metadata</span><span class="o">.</span><span class="na">createInputStream</span><span class="o">();</span>
+
+<span class="c1">//or to write new XML metadata</span>
+<span class="n">InputStream</span> <span class="n">newXMPData</span> <span class="o">=</span> <span class="o">...;</span>
+<span class="n">PDMetadata</span> <span class="n">newMetadata</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDMetadata</span><span class="o">(</span><span class="n">doc</span><span class="o">,</span> <span class="n">newXMLData</span><span class="o">,</span> <span class="kc">false</span> <span class="o">);</span>
+<span class="n">catalog</span><span class="o">.</span><span class="na">setMetadata</span><span class="o">(</span> <span class="n">newMetadata</span> <span class="o">);</span>
+</code></pre></div>
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/1.8/dependencies.html
----------------------------------------------------------------------
diff --git a/content/1.8/dependencies.html b/content/1.8/dependencies.html
new file mode 100644
index 0000000..7062982
--- /dev/null
+++ b/content/1.8/dependencies.html
@@ -0,0 +1,288 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Dependencies</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="dependencies">Dependencies</h1>
+
+<p>PDFBox consists of a three related components and depends on a few external libraries. This page describes what these libraries are and how to include them in your application.</p>
+
+<h2 id="core-components">Core components</h2>
+
+<p class="alert alert-info">These components are needed during runtime, development and testing dependent on the details below.</p>
+
+<p>The three PDFBox components are named <code>pdfbox</code>, <code>fontbox</code> and <code>jempbox</code>. The Maven groupId of all PDFBox components is org.apache.pdfbox.</p>
+
+<h3 id="minimum-requirement">Minimum Requirement</h3>
+
+<ul>
+<li>Java 1.5</li>
+<li><a href="http://commons.apache.org/logging/">commons-logging</a></li>
+</ul>
+
+<p>The main PDFBox component, pdfbox, has a hard dependency on the <a href="http://commons.apache.org/logging/">commons-logging</a> library.
+Commons Logging is a generic wrapper around different logging frameworks, so you'll either need to also use a logging library like <a href="http://logging.apache.org/log4j/">log4j</a>
+or let commons-logging fall back to the standard <a href="http://java.sun.com/j2se/1.4.2/docs/guide/util/logging/overview.html">java.util.logging API</a>
+included in the Java platform.</p>
+
+<h3 id="font-handling">Font Handling</h3>
+
+<p>For font handling the fontbox component is needed.</p>
+
+<h3 id="xmp-metadata">XMP Metadata</h3>
+
+<p>To support XMP metadata the jembox component is needed.</p>
+
+<p>To add the pdfbox, fontbox, jempbox and commons-logging jars to your application, the easiest thing is to declare the Maven dependency shown below. This gives you the main
+pdfbox library directly and the other required jars as transitive dependencies.</p>
+<div class="highlight"><pre><code class="language-" data-lang=""><dependency>
+ <groupId>org.apache.pdfbox</groupId>
+ <artifactId>pdfbox</artifactId>
+ <version>...</version>
+</dependency>
+</code></pre></div>
+<p>Set the version field to the latest stable PDFBox version.</p>
+
+<h2 id="optional-dependencies">Optional dependencies</h2>
+
+<p>Some features in PDFBox depend on optional external libraries. You can enable these features simply by including the required libraries in the classpath of your application.</p>
+
+<h3 id="extented-image-format-support">Extented Image Format Support</h3>
+
+<p>To support JBIG2 and writing TIFF images additional libraries are needed. </p>
+
+<p class="alert alert-warning">The image plugins described below are not part of the PDFBox distribution because of incompatible licensing terms. Please make sure to check if the licensing terms are compatible to your usage.</p>
+
+<p>For <strong>JBIG2</strong> support a Java ImageIO Plugin such as the <a href="https://github.com/levigo/jbig2-imageio">Levigo Plugin</a> or <a href="https://github.com/Borisvl/JBIG2-Image-Decoder">JBIG2-Image-Decoder
+</a> will be needed. </p>
+
+<p>To write <strong>TIFF</strong> images a JAI ImageIO Core library will be needed. </p>
+
+<h4 id="pdf-encryption-and-signing">PDF Encryption and Signing</h4>
+
+<p>The most notable such optional feature is support for PDF encryption. Instead of implementing its own encryption algorithms, PDFBox uses libraries from the
+<a href="http://www.bouncycastle.org/">Legion of the Bouncy Castle</a>. Both the bcprov and bcmail libraries are needed and can be included using the Maven dependencies shown below.</p>
+<div class="highlight"><pre><code class="language-" data-lang=""><dependency>
+ <groupId>org.bouncycastle</groupId>
+ <artifactId>bcprov-jdk15</artifactId>
+ <version>1.44</version>
+</dependency>
+<dependency>
+ <groupId>org.bouncycastle</groupId>
+ <artifactId>bcmail-jdk15</artifactId>
+ <version>1.44</version>
+</dependency>
+</code></pre></div>
+<p><br/></p>
+
+<h4 id="support-for-bidirectional-languages">Support for bidirectional languages</h4>
+
+<p>Another important optional feature is support for bidirectional languages like Arabic. PDFBox uses the ICU4J library from the
+<a href="http://site.icu-project.org/">International Components for Unicode</a> (ICU) project to support such languages in PDF documents. To add the ICU4J jar to your project,
+use the following Maven dependency.</p>
+<div class="highlight"><pre><code class="language-" data-lang=""><dependency>
+ <groupId>com.ibm.icu</groupId>
+ <artifactId>icu4j</artifactId>
+ <version>3.8</version>
+</dependency>
+</code></pre></div>
+<p>PDFBox also contains extra support for use with the <a href="http://lucene.apache.org/">Lucene</a> and <a href="http://ant.apache.org/">Ant</a> projects. Since in these cases PDFBox is just an
+add-on feature to these projects, you should first set up your application to use Lucene or Ant and then add PDFBox support as described on this page.</p>
+
+<h2 id="dependencies-for-ant-builds">Dependencies for Ant builds</h2>
+
+<p>The above instructions expect that you're using <a href="http://maven.apache.org/">Maven</a> or another build tool like <a href="http://ant.apache.org/ivy/">Ivy</a> that supports Maven dependencies.
+If you instead use tools like <a href="http://ant.apache.org/">Ant</a> where you need to explicitly include all the required library jars in your application, you'll need to do
+something different.</p>
+
+<p>The easiest approach is to run <code>mvn dependency:copy-dependencies</code> inside the pdfbox directory of the latest PDFBox source release. This will copy all the required and optional
+libraries discussed above into the pdfbox/target/dependencies directory. You can then simply copy all the libraries you need from this directory to your application.</p>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/aa929f46/content/1.8/faq.html
----------------------------------------------------------------------
diff --git a/content/1.8/faq.html b/content/1.8/faq.html
new file mode 100644
index 0000000..f5902f9
--- /dev/null
+++ b/content/1.8/faq.html
@@ -0,0 +1,320 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="description" content="The Apache PDFBox™ library is an open source Java tool for working with PDF documents. This project allows creation of new PDF documents, manipulation of existing documents and the ability to extract content from documents. Apache PDFBox also includes several command line utilities. Apache PDFBox is published under the Apache License v2.0.
+">
+
+ <title>Apache PDFBox | Frequently Asked Questions (FAQ)</title>
+
+ <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/assets/open-iconic/font/css/open-iconic-bootstrap.min.css" rel="stylesheet">
+ <link href="/css/pygments-github.css" rel="stylesheet">
+
+ <link href="/css/site.css" rel="stylesheet">
+
+
+
+
+
+
+
+</head>
+
+<body>
+ <nav class="navbar navbar-default navbar-top">
+ <div class="container">
+ <div class="navbar-header">
+ <a href="/index.html">
+ <img class="logo" src="/images/logo-head.gif">
+ </a>
+ <p class="pull-right visible-xs">
+ <button type="button" class="btn btn-primary btn-sm" data-toggle="offcanvas">Menu</button>
+ </p>
+ </div>
+ </div>
+ </nav>
+
+ <div class="container">
+
+ <div class="row row-offcanvas row-offcanvas-left">
+ <div class="col-xs-6 col-sm-3 sidebar-offcanvas" id="sidebar">
+
+ <ul class="sidebar">
+ <li class="sidebar-header">Apache PDFBox</li>
+ <li><a href="/index.html">Overview</a></li>
+ <li><a href="/download.cgi">Downloads</a></li>
+
+ <li class="sidebar-header">Community</li>
+ <li><a href="/support.html">Support</a></li>
+ <li><a href="/mailinglists.html">Mailing Lists</a></li>
+ <li><a href="/team.html">Project Team</a></li>
+
+ <li class="sidebar-header">Documentation</li>
+ <li class="sidebar-node" id="v2-0">
+ <a href="#">2.0.0 (trunk)</a>
+ <ul>
+ <li><a href="/2.0/migration.html">Migration Guide</a></li>
+ <li><a href="/2.0/getting-started.html">Getting Started</a></li>
+ <li><a href="/2.0/examples.html">Examples</a></li>
+ <li><a href="/2.0/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v2-0-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
+ </ul>
+ </li>
+ <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
+ </ul>
+ </li>
+ <li class="sidebar-node" id="v1-8">
+ <a href="#">1.8.10</a>
+ <ul>
+ <li><a href="/1.8/architecture.html">Architecture</a></li>
+ <li><a href="/1.8/dependencies.html">Dependencies</a></li>
+ <li class="sidebar-node" id="v1-8-cookbook">
+ <a href="#">Cookbook</a>
+ <ul>
+ <li><a href="/1.8/cookbook/documentcreation.html">Document Creation</a></li>
+ <li><a href="/1.8/cookbook/textextraction.html">Text Extraction</a></li>
+ <li><a href="/1.8/cookbook/encryption.html">Document Encryption</a></li>
+ <li><a href="/1.8/cookbook/workingwithfonts.html">Working with Fonts</a></li>
+ <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
+ <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
+ <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
+ <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+ </ul>
+ </li>
+ <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+ <li><a href="/docs/1.8.10/javadocs/">API Docs</a></li>
+ <li><a href="/1.8/faq.html">FAQ</a></li>
+ </ul>
+ </li>
+
+ <li class="sidebar-header">Development</li>
+ <li><a href="/building.html">Building from Source</a></li>
+ <li><a href="/codingconventions.html">Coding Conventions</a></li>
+ <li><a href="/siteupdate.html">Update the Website</a></li>
+ <li><a href="https://builds.apache.org/view/All/job/PDFBox-trunk/">Jenkins</a></li>
+ <li><a href="https://travis-ci.org/apache/pdfbox">Travis CI</a></li>
+ <li><a href="https://analysis.apache.org/dashboard/index/org.apache.pdfbox:pdfbox-reactor">SonarQube</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/PDFBOX">JIRA</a></li>
+ <li><a href="/ideas.html">Ideas</a></li>
+ <li><a href="/references.html">External Links</a></li>
+
+ <li class="sidebar-header">Apache Software Foundation</li>
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">ASF Sponsors</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ <div class="col-xs-12 col-sm-9">
+ <h1 id="frequently-asked-questions">Frequently asked questions</h1>
+
+<h3 id="general-questions">General Questions</h3>
+
+<ul>
+<li><a href="#log4j">I am getting the below Log4J warning message, how do I remove it?</a></li>
+<li><a href="#threadsafe">Is PDFBox thread safe?</a></li>
+<li><a href="#notclosed">Why do I get a "Warning: You did not close the PDF Document"?</a></li>
+</ul>
+
+<h3 id="text-extraction">Text Extraction</h3>
+
+<ul>
+<li><a href="#notext">How come I am not getting any text from the PDF document?</a></li>
+<li><a href="#gibberish">How come I am getting gibberish(G38G43G36G51G5) when extracting text?</a></li>
+<li><a href="#fontwidth">What does "java.io.IOException: Can't handle font width" mean?</a></li>
+<li><a href="#permission">Why do I get "You do not have permission to extract text" on some documents?</a></li>
+<li><a href="#partially">Can't we just extract the text without parsing the whole document or extract text as it is parsed?</a></li>
+</ul>
+
+<h2 id="general-questions">General Questions</h2>
+
+<p><a name="log4j"></a></p>
+
+<h3 id="i-am-getting-the-below-log4j-warning-message-how-do-i-remove-it">I am getting the below Log4J warning message, how do I remove it?</h3>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="nl">log4j:</span><span class="n">WARN</span> <span class="n">No</span> <span class="n">appenders</span> <span class="n">could</span> <span class="n">be</span> <span class="n">found</span> <span class="k">for</span> <span class="n">logger</span> <span class="o">(</span><span class="n">org</span><span class="o">.</span><span class="na">apache</span><span class="o">.</span><span class="na">pdfbox</span><span class="o">.</span><span class="na">util</span><span class="o">.</span><span class="na">ResourceLoader</span><span class="o">).</span>
+<span class="nl">log4j:</span><span class="n">WARN</span> <span class="n">Please</span> <span class="n">initialize</span> <span class="n">the</span> <span class="n">log4j</span> <span class="n">system</span> <span class="n">properly</span><span class="o">.</span>
+</code></pre></div>
+<p>This message means that you need to configure the log4j logging system.
+See the <a href="http://logging.apache.org/log4j/1.2/manual.html">log4j documentation</a> for more information.</p>
+
+<p>PDFBox comes with a sample log4j configuration file. To use it you set a system property like this</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">java</span> <span class="o">-</span><span class="n">Dlog4j</span><span class="o">.</span><span class="na">configuration</span><span class="o">=</span><span class="n">log4j</span><span class="o">.</span><span class="na">xml</span> <span class="n">org</span><span class="o">.</span><span class="na">apache</span><span class="o">.</span><span class="na">pdfbox</span><span class="o">.</span><span class="na">ExtractText</span> <span class="o"><</span><span class="n">PDF</span><span class="o">-</span><span class="n">file</span><span class="o">></span> <span class="o"><</span><span class="n">output</span><span class="o">-</span><span class="n">text</span><span class="o">-</span><span class="n">file</span><span class="o">></span>
+</code></pre></div>
+<p>If this is not working for you then you may have to specify the log4j config file using a URL path, like this:</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">log4j</span><span class="o">.</span><span class="na">configuration</span><span class="o">=</span><span class="nl">file:</span><span class="c1">///<path to config file></span>
+</code></pre></div>
+<p>Please see <a href="https://sourceforge.net/forum/forum.php?thread_id=1254229&amp;forum_id=267205">this</a> forum thread
+for more information.</p>
+
+<p><a name="threadsafe"></a></p>
+
+<h3 id="is-pdfbox-thread-safe">Is PDFBox thread safe?</h3>
+
+<p>No! Only one thread may access a single document at a time. You can have multiple threads
+each accessing their own PDDocument object.</p>
+
+<p><a name="notclosed"></a></p>
+
+<h3 id="why-do-i-get-a-quot-warning-you-did-not-close-the-pdf-document-quot">Why do I get a "Warning: You did not close the PDF Document"?</h3>
+
+<p>You need to call close() on the PDDocument inside the finally block, if you
+don't then the document will not be closed properly. Also, you must close all
+PDDocument objects that get created. The following code creates <strong>two</strong>
+PDDocument objects; one from the "new PDDocument()" and the second by the load method.</p>
+<div class="highlight"><pre><code class="language-java" data-lang="java"><span class="n">PDDocument</span> <span class="n">doc</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDDocument</span><span class="o">();</span>
+<span class="k">try</span>
+<span class="o">{</span>
+ <span class="n">doc</span> <span class="o">=</span> <span class="n">PDDocument</span><span class="o">.</span><span class="na">load</span><span class="o">(</span> <span class="s">"my.pdf"</span> <span class="o">);</span>
+<span class="o">}</span>
+<span class="k">finally</span>
+<span class="o">{</span>
+ <span class="k">if</span><span class="o">(</span> <span class="n">doc</span> <span class="o">!=</span> <span class="kc">null</span> <span class="o">)</span>
+ <span class="o">{</span>
+ <span class="n">doc</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
+ <span class="o">}</span>
+<span class="o">}</span>
+</code></pre></div>
+<h2 id="text-extraction">Text Extraction</h2>
+
+<p><a name="notext"></a></p>
+
+<h3 id="how-come-i-am-not-getting-any-text-from-the-pdf-document">How come I am not getting any text from the PDF document?</h3>
+
+<p>Text extraction from a pdf document is a complicated task and there are many factors
+involved that effect the possibility and accuracy of text extraction. It would be helpful
+to the PDFBox team if you could try a couple things.</p>
+
+<ul>
+<li>Open the PDF in Acrobat and try to extract text from there. If Acrobat can extract text then PDFBox
+should be able to as well and it is a bug if it cannot. If Acrobat cannot extract text then PDFBox 'probably' cannot either.</li>
+<li>It might really be an image instead of text. Some PDF documents are just images that have been scanned in.
+You can tell by using the selection tool in Acrobat, if you can't select any text then it is probably an image.</li>
+</ul>
+
+<p><a name="gibberish"></a></p>
+
+<h3 id="how-come-i-am-getting-gibberish-g38g43g36g51g5-when-extracting-text">How come I am getting gibberish(G38G43G36G51G5) when extracting text?</h3>
+
+<p>This is because the characters in a PDF document can use a custom encoding
+instead of unicode or ASCII. When you see gibberish text then it
+probably means that a meaningless internal encoding is being used. The
+only way to access the text is to use OCR. This may be a future
+enhancement.</p>
+
+<p><a name="fontwidth"></a></p>
+
+<h3 id="what-does-quot-java-io-ioexception-can-39-t-handle-font-width-quot-mean">What does "java.io.IOException: Can't handle font width" mean?</h3>
+
+<p>This probably means that the "Resources" directory is not in your classpath. The
+Resources directory is included in the PDFBox jar so this is only a problem if you
+are building PDFBox yourself and not using the binary.</p>
+
+<p><a name="permission"></a></p>
+
+<h3 id="why-do-i-get-quot-you-do-not-have-permission-to-extract-text-quot-on-some-documents">Why do I get "You do not have permission to extract text" on some documents?</h3>
+
+<p>PDF documents have certain security permissions that can be applied to them and two
+passwords associated with them, a user password and a master password. If the "cannot extract text"
+permission bit is set then you need to decrypt the document with the master password in order
+to extract the text.</p>
+
+<p><a name="partially"></a></p>
+
+<h3 id="can-39-t-we-just-extract-the-text-without-parsing-the-whole-document-or-extract-text-as-it-is-parsed">Can't we just extract the text without parsing the whole document or extract text as it is parsed?</h3>
+
+<p>Not really, for a couple reasons.</p>
+
+<ul>
+<li>If the document is encrypted then you need to parse at least until the encryption dictionary before
+you can decrypt.</li>
+<li>Sometimes the PDFont contains vital information needed for text extraction.</li>
+<li>Text on a page does not have to be drawn in reading order. For example: if the page said "Hello World",
+the pdf could have been written such that "World" gets drawn and then the cursor moves to the left and
+the word "Hello" is drawn.</li>
+</ul>
+
+ </div>
+ </div>
+ </div>
+
+ <footer class="footer">
+ <div class="container"
+ <div class="row">
+ <div class="span3">
+ <!-- nothing in here on purpose -->
+ </div>
+ <div class="span9">
+ <p>Copyright © 2009–2015 <a href="http://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br/>Apache PDFBox, PDFBox, Apache, the Apache feather logo and the Apache PDFBox project logos are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </div>
+ </div>
+ </footer>
+
+ <!-- Twitter Bootstrap and jQuery after this line. -->
+ <script src="//code.jquery.com/jquery-latest.js"></script>
+ <script src="/bootstrap/js/bootstrap.min.js"></script>
+ <script type="text/javascript">
+
+ $(document).ready(function () {
+ $('[data-toggle="offcanvas"]').click(function () {
+ $('.row-offcanvas').toggleClass('active')
+ });
+ });
+
+ $(function() {
+ // collapse tree nodes dynamically to support noscript
+ $('.sidebar-node').addClass('collapsed');
+
+
+ // toggle expand/collapse
+ $('.sidebar-node > a').click(function(e) {
+ $(this).parent().toggleClass('collapsed');
+ e.preventDefault();
+ });
+
+ // preserve expand/collapse across page navigation
+ var path = document.location.pathname;
+ if (path.indexOf('/2.0') == 0) {
+ $('#v2-0').removeClass('collapsed');
+ if (path.indexOf('/2.0/cookbook') == 0) {
+ $('#v2-0-cookbook').removeClass('collapsed');
+ }
+ } else {
+ $('#v1-8').removeClass('collapsed');
+ if (path.indexOf('/1.8/cookbook') == 0) {
+ $('#v1-8-cookbook').removeClass('collapsed');
+ }
+ }
+
+ });
+ </script>
+
+</body>
+
+</html>
\ No newline at end of file