Metadata-Version: 1.1
Name: djangotheming
Version: 0.1.0
Summary: Complete solution for theming your django site.
Home-page: https://github.com/saleem-latif/djangotheming
Author: Saleem Latif
Author-email: saleem_ee@hotmail.com
License: GPL 3.0
Description: Django Theming
        ==============
        
        .. image:: https://img.shields.io/pypi/v/djangotheming.svg
            :target: https://pypi.python.org/pypi/djangotheming/
            :alt: PyPI
        
        .. image:: https://travis-ci.org/saleem-latif/djangotheming.svg?branch=master
            :target: https://travis-ci.org/saleem-latif/djangotheming
            :alt: Travis
        
        .. image:: http://codecov.io/github/saleem-latif/djangotheming/coverage.svg?branch=master
            :target: http://codecov.io/github/saleem-latif/djangotheming?branch=master
            :alt: Codecov
        
        .. image:: https://img.shields.io/pypi/pyversions/djangotheming.svg
            :target: https://pypi.python.org/pypi/djangotheming/
            :alt: Supported Python versions
        
        .. image:: https://img.shields.io/github/license/saleem-latif/djangotheming.svg
            :target: https://github.com/saleem-latif/djangotheming/blob/master/LICENSE.txt
            :alt: License
        
        The ``Django Theming`` is a standalone theming solution for django sites. You
        can use it customize the look and feel of any of your django site.
        
        Overview
        --------
        
        Django theming provides a way for django sites owners to customize the look
        and feel of django sites without having to alter the code of the base site.
        
        
        Installation
        ------------
        
        Install using pip:
        
        .. code-block:: sh
        
            pip install djangotheming
        
        Usage
        -----
        
        Add ``'theming'`` to your ``INSTALLED_APPS``.
        
        .. code-block:: python
        
            INSTALLED_APPS = [
                ...
                'theming',
            ]
        
        Add ``'django.contrib.sites.middleware.CurrentSiteMiddleware'``,
        ``'theming.middleware.CurrentRequestMiddleware'`` and
        ``'theming.middleware.CurrentThemeMiddleware'`` to your ``MIDDLEWARE``
        
        Add ``theming.template.loaders.theme.Loader`` to your ``'TEMPLATES['OPTIONS']['loaders']'``
        
        .. code-block:: python
        
            TEMPLATES = [
                {
                    'BACKEND': 'django.template.backends.django.DjangoTemplates',
                    'DIRS': [os.path.join(BASE_DIR, 'templates')]
                    ,
                    'APP_DIRS': False,
                    'OPTIONS': {
                        'loaders': [
                            'theming.template.loaders.theme.Loader',
                            'django.template.loaders.app_directories.Loader',
                        ],
                        'context_processors': [
                            'django.template.context_processors.debug',
                            'django.template.context_processors.request',
                            'django.contrib.auth.context_processors.auth',
                            'django.contrib.messages.context_processors.messages',
                        ],
                    },
                },
            ]
        
        
        Set ``'theming.static.storage.ThemeStorage'`` as your ``'STATICFILES_STORAGE'``
        
        .. code-block:: python
        
            STATICFILES_STORAGE = "theming.static.storage.ThemeStorage"
        
        
        Add ``'theming.static.finders.ThemeFilesFinder'`` to your ``'STATICFILES_FINDERS'``
        
        .. code-block:: python
        
            STATICFILES_FINDERS = (
                'theming.static.finders.ThemeFilesFinder',
                'django.contrib.staticfiles.finders.FileSystemFinder',
                'django.contrib.staticfiles.finders.AppDirectoriesFinder',
        
            )
        
        
        Finally, Set the ``'THEMING'`` setting to something like.
        
        .. code-block:: python
        
            #  Theming settings.
        
            THEMING = {
              'ENABLED': True,
              'DEFAULT': '<theme-name>',
              'DIRS': [
        
                 os.path.join(<absolute-path-to-themes-dir>)
        
              ],
        
           }
        
        
        License
        -------
        
        The code in this repository is licensed under the GNU GENERAL PUBLIC LICENSE Version 3 unless otherwise noted.
        
        Please see ``LICENSE`` for details.
        
        How To Contribute
        -----------------
        
        Contributions are very welcome.
        
        I will add info on how to contribute soon.
        
        Reporting Security Issues
        -------------------------
        
        Please do not report security issues in public. Please email saleem_ee@hotmail.com.
        
        
        Change Log
        ==========
        
        ..
           All enhancements and patches to theming will be documented
           in this file.  It adheres to the structure of http://keepachangelog.com/ ,
           but in reStructuredText instead of Markdown (for ease of incorporation into
           Sphinx documentation and the PyPI description).
        
           This project adheres to Semantic Versioning (http://semver.org/).
        
        ..
        
        
        [0.1.0] - 2016-10-13
        --------------------
        
        * First release on PyPI.
        * Models and Django admin integration
        
Keywords: Django Theming
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: Framework :: Django :: 1.10
Classifier: Framework :: Django :: 1.11
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
