Doxygen: question: is there a any interest in improving the default style sheet for html?

Created on 4 Dec 2018  路  4Comments  路  Source: doxygen/doxygen

Current style sheet is full width of the browser. A nicer thing would be to set a max-width to 800. When copy & pasting enums in html it always copies a space at the end. There is other modern improvements that could be made. Or will the style sheet stay the same to be backwards compatible with customizations people have done already?

Most helpful comment

I would really like a rework of the current theme.

However I think a complete redesign like some of the third-party themes is problematic. Not only does it differ a lot from the current theme but it also changes the html structure of the output. As some people may query certain docs this would be backwards incompatible. Instead I would propose to update the current theme whilst keeping the html structure (at least the content, maybe small modifications to header and footer template) as these could all be suppressed by a user by just passing the old files during the build process as options.

What I would like to see is:

  • move to a flat theme
  • solid background
  • collapsible sidebar
  • responsive theme for mobile devices
  • dark mode using @media (prefers-color-scheme: dark)

If the maintainers have nothing to object to this proposal/issue and I have some free time I may try to draft a demo.

All 4 comments

Shameless self-promo: have you seen the m.css Doxygen theme? It has various usability improvements as well as mobile-friendly rendering and blazing-fast search.

I would really like a rework of the current theme.

However I think a complete redesign like some of the third-party themes is problematic. Not only does it differ a lot from the current theme but it also changes the html structure of the output. As some people may query certain docs this would be backwards incompatible. Instead I would propose to update the current theme whilst keeping the html structure (at least the content, maybe small modifications to header and footer template) as these could all be suppressed by a user by just passing the old files during the build process as options.

What I would like to see is:

  • move to a flat theme
  • solid background
  • collapsible sidebar
  • responsive theme for mobile devices
  • dark mode using @media (prefers-color-scheme: dark)

If the maintainers have nothing to object to this proposal/issue and I have some free time I may try to draft a demo.

@septatrix yes that sounds good. I don鈥檛 consider myself to be a good web designer, so I tend to not give it enough attention. So I鈥檇 appreciate any help to improve the look and feel of the output.

Things to be considered are (in my opinion) also:

  • the fact that the HTML documentation is used as base for the CHM output as well
  • the layout / colors are very individually,
    In the past it was considered e.g. in leaflets to have a lot of colors making it unreadable. Also when I personally see a site with a black background it straight a way give me a negative impression and also sites with fancy letter types or big white / transparent borders result in the same negative ideas. On a site the content should be the most important and the possibility to find things.
Was this page helpful?
0 / 5 - 0 ratings

Related issues

eseiler picture eseiler  路  3Comments

sawatts picture sawatts  路  7Comments

FFroehlich picture FFroehlich  路  6Comments

eseiler picture eseiler  路  3Comments

louis-langholtz picture louis-langholtz  路  3Comments