= Export wiki pages as OpenDocument (ODT) = == Description == This plugins can convert a wiki page to an [http://en.wikipedia.org/wiki/Opendocument OpenDocument] Text file (ODT). The file can be opened with any compatible office suite, such as !OpenOffice, KOffice, IBM Symphony, etc. Currently, it's only been tested with !OpenOffice. The XSLT stylesheets come from the [http://gitorious.org/xhtml2odt XHTML2ODT] project. == Installation == This plugin was tested with Trac version 0.11. Please ensure the following python modules are installed before installing this plugin: * [http://pypi.python.org/pypi/uTidylib python-uTidyLib] * [http://pypi.python.org/pypi/lxml python-lxml] * [http://pypi.python.org/pypi/PIL python-PIL] (sometimes named python-imaging) Refer to the [trac:TracPlugins Trac plugin documentation] for details on how to build and install plugins and macros. You will probably have to enable the plugin by editing the `components` section of your `trac.ini`, for example: {{{ [components] odtexport.* = enabled }}} After installing, a new alternative format should appear on the bottom of each wiki page, next to the "Plain Text" link. == Options == In `trac.ini`, you can setup a few options : * '''get_remote_images''' (boolean, defaults to true) : wheather the plugin should download the remote images * '''replace_keyword''' (string, defaults to "TRAC-ODT-INSERT") : the string in the ODT template file to replace with the wiki page content. * '''dpi''' (integer, defaults to 96) : the screen DPI. * '''img_default_width''' (string, defaults to "8cm") : the width of an exported image when the plugin can't compute it. * '''img_default_height''' (string, defaults to "6cm") : the height of an exported image when the plugin can't compute it. Those options must be put under a `[odtexport]` section in the ini file, such as : {{{ [odtexport] get_remote_images = False replace_keyword = REPLACE_ME }}} == Bugs/Feature Requests == Existing bugs and feature requests for OdtExportPlugin are [report:9?COMPONENT=OdtExportPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=OdtExportPlugin&owner=abompard new ticket]. == Download == Download the zipped source from [download:odtexportplugin here]. == Source == You can check out OdtExportPlugin from [http://trac-hacks.org/svn/odtexportplugin here] using Subversion, or [source:odtexportplugin browse the source] with Trac. == Example == Once installed, a new entry shows up below the ''Download in other formats'' section at the end of the page. Click and save to disk, and open with a compatible office suite such as !OpenOffice. == Recent Changes == [[ChangeLog(odtexportplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:abompard Aurélien Bompard] [[BR]] '''Contributors:'''