Version 26 (modified by Radek Bartoň, 12 years ago) (diff)


Doxygen Plugin for Trac


Integrates doxygen documentation into Trac.

Bugs/Feature Requests

Existing bugs and feature requests for DoxygenPlugin are here.

If you have any issues, create a new ticket.


Download the zipped source from [download:doxygenplugin here].


You can check out the source for DoxygenPlugin from Subversion at



Download the source code for the DoxygenPlugin from [download:doxygenplugin here] or checkout the source from the trac hacks subversion repository at:

Change to the doxygenplugin/0.9 directory and run:

python bdist_egg

This will generate a python egg in the dist directory. Copy the egg file into the trac/plugins directory and follow the Configuration steps outlined below.

Configuring Trac

Set path where you have your doxygen documentations and specify what documentation or wiki page should be displayed as a index. Setting wiki_index variable has higher priority. You can create your own content using [doxygen:<page_name>] macro on specified wiki page and so provide easy multiple documentation support.

path = <path_to_the_doxygen_documentation>
index = <name_of_mainpage_file>
wiki_index = <name_of_wiki_page>

Doxygen generated documentation cointains html, png and sometime other files. To tell plugin which file extentions can be handled put to ![doxygen] section in trac.ini this:

ext = htm html png # Default values

If you want to change main navigation menu button label put this to ![doxygen] section in trac.ini:

title = Documentation

If you install the plugin globally, you'll also need to enable it in trac.ini as follows:

doxygentrac.* = enabled

Configuring Doxygen

The only configuration tags that are required in to make this plugin work are 'GENERATE_HTML' and 'GENERATE_TREEVIEW'. Since this plugin just embeds the html pages generated by doxygen you will need to define a custom header and footer even if it will be containing only blank line.

HTML_HEADER            = TracHeader.html
HTML_FOOTER            = TracFooter.html

These files must contain something, a blank line is sufficient, or doxygen will put in the defaults. You can put there you own CSS style as in following example:

<style type="text/css">
        h1 { text-align: center; }

and my TracFooter.html contains a blank line.

To enable the search option the SEARCHENGINE tag must be set to 'YES'.

Wiki Macros

Using provided wiki macro you can make a link to doxygen documentation page wherever you want. Specified links are related to setted up doxygen path:

[doxygen:main.html Documentation] # Simple documentation in doxygen path.
[doxygen:FirstProject/main.html First]   # Multiple documentation in separate
[doxygen:SecondProject/main.html Second] # directories in doxygen path.


Are you using this plugin?
  • Yes, it's usefull. (sgrayban, cboos, okaori, wadeb, s0undt3ch, ttressieres, imme, dh1jc, talameelombu, Tharban, athomas, jtuchscherer, xvirus, osimons, Sincklation, manni, izzy, ericalens, KevinGabbert, mwehr, renzo, marcvs, eskil, rjollos, koolhand, edo, colski, dfleming, lucasrangit, miezuit, lhr870630, hasienda, arnisandy, lucid, AdrianFritz, akliewer99, AmigaAbattoir, laijinman, ntmlod)
  • No, it's useless. (falkb)
  • No, I don't need it. (dfaerch, harmy, prz)

  • You don't have permission to vote. You may need to login.

Change Log

16397 by rjollos on 2017-03-25 09:37:00
Remove obsolete "0.9" code
16367 by rjollos on 2017-03-22 21:24:48
0.7.5: Conform to PEP8
15902 by rjollos on 2016-09-28 11:19:17
0.7.4: Fix duplicate id attribute values

Patch by ntmlod.

Fixes #12872.

15667 by Committo-Ergo-Sum on 2016-07-20 12:44:08
Better log messages.
15662 by Committo-Ergo-Sum on 2016-07-16 19:36:37
DoxygenPlugin: an old missing import like this one.


Author: jparks
Contributors: Blackhex

Attachments (1)

Download all attachments as: .zip