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.