Django SVG Icons made easy
Project description
Django SVG Icons
================
Simple django templatetag to display `SVG` icons in your django application.
Icon paths will loaded from a provided `JSON` file, formatted according the icomoon format.
More info: [Icomoon website](http://icomoon.io/)
Installation
------------
Installation from pypi via pip
pip install django-svg-icons
Configuration
-------------
In your django project add `svg_icons` to your installed apps and set the `SVG_ICONS_SOURCE_FILE` setting to your source file.
INSTALLED_APPS = [
# ...
'svg_icons',
]
SVG_ICONS_SOURCE_FILE = '/path/to/source_file.json'
Usage
-----
In your templates you can load the templatetag and start including your icons.
{% load svg_icons %}
{% icon 'icon_name' %}
The templatetag accepts some kwargs for icon configuration as well.
- **size** for setting both width and height
- **width** for only setting a specific width
- **height** for only setting a specific height
- **className** css classnames applied on the `<svg>` object
All kwargs are optional, when not provided the deaults are used.
{% icon 'icon_name' size=50 className="css classnames" %}
Todo
----
- Write tests
================
Simple django templatetag to display `SVG` icons in your django application.
Icon paths will loaded from a provided `JSON` file, formatted according the icomoon format.
More info: [Icomoon website](http://icomoon.io/)
Installation
------------
Installation from pypi via pip
pip install django-svg-icons
Configuration
-------------
In your django project add `svg_icons` to your installed apps and set the `SVG_ICONS_SOURCE_FILE` setting to your source file.
INSTALLED_APPS = [
# ...
'svg_icons',
]
SVG_ICONS_SOURCE_FILE = '/path/to/source_file.json'
Usage
-----
In your templates you can load the templatetag and start including your icons.
{% load svg_icons %}
{% icon 'icon_name' %}
The templatetag accepts some kwargs for icon configuration as well.
- **size** for setting both width and height
- **width** for only setting a specific width
- **height** for only setting a specific height
- **className** css classnames applied on the `<svg>` object
All kwargs are optional, when not provided the deaults are used.
{% icon 'icon_name' size=50 className="css classnames" %}
Todo
----
- Write tests
Project details
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-svg-icons-0.1.2.tar.gz
(4.2 kB
view hashes)
Built Distribution
Close
Hashes for django_svg_icons-0.1.2-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ea9cb3ae499bcecb973ec596a84584d4f9b12dd2ea8612134d4e6a6cf4c07d0c |
|
MD5 | 079604b5f0647e99939ad4a09a405cfa |
|
BLAKE2b-256 | 7108295fa4132e85d449aa229bd5a65ba38d16efefc6d904d9169998be1aabc9 |