Metadata-Version: 2.0
Name: django-smarty
Version: 0.1.2
Summary: A Django template filter to convert ASCII punctuation into typographic punctuation HTML entities.
Home-page: https://github.com/richardcornish/django-smarty
Author: Richard Cornish
Author-email: rich@richardcornish.com
License: BSD
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: Framework :: Django :: 1.10
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.0
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Dist: smartypants

Django Smarty
*************

|PyPI version|_

.. |PyPI version| image::
   https://badge.fury.io/py/django-smarty.svg
.. _PyPI version: https://pypi.python.org/pypi/django-smarty

**Django Smarty** is a `Django <https://www.djangoproject.com/>`_ `template filter <https://docs.djangoproject.com/en/2.0/howto/custom-template-tags/>`_ application to convert ASCII punctuation characters into smart typographic punctuation HTML entities with `SmartyPants <https://daringfireball.net/projects/smartypants/>`_. Uses the `Python smartypants <https://pypi.python.org/pypi/smartypants>`_ package.

* `Package distribution <https://pypi.python.org/pypi/django-smarty>`_
* `Code repository <https://github.com/richardcornish/django-smarty>`_

Install
=======

.. code-block:: bash

   $ pipenv install django-smarty

Add to ``settings.py``.

.. code-block:: python

   INSTALLED_APPS = [
       # ...
       'smarty',
   ]

Usage
=====

.. code-block:: django

   {% load smarty_tags %}

   {{ post.body|smarty }}

Result:

.. code-block:: html

   &#8220;Hello&#8212;world!&#8221;

Settings
========

``smarty`` is a filter composed of several smaller filters:

- ``smartypants`` is the original SmartyPants
- ``smartycaps`` wraps capital letters in ``<span class="initialism"></span>``

One can apply any filter individually. For example, if one preferred the original SmartyPants, write ``{{ post.body|smartypants }}``.

One can customize the application and order of ``smarty`` filters with the ``SMARTY_FILTERS`` setting. By default, the ``SMARTY_FILTERS`` setting is:

.. code-block:: python

   SMARTY_FILTERS = [
       'smartypants',
       'smartycaps',
   ]

One can also customize the HTML class of ``smartycaps`` with the ``SMARTY_CAPS_CLASS`` setting. By default, the ``SMARTY_CAPS_CLASS`` setting is:

.. code-block:: python

   SMARTY_CAPS_CLASS = 'initialism'


