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.
