DokuWiki Engine

[Straider]

Is there an easy way to closely integrate the DokuWiki engine with the Trac platform?

Not that the Trac Wiki engine isn't good enough, but because the DokuWiki engine has some very adequate features, such as Syntax Highlight, Section Editing, Windows Shares, Automatic Table of Contents, and others.

Thanks.

[Matthew Good <matt-good.net>]

Since DokuWiki is written in PHP the integration would be problematic. For more powerful markup you can use WikiRestructuredText. The TracFaq is a good example of the table of contents generation. The way DokuWiki generates a small TOC at the corner of the page does seem nice though. However, individual features you'd like to see added to Trac should probably be filed under separate tickets.

[Matthew Good <matt-good.net>]

Sorry, apparently Trac reset the resolution type to fixed when I previewed it.

[Matthew Good <matt-good.net>]

Fixing resolution type.

[mrdavidcullen@…]

Is there any way then to replace the Wiki section of Trac with a seperate Dockuwiki installation while still creating links and seamless references between bugs, tasks, changesets?

[cboos]

Not that I know of, but there's a wiki syntax replacement patch somewhere which implements most of the DokuWiki syntax within Trac, see ...

Well, I just realized that this patch was in a mail exchange that happened outside of Trac-users.

I'm sure Matthieu Jonglez is OK with sharing his code, so here's his original mail:

Hi there,
 
I investigated that over a year ago when we migrated from Dokuwiki + CVS
to Trac + SVN. I first looked into doing that as a plugin but gave up on
Christian's own advice and did a patch instead. 
 
Please find attached a zip containing:
- the html output of the syntax example page (DokuwikiFormatting.htm)
- the wiki text equivalent (as you can see it's dokuwiki syntax)
(DokuwikiFormatting.txt)
- a couple of screen shots illustrating the look and feel of the edit
pages after the patch is applied
- just in case you are trying to migrate for the same reason I did,
tracdown.tgz a modified version of tracdown that supports multiple
projects/product (supports recursive folders)
 
You'll have to excuse the install process of the formatter patch: the
makefile is kinda hardcoded but will probably only need minor editing
for your install.
 
Note that the trac goodies plugin is required for the emoticon.
 
I am sure that the formatting patch must break a few of the plugins
available out there, but I've been running it for over a year now with
the following config (extract from my install script)
        (cd formatter && make)
        (cd goodies && python setup.py install)
        (cd ctxtnavaddplugin/0.10 && python setup.py install)
        (cd autowikifyplugin/trunk && python setup.py install)
        (cd newsflashmacro/0.9 && python setup.py install)
        (cd tracdown && python setup.py install)
        easy_install TracWebAdmin-0.1.1dev_r2765-py2.4.egg
        easy_install TracGantt-0.3.2a-py2.4.egg
        (cd TracTags && python setup.py install)
        (cd tracblogplugin/0.10 && python setup.py install)

A final note: I can't remember which version of DokuWiki we were using,
but we migrated over a year ago now... I haven't kept track of the
syntax changes (if any) that took place so I can't guarantee it'll manage
a 100% coverage of you wiki data.

Regards, 

/ Matthieu

And his contributions can be found in the attachment:trac.zip.

[cboos]

Replace Trac's WikiFormatting with DokuWiki syntax, for Trac 0.10.4 (contributed by Matthieu Jonglez)