a django app that provides a couple of fontawesome/django related utilities.
Project description
==================
django-fa disclaimer
==================
This package is basically a `django-fontawesome <https://github.com/atiberghien/django-fontawesome>`_ fork with support of latest django, uploaded to PyPi.
Reason of creating this repo was sadly ignored `merge request <https://github.com/redouane/django-fontawesome/pull/32>`_.
All the credits goes to authors of source repository and merge request.
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'
FONTAWESOME_CSS_URL = '//cdn.example.com/fontawesome-min.css' # absolute url
FONTAWESOME_CSS_URL = 'myapp/css/fontawesome.min.css' # relative url
You can also tell it the fontawesome prefix, which as of right now is 'fa', using::
FONTAWESOME_PREFIX = 'bg' # default is 'fa'
Installation / Usage
====================
0. Install via pip::
pip install django-fa
1. Add 'fontawesome' to your installed apps setting like this::
INSTALLED_APPS = (
...
'fontawesome',
)
2. Import and use the ``IconField``::
from fontawesome.fields import IconField
class Category(models.Model):
...
icon = IconField()
Here's what the widget looks like in the admin panel:
|admin-widget|
3. You can then render the icon in your template like this::
{% for category in categories.all %}
{% if category.icon %}
{{ category.icon.as_html }}
{% endif %}
{% endfor %}
4. django-fontawesome ships with two template tags, ``fontawesome_stylesheet`` and ``fontawesome_icon``.
- the former inserts a stylesheet link with a pre-configured href according to the ``FONTAWESOME_CSS_URL`` setting
- the latter renders icons, and accepts the following optional keywords arguments: large, spin, fixed, li, border: (true/false), rotate: (90/180/270), title: (string)
- you can also colorize an icon using the ``color='red'`` keyword argument to the ``fontawesome_icon`` template tag
- example usage::
{% load fontawesome %}
<head>
{% fontawesome_stylesheet %}
...
</head>
{% fontawesome_icon 'user' color='red' %}
{% fontawesome_icon 'star' large=True spin=True %}
<ul class="fa-ul">
<li> {% fontawesome_icon 'home' rotate=90 li=True %} One</li>
</ul>
.. |admin-widget| image:: docs/images/admin-widget.png
django-fa disclaimer
==================
This package is basically a `django-fontawesome <https://github.com/atiberghien/django-fontawesome>`_ fork with support of latest django, uploaded to PyPi.
Reason of creating this repo was sadly ignored `merge request <https://github.com/redouane/django-fontawesome/pull/32>`_.
All the credits goes to authors of source repository and merge request.
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'
FONTAWESOME_CSS_URL = '//cdn.example.com/fontawesome-min.css' # absolute url
FONTAWESOME_CSS_URL = 'myapp/css/fontawesome.min.css' # relative url
You can also tell it the fontawesome prefix, which as of right now is 'fa', using::
FONTAWESOME_PREFIX = 'bg' # default is 'fa'
Installation / Usage
====================
0. Install via pip::
pip install django-fa
1. Add 'fontawesome' to your installed apps setting like this::
INSTALLED_APPS = (
...
'fontawesome',
)
2. Import and use the ``IconField``::
from fontawesome.fields import IconField
class Category(models.Model):
...
icon = IconField()
Here's what the widget looks like in the admin panel:
|admin-widget|
3. You can then render the icon in your template like this::
{% for category in categories.all %}
{% if category.icon %}
{{ category.icon.as_html }}
{% endif %}
{% endfor %}
4. django-fontawesome ships with two template tags, ``fontawesome_stylesheet`` and ``fontawesome_icon``.
- the former inserts a stylesheet link with a pre-configured href according to the ``FONTAWESOME_CSS_URL`` setting
- the latter renders icons, and accepts the following optional keywords arguments: large, spin, fixed, li, border: (true/false), rotate: (90/180/270), title: (string)
- you can also colorize an icon using the ``color='red'`` keyword argument to the ``fontawesome_icon`` template tag
- example usage::
{% load fontawesome %}
<head>
{% fontawesome_stylesheet %}
...
</head>
{% fontawesome_icon 'user' color='red' %}
{% fontawesome_icon 'star' large=True spin=True %}
<ul class="fa-ul">
<li> {% fontawesome_icon 'home' rotate=90 li=True %} One</li>
</ul>
.. |admin-widget| image:: docs/images/admin-widget.png
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
django-f-awesome-0.3.2.tar.gz
(675.0 kB
view details)
File details
Details for the file django-f-awesome-0.3.2.tar.gz.
File metadata
- Download URL: django-f-awesome-0.3.2.tar.gz
- Upload date:
- Size: 675.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ed9e9a02bded0222367f735e1c1dd7d8b9192a2b0a8a3588abb91bbfd9aa16ec
|
|
| MD5 |
8ba13eeaacff513e328a82cf103df2a3
|
|
| BLAKE2b-256 |
32513bc3468e81d689c501f3bfde8be1a6a2a4d8108a039b064a60c7f06160ff
|
