pdfbox-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r935191 - in /websites/staging/pdfbox/trunk/content: ./ 1.8/ 1.8/cookbook/ 2.0/ docs/1.8.2/ errors/
Date Mon, 05 Jan 2015 22:36:49 GMT
Author: buildbot
Date: Mon Jan  5 22:36:48 2015
New Revision: 935191

Log:
Staging update by buildbot for pdfbox

Added:
    websites/staging/pdfbox/trunk/content/2.0/
    websites/staging/pdfbox/trunk/content/2.0/dependencies.html
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/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/building.html
    websites/staging/pdfbox/trunk/content/codingconventions.html
    websites/staging/pdfbox/trunk/content/docs/1.8.2/pdfcoverage.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 Mon Jan  5 22:36:48 2015
@@ -1 +1 @@
-1649678
+1649682

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 Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

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 Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

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 Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

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 Mon Jan  5 22:36:48 2015
@@ -65,7 +65,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -100,6 +100,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

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 Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

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 Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

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 Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

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 Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

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 Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

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 Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>
@@ -139,8 +140,6 @@
             <div class="col-xs-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>
-<p class="alert alert-info">This information is for the current stable 1.8.x branch. The 2.0 development branch will have different dependencies.</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>
 
@@ -168,7 +167,7 @@ pdfbox library directly and the other re
 <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 TIF images additional libraries are needed. </p>
+<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
@@ -191,19 +190,6 @@ pdfbox library directly and the other re
 
 
 <p><br/></p>
-<p class="alert alert-warning">New for PDFBox 2.0.0 (this version is still in development).</p>
-
-<p>Since PDFBOX-2460, building PDFBox now requires a JDK with "unlimited strength" cryptography. Which requires extra files to be installed.</p>
-<p>For JDK 7: <a href="http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html">Java Cryptography Extension (JCE)</a></p>
-<p>Users without these files will see the message:</p>
-<div class="codehilite"><pre><span class="n">Failed</span> <span class="n">tests</span><span class="p">:</span>
-<span class="n">TestPublicKeyEncryption</span><span class="p">.</span><span class="n">setUp</span><span class="p">:</span>70 <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>
-<span class="n">TestPublicKeyEncryption</span><span class="p">.</span><span class="n">setUp</span><span class="p">:</span>70 <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>
-<span class="n">TestPublicKeyEncryption</span><span class="p">.</span><span class="n">setUp</span><span class="p">:</span>70 <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>
-<span class="n">TestSymmetricKeyEncryption</span><span class="p">.</span><span class="n">setUp</span><span class="p">:</span>80 <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>
-
-
 <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, 

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 Mon Jan  5 22:36:48 2015
@@ -65,7 +65,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -100,6 +100,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>
@@ -142,7 +143,6 @@
                  <h1 id="frequently-asked-questions">Frequently asked questions</h1>
 <h2 id="general-questions">General Questions</h2>
 <ul>
-<li><a href="#releaseplan">When will the next version of PDFBox be released?</a></li>
 <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>
@@ -155,13 +155,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="answers">Answers</h2>
-<h3 id="general-questions_1">General Questions</h3>
-<h4 id="releaseplan">When will the next version of PDFBox be released?</h4>
-<p>As fixes are made and integrated into the repository these changes are documented in the
-<a href="http://pdfbox.apache.org/downloads.html">release notes</a>. An estimate will be given of when the next version will be released.
-Of course, this is only an estimate and could change.</p>
-<h4 id="log4j">I am getting the below Log4J warning message, how do I remove it?</h4>
+<h2 id="general-questions_1">General Questions</h2>
+<h2 id="log4j">I am getting the below Log4J warning message, how do I remove it?</h2>
 <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>
@@ -182,10 +177,10 @@ See the <a href="http://logging.apache.o
 
 <p>Please see <a href="https://sourceforge.net/forum/forum.php?thread_id=1254229&amp;amp;forum_id=267205">this</a> forum thread 
 for more information.</p>
-<h4 id="threadsafe">Is PDFBox thread safe?</h4>
+<h2 id="threadsafe">Is PDFBox thread safe?</h2>
 <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>
-<h4 id="notclosed">Why do I get a "Warning: You did not close the PDF Document"?</h4>
+<h2 id="notclosed">Why do I get a "Warning: You did not close the PDF Document"?</h2>
 <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>
@@ -207,7 +202,7 @@ PDDocument objects; one from the "new PD
 
 
 <h3 id="text-extraction_1">Text Extraction</h3>
-<h4 id="notext">How come I am not getting any text from the PDF document?</h4>
+<h2 id="notext">How come I am not getting any text from the PDF document?</h2>
 <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>
@@ -217,22 +212,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>
-<h4 id="gibberish">How come I am getting gibberish(G38G43G36G51G5) when extracting text?</h4>
+<h2 id="gibberish">How come I am getting gibberish(G38G43G36G51G5) when extracting text?</h2>
 <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>
-<h4 id="fontwidth">What does "java.io.IOException: Can't handle font width" mean?</h4>
+<h2 id="fontwidth">What does "java.io.IOException: Can't handle font width" mean?</h2>
 <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>
-<h4 id="permission">Why do I get "You do not have permission to extract text" on some documents?</h4>
+<h2 id="permission">Why do I get "You do not have permission to extract text" on some documents?</h2>
 <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>
-<h4 id="partially">Can't we just extract the text without parsing the whole document or extract text as it is parsed?</h4>
+<h2 id="partially">Can't we just extract the text without parsing the whole document or extract text as it is parsed?</h2>
 <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 

Added: websites/staging/pdfbox/trunk/content/2.0/dependencies.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/2.0/dependencies.html (added)
+++ websites/staging/pdfbox/trunk/content/2.0/dependencies.html Mon Jan  5 22:36:48 2015
@@ -0,0 +1,227 @@
+<!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">
+
+    <title>Apache PDFBox | Dependencies</title>
+
+    <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
+    <link href="/FontAwesome/css/font-awesome.css" rel="stylesheet">
+    <link href="/Iconic/iconic fill/iconic_fill.css" rel="stylesheet">
+    <link href="/css/pygments-github.css" rel="stylesheet">
+    
+    <link href="/css/site.css" rel="stylesheet">
+    
+    
+    
+     
+    
+    
+    <!-- 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">
+        $(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');
+            } else {
+                $('#v1-8').removeClass('collapsed');
+                if (path.indexOf('/1.8/cookbook') == 0) {
+                    $('#v1-8-cookbook').removeClass('collapsed');
+                }
+            }
+
+        });
+    </script>
+</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>
+        </div>
+      </div>
+    </nav>
+    
+    <div class="container">
+        
+        <div class="row">
+            <div class="col-xs-3">
+                
+                <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="#">Trunk</a>
+                        <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</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.8</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/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.8/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="/codingconventions.html">Coding Conventions</a></li>
+                    <li><a href="/building.html">Building</a></li>
+                    <li><a href="/ideas.html">Ideas</a></li>
+                    <li><a href="/references.html">References</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-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 consists of a two core 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>These components are needed during runtime, development and testing dependent on the details below.</p>
+<p>The two core PDFBox components are named <code>pdfbox</code> and <code>fontbox</code>. The Maven groupId of all PDFBox components is org.apache.pdfbox.</p>
+<h3 id="minimum-requirement">Minimum Requirement</h3>
+<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>
+<p>To add the pdfbox, fontbox 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="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
+  <span class="nt">&lt;groupId&gt;</span>org.apache.pdfbox<span class="nt">&lt;/groupId&gt;</span>
+  <span class="nt">&lt;artifactId&gt;</span>pdfbox<span class="nt">&lt;/artifactId&gt;</span>
+  <span class="nt">&lt;version&gt;</span>...<span class="nt">&lt;/version&gt;</span>
+<span class="nt">&lt;/dependency&gt;</span>
+</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><strong>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.</strong></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> is needed. </p>
+<p>For <strong>JPEG 2000 (JPX)</strong> support <a href="https://java.net/projects/jai-imageio-core">JAI Image I/O Tools Core</a> is needed. </p>
+<p>To write <strong>TIFF</strong> images a JAI ImageIO Core library will be needed. </p>
+<h3 id="pdf-encryption-and-signing">PDF Encryption and Signing</h3>
+<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">&lt;dependency&gt;</span>
+  <span class="nt">&lt;groupId&gt;</span>org.bouncycastle<span class="nt">&lt;/groupId&gt;</span>
+  <span class="nt">&lt;artifactId&gt;</span>bcprov-jdk15<span class="nt">&lt;/artifactId&gt;</span>
+  <span class="nt">&lt;version&gt;</span>1.44<span class="nt">&lt;/version&gt;</span>
+<span class="nt">&lt;/dependency&gt;</span>
+
+<span class="nt">&lt;dependency&gt;</span>
+  <span class="nt">&lt;groupId&gt;</span>org.bouncycastle<span class="nt">&lt;/groupId&gt;</span>
+  <span class="nt">&lt;artifactId&gt;</span>bcmail-jdk15<span class="nt">&lt;/artifactId&gt;</span>
+  <span class="nt">&lt;version&gt;</span>1.44<span class="nt">&lt;/version&gt;</span>
+<span class="nt">&lt;/dependency&gt;</span>
+</pre></div>
+
+
+<h3 id="java-7-cryptography">Java 7 Cryptography</h3>
+<p>Building PDFBox requires a JDK with "unlimited strength" cryptography, which requires extra files to be installed.</p>
+<p>For JDK 7: <a href="http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html">Java Cryptography Extension (JCE)</a></p>
+<p>Users without these files will see the message:</p>
+<div class="codehilite"><pre><span class="n">Failed</span> <span class="n">tests</span><span class="p">:</span>
+<span class="n">TestPublicKeyEncryption</span><span class="p">.</span><span class="n">setUp</span><span class="p">:</span>70 <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>
+<span class="n">TestPublicKeyEncryption</span><span class="p">.</span><span class="n">setUp</span><span class="p">:</span>70 <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>
+<span class="n">TestPublicKeyEncryption</span><span class="p">.</span><span class="n">setUp</span><span class="p">:</span>70 <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>
+<span class="n">TestSymmetricKeyEncryption</span><span class="p">.</span><span class="n">setUp</span><span class="p">:</span>80 <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>
+
+
+<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&ndash;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>
+</body>
+
+</html>

Modified: websites/staging/pdfbox/trunk/content/building.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/building.html (original)
+++ websites/staging/pdfbox/trunk/content/building.html Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</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 Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

Modified: websites/staging/pdfbox/trunk/content/docs/1.8.2/pdfcoverage.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/docs/1.8.2/pdfcoverage.html (original)
+++ websites/staging/pdfbox/trunk/content/docs/1.8.2/pdfcoverage.html Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

Modified: websites/staging/pdfbox/trunk/content/download.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/download.html (original)
+++ websites/staging/pdfbox/trunk/content/download.html Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</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 Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

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 Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

Modified: websites/staging/pdfbox/trunk/content/ideas.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/ideas.html (original)
+++ websites/staging/pdfbox/trunk/content/ideas.html Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

Modified: websites/staging/pdfbox/trunk/content/index.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/index.html (original)
+++ websites/staging/pdfbox/trunk/content/index.html Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

Modified: websites/staging/pdfbox/trunk/content/mailinglists.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/mailinglists.html (original)
+++ websites/staging/pdfbox/trunk/content/mailinglists.html Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

Modified: websites/staging/pdfbox/trunk/content/references.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/references.html (original)
+++ websites/staging/pdfbox/trunk/content/references.html Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

Modified: websites/staging/pdfbox/trunk/content/sitemap.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/sitemap.html (original)
+++ websites/staging/pdfbox/trunk/content/sitemap.html Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

Modified: websites/staging/pdfbox/trunk/content/support.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/support.html (original)
+++ websites/staging/pdfbox/trunk/content/support.html Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>

Modified: websites/staging/pdfbox/trunk/content/team.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/team.html (original)
+++ websites/staging/pdfbox/trunk/content/team.html Mon Jan  5 22:36:48 2015
@@ -63,7 +63,7 @@
                     $('#v1-8-cookbook').removeClass('collapsed');
                 }
             }
-            
+
         });
     </script>
 </head>
@@ -98,6 +98,7 @@
                     <li class="sidebar-node" id="v2-0">
                         <a href="#">Trunk</a>
                         <ul>
+                            <li><a href="/2.0/dependencies.html">Dependencies</a></li>
                             <li><a href="/docs/2.0.0-SNAPSHOT/javadocs/">API Docs</a></li>
                         </ul>
                     </li>



Mime
View raw message