django-icomoon 0.4.0

A Django app to deploy wefonts from Icomoon and display them

A Django app to deploy downloaded wefonts from Icomoon and display them in a gallery.

Warning

Since version 0.4.0 Django support for 1.7 version and less has been dropped.

Links

• Download his PyPi package;

• Clone it on his Github repository;

Requires

• Django >= 1.8;

• django-braces >= 1.2.0;

Install

First install the package

pip install django-icomoon

Add it to your installed Django apps in settings :

INSTALLED_APPS = (
    ...
    'icomoon',
    ...
)

Import default app settings:

from icomoon.settings import *

Default behavior require users to be authenticated to view the gallery, if you want to open it for anonymous define the following setting:

ICOMOON_PRIVATE = False

Webfonts and manifests

Now you must define at least one webfont in your project settings like this:

ICOMOON_MANIFEST_FILEPATH = {
    'Default': {
        'fontdir_path': '/home/work/myproject/webapp_statics/fonts/default',
        'csspart_path': '/home/work/myproject/webapp_statics/css/icomoon_icons.scss'
    },
}

Each website entry is a dict containing the following values:

fontdir_path

(Required) Absolute path to the webfont directory.

csspart_path

(Optional) Absolute path where will be written the css part containing webfont icons.

Urls

Just mount its urls in your main urls.py :

urlpatterns = patterns('',
    ...
    (r'^icomoon/', include('icomoon.urls', namespace='icomoon')),
    ...
)

Templates

This at your responsability to load the webfont into your website templates, this app won’t do it for you.

Note that shipped templates in templates/icomoon/ are written using Foundation5 components and inherits from a templates/skeleton.html that you have to create yourself. You better gives an eye to this app templates to correctly integrate them into your project.

Usage

Gallery

When it’s installed you could reach the webfont gallery from /icomoon/.

The gallery display all defined icons in the manifest, giving the CSS classname, the unicode codepoint and the UTF-8 code.

Deployment

Put the downloaded ZIP archive on your server then simply use the command line:

./manage.py icomoon_deploy Default icomoon.zip

The first argument is the webfont key name (defined in your settings, see Webfonts and manifests) to use and the second argument is the path to your downloaded archive to deploy:

./manage.py icomoon_deploy [Webfont name] [Zip archive path]

Default values for these two arguments are respectively Default and icomoon.zip, so if they match your webfont settings, you don’t need to give them:

./manage.py icomoon_deploy

The tool will validate the archive content structure then if all requirements are meets (a JSON manifest and at least one supported font format) it will deploy the archive content to defined path (fontdir_path) in webfont settings.

Optionaly, if a path (csspart_path) is defined for, the manifest will be used to build a css file where all icon selectors are defined, so you can import it to directly use your icons.

Finally the manifest is installed in the same directory than font files.

History

Version 0.4.0 - 2016/04/06

• Dropped support for Django <= 1.7;

• Fixed command line arguments for Django == 1.8;

Version 0.3.1 - 2015/10/24

• Lowering down minimal ‘django-braces’ dependancy, better classifiers for Django versions in setup.py;

Version 0.3.0 - 2015/10/11

• Implemented command line to deploy webfont from download ZIP on Icomoon, contains many backward incompatible settings, this is related to issue #2;