I am currently writing some extensive documentation using Sphinx for a rather complex Django web site. I have been working on this in-house and before I leave soon I want to leave behind detailed documentation accessible by the new devs/admins for the site.
My question is what are my options for hosting this documentation? I would prefer it to be private. Also the docs are concerning a website not a python package. For these two reasons I am thinking that Read the Docs may not be the most appropriate option.
I ran across django-sphinxdoc , though this requires setting up Haystack as the backend. Is there not a way to simply server the docs using the built in js search? Or a service which allows private hosting of the docs?
Any options would be much appreciated.
To support Markdown-based documentation, Sphinx can use MyST-Parser. MyST-Parser is a Docutils bridge to markdown-it-py, a Python package for parsing the CommonMark Markdown flavor.
Sphinx can generate static .html
files (make html
). Put those HTML files up on an internal web server and you should be good to go.
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With