Metadata-Version: 1.1
Name: django-initial-avatars
Version: 0.5.2
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` 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_id/[size/]
        
        8. In your templates, use::
        
            {% load initialavatar %}
        
            {% get_initial_avatar user [size] %}
        
            {% get_initial_avatar user.email [size] %}
        
        9. Tests
        
            Django-initial-avatars is provided with tests, they require django-gravatar2
        
            You can launch them in the virtualenv like this::
        
                python runtests.py
        
            It might happen that a calculated position fails because of a minor difference in the result, don't care about it.
        
        10. Contributing
        
            Contributions are welcome ! Feel free to write an issue for any feedback you have or send a pull request on Github <https://github.com/axiome-oss/django-initial-avatars>
        
        
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
