GNOME Bugzilla – Bug 162968
Organize HTML Tree frame and quick index links
Last modified: 2012-11-18 11:11:47 UTC
I have reordered the generation of items in the tree frame to provide what I feel is better organization, and modified the quick index found at the top of each HTML page to match. New text required a few new entries to the translator files ("list", "index", "hierarchy" as single words, not part of a phrase) You can preview the results of this reorganization at our project's site: http://www.tekkotsu.org/dox/ I would've liked to clean up the tree frame a bit more, but the way the code is structured would seem to make this rather difficult. Perhaps someone more familiar with how the FTV code could do it. My suggested ideal layout is shown at: http://ejt.no-ip.org/stuff/treetest/tree.html
Created attachment 35452 [details] [review] Patch file for applying the suggested changes, relative to 1.4.0 release To apply: cd [path/to/]doxygen-1.4.0; cd ..; patch -p0 < [path/to/]tree_and_qindex_reorg.patch;
Created attachment 50329 [details] [review] Patch file for applying the suggested changes, relative to 1.4.4 release This patch is simply an updated version of the previous patch, hopefully to encourage application to the main trunk so I don't have to update my own copy anymore ;)
If you'd like a little more information on what changes this patch contains, it modifies doxygen.cpp, htmlgen.cpp, search.php, and search_php.h to reorganize the layout of the qindex header bar on each page and the order of items in the tree. I like this layout because it groups related items together: Classes, Namespaces, and Files each have their own List, Hierarchy, and Index view. Previous version seems a bit random. You can see the proposed new layout on our server: http://www.tekkotsu.org/dox/ In order to do this, I had to add three new items to the translation database, "List", "Index", and "Hierarchy". I was able to update a few of the languages (Dutch, Swedish, and of course English) but the rest are set to use the TranslatorAdapter_1_4_1 until a native speaker can do the correct translation.
I'm working on a new look for the index (it will look as a series of tabs) and I will take your suggestions into account. I'll make a row of "sub" tabs for each of the class/namespace/file related groups.
This bug was resolved to status "FIXED" as part of a group change. Please verify that this bug is indeed fixed in doxygen version 1.4.5 (or later). If not then please reopen the bug, so it stays on my radar.