You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pdfbox.apache.org by ju...@apache.org on 2010/03/18 16:46:10 UTC
svn commit: r924869 [13/13] - in /pdfbox/site: ./ publish/
publish/commandlineutilities/ publish/css/ publish/userguide/
publish/userguide/cookbook/ src/site/fml/userguide/ src/site/xdoc/
src/site/xdoc/commandlineutilities/ src/site/xdoc/userguide/ src...
Modified: pdfbox/site/src/site/xdoc/commandlineutilities/PDFToImage.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/commandlineutilities/PDFToImage.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/commandlineutilities/PDFToImage.xml (original)
+++ pdfbox/site/src/site/xdoc/commandlineutilities/PDFToImage.xml Thu Mar 18 15:46:08 2010
@@ -14,16 +14,18 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFToImage</title>
- <meta name="keywords">pdf to image, java pdf image, image, pdfbox, open source</meta>
- </properties>
+ <meta name="keywords" content="pdf to image, java pdf image, image, pdfbox, open source"/>
+ </head>
<body>
<section name="PDFToImage">
<p>This application will create an image for every page in the PDF document.</p>
- <warning>This is new code and should be treated as beta quality!</warning>
+ <p>WARNING: This is new code and should be treated as beta quality!</p>
<table>
<tr>
<th>Command Line Parameter</th>
Modified: pdfbox/site/src/site/xdoc/commandlineutilities/PrintPDF.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/commandlineutilities/PrintPDF.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/commandlineutilities/PrintPDF.xml (original)
+++ pdfbox/site/src/site/xdoc/commandlineutilities/PrintPDF.xml Thu Mar 18 15:46:08 2010
@@ -14,15 +14,17 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PrintPDF</title>
- </properties>
+ </head>
<body>
<section name="PrintPDF">
<p>This application will send a pdf document to the printer.</p>
- <note>You must have the correct permissions to print the document!</note>
+ <p>NOTE: You must have the correct permissions to print the document!</p>
<p>usage: java org.apache.pdfbox.PrintPDF [OPTIONS] <inputfile></p>
<table>
<tr>
Modified: pdfbox/site/src/site/xdoc/commandlineutilities/TextToPDF.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/commandlineutilities/TextToPDF.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/commandlineutilities/TextToPDF.xml (original)
+++ pdfbox/site/src/site/xdoc/commandlineutilities/TextToPDF.xml Thu Mar 18 15:46:08 2010
@@ -14,11 +14,13 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>TextToPDF</title>
- </properties>
+ </head>
<body>
<section name="TextToPDF">
<p>This application will create a PDF document from a text file.</p>
Modified: pdfbox/site/src/site/xdoc/commandlineutilities/index.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/commandlineutilities/index.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/commandlineutilities/index.xml (original)
+++ pdfbox/site/src/site/xdoc/commandlineutilities/index.xml Thu Mar 18 15:46:08 2010
@@ -14,11 +14,13 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox Command Line Utilities</title>
- </properties>
+ </head>
<body>
<section name="PDFBox Command Line Utilities">
<p>
@@ -35,10 +37,8 @@
<p>
PDFBox uses log4j for logging, if you do not set up log4j then you will get a warning like this
</p>
- <note>
- log4j:WARN No appenders could be found for logger (org.apache.pdfbox.util.ResourceLoader).<br/>
- log4j:WARN Please initialize the log4j system properly.
- </note>
+<pre>log4j:WARN No appenders could be found for logger (org.apache.pdfbox.util.ResourceLoader).
+log4j:WARN Please initialize the log4j system properly.</pre>
<p>
See the log4j <a href="http://logging.apache.org/log4j/docs/documentation.html">documentation</a> for more information on how to set up log4j.
</p>
Modified: pdfbox/site/src/site/xdoc/download.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/download.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/download.xml (original)
+++ pdfbox/site/src/site/xdoc/download.xml Thu Mar 18 15:46:08 2010
@@ -14,11 +14,13 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>Download</title>
- </properties>
+ </head>
<body>
<section name="Download">
<p>
@@ -225,10 +227,10 @@
The following provides more details on the included cryptographic
software:
</p>
- <note>
+ <blockquote>
Apache PDFBox uses the Java Cryptography Architecture (JCA) and the
Bouncy Castle libraries for handling encryption in PDF documents.
- </note>
+ </blockquote>
</section>
</body>
</document>
Modified: pdfbox/site/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/index.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/index.xml (original)
+++ pdfbox/site/src/site/xdoc/index.xml Thu Mar 18 15:46:08 2010
@@ -14,12 +14,14 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>Apache PDFBox - Java PDF Library</title>
- <meta name="keywords">Java PDF Library, pdfbox, pdftotext, print pdf</meta>
- </properties>
+ <meta name="keywords" content="Java PDF Library, pdfbox, pdftotext, print pdf"/>
+ </head>
<body>
<section name="Apache PDFBox - Java PDF Library">
<p>
Modified: pdfbox/site/src/site/xdoc/mailing-list.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/mailing-list.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/mailing-list.xml (original)
+++ pdfbox/site/src/site/xdoc/mailing-list.xml Thu Mar 18 15:46:08 2010
@@ -14,11 +14,13 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>Mailing Lists</title>
- </properties>
+ </head>
<body>
<section name="Mailing Lists">
<p>
@@ -45,7 +47,7 @@
committers (developers) are required to be subscribed to this mailing list. When in doubt
which mailing list to use, use this one.
</p>
- <section id="users-subscribe" name="Subscription Information">
+ <subsection id="users-subscribe" name="Subscription Information">
<ul>
<li>To subscribe (digest only): Send email to <a href="mailto:users-digest-subscribe@pdfbox.apache.org">users-digest-subscribe@pdfbox.apache.org</a>.</li>
<li>To <strong>subscribe</strong> fully: Send email to <a href="mailto:users-subscribe@pdfbox.apache.org">users-subscribe@pdfbox.apache.org</a>.</li>
@@ -53,21 +55,21 @@
<li>To <strong>unsubscribe</strong>: Send email to <a href="mailto:users-unsubscribe@pdfbox.apache.org">users-unsubscribe@pdfbox.apache.org</a>.</li>
<li>To <strong>post</strong>: Send email to <a href="mailto:users@pdfbox.apache.org">users@pdfbox.apache.org</a>.</li>
</ul>
- </section>
- <section id="users-archives" name="Mailing List Archives">
+ </subsection>
+ <subsection id="users-archives" name="Mailing List Archives">
<ul>
<li><a href="http://mail-archives.apache.org/mod_mbox/incubator-pdfbox-users/">Apache Mailing List Archive</a> (mod_mbox archive, no full-text search)</li>
<li><a href="http://pdfbox-users.markmail.org">MarkMail Archive</a></li>
<li><a href="http://pdfbox.markmail.org">MarkMail Archive</a> (all PDFBox mailing lists together)</li>
</ul>
- </section>
+ </subsection>
</section>
<section id="dev" name="Developers Mailing List">
<p>
This is where the committers and interested contributors discuss the further development of
Apache PDFBox.
</p>
- <section id="dev-subscribe" name="Subscription Information">
+ <subsection id="dev-subscribe" name="Subscription Information">
<ul>
<li>To subscribe (digest only): Send email to <a href="mailto:dev-digest-subscribe@pdfbox.apache.org">dev-digest-subscribe@pdfbox.apache.org</a>.</li>
<li>To <strong>subscribe</strong> fully: Send email to <a href="mailto:dev-subscribe@pdfbox.apache.org">dev-subscribe@pdfbox.apache.org</a>.</li>
@@ -75,33 +77,33 @@
<li>To <strong>unsubscribe</strong>: Send email to <a href="mailto:dev-unsubscribe@pdfbox.apache.org">dev-unsubscribe@pdfbox.apache.org</a>.</li>
<li>To <strong>post</strong>: Send email to <a href="mailto:dev@pdfbox.apache.org">dev@pdfbox.apache.org</a>.</li>
</ul>
- </section>
- <section id="dev-archives" name="Mailing List Archives">
+ </subsection>
+ <subsection id="dev-archives" name="Mailing List Archives">
<ul>
<li><a href="http://mail-archives.apache.org/mod_mbox/incubator-pdfbox-dev/">Apache Mailing List Archive</a> (mod_mbox archive, no full-text search)</li>
<li><a href="http://pdfbox-dev.markmail.org">MarkMail Archive</a></li>
</ul>
- </section>
+ </subsection>
</section>
<section id="commits" name="Commits Mailing List">
<p>
This is where all the notification mails from Subversion commits and issue tracker changes
get sent. This mailing list is not used for discussions.
</p>
- <section id="commits-subscribe" name="Subscription Information">
+ <subsection id="commits-subscribe" name="Subscription Information">
<ul>
<li>To subscribe (digest only): Send email to <a href="mailto:commits-digest-subscribe@pdfbox.apache.org">commits-digest-subscribe@pdfbox.apache.org</a>.</li>
<li>To <strong>subscribe</strong> fully: Send email to <a href="mailto:commits-subscribe@pdfbox.apache.org">commits-subscribe@pdfbox.apache.org</a>.</li>
<li>To receive information about the mailing list: Send email to <a href="mailto:commits-help@pdfbox.apache.org">commits-help@pdfbox.apache.org</a>.</li>
<li>To <strong>unsubscribe</strong>: Send email to <a href="mailto:commits-unsubscribe@pdfbox.apache.org">commits-unsubscribe@pdfbox.apache.org</a>.</li>
</ul>
- </section>
- <section id="commits-archives" name="Mailing List Archives">
+ </subsection>
+ <subsection id="commits-archives" name="Mailing List Archives">
<ul>
<li><a href="http://mail-archives.apache.org/mod_mbox/incubator-pdfbox-commits/">Apache Mailing List Archive</a> (mod_mbox archive, no full-text search)</li>
<li><a href="http://pdfbox-commits.markmail.org">MarkMail Archive</a></li>
</ul>
- </section>
+ </subsection>
</section>
</body>
</document>
Modified: pdfbox/site/src/site/xdoc/references.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/references.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/references.xml (original)
+++ pdfbox/site/src/site/xdoc/references.xml Thu Mar 18 15:46:08 2010
@@ -14,11 +14,13 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox - References</title>
- </properties>
+ </head>
<body>
<section name="PDFBox References">
<p>
@@ -158,7 +160,7 @@
<p><br/></p>
<table>
<tr>
- <th width="250px">Article Name</th>
+ <th width="30%">Article Name</th>
<th>Article Abstract</th>
</tr>
<tr>
Modified: pdfbox/site/src/site/xdoc/userguide/bookmarks.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/userguide/bookmarks.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/userguide/bookmarks.xml (original)
+++ pdfbox/site/src/site/xdoc/userguide/bookmarks.xml Thu Mar 18 15:46:08 2010
@@ -14,11 +14,13 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox - PDF Bookmarks</title>
- </properties>
+ </head>
<body>
<section name="Accessing PDF Bookmarks">
<p>
@@ -81,10 +83,11 @@
firstPageItem.setDestination( firstPage );
root.appendChild( firstPageItem );
</source>
- <note>
+ <p>
+ NOTE:
By default all nodes in the outline tree are closed. You need to call openNode() if you want
the node to be open when the document is opened.
- </note>
+ </p>
</section>
</body>
</document>
Modified: pdfbox/site/src/site/xdoc/userguide/building_pdfbox.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/userguide/building_pdfbox.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/userguide/building_pdfbox.xml (original)
+++ pdfbox/site/src/site/xdoc/userguide/building_pdfbox.xml Thu Mar 18 15:46:08 2010
@@ -14,11 +14,13 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox - How to build PDFBox</title>
- </properties>
+ </head>
<body>
<section name="Building PDFBox">
<p>
@@ -67,16 +69,18 @@
for other ant targets.
</li>
</ol>
- <note>
+ <p>
+ NOTE:
If you want to run PDFBox from an IDE them you will need to add
the 'Resources' directory to the project classpath in your IDE.
- </note>
+ </p>
</section>
<section name="Running/Debugging PDFBox in Eclipse">
<p>
In order to run PDFBox from within Eclipse there are a couple things that need to be setup. Certain
pieces of functionality require access to the Resources folder. Here is an example of what you need
to do to run the ExtractText command line application.
+ </p>
<ol>
<li>In Eclipse click on "run..." or "debug..."</li>
<li>In the tree on the left select "Java Application" and click "New"</li>
@@ -87,8 +91,6 @@
<li>The "Add Folder" radio button should be selected, press ok</li>
<li>Select the root of the pdfbox project, this will make the "Resources" folder available on the classpath.</li>
</ol>
-
- </p>
</section>
</body>
</document>
Modified: pdfbox/site/src/site/xdoc/userguide/cookbook.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/userguide/cookbook.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/userguide/cookbook.xml (original)
+++ pdfbox/site/src/site/xdoc/userguide/cookbook.xml Thu Mar 18 15:46:08 2010
@@ -12,11 +12,13 @@
License for the specific language governing permissions and !
limitations under the License. !
-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox - Cookbook</title>
- </properties>
+ </head>
<body>
<section name="Cookbook">
<p>
Modified: pdfbox/site/src/site/xdoc/userguide/cookbook/creation.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/userguide/cookbook/creation.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/userguide/cookbook/creation.xml (original)
+++ pdfbox/site/src/site/xdoc/userguide/cookbook/creation.xml Thu Mar 18 15:46:08 2010
@@ -14,11 +14,13 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox - Cookbook</title>
- </properties>
+ </head>
<body>
<section name="Cookbook - Document Creation">
<subsection name="CreateBlankPDF" id="CreateBlankPDF">
Modified: pdfbox/site/src/site/xdoc/userguide/dot_net.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/userguide/dot_net.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/userguide/dot_net.xml (original)
+++ pdfbox/site/src/site/xdoc/userguide/dot_net.xml Thu Mar 18 15:46:08 2010
@@ -14,12 +14,14 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox - .NET Version</title>
- <meta name="keywords">Java PDF Library, pdftotext, PDF to text, ..NET pdf text extraction, pdf ASP, pdf .NET</meta>
- </properties>
+ <meta name="keywords" content="Java PDF Library, pdftotext, PDF to text, ..NET pdf text extraction, pdf ASP, pdf .NET"/>
+ </head>
<body>
<section name=".NET Version">
<p>
@@ -28,19 +30,19 @@
required DLL files. For the command line applications that are available in the Java version a native windows executable is
also included. This page contains information that is specific to using the .NET version of PDFBox.
</p>
- <section name="log4j">
+ <subsection name="log4j">
<p>
PDFBox no longer requires log4j! Older versions used to require you to configure log4j before using it in .NET
</p>
- </section>
- <section name="Lucene">
+ </subsection>
+ <subsection name="Lucene">
<p>
The way that IKVM works is that DLLs are only compatible when used with the dependent DLLs that are used to build them. For example, in
order to build the PDFBox DLL, a lucene DLL needs to be built, then the PDFBox DLL. The PDFBox DLL now depends on that <b>*exact*</b>
lucene DLL. This means that if you build your own version of the lucene DLL then you also need to rebuild the PDFBox DLL. Your best bet
is to use the lucene/pdfbox that is shipped with PDFBox.
</p>
- </section>
+ </subsection>
</section>
</body>
</document>
Modified: pdfbox/site/src/site/xdoc/userguide/file_references.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/userguide/file_references.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/userguide/file_references.xml (original)
+++ pdfbox/site/src/site/xdoc/userguide/file_references.xml Thu Mar 18 15:46:08 2010
@@ -14,11 +14,13 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox - PDF File References</title>
- </properties>
+ </head>
<body>
<section name="PDF File Specification">
<p>
Modified: pdfbox/site/src/site/xdoc/userguide/fonts.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/userguide/fonts.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/userguide/fonts.xml (original)
+++ pdfbox/site/src/site/xdoc/userguide/fonts.xml Thu Mar 18 15:46:08 2010
@@ -14,11 +14,13 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox - PDF Fonts</title>
- </properties>
+ </head>
<body>
<section name="Standard 14 Fonts">
<p>
Modified: pdfbox/site/src/site/xdoc/userguide/highlighting.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/userguide/highlighting.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/userguide/highlighting.xml (original)
+++ pdfbox/site/src/site/xdoc/userguide/highlighting.xml Thu Mar 18 15:46:08 2010
@@ -14,12 +14,14 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <header>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox - PDF Highlighting</title>
- <meta name="keywords">Java PDF Library, highlight, highlight pdf, highlight pdf text, java</meta>
- </header>
+ <meta name="keywords" content="Java PDF Library, highlight, highlight pdf, highlight pdf text, java"/>
+ </head>
<body>
<section name="Highlighting text in a PDF">
<p>
@@ -27,58 +29,69 @@
of a search request you might want to highlight the word in the resulting PDF document. There are several ways
this can be achieved, each method varying in complexity and flexibility.
</p>
- <section name="1. Use the 'search' open parameter">
+ <subsection name="1. Use the 'search' open parameter">
<p>
Acrobat supports passing is various parameters that tell it what to do once the PDF is open.
See <a href="http://partners.adobe.com/public/developer/en/acrobat/PDFOpenParameters.pdf" target="_blank">PDF Open Parameters</a> for
documentation on all the open parameters. One of the parameters is the 'search' parameter, this will automatically run the search
- functionality inside of Acrobat once the PDF is open. For example: <a href='http://pdfbox.apache.org/userguide/text_extraction.pdf#search="check"' target='_blank'>http://pdfbox.apache.org/userguide/text_extraction.pdf#search="check"</a><br/>
- <br/>
- <note>The words must be enclosed in quotes and separated by spaces; for example:#search="pdfbox rocks"</note>
+ functionality inside of Acrobat once the PDF is open. For example: <a href='http://pdfbox.apache.org/userguide/text_extraction.pdf#search="check"' target='_blank'>http://pdfbox.apache.org/userguide/text_extraction.pdf#search="check"</a>
+ </p>
+ <p>
+ NOTE: The words must be enclosed in quotes and separated by spaces; for example:#search="pdfbox rocks"
+ </p>
+ <p>
This is a great solution because of its simplicity! It doesn't require PDFBox at all, but it is a potential solution that
many developers are not aware of.
</p>
-
- </section>
- <section name="2. Generate a highlight XML document">
+ </subsection>
+ <subsection name="2. Generate a highlight XML document">
<p>
Acrobat also allows you to tell it to highlight specific words in the PDF document. It does this by passing an XML document to
Acrobat when opening the PDF.
See the <a href="http://partners.adobe.com/public/developer/en/pdf/HighlightFileFormat.pdf" target="_blank">PDF Highlight File Format</a>
- for more detailed documentation. <br/>
- <br/>
+ for more detailed documentation.
+ </p>
+ <p>
Basically the document allows you to tell it the characters to highlight in the PDF by using character
offsets on a page. As this is just an XML document, there are many ways you could create it but PDFBox does have a utility to make it
easier. Take a look at the javadoc for the <a href="../apidocs/org/apache/pdfbox/util/PDFHighlighter.html">PDFHighlighter</a> class. This will
allow you specify a set of words that you want have highlighted and generate the XML document for you. <br/>
- <br/>
+ </p>
+ <p>
PDFBox also ships with a complete
web application example of using this class, take a look at the pdfbox.war directory in your PDFBox installation.
- <br/>
+ </p>
+ <p>
You pass the xml to acrobat through a URL (or command line) parameter like this:
<a href="http://pdfbox.apache.org/userguide/text_extraction.pdf#xml=http://pdfbox.apache.org/highlight.xml" target="_blank">http://pdfbox.apache.org/userguide/text_extraction.pdf#xml=http://pdfbox.apache.org/highlight.xml</a>
- <br/>
- <note>The value of the xml parameter must be a full URL to the XML document. <br/>
+ </p>
+ <p>
+ NOTE: The value of the xml parameter must be a full URL to the XML document. <br/>
http://pdfbox.apache.org/userguide/text_extraction.pdf#xml=highlight.xml will not work<br/>
- http://pdfbox.apache.org/userguide/text_extraction.pdf#xml=http://pdfbox.apache.org/highlight.xml is correct!</note>
- <br/>The one drawback to this solution is that you must parse the PDF and then generate an XML document, which is a time consuming operation.
+ http://pdfbox.apache.org/userguide/text_extraction.pdf#xml=http://pdfbox.apache.org/highlight.xml is correct!
+ </p>
+ <p>
+ The one drawback to this solution is that you must parse the PDF and then generate an XML document, which is a time consuming operation.
</p>
- </section>
- <section name="3. Alter pdf contents to highlight specific text">
+ </subsection>
+ <subsection name="3. Alter pdf contents to highlight specific text">
<p>
Using PDFBox it is possible to regenerate the appearance stream to add highlighting to specific areas. While this is possible,
it will require recreating a new PDF for every search request. There is nothing prebuilt in PDFBox to do this automatically for you
- and will require a significant coding effort.<br/>
- <br/>
+ and will require a significant coding effort.
+ </p>
+ <p>
You would need to
+ </p>
<ol>
<li>Find all locations of the text, determine x/y coordinates, width/height</li>
<li>Regenerate the PDF appearance stream and draw a highlighted box behind the text. Yellow would be easiest, if you want an inverted black/white, then you would need to change the color of the text to be white and draw a black box.</li>
<li>Stream the PDF back to the user</li>
</ol>
+ <p>
This is the most flexible but is also the most work to implement and is also more resource intensive.
</p>
- </section>
+ </subsection>
</section>
</body>
</document>
Modified: pdfbox/site/src/site/xdoc/userguide/index.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/userguide/index.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/userguide/index.xml (original)
+++ pdfbox/site/src/site/xdoc/userguide/index.xml Thu Mar 18 15:46:08 2010
@@ -14,11 +14,13 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox - User Guide</title>
- </properties>
+ </head>
<body>
<section name="PDFBox User Guide">
<p>
@@ -157,7 +159,7 @@ System.out.println( "Width:" + mediaBox.
then the Calendar is converted to a string in the COSDictionary.
</p>
<p>Here is a visual depiction of the COS Model and PD Model design.</p>
- <center><img src="../images/cos-pdmodel diagram.png" /></center>
+ <center><img src="../images/cos-pdmodel diagram.png" alt="COS and PD models"/></center>
<p>
This design presents many advantages and disadvantages.<br /><br/>
<b>Advantages:</b></p>
@@ -170,8 +172,8 @@ System.out.println( "Width:" + mediaBox.
<p><b>Disadvantages:</b></p>
<ul>
<li>Object caching is not done in the PD Model classes
- <note>For example, each call to PDPage.getMediaBox() will return a new PDRectangle
- object, but will contain the same underlying COSArray.</note>
+ For example, each call to PDPage.getMediaBox() will return a new PDRectangle
+ object, but will contain the same underlying COSArray.
</li>
</ul>
</section>
Modified: pdfbox/site/src/site/xdoc/userguide/metadata.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/userguide/metadata.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/userguide/metadata.xml (original)
+++ pdfbox/site/src/site/xdoc/userguide/metadata.xml Thu Mar 18 15:46:08 2010
@@ -14,12 +14,14 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox - PDF Metadata</title>
- <meta name="keywords">Java PDF Library, XMP, PDF metadata, pdfbox</meta>
- </properties>
+ <meta name="keywords" content="Java PDF Library, XMP, PDF metadata, pdfbox"/>
+ </head>
<body>
<section name="Introduction">
<p>PDF documents can contain information describing the document itself or certain objects within the document such as
Modified: pdfbox/site/src/site/xdoc/userguide/redistribution.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/userguide/redistribution.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/userguide/redistribution.xml (original)
+++ pdfbox/site/src/site/xdoc/userguide/redistribution.xml Thu Mar 18 15:46:08 2010
@@ -14,12 +14,14 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox - Redistribution</title>
- <meta name="keywords">Java PDF Library, pdfbox</meta>
- </properties>
+ <meta name="keywords" content="Java PDF Library, pdfbox"/>
+ </head>
<body>
<section name="Redistributing PDFBox">
<p>
Modified: pdfbox/site/src/site/xdoc/userguide/text_extraction.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/userguide/text_extraction.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/userguide/text_extraction.xml (original)
+++ pdfbox/site/src/site/xdoc/userguide/text_extraction.xml Thu Mar 18 15:46:08 2010
@@ -14,12 +14,14 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox - PDF Text Extraction</title>
- <meta name="keywords">Java PDF Library, pdftotext, PDF to text, java pdf text extraction</meta>
- </properties>
+ <meta name="keywords" content="Java PDF Library, pdftotext, PDF to text, java pdf text extraction"/>
+ </head>
<body>
<section name="Extracting Text">
<p>
@@ -32,7 +34,7 @@
This functionality is encapsulated in the <a href="../apidocs/org/apache/pdfbox/util/PDFTextStripper.html">org.apache.pdfbox.util.PDFTextStripper</a> and
can be easily executed on the command line with <a href="../apidocs/org/apache/pdfbox/ExtractText.html">org.apache.pdfbox.ExtractText</a>.
</p>
- <section name="Lucene Integration">
+ <subsection name="Lucene Integration">
<p><a href="http://lucene.apache.org/java/docs/index.html">Lucene</a> 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>
@@ -47,13 +49,13 @@
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>
- </section>
- <section name="Advanced Text Extraction">
+ </subsection>
+ </section>
+ <section name="Advanced Text Extraction">
<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
<a href="../apidocs/org/apache/pdfbox/util/PDFTextStripper.html">PDFTextStripper</a> class to meet some of these requirements.</p>
- <section>
- <title>Limiting The Extracted Text</title>
+ <subsection name="Limiting The Extracted Text">
<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
@@ -66,7 +68,7 @@
stripper.writeText( ... );
</source>
- <note>The startPage and endPage properties of PDFTextStripper are 1 based and inclusive.</note>
+ <p>NOTE: The startPage and endPage properties of PDFTextStripper are 1 based and inclusive.</p>
<p>If you wanted to start on page 2 and extract to the end of the document then you would just set the startPage property.
By default all pages in the pdf document are extracted.</p>
@@ -128,17 +130,15 @@
will be thrown to indicate to the user that the bookmark is not valid.</td>
</tr>
</table>
- <note>PDFTextStripper will check both the startPage/endPage and the startBookmark/endBookmark to determine if text should
- be extracted from the current page.</note>
- </section>
- <section name="External Glyph List">
+ <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>
+ </subsection>
+ <subsection name="External Glyph List">
<p>Some PDF files need to map between glyph names and Unicode values during text extraction. PDFBox comes with an <a href="http://partners.adobe.com/public/developer/en/opentype/glyphlist.txt">Adobe Glyph List</a>, 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 <tt>glyphlist_ext</tt> JVM property. </p>
- </section>
- <section name="Right to Left Text">
+ </subsection>
+ <subsection name="Right to Left Text">
<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 <a href="http://icu-project.org/">ICU4J</a> jar file has been placed on the classpath (it is an optional dependency). Note that you should also enable sorting with either <a href="../apidocs/org/apache/pdfbox/util/PDFTextStripper.html">org.apache.pdfbox.util.PDFTextStripper</a> or <a href="../apidocs/org/apache/pdfbox/ExtractText.html">org.apache.pdfbox.ExtractText</a> to ensure accurate output.</p>
- </section>
- </section>
-
+ </subsection>
</section>
</body>
</document>
Modified: pdfbox/site/src/site/xdoc/userguide/tutorials.xml
URL: http://svn.apache.org/viewvc/pdfbox/site/src/site/xdoc/userguide/tutorials.xml?rev=924869&r1=924868&r2=924869&view=diff
==============================================================================
--- pdfbox/site/src/site/xdoc/userguide/tutorials.xml (original)
+++ pdfbox/site/src/site/xdoc/userguide/tutorials.xml Thu Mar 18 15:46:08 2010
@@ -14,11 +14,13 @@
! See the License for the specific language governing permissions and
! limitations under the License.
!-->
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
-<document>
- <properties>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
+ http://maven.apache.org/xsd/xdoc-2.0.xsd">
+ <head>
<title>PDFBox - Tutorials</title>
- </properties>
+ </head>
<body>
<section name="Tutorials">
<p>The Tutorials for PDFBox provide a quick start into some of the most common uses cases for