Skip to content

Add doc hosting on readthedocs #83

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

Merged
merged 10 commits into from
May 10, 2023
Merged

Conversation

dstansby
Copy link
Member

@dstansby dstansby commented May 3, 2023

Fixes #18. This is a minimal config to get the docs building and hosted. The gallery build is disabled becaus I can't get it to work, but I think it's worth merging this as is so we can work on fixing the gallery and improving the rest of the docs in parallel.

@dstansby dstansby force-pushed the readthedocs branch 7 times, most recently from 8378c88 to 2c1bd8c Compare May 5, 2023 09:21
@dstansby
Copy link
Member Author

dstansby commented May 5, 2023

As per #18 (comment), this isn't working and I'm going to close this PR. Bits can always be adapted for an attempt at hosting on GitHub pages.

@samcunliffe
Copy link
Collaborator

Dude!

@dstansby dstansby marked this pull request as ready for review May 10, 2023 11:42
@dstansby dstansby requested review from samcunliffe and ruaridhg May 10, 2023 11:42
"image_scrapers": (qtgallery.qtscraper,),
"reset_modules": (qtgallery.reset_qapp,),
# Don't run any gallery examples, because they're not working on
# readthedocs at the moment
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

😭 But it was so nice.

What was the problem? I assume it's not a problem of xfvb on rtd?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure, but xvfb just kept crashing. Might be due to some leaking/non-closed widgets, but the error message wasn't helpful enough to make a more educated guess.

Copy link
Collaborator

@samcunliffe samcunliffe May 10, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess we would need sudo access to a headless 18.04 VM to try it ourselves?

tools:
python: "3.10"
apt_packages:
- xvfb
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Collaborator

@samcunliffe samcunliffe left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Docs without pretty screenshots is better than no docs.

@samcunliffe samcunliffe added this pull request to the merge queue May 10, 2023
Merged via the queue into matplotlib:main with commit 7b4102b May 10, 2023
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 this pull request may close these issues.

Add hosted API documentation
2 participants