[[PageOutline(2-5,Contents,pullout)]]

= Preview doc and xls files

== Description

This is a mimeview plugin to render doc/xls/ppt attachments in preview mode in Trac.

This plugin uses headless OpenOffice/Libreoffice to generate html.

See also: BasicOfficePreviewPlugin, PandocPlugin, ExcelXlstViewerPlugin.

== Bugs/Feature Requests

Existing bugs and feature requests for DocRenderPlugin are 
[report:9?COMPONENT=DocRenderPlugin here].

If you have any issues, create a 
[/newticket?component=DocRenderPlugin new ticket].

[[TicketQuery(component=DocRenderPlugin,group=type,format=progress)]]

== Download

Download the zipped source from [export:docrenderplugin here].

== Source

You can check out DocRenderPlugin from [/svn/docrenderplugin here] using Subversion, or [source:docrenderplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Configuration

Sample [browser:/docrenderplugin/1.0/examples/openoffice.sh init-script], tested on Debian.

Put the [browser:/docrenderplugin/1.0/examples/ooextract.py helper] file into `/usr/local/bin`.

Execute the init-script, install the plugin and edit `attachment` section in your `trac.ini` file:
{{{#!ini
[attachment]
ooo_socket = socket,host=localhost,port=8100
}}}

== Recent Changes

[[ChangeLog(docrenderplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:bsavelev] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''