Metadata-Version: 2.4
Name: django-sphinx-hosting
Version: 1.8.1
Summary: Reusable Django app for hosting Sphinx documentation privately.
Author-email: Caltech IMSS ADS <imss-ads-staff@caltech.edu>
Maintainer-email: Chris Malek <cmalek@caltech.edu>
Project-URL: Documentation, https://django-sphinx-hosting.readthedocs.io/en/latest/
Project-URL: Source, https://github.com/caltechads/django-sphinx-hosting
Project-URL: Issues, https://github.com/caltechads/django-sphinx-hosting/issues
Keywords: documentation,sphinx,django
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Framework :: Django :: 3.2
Classifier: Framework :: Django :: 4.0
Classifier: Framework :: Django :: 4.1
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.0
Classifier: Framework :: Django :: 5.1
Classifier: Framework :: Django :: 5.2
Classifier: Topic :: Documentation :: Sphinx
Classifier: Topic :: Software Development :: Documentation
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: django>=4.2
Requires-Dist: django-braces>=1.15.0
Requires-Dist: django-crispy-forms>=2.3
Requires-Dist: django-extensions>=3.2.3
Requires-Dist: django-filter>=24.2
Requires-Dist: django-haystack>=3.3.0
Requires-Dist: django-rest-framework-helpers>=8.5.0
Requires-Dist: django-theme-academy>=0.3.11
Requires-Dist: django-wildewidgets>=1.2.3
Requires-Dist: djangorestframework>=3.15.2
Requires-Dist: drf-spectacular>=0.27.2
Requires-Dist: crispy-bootstrap5>=2024.10
Requires-Dist: semver>=3.0.2
Requires-Dist: humanize>=4.11.0
Requires-Dist: lxml>=4.9.1
Requires-Dist: cssselect>=1.2.0
Requires-Dist: rich>=13.9.4
Dynamic: license-file

# django-sphinx-hosting

**Documentation**: [django-sphinx-hosting.readthedocs.org](https://django-sphinx-hosting.readthedocs.org)

This reusable Django application provides models, views, permissions, REST API
endpoints and management commands for making a private Sphinx documentation
hosting platform.

This is useful for when you want Sphinx documentation for your internal software
projects, but that is too sensitive to be shared with a third party.

## Features

* Users must be authenticated to view docs
* Multiple levels of privileges within the system based on Django authentication
* Manage multiple versions of your docs per project
* Automatically build and display navigation for each version of your documentaion
* Renders all documentation published within with a consistent theme
* Tag projects with classifiers to refine searching and filtering
* Search across all projects
* Use REST API to programmatically interact with the system.  Useful for
  integrating into a CI/CD system

## Installation and Configuration

See the [documentation](https://django-sphinx-hosting.readthedocs.org) for how
to install and configure `django-sphinx-hosting` in your Django project.
