====== odf-converter-integrator ======

odf-converter-integrator is an easy way to open Microsoft Office 2007 files (also called Office Open XML, .docx, .xlsx, and .pptx) with a high-quality conversion on //any// Linux or Windows system in //any// OpenOffice.org.

odf-converter-integrator uses the high-quality [[http://odf-converter.sourceforge.net/|odf-converter]] code (which converts between Office Open XML and OpenDocument) as packaged by Novell and integrates it into the operating system.  That means when you click on a .docx/.xlsx/.pptx file on a web page, in an email attachment, or your desktop, odf-converter-integrator springs into action, converts the .docx/.xlsx/.pptx to an .odt/.ods/.odp, and then automatically opens the new document in OpenOffice.org, StarOffice, Abiword, KWord, Gnumeric, Microsoft Office 2003, or whatever is your default ODF editor.

odf-converter-integrator is simply a little glue to overcomes the integration limitation of the Novell odf-converter, which cannot integrate into most editions of OpenOffice.org (such as the vanilla/Sun Microsystems edition, Fedora, OxygenOffice, and others).

===== Poll =====

Which operating system and OOo [[/editions_of_openoffice.org|edition]] do you use? Take the [[http://katana.oooninja.com/poll/odf-converter-integrator.php|poll]].

===== Download =====

[[odf-converter-integrator/download|Download odf-converter-integrator]] or view the [[odf-converter-integrator/changelog|change log]].  

//coming soon// RSS feed for notification of software updates

===== Testing =====

For instructions on how to test and the results of those tests, see [[odf-converter-integrator/test]].

===== Install =====

Instructions on how to install odf-converter-integrator.  Separately you may wish to install the [[http://www.oooninja.com/2008/01/calibri-linux-vista-fonts-download.html|Office 2007 fonts]].

==== Fedora/Red Hat/CentOS ====

The same RPM should work any Fedora version regardless of whether you use Fedora OpenOffice.org or vanilla OpenOffice.org.
<code bash>rpm -Uvh odf-converter-integrator-0.1.3-1.i386.rpm</code>







==== Ubuntu ====

If you use the [[/editions_of_openoffice.org|edition of OpenOffice.org]] that came with Ubuntu (most common), install odf-converter-integrator chocolate edition.  If you downloaded and installed the [[/editions_of_openoffice.org|vanilla]] OpenOffice.org from the OpenOffice.org web site (less common), then install the strawberry edition.

The Ubuntu 7.10 OpenOffice.org 2.3 already includes a .docx/.xlsx/.pptx importer, so why would you use odf-converter-integrator?  The code that comes with Ubuntu OpenOffice.org is an alpha version intended for OpenOffice.org, so the quality is poor and it doesn't handle simple formatting elements such as bullet points.  

=== Chocolate edition ===

As a dependency, install libgif4 //or// libungif4g, but don't install both.

<code bash>
sudo apt-get install libgif4
</code>
//or//
<code bash>
sudo apt-get install libungif4g
</code>

Then, install odf-converter-integrator:
<code>
dpkg -i odf-converter-integrator-chocolate*deb
</code>

=== Strawberry edition ===

If the latest strawberry .deb is not available, make one from the latest .rpm using alien.
<code>
sudo alien --scripts odf-converter-integrator-0.1.5-1.i386.rpm
</code>

After that:

<code>sudo apt-get install libgif4
sudo ln -s /usr/lib/libtiff.so.4 /usr/libtiff.so.3
dpkg -i odf-converter-integrator*deb</code>



==== Mandriva ====

Mandriva Linux One 2008 complains about libgif.so.4 not being installed, but it probably is (as part of the libungif4 package).  Ignore the error and just install the latest odf-converter-integrator RPM.

==== Novell/SUSE ====

If you use the [[/editions_of_openoffice.org|Novell/SUSE edition of OpenOffice.org]], you don't need odf-converter-integrator.  Just install [[http://www.oooninja.com/2008/01/openxml-translator-odf-converter-11.html|Novell's odf-converter]].

==== Microsoft Windows ====

Just download and run the installation program.  If you use OpenOffice.org, StarOffice, Abiword, or Gnumeric, that's it.   

=== Microsoft Office ===

If you use Microsoft Word/Excel/Powerpoint 2003, install [[http://odf-converter.sourceforge.net/|OpenXML/ODF Translator Add-in for Office]].

===== How to use =====

Using odf-converter-integrator depends which edition you use.

==== odf-converter-integrator: strawberry edition ====

The strawberry edition of odf-integrator-converter works with [[/editions_of_openoffice.org|all editions of OpenOffice.org]], Abiword, KWord, Gnumeric, etc.
However, the strawyberry edition does not open documents from within OpenOffice.org, so to open a .docx/.xlsx/.pptx document, double click on it from your file browser (such as the place on your desktop), or from a web page, or from an email.  

FIXME a screenshot would be nice to illustrate this point

==== odf-converter-integrator: chocolate edition for Ubuntu ====

If you use the [[/editions_of_openoffice.org|Ubuntu edition of OpenOffice.org]], install the chocolate edition of odf-converter-integrator.



===== To-do list =====

   * Add pretty icons
   * See the "fixme" items in the Python script
   * Investigate unnecessary libgif.so.4 dependency complaint on Mandriva Linux One 2008
   * Add progress indicator

===== Help =====

Do you need help?  Post your questions in [[odf-converter-integrator/help]].  If you cannot use the wiki, email [[aziem@openoffice.org|Andrew]].

===== Bugs =====

Yes, there are bugs.  :)  If you find any bugs in the integrator (such as installation issues), list them in [[odf-converter-integrator/bugs]].  If you find any bugs in the converter (such as formatting problems), report them to [[https://sourceforge.net/tracker/?group_id=169337|odf-converter tracker]]