Metadata-Version: 1.1
Name: django-initial-avatars
Version: 0.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 associated email adress has no gravatar
        
        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. Add "django-initial-avatars" to your INSTALLED_APPS setting like this::
        
            INSTALLED_APPS = (
                ...
                'initial_avatars',
            )
        
        3. Include the django-initial-avatar URLconf in your project urls.py like this::
        
            url(r'^avatar/', include('initial_avatars.urls')),
        
        4. Launch development server
        
        	python manage.py runserver
        
        5. Each user has now an endpoint for his avatar:
        
        	localhost:8000/avatar/user[/size]
        
        6. In your templates, use :
        
            {% load initial_avatars %}
        
            {% get_initial_avatar user [size] %}
        or
            {% get_initial_avatar user.email [size] %}
        
        
        7. To-do:
        
        	Write Tests
        	Make django-gravatar2 optionnal
        	add settings ?
        
Keywords: django gravatar initial avatar
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
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
