c2.transform.msoffice 1.0b6

Introduction
============

Description
-------------

- This product enables to search MS-Office files on Plone.
- Include Apache POI 3.17 package by jar file.

- http://poi.apache.org/

- Code repository

- https://bitbucket.org/cmscom/c2.transform.msoffice

- Java code

- https://bitbucket.org/cmscom/msdoc2txt


Support files
----------------
- MS-Office files

- MS-Word 95-2000, XP, 2007 and xml-format
- MS-Excel 95-2000, XP, 2007 and xml-format
- MS-PowerPoint 95-2000, XP, 2007 and xml-format

Requirement
-------------

- Plone

- Plone 3.0-3.3 and Plone 4.x and 5.0 / 5.1 (tested by 5.1 CentOS 7 64bit)

- Java

- Java 8

- OS

- Linux(like Unix)
- no support for Windows

Credits
---------

This code was inspired by Products.OpenXml


Contributors
---------------
- Manabu Terada(Twitter: @Terapyon) (Main code)
- Mikio Hokari (Java code & Extend call)
- Takashi Nagai (Support Windows)
- Takayuki Nagai (Bug fix for 1.0b4 tnagai@cc.kumamoto-u.ac.jp)
- Tetsuya Morimoto (Refactoring Java code and Support POI 3.17)
Changelog
=========


1.0b6 (2018-04-02)
-----------------------

* change from POI 3.6 to POI 3.17 with Java 8 [Tetsuya Morimoto]


1.0b5 (2018-02-28)
-----------------------

* modify setup.py for target Plone [terapyon]
* tested Plone 5.1

1.0b4 (2013-03-16)
-----------------------

* modify kill process for Popen [Takayuki Nagai]

1.0b3 (2010-10-06)
---------------------

* adding terminated suspicious zombie process [terapyon]

1.0b2 (2010-02-19)
---------------------

* remove the copyright in the files [terapyon]

1.0b1 (2010-02-01)
---------------------

* modify getting from metadata and note in the msoffice file [terapyon]
* no support for Windows [terapyon]


0.3.2 (2010-01-19)
---------------------

* setting some mimetypes [terapyon]

0.3.1 (2009-12-22)
---------------------

* bug fix for Windows [terapyon]

0.3 (2009-12-22)
---------------------

* support Windows OS

0.2 (2009-12-21)
---------------------

* support Plone 4.x [terapyon]

0.1.2 (2009-12-17)
---------------------

* modify typo

0.1.1 (2009-12-16)
---------------------

* modify exception code
* adding java args for big size file


0.1 (2009-12-16)
-----------------

* Initial release

c2.transform.msoffice Installation
=====================================

* When you're reading this you have probably already run
``easy_install c2.transform.msoffice``. Find out how to install setuptools
(and EasyInstall) here:
http://peak.telecommunity.com/DevCenter/EasyInstall

* Get `pythonproducts`_ and install it via::

python setup.py install --home /path/to/instance

into your Zope instance.

* Create a file called ``c2.transform.msoffice-configure.zcml`` in the
``/path/to/instance/etc/package-includes`` directory. The file
should only contain this::

<include package="c2.transform.msoffice" />

.. _pythonproducts: http://plone.org/products/pythonproducts

Alternatively, if you are using zc.buildout and the plone.recipe.zope2instance
recipe to manage your project, you can do this:

* Add ``c2.transform.msoffice`` to the list of eggs to install, e.g.::

[buildout]
...
eggs =
...
c2.transform.msoffice

* Tell the plone.recipe.zope2instance recipe to install a ZCML slug::

[instance]
recipe = plone.recipe.zope2instance
...
zcml =
c2.transform.msoffice

* Re-run buildout, e.g. with::

$ ./bin/buildout

You can skip the ZCML slug if you are going to explicitly include the package
from another package's configure.zcml file.