Opened 3 years ago
Last modified 3 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
Correction:
trac.ini