wiki:PageToOdtPlugin

Version 11 (modified by cdevienne, 7 years ago) (diff)

--

A plugin for exporting wiki pages as OpenDocument (.odt) files.

Description

This plugin add a 'OpenDocument' link at the bottom of Wiki pages.

Configuration

Dependencies

The plugin uses the cElementTree Python module (and not the standard elementtree). If you're using python 2.4, make sure it is installed. On Debian/Ubuntu systems you can use apt-get install python-celementtree.

Enable the plugin

[components]
pagetoodt.* = enabled

Configure it

The configuration of the plugin and the template odt file are read from a wiki page, PageToOdtStyles. This page must exist for the plugin to work. Its content is a key/value pair list defining what attached file to use as a template and what predefined styles to use. Below is an example for the French version of OpenOffice:

{{{
style_standard = Corps de texte
style_heading_1 = Titre 1
style_heading_2 = Titre 2
style_heading_3 = Titre 3
style_heading_4 = Titre 4
style_heading_5 = Titre 5
style_heading_6 = Titre 6
style_heading_7 = Titre 7

style_unordered_list = Puce 1

style_ordered_list = Numérotation 1

style_inline = Texte source
style_bold = Accentuation forte
style_italic = Accentuation
style_bolditalic = Accentuation forte

template = empty.odt
}}}

If using the English version, here is a template, contributed by JasonWinnebeck:

{{{
style_standard = Text body
style_heading_1 = Heading 1
style_heading_2 = Heading 2
style_heading_3 = Heading 3
style_heading_4 = Heading 4
style_heading_5 = Heading 5
style_heading_6 = Heading 6
style_heading_7 = Heading 7

style_unordered_list = List 1

style_ordered_list = Numbering 1

style_inline = Source Text
style_bold = Strong Emphasis
style_italic = Emphasis
style_bolditalic = Strong Emphasis

template = empty.odt
}}}

You also need to attach a file empty.odt to that page. You can create this file by creating a new OOo Writer document and saving the blank document as empty.odt, and then attaching it to the page. Because the default OOo template does not have a built-in style for bold+italic, the examples above map bold+italic to just bold. You could create such a style (or any other styles) before saving the empty.odt.

Limitations

  • no support for exporting images
  • Per #2065, internal Trac links are not working

Bugs/Feature Requests

Existing bugs and feature requests for PageToOdtPlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from here.

Source

You can check out PageToOdtPlugin from here using Subversion, or browse the source with Trac.

Recent Changes

[3314] by cdevienne on 2008-03-05 22:20:19
Disable a debugging purpose feature which make win32 deployment fail. This fix #2160.
[2650] by cdevienne on 2007-09-22 10:19:54
Applied patch #1736
[2511] by cdevienne on 2007-07-23 12:43:08
PageToOdtPlugin:

Added ext hyperlink support.
Version Bump.

Author/Contributors

Author: cdevienne
Contributors: