Metadata-Version: 2.1
Name: django4-docs
Version: 0.4.0
Summary: Allows to serve Sphinx generated docs from django.
Home-page: https://github.com/jonasbohmann/django4-docs
Author: Evgeny Demchenko
Author-email: little_pea@list.ru
License: BSD
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 2
Classifier: Framework :: Django
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
License-File: LICENSE
License-File: AUTHORS

django4-docs
============

`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/ <https://github.com/jonasbohmann/django4-docs/>`_
* Original Project on GitHub: `littlepea/django-docs <https://github.com/littlepea/django-docs/>`_
* `Documentation on Read The Docs <https://django-docs.readthedocs.org/>`_
* Maintained by `Evgeny Demchenko <https://github.com/littlepea>`_

Installation
------------

1. Install `django-docs` package::

    pip install django-docs

2. Add `docs` to INSTALLED_APPS in settings.py::

    INSTALLED_APPS = (
        ...
        'docs',
        ...
    )

3. Add `docs.urls` to urls.py::

    urlpatterns = [
        ...
        url(r'^docs/', include('docs.urls')),
        ...
    ]

4. 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
----------

.. image:: https://www.evernote.com/l/AHRVMNRZKLVPaoCgJouF_-Pz7rfeDzGF32sB/image.png
