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 2011/11/08 08:29:44 UTC
svn commit: r1199134 - in /tika/site: publish/1.0/gettingstarted.html
publish/1.0/index.html src/site/apt/1.0/gettingstarted.apt
src/site/apt/1.0/index.apt
Author: mattmann
Date: Tue Nov 8 07:29:43 2011
New Revision: 1199134
URL: http://svn.apache.org/viewvc?rev=1199134&view=rev
Log:
- Update site with 1.0 release info.
Modified:
tika/site/publish/1.0/gettingstarted.html
tika/site/publish/1.0/index.html
tika/site/src/site/apt/1.0/gettingstarted.apt
tika/site/src/site/apt/1.0/index.apt
Modified: tika/site/publish/1.0/gettingstarted.html
URL: http://svn.apache.org/viewvc/tika/site/publish/1.0/gettingstarted.html?rev=1199134&r1=1199133&r2=1199134&view=diff
==============================================================================
--- tika/site/publish/1.0/gettingstarted.html (original)
+++ tika/site/publish/1.0/gettingstarted.html Tue Nov 8 07:29:43 2011
@@ -84,41 +84,49 @@
width="387" height="100"/></a>
</div>
<div id="content">
- <!-- 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. --><div class="section"><h2>Getting Started with Apache Tika<a name="Getting_Started_with_Apache_Tika"></a></h2><p>This d
ocument describes how to build Apache Tika from sources and how to start using Tika in an application.</p></div><div class="section"><h2>Getting and building the sources<a name="Getting_and_building_the_sources"></a></h2><p>To build Tika from sources you first need to either <a href="../download.html">download</a> a source release or <a href="../source-repository.html">checkout</a> the latest sources from version control.</p><p>Once you have the sources, you can build them using the <a class="externalLink" href="http://maven.apache.org/">Maven 2</a> build system. Executing the following command in the base directory will build the sources and install the resulting artifacts in your local Maven repository.</p><div><pre>mvn install</pre></div><p>See the Maven documentation for more information about the available build options.</p><p>Note that you need Java 5 or higher to build Tika.</p></div><div class="section"><h2>Build artifacts<a name="Build_artifacts"></a></h2><p>The Tik
a 0.8 build consists of a number of components and produces the following main binaries:</p><dl><dt>tika-core/target/tika-core-0.8.jar</dt><dd> Tika core library. Contains the core interfaces and classes of Tika, but none of the parser implementations. Depends only on Java 5.</dd><dt>tika-parsers/target/tika-parsers-0.8.jar</dt><dd> Tika parsers. Collection of classes that implement the Tika Parser interface based on various external parser libraries.</dd><dt>tika-app/target/tika-app-0.8.jar</dt><dd> Tika application. Combines the above libraries and all the external parser libraries into a single runnable jar with a GUI and a command line interface.</dd><dt>tika-bundle/target/tika-bundle-0.8.jar</dt><dd> Tika bundle. An OSGi bundle that includes everything you need to use all Tika functionality in an OSGi environment.</dd></dl></div><div class="section"><h2>Using Tika as a Maven dependency<a name="Using_Tika_as_a_Maven_dependency"></a></h2><p>The core library, tika-core, co
ntains 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:</p><div><pre> <dependency>
+ <!-- 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. --><div class="section"><h2>Getting Started with Apache Tika<a name="Getting_Started_with_Apache_Tika"></a></h2><p>This d
ocument describes how to build Apache Tika from sources and how to start using Tika in an application.</p></div><div class="section"><h2>Getting and building the sources<a name="Getting_and_building_the_sources"></a></h2><p>To build Tika from sources you first need to either <a href="../download.html">download</a> a source release or <a href="../source-repository.html">checkout</a> the latest sources from version control.</p><p>Once you have the sources, you can build them using the <a class="externalLink" href="http://maven.apache.org/">Maven 2</a> build system. Executing the following command in the base directory will build the sources and install the resulting artifacts in your local Maven repository.</p><div><pre>mvn install</pre></div><p>See the Maven documentation for more information about the available build options.</p><p>Note that you need Java 5 or higher to build Tika.</p></div><div class="section"><h2>Build artifacts<a name="Build_artifacts"></a></h2><p>The Tik
a 1.0 build consists of a number of components and produces the following main binaries:</p><dl><dt>tika-core/target/tika-core-1.0.jar</dt><dd> Tika core library. Contains the core interfaces and classes of Tika, but none of the parser implementations. Depends only on Java 5.</dd><dt>tika-parsers/target/tika-parsers-1.0.jar</dt><dd> Tika parsers. Collection of classes that implement the Tika Parser interface based on various external parser libraries.</dd><dt>tika-app/target/tika-app-1.0.jar</dt><dd> Tika application. Combines the above libraries and all the external parser libraries into a single runnable jar with a GUI and a command line interface.</dd><dt>tika-bundle/target/tika-bundle-1.0.jar</dt><dd> Tika bundle. An OSGi bundle that includes everything you need to use all Tika functionality in an OSGi environment.</dd></dl></div><div class="section"><h2>Using Tika as a Maven dependency<a name="Using_Tika_as_a_Maven_dependency"></a></h2><p>The core library, tika-core, co
ntains 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:</p><div><pre> <dependency>
<groupId>org.apache.tika</groupId>
<artifactId>tika-core</artifactId>
- <version>0.8</version>
+ <version>1.0</version>
</dependency></pre></div><p>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: </p><div><pre> <dependency>
<groupId>org.apache.tika</groupId>
<artifactId>tika-parsers</artifactId>
- <version>0.8</version>
- </dependency></pre></div><p>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. The listing below shows all the compile-scope dependencies of tika-parsers in the Tika 0.8 release.</p><div><pre>org.apache.tika:tika-parsers:bundle:0.8
-+- org.apache.tika:tika-core:jar:0.8:compile
-+- org.apache.commons:commons-compress:jar:1.0:compile
-+- org.apache.pdfbox:pdfbox:jar:0.8.0-incubating:compile
-| +- org.apache.pdfbox:fontbox:jar:0.8.0-incubator:compile
-| \- org.apache.pdfbox:jempbox:jar:0.8.0-incubator:compile
-+- org.apache.poi:poi:jar:3.6:compile
-+- org.apache.poi:poi-scratchpad:jar:3.6:compile
-+- org.apache.poi:poi-ooxml:jar:3.6:compile
-| +- org.apache.poi:poi-ooxml-schemas:jar:3.6:compile
-| | \- org.apache.xmlbeans:xmlbeans:jar:2.3.0:compile
-| \- dom4j:dom4j:jar:1.6.1:compile
-| \- xml-apis:xml-apis:jar:1.0.b2:compile
-+- org.apache.geronimo.specs:geronimo-stax-api_1.0_spec:jar:1.0.1:compile
-+- commons-logging:commons-logging:jar:1.1.1:compile
-+- org.ccil.cowan.tagsoup:tagsoup:jar:1.2:compile
-+- asm:asm:jar:3.1:compile
-+- log4j:log4j:jar:1.2.14:compile
-\- com.drewnoakes:metadata-extractor:jar:2.4.0-beta-1:compile</pre></div></div><div class="section"><h2>Using Tika in an Ant project<a name="Using_Tika_in_an_Ant_project"></a></h2><p>Unless you use a dependency manager tool like <a class="externalLink" href="http://ant.apache.org/ivy/">Apache Ivy</a>, to use Tika in you application you can include the Tika jar files and the dependencies individually.</p><div><pre><classpath>
+ <version>1.0</version>
+ </dependency></pre></div><p>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. The listing below shows all the compile-scope dependencies of tika-parsers in the Tika 1.0 release.</p><div><pre> org.apache.tika:tika-parsers:bundle:1.0
+ +- org.apache.tika:tika-core:jar:1.0:compile
+ +- edu.ucar:netcdf:jar:4.2-min:compile
+ | \- org.slf4j:slf4j-api:jar:1.5.6:compile
+ +- org.apache.james:apache-mime4j-core:jar:0.7:compile
+ +- org.apache.james:apache-mime4j-dom:jar:0.7:compile
+ +- org.apache.commons:commons-compress:jar:1.3:compile
+ +- commons-codec:commons-codec:jar:1.5:compile
+ +- org.apache.pdfbox:pdfbox:jar:1.6.0:compile
+ | +- org.apache.pdfbox:fontbox:jar:1.6.0:compile
+ | +- org.apache.pdfbox:jempbox:jar:1.6.0:compile
+ | \- commons-logging:commons-logging:jar:1.1.1:compile
+ +- org.bouncycastle:bcmail-jdk15:jar:1.45:compile
+ +- org.bouncycastle:bcprov-jdk15:jar:1.45:compile
+ +- org.apache.poi:poi:jar:3.8-beta4:compile
+ +- org.apache.poi:poi-scratchpad:jar:3.8-beta4:compile
+ +- org.apache.poi:poi-ooxml:jar:3.8-beta4:compile
+ | +- org.apache.poi:poi-ooxml-schemas:jar:3.8-beta4:compile
+ | | \- org.apache.xmlbeans:xmlbeans:jar:2.3.0:compile
+ | \- dom4j:dom4j:jar:1.6.1:compile
+ +- org.apache.geronimo.specs:geronimo-stax-api_1.0_spec:jar:1.0.1:compile
+ +- org.ccil.cowan.tagsoup:tagsoup:jar:1.2.1:compile
+ +- asm:asm:jar:3.1:compile
+ +- com.drewnoakes:metadata-extractor:jar:2.4.0-beta-1:compile
+ +- de.l3s.boilerpipe:boilerpipe:jar:1.1.0:compile
+ +- rome:rome:jar:0.9:compile
+ \- jdom:jdom:jar:1.0:compile</pre></div></div><div class="section"><h2>Using Tika in an Ant project<a name="Using_Tika_in_an_Ant_project"></a></h2><p>Unless you use a dependency manager tool like <a class="externalLink" href="http://ant.apache.org/ivy/">Apache Ivy</a>, to use Tika in you application you can include the Tika jar files and the dependencies individually.</p><div><pre><classpath>
... <!-- your other classpath entries -->
- <pathelement location="path/to/tika-core-0.8.jar"/>
- <pathelement location="path/to/tika-parsers-0.8.jar"/>
+ <pathelement location="path/to/tika-core-1.0.jar"/>
+ <pathelement location="path/to/tika-parsers-1.0.jar"/>
<pathelement location="path/to/commons-logging-1.1.1.jar"/>
<pathelement location="path/to/commons-compress-1.0.jar"/>
- <pathelement location="path/to/pdfbox-0.8.0-incubating.jar"/>
- <pathelement location="path/to/fontbox-0.8.0-incubator.jar"/>
- <pathelement location="path/to/jempbox-0.8.0-incubator.jar"/>
+ <pathelement location="path/to/pdfbox-1.0.0-incubating.jar"/>
+ <pathelement location="path/to/fontbox-1.0.0-incubator.jar"/>
+ <pathelement location="path/to/jempbox-1.0.0-incubator.jar"/>
<pathelement location="path/to/poi-3.6.jar"/>
<pathelement location="path/to/poi-scratchpad-3.6.jar"/>
<pathelement location="path/to/poi-ooxml-3.6.jar"/>
@@ -131,7 +139,7 @@
<pathelement location="path/to/asm-3.1.jar"/>
<pathelement location="path/to/log4j-1.2.14.jar"/>
<pathelement location="path/to/metadata-extractor-2.4.0-beta-1.jar"/>
-</classpath></pre></div><p>An easy way to gather all these libraries is to run "mvn dependency:copy-dependencies" in the tika-parsers source directory. This will copy all Tika dependencies to the <tt>target/dependencies</tt> directory.</p><p>Alternatively you can simply drop the entire tika-app jar to your classpath to get all of the above dependencies in a single archive.</p></div><div class="section"><h2>Using Tika as a command line utility<a name="Using_Tika_as_a_command_line_utility"></a></h2><p>The Tika application jar (tika-app-0.8.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.</p><p>The usage instructions are shown below.</p><div><pre>usage: java -jar tika-app-0.8.jar [option] [file]
+</classpath></pre></div><p>An easy way to gather all these libraries is to run "mvn dependency:copy-dependencies" in the tika-parsers source directory. This will copy all Tika dependencies to the <tt>target/dependencies</tt> directory.</p><p>Alternatively you can simply drop the entire tika-app jar to your classpath to get all of the above dependencies in a single archive.</p></div><div class="section"><h2>Using Tika as a command line utility<a name="Using_Tika_as_a_command_line_utility"></a></h2><p>The Tika application jar (tika-app-1.0.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.</p><p>The usage instructions are shown below.</p><div><pre>usage: java -jar tika-app-1.0.jar [option] [file]
Options:
-? or --help Print this usage message
@@ -159,7 +167,7 @@ Description:
from a normal file explorer to the GUI window to
extract text content and metadata from the files.</pre></div><p>You can also use the jar as a component in a Unix pipeline or as an external tool in many scripting languages.</p><div><pre># Check if an Internet resource contains a specific keyword
curl http://.../document.doc \
- | java -jar tika-app-0.8.jar --text \
+ | java -jar tika-app-1.0.jar --text \
| grep -q keyword</pre></div></div>
</div>
<div id="sidebar">
Modified: tika/site/publish/1.0/index.html
URL: http://svn.apache.org/viewvc/tika/site/publish/1.0/index.html?rev=1199134&r1=1199133&r2=1199134&view=diff
==============================================================================
--- tika/site/publish/1.0/index.html (original)
+++ tika/site/publish/1.0/index.html Tue Nov 8 07:29:43 2011
@@ -84,7 +84,7 @@
width="387" height="100"/></a>
</div>
<div id="content">
- <!-- 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. --><div class="section"><h2>Apache Tika 1.0<a name="Apache_Tika_1.0"></a></h2><p>The most notable changes in Tika 1.0 ove
r the previous release are:</p><ul><li>TBD</li></ul><p>The following people have contributed to Tika 1.0 by submitting or commenting on the issues resolved in this release:</p><ul><li>TBD</li></ul><p>See TBD for more details on these contributions.</p></div>
+ <!-- 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. --><div class="section"><h2>Apache Tika 1.0<a name="Apache_Tika_1.0"></a></h2><p>The most notable changes in Tika 1.0 ove
r the previous release are:</p><ul><li>API: All methods, classes and interfaces that were marked as deprecated in Tika 0.10 have been removed to clean up the API (<a class="externalLink" href="http://issues.apache.org/jira/browse/TIKA-703">TIKA-703</a>). You may need to adjust and recompile client code accordingly. The declared OSGi package versions are now 1.0, and will thus not resolve for client bundles that still refer to 0.x versions (<a class="externalLink" href="http://issues.apache.org/jira/browse/TIKA-565">TIKA-565</a>).</li><li>Configuration: The context class loader of the current thread is no longer used as the default for loading configured parser and detector classes. You can still pass an explicit class loader to the configuration mechanism to get the previous behaviour. (<a class="externalLink" href="http://issues.apache.org/jira/browse/TIKA-565">TIKA-565</a>).</li><li>OSGi: The tika-core bundle will now automatically pick up and use any available Parser and
Detector services when deployed to an OSGi environment. The tika-parsers bundle provides such services based on for all the supported file formats for which the upstream parser library is available. If you don't want to track all the parser libraries as separate OSGi bundles, you can use the tika-bundle bundle that packages tika-parsers together with all its upstream dependencies. (<a class="externalLink" href="http://issues.apache.org/jira/browse/TIKA-565">TIKA-565</a>).</li><li>RTF: Hyperlinks in RTF documents are now extracted as an <i>a href=...</i>...<i>/a</i> element (<a class="externalLink" href="http://issues.apache.org/jira/browse/TIKA-632">TIKA-632</a>). The RTF parser is also now more robust when encountering too many closing {'s vs. opening {'s (<a class="externalLink" href="http://issues.apache.org/jira/browse/TIKA-733">TIKA-733</a>).</li><li>MS Word: From Word (.doc) documents we now extract optional hyphen as Unicode zero-width space (U+200B), and non-breaking
hyphen as Unicode non-breaking hyphen (U+2011). (<a class="externalLink" href="http://issues.apache.org/jira/browse/TIKA-711">TIKA-711</a>).</li><li>Outlook: Tika can now process also attachments in Outlook messages. (<a class="externalLink" href="http://issues.apache.org/jira/browse/TIKA-396">TIKA-396</a>).</li><li>MS Office: Performance of extracting embedded office docs was improved. (<a class="externalLink" href="http://issues.apache.org/jira/browse/TIKA-753">TIKA-753</a>).</li><li>PDF: The PDF parser now extracts paragraphs within each page (<a class="externalLink" href="http://issues.apache.org/jira/browse/TIKA-742">TIKA-742) and can now optionally extract text from PDF annotations ({{{http://issues.apache.org/jira/browse/TIKA-738}TIKA-738</a>). There's also an option to enable (the default) or disable auto-space insertion (<a class="externalLink" href="http://issues.apache.org/jira/browse/TIKA-724">TIKA-724</a>). </li><li>Language detection: Tika can now detect Belar
usian, Catalan, Esperanto, Galician, Lithuanian (TIKA-582), Romanian, Slovak, Slovenian, and Ukrainian (<a class="externalLink" href="http://issues.apache.org/jira/browse/TIKA-681">TIKA-681</a>).</li><li>Java: Tika no longer ships retrotranslated Java 1.4 binaries along with the normal ones that work with Java 5 and higher. (<a class="externalLink" href="http://issues.apache.org/jira/browse/TIKA-744">TIKA-744</a>).</li><li>OpenOffice documents: header/footer text is now extracted for text, presentation and spreadsheet documents (<a class="externalLink" href="http://issues.apache.org/jira/browse/TIKA-736">TIKA-736</a>).</li></ul><p>The following people have contributed to Tika 1.0 by submitting or commenting on the issues resolved in this release:</p><ul><li>Andrzej Bialecki</li><li>Antoni Mylka</li><li>Benson Margulies</li><li>Chris A. Mattmann</li><li>Cristian Vat</li><li>Dave Meikle</li><li>David Smiley</li><li>Dennis Adler</li><li>Erik Hetzner</li><li>Ingo Renner</li><li>
Jeremias Maerki</li><li>Jeremy Anderson</li><li>Jeroen van Vianen</li><li>John Bartak</li><li>Jukka Zitting</li><li>Julien Nioche</li><li>Ken Krugler</li><li>Mark Butler</li><li>Maxim Valyanskiy</li><li>Michael Bryant</li><li>Michael McCandless </li><li>Nick Burch</li><li>Pablo Queixalos</li><li>Uwe Schindler</li><li>Žygimantas Medelis</li></ul><p>See <a class="externalLink" href="http://s.apache.org/Zk6">http://s.apache.org/Zk6</a> for more details on these contributions.</p></div>
</div>
<div id="sidebar">
<div id="navigation">
Modified: tika/site/src/site/apt/1.0/gettingstarted.apt
URL: http://svn.apache.org/viewvc/tika/site/src/site/apt/1.0/gettingstarted.apt?rev=1199134&r1=1199133&r2=1199134&view=diff
==============================================================================
--- tika/site/src/site/apt/1.0/gettingstarted.apt (original)
+++ tika/site/src/site/apt/1.0/gettingstarted.apt Tue Nov 8 07:29:43 2011
@@ -45,23 +45,23 @@ mvn install
Build artifacts
- The Tika 0.8 build consists of a number of components and produces
+ The Tika 1.0 build consists of a number of components and produces
the following main binaries:
- [tika-core/target/tika-core-0.8.jar]
+ [tika-core/target/tika-core-1.0.jar]
Tika core library. Contains the core interfaces and classes of Tika,
but none of the parser implementations. Depends only on Java 5.
- [tika-parsers/target/tika-parsers-0.8.jar]
+ [tika-parsers/target/tika-parsers-1.0.jar]
Tika parsers. Collection of classes that implement the Tika Parser
interface based on various external parser libraries.
- [tika-app/target/tika-app-0.8.jar]
+ [tika-app/target/tika-app-1.0.jar]
Tika application. Combines the above libraries and all the external
parser libraries into a single runnable jar with a GUI and a command
line interface.
- [tika-bundle/target/tika-bundle-0.8.jar]
+ [tika-bundle/target/tika-bundle-1.0.jar]
Tika bundle. An OSGi bundle that includes everything you need to use all
Tika functionality in an OSGi environment.
@@ -75,7 +75,7 @@ Using Tika as a Maven dependency
<dependency>
<groupId>org.apache.tika</groupId>
<artifactId>tika-core</artifactId>
- <version>0.8</version>
+ <version>1.0</version>
</dependency>
---
@@ -86,7 +86,7 @@ Using Tika as a Maven dependency
<dependency>
<groupId>org.apache.tika</groupId>
<artifactId>tika-parsers</artifactId>
- <version>0.8</version>
+ <version>1.0</version>
</dependency>
---
@@ -94,28 +94,36 @@ Using Tika as a Maven dependency
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. The listing below shows all the
- compile-scope dependencies of tika-parsers in the Tika 0.8 release.
+ compile-scope dependencies of tika-parsers in the Tika 1.0 release.
---
-org.apache.tika:tika-parsers:bundle:0.8
-+- org.apache.tika:tika-core:jar:0.8:compile
-+- org.apache.commons:commons-compress:jar:1.0:compile
-+- org.apache.pdfbox:pdfbox:jar:0.8.0-incubating:compile
-| +- org.apache.pdfbox:fontbox:jar:0.8.0-incubator:compile
-| \- org.apache.pdfbox:jempbox:jar:0.8.0-incubator:compile
-+- org.apache.poi:poi:jar:3.6:compile
-+- org.apache.poi:poi-scratchpad:jar:3.6:compile
-+- org.apache.poi:poi-ooxml:jar:3.6:compile
-| +- org.apache.poi:poi-ooxml-schemas:jar:3.6:compile
-| | \- org.apache.xmlbeans:xmlbeans:jar:2.3.0:compile
-| \- dom4j:dom4j:jar:1.6.1:compile
-| \- xml-apis:xml-apis:jar:1.0.b2:compile
-+- org.apache.geronimo.specs:geronimo-stax-api_1.0_spec:jar:1.0.1:compile
-+- commons-logging:commons-logging:jar:1.1.1:compile
-+- org.ccil.cowan.tagsoup:tagsoup:jar:1.2:compile
-+- asm:asm:jar:3.1:compile
-+- log4j:log4j:jar:1.2.14:compile
-\- com.drewnoakes:metadata-extractor:jar:2.4.0-beta-1:compile
+ org.apache.tika:tika-parsers:bundle:1.0
+ +- org.apache.tika:tika-core:jar:1.0:compile
+ +- edu.ucar:netcdf:jar:4.2-min:compile
+ | \- org.slf4j:slf4j-api:jar:1.5.6:compile
+ +- org.apache.james:apache-mime4j-core:jar:0.7:compile
+ +- org.apache.james:apache-mime4j-dom:jar:0.7:compile
+ +- org.apache.commons:commons-compress:jar:1.3:compile
+ +- commons-codec:commons-codec:jar:1.5:compile
+ +- org.apache.pdfbox:pdfbox:jar:1.6.0:compile
+ | +- org.apache.pdfbox:fontbox:jar:1.6.0:compile
+ | +- org.apache.pdfbox:jempbox:jar:1.6.0:compile
+ | \- commons-logging:commons-logging:jar:1.1.1:compile
+ +- org.bouncycastle:bcmail-jdk15:jar:1.45:compile
+ +- org.bouncycastle:bcprov-jdk15:jar:1.45:compile
+ +- org.apache.poi:poi:jar:3.8-beta4:compile
+ +- org.apache.poi:poi-scratchpad:jar:3.8-beta4:compile
+ +- org.apache.poi:poi-ooxml:jar:3.8-beta4:compile
+ | +- org.apache.poi:poi-ooxml-schemas:jar:3.8-beta4:compile
+ | | \- org.apache.xmlbeans:xmlbeans:jar:2.3.0:compile
+ | \- dom4j:dom4j:jar:1.6.1:compile
+ +- org.apache.geronimo.specs:geronimo-stax-api_1.0_spec:jar:1.0.1:compile
+ +- org.ccil.cowan.tagsoup:tagsoup:jar:1.2.1:compile
+ +- asm:asm:jar:3.1:compile
+ +- com.drewnoakes:metadata-extractor:jar:2.4.0-beta-1:compile
+ +- de.l3s.boilerpipe:boilerpipe:jar:1.1.0:compile
+ +- rome:rome:jar:0.9:compile
+ \- jdom:jdom:jar:1.0:compile
---
Using Tika in an Ant project
@@ -127,13 +135,13 @@ Using Tika in an Ant project
---
<classpath>
... <!-- your other classpath entries -->
- <pathelement location="path/to/tika-core-0.8.jar"/>
- <pathelement location="path/to/tika-parsers-0.8.jar"/>
+ <pathelement location="path/to/tika-core-1.0.jar"/>
+ <pathelement location="path/to/tika-parsers-1.0.jar"/>
<pathelement location="path/to/commons-logging-1.1.1.jar"/>
<pathelement location="path/to/commons-compress-1.0.jar"/>
- <pathelement location="path/to/pdfbox-0.8.0-incubating.jar"/>
- <pathelement location="path/to/fontbox-0.8.0-incubator.jar"/>
- <pathelement location="path/to/jempbox-0.8.0-incubator.jar"/>
+ <pathelement location="path/to/pdfbox-1.0.0-incubating.jar"/>
+ <pathelement location="path/to/fontbox-1.0.0-incubator.jar"/>
+ <pathelement location="path/to/jempbox-1.0.0-incubator.jar"/>
<pathelement location="path/to/poi-3.6.jar"/>
<pathelement location="path/to/poi-scratchpad-3.6.jar"/>
<pathelement location="path/to/poi-ooxml-3.6.jar"/>
@@ -159,7 +167,7 @@ Using Tika in an Ant project
Using Tika as a command line utility
- The Tika application jar (tika-app-0.8.jar) can be used as a command
+ The Tika application jar (tika-app-1.0.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.
@@ -167,7 +175,7 @@ Using Tika as a command line utility
The usage instructions are shown below.
---
-usage: java -jar tika-app-0.8.jar [option] [file]
+usage: java -jar tika-app-1.0.jar [option] [file]
Options:
-? or --help Print this usage message
@@ -202,6 +210,6 @@ Description:
---
# Check if an Internet resource contains a specific keyword
curl http://.../document.doc \
- | java -jar tika-app-0.8.jar --text \
+ | java -jar tika-app-1.0.jar --text \
| grep -q keyword
---
Modified: tika/site/src/site/apt/1.0/index.apt
URL: http://svn.apache.org/viewvc/tika/site/src/site/apt/1.0/index.apt?rev=1199134&r1=1199133&r2=1199134&view=diff
==============================================================================
--- tika/site/src/site/apt/1.0/index.apt (original)
+++ tika/site/src/site/apt/1.0/index.apt Tue Nov 8 07:29:43 2011
@@ -22,13 +22,122 @@ Apache Tika 1.0
The most notable changes in Tika 1.0 over the previous release are:
- * TBD
+ * API: All methods, classes and interfaces that were marked as
+ deprecated in Tika 0.10 have been removed to clean up the API
+ ({{{http://issues.apache.org/jira/browse/TIKA-703}TIKA-703}}).
+ You may need to adjust and recompile client code accordingly.
+ The declared OSGi package versions are now 1.0, and will thus
+ not resolve for client bundles that still refer to 0.x
+ versions ({{{http://issues.apache.org/jira/browse/TIKA-565}TIKA-565}}).
+
+
+ * Configuration: The context class loader of the current thread is
+ no longer used as the default for loading configured parser and
+ detector classes. You can still pass an explicit class loader
+ to the configuration mechanism to get the previous behaviour.
+ ({{{http://issues.apache.org/jira/browse/TIKA-565}TIKA-565}}).
+
+ * OSGi: The tika-core bundle will now automatically pick up and use
+ any available Parser and Detector services when deployed to an OSGi
+ environment. The tika-parsers bundle provides such services based on
+ for all the supported file formats for which the upstream parser library
+ is available. If you don't want to track all the parser libraries as
+ separate OSGi bundles, you can use the tika-bundle bundle that packages
+ tika-parsers together with all its upstream dependencies.
+ ({{{http://issues.apache.org/jira/browse/TIKA-565}TIKA-565}}).
+
+ * RTF: Hyperlinks in RTF documents are now extracted as an <a
+ href=...>...</a> element
+ ({{{http://issues.apache.org/jira/browse/TIKA-632}TIKA-632}}).
+ The RTF parser is also now
+ more robust when encountering too many closing \{'s vs. opening \{'s
+ ({{{http://issues.apache.org/jira/browse/TIKA-733}TIKA-733}}).
+
+ * MS Word: From Word (.doc) documents we now extract optional hyphen
+ as Unicode zero-width space (U+200B), and non-breaking hyphen as
+ Unicode non-breaking hyphen (U+2011).
+ ({{{http://issues.apache.org/jira/browse/TIKA-711}TIKA-711}}).
+
+ * Outlook: Tika can now process also attachments in Outlook messages.
+ ({{{http://issues.apache.org/jira/browse/TIKA-396}TIKA-396}}).
+
+ * MS Office: Performance of extracting embedded office docs was improved.
+ ({{{http://issues.apache.org/jira/browse/TIKA-753}TIKA-753}}).
+
+ * PDF: The PDF parser now extracts paragraphs within each page
+ ({{{http://issues.apache.org/jira/browse/TIKA-742}TIKA-742) and
+ can now optionally extract text from PDF annotations
+ ({{{http://issues.apache.org/jira/browse/TIKA-738}TIKA-738}}).
+ There's also an option to enable (the default) or disable
+ auto-space insertion
+ ({{{http://issues.apache.org/jira/browse/TIKA-724}TIKA-724}}).
+
+ * Language detection: Tika can now detect Belarusian, Catalan,
+ Esperanto, Galician, Lithuanian (TIKA-582), Romanian, Slovak,
+ Slovenian, and Ukrainian
+ ({{{http://issues.apache.org/jira/browse/TIKA-681}TIKA-681}}).
+
+ * Java: Tika no longer ships retrotranslated Java 1.4 binaries along
+ with the normal ones that work with Java 5 and higher.
+ ({{{http://issues.apache.org/jira/browse/TIKA-744}TIKA-744}}).
+
+ * OpenOffice documents: header/footer text is now extracted for text,
+ presentation and spreadsheet documents
+ ({{{http://issues.apache.org/jira/browse/TIKA-736}TIKA-736}}).
The following people have contributed to Tika 1.0 by submitting or
commenting on the issues resolved in this release:
- * TBD
+ * Andrzej Bialecki
+
+ * Antoni Mylka
+
+ * Benson Margulies
+
+ * Chris A. Mattmann
+
+ * Cristian Vat
+
+ * Dave Meikle
+
+ * David Smiley
+
+ * Dennis Adler
+
+ * Erik Hetzner
+
+ * Ingo Renner
+
+ * Jeremias Maerki
+
+ * Jeremy Anderson
+
+ * Jeroen van Vianen
+
+ * John Bartak
+
+ * Jukka Zitting
+
+ * Julien Nioche
+
+ * Ken Krugler
+
+ * Mark Butler
+
+ * Maxim Valyanskiy
+
+ * Michael Bryant
+
+ * Michael McCandless
+
+ * Nick Burch
+
+ * Pablo Queixalos
+
+ * Uwe Schindler
+
+ * Žygimantas Medelis
- See TBD for more details on these contributions.
+ See {{http://s.apache.org/Zk6}} for more details on these contributions.