We’re looking at using Django to serve Sphinx content as static files - the idea at present is to swallow each page, minus the site’s navigation menu, and to have Django render a template with that as the content.
The problem we’re trying to solve is granular access control, so that authorised users get to see a subset of pages.
I have a strong memory of a conference talk about two years ago, in which someone discussed using Sphinx behind Django. I can’t remember the details but I want to find the discussion. (Perhaps it was an article, not a talk, and I am misremembering.)
Permissions isn’t something I’ve explicitly added but It’s Just Django so you’d implement a role check, in a DocumentationView subclass before serving.
There’s an open issue for per-page templates:
The idea there is to use Sphinx page metadata to decide which template to use. The same idea could be leveraged to keep role information in the page too.
Whilst the project hasn’t been updated for a while, that’s merely because it Serves My Needs™ and I’ve not needed to do anything else. If you do decide to look at it, know that I consider it active and am very happy to both sweep the floor/lay out the chairs, as needed, and look at whatever ideas might arise.