-
Notifications
You must be signed in to change notification settings - Fork 22
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
Conversation
8378c88
to
2c1bd8c
Compare
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. |
[pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci
"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 |
There was a problem hiding this comment.
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?
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
... And qtgallery
's README says to do what you're doing.
There was a problem hiding this 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.
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.