Duncan Gibson wrote:

> The quick guide (and I can commit the changes later this evening)
> 1. doxygen -w html header.html footer.html customdoxygen.css
> 2. copy customdoxygen.css to documentation/src
> 3. in Doxyfile, set HTML_STYLESHEET to customdoxygen.css
> 4. in customdoxygen.css, change fontsize for h2 and h3

Okay, that looks good! Although I'm not sure if the generated .css file 
might change with different doxygen versions. We would have to check 
this from time to time.

And, maybe more important, if developers and users would use different 
doxygen versions, what would happen if someone uses a newer doxygen 
version, and the generated output uses other (missing) tags/classes?

But I vote +1 anyway, we should try it.

> I think I changed them to 140% and 120% but I don't remember exactly.
> But I then realized that (in drawing.dox anyway) I have \subsection
> where maybe I could have \section and that would improve layout. I
> was going to investigate further this evening. 

Yes, please, this would be helpful.

> I can look into \c at the same time if you want.

I tested this myself. I got nice results by adding these lines at the 
end of the .css file. Please try/modify/confirm yourself.

code {
        text-decoration: none;
        font-size: 140%
}

BTW.: These docs also explain why our "tiny.gif" is not copied to the 
html directory by doxygen: this is documented behavior, we need to do 
this ourselves. I'll have a look at this one, and if this is okay, we 
can remove the reference from <something>.dox.

And, last but not least, I found out that we use "<!-- $datetime. -->" 
in our html_footer. If we remove/replace this, then we don't need to use 
"strip_tags" to replace it after generation.

However, another thing that may be "different" in the generated pages is 
the doxygen version, but this is included _after_ the html_header, and I 
didn't see how to avoid this (yet). Maybe you have an idea.

The last 2 points are only relevant for updating the web pages, so that 
different doxygen versions and creation dates don't result in mass 
updates of the www svn repository. We could also extend strip_tags to 
replace the doxygen version string too.

Albrecht
_______________________________________________
fltk-dev mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-dev

Reply via email to