Metadata-Version: 1.1
Name: django-initial-avatars
Version: 0.5.1
Summary: A simple Django app to get avatars based on username and initials if no gravatars is associated to the email address.
Home-page: https://github.com/axiome-oss/django-initial-avatars
Author: Mathieu Requillart
Author-email: mrequillart@axiome.io
License: BSD License
Description: =====
        django-initial-avatars
        =====
        
        django-initial-avatars is a simple Django app which generates avatars based on username and initials. If django_gravatar is installed, user gravatar is preferred.
        
        Dependencies
        ------------
        
        Generating avatars requires a `Pillow`_ (or PIL) installation with `freetype`_ support.
        
        ``freetype`` can easily be installed on ubuntu with _::
        	
        	$ sudo aptitude install libfreetype6-dev
        
        or on OS X with `homebrew`_::
        
            $ brew install freetype
        
        After installing ``freetype`` Pillow may need to be rebuilt.
        
        Font licensing
        --------------
        
        For generating the avatar the font ``Ubuntu Monospace`` is used.
        The font is licensed under the Ubuntu Font Licence, see the
        `License <http://font.ubuntu.com/licence/>`_
        
        Quick start
        -----------
        1. install app requirements::
        
        2. install django-initial-avatars through pip::
        
            pip install django-initial-avatars
        
        3. If you want to use gravatar for users who have one, install django-gravatar2::
        
            pip install django-gravatar2
        
        4. Add "django-initial-avatars" to your INSTALLED_APPS setting like this::
        
            INSTALLED_APPS = (
                ...
                'initial_avatars',
                ['django_gravatar',]
            )
        
        5. Include the django-initial-avatar URLconf in your project urls.py like this::
        
            url(r'^avatar/', include('initial_avatars.urls')),
        
        6. Launch development server::
        
        	python manage.py runserver
        
        7. Each user has now an endpoint for his avatar::
        
        	localhost:8000/avatar/user[/size]
        
        8. In your templates, use::
        
            {% load initialavatar %}
        
            {% get_initial_avatar user [size] %}
        
        or:
        
            {% get_initial_avatar user.email [size] %}
        
Keywords: django gravatar initial avatar
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
