jothepro / doxygen-awesome-css

Custom CSS theme for doxygen html-documentation with lots of customization parameters.
https://jothepro.github.io/doxygen-awesome-css/
MIT License
1.04k stars 118 forks source link

Menu runs over content #3

Closed Warchant closed 3 years ago

Warchant commented 3 years ago

If you use doxygen-awesome-css as-is, on mid-size screen devices menu will run over content: image

Here is the fix:

@media screen and (min-width: 767px) and (max-width: 1410px) {
    #doc-content .contents, #doc-content .header .title {
        margin-left: 250px;
    }
}
jothepro commented 3 years ago

I can not reproduce that. Something seems odd about your treeview navigation. Normally the margin-left of #doc-content is set dynamically by javascript. Can you provide the Doxyfile and the Doxygen version you used for generation? Do you have Javascript enabled?

Warchant commented 3 years ago
  1. Repo: https://github.com/VeriBlock/alt-integration-cpp/ - Doxyfile is in the root directory.
  2. Deployed: https://veriblock.github.io/alt-integration-cpp/

Here is my fix: https://github.com/VeriBlock/alt-integration-cpp/blob/master/docs/look/main.css#L24-L28, you can try to comment it.

To generate and view docs:

  1. clone repo
  2. mkdir build
  3. doxygen
  4. browser build/docs/html/index.html
$ doxygen --version                                                                                                                                          
1.9.1
Warchant commented 3 years ago

Also, if I use

HTML_DYNAMIC_MENUS     = NO

Styles for top menu are from original doxygen theme: image

jothepro commented 3 years ago

Hm. When I first visited your website a few hours ago, there where Javascript errors in the console that clearly where the issue why the left margin wasn't set correctly. This seems to be resolved now. Did you change anything? It seems to me that you can now remove your fix that sets a fixed margin-left.

But now somehow the height of the treeview seems to be broken. It should be set by the treeview javascript as well:

I am not going to investigate this further as it seems to be an issue that's not related to the custom css. I'm sure that the side-nav would be broken with the default theme as well.


Thanks for the tip with the top menu when setting HTML_DYNAMIC_MENUS = NO! Furthermore, when browsing your site I found out that I should support @invarint and @pre (#4 )

I will fix these 2 things. Stay tuned! Your contribution would be welcome as well! :)

Please make sure to update to my latest release (v1.2.2) to get improvements for dark-mode, code-fragments and lots of optimizations for small screens! :)

Warchant commented 3 years ago

@jothepro thanks for your time. You do not see a footer, because I am using custom footer.html, which has single Githubissues.

  • Githubissues is a development platform for aggregating issues.