boostorg / redis

An async redis client designed for performance and scalability
https://www.boost.org/doc/libs/develop/libs/redis/doc/html/index.html
Boost Software License 1.0
212 stars 38 forks source link

[docs] Navigation panel improperly rendered #194

Closed Lastique closed 2 months ago

Lastique commented 3 months ago

https://www.boost.org/doc/libs/1_84_0/libs/redis/doc/html/index.html

The navigation panel seems to be overlapping the library title, and the search bar overlaps the panel.

Screenshot_20240323_110356

Firefox 124.0.1, Kubuntu 22.04.

Lastique commented 3 months ago

The same issue is on the Reference page.

mzimbres commented 3 months ago

Hi, I am aware of this problem but still don't have a solution. It first appeared when Boost.Redis was integrated into boost and that boost header got automatically added to the docs. @anarthal has also investigated but AFAIR it was not trivial to fix.

anarthal commented 3 months ago

AFAIR it is a CSS problem on the Doxygen template you were using. It uses absolute positioning, assuming there is nothing on top of it. When the website adds the header, it breaks.

I thought I had fixed it though, but looks like it broke again. Probably the best way to handle this is preventing the website from including the header - let me investigate on whether this is possible and I'll come back to you.

Lastique commented 3 months ago

I just checked https://www.boost.org/doc/libs/master/libs/redis/doc/html/index.html and indeed it looks fixed. Was the fix made post-1.84 release? If so, you can close this and sorry for the noise. Thanks.

anarthal commented 3 months ago

Looking at the commit history, yes, I fixed it after 1.84. This explains what we're seeing.