Version 45 (modified by anonymous, 3 years ago) (diff)


hi chris, this page was automatically added via XmlRpc from .NET

Ticket Severity Priority Summary
#11349 normal normal easy install failure

I have a trac 1.0 site setup on Ubuntu 12.10 server - WSGI on Apache2 with git, nothing terribly exotic I think...

When I try to use the 0.11 easy install, this happens:

:~$ sudo easy_install
Doing subversion checkout from to /tmp/easy_install-GmIBBC/__downloaded__
Processing __downloaded__
Writing /tmp/easy_install-GmIBBC/__downloaded__/setup.cfg
Running -q bdist_egg --dist-dir /tmp/easy_install-GmIBBC/__downloaded__
  File "build/bdist.linux-i686/egg/setuptools/command/", line 192
5, in main

  File "build/bdist.linux-i686/egg/setuptools/command/", line 191
2, in with_ei_usage

  File "build/bdist.linux-i686/egg/setuptools/command/", line 192 9, in <lambda>

  File "/usr/lib/python2.7/distutils/", line 152, in setup
  File "/usr/lib/python2.7/distutils/", line 953, in run_commands
  File "/usr/lib/python2.7/distutils/", line 972, in run_command
  File "build/bdist.linux-i686/egg/setuptools/command/", line 374, in run

  File "build/bdist.linux-i686/egg/setuptools/command/", line 585, in easy_install

  File "build/bdist.linux-i686/egg/setuptools/command/", line 639, in install_item

  File "build/bdist.linux-i686/egg/setuptools/command/", line 825, in install_eggs

  File "build/bdist.linux-i686/egg/setuptools/command/", line 1031, in build_and_install

  File "build/bdist.linux-i686/egg/setuptools/command/", line 1016, in run_setup

  File "build/bdist.linux-i686/egg/setuptools/", line 69, in run_setup

  File "build/bdist.linux-i686/egg/setuptools/", line 120, in run
  File "build/bdist.linux-i686/egg/setuptools/", line 71, in <lambda>
  File "", line 49, in <module>
  File "/usr/lib/python2.7/distutils/", line 152, in setup
  File "/usr/lib/python2.7/distutils/", line 953, in run_commands
  File "/usr/lib/python2.7/distutils/", line 971, in run_command
  File "/usr/lib/python2.7/distutils/", line 109, in ensure_finalized
  File "build/bdist.linux-i686/egg/setuptools/command/", line 104, in finalize_options
  File "/usr/lib/python2.7/distutils/", line 312, in get_finalized_command

  File "/usr/lib/python2.7/distutils/", line 109, in ensure_finalized
  File "build/bdist.linux-i686/egg/setuptools/command/", line 86, in finalize_options
  File "build/bdist.linux-i686/egg/setuptools/command/", line 193, in tags
  File "build/bdist.linux-i686/egg/setuptools/command/", line 242, in get_svn_revision
IndexError: list index out of range

On the bright side, it seems to clean up after itself (nothing left in /tmp) and doesn't break the existing trac, so that's a good thing.

#11294 normal normal Images placed in folder IMAGE_PATH are not shown

Images within the documentation, which are located at the doxygen IMAGE_PATH are not shown.


Only the name of the image is listed. The corresponding section in the html file is:

<div class="image">
<img src="example-echarts-screenshot.png" alt="example-echarts-screenshot.png"/>
#10511 normal normal Doxygenplugin does not load


In my trac setup, it doxygenplugin (0.10) is failing to load with the below error in log.

I am running trac 1.0 under windows 7 with python 2.6.

It does not have any other plugins.

The offending line seems to be from trac.Search import ISearchSource.

Could you please help?

Regards, Vijay

 ERROR: Skipping "doxygentrac = doxygentrac.doxygentrac": 
Traceback (most recent call last):
  File "../easy_install-kdubk1\Trac-1.0-py2.6-win32.egg.tmp\trac\", line 68, in _load_eggs
  File "c:\python26\lib\site-packages\setuptools-0.6c9-py2.6.egg\", line 1913, in load
    entry = __import__(self.module_name, globals(),globals(), ['__name__'])
  File "build\bdist.win32\egg\doxygentrac\", line 2, in <module>
    #  defines this directory as the 'libsvn' package.
  File "build\bdist.win32\egg\doxygentrac\", line 20, in <module>
ImportError: No module named Search

2012-10-20 19:01:23,664 Trac[loader] DEBUG: Loading trac.about from c:\python26\lib\site-packages\trac-1.0-py2.6-win32.egg
#9961 major high Web pages inside folders not accessible


I created code docs with Doxygen with CREATE_SUBDIRS option enabled.

I saved the generated documentation to local disk (say c:\doxygen) of server(Win 2k3) where trac site is hosted.

I specified "path" as "c:\doxygen" in trac.ini

My problem is, when I select doxygen option from wikistart page, the main page shows up.
But, the further pages are not found.

Basically, trac can only access the files in start directory (c:\doxygen\html). It cannot access any files in subdirectories(e.g. c:\doxygen\html\abc)

Is this a defect or am I doing something wrong?

#9565 normal high setup.cfg file stops easy_install from executing

VisuaulSVN with it's trac plugin and python environment


c:\VisualSVNServer\trac\python\pyton.exe c:\VisualSVNServer\trac\python\Scripts\ c:\doxygenplugin

Running -q bdist_egg --dist-dir c:\users\patric~1.lit\appdata\local\temp\easy_install-irn7pf\0.11\egg-dist-tmp-xmzuzt
Traceback (most recent call last):
  File "c:\VisualSVNServer\trac\python\Scripts\", line 8, in <module>
    load_entry_point('setuptools==0.6c11', 'console_scripts', 'easy_install-2.6')()
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\command\", line 1712, in main
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\command\", line 1700, in with_ei_usage
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\command\", line 1716, in <lambda>
  File "C:\VisualSVNServer\trac\python\lib\distutils\", line 152, in setup    dist.run_commands()
  File "C:\VisualSVNServer\trac\python\lib\distutils\", line 975, in run_commands
  File "C:\VisualSVNServer\trac\python\lib\distutils\", line 995, in run_command
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\command\", line 211, in run
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\command\", line 422, in easy_install
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\command\", line 476, in install_item
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\command\", line 655, in install_eggs
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\command\", line 930, in build_and_install
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\command\", line 919, in run_setup
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\", line 62, in run_setup
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\", line 105, in run
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\", line 64, in
  File "", line 49, in <module>
    entry_points={'trac.plugins': 'doxygentrac = doxygentrac.doxygentrac'})
  File "C:\VisualSVNServer\trac\python\lib\distutils\", line 152, in setup
  File "C:\VisualSVNServer\trac\python\lib\distutils\", line 975, in run_commands
  File "C:\VisualSVNServer\trac\python\lib\distutils\", line 994, in run_command
  File "C:\VisualSVNServer\trac\python\lib\distutils\", line 117, in ensure_finalized
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\command\", line 94, in finalize_options
  File "C:\VisualSVNServer\trac\python\lib\distutils\", line 319, in get_finalized_command
  File "C:\VisualSVNServer\trac\python\lib\distutils\", line 117, in ensure_finalized
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\command\", line 85, in finalize_options
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\command\", line 185, in tags
  File "C:\VisualSVNServer\trac\python\lib\site-packages\setuptools-0.6c11-py2.6.egg\setuptools\command\", line 233, in get_svn_revision
IndexError: list index out of range

Delete setup.cfg

c:\doxygenplugin>c:\VisualSVNServer\trac\python\python.exe c:\VisualSVNServer\trac\python\Scripts\ c:\doxygenplugin
Processing doxygenplugin
Running -q bdist_egg --dist-dir c:\doxygenplugin\egg-dist-tmp-6vhutw
Adding tracdoxygen to easy-install.pth file
#9410 critical high Doesn't work with 0.12

How to Reproduce

While doing a GET operation on /doxygen/, Trac issued an internal error.

I'll fiddle around with this tomorrow and see if I can sort out a patch, but this is a pretty major bug for me.

Request parameters:

{'action': 'index', 'path': ''}

User agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:7.0.1) Gecko/20100101 Firefox/7.0.1

System Information

Trac 0.12.2
Genshi 0.6
Pygments 1.4
pysqlite 2.4.1
Python 2.5.2 (r252:60911, Jan 24 2010, 17:44:40)
[GCC 4.3.2]
pytz 2008c
setuptools 0.6c8
SQLite 3.5.9
Subversion 1.5.1 (r32289)
jQuery 1.2.6

Enabled Plugins

TracAccountManager 0.3.2

Python Traceback

Traceback (most recent call last):
  File "build/bdist.linux-x86_64/egg/trac/web/", line 511, in _dispatch_request
  File "build/bdist.linux-x86_64/egg/trac/web/", line 237, in dispatch
    resp = chosen_handler.process_request(req)
  File "build/bdist.linux-x86_64/egg/doxygentrac/", line 159, in process_request
    self.html_output, self.index)
  File "/usr/lib/python2.5/", line 60, in join
    if b.startswith('/'):
AttributeError: 'NoneType' object has no attribute 'startswith'
#7710 normal normal Pages with frames do not display correctly

I'm trying to display some documentation from a third party generated using CppDoc. Most of the documentation displays fine, but one of the files is index.htm (see below), which appears to have been written by hand. For all I know, the problem could be with the index.htm page, but what I'm seeing is that nothing is displayed when I navigate to this page. It displays fine in the browser outside of Trac.

<!-- Generated by CppDoc v2.4.1 on May 17, 2010 at 19:42-->

	<META NAME="GENERATOR" Content="CppDoc">
	<TITLE>Verasonics HAL C</TITLE>


<FRAMESET cols="20%,80%">
<FRAMESET rows="30%,70%">
<FRAME src="index-overview-frame.html" name="projectListFrame">
<FRAME src="index-allclasses-frame.html" name="projectFrame">
<FRAME src="index-overview-summary.html" name="classFrame">
<H2>Frame Alert</H2>

This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client.
Link to <a href="index-overview-summary.html">Non-frame version</a>.</NOFRAMES>
#7247 normal normal Trac 0.11.6 AttributeError: 'NoneType' object has no attribute 'startswith'


Trac:  	0.11.6
Python: 	2.4.3 (#1, Jun 11 2009, 14:09:37) [GCC 4.1.2 20080704 (Red Hat 4.1.2-44)]
setuptools: 	0.6c9
SQLite: 	3.3.6
pysqlite: 	2.5.1
Genshi: 	0.5.1
mod_python: 	3.2.8
Subversion: 	1.6.6 (r40053)
jQuery:	1.2.6
 Trac detected an internal error:

AttributeError: 'NoneType' object has no attribute 'startswith'

Python Traceback
Most recent call last:

    * File "/usr/lib/python2.4/site-packages/Trac-0.11.6-py2.4.egg/trac/web/", line 450, in _dispatch_request
      Code fragment:
       445. try:
       446. if not env and env_error:
       447. raise HTTPInternalError(env_error)
       448. try:
       449. dispatcher = RequestDispatcher(env)
       450. dispatcher.dispatch(req)
       451. except RequestDone:
       452. pass
       453. resp = req._response or []
       455. except HTTPException, e:
      Local variables:
      Name	Value
      after 	[u' except RequestDone:', u' pass', u' resp = ...
      before 	[u' try:', u' if not env and env_error:', u' raise ...
      dispatcher 	<trac.web.main.RequestDispatcher object at 0x2ae2397c3d50>
      e 	<exceptions.AttributeError instance at 0x2aaaacb15d88>
      env 	<trac.env.Environment object at 0x2ae2397b1210>
      env_error 	None
      exc_info 	(<class exceptions.AttributeError at 0x2ae23030c6b0>, ...
      filename 	'/usr/lib/python2.4/site-packages/Trac-0.11.6-py2.4.egg/trac/web/'
      frames 	[{'function': '_dispatch_request', 'lines_before': [u' try:', u' ...
      has_admin 	True
      line 	u' dispatcher.dispatch(req)'
      lineno 	449
      message 	u"AttributeError: 'NoneType' object has no attribute 'startswith'"
      req 	<Request "GET u'/doxygen/'">
      resp 	[]
      tb 	<traceback object at 0x2aaaacb15dd0>
      tb_hide 	None
      traceback 	u'Traceback (most recent call last):\n File ...
    * File "/usr/lib/python2.4/site-packages/Trac-0.11.6-py2.4.egg/trac/web/", line 206, in dispatch
      Code fragment:
       201. req.args.get('__FORM_TOKEN') != req.form_token:
       202. raise HTTPBadRequest('Missing or invalid form token. '
       203. 'Do you have cookies enabled?')
       205. # Process the request and render the template
       206. resp = chosen_handler.process_request(req)
       207. if resp:
       208. if len(resp) == 2: # Clearsilver
       209. chrome.populate_hdf(req)
       210. template, content_type = \
       211. self._post_process_request(req, *resp)
      Local variables:
      Name	Value
      chosen_handler 	<doxygentrac.doxygentrac.DoxygenPlugin object at 0x2ae2397ce050>
      chrome 	< object at 0x2ae2397c3650>
      err 	(<class exceptions.AttributeError at 0x2ae23030c6b0>, ...
      handler 	<doxygentrac.doxygentrac.DoxygenPlugin object at 0x2ae2397ce050>
      req 	<Request "GET u'/doxygen/'">
      self 	<trac.web.main.RequestDispatcher object at 0x2ae2397c3d50>
    * File "build/bdist.linux-x86_64/egg/doxygentrac/", line 159, in process_request
      Local variables:
      Name	Value
      action 	'index'
      link 	None
      path 	''
      req 	<Request "GET u'/doxygen/'">
      self 	<doxygentrac.doxygentrac.DoxygenPlugin object at 0x2ae2397ce050>
      wiki 	None
    * File "/usr/lib64/python2.4/", line 60, in join 
#7179 normal normal doxygen plugin for 0.12 trac

releas doxygen plugin for trac 0.12 as it is already in beta phase. Also can i put some post commit hook in mercurial hgrc so that with every commit, docs are automatically regenerated.

#6262 normal normal Search does not work with Doxygen >= 1.6.0

Doxygen 1.6.0 replaced the search php script with javascript which breaks a significant portion of the plugin code.

#5963 major normal doxygentrac cannot cope with subdirized doxygen documentation

My doxygen uses the CREATE_SUBDIRS feature to be able to have the amount of files in a manageable size. Additionally I use in my setup prefixes for the project where the docs reside, as such I have some svn/html prefix and a complete url to the docs looks like:

however on the tabs bar the annotated.html that is my entry point is visible via (because its configured for the default project svn/html). As such clicking there on the link to classes.html it links to which it correctly redirects to the default projects

Doing now the same for actual class documentation means I click on link to which should insert svn/html but does not do so. Looking at it seems the problem here is this line:

doc, file = segments[:-1], segments and segments[-1]

which does not take into account that there can be a subdirized documentation and treats just the one after the last / as the documentation file, and thinks the remaining d9/d3f is a project prefix like svn/html and leaves it as-is.

The easiest would probably be a config option to tell doxygentrac to use more than the last one for subdirized projects (however be aware of that it currently works as intended with the entry point files like classes.html that are not subdirized!)

#5776 normal normal where to put doxyfile

We are using for Trac for multiple projects and doxygen plugin is installed as egg.

But doxygen is not generating any documentation. Possibly because I do not have a doxyfile config file defined for the project(s).

It's not clear to me where exactly to place the doxyfile file.

#5588 normal normal Can't access paths outside of a folder

My system is windows server 2003 enterprise edition service pack. Trac version is 0.11.5. DoxygenPlugin is to check out from svn.

The setting in TracIni is:

path = D:/xampp/htdocs/project/doc
html_output = html

But I get a error message like this

Can't access paths outside of D:/xampp/htdocs/project/doc

How can I fix the problem?

Thank you very much

#5278 major normal Highliting boxes around Classes/methods/functions are not shown

When doxygen-generated documentation is accessed through trac, the displayed result is very difficult to orient - it is due to missing boxes highliting individual classes, methods and functions (see attachment 1 - doxygen_trac.png). However, when I look at the html files directly in a browser (from the same path as Doxygen plugin is configured to take the html), the result is OK (see attachment 2 - doxygen_correct.png). Did I forgot something to configure?

Doxygen plugin version is

Header and footer (HTML_HEADER, HTML_FOOTER) files were empty, when documentation was generated.

Thank you very much, Dan

#5166 normal normal pls add a screenshot or an example link

pls add a screenshot or a link to an example page.

#4740 normal normal Accessing the doxygen files in a subversion repository

As documentation should be part of a project, we commit our doxygen HTML documentation to the subversion repository too. What we do now is to checkout this files on the server in an extra directory to let the doxygen plugin have access to them. The subversion directory could be mounted as WebDAV filesystem, but this means much administration efford too. This means a couple of management and administration, so it would be desirable and highly convenient to access the files directly in the subversion repository. So instead of /var/lib/path/to/doxygen/doc something like svn:trunk/doc/html could then be configured.

Unfortunately I don't know python (I looked at the sources and understood nothing), so I ask you to realize this enhancement.

Thank you in advance!

#4175 normal normal HTML title should be set to a specific name

All the pages have the same title, which is very inconvenient when you have multiple pages open in separate tabs in a browser as you can not distinguish what tab shows which documentation. E.g. has as title simply "Doygen Trac - Opensync" but should have "OpenSync Archive"

#3580 blocker highest Port to 0.11

Port DoxygenPlugin to 0.11

#3079 major high Search error: "TypeError: can't compare datetime.datetime to int"

I received this error after upgrading to Genshi 0.5dev-r852 and trying to perform a search. While I'm not positive it's due to the doxygen plugin, logging in as a user that doesn't have permissions to the Doxygen page does not cause the error when searching.

#3003 minor normal IWikiSyntaxProvider with doxygen SEARCH_ENGINE unusable slow for large code-bases


  1. search engine is enabled in doxygen
  2. the doxygen-html-code base is large
  3. a simple WIKI-page is loaded by the user

--> the WIKI-Syntax-provider of the DoxygenPlugin stalls the whole server for up to 5 seconds with 100% CPU usage when loading any simple wiki-page.

my current workaround (with lost functionality) is:


_doxygen_lookup(self, segments):

        # Request for a named object
        # TODO:
        #  - do something about dirs
        #  - expand with enum, defs, etc.
        #  - this doesn't work well with the CREATE_SUBDIRS Doxygen option
        path, link = lookup('class%s.html' % file, 'class')
        if not path:
            path, link = lookup('struct%s.html' % file, 'struct')
        if path:
            return 'view', path, link

        # Revert to search
>>>>>>> return ('search', None, None) # bail out for performance issues <<<<<<<<<< 

       results = self._search_in_documentation(doc, [file]) << this is never called now and he rest of this function can not be used at the moment in our case

It would be nice to have a trac.ini - configuration option to disable the last branch, instead of hard-coding the return. I think optimizing the search_in_documentation function would take more time, and it is not needed that much.

Best Regards

#3000 normal normal Search fails when the Wiki _and_ Doxygen has results for a keyword

The problem is a "datetime.datetime <-> int comparision error" because:

  1. The default date-format of the ISearchSource is datetime
  1. DoxygenPlugin returns the filedate (ctime) as int.
  1. Trac compares both time-types to sort them, but fails because type datetime can not be compared with type int.

Here are the patch instructions for using the trac function to_datetime:

from trac.util.datefmt import to_timestamp, to_datetime, utc
def get_search_results(self, req, keywords, filters):
      if os.path.isdir(path):
                index = os.path.join(path, 'search.idx')
                if os.path.exists(index):
>>>>                creation = to_datetime(os.path.getctime(index))     <<<< 
                    for result in  self._search_in_documentation(doc, keywords):
                        result['url'] =  req.href.doxygen(doc) + '/' \
 if os.path.exists(index):
>>>>                creation = to_datetime(os.path.getctime(index))  <<<< 
                for result in self._search_in_documentation('', keywords):
#2995 normal normal Doxygen TracLinks do not work for classes in a namespace

We use Trac and DoxygenPlugin in libLAS project. All our classes live in namespace liblas and doxygen generates file with names like this: class liblas::guid and doxygen filename is classliblas_1_1guid.html - note the liblas part in filename.

This is causes problems with linking classes I tried to use qualified and non-qualified name but no success:


Here is one of our ticket as an example of this problem.

I've made some test with classes not defined in a namespace and here everything works well, classe names are correctly linked to corresponding doxygen pages. This assures me that the namespace part in filename of doxygen HTML page is a trouble maker here.

Thanks in advance for any comments and patches. Also, thank you for the DoxygenPlugin!

#2979 minor normal search does not work

Doxygen serach does not work on my site ( Below is log file:

2008-05-01 20:57:59,891 Trac[doxygentrac] DEBUG: Performing search(None,None)"
2008-05-01 20:58:00,398 Trac[doxygentrac] DEBUG: Performing redirect(None,stable/html/tabs.css)"
2008-05-01 20:58:00,518 Trac[doxygentrac] DEBUG: Looking up "tabs.css" in documentation "stable/html"
2008-05-01 20:58:00,528 Trac[doxygentrac] DEBUG:  source file /home/services/httpd/html/virtuals/ (not found)
2008-05-01 20:58:00,602 Trac[doxygentrac] DEBUG: Performing search(None,None)"
2008-05-01 20:58:03,063 Trac[doxygentrac] DEBUG: Performing redirect(None,stable/html/search.php)"
2008-05-01 20:58:03,183 Trac[doxygentrac] DEBUG: Looking up "search.php" in documentation "stable/html"
2008-05-01 20:58:03,257 Trac[doxygentrac] DEBUG: Performing search(None,None)"

Any hints appreciated.

#2901 blocker normal Getting UnicodeDecodeError: when trying to view the the doxyfiles
UnicodeDecodeError: 'ascii' codec can't decode byte 0xf6 in position 712: ordinal not in range(128)

How to Reproduce ¶

While doing a GET operation on /doxygen/, Trac issued an internal error.

(please provide additional details here)

Request parameters:

{'action': 'index', 'path': ''}

System Information ¶
Trac 	0.11b1
Python 	2.4.3 (#1, Mar 14 2007, 18:51:08)
[GCC 4.1.1 20070105 (Red Hat 4.1.1-52)]
setuptools 	0.6c8
SQLite 	3.3.6
pysqlite 	1.1.7
Genshi 	0.4.4
Pygments 	0.9
Subversion 	1.4.2 (r22196)

Traceback (most recent call last):
  File "/usr/lib/python2.4/site-packages/Trac-0.11b1-py2.4.egg/trac/web/", line 398, in _dispatch_request
  File "/usr/lib/python2.4/site-packages/Trac-0.11b1-py2.4.egg/trac/web/", line 195, in dispatch
    resp = chosen_handler.process_request(req)
  File "build/bdist.linux-i686/egg/doxygentrac/", line 170, in process_request
  File "build/bdist.macosx-10.3-fat/egg/genshi/", line 342, in __new__
UnicodeDecodeError: 'ascii' codec can't decode byte 0xf6 in position 712: ordinal not in range(128)
#2702 normal normal path is leaking some sensitive infos


I'm not sure what's the ?paht=/full/path/diclosure/bla.html good for.

In my opinion it's disclosing potentialy sensitive informations.

Cheers, /thorkill

--- simple fix

  • 0.10/doxygentrac/

    237237                              href=formatter.href.doxygen()) 
    238238            else: 
    239239                return html.a(label, title=params, 
    240                               href=formatter.href.doxygen(link, path=path)) 
     240                              href=formatter.href.doxygen(link)) 
    241241        yield ('doxygen', doxygen_link) 
    243243    def get_wiki_syntax(self): 
#2603 normal normal wrong configuration

I checkout revision 3249 for doxygen plugin sources from
It builds up an .egg file missing the directory "templates" and thus it was not working properly. I solved the problem changing line 49 of from package_data={'doxygentrac': ['templates/*.cs', 'htdocs/css/*.css']} to package_data={'doxygentrac': ['templates/*.html', 'htdocs/css/*.css']}

#2529 trivial lowest Plugin fails with Trac 0.11b1

DoxygenPlugin: Trac: 0.11b1 Python version: 2.5 Server: Tracd OS: Windows

I have a complete fresh installation of Trac 0.11b and tried to add the doxygen plugin. I have downloaded the source and ran the setup: python bdist_egg


running bdist_egg
running egg_info
writing TracDoxygen.egg-info\PKG-INFO
writing top-level names to TracDoxygen.egg-info\top_level.txt
writing dependency_links to TracDoxygen.egg-info\dependency_links.txt
writing entry points to TracDoxygen.egg-info\entry_points.txt
reading manifest file 'TracDoxygen.egg-info\SOURCES.txt'
writing manifest file 'TracDoxygen.egg-info\SOURCES.txt'
installing library code to build\bdist.win32\egg
running install_lib
running build_py
creating build\bdist.win32\egg
creating build\bdist.win32\egg\doxygentrac
copying build\lib\doxygentrac\ -> build\bdist.win32\egg\doxygentrac
creating build\bdist.win32\egg\doxygentrac\htdocs
creating build\bdist.win32\egg\doxygentrac\htdocs\css
copying build\lib\doxygentrac\htdocs\css\doxygen.css -> build\bdist.win32\egg\doxygentrac\htdocs\css
copying build\lib\doxygentrac\ -> build\bdist.win32\egg\doxygentrac
byte-compiling build\bdist.win32\egg\doxygentrac\ to doxygentrac.pyc
byte-compiling build\bdist.win32\egg\doxygentrac\ to __init__.pyc
creating build\bdist.win32\egg\EGG-INFO
copying TracDoxygen.egg-info\PKG-INFO -> build\bdist.win32\egg\EGG-INFO
copying TracDoxygen.egg-info\SOURCES.txt -> build\bdist.win32\egg\EGG-INFO
copying TracDoxygen.egg-info\dependency_links.txt -> build\bdist.win32\egg\EGG-INFO
copying TracDoxygen.egg-info\entry_points.txt -> build\bdist.win32\egg\EGG-INFO
copying TracDoxygen.egg-info\top_level.txt -> build\bdist.win32\egg\EGG-INFO
copying TracDoxygen.egg-info\zip-safe -> build\bdist.win32\egg\EGG-INFO
creating 'dist\TracDoxygen-' and adding 'build\bdist.win32\egg' to it
removing 'build\bdist.win32\egg' (and everything under it)

I moved the egg to the plugin directory, set the trac.ini and restarted the tracd server. However, after I select my project I get the following error in Internet Explorer:

Traceback (most recent call last):
  File "C:\Python25\Lib\site-packages\trac\web\", line 339, in send_error
  File "C:\Python25\Lib\site-packages\trac\web\", line 651, in render_template
    template = self.load_template(filename, method=method)
  File "C:\Python25\Lib\site-packages\trac\web\", line 627, in load_template
    self.templates = TemplateLoader(self.get_all_templates_dirs(),
  File "C:\Python25\Lib\site-packages\trac\web\", line 390, in get_all_templates_dirs
    dirs += provider.get_templates_dirs()
  File "build\bdist.win32\egg\doxygentrac\", line 186, in get_templates_dirs
    return [resource_filename(__name__, 'templates')]
  File "C:\Python25\lib\site-packages\", line 841, in resource_filename
    self, resource_name
  File "C:\Python25\lib\site-packages\", line 1311, in get_resource_filename
    return self._extract_resource(manager, zip_path)
  File "C:\Python25\lib\site-packages\", line 1322, in _extract_resource
    zip_stat = self.zipinfo[zip_path]
  KeyError: 'doxygentrac\\templates'

Only completely removing the egg seems "fix" this problem. I previously had trac 0.9.3 with the doxygenplugin (not sure what version, about two years old I guess) and that has always worked perfectly.

#2525 normal normal trac plugin fails with ImportError

I followed the instructions as good as I good but the doxygen plugin fails to load giving me the following error message (version 0.10.4):

> tracd  */ --port 8000
01:06:47 PM Trac[loader] DEBUG: Loading egg plugin doxygentrac from /usr/local/share/trac/plugins
01:06:47 PM Trac[loader] ERROR: Failed to load plugin doxygentrac from /usr/local/share/trac/plugins
Traceback (most recent call last):
  File "/usr/local/lib/python2.5/site-packages/trac/", line 101, in load_components
  File "build/bdist.linux-i686/egg/", line 1830, in load
    entry = __import__(self.module_name, globals(),globals(), ['__name__'])
ImportError: No module named doxygentrac.doxygentrac
01:06:47 PM Trac[loader] DEBUG: Loading egg plugin doxygentrac from /usr/local/share/trac/plugins/TracDoxygen-0.4-py2.5.egg
01:06:47 PM Trac[macros] ERROR: Failed to load wiki macro ()
Traceback (most recent call last):
  File "/usr/local/lib/python2.5/site-packages/trac/wiki/", line 448, in get_macros
    yield name
01:06:47 PM Trac[formatter] DEBUG: Executing Wiki macro TracGuideToc by provider < object at 0x8273f2c>
#2492 major normal error in the file

The fiel containts the line

package_data={'doxygentrac': ['templates/*.cs', 'htdocs/css/*.css']},

but the file doxygen.cs has been renamed in doxygen.html. So when installing the plugin, it doesn't work.

To work finely, I change the line as below :

package_data={'doxygentrac': ['templates/*.'''*'''', 'htdocs/css/*.css']}
#2446 normal high Problem with DoxygenPlugin and trac 0.11b1

I try to install the doxygen plugin with trac 0.11b1. It doesn't work, I have the following problem :

Trac detected an internal error:

AssertionError: HDF dataset not available. Check your clearsilver installation

Python Traceback Most recent call last:

  • File "c:\program files\python25\lib\site-packages\Trac-0.11b1-py2.5.egg\trac\web\", line 398, in _dispatch_request Code fragment:
    1. try:
    2. if not env and env_error:
    3. raise HTTPInternalError(env_error)
    4. try:
    5. dispatcher = RequestDispatcher(env)
    6. dispatcher.dispatch(req)
    7. except RequestDone:
    8. pass
    9. resp = req._response or []
    10. except HTTPException, e:
    Local variables: Name Value after [' except RequestDone:', ' pass', ' resp = ... before [' try:', ' if not env and env_error:', ' raise ... dispatcher <trac.web.main.RequestDispatcher object at 0x01512550> e AssertionError('HDF dataset not available. Check your clearsilver ... env <trac.env.Environment object at 0x0104B7F0> env_error None exc_info (<type 'exceptions.AssertionError'>, AssertionError('HDF dataset not ... filename 'c:
    program ... frames [{'function': '_dispatch_request', 'lines_before': [' try:', ' ... has_admin True line ' dispatcher.dispatch(req)' lineno 397 message u'AssertionError: HDF dataset not available. Check your clearsilver ... req <Request "GET u'/doxygen/'"> resp [] tb <traceback object at 0x0170D878> tb_hide None traceback 'Traceback (most recent call last):\n File "c:
    program ...
  • File "c:\program files\python25\lib\site-packages\Trac-0.11b1-py2.5.egg\trac\web\", line 204, in dispatch Code fragment:
    1. template, content_type = \
    2. self._post_process_request(req, *resp)
    3. # Give the session a chance to persist changes
    4. if req.session:
    6. req.display(template, content_type or 'text/html')
    7. else: # Genshi
    8. template, data, content_type = \
    9. self._post_process_request(req, *resp)
    10. if 'hdfdump' in req.args:
    11. req.perm.require('TRAC_ADMIN')
    Local variables: Name Value chosen_handler <doxygentrac.doxygentrac.DoxygenPlugin object at 0x015127D0> chrome < object at 0x011CEEF0> content_type 'text/html' err (<type 'exceptions.AssertionError'>, AssertionError('HDF dataset not ... handler <doxygentrac.doxygentrac.DoxygenPlugin object at 0x015127D0> req <Request "GET u'/doxygen/'"> resp ('doxygen.cs', 'text/html') self <trac.web.main.RequestDispatcher object at 0x01512550> template 'doxygen.cs'
  • File "c:\program files\python25\lib\site-packages\Trac-0.11b1-py2.5.egg\trac\web\", line 297, in display Code fragment:
    1. def display(self, template, content_type='text/html', status=200):
    2. """Render the response using the ClearSilver template given by the
    3. template parameter, which can be either the name of the template file,
    4. or an already parsed neo_cs.CS object.
    5. """
    6. assert self.hdf, 'HDF dataset not available. Check your clearsilver installation'
    7. if self.args.has_key('hdfdump'):
    8. # FIXME: the administrator should probably be able to disable HDF
    9. # dumps
    10. self.perm.require('TRAC_ADMIN')
    11. content_type = 'text/plain'
    Local variables: Name Value content_type 'text/html' self <Request "GET u'/doxygen/'"> status 200 template 'doxygen.cs'

File "c:\program files\python25\lib\site-packages\Trac-0.11b1-py2.5.egg\trac\web\", line 398, in _dispatch_request


File "c:\program files\python25\lib\site-packages\Trac-0.11b1-py2.5.egg\trac\web\", line 204, in dispatch

req.display(template, content_type or 'text/html')

File "c:\program files\python25\lib\site-packages\Trac-0.11b1-py2.5.egg\trac\web\", line 297, in display

assert self.hdf, 'HDF dataset not available. Check your clearsilver installation'

System Information:

User Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; fr; rv: Gecko/20071127 Firefox/ Trac: 0.11b1 Python: 2.5 (r25:51908, Sep 19 2006, 09:52:17) [MSC v.1310 32 bit (Intel)] setuptools: 0.6c7 SQLite: 3.3.4 pysqlite: 2.3.2 Genshi: 0.4.4 Subversion: 1.4.6 (r28521) jQuery: 1.2.1

#2207 trivial lowest dont forget to use index option!

i just installed doxygen plugin for my trac 0.10.4. with the options provided in the manual:

[doxygen] path = /var/cache/doxygen/myproject html_output = html was not working. i spent more than 1 hour to trying and looking around. then i tryed to include option index:

index = index.html

...and everything works fine. thanks for nice plugin ;)

#1882 normal normal TracLinks in doxygen-comments?

It would be very nice, if TracLinks from the doxygen-output is parsed. eg:

  * This is a simple function. ([wiki:function/simplefunction details])
  * @param string input
  * @return string output
  * .........
#1803 normal normal trac link with subdirectory access

When I access a Doxygen Trac link which points to a file in a subdirectory, a 404 Not Found error occurs. There is an automatic transformation from a slash (/) to a backslash (\) wich causes the error (see error message).

[doxygen:directory/subdirectory/file] -> error

[doxygen:directory/file] -> works

Error message:

The requested URL /trac/myproject/doxygen/directory\subdirectory/file was not found on this server.

Direct access with a correct slash (/trac/myproject/doxygen/directory/directory/file) works.

Webserver - Apache 2.0.59 + mod_python 3.3.1
Trac 0.10.4 + doxygen 0.4
Python 2.4.4
OS - Win 2003 Server

#1790 normal normal Encoding problem


Actually I use doxygen and I want integrated it to Trac.

I installed DoxygenPlugin but I view word as example 'pagina' in utf8 (p?gina).

I defined the encoding param in trac.ini in 'latin-1' 'iso-8859-15' 'iso-8859-1'

But it doesn't work.

Can you help me!! Thanks

#1564 normal normal Links on doxygen Main Page resulted in call of trac search

Problem was, that if I clicked for example 'Classes' Link, the plugin searched for a file /path/to/doxygen/classes.html instead of /path/to/doxygen/html/classes.html. The result was that it didn't find the page and rerouted to the search.

I had to apply the following patch (for the 0.10 version).

Note: I did NOT test what happens if the 'html_output' option is not set in 'trac.ini'.

--- 2007-05-23 09:42:35.750206000 +0200
+++  2007-05-23 09:43:07.942571000 +0200
@@ -263,7 +263,7 @@
                                                    file or self.index])
-                doc = ''
+                doc = self.html_output

         def lookup(file, category='undefined'):
             """Build (full path, relative link) and check if path exists."""
#1361 normal normal setting DOXYGEN_VIEW permission


I just installed the Doxygen plugin but, it was done fine until setting DOXYGEN_VIEW permission

# trac-admin /var/trac/myproject permission add dev DOXYGEN_VIEW /usr/lib/python2.4/site-packages/trac/ UserWarning: Unbuilt egg for doxygenplugin [unknown version] (/usr/lib/python2.4/site-packages/doxygenplugin.egg)

pkg_env = pkg_resources.Environment([plugins_dir] + sys.path)

Command failed: DOXYGEN_VIEW is not a valid action.

well I don't know where it could come from... Please cc me if you resolve the ticket

#1212 critical highest Security issue allowing to download files of the server running trac

By entering any path and a corresponding file after any of the html files generated by Doxygen in the following url:


it allows to download this specified file which is a big security issue.

#1085 normal normal Search does not work

Trac 10.3 (mod_python) on SLES 10 with DoxygenPlugin 0.10 r1251

Though I can employ "doxygen:"-type links and they work, when I search for something using the Trac search form, the apache process goes to 100% CPU and never ends. This only happens when the search includes doxygen, if I unset it, I get the results instantanoeusly.

#962 major normal images are not shown

the requests for the .png files (rendered by dot) lead to the search page

#951 major highest Any file in the file system can be accessed via the Doxygen plugin

Similar to ticket #722, links to the DoxygenPlugin in wiki articles suffer the same issue of missing a trailing slash. I tried searching the Python source for a solution, but to no avail (I'm no Python coder!), and it only applies to pages that the plugin is unable to serve.

Additionally, I've found that in wiki links that are interpreted properly, the full filesystem location of the file to be served is present in the URL. Please can this be changed; after all, it doesn't happen if you visit the same pages by browsing through the links.

#868 normal normal Search for class methods

Updated version of #780 with some new features.

It is now possible to directly link to methods in the doxygen documentation, for example:

[dox:"VectorInterface::operator *"]
[dox:"VectorInterface::VectorInterface(const ValueTypeT *pVals)"]
[dox:"osg::VectorInterface::squareLength(void) const"]

(go to to see it live)

all work, i.e. it is possible to link to pretty much anything, including operators and overloaded methods. The detection is not very robust, i.e. argument names must match etc., but it's useful.

The code is not the nicest (still getting the hang of python), but seems to work well enough for us.

Hope it helps


#798 major high Search not working for multiple documentation projects

I have multiple documentation projects configured. I am able to browse them using the doxygen trac links on my configured wiki_index page. However, searching doxygen always returns no results. I have SEARCHENGINE=YES in each of my doxygen projects. I have verified that a search.idx file exists in the html directory of each.

#780 normal normal Perform Doxygen-like name mangling

The current version has problems finding named objects in namespaces, as doxygen encodes '::' as '_1_1' in the filename and some other characters, too (see utils.cpp:escapeCharsInString()). The following patch fixes it. I had to do a few things differently, as you can't have spaces in a WikiLink, but doxygen maps TypeTrait<bool> to TypeTrait< bool >. Currently the mapper adds the spaces (resp. their code), to make doxygen:TypeTrait<bool> work right. This might barf in other languages or other situations, but seems to work ok for now.

It also adds a default namespace option to the .ini that is searched if the global name is not found. This simplifies support for system where everything is in a common namespace.

Hope it helps


#772 major high Wrong link path in navigation

The link in the navigation goes to "doxygen". So following this link it will take you to something like http://server/trac/doxygen. On this the relative links in the Trac navigation (for instance to classes.html) will point to a non-existent path. The problem is the following code in source:doxygenplugin/0.10/doxygentrac/, line 86-90:

    def get_navigation_items(self, req):
        if req.perm.has_permission('DOXYGEN_VIEW'):
            # Return mainnav buttons.
            yield 'mainnav', 'doxygen', html.a(self.title,

This will create a relative link to doxygen. Similar to the code in 0.9 this should read:

    def get_navigation_items(self, req):
        if req.perm.has_permission('DOXYGEN_VIEW'):
            # Return mainnav buttons.
            yield 'mainnav', 'doxygen', html.a(self.title,
                                               href=req.href.doxygen() + '/')

Note the additional + '/'. This will create a link to http://server/trac/doxygen/ and relative links will work just fine.

#771 normal normal Nicer CSS

I have created a new style file based on the one that comes with the doxygen plugin and the one that comes with doxygen itself. The old one was pretty unreadable (things like unsigned char on two lines on big screen). Tested with doxygen plugin 0.10 (on trac 0.10) and doxygen 1.4.7.

#706 normal normal scanning algorithm?

Hi, I'm having some trouble getting this plugin to work with more than one Doxygen directory - it keeps putting "html" in the wrong places.

My generated HTML files are in the following directories:

c:/tl/base/doc/html/* c:/tl/ngl/doc/html/* c:/tl/apk/doc/html/* c:/tl/apk/tools/apkedit/doc/html/*

I set my root to 'c:/', and put the tag [doxygen:tl/ngl/doc] with html_out as 'html', and all I get are error pages.

Now, say I have a class apkString in apkedit, it would be great to be able to write [doxygen:apkString] and have the plugin just find it. Maybe support for multiple defaults would covert it.

Best regards,

Wade Brainerd Technical Directory Activision Central Technology

#662 normal normal Port to 0.10

I've started to port this plugin to trac:milestone:0.10.

See also Trac:TracDev/ApiChanges/0.10.

I'll upload the patch here when it's ready.

#611 normal normal Doxygen plugin search creates WikiPages if your search is CamelCase


I just noticed a bug when searching for things in the doxygen plugin.

If my search is camelcase - e.g. I have a function called "EchoDateInput" (it's a PHP project).

If I search for it in lower case, the search results take me nicely to the results. but if I type it in it's original case, it asks me if I want to create a new Wiki Page....

All the best.

#596 normal normal Allow the SVN Code Browser to link to appropriate Doxy Docs.


I've just enabled the doxygen plugin on my trac install and kudos to both of you developers.

It's mega handy as it is but I have a suggestion for an enhancement that you can perhaps think about (I'm not a Python coder so don't really know how hard this is).

In my code project, I use the wiki to document certain parts of our code such that new employees/contractors can easily read though it and find out some of the core aspects of our code - e.g. data validation routines, class factories etc. As part of this documentation, I frequently use the source: macro to link directly to the files in question. It would be really nice if this also linked to the Doxygen docs too. - e.g. the source code browser knew about doxygen and which sub path within SVN the Doxy docs were generated from. It could then give a "See Doxygen Documentation for this file" type links directly from the source broswer.

As the Doxy generated HTML files are rather criptic, I cannot see how to do this easily without making the macro itself a little cleverer. I'm sure the information needed will be in one of the files Doxy generates (e.g. the search index file??).

Thanks for listening and for such a cool plugin. If I've not explained myself very well, I apologise - just ask and I will attempt to clarify.

#391 major high `DoxygenPlugin` object has no attribute `get_htdocs_dirs`

Latest version of DoxygenPlugin using Trac SVN trunk, generates this error in the log file, trac.log running as a plugin, TracDoxygen-0.1-py2.3.egg:

2006-05-25 11:11:12,310 Trac[main] ERROR: 'DoxygenPlugin' object has no attribute 'get_htdocs_dirs'
Traceback (most recent call last):
  File "/System/Library/Frameworks/Python.framework/Versions/2.3/lib/python2.3/site-packages/trac/web/", line 299, in dispatch_request
  File "/System/Library/Frameworks/Python.framework/Versions/2.3/lib/python2.3/site-packages/trac/web/", line 189, in dispatch
    resp = chosen_handler.process_request(req)
  File "/System/Library/Frameworks/Python.framework/Versions/2.3/lib/python2.3/site-packages/trac/web/", line 219, in process_request
    for dir in [os.path.normpath(dir[1]) for dir
AttributeError: 'DoxygenPlugin' object has no attribute 'get_htdocs_dirs'
#194 normal normal Doxygen-Plugin won't run

Under circumstances I can't define exactly, the doxygen plugin doesn't run here. Paths are correct, but it seems, that the conversion from req.args[''] to string doesn't work as expected here (Or better said, as expected, as I don't understand why it is running elsewhere at all). Nevertheless, I've attached a patch to get it running here. This patch is also adding png support to the plugin, allowing it to show the embedded images, as I had the same kind of problems with the other patches (See #119).

#171 normal normal Multiple documentation support

DoxygenPlugin should support multiple Doxygen documentation for each project in Trac. My idea is to have all documentations in separate dicrectories in folder "path" from trac.ini. Plugin should on load scan for these directories and produce handling for requests to each documentation. ie. .../doxygen/project_1/... I could write this myself but there will be a quite big changes in code so I am asking for permition to do it.

#153 normal normal Internationalized Doxygen pages encoding.

When I use DoxygenPlugin with internationalized pages generated with Doxygen, localized characters are rendered wrong. There is no way how to tell doxygen wich codepage should use, each localization has fixed encoding (Ie. Czech - iso8859-2). Is there any way how to tell Trac or DoxygenPlugin that custom page is in different encoding? I notice that there is no <META http-equiv = "content-type" content = "text/html;charset = ISO-8859-2"> in generated pages.

#119 major high class diagram are not displayed

class diagram are not displayed, the <img> source attribute may not be valid in the include context...

Attachments (1)

Download all attachments as: .zip