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

Readthedocs /stable documentation page is empty. #845

Closed
1Rogue opened this issue Jun 7, 2024 · 7 comments · Fixed by #850
Closed

Readthedocs /stable documentation page is empty. #845

1Rogue opened this issue Jun 7, 2024 · 7 comments · Fixed by #850

Comments

@1Rogue
Copy link

1Rogue commented Jun 7, 2024

As seen here: https://libpqxx.readthedocs.io/stable/

Screenshot of that page:
image

Notably, all the indices are empty. I believe this is the primary path that google drops users searching documentation into, thus most libpqxx documentation searches lead to 404 pages.

@1Rogue 1Rogue changed the title Readthedocs /stable documentation page is down. Readthedocs /stable documentation page is empty. Jun 7, 2024
@tt4g
Copy link
Contributor

tt4g commented Jun 7, 2024

The Read The Docs build was broken once at the time of the release of version 7.9.0.
@jtv's efforts have resolved this issue (#802).
The documents will be viewable as they should be in the next version release.
Until then, please view the documentation for the latest commit: https://libpqxx.readthedocs.io/latest/

@jtv
Copy link
Owner

jtv commented Jun 7, 2024

That's a good point. I'll just release 7.9.1 so readthedocs will pick up the fixed documentation. Also a good excuse for getting a bunch of other pending fixes out the door.

@jtv
Copy link
Owner

jtv commented Jun 8, 2024

@1Rogue, @tt4g: I have just released 7.9.1. I'm seeing working documentation on ReadTheDocs.

This has been wearing me down for 3 months!

@alexolog
Copy link

alexolog commented Jun 9, 2024

Images are broken:

image

@jtv
Copy link
Owner

jtv commented Jun 18, 2024

@alexolog I think that may be because... the documentation build is now disabled by default but I forgot to enable it in the readthedocs build.

Trying a fix for that...

@jtv
Copy link
Owner

jtv commented Jun 18, 2024

Nope, it's not even that. For some reason we've got the "dot" files but not the "png" files.

This does actually work for the local build.

@jtv
Copy link
Owner

jtv commented Jun 18, 2024

Found it. For some reason installing the graphviz pip package did not install the dot binary into the path, but installing the graphviz system package did.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

4 participants