Metadata-Version: 1.1
Name: django-thema
Version: 1.2.8
Summary: Application that provides EDItEUR Thema categories, and translations for the headers.
Home-page: https://saxo.githost.io/publish/django-thema
Author: Saxo Publish
Author-email: publish@saxo.com
License: BSD License 2.0
Description-Content-Type: UNKNOWN
Description: django-thema
        ============
        
        A `Django`_ application that provides `EDItEUR Thema categories`_. It supplies translation to all languages EDItEUR supports, so if you are using Django's internationalization in your project, you will also get translation.
        
        .. _Django: https://www.djangoproject.com/
        .. _EDItEUR Thema Categories: http://www.editeur.org/151/Thema/
        
        Requirements
        ------------
        
        This application requires:
        
        - django
        - mock
        - polib
        - xlrd
        
        Installation
        ------------
        
        Install the application from Pypi:
        
        `$ pip install django-thema`
        
        Add the application to your Django project:
        
        ::
        
            INSTALLED_APPS = [
                ...
                'thema',
                ...
            ]
        
        
        Migrate the application
        
        ::
        
            $ ./manage.py migrate thema
        
        You should populate the model with the data in EDItEUR database, for this use the command `populate_thema_categories`
        
        ::
        
            $ ./manage.py populate_thema_categories
        
        
        Also, please make sure the tests passed smoothly
        
        ::
        
            $ ./manage.py test thema
        
        
        If any test fails, then you could end up with missing data in your database or malfunction of the application.
        
        
        How it works
        ------------
        
        django-thema offers a model ThemaCategory, each instance is a Thema category.
        
        .. code:: python
        
            ...
            >>> from thema.models import ThemaCategory
            >>> thema_aba = ThemaCategory.objects.get(code='ABA')
            >>> thema_aba.header
            'Theory of art'
            ...
        
        Getting translation:
        
        .. code:: python
        
            ...
            >>> from django.utils.translation import activate
            >>> activate('es')
            >>> thema_aba.local_header
            'Teoría del arte'
            >>> activate('da')
            >>> thema_aba.local_header
            'Kunstteori'
            ...
        
        Note: the translation will work only if you have enabled `Django's internationalization`_ in your project.
        
        .. _Django's internationalization: https://docs.djangoproject.com/en/1.10/topics/i18n/
        
        Getting the parent category:
        
        .. code:: python
        
            ...
            >>> thema_aba.parent
            <ThemaCategory: AB>
            ...
        
        Supported languages
        -------------------
        
        The application supports the languages covered by EDItEUR:
        
        - Arabic
        - Danish
        - English
        - Spanish
        - French
        - German
        - Hungarian
        - Italian
        - Japanese
        - Lithuanian
        - Norwegian
        - Polish
        - Portuguese
        - Swedish
        - Turkish
        
        We don't do any translation, we just use the data provided by EDItEUR, so if you find a missing translation or a translation error, please `contact EDItEUR directly`_.
        
        .. _contact EDItEUR directly: http://www.editeur.org/42/Contact/
        
        Authors
        -------
        
        - Dannier Trinchet Almaguer
        - Mikkel Munch Mortensen
        - Vladir Antonio Parrado
        - Søren Howe Gersager
        - Tobias Ley
        
        Maintenance
        -----------
        To submit bugs, feature requests, submit patches, please use `the official repository`_.
        
        .. _the official repository: https://saxo.githost.io/publish/django-thema/
        
        Copyright and licensing information
        -----------------------------------
        BSD License 2.0, 3-clause license.
        
Keywords: django,thema,EDItEUR
Platform: UNKNOWN
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
