Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Code blocks in documentation are unreadable (white on light grey) #6820

Open
3 tasks done
themightyoarfish opened this issue Jun 7, 2024 · 2 comments
Open
3 tasks done
Labels
bug Not a build issue, this is likely a bug.

Comments

@themightyoarfish
Copy link

Checklist

Describe the issue

Consider the code block under this paragraph for instance: https://www.open3d.org/docs/latest/tutorial/Advanced/pointcloud_outlier_removal.html#Prepare-input-data

It renders like this:
image

And most of the code is unreadable.

Steps to reproduce the bug

1. Open any page with formatted code in the latest documentation.
2. observe that you cannot read the code

Error message

No response

Expected behavior

No response

Open3D, Python and System information

- Operating system: macOS 10.15
- Browser: Firefox 126.0.1, Chrome 125.0.6422.142

Additional information

No response

@themightyoarfish themightyoarfish added the bug Not a build issue, this is likely a bug. label Jun 7, 2024
@saurabheights
Copy link
Contributor

saurabheights commented Jun 7, 2024

@themightyoarfish The issue is because this is old documentation which is still located at the url

latest/tutorial/Advanced/pointcloud_outlier_removal.html#Prepare-input-data

The new path should be:-
latest/tutorial/geometry/pointcloud_outlier_removal.html

The old paths were never deleted during change in paths of the documentation. Furthermore, since Open3D moved to furo theme (modern looks), I believe the CSS of the new theme is causing old docs to be rendered incorrectly.

See https://www.open3d.org/docs/latest/tutorial/geometry/pointcloud_outlier_removal.html where code is correctly rendered.

@ssheorey Tagging for action. AFAIK, this can be easily done manually.

@mdfirman
Copy link

Thanks for raising this issue; I've had exactly the same problem, I assumed it was some browser plugin I had breaking this. It was only when I tried the docs in other browsers and in ingocnito that I realised it was a bug in the docs themselves.

Its worth knowing that the "deprecated" versions of the docs (with the rendering bug) will often come up first in search results, at least for me. So when I use google to find documentation, a lot of the documentation I see has this issue.

image image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Not a build issue, this is likely a bug.
Projects
None yet
Development

No branches or pull requests

3 participants