Re: [Doxygen-develop] Style bug: In need of a nest list class in CSS

[Dimitri v. H. <di...@st...>]

Hi Jeff,

On Wed, Nov 17, 2004 at 02:45:41PM +1100, Jeff Franks wrote:
> I have come across a style bug with unumbered lists. It's only a bug if 
> you try to set a custom style on <ul>. I use doxygen  to document a  
> large C++ project - it's great, thank you! I want to give the unnumbered 
> lists that are used to list the class members at the top of the 
> generated HTML pages a custom background color, so they stand out more 
> as a group. I added an entry for <ul> to my custom CSS file. I use a 
> light page background color (darker than white) and have the list 
> background color a few shades lighter. On its own it doesn't look good 
> but when you give the list a much darker one pixel border I looks great. 
> The subtle difference in shades becomes more obvious and the lists 
> appears to stand out from the page.

Can you give an example CSS so I can try it?

> Unfortunately this is where the style bug occurs. The custom style also 
> gets applied to the nested <ul> that are used to display the class 
> hierarchy entries in the 'hierarchy.html' file. Not only does the top 
> level <ul> have a border but all the nested <ul> do as well - and it 
> looks ugly. So I have to manually edit the file to remove the borders, 
> and its a long file - about 420 classes across two libraries. Everywhere 
> else top level lists look OK.
> 
> Would it be possible to implement a nested <ul> class in the CSS that 
> could be used to reverse any style changes applied to a top level <ul>. 
> Then all nested <ul> could be generated with this nested <ul> class 
> instead of a standard <ul>. I don't know if you ever intended such a 
> style to be applied to lists but it looks good, and I'm sure it would 
> add new design possibilites to Doxygen documentation.

I think that what you want is to have the top level <ul> looking something
like <ul class="top"> so you can style it via CSS in a different way as
the nested <ul>'s? For lists defined inside comment blocks this is already
possible. For the hierarchy.html it is not. 

If you want to help to fix this, please look for startItemList() in 
startIndexHierarchy() of index.cpp. It should be passed the level 
parameter. In htmlgen.h you can then change the implementation to 
include the proper class in case the level is 0.

Regards,
  Dimitri