wiki:OdtExportPlugin

Version 4 (modified by abompard, 5 years ago) (diff)

Explain options

Export wiki pages as OpenDocument (ODT)

Description

This plugins can convert a wiki page to an 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 XHTML2ODT project.

Installation

This plugin was tested with Trac version 0.11. Please ensure the following python modules are installed before installing this plugin:

Refer to the 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 here.

If you have any issues, create a new ticket.

Download

Download the zipped source from here.

Source

You can check out OdtExportPlugin from here using Subversion, or 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

[12790] by rjollos on 2013-03-25 04:25:49
Added .gitignore.
[12787] by rjollos on 2013-03-25 01:56:46
Fixes #9877: Fixed UnicodeEncodeError when trying to export a wiki page with unicode characters in the page name.
[12786] by rjollos on 2013-03-25 01:42:36
Refs #8157: Support different styles of importing PIL.

Author/Contributors

Author: Aurélien Bompard
Contributors: