django-fontawesome

================== django-fontawesome ================== .. image:: https://badge.fury.io/py/django-fontawesome.svg :target: http://badge.fury.io/py/django-fontawesome django-fontawesome is a Django app that provides a couple of Fontawesome/Django related utilities, namely: an IconField to associate Fontawesome icons with model instances templatetags to render Fontawesome icons also included: admin support for the IconField fr locale translation Requirements ============ PyYAML Select2 (included) JQuery (uses django's jquery in admin panel) Settings ======== By default, django-fontawesome ships with and uses the lastest fontawesome release. You can configure django-fontawesome to use another release/source/cdn by specifying:: # default uses locally shipped version at 'fontawesome/css/font-awesome.min.css' FONTAWESOMECSSURL = '//cdn.example.com/fontawesome-min.css' # absolute url FONTAWESOMECSSURL = 'myapp/css/fontawesome.min.css' # relative url You can also tell it the fontawesome prefix, which as of right now is 'fa', using:: FONTAWESOMEPREFIX = 'bg' # default is 'fa' Installation / Usage ==================== Install via pip:: pip install django-fontawesome