Author: buildbot
Date: Wed Aug 19 13:47:19 2015
New Revision: 962331
Log:
Staging update by buildbot for pdfbox
Modified:
websites/staging/pdfbox/trunk/content/ (props changed)
websites/staging/pdfbox/trunk/content/1.8/architecture.html
websites/staging/pdfbox/trunk/content/1.8/commandline.html
websites/staging/pdfbox/trunk/content/1.8/cookbook/documentcreation.html
websites/staging/pdfbox/trunk/content/1.8/cookbook/encryption.html
websites/staging/pdfbox/trunk/content/1.8/cookbook/pdfacreation.html
websites/staging/pdfbox/trunk/content/1.8/cookbook/pdfavalidation.html
websites/staging/pdfbox/trunk/content/1.8/cookbook/textextraction.html
websites/staging/pdfbox/trunk/content/1.8/cookbook/workingwithattachments.html
websites/staging/pdfbox/trunk/content/1.8/cookbook/workingwithfonts.html
websites/staging/pdfbox/trunk/content/1.8/cookbook/workingwithmetadata.html
websites/staging/pdfbox/trunk/content/1.8/dependencies.html
websites/staging/pdfbox/trunk/content/1.8/faq.html
websites/staging/pdfbox/trunk/content/2.0/dependencies.html
websites/staging/pdfbox/trunk/content/2.0/examples.html
websites/staging/pdfbox/trunk/content/2.0/getting-started.html
websites/staging/pdfbox/trunk/content/building.html
websites/staging/pdfbox/trunk/content/codingconventions.html
websites/staging/pdfbox/trunk/content/download.html
websites/staging/pdfbox/trunk/content/errors/403.html
websites/staging/pdfbox/trunk/content/errors/404.html
websites/staging/pdfbox/trunk/content/ideas.html
websites/staging/pdfbox/trunk/content/index.html
websites/staging/pdfbox/trunk/content/mailinglists.html
websites/staging/pdfbox/trunk/content/references.html
websites/staging/pdfbox/trunk/content/sitemap.html
websites/staging/pdfbox/trunk/content/support.html
websites/staging/pdfbox/trunk/content/team.html
Propchange: websites/staging/pdfbox/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Aug 19 13:47:19 2015
@@ -1 +1 @@
-1696588
+1696590
Modified: websites/staging/pdfbox/trunk/content/1.8/architecture.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/1.8/architecture.html (original)
+++ websites/staging/pdfbox/trunk/content/1.8/architecture.html Wed Aug 19
13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,7 +145,18 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="architecture">Architecture</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="architecture">Architecture<a class="headerlink" href="#architecture"
title="Permanent link">¶</a></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>
@@ -153,7 +164,7 @@ ISO-32000 (PDF) Specification</p>
<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>
+<h2 id="quick-introduction-to-the-pdf-format">Quick Introduction to the PDF
format<a class="headerlink" href="#quick-introduction-to-the-pdf-format"
title="Permanent link">¶</a></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
@@ -177,9 +188,9 @@ inspect the underlying structure or to h
doesn't provide the functionality needed.</p>
<p class="alert">It's always the COS model which is represented in the PDF
file.</p>
-<h2 id="the-cos-model">The COS Model</h2>
+<h2 id="the-cos-model">The COS Model<a class="headerlink"
href="#the-cos-model" title="Permanent link">¶</a></h2>
<p>As outlined above the basic PDF objects are represented in PDFBox in the
org.apache.pdfbox.cos package.</p>
-<table>
+<table class="table">
<thead>
<tr>
<th>PDF Type</th>
@@ -267,7 +278,7 @@ doesn't provide the functionality needed
<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>
+<h2 id="the-pd-model">The PD Model<a class="headerlink" href="#the-pd-model"
title="Permanent link">¶</a></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
Modified: websites/staging/pdfbox/trunk/content/1.8/commandline.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/1.8/commandline.html (original)
+++ websites/staging/pdfbox/trunk/content/1.8/commandline.html Wed Aug 19
13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,7 +145,18 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="command-line-tools">Command Line Tools</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="command-line-tools">Command Line Tools<a class="headerlink"
href="#command-line-tools" title="Permanent link">¶</a></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>
@@ -168,11 +179,11 @@ PDFBox tools as Java applications.</p>
</li>
</ul>
</div>
-<h2 id="decrypt">Decrypt</h2>
+<h2 id="decrypt">Decrypt<a class="headerlink" href="#decrypt" title="Permanent
link">¶</a></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>
+<table class="table">
<thead>
<tr>
<th>Command Line Parameter</th>
@@ -202,10 +213,10 @@ PDFBox tools as Java applications.</p>
</tr>
</tbody>
</table>
-<h2 id="encrypt">Encrypt</h2>
+<h2 id="encrypt">Encrypt<a class="headerlink" href="#encrypt" title="Permanent
link">¶</a></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>
+<table class="table">
<thead>
<tr>
<th>Command Line Parameter</th>
@@ -286,10 +297,10 @@ PDFBox tools as Java applications.</p>
</tr>
</tbody>
</table>
-<h2 id="extractText">ExtractText</h2>
+<h2 id="extractText">ExtractText<a class="headerlink" href="#extractText"
title="Permanent link">¶</a></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>
+<table class="table">
<thead>
<tr>
<th>Command Line Parameter</th>
@@ -355,10 +366,10 @@ PDFBox tools as Java applications.</p>
</tr>
</tbody>
</table>
-<h2 id="overlayPDF">OverlayPDF</h2>
+<h2 id="overlayPDF">OverlayPDF<a class="headerlink" href="#overlayPDF"
title="Permanent link">¶</a></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>
+<table class="table">
<thead>
<tr>
<th>Command Line Parameter</th>
@@ -425,12 +436,12 @@ PDFBox tools as Java applications.</p>
<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>
+<h2 id="printPDF">PrintPDF<a class="headerlink" href="#printPDF"
title="Permanent link">¶</a></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>
+<table class="table">
<thead>
<tr>
<th>Command Line Parameter</th>
@@ -452,10 +463,10 @@ PDFBox tools as Java applications.</p>
</tr>
</tbody>
</table>
-<h2 id="pdfDebugger">PDFDebugger</h2>
+<h2 id="pdfDebugger">PDFDebugger<a class="headerlink" href="#pdfDebugger"
title="Permanent link">¶</a></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>
+<table class="table">
<thead>
<tr>
<th>Command Line Parameter</th>
@@ -481,10 +492,10 @@ PDFBox tools as Java applications.</p>
</tr>
</tbody>
</table>
-<h2 id="pdfReader">PDFReader</h2>
+<h2 id="pdfReader">PDFReader<a class="headerlink" href="#pdfReader"
title="Permanent link">¶</a></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>
+<table class="table">
<thead>
<tr>
<th>Command Line Parameter</th>
@@ -510,13 +521,13 @@ PDFBox tools as Java applications.</p>
</tr>
</tbody>
</table>
-<h2 id="pdfMerger">PDFMerger</h2>
+<h2 id="pdfMerger">PDFMerger<a class="headerlink" href="#pdfMerger"
title="Permanent link">¶</a></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>
+<h2 id="pdfSplit">PDFSplit<a class="headerlink" href="#pdfSplit"
title="Permanent link">¶</a></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>
+<table class="table">
<thead>
<tr>
<th>Command Line Parameter</th>
@@ -559,10 +570,10 @@ PDFBox tools as Java applications.</p>
<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>
+<h2 id="pdfToImage">PDFToImage<a class="headerlink" href="#pdfToImage"
title="Permanent link">¶</a></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>
+<table class="table">
<thead>
<tr>
<th>Command Line Parameter</th>
@@ -603,10 +614,10 @@ PDFBox tools as Java applications.</p>
</tr>
</tbody>
</table>
-<h2 id="textToPDF">TextToPDF</h2>
+<h2 id="textToPDF">TextToPDF<a class="headerlink" href="#textToPDF"
title="Permanent link">¶</a></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>
+<table class="table">
<thead>
<tr>
<th>Command Line Parameter</th>
@@ -649,10 +660,10 @@ PDFBox tools as Java applications.</p>
<li>Times-BoldItalic</li>
<li>ZapfDingbats</li>
</ul>
-<h2 id="writeDecodeDoc">WriteDecodedDoc</h2>
+<h2 id="writeDecodeDoc">WriteDecodedDoc<a class="headerlink"
href="#writeDecodeDoc" title="Permanent link">¶</a></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>
+<table class="table">
<thead>
<tr>
<th>Command Line Parameter</th>
Modified:
websites/staging/pdfbox/trunk/content/1.8/cookbook/documentcreation.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/1.8/cookbook/documentcreation.html
(original)
+++ websites/staging/pdfbox/trunk/content/1.8/cookbook/documentcreation.html
Wed Aug 19 13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,8 +145,19 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="document-creation">Document Creation</h1>
-<h2 id="create-a-blank-pdf">Create a blank PDF</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="document-creation">Document Creation<a class="headerlink"
href="#document-creation" title="Permanent link">¶</a></h1>
+<h2 id="create-a-blank-pdf">Create a blank PDF<a class="headerlink"
href="#create-a-blank-pdf" title="Permanent link">¶</a></h2>
<p>This small sample shows how to create a new PDF document using PDFBox.</p>
<div class="codehilite"><pre><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>
@@ -164,7 +175,7 @@
</pre></div>
-<h2 id="hello-world-using-a-pdf-base-font">Hello World using a PDF base
font</h2>
+<h2 id="hello-world-using-a-pdf-base-font">Hello World using a PDF base font<a
class="headerlink" href="#hello-world-using-a-pdf-base-font" title="Permanent
link">¶</a></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="codehilite"><pre><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>
Modified: websites/staging/pdfbox/trunk/content/1.8/cookbook/encryption.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/1.8/cookbook/encryption.html
(original)
+++ websites/staging/pdfbox/trunk/content/1.8/cookbook/encryption.html Wed Aug
19 13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,9 +145,20 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="encrypting-a-file">Encrypting a file</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="encrypting-a-file">Encrypting a file<a class="headerlink"
href="#encrypting-a-file" title="Permanent link">¶</a></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>
+<h2 id="load-and-save-encrypted">Load and save encrypted<a class="headerlink"
href="#load-and-save-encrypted" title="Permanent link">¶</a></h2>
<p>This small sample shows how to encrypt a file so that it can be viewed, but
not printed..</p>
<div class="codehilite"><pre><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>
Modified: websites/staging/pdfbox/trunk/content/1.8/cookbook/pdfacreation.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/1.8/cookbook/pdfacreation.html
(original)
+++ websites/staging/pdfbox/trunk/content/1.8/cookbook/pdfacreation.html Wed
Aug 19 13:47:19 2015
@@ -107,7 +107,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -125,7 +125,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -147,12 +147,23 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="pdfa-creation">PDF/A Creation</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="pdfa-creation">PDF/A Creation<a class="headerlink"
href="#pdfa-creation" title="Permanent link">¶</a></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>
+<h2 id="load-all-the-fonts-used-in-document">Load all the fonts used in
document<a class="headerlink" href="#load-all-the-fonts-used-in-document"
title="Permanent link">¶</a></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="codehilite"><pre><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>
@@ -160,7 +171,7 @@ have to load them. As an example:</p>
</pre></div>
-<h2 id="including-xmp-metadata-block">Including XMP metadata block</h2>
+<h2 id="including-xmp-metadata-block">Including XMP metadata block<a
class="headerlink" href="#including-xmp-metadata-block" title="Permanent
link">¶</a></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>
@@ -174,7 +185,7 @@ PDF/A-1b document:</p>
</pre></div>
-<h2 id="including-color-profile">Including color profile</h2>
+<h2 id="including-color-profile">Including color profile<a class="headerlink"
href="#including-color-profile" title="Permanent link">¶</a></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="codehilite"><pre><span class="c1">// create output intent</span>
@@ -188,7 +199,7 @@ example takes one present in pdfbox:</p>
</pre></div>
-<h2 id="complete-example">Complete example</h2>
+<h2 id="complete-example">Complete example<a class="headerlink"
href="#complete-example" title="Permanent link">¶</a></h2>
<p>The complete example can be found in pdfbox-example. The source file is</p>
<div class="codehilite"><pre><span class="n">src</span><span
class="o">/</span><span class="n">main</span><span class="o">/</span><span
class="n">java</span><span class="o">/</span><span class="n">org</span><span
class="o">/</span><span class="n">apache</span><span class="o">/</span><span
class="n">pdfbox</span><span class="o">/</span><span
class="n">examples</span><span class="o">/</span><span
class="n">pdfa</span><span class="o">/</span><span
class="n">CreatePDFA</span><span class="p">.</span><span class="n">java</span>
</pre></div>
Modified: websites/staging/pdfbox/trunk/content/1.8/cookbook/pdfavalidation.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/1.8/cookbook/pdfavalidation.html
(original)
+++ websites/staging/pdfbox/trunk/content/1.8/cookbook/pdfavalidation.html Wed
Aug 19 13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,7 +145,18 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="pdfa-validation">PDF/A Validation</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="pdfa-validation">PDF/A Validation<a class="headerlink"
href="#pdfa-validation" title="Permanent link">¶</a></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>
@@ -200,7 +211,7 @@ Check Compliance with PDF/A-1b</p>
</pre></div>
-<h2 id="categories-of-validation-error">Categories of Validation Error</h2>
+<h2 id="categories-of-validation-error">Categories of Validation Error<a
class="headerlink" href="#categories-of-validation-error" title="Permanent
link">¶</a></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>
@@ -210,7 +221,7 @@ In order to help in the failure understa
</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 PreglihtConstant interface) :</p>
-<table>
+<table class="table">
<thead>
<tr>
<th>Category</th>
Modified: websites/staging/pdfbox/trunk/content/1.8/cookbook/textextraction.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/1.8/cookbook/textextraction.html
(original)
+++ websites/staging/pdfbox/trunk/content/1.8/cookbook/textextraction.html Wed
Aug 19 13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,8 +145,19 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="textextraction">Textextraction</h1>
-<h2 id="extracting-text">Extracting Text</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="textextraction">Textextraction<a class="headerlink"
href="#textextraction" title="Permanent link">¶</a></h1>
+<h2 id="extracting-text">Extracting Text<a class="headerlink"
href="#extracting-text" title="Permanent link">¶</a></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>
@@ -154,7 +165,7 @@ See command line app:ExtractText </p>
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>
+<h2 id="lucene-integration">Lucene Integration<a class="headerlink"
href="#lucene-integration" title="Permanent link">¶</a></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>
@@ -168,12 +179,12 @@ extracts a variety of metadata fields fr
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>
+<h2 id="advanced-text-extraction">Advanced Text Extraction<a
class="headerlink" href="#advanced-text-extraction" title="Permanent
link">¶</a></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>
+<h3 id="limiting-the-extracted-text">Limiting The Extracted Text<a
class="headerlink" href="#limiting-the-extracted-text" title="Permanent
link">¶</a></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
@@ -201,7 +212,7 @@ feature of the PDFTextStripper. Not all
<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>
+<table class="table">
<thead>
<tr>
<th>Start Bookmark</th>
@@ -248,11 +259,11 @@ feature of the PDFTextStripper. Not all
</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>
+<h3 id="external-glyph-list">External Glyph List<a class="headerlink"
href="#external-glyph-list" title="Permanent link">¶</a></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>
+<h3 id="right-to-left-text">Right to Left Text<a class="headerlink"
href="#right-to-left-text" title="Permanent link">¶</a></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).
Modified:
websites/staging/pdfbox/trunk/content/1.8/cookbook/workingwithattachments.html
==============================================================================
---
websites/staging/pdfbox/trunk/content/1.8/cookbook/workingwithattachments.html
(original)
+++
websites/staging/pdfbox/trunk/content/1.8/cookbook/workingwithattachments.html
Wed Aug 19 13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,8 +145,19 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="working-with-attachments">Working with
Attachments</h1>
-<h2 id="the-pdf-file-specification">The PDF File Specification</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="working-with-attachments">Working with Attachments<a
class="headerlink" href="#working-with-attachments" title="Permanent
link">¶</a></h1>
+<h2 id="the-pdf-file-specification">The PDF File Specification<a
class="headerlink" href="#the-pdf-file-specification" title="Permanent
link">¶</a></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
@@ -158,7 +169,7 @@ specification does not allow for any par
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 PDComplexFileSpecification, the EmbeddedFile attribute can be
used instead.</p>
-<h2 id="adding-a-file-attachment">Adding a File Attachment</h2>
+<h2 id="adding-a-file-attachment">Adding a File Attachment<a
class="headerlink" href="#adding-a-file-attachment" title="Permanent
link">¶</a></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>
Modified:
websites/staging/pdfbox/trunk/content/1.8/cookbook/workingwithfonts.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/1.8/cookbook/workingwithfonts.html
(original)
+++ websites/staging/pdfbox/trunk/content/1.8/cookbook/workingwithfonts.html
Wed Aug 19 13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,10 +145,21 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="working-with-fonts">Working with Fonts</h1>
-<h2 id="standard-14-fonts">Standard 14 Fonts</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="working-with-fonts">Working with Fonts<a class="headerlink"
href="#working-with-fonts" title="Permanent link">¶</a></h1>
+<h2 id="standard-14-fonts">Standard 14 Fonts<a class="headerlink"
href="#standard-14-fonts" title="Permanent link">¶</a></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>
+<table class="table">
<thead>
<tr>
<th>Standard Font</th>
@@ -214,7 +225,7 @@
</tr>
</tbody>
</table>
-<h2 id="hello-world-using-a-pdf-base-font">Hello World using a PDF base
font</h2>
+<h2 id="hello-world-using-a-pdf-base-font">Hello World using a PDF base font<a
class="headerlink" href="#hello-world-using-a-pdf-base-font" title="Permanent
link">¶</a></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="codehilite"><pre><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>
@@ -243,7 +254,7 @@
</pre></div>
-<h2 id="hello-world-using-a-truetype-font">Hello World using a TrueType
font</h2>
+<h2 id="hello-world-using-a-truetype-font">Hello World using a TrueType font<a
class="headerlink" href="#hello-world-using-a-truetype-font" title="Permanent
link">¶</a></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="codehilite"><pre><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>
@@ -278,7 +289,7 @@ PDFBox will look for a mapping file to u
<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>
+<h2 id="hello-world-using-a-postscript-type1-font">Hello World using a
Postscript Type1 font<a class="headerlink"
href="#hello-world-using-a-postscript-type1-font" title="Permanent
link">¶</a></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="codehilite"><pre><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>
Modified:
websites/staging/pdfbox/trunk/content/1.8/cookbook/workingwithmetadata.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/1.8/cookbook/workingwithmetadata.html
(original)
+++ websites/staging/pdfbox/trunk/content/1.8/cookbook/workingwithmetadata.html
Wed Aug 19 13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,8 +145,19 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="working-with-metadata">Working with Metadata</h1>
-<h2 id="introduction">Introduction</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="working-with-metadata">Working with Metadata<a class="headerlink"
href="#working-with-metadata" title="Permanent link">¶</a></h1>
+<h2 id="introduction">Introduction<a class="headerlink" href="#introduction"
title="Permanent link">¶</a></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>
@@ -168,7 +179,7 @@ provides a high level API to that inform
</pre></div>
-<h2 id="accessing-pdf-metadata">Accessing PDF Metadata</h2>
+<h2 id="accessing-pdf-metadata">Accessing PDF Metadata<a class="headerlink"
href="#accessing-pdf-metadata" title="Permanent link">¶</a></h2>
<p>See class:org.apache.pdfbox.pdmodel.common.PDMetadata<br />
See example:AddMetadataFromDocInfo<br />
See Adobe Documentation:XMP Specification </p>
Modified: websites/staging/pdfbox/trunk/content/1.8/dependencies.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/1.8/dependencies.html (original)
+++ websites/staging/pdfbox/trunk/content/1.8/dependencies.html Wed Aug 19
13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,13 +145,24 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="dependencies">Dependencies</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="dependencies">Dependencies<a class="headerlink" href="#dependencies"
title="Permanent link">¶</a></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>
+<h2 id="core-components">Core components<a class="headerlink"
href="#core-components" title="Permanent link">¶</a></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>
+<h3 id="minimum-requirement">Minimum Requirement<a class="headerlink"
href="#minimum-requirement" title="Permanent link">¶</a></h3>
<ul>
<li>Java 1.5</li>
<li><a href="http://commons.apache.org/logging/";>commons-logging</a></li>
@@ -160,9 +171,9 @@
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>
+<h3 id="font-handling">Font Handling<a class="headerlink"
href="#font-handling" title="Permanent link">¶</a></h3>
<p>For font handling the fontbox component is needed.</p>
-<h3 id="xmp-metadata">XMP Metadata</h3>
+<h3 id="xmp-metadata">XMP Metadata<a class="headerlink" href="#xmp-metadata"
title="Permanent link">¶</a></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>
@@ -175,16 +186,16 @@ pdfbox library directly and the other re
<p>Set the version field to the latest stable PDFBox version.</p>
-<h2 id="optional-dependencies">Optional dependencies</h2>
+<h2 id="optional-dependencies">Optional dependencies<a class="headerlink"
href="#optional-dependencies" title="Permanent link">¶</a></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>
+<h3 id="extented-image-format-support">Extented Image Format Support<a
class="headerlink" href="#extented-image-format-support" title="Permanent
link">¶</a></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>
+<h4 id="pdf-encryption-and-signing">PDF Encryption and Signing<a
class="headerlink" href="#pdf-encryption-and-signing" title="Permanent
link">¶</a></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="codehilite"><pre><span class="nt"><dependency></span>
@@ -201,7 +212,7 @@ pdfbox library directly and the other re
<p><br/></p>
-<h4 id="support-for-bidirectional-languages">Support for bidirectional
languages</h4>
+<h4 id="support-for-bidirectional-languages">Support for bidirectional
languages<a class="headerlink" href="#support-for-bidirectional-languages"
title="Permanent link">¶</a></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>
@@ -215,7 +226,7 @@ use the following Maven dependency.</p>
<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>
+<h2 id="dependencies-for-ant-builds">Dependencies for Ant builds<a
class="headerlink" href="#dependencies-for-ant-builds" title="Permanent
link">¶</a></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>
Modified: websites/staging/pdfbox/trunk/content/1.8/faq.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/1.8/faq.html (original)
+++ websites/staging/pdfbox/trunk/content/1.8/faq.html Wed Aug 19 13:47:19 2015
@@ -107,7 +107,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -125,7 +125,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -147,14 +147,25 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="frequently-asked-questions">Frequently asked
questions</h1>
-<h3 id="general-questions">General Questions</h3>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="frequently-asked-questions">Frequently asked questions<a
class="headerlink" href="#frequently-asked-questions" title="Permanent
link">¶</a></h1>
+<h3 id="general-questions">General Questions<a class="headerlink"
href="#general-questions" title="Permanent link">¶</a></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>
+<h3 id="text-extraction">Text Extraction<a class="headerlink"
href="#text-extraction" title="Permanent link">¶</a></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>
@@ -162,8 +173,8 @@
<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_1">General Questions</h2>
-<h3 id="log4j">I am getting the below Log4J warning message, how do I remove
it?</h3>
+<h2 id="general-questions_1">General Questions<a class="headerlink"
href="#general-questions_1" title="Permanent link">¶</a></h2>
+<h3 id="log4j">I am getting the below Log4J warning message, how do I remove
it?<a class="headerlink" href="#log4j" title="Permanent link">¶</a></h3>
<div class="codehilite"><pre><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>
</pre></div>
@@ -184,10 +195,10 @@ See the <a href="http://logging.apache.o
<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>
-<h3 id="threadsafe">Is PDFBox thread safe?</h3>
+<h3 id="threadsafe">Is PDFBox thread safe?<a class="headerlink"
href="#threadsafe" title="Permanent link">¶</a></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>
-<h3 id="notclosed">Why do I get a "Warning: You did not close the PDF
Document"?</h3>
+<h3 id="notclosed">Why do I get a "Warning: You did not close the PDF
Document"?<a class="headerlink" href="#notclosed" title="Permanent
link">¶</a></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>
@@ -208,8 +219,8 @@ PDDocument objects; one from the "new PD
</pre></div>
-<h2 id="text-extraction_1">Text Extraction</h2>
-<h3 id="notext">How come I am not getting any text from the PDF document?</h3>
+<h2 id="text-extraction_1">Text Extraction<a class="headerlink"
href="#text-extraction_1" title="Permanent link">¶</a></h2>
+<h3 id="notext">How come I am not getting any text from the PDF document?<a
class="headerlink" href="#notext" title="Permanent link">¶</a></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>
@@ -219,22 +230,22 @@ should be able to as well and it is a bu
<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>
-<h3 id="gibberish">How come I am getting gibberish(G38G43G36G51G5) when
extracting text?</h3>
+<h3 id="gibberish">How come I am getting gibberish(G38G43G36G51G5) when
extracting text?<a class="headerlink" href="#gibberish" title="Permanent
link">¶</a></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>
-<h3 id="fontwidth">What does "java.io.IOException: Can't handle font width"
mean?</h3>
+<h3 id="fontwidth">What does "java.io.IOException: Can't handle font width"
mean?<a class="headerlink" href="#fontwidth" title="Permanent
link">¶</a></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>
-<h3 id="permission">Why do I get "You do not have permission to extract text"
on some documents?</h3>
+<h3 id="permission">Why do I get "You do not have permission to extract text"
on some documents?<a class="headerlink" href="#permission" title="Permanent
link">¶</a></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>
-<h3 id="partially">Can't we just extract the text without parsing the whole
document or extract text as it is parsed?</h3>
+<h3 id="partially">Can't we just extract the text without parsing the whole
document or extract text as it is parsed?<a class="headerlink"
href="#partially" title="Permanent link">¶</a></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
Modified: websites/staging/pdfbox/trunk/content/2.0/dependencies.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/2.0/dependencies.html (original)
+++ websites/staging/pdfbox/trunk/content/2.0/dependencies.html Wed Aug 19
13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,9 +145,20 @@
</ul>
</div>
<div class="col-xs-9">
- <p class="alert alert-warning">This is an unreleased
development preview and may change without notice.</p>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<p class="alert alert-warning">This is an unreleased development preview and
may change without notice.</p>
-<h1 id="dependencies">Dependencies</h1>
+<h1 id="dependencies">Dependencies<a class="headerlink" href="#dependencies"
title="Permanent link">¶</a></h1>
<p>PDFBox has the following basic dependencies:</p>
<ul>
<li>Java 6</li>
@@ -156,9 +167,9 @@
<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>
+<h2 id="optional-components">Optional components<a class="headerlink"
href="#optional-components" title="Permanent link">¶</a></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-io">JAI Image I/O</h3>
+<h3 id="jai-image-io">JAI Image I/O<a class="headerlink" href="#jai-image-io"
title="Permanent link">¶</a></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
@@ -168,7 +179,7 @@ included in the Java platform.</p>
</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>
+<h3 id="encryption-and-signing">Encryption and Signing<a class="headerlink"
href="#encryption-and-signing" title="Permanent link">¶</a></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="codehilite"><pre><span class="nt"><dependency></span>
<span class="nt"><groupId></span>org.bouncycastle<span
class="nt"></groupId></span>
@@ -184,7 +195,7 @@ included in the Java platform.</p>
</pre></div>
-<h3 id="java-cryptography-extension-jce">Java Cryptography Extension (JCE)</h3>
+<h3 id="java-cryptography-extension-jce">Java Cryptography Extension (JCE)<a
class="headerlink" href="#java-cryptography-extension-jce" title="Permanent
link">¶</a></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="codehilite"><pre><span class="n">JCE</span> <span
class="n">unlimited</span> <span class="n">strength</span> <span
class="n">jurisdiction</span> <span class="n">policy</span> <span
class="n">files</span> <span class="n">are</span> <span class="n">not</span>
<span class="n">installed</span>
</pre></div>
Modified: websites/staging/pdfbox/trunk/content/2.0/examples.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/2.0/examples.html (original)
+++ websites/staging/pdfbox/trunk/content/2.0/examples.html Wed Aug 19 13:47:19
2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,9 +145,20 @@
</ul>
</div>
<div class="col-xs-9">
- <p class="alert alert-warning">This is an unreleased
development preview and may change without notice.</p>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<p class="alert alert-warning">This is an unreleased development preview and
may change without notice.</p>
-<h1 id="examples">Examples</h1>
+<h1 id="examples">Examples<a class="headerlink" href="#examples"
title="Permanent link">¶</a></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>
Modified: websites/staging/pdfbox/trunk/content/2.0/getting-started.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/2.0/getting-started.html (original)
+++ websites/staging/pdfbox/trunk/content/2.0/getting-started.html Wed Aug 19
13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
Modified: websites/staging/pdfbox/trunk/content/building.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/building.html (original)
+++ websites/staging/pdfbox/trunk/content/building.html Wed Aug 19 13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
Modified: websites/staging/pdfbox/trunk/content/codingconventions.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/codingconventions.html (original)
+++ websites/staging/pdfbox/trunk/content/codingconventions.html Wed Aug 19
13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,9 +145,20 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="coding-conventions">Coding Conventions</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="coding-conventions">Coding Conventions<a class="headerlink"
href="#coding-conventions" title="Permanent link">¶</a></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>
+<h3 id="formatting">Formatting<a class="headerlink" href="#formatting"
title="Permanent link">¶</a></h3>
<ul>
<li>
<p>Braces go on their own line.</p>
@@ -171,7 +182,7 @@
<p>Prefer aligned wrapped parameter lists.</p>
</li>
</ul>
-<h3 id="whitespace">Whitespace</h3>
+<h3 id="whitespace">Whitespace<a class="headerlink" href="#whitespace"
title="Permanent link">¶</a></h3>
<ul>
<li>
<p>Four spaces for indents, no tabs.</p>
@@ -189,7 +200,7 @@
<p>Prefer not following casts with a blank space.</p>
</li>
</ul>
-<h3 id="structure">Structure</h3>
+<h3 id="structure">Structure<a class="headerlink" href="#structure"
title="Permanent link">¶</a></h3>
<ul>
<li>
<p>Do not use package imports (e.g. <code>import java.util.*</code>)</p>
@@ -205,7 +216,7 @@ Constructors<br />
Methods </p>
</li>
</ul>
-<h3 id="javadoc">JavaDoc</h3>
+<h3 id="javadoc">JavaDoc<a class="headerlink" href="#javadoc" title="Permanent
link">¶</a></h3>
<ul>
<li>
<p>Public and protected methods and fields must have JavaDoc.</p>
@@ -226,7 +237,7 @@ Methods </p>
<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>
+<h3 id="comments">Comments<a class="headerlink" href="#comments"
title="Permanent link">¶</a></h3>
<ul>
<li>
<p>Only use line comments within code, never block comments.</p>
@@ -238,7 +249,7 @@ Methods </p>
<p>Prefix line comments by a space <code>// like this</code>.</p>
</li>
</ul>
-<h3 id="variables">Variables</h3>
+<h3 id="variables">Variables<a class="headerlink" href="#variables"
title="Permanent link">¶</a></h3>
<ul>
<li>
<p>Prefer initializing variables when they are declared, rather than C-style
declaration before use.</p>
@@ -247,7 +258,7 @@ Methods </p>
<p>Always use final fields when possible.</p>
</li>
</ul>
-<h3 id="control-flow">Control Flow</h3>
+<h3 id="control-flow">Control Flow<a class="headerlink" href="#control-flow"
title="Permanent link">¶</a></h3>
<ul>
<li>
<p>Prefer multiple return statements over additional control flow logic.</p>
@@ -256,7 +267,7 @@ Methods </p>
<p>Prefer switch statements over multi-clause if-then statements.</p>
</li>
</ul>
-<h3 id="api-design">API Design</h3>
+<h3 id="api-design">API Design<a class="headerlink" href="#api-design"
title="Permanent link">¶</a></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>
@@ -277,7 +288,7 @@ Methods </p>
<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>
+<h3 id="example">Example<a class="headerlink" href="#example" title="Permanent
link">¶</a></h3>
<p>Here's an example of PDFBox's formatting style:</p>
<div class="codehilite"><pre><span class="kd">public</span> <span
class="kd">class</span> <span class="nc">Foo</span> <span
class="kd">extends</span> <span class="n">Bar</span>
<span class="o">{</span>
@@ -299,7 +310,7 @@ Methods </p>
</pre></div>
-<h2 id="eclipse-formatter">Eclipse Formatter</h2>
+<h2 id="eclipse-formatter">Eclipse Formatter<a class="headerlink"
href="#eclipse-formatter" title="Permanent link">¶</a></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>
Modified: websites/staging/pdfbox/trunk/content/download.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/download.html (original)
+++ websites/staging/pdfbox/trunk/content/download.html Wed Aug 19 13:47:19 2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
Modified: websites/staging/pdfbox/trunk/content/errors/403.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/errors/403.html (original)
+++ websites/staging/pdfbox/trunk/content/errors/403.html Wed Aug 19 13:47:19
2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,7 +145,18 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="403">403</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="403">403<a class="headerlink" href="#403" title="Permanent
link">¶</a></h1>
<p>We're sorry, but the page you requested cannot be accessed. </p>
<p>Maybe you </p>
<ul>
Modified: websites/staging/pdfbox/trunk/content/errors/404.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/errors/404.html (original)
+++ websites/staging/pdfbox/trunk/content/errors/404.html Wed Aug 19 13:47:19
2015
@@ -105,7 +105,7 @@
</ul>
</li>
<li class="sidebar-node" id="v1-8">
- <a href="#">1.8.9</a>
+ <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>
@@ -123,7 +123,7 @@
</ul>
</li>
<li><a href="/1.8/commandline.html">Command Line
Tools</a></li>
- <li><a href="/docs/1.8.9/javadocs/">API
Docs</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>
@@ -145,7 +145,18 @@
</ul>
</div>
<div class="col-xs-9">
- <h1 id="404">404</h1>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink,
h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink,
dt:hover > .elementid-permalink { visibility: visible }</style>
+<h1 id="404">404<a class="headerlink" href="#404" title="Permanent
link">¶</a></h1>
<p>We're sorry, but the page you requested cannot be found. </p>
<p>Maybe you </p>
<ul>
