search

flatpak / flatpak-docs

Flatpak documentation
https://docs.flatpak.org
Other
79 stars 132 forks source link

readme: Change default build instructions to be inside a venv #476

Closed bbhtt closed 3 months ago

bbhtt commented 3 months ago

Unfortunately building on Fedora and Debian using system packages is broken righ now because both of them are missing parts of sphinx-opengraph.

I've opened issues https://bugzilla.redhat.com/show_bug.cgi?id=2283086

bbhtt commented 3 months ago

It works on Debian by accident because they are on a very old version 0.7.5 and the entire socialcards.py is missing from there.

TingPing commented 3 months ago

I think its fine to just recommend using pip directly, and a venv or something.

bbhtt commented 3 months ago

Yea I will change it to a venv, relying on them is unsustainable..

bbhtt commented 3 months ago

supporting both sphinx-build and sphinx-build3 doesn't seem to be possible with venv.

sh or shell will cause it to escape the virtual environment and use sphinx-build from host.

bbhtt commented 3 months ago

Nevermind I had the sphinx-build-3 symlink

bbhtt commented 3 months ago

removed .venv from gitignore, I was thinking of having something in the makefile to setup the venv automatically but that would not be needed.