You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tika.apache.org by ma...@apache.org on 2016/02/20 01:42:14 UTC
svn commit: r1731321 [13/14] - in /tika/site: publish/ publish/0.10/
publish/0.5/ publish/0.6/ publish/0.7/ publish/0.8/ publish/0.9/
publish/1.0/ publish/1.1/ publish/1.10/ publish/1.11/ publish/1.12/
publish/1.13/ publish/1.2/ publish/1.3/ publish/1....
Modified: tika/site/publish/index.html
URL: http://svn.apache.org/viewvc/tika/site/publish/index.html?rev=1731321&r1=1731320&r2=1731321&view=diff
==============================================================================
--- tika/site/publish/index.html (original)
+++ tika/site/publish/index.html Sat Feb 20 00:42:12 2016
@@ -93,6 +93,8 @@
<div class="section">
<h2><a name="Latest_News"></a>Latest News</h2>
<dl>
+<dt>19 February 2016: Apache Tika Release</dt>
+<dd> Apache Tika 1.12 has been released! This release includes some improvements to Named Entity Recognition (Stanford NER integration and Apache OpenNLP) and additionally efficiency improvements to the GeoTopicParser. There are also bugfixes to Tika REST server in this release. Please see the <a class="externalLink" href="https://dist.apache.org/repos/dist/release/tika/CHANGES-1.12.txt">CHANGES.txt</a> file for a full list of changes in this release and have a look at the download page for more information on how to obtain Apache Tika 1.12.</dd>
<dt>25 October 2015: Apache Tika Release</dt>
<dd> Apache Tika 1.11 has been released! This release includes several improvements that better utilize Java7 support, that help extract more content using the cTAKES clinical extraction system and GROBID journal parser, and improvements to Tesseract extraction. Please see the <a class="externalLink" href="https://dist.apache.org/repos/dist/release/tika/CHANGES-1.11.txt">CHANGES.txt</a> file for a full list of changes in this release and have a look at the download page for more information on how to obtain Apache Tika 1.11.</dd>
<dt>01 August 2015: Apache Tika Release</dt>
@@ -254,39 +256,39 @@
<li class="expanded">
- <a href="1.11/index.html">Apache Tika 1.11</a>
+ <a href="1.12/index.html">Apache Tika 1.12</a>
<ul>
<li class="none">
- <a href="1.11/gettingstarted.html">Getting Started</a>
+ <a href="1.12/gettingstarted.html">Getting Started</a>
</li>
<li class="none">
- <a href="1.11/formats.html">Supported Formats</a>
+ <a href="1.12/formats.html">Supported Formats</a>
</li>
<li class="none">
- <a href="1.11/parser.html">Parser API</a>
+ <a href="1.12/parser.html">Parser API</a>
</li>
<li class="none">
- <a href="1.11/parser_guide.html">Parser 5min Quick Start Guide</a>
+ <a href="1.12/parser_guide.html">Parser 5min Quick Start Guide</a>
</li>
<li class="none">
- <a href="1.11/detection.html">Content and Language Detection</a>
+ <a href="1.12/detection.html">Content and Language Detection</a>
</li>
<li class="none">
- <a href="1.11/configuring.html">Configuring Tika</a>
+ <a href="1.12/configuring.html">Configuring Tika</a>
</li>
<li class="none">
- <a href="1.11/examples.html">Usage Examples</a>
+ <a href="1.12/examples.html">Usage Examples</a>
</li>
<li class="none">
- <a href="1.11/api/">API Documentation</a>
+ <a href="1.12/api/">API Documentation</a>
</li>
</ul>
</li>
@@ -302,7 +304,7 @@
<li class="collapsed">
- <a href="1.10/index.html">Apache Tika 1.10</a>
+ <a href="1.11/index.html">Apache Tika 1.11</a>
</li>
@@ -316,7 +318,7 @@
<li class="collapsed">
- <a href="1.9/index.html">Apache Tika 1.9</a>
+ <a href="1.10/index.html">Apache Tika 1.10</a>
</li>
@@ -327,9 +329,10 @@
+
<li class="collapsed">
- <a href="1.8/index.html">Apache Tika 1.8</a>
+ <a href="1.9/index.html">Apache Tika 1.9</a>
</li>
</ul>
<h5>The Apache Software Foundation</h5>
@@ -383,7 +386,7 @@
</div>
<div id="footer">
<p>
- Copyright © 2015
+ Copyright © 2016
<a href="http://www.apache.org/">The Apache Software Foundation</a>.
Site powered by <a href="http://maven.apache.org/">Apache Maven</a>.
Search powered by
Modified: tika/site/publish/issue-tracking.html
URL: http://svn.apache.org/viewvc/tika/site/publish/issue-tracking.html?rev=1731321&r1=1731320&r2=1731321&view=diff
==============================================================================
--- tika/site/publish/issue-tracking.html (original)
+++ tika/site/publish/issue-tracking.html Sat Feb 20 00:42:12 2016
@@ -136,39 +136,39 @@
<li class="expanded">
- <a href="1.11/index.html">Apache Tika 1.11</a>
+ <a href="1.12/index.html">Apache Tika 1.12</a>
<ul>
<li class="none">
- <a href="1.11/gettingstarted.html">Getting Started</a>
+ <a href="1.12/gettingstarted.html">Getting Started</a>
</li>
<li class="none">
- <a href="1.11/formats.html">Supported Formats</a>
+ <a href="1.12/formats.html">Supported Formats</a>
</li>
<li class="none">
- <a href="1.11/parser.html">Parser API</a>
+ <a href="1.12/parser.html">Parser API</a>
</li>
<li class="none">
- <a href="1.11/parser_guide.html">Parser 5min Quick Start Guide</a>
+ <a href="1.12/parser_guide.html">Parser 5min Quick Start Guide</a>
</li>
<li class="none">
- <a href="1.11/detection.html">Content and Language Detection</a>
+ <a href="1.12/detection.html">Content and Language Detection</a>
</li>
<li class="none">
- <a href="1.11/configuring.html">Configuring Tika</a>
+ <a href="1.12/configuring.html">Configuring Tika</a>
</li>
<li class="none">
- <a href="1.11/examples.html">Usage Examples</a>
+ <a href="1.12/examples.html">Usage Examples</a>
</li>
<li class="none">
- <a href="1.11/api/">API Documentation</a>
+ <a href="1.12/api/">API Documentation</a>
</li>
</ul>
</li>
@@ -184,7 +184,7 @@
<li class="collapsed">
- <a href="1.10/index.html">Apache Tika 1.10</a>
+ <a href="1.11/index.html">Apache Tika 1.11</a>
</li>
@@ -198,7 +198,7 @@
<li class="collapsed">
- <a href="1.9/index.html">Apache Tika 1.9</a>
+ <a href="1.10/index.html">Apache Tika 1.10</a>
</li>
@@ -209,9 +209,10 @@
+
<li class="collapsed">
- <a href="1.8/index.html">Apache Tika 1.8</a>
+ <a href="1.9/index.html">Apache Tika 1.9</a>
</li>
</ul>
<h5>The Apache Software Foundation</h5>
@@ -265,7 +266,7 @@
</div>
<div id="footer">
<p>
- Copyright © 2015
+ Copyright © 2016
<a href="http://www.apache.org/">The Apache Software Foundation</a>.
Site powered by <a href="http://maven.apache.org/">Apache Maven</a>.
Search powered by
Modified: tika/site/publish/license.html
URL: http://svn.apache.org/viewvc/tika/site/publish/license.html?rev=1731321&r1=1731320&r2=1731321&view=diff
==============================================================================
--- tika/site/publish/license.html (original)
+++ tika/site/publish/license.html Sat Feb 20 00:42:12 2016
@@ -91,7 +91,210 @@
<h2><a name="Project_License"></a>Project License</h2><a name="Project_License"></a>
<div class="section">
<h3><a name="Apache_License_Version_2.0"></a>Apache License, Version 2.0</h3><a name="Apache_License_Version_2.0"></a>
-<p>Can't read the url [http://www.apache.org/licenses/LICENSE-2.0.txt] : Read timed out</p></div></div>
+<div class="source">
+<pre>
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed 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.
+</pre></div></div></div>
</div>
<div id="sidebar">
<div id="navigation">
@@ -136,39 +339,39 @@
<li class="expanded">
- <a href="1.11/index.html">Apache Tika 1.11</a>
+ <a href="1.12/index.html">Apache Tika 1.12</a>
<ul>
<li class="none">
- <a href="1.11/gettingstarted.html">Getting Started</a>
+ <a href="1.12/gettingstarted.html">Getting Started</a>
</li>
<li class="none">
- <a href="1.11/formats.html">Supported Formats</a>
+ <a href="1.12/formats.html">Supported Formats</a>
</li>
<li class="none">
- <a href="1.11/parser.html">Parser API</a>
+ <a href="1.12/parser.html">Parser API</a>
</li>
<li class="none">
- <a href="1.11/parser_guide.html">Parser 5min Quick Start Guide</a>
+ <a href="1.12/parser_guide.html">Parser 5min Quick Start Guide</a>
</li>
<li class="none">
- <a href="1.11/detection.html">Content and Language Detection</a>
+ <a href="1.12/detection.html">Content and Language Detection</a>
</li>
<li class="none">
- <a href="1.11/configuring.html">Configuring Tika</a>
+ <a href="1.12/configuring.html">Configuring Tika</a>
</li>
<li class="none">
- <a href="1.11/examples.html">Usage Examples</a>
+ <a href="1.12/examples.html">Usage Examples</a>
</li>
<li class="none">
- <a href="1.11/api/">API Documentation</a>
+ <a href="1.12/api/">API Documentation</a>
</li>
</ul>
</li>
@@ -184,7 +387,7 @@
<li class="collapsed">
- <a href="1.10/index.html">Apache Tika 1.10</a>
+ <a href="1.11/index.html">Apache Tika 1.11</a>
</li>
@@ -198,7 +401,7 @@
<li class="collapsed">
- <a href="1.9/index.html">Apache Tika 1.9</a>
+ <a href="1.10/index.html">Apache Tika 1.10</a>
</li>
@@ -209,9 +412,10 @@
+
<li class="collapsed">
- <a href="1.8/index.html">Apache Tika 1.8</a>
+ <a href="1.9/index.html">Apache Tika 1.9</a>
</li>
</ul>
<h5>The Apache Software Foundation</h5>
@@ -265,7 +469,7 @@
</div>
<div id="footer">
<p>
- Copyright © 2015
+ Copyright © 2016
<a href="http://www.apache.org/">The Apache Software Foundation</a>.
Site powered by <a href="http://maven.apache.org/">Apache Maven</a>.
Search powered by
Modified: tika/site/publish/mail-lists.html
URL: http://svn.apache.org/viewvc/tika/site/publish/mail-lists.html?rev=1731321&r1=1731320&r2=1731321&view=diff
==============================================================================
--- tika/site/publish/mail-lists.html (original)
+++ tika/site/publish/mail-lists.html Sat Feb 20 00:42:12 2016
@@ -142,39 +142,39 @@
<li class="expanded">
- <a href="1.11/index.html">Apache Tika 1.11</a>
+ <a href="1.12/index.html">Apache Tika 1.12</a>
<ul>
<li class="none">
- <a href="1.11/gettingstarted.html">Getting Started</a>
+ <a href="1.12/gettingstarted.html">Getting Started</a>
</li>
<li class="none">
- <a href="1.11/formats.html">Supported Formats</a>
+ <a href="1.12/formats.html">Supported Formats</a>
</li>
<li class="none">
- <a href="1.11/parser.html">Parser API</a>
+ <a href="1.12/parser.html">Parser API</a>
</li>
<li class="none">
- <a href="1.11/parser_guide.html">Parser 5min Quick Start Guide</a>
+ <a href="1.12/parser_guide.html">Parser 5min Quick Start Guide</a>
</li>
<li class="none">
- <a href="1.11/detection.html">Content and Language Detection</a>
+ <a href="1.12/detection.html">Content and Language Detection</a>
</li>
<li class="none">
- <a href="1.11/configuring.html">Configuring Tika</a>
+ <a href="1.12/configuring.html">Configuring Tika</a>
</li>
<li class="none">
- <a href="1.11/examples.html">Usage Examples</a>
+ <a href="1.12/examples.html">Usage Examples</a>
</li>
<li class="none">
- <a href="1.11/api/">API Documentation</a>
+ <a href="1.12/api/">API Documentation</a>
</li>
</ul>
</li>
@@ -190,7 +190,7 @@
<li class="collapsed">
- <a href="1.10/index.html">Apache Tika 1.10</a>
+ <a href="1.11/index.html">Apache Tika 1.11</a>
</li>
@@ -204,7 +204,7 @@
<li class="collapsed">
- <a href="1.9/index.html">Apache Tika 1.9</a>
+ <a href="1.10/index.html">Apache Tika 1.10</a>
</li>
@@ -215,9 +215,10 @@
+
<li class="collapsed">
- <a href="1.8/index.html">Apache Tika 1.8</a>
+ <a href="1.9/index.html">Apache Tika 1.9</a>
</li>
</ul>
<h5>The Apache Software Foundation</h5>
@@ -271,7 +272,7 @@
</div>
<div id="footer">
<p>
- Copyright © 2015
+ Copyright © 2016
<a href="http://www.apache.org/">The Apache Software Foundation</a>.
Site powered by <a href="http://maven.apache.org/">Apache Maven</a>.
Search powered by
Modified: tika/site/publish/project-info.html
URL: http://svn.apache.org/viewvc/tika/site/publish/project-info.html?rev=1731321&r1=1731320&r2=1731321&view=diff
==============================================================================
--- tika/site/publish/project-info.html (original)
+++ tika/site/publish/project-info.html Sat Feb 20 00:42:12 2016
@@ -154,39 +154,39 @@
<li class="expanded">
- <a href="1.11/index.html">Apache Tika 1.11</a>
+ <a href="1.12/index.html">Apache Tika 1.12</a>
<ul>
<li class="none">
- <a href="1.11/gettingstarted.html">Getting Started</a>
+ <a href="1.12/gettingstarted.html">Getting Started</a>
</li>
<li class="none">
- <a href="1.11/formats.html">Supported Formats</a>
+ <a href="1.12/formats.html">Supported Formats</a>
</li>
<li class="none">
- <a href="1.11/parser.html">Parser API</a>
+ <a href="1.12/parser.html">Parser API</a>
</li>
<li class="none">
- <a href="1.11/parser_guide.html">Parser 5min Quick Start Guide</a>
+ <a href="1.12/parser_guide.html">Parser 5min Quick Start Guide</a>
</li>
<li class="none">
- <a href="1.11/detection.html">Content and Language Detection</a>
+ <a href="1.12/detection.html">Content and Language Detection</a>
</li>
<li class="none">
- <a href="1.11/configuring.html">Configuring Tika</a>
+ <a href="1.12/configuring.html">Configuring Tika</a>
</li>
<li class="none">
- <a href="1.11/examples.html">Usage Examples</a>
+ <a href="1.12/examples.html">Usage Examples</a>
</li>
<li class="none">
- <a href="1.11/api/">API Documentation</a>
+ <a href="1.12/api/">API Documentation</a>
</li>
</ul>
</li>
@@ -202,7 +202,7 @@
<li class="collapsed">
- <a href="1.10/index.html">Apache Tika 1.10</a>
+ <a href="1.11/index.html">Apache Tika 1.11</a>
</li>
@@ -216,7 +216,7 @@
<li class="collapsed">
- <a href="1.9/index.html">Apache Tika 1.9</a>
+ <a href="1.10/index.html">Apache Tika 1.10</a>
</li>
@@ -227,9 +227,10 @@
+
<li class="collapsed">
- <a href="1.8/index.html">Apache Tika 1.8</a>
+ <a href="1.9/index.html">Apache Tika 1.9</a>
</li>
</ul>
<h5>The Apache Software Foundation</h5>
@@ -283,7 +284,7 @@
</div>
<div id="footer">
<p>
- Copyright © 2015
+ Copyright © 2016
<a href="http://www.apache.org/">The Apache Software Foundation</a>.
Site powered by <a href="http://maven.apache.org/">Apache Maven</a>.
Search powered by
Modified: tika/site/publish/source-repository.html
URL: http://svn.apache.org/viewvc/tika/site/publish/source-repository.html?rev=1731321&r1=1731320&r2=1731321&view=diff
==============================================================================
--- tika/site/publish/source-repository.html (original)
+++ tika/site/publish/source-repository.html Sat Feb 20 00:42:12 2016
@@ -164,39 +164,39 @@ http-proxy-port = 3128
<li class="expanded">
- <a href="1.11/index.html">Apache Tika 1.11</a>
+ <a href="1.12/index.html">Apache Tika 1.12</a>
<ul>
<li class="none">
- <a href="1.11/gettingstarted.html">Getting Started</a>
+ <a href="1.12/gettingstarted.html">Getting Started</a>
</li>
<li class="none">
- <a href="1.11/formats.html">Supported Formats</a>
+ <a href="1.12/formats.html">Supported Formats</a>
</li>
<li class="none">
- <a href="1.11/parser.html">Parser API</a>
+ <a href="1.12/parser.html">Parser API</a>
</li>
<li class="none">
- <a href="1.11/parser_guide.html">Parser 5min Quick Start Guide</a>
+ <a href="1.12/parser_guide.html">Parser 5min Quick Start Guide</a>
</li>
<li class="none">
- <a href="1.11/detection.html">Content and Language Detection</a>
+ <a href="1.12/detection.html">Content and Language Detection</a>
</li>
<li class="none">
- <a href="1.11/configuring.html">Configuring Tika</a>
+ <a href="1.12/configuring.html">Configuring Tika</a>
</li>
<li class="none">
- <a href="1.11/examples.html">Usage Examples</a>
+ <a href="1.12/examples.html">Usage Examples</a>
</li>
<li class="none">
- <a href="1.11/api/">API Documentation</a>
+ <a href="1.12/api/">API Documentation</a>
</li>
</ul>
</li>
@@ -212,7 +212,7 @@ http-proxy-port = 3128
<li class="collapsed">
- <a href="1.10/index.html">Apache Tika 1.10</a>
+ <a href="1.11/index.html">Apache Tika 1.11</a>
</li>
@@ -226,7 +226,7 @@ http-proxy-port = 3128
<li class="collapsed">
- <a href="1.9/index.html">Apache Tika 1.9</a>
+ <a href="1.10/index.html">Apache Tika 1.10</a>
</li>
@@ -237,9 +237,10 @@ http-proxy-port = 3128
+
<li class="collapsed">
- <a href="1.8/index.html">Apache Tika 1.8</a>
+ <a href="1.9/index.html">Apache Tika 1.9</a>
</li>
</ul>
<h5>The Apache Software Foundation</h5>
@@ -293,7 +294,7 @@ http-proxy-port = 3128
</div>
<div id="footer">
<p>
- Copyright © 2015
+ Copyright © 2016
<a href="http://www.apache.org/">The Apache Software Foundation</a>.
Site powered by <a href="http://maven.apache.org/">Apache Maven</a>.
Search powered by
Modified: tika/site/publish/team-list.html
URL: http://svn.apache.org/viewvc/tika/site/publish/team-list.html?rev=1731321&r1=1731320&r2=1731321&view=diff
==============================================================================
--- tika/site/publish/team-list.html (original)
+++ tika/site/publish/team-list.html Sat Feb 20 00:42:12 2016
@@ -361,39 +361,39 @@ window.onLoad = init();
<li class="expanded">
- <a href="1.11/index.html">Apache Tika 1.11</a>
+ <a href="1.12/index.html">Apache Tika 1.12</a>
<ul>
<li class="none">
- <a href="1.11/gettingstarted.html">Getting Started</a>
+ <a href="1.12/gettingstarted.html">Getting Started</a>
</li>
<li class="none">
- <a href="1.11/formats.html">Supported Formats</a>
+ <a href="1.12/formats.html">Supported Formats</a>
</li>
<li class="none">
- <a href="1.11/parser.html">Parser API</a>
+ <a href="1.12/parser.html">Parser API</a>
</li>
<li class="none">
- <a href="1.11/parser_guide.html">Parser 5min Quick Start Guide</a>
+ <a href="1.12/parser_guide.html">Parser 5min Quick Start Guide</a>
</li>
<li class="none">
- <a href="1.11/detection.html">Content and Language Detection</a>
+ <a href="1.12/detection.html">Content and Language Detection</a>
</li>
<li class="none">
- <a href="1.11/configuring.html">Configuring Tika</a>
+ <a href="1.12/configuring.html">Configuring Tika</a>
</li>
<li class="none">
- <a href="1.11/examples.html">Usage Examples</a>
+ <a href="1.12/examples.html">Usage Examples</a>
</li>
<li class="none">
- <a href="1.11/api/">API Documentation</a>
+ <a href="1.12/api/">API Documentation</a>
</li>
</ul>
</li>
@@ -409,7 +409,7 @@ window.onLoad = init();
<li class="collapsed">
- <a href="1.10/index.html">Apache Tika 1.10</a>
+ <a href="1.11/index.html">Apache Tika 1.11</a>
</li>
@@ -423,7 +423,7 @@ window.onLoad = init();
<li class="collapsed">
- <a href="1.9/index.html">Apache Tika 1.9</a>
+ <a href="1.10/index.html">Apache Tika 1.10</a>
</li>
@@ -434,9 +434,10 @@ window.onLoad = init();
+
<li class="collapsed">
- <a href="1.8/index.html">Apache Tika 1.8</a>
+ <a href="1.9/index.html">Apache Tika 1.9</a>
</li>
</ul>
<h5>The Apache Software Foundation</h5>
@@ -490,7 +491,7 @@ window.onLoad = init();
</div>
<div id="footer">
<p>
- Copyright © 2015
+ Copyright © 2016
<a href="http://www.apache.org/">The Apache Software Foundation</a>.
Site powered by <a href="http://maven.apache.org/">Apache Maven</a>.
Search powered by
Added: tika/site/src/site/apt/1.12/configuring.apt
URL: http://svn.apache.org/viewvc/tika/site/src/site/apt/1.12/configuring.apt?rev=1731321&view=auto
==============================================================================
--- tika/site/src/site/apt/1.12/configuring.apt (added)
+++ tika/site/src/site/apt/1.12/configuring.apt Sat Feb 20 00:42:12 2016
@@ -0,0 +1,223 @@
+ ----------------
+ Configuring Tika
+ ----------------
+
+~~ 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.
+
+Configuring Tika
+
+ Out of the box, Apache Tika will attempt to start with all available
+ Detectors and Parsers, running with sensible defaults. For most users,
+ this default configuration will work well.
+
+ This page gives you information on how to configure the various
+ components of Apache Tika, such as Parsers and Detectors, if you need
+ fine-grained control over ordering, exclusions and the like.
+
+%{toc|section=1|fromDepth=1}
+
+* {Configuring Parsers}
+
+ Through the Tika Config xml, it is possible to have a high degree of control
+ over which parsers are or aren't used, in what order of preferences etc. It
+ is also possible to override just certain parts, to (for example) have "default
+ except for PDF".
+
+ Currently, it is only possible to have a single parser run against a document.
+ There is on-going discussion around fallback parsers and combining the output
+ of multiple parsers running on a document, but none of these are available yet.
+
+ To override some parser certain default behaviours, include the {{{ DefaultParser }}}
+ in your configuration, with excludes, then add other parser definitions in.
+ To prevent the {{{ DefaultParser }}} (with its auto-discovery) being used,
+ simply omit it from your config, and list all other parsers you want instead.
+
+ To override just some default behaviour, you can use a Tika Config something
+ like this:
+
+---
+<?xml version="1.0" encoding="UTF-8"?>
+<properties>
+ <parsers>
+ <!-- Default Parser for most things, except for 2 mime types, and never
+ use the Executable Parser -->
+ <parser class="org.apache.tika.parser.DefaultParser">
+ <mime-exclude>image/jpeg</mime-exclude>
+ <mime-exclude>application/pdf</mime-exclude>
+ <parser-exclude class="org.apache.tika.parser.executable.ExecutableParser"/>
+ </parser>
+ <!-- Use a different parser for PDF -->
+ <parser class="org.apache.tika.parser.EmptyParser">
+ <mime>application/pdf</mime>
+ </parser>
+ </parsers>
+</properties>
+---
+
+ To configure things in code, the key classes to use to build up your own custom
+ parser heirarchy are
+ {{{./api/org/apache/tika/parser/DefaultParser.html}org.apache.tika.parser.DefaultParser}},
+ {{{./api/org/apache/tika/parser/CompositeParser.html}org.apache.tika.parser.CompositeParser}}
+ and
+ {{{./api/org/apache/tika/parser/ParserDecorator.html}org.apache.tika.parser.ParserDecorator}}.
+
+* {Configuring Detectors}
+
+ Through the Tika Config xml, it is possible to have a high degree of control
+ over which detectors are or aren't used, in what order of preferences etc. It
+ is also possible to override just certain parts, to (for example) have "default
+ except for no POIFS Container Detction".
+
+ To override some detector certain default behaviours, include the
+ {{{ DefaultDetector }}}, with any {{{ detector-exclude }}} entries you need,
+ in your configuration, then add other detectors definitions in. To prevent
+ the {{{ DefaultParser }}} (with its auto-discovery) being used, simply omit it
+ from your config, and list all other detectors you want instead.
+
+ To override just some default behaviour, you can use a Tika Config something
+ like this:
+
+---
+<?xml version="1.0" encoding="UTF-8"?>
+<properties>
+ <detectors>
+ <!-- All detectors except built-in container ones -->
+ <detector class="org.apache.tika.detect.DefaultDetector">
+ <detector-exclude class="org.apache.tika.parser.pkg.ZipContainerDetector"/>
+ <detector-exclude class="org.apache.tika.parser.microsoft.POIFSContainerDetector"/>
+ </detector>
+ </detectors>
+</properties>
+---
+
+ Or to just only use certain detectors, you can use a Tika Config something
+ like this:
+
+---
+<?xml version="1.0" encoding="UTF-8"?>
+<properties>
+ <detectors>
+ <!-- Only use these two detectors, and ignore all others -->
+ <detector class="org.apache.tika.parser.pkg.ZipContainerDetector"/>
+ <detector class="org.apache.tika.mime.MimeTypes"/>
+ </detectors>
+</properties>
+---
+
+ In code, the key classes to use to build up your own custom detector
+ heirarchy are
+ {{{./api/org/apache/tika/detect/DefaultDetector.html}org.apache.tika.detect.DefaultDetector}}
+ and
+ {{{./api/org/apache/tika/detect/CompositeDetector.html}org.apache.tika.detect.CompositeDetector}}.
+
+* {Configuring Mime Types}
+
+ TODO Mention non-standard paths, and custom mime type files
+
+* {Configuring Language Identifiers}
+
+ At this time, there is no unified way to configure language identifiers.
+ While the work on that is ongoing, for now you will need to review the
+ {{{./api/}Tika Javadocs}} to see how individual identifiers are configured.
+
+* {Configuring Translators}
+
+ At this time, there is no unified way to configure Translators.
+ While the work on that is ongoing, for now you will need to review the
+ {{{./api/}Tika Javadocs}} to see how individual Translators are configured.
+
+~~ When Translators can have their parameters configured, mention here about
+~~ specifying which single one to use in the Tika Config XML
+
+* {Configuring the Service Loader}
+
+ Tika has a number of service provider types such as parsers, detectors, and translators.
+ The {{{./api/org/apache/tika/config/ServiceLoader.html}org.apache.tika.config.ServiceLoader}} class provides a registry of each type of provider. This allows Tika to create
+ implementations such as {{{./api/org/apache/tika/parser/DefaultParser.html}org.apache.tika.parser.DefaultParser}},
+ {{{./api/org/apache/tika/language/translate/DefaultTranslator.html}org.apache.tika.language.translate.DefaultTranslator}}, and {{{./api/org/apache/tika/detect/DefaultDetector.html}org.apache.tika.detect.DefaultDetector}}
+ that can match the appropriate provider to an incoming piece of content.
+
+ The ServiceLoader's registry can be populated either statically or dynamically.
+
+** Static
+
+ Static loading is the default which requires no configuration. This configuration options is used in
+ Tika deployments where the Tika JAR files reside together in the same classloader hierarchy. The services
+ provides are loaded from provider configuration files located within the tika-parsers JAR file at META-INF/services.
+
+** Dynamic
+
+ Dynamic loading may be required if the tika service providers will reside in different classloaders such as
+ in OSGi. To allow a provider created in tika-config.xml to utilize dynamically loaded services you need to
+ configure the ServiceLoader to be dynamic with the following configuration:
+
+---
+<properties>
+ <service-loader dynamic="true"/>
+ ....
+</properties>
+---
+
+** Load Error Handling
+
+ The ServiceLoader can contains a handler to deal with errors that occur during provider initialization. For example
+ if a class fails to initialize LoadErrorHandler deals with the exception that is thrown.
+ This handler can be configured to:
+
+ * <<< IGNORE >>> - (Default) Do nothing when providers fail to initialize.
+
+ * <<< WARN >>> - Log a warning when providers fail to initialize.
+
+ * <<< THROW >>> - Throw an exception when providers fail to initialize.
+
+ []
+
+ For example to set the LoadErrorHandler to WARN then use the following configuration:
+
+---
+<properties>
+ <service-loader loadErrorHandler="WARN"/>
+ ....
+</properties>
+---
+
+* {Using a Tika Configuration XML file}
+
+ However you call Tika, the System Property of <<< tika.config >>> is
+ checked first, and the Environment Variable of <<< TIKA_CONFIG >>> is
+ tried next. Setting one of those will cause Tika to use your given
+ Tika Config XML file.
+
+ If you are calling Tika from your own code, then you can pass in the
+ location of your Tika Config XML file when you construct your
+ <<<TikaConfig>>> instance. From that, you can fetch your configured
+ parser, detectors etc.
+
+---
+TikaConfig config = new TikaConfig("/path/to/tika-config.xml");
+Detector detector = config.getDetector();
+Parser autoDetectParser = new AutoDetectParser(config);
+---
+
+ For users of the Tika App, in addition to the sytem property and the
+ environement variable, you can also use the
+ <<< --config=[tika-config.xml] >>> option to select a different
+ Tika Config XML file to use
+
+ For users of the Tika Server, in addition to the sytem property and the
+ environement variable, you can also use <<< -c [tika-config.xml] >>> or
+ <<< --config [tika-config.xml] >>> options to select a different
+ Tika Config XML file to use
Added: tika/site/src/site/apt/1.12/detection.apt
URL: http://svn.apache.org/viewvc/tika/site/src/site/apt/1.12/detection.apt?rev=1731321&view=auto
==============================================================================
--- tika/site/src/site/apt/1.12/detection.apt (added)
+++ tika/site/src/site/apt/1.12/detection.apt Sat Feb 20 00:42:12 2016
@@ -0,0 +1,211 @@
+ -----------------
+ Content Detection
+ -----------------
+
+~~ 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.
+
+Content Detection
+
+ This page gives you information on how content and language detection
+ works with Apache Tika, and how to tune the behaviour of Tika.
+
+%{toc|section=1|fromDepth=1}
+
+* {The Detector Interface}
+
+ The
+ {{{./api/org/apache/tika/detect/Detector.html}org.apache.tika.detect.Detector}}
+ interface is the basis for most of the content type detection in Apache
+ Tika. All the different ways of detecting content all implement the
+ same common method:
+
+---
+MediaType detect(java.io.InputStream input,
+ Metadata metadata) throws java.io.IOException
+---
+
+ The <<<detect>>> method takes the stream to inspect, and a
+ <<<Metadata>>> object that holds any additional information on
+ the content. The detector will return a
+ {{{./api/org/apache/tika/mime/MediaType.html}MediaType}} object describing
+ its best guess as to the type of the file.
+
+ In general, only two keys on the Metadata object are used by Detectors.
+ These are <<<Metadata.RESOURCE_NAME_KEY>>> which should hold the name
+ of the file (where known), and <<<Metadata.CONTENT_TYPE>>> which should
+ hold the advertised content type of the file (eg from a webserver or
+ a content repository).
+
+
+* {Mime Magic Detection}
+
+ By looking for special ("magic") patterns of bytes near the start of
+ the file, it is often possible to detect the type of the file. For
+ some file types, this is a simple process. For others, typically
+ container based formats, the magic detection may not be enough. (More
+ detail on detecting container formats below)
+
+ Tika is able to make use of a a mime magic info file, in the
+ {{{http://www.freedesktop.org/standards/shared-mime-info}Freedesktop MIME-info}}
+ format to peform mime magic detection. (Note that Tika supports a few
+ more match types than Freedesktop does)
+
+ This is provided within Tika by
+ {{{./api/org/apache/tika/detect/MagicDetector.html}org.apache.tika.detect.MagicDetector}}. It is most commonly access via
+ {{{./api/org/apache/tika/mime/MimeTypes.html}org.apache.tika.mime.MimeTypes}},
+ normally sourced from the <<<tika-mimetypes.xml>>> and <<<custom-mimetypes.xml>>>
+ files. For more information on defining your own custom mimetypes, see
+ {{{./parser_guide.html#Add_your_MIME-Type}the new parser guide}}.
+
+
+* {Resource Name Based Detection}
+
+ Where the name of the file is known, it is sometimes possible to guess
+ the file type from the name or extension. Within the
+ <<<tika-mimetypes.xml>>> file is a list of patterns which are used to
+ identify the type from the filename.
+
+ However, because files may be renamed, this method of detection is quick
+ but not always as accurate.
+
+ This is provided within Tika by
+ {{{./api/org/apache/tika/detect/NameDetector.html}org.apache.tika.detect.NameDetector}}.
+
+
+* {Known Content Type "Detection}
+
+ Sometimes, the mime type for a file is already known, such as when
+ downloading from a webserver, or when retrieving from a content store.
+ This information can be used by detectors, such as
+ {{{./api/org/apache/tika/mime/MimeTypes.html}org.apache.tika.mime.MimeTypes}},
+
+
+* {The default Mime Types Detector}
+
+ By default, the mime type detection in Tika is provided by
+ {{{./api/org/apache/tika/mime/MimeTypes.html}org.apache.tika.mime.MimeTypes}}.
+ This detector makes use of <<<tika-mimetypes.xml>>> to power
+ magic based and filename based detection.
+
+ Firstly, magic based detection is used on the start of the file.
+ If the file is an XML file, then the start of the XML is processed
+ to look for root elements. Next, if available, the filename
+ (from <<<Metadata.RESOURCE_NAME_KEY>>>) is
+ then used to improve the detail of the detection, such as when magic
+ detects a text file, and the filename hints it's really a CSV. Finally,
+ if available, the supplied content type (from <<<Metadata.CONTENT_TYPE>>>)
+ is used to further refine the type.
+
+
+* {Container Aware Detection}
+
+ Several common file formats are actually held within a common container
+ format. One example is the PowerPoint .ppt and Word .doc formats, which
+ are both held within an OLE2 container. Another is Apple iWork formats,
+ which are actually a series of XML files within a Zip file.
+
+ Using magic detection, it is easy to spot that a given file is an OLE2
+ document, or a Zip file. Using magic detection alone, it is very difficult
+ (and often impossible) to tell what kind of file lives inside the container.
+
+ For some use cases, speed is important, so having a quick way to know the
+ container type is sufficient. For other cases however, you don't mind
+ spending a bit of time (and memory!) processing the container to get a
+ more accurate answer on its contents. For these cases, the additional
+ container aware detectors contained in the <<<Tika Parsers>>> jar should
+ be used.
+
+ Tika provides a wrapping detector in the form of
+ {{{./api/org/apache/tika/detect/DefaultDetector.html}org.apache.tika.detect.DefaultDetector}}.
+ This uses the service loader to discover all available detectors, including
+ any available container aware ones, and tries them in turn. For container
+ aware detection, include the <<<Tika Parsers>>> jar and its dependencies
+ in your project, then use DefaultDetector along with a <<<TikaInputStream>>>.
+
+ Because these container detectors needs to read the whole file to open and
+ inspect the container, they must be used with a
+ {{{./api/org/apache/tika/io/TikaInputStream.html}org.apache.tika.io.TikaInputStream}}.
+ If called with a regular <<<InputStream>>>, then all work will be done
+ by the default Mime Magic detection only.
+
+ For more information on container formats and Tika, see
+ {{{http://wiki.apache.org/tika/MetadataDiscussion}}}
+
+
+* {The default Tika Detector}
+
+ Just as with Parsers, Tika provides a special detector
+ {{{./api/org/apache/tika/detect/DefaultDetector.html}org.apache.tika.detect.DefaultDetector}}
+ which auto-detects (based on service files) the available detectors at
+ runtime, and tries these in turn to identify the file type.
+
+ If only <<<Tika Core>>> is available, the Default Detector will work only
+ with Mime Magic and Resource Name detection. However, if <<<Tika Parsers>>>
+ (and its dependencies!) are available, additional detectors which known about
+ containers (such as zip and ole2) will be used as appropriate, provided that
+ detection is being performed with a
+ {{{./api/org/apache/tika/io/TikaInputStream.html}org.apache.tika.io.TikaInputStream}}.
+ Custom detectors can also be used as desired, they simply need to be listed
+ in a service file much as is done for
+ {{{./parser_guide.html#List_the_new_parser}custom parsers}}.
+
+
+* {Ways of triggering Detection}
+
+ The simplest way to detect is through the
+ {{{./api/org/apache/tika/Tika.html}Tika Facade class}}, which provides methods to
+ detect based on
+ {{{./api/org/apache/tika/Tika.html##detect(java.io.File)}File}},
+ {{{./api/org/apache/tika/Tika.html##detect(java.io.InputStream)}InputStream}},
+ {{{./api/org/apache/tika/Tika.html##detect(java.io.InputStream, java.lang.String)}InputStream and Filename}},
+ {{{./api/org/apache/tika/Tika.html##detect(java.lang.String)}Filename}} or a few others.
+ It works best with a File or
+ {{{./api/org/apache/tika/io/TikaInputStream.html}TikaInputStream}}.
+
+ Alternately, detection can be performed on a specific Detector, or using
+ <<<DefaultDetector>>> to have all available Detectors used. A typical pattern
+ would be something like:
+
+---
+TikaConfig tika = new TikaConfig();
+
+for (File f : myListOfFiles) {
+ Metadata metadata = new Metadata();
+ metadata.set(Metadata.RESOURCE_NAME_KEY, f.toString());
+ String mimetype = tika.getDetector().detect(
+ TikaInputStream.get(f), metadata);
+ System.out.println("File " + f + " is " + mimetype);
+}
+for (InputStream is : myListOfStreams) {
+ String mimetype = tika.getDetector().detect(
+ TikaInputStream.get(is), new Metadata());
+ System.out.println("Stream " + is + " is " + mimetype);
+}
+---
+
+* {Language Detection}
+
+ Tika is able to help identify the language of a piece of text, which
+ is useful when extracting text from document formats which do not include
+ language information in their metadata.
+
+ The language detection is provided by
+ {{{./api/org/apache/tika/language/LanguageIdentifier.html}org.apache.tika.language.LanguageIdentifier}}
+
+* {More Examples}
+
+ For more examples of Detection using Apache Tika, please take a look at
+ the {{{./examples.html}Tika Examples page}}.
Added: tika/site/src/site/apt/1.12/gettingstarted.apt
URL: http://svn.apache.org/viewvc/tika/site/src/site/apt/1.12/gettingstarted.apt?rev=1731321&view=auto
==============================================================================
--- tika/site/src/site/apt/1.12/gettingstarted.apt (added)
+++ tika/site/src/site/apt/1.12/gettingstarted.apt Sat Feb 20 00:42:12 2016
@@ -0,0 +1,241 @@
+ --------------------------------
+ Getting Started with Apache Tika
+ --------------------------------
+
+~~ 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.
+
+Getting Started with Apache Tika
+
+ This document describes how to build Apache Tika from sources and
+ how to start using Tika in an application.
+
+Getting and building the sources
+
+ To build Tika from sources you first need to either
+ {{{../download.html}download}} a source release or
+ {{{../source-repository.html}checkout}} the latest sources from
+ version control.
+
+ Once you have the sources, you can build them using the
+ {{{http://maven.apache.org/}Maven 2}} build system. Executing the
+ following command in the base directory will build the sources
+ and install the resulting artifacts in your local Maven repository.
+
+---
+mvn install
+---
+
+ See the Maven documentation for more information about the available
+ build options.
+
+ Note that you need Java 7 or higher to build Tika.
+
+Build artifacts
+
+ The Tika build consists of a number of components and produces
+ the following main binaries:
+
+ [tika-core/target/tika-core-*.jar]
+ Tika core library. Contains the core interfaces and classes of Tika,
+ but none of the parser implementations. Depends only on Java 6.
+
+ [tika-parsers/target/tika-parsers-*.jar]
+ Tika parsers. Collection of classes that implement the Tika Parser
+ interface based on various external parser libraries.
+
+ [tika-app/target/tika-app-*.jar]
+ Tika application. Combines the above components and all the external
+ parser libraries into a single runnable jar with a GUI and a command
+ line interface.
+
+ [tika-server/target/tika-server-*.jar]
+ Tika JAX-RS REST application. This is a Jetty web server running Tika
+ REST services as described in {{{http://wiki.apache.org/tika/TikaJAXRS}this page}}.
+
+ [tika-bundle/target/tika-bundle-*.jar]
+ Tika bundle. An OSGi bundle that combines tika-parsers with non-OSGified
+ parser libraries to make them easy to deploy in an OSGi environment.
+
+Using Tika as a Maven dependency
+
+ The core library, <<< tika-core >>>, contains the key interfaces and classes
+ of Tika and can be used by itself if you don't need the full set of parsers
+ from the <<< tika-parsers >>> component. The tika-core dependency looks like
+ this:
+
+---
+ <dependency>
+ <groupId>org.apache.tika</groupId>
+ <artifactId>tika-core</artifactId>
+ <version>1.12</version>
+ </dependency>
+---
+
+ If you want to use Tika to parse documents (instead of simply detecting
+ document types, etc.), you'll want to depend on <<< tika-parsers >>> instead:
+
+---
+ <dependency>
+ <groupId>org.apache.tika</groupId>
+ <artifactId>tika-parsers</artifactId>
+ <version>1.12</version>
+ </dependency>
+---
+
+ Note that adding this dependency will introduce a number of
+ transitive dependencies to your project, including one on tika-core.
+ You need to make sure that these dependencies won't conflict with your
+ existing project dependencies. You can use the following command in
+ the tika-parsers directory to get a full listing of all the dependencies.
+
+---
+$ mvn dependency:tree | grep :compile
+---
+
+Using Tika in a Gradle-built project
+
+ To add a dependency on Apache Tika to your Gradle built project,
+ including the full set of parsers, you should depend on the
+ <<< tika-parsers >>> artifact:
+
+---
+dependencies {
+ runtime 'org.apache.tika:tika-parsers:1.12'
+}
+---
+
+Using Tika in an Ant project
+
+ If you are using {{{http://ant.apache.org/ivy/}Apache Ivy}} as your
+ dependency manager tool with Ant, then to include Tika with the full set
+ of parsers, you should depend on the <<< tika-parsers >>> artifact like this:
+
+---
+ <dependencies>
+ <dependency org="org.apache.tika" name="tika-parsers" rev="1.12"/>
+ </dependencies>
+---
+
+ Otherwise, probably the easiest way to use Tika is to include the full
+ <<< tika-app >>> jar on your classpath. For just core functionality, you
+ can add the <<< tika-core >>> jar, but be aware that the full set of
+ parsers have a large number of dependencies which must be included which
+ is very fiddly to do by hand with Ant! To include Tika in your Ant project,
+ you should do something like:
+
+---
+<classpath>
+ ... <!-- your other classpath entries -->
+
+ <!-- either: Tika Core only, no parsers -->
+ <pathelement location="path/to/tika-core-${tika.version}.jar"/>
+ <!-- or: Tika with all Parsers-->
+ <pathelement location="path/to/tika-app-${tika.version}.jar"/>
+
+</classpath>
+---
+
+Using Tika as a command line utility
+
+ The Tika application jar (tika-app-*.jar) can be used as a command
+ line utility for extracting text content and metadata from all sorts of
+ files. This runnable jar contains all the dependencies it needs, so
+ you don't need to worry about classpath settings to run it.
+
+ The usage instructions are shown below.
+
+---
+usage: java -jar tika-app.jar [option...] [file|port...]
+
+Options:
+ -? or --help Print this usage message
+ -v or --verbose Print debug level messages
+ -V or --version Print the Apache Tika version number
+
+ -g or --gui Start the Apache Tika GUI
+ -s or --server Start the Apache Tika server
+ -f or --fork Use Fork Mode for out-of-process extraction
+
+ -x or --xml Output XHTML content (default)
+ -h or --html Output HTML content
+ -t or --text Output plain text content
+ -T or --text-main Output plain text content (main content only)
+ -m or --metadata Output only metadata
+ -j or --json Output metadata in JSON
+ -y or --xmp Output metadata in XMP
+ -l or --language Output only language
+ -d or --detect Detect document type
+ -eX or --encoding=X Use output encoding X
+ -pX or --password=X Use document password X
+ -z or --extract Extract all attachements into current directory
+ --extract-dir=<dir> Specify target directory for -z
+ -r or --pretty-print For XML and XHTML outputs, adds newlines and
+ whitespace, for better readability
+
+ --create-profile=X
+ Create NGram profile, where X is a profile name
+ --list-parsers
+ List the available document parsers
+ --list-parser-details
+ List the available document parsers, and their supported mime types
+ --list-detectors
+ List the available document detectors
+ --list-met-models
+ List the available metadata models, and their supported keys
+ --list-supported-types
+ List all known media types and related information
+
+Description:
+ Apache Tika will parse the file(s) specified on the
+ command line and output the extracted text content
+ or metadata to standard output.
+
+ Instead of a file name you can also specify the URL
+ of a document to be parsed.
+
+ If no file name or URL is specified (or the special
+ name "-" is used), then the standard input stream
+ is parsed. If no arguments were given and no input
+ data is available, the GUI is started instead.
+
+- GUI mode
+
+ Use the "--gui" (or "-g") option to start the
+ Apache Tika GUI. You can drag and drop files from
+ a normal file explorer to the GUI window to extract
+ text content and metadata from the files.
+
+- Server mode
+
+ Use the "--server" (or "-s") option to start the
+ Apache Tika server. The server will listen to the
+ ports you specify as one or more arguments.
+---
+
+ You can also use the jar as a component in a Unix pipeline or
+ as an external tool in many scripting languages.
+
+---
+# Check if an Internet resource contains a specific keyword
+curl http://.../document.doc \
+ | java -jar tika-app.jar --text \
+ | grep -q keyword
+---
+
+Wrappers
+
+ Several wrappers are available to use Tika in another programming language,
+ such as {{{https://github.com/aviks/Taro.jl}Julia}} or {{{https://github.com/chrismattmann/tika-python}Python}}.
Added: tika/site/src/site/apt/1.12/index.apt
URL: http://svn.apache.org/viewvc/tika/site/src/site/apt/1.12/index.apt?rev=1731321&view=auto
==============================================================================
--- tika/site/src/site/apt/1.12/index.apt (added)
+++ tika/site/src/site/apt/1.12/index.apt Sat Feb 20 00:42:12 2016
@@ -0,0 +1,53 @@
+ ----------------
+ Apache Tika 1.12
+ ----------------
+
+~~ 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.
+
+Apache Tika 1.12
+
+ The most notable changes in Tika 1.12 over the previous release are:
+
+ * Support for iFrames and element link extraction is provided inthe link Content Handler ({{{http://issues.apache.org/jira/browse/1835}TIKA-1835}}).
+ * Slide notes are now linked to the slide XHTML in the PPT output({{{http://issues.apache.org/jira/browse/1840}TIKA-1840}}).
+ * JSON tests in Tika server were updated to remove impossible casts({{http://github.com/apache/tika/pulls/73}Github-73}}).
+ * Fix bug in GeoTopicParser where NER is reused instead of instantiatedwith each request ({{{http://issues.apache.org/jira/browse/1834}TIKA-1834}}).
+ * 5.1 && Downgrade Rome dependency to 0.9 to avoidnasty NPE ({{{http://issues.apache.org/jira/browse/1820}TIKA-1820}}, {{{http://issues.apache.org/jira/browse/1516}TIKA-1516}})
+ * The NamedEntityParser was enhanced to generate text contentin addition to metadata ({{{http://issues.apache.org/jira/browse/1815}TIKA-1815}}, {{{http://issues.apache.org/jira/browse/1816}TIKA-1816}}).
+ * A significant speed-up is made to the GeoTopicParser byusing the new REST server capabilities from Lucene GeoGazetteer ({{{http://issues.apache.org/jira/browse/1803}TIKA-1803}}).
+ * A parser to compute motion properties in Videos, e.g.,Histogram of Oriented Gradients and Histogram of Optical Flowsusing the Pooled Time Series algorithm, was added ({{{http://issues.apache.org/jira/browse/1798}TIKA-1798}}).
+ * Provide NamedEntityParser which exposes Named Entity Recognitionfrom OpenNLP and Stanford NER providers ({{{http://issues.apache.org/jira/browse/1787}TIKA-1787}}, {{http://github.com/apache/tika/pulls/61}Github-61}},{{http://github.com/apache/tika/pulls/62}Github-62}}).
+ * Allow XHTMLContentHandler to pass attributes of html elementvia Markus Jelsma ({{{http://issues.apache.org/jira/browse/1782}TIKA-1782}}).
+ * Fix regression with spacing in PPT via Andreas Beeker ({{{http://issues.apache.org/jira/browse/1777}TIKA-1777}}).
+ * Tika Facade parse methods for Path and File added which take aMetadata object, to mirror the existing InputStream one ({{http://github.com/apache/tika/pulls/60}Github-60}})
+
+ The following people have contributed to Tika 1.12 by submitting or
+ commenting on the issues resolved in this release:
+
+ * Bob Paulin
+ * Chris A. Mattmann
+ * Ken Krugler
+ * Lewis John McGibbney
+ * Madhav Sharan
+ * Markus Jelsma
+ * Nick Burch
+ * Roberto Benedetti
+ * Thamme Gowda N
+ * Tim Allison
+ * Vjeran Marcinko
+ * Yueheng He
+
+ See {{https://s.apache.org/wDlx}} for more details on these contributions.
Added: tika/site/src/site/apt/1.12/parser.apt
URL: http://svn.apache.org/viewvc/tika/site/src/site/apt/1.12/parser.apt?rev=1731321&view=auto
==============================================================================
--- tika/site/src/site/apt/1.12/parser.apt (added)
+++ tika/site/src/site/apt/1.12/parser.apt Sat Feb 20 00:42:12 2016
@@ -0,0 +1,251 @@
+ --------------------
+ The Parser interface
+ --------------------
+
+~~ 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.
+
+The Parser interface
+
+ The
+ {{{./api/org/apache/tika/parser/Parser.html}org.apache.tika.parser.Parser}}
+ interface is the key concept of Apache Tika. It hides the complexity of
+ different file formats and parsing libraries while providing a simple and
+ powerful mechanism for client applications to extract structured text
+ content and metadata from all sorts of documents. All this is achieved
+ with a single method:
+
+---
+void parse(
+ InputStream stream, ContentHandler handler, Metadata metadata,
+ ParseContext context) throws IOException, SAXException, TikaException;
+---
+
+ The <<<parse>>> method takes the document to be parsed and related metadata
+ as input and outputs the results as XHTML SAX events and extra metadata.
+ The parse context argument is used to specify context information (like
+ the current local) that is not related to any individual document.
+ The main criteria that lead to this design were:
+
+ [Streamed parsing] The interface should require neither the client
+ application nor the parser implementation to keep the full document
+ content in memory or spooled to disk. This allows even huge documents
+ to be parsed without excessive resource requirements.
+
+ [Structured content] A parser implementation should be able to
+ include structural information (headings, links, etc.) in the extracted
+ content. A client application can use this information for example to
+ better judge the relevance of different parts of the parsed document.
+
+ [Input metadata] A client application should be able to include metadata
+ like the file name or declared content type with the document to be
+ parsed. The parser implementation can use this information to better
+ guide the parsing process.
+
+ [Output metadata] A parser implementation should be able to return
+ document metadata in addition to document content. Many document
+ formats contain metadata like the name of the author that may be useful
+ to client applications.
+
+ [Context sensitivity] While the default settings and behaviour of Tika
+ parsers should work well for most use cases, there are still situations
+ where more fine-grained control over the parsing process is desirable.
+ It should be easy to inject such context-specific information to the
+ parsing process without breaking the layers of abstraction.
+
+ []
+
+ These criteria are reflected in the arguments of the <<<parse>>> method.
+
+* Document input stream
+
+ The first argument is an
+ {{{http://docs.oracle.com/javase/6/docs/api/java/io/InputStream.html}InputStream}}
+ for reading the document to be parsed.
+
+ If this document stream can not be read, then parsing stops and the thrown
+ {{{http://docs.oracle.com/javase/6/docs/api/java/io/IOException.html}IOException}}
+ is passed up to the client application. If the stream can be read but
+ not parsed (for example if the document is corrupted), then the parser
+ throws a {{{./api/org/apache/tika/exception/TikaException.html}TikaException}}.
+
+ The parser implementation will consume this stream but <will not close it>.
+ Closing the stream is the responsibility of the client application that
+ opened it in the first place. The recommended pattern for using streams
+ with the <<<parse>>> method is:
+
+---
+InputStream stream = ...; // open the stream
+try {
+ parser.parse(stream, ...); // parse the stream
+} finally {
+ stream.close(); // close the stream
+}
+---
+
+ Some document formats like the OLE2 Compound Document Format used by
+ Microsoft Office are best parsed as random access files. In such cases the
+ content of the input stream is automatically spooled to a temporary file
+ that gets removed once parsed. A future version of Tika may make it possible
+ to avoid this extra file if the input document is already a file in the
+ local file system. See
+ {{{https://issues.apache.org/jira/browse/TIKA-153}TIKA-153}} for the status
+ of this feature request.
+
+* XHTML SAX events
+
+ The parsed content of the document stream is returned to the client
+ application as a sequence of XHTML SAX events. XHTML is used to express
+ structured content of the document and SAX events enable streamed
+ processing. Note that the XHTML format is used here only to convey
+ structural information, not to render the documents for browsing!
+
+ The XHTML SAX events produced by the parser implementation are sent to a
+ {{{http://docs.oracle.com/javase/6/docs/api/org/xml/sax/ContentHandler.html}ContentHandler}}
+ instance given to the <<<parse>>> method. If this the content handler
+ fails to process an event, then parsing stops and the thrown
+ {{{http://docs.oracle.com/javase/6/docs/api/org/xml/sax/SAXException.html}SAXException}}
+ is passed up to the client application.
+
+ The overall structure of the generated event stream is (with indenting
+ added for clarity):
+
+---
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>...</title>
+ </head>
+ <body>
+ ...
+ </body>
+</html>
+---
+
+ Parser implementations typically use the
+ {{{./api/org/apache/tika/sax/XHTMLContentHandler.html}XHTMLContentHandler}}
+ utility class to generate the XHTML output.
+
+ Dealing with the raw SAX events can be a bit complex, so Apache Tika
+ comes with a number of utility classes that can be used to process and
+ convert the event stream to other representations.
+
+ For example, the
+ {{{./api/org/apache/tika/sax/BodyContentHandler.html}BodyContentHandler}}
+ class can be used to extract just the body part of the XHTML output and
+ feed it either as SAX events to another content handler or as characters
+ to an output stream, a writer, or simply a string. The following code
+ snippet parses a document from the standard input stream and outputs the
+ extracted text content to standard output:
+
+---
+ContentHandler handler = new BodyContentHandler(System.out);
+parser.parse(System.in, handler, ...);
+---
+
+ Another useful class is
+ {{{./api/org/apache/tika/parser/ParsingReader.html}ParsingReader}} that
+ uses a background thread to parse the document and returns the extracted
+ text content as a character stream:
+
+---
+InputStream stream = ...; // the document to be parsed
+Reader reader = new ParsingReader(parser, stream, ...);
+try {
+ ...; // read the document text using the reader
+} finally {
+ reader.close(); // the document stream is closed automatically
+}
+---
+
+* Document metadata
+
+ The third argument to the <<<parse>>> method is used to pass document
+ metadata both in and out of the parser. Document metadata is expressed
+ as an {{{./api/org/apache/tika/metadata/Metadata.html}Metadata}} object.
+
+ The following are some of the more interesting metadata properties:
+
+ [Metadata.RESOURCE_NAME_KEY] The name of the file or resource that contains
+ the document.
+
+ A client application can set this property to allow the parser to use
+ file name heuristics to determine the format of the document.
+
+ The parser implementation may set this property if the file format
+ contains the canonical name of the file (for example the Gzip format
+ has a slot for the file name).
+
+ [Metadata.CONTENT_TYPE] The declared content type of the document.
+
+ A client application can set this property based on for example a HTTP
+ Content-Type header. The declared content type may help the parser to
+ correctly interpret the document.
+
+ The parser implementation sets this property to the content type according
+ to which the document was parsed.
+
+ [Metadata.TITLE] The title of the document.
+
+ The parser implementation sets this property if the document format
+ contains an explicit title field.
+
+ [Metadata.AUTHOR] The name of the author of the document.
+
+ The parser implementation sets this property if the document format
+ contains an explicit author field.
+
+ []
+
+ Note that metadata handling is still being discussed by the Tika development
+ team, and it is likely that there will be some (backwards incompatible)
+ changes in metadata handling before Tika 1.0.
+
+* Parse context
+
+
+ The final argument to the <<<parse>>> method is used to inject
+ context-specific information to the parsing process. This is useful
+ for example when dealing with locale-specific date and number formats
+ in Microsoft Excel spreadsheets. Another important use of the parse
+ context is passing in the delegate parser instance to be used by
+ two-phase parsers like the
+ {{{./api/org/apache/parser/pkg/PackageParser.html}PackageParser}} subclasses.
+ Some parser classes allow customization of the parsing process through
+ strategy objects in the parse context.
+
+* Parser implementations
+
+ Apache Tika comes with a number of parser classes for parsing
+ {{{./formats.html}various document formats}}. You can also extend Tika
+ with your own parsers, and of course any contributions to Tika are
+ warmly welcome.
+
+ The goal of Tika is to reuse existing parser libraries like
+ {{{http://pdfbox.apache.org/}PDFBox}} or
+ {{{http://poi.apache.org/}Apache POI}} as much as possible, and so most
+ of the parser classes in Tika are adapters to such external libraries.
+
+ Tika also contains some general purpose parser implementations that are
+ not targeted at any specific document formats. The most notable of these
+ is the {{{./api/org/apache/tika/parser/AutoDetectParser.html}AutoDetectParser}}
+ class that encapsulates all Tika functionality into a single parser that
+ can handle any types of documents. This parser will automatically determine
+ the type of the incoming document based on various heuristics and will then
+ parse the document accordingly.
+
+* {More Examples}
+
+ For more examples of calling Parsing with Apache Tika, please take a look at
+ the {{{./examples.html}Tika Examples page}}.