guzzle_sphinx_theme icon indicating copy to clipboard operation
guzzle_sphinx_theme copied to clipboard

Using theme with githubpages/readthedocs

Open DerWeh opened this issue 6 years ago • 2 comments

I can only get the theme to work locally. If I use make html it works properly, using automated tools like githubpages or readthedocs however, the documentation is broken.

How do I properly use it? I don't want an unnecessary dependency in my python project, thus it is not included in requirements.txt or setup.py. Instead, I just put a zip file in docs/source which works perfectly local, but not using a service. What is a proper way use this theme?

DerWeh avatar Aug 20 '18 14:08 DerWeh

for git pages, u have to make html and upload only the html folder contents to either master or docs folder. I don't think u can use this in readthedocs, it was mentioned by the creator that u might run into issues, which I had too.

mapattacker avatar Oct 26 '19 17:10 mapattacker

I use guzzle_sphinx_theme with readthedocs no problem https://railing.readthedocs.io/en/latest/

venaturum avatar Jan 14 '21 13:01 venaturum