Modify

Opened 2 years ago

Last modified 2 years ago

#14117 new defect

Only default_documentation project works while doing multi project documentation

Reported by: anonymous Owned by: Committo-Ergo-Sum
Priority: high Component: DoxygenPlugin
Severity: major Keywords: MultipleRepository
Cc: tvs@… Trac Release:

Description

Setting up documentation for multiple projects p1,p2 as described in https://trac-hacks.org/wiki/DoxygenPlugin ,

performed easy_install

sudo easy_install https://trac-hacks.org/svn/doxygenplugin/trunk/

Response is Finished processing dependencies for TracDoxygen==0.7.6.dev0

p1.Doxyfile

...
OUTPUT_DIRECTORY = p1
HTML_OUTPUT = doc
...

p2.Doxyfile

...
OUTPUT_DIRECTORY = p2
HTML_OUTPUT = doc
...

trac.ini

...
[doxygen]
path = /...
wiki_index = DoxyGen
html_output = doxygen
...

DoxyGen Wiki Page

= Documentation = 
 - Main page for p1 documentation: [doxygen:p1/]
 - Main page for p2 documentation: [doxygen:p2/]

commands issued

mkdir -p $DOX/source
svn co file://$SVN/p1 $DOX/source/p1
svn co file://$SVN/p2 $DOX/source/p2
cd $DOX
doxygen p1.Doxyfile
doxygen p2.Doxyfile

where $SVN is the subversion svn repos parent folder and $DOX is the doxygen projects parent folder.

Without specifying a default_documentation, only a bare mainpage comes up without any navigation elements. Adding default_documentation = p1 to the [trac] section of the trac.ini file makes the DoxyGen navigation elements like [Main Page] and [Namespaces] appear, but they only work properly for the default documentation project p1. Clicking them for project p2 navigates erroneously to the default p1 project.

I noticed the query string ?doc=p2# appears on the URL for the Doxygen index.htm file, but navigating to any link removes the query string, which explains why the default documentation appears instead of the project p2 documentation. This appears to be a bug in the DoxygenPlugin with no known workaround.

The following versions are listed at the bottom of the index page for the generated documentation:

  • Powered by Trac 1.4.3
  • Generated by TracDoxygen 0.7.6dev0 &
  • doxygen 1.7.17

Attachments (0)

Change History (1)

comment:1 Changed 2 years ago by Ted Shaneyfelt <t.s@…>

Correction:

trac.ini

...
[doxygen]
path = /...
wiki_index = DoxyGen
html_output = doc
...

Modify Ticket

Change Properties
Set your email in Preferences
Action
as new The owner will remain Committo-Ergo-Sum.

Add Comment


E-mail address and name can be saved in the Preferences.

 
Note: See TracTickets for help on using tickets.