= Export wiki pages to PDF, ODT, and DOC format = == Description == This plugin allows you to export wiki pages to PDF, ODT and DOC format. This plugin is licensed under LGPL == Requisites == This plugin has been developed with '''python-uno''' 2.4.1, '''[http://www.crummy.com/software/BeautifulSoup/ BeautifulSoup]''' 3.0.7a and '''python-imaging-library (PIL)'''. Python-uno is not installed by default. For install it, depends of OS: * Linux: If your Linux uses apt, you can install python-uno with the next command: {{{ apt-get install python-uno python-beautifulsoup python-imaging }}} * With Debian Lenny 5.0, if you want to run '''soffice''' with `-headless` option, you must install these following packages too: {{{ apt-get install openoffice.org openoffice.org-headless openoffice.org-java-common }}} * Mac: I can't install python-uno in mac. * Windows: The next article can be interesting : http://wiki.services.openoffice.org/wiki/Using_Python_on_Windows Before use, you must start open office in service mode. To start soffice in this mode, use a command like this: {{{ soffice "-accept=socket,host=localhost,port=8100;urp;" -headless (1) soffice -accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager (2) }}} The version of the open office used in the development of the plugin was the 2.4. * '''(1)''' Openoffice 2.4 with headless without framebuffer. * '''(2)''' Standard Openoffice server with X == Bugs/Feature Requests == Existing bugs and feature requests for WikiExportPlugin are [report:9?COMPONENT=WikiExportPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=WikiExportPlugin&owner=sfhynx new ticket]. == Download == Download the zipped source from [download:wikiexportplugin here]. == Source == You can check out WikiExportPlugin from [http://trac-hacks.org/svn/wikiexportplugin here] using Subversion, or [source:wikiexportplugin browse the source] with Trac. == Example == A possible configuration of this plugin is the next: {{{ [openOffice-exporter] user = john psswrd = 1234 host = localhost port = 8100 para-styles = Text Body, Default, Heading 1, Heading 2, Heading 3, ..., Heading 10 list-styles = List 1, Numbering 1, Numbering 2, Numbering 3 char-styles = Default, Source Text, Internet Link }}} A brief description of the fields: * '''user''' and '''psswrd''': If the trac project needs authentication, for export the images you need to pass a user and a password for construct a url that urllib can open. * '''host''' and '''port''': When you start the soffice in service mode, you must specify a host and a port where the service accepts the connections. By default in this plugin, these values are localhost and 8100. * '''para-styles''', '''list-styles''' and '''char-styles''': Are the styles that you want to use of the open office to export the wiki pages. All this fields are optional, but the default configuration of this plugin if for the spanish version of the Open Office. When this plugin is active, appears three new options in the wiki pages: [[Image(wikiexport.png)]] Since r5057, this plugin accepts a basic template system. This system works as follow: 1. Create a wiki page called '''!WikiTemplateConf''' 1. Adds to that page a text similar to the next: {{{ {{{ template_list= Manual, List template_file= manual.odt, list.odt }}} }}} 1. Attach to the page the files manual.odt, list.odt (or those who have written in the template_file section) Once this is done, when you export a wiki page, if the page name starts with a name written in the template_list section, the document created use the template defined in the '''!WikiTemplateConf''' page. == Considerations == For the moment, you must keep in mind the following: {{{ styles = Default, Heading 1, Heading 2 Works fine }}} {{{ styles = Default,Heading 1,Heading 2 Doesn't work }}} == Recent Changes == [[ChangeLog(wikiexportplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:sfhynx] [[BR]] '''Contributors:''' [wiki:clp]