Allows to serve Sphinx generated docs from django.
Project description
django4-docs allows to serve Sphinx generated docs directly from Django.
This is a fork of django-docs and was updated to work with Django 4.
Dependencies
Python 2.7-3.6 for Django 1.8 - 1.11
Python 3.4-3.6 for Django 2.0 or higher
Credits
This fork on GitHub: jonasbohmann/django4-docs/
Original Project on GitHub: littlepea/django-docs
Maintained by Evgeny Demchenko
Installation
Install django-docs package:
pip install django-docs
Add docs to INSTALLED_APPS in settings.py:
INSTALLED_APPS = ( ... 'docs', ... )
Add docs.urls to urls.py:
urlpatterns = [ ... url(r'^docs/', include('docs.urls')), ... ]
Customize configuration:
DOCS_ROOT = os.path.join(PROJECT_PATH, '../docs/_build/html') DOCS_ACCESS = 'staff'
Configuration
DOCS_ROOT (required)
Absolute path to the root directory of html docs generated by Sphinx (just like STATIC_ROOT / MEDIA_ROOT settings).
DOCS_ACCESS (optional)
Docs access level (public by default). Possible values:
public - (default) docs are visible to everyone
login_required - docs are visible only to authenticated users
staff - docs are visible only to staff users (user.is_staff == True)
superuser - docs are visible only to superusers (user.is_superuser == True)
Running the tests
Make sure to install test_requirements.txt first:
pip install -r test_requirements.txt pip install -e .
You can run the tests with via:
python setup.py test
or:
python docs/tests/runtests.py
To run all tests against different versions of Django simply run:
tox
Running the example project
Make sure to install requirements.txt first:
virtualenv env . env/bin/activate pip install -r test_requirements.txt pip install -e .
You can run the example project with via:
cd example python manage.py migrate python manage.py runserver
Screenshot
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django4_docs-0.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9df8e37dd0eb695ff9827e7aea105e9137abf66b8113a1ca962bd62800b7692a |
|
MD5 | 321041f7a8046492555b80f1a9dc4bc5 |
|
BLAKE2b-256 | aae21039949660e41a513a715b6fe10722bbf5c7a78acfca339419b64adee323 |