Metadata-Version: 1.1
Name: django-docs
Version: 0.1.2
Summary: Allows to serve Sphinx generated docs from django.
Home-page: https://github.com/littlepea/django-docs
Author: Evgeny Demchenko
Author-email: little_pea@list.ru
License: BSD
Description: django-docs
        ===========
        
        .. image:: https://travis-ci.org/littlepea/django-docs.png?branch=master
            :target: http://travis-ci.org/littlepea/django-docs
        
        Allows to serve Sphinx generated docs from django.
        
        Credits
        -------
        
        * 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 = patterns('',
                ...
                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
        ------------------------------------
        
        You can run the tests with via::
        
            python setup.py test
        
        or::
        
            python docs/tests/runtests.py
        
        Screenshot
        ----------
        
        .. image:: http://screencloud.net//img/screenshots/6521a4af4845acceaad80bd64f842a61.png
        
Platform: UNKNOWN
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Framework :: Django
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
