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

= Preview docx files using Pandoc

== Description

This is a generic preview plugin using [http://pandoc.org/ Pandoc]. Pandoc is a tool to convert files from one markup format into another and is GPL licensed.

Currently, it can render docx files in the repository browser.

== !Bugs/Feature Requests

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

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

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

== Download

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

== Source

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

== Installation

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

== Configuration

Add `application/vnd.openxmlformats-officedocument.wordprocessingml.document:docx` to `mime_map` in your `trac.ini` file:

{{{#!ini
[mimeviewer]
mime_map = text/x-dylan:dylan, text/x-idl:ice, text/x-ada:ads:adb, application/vnd.openxmlformats-officedocument.wordprocessingml.document:docx
}}}

You should also install Pandoc. See [https://pypi.python.org/pypi/pypandoc/#installing-pandoc Installing pandoc] section of pypandoc documentation.

== Recent Changes

[[ChangeLog(pandocplugin, 3)]]

== !Author/Contributors

**Author:** [wiki:tkob-trac] [[BR]]
**Maintainer:** [[Maintainer]] [[BR]]
**Contributors:**