Package: typogrify-engineer
Note: This is a fork of the original `typogrify` project made especiallyfor `Engineer<http://www.github.com/tylerbutler/engineer/>`_. Themodifications are very minor:- SmartyPants defaults changed so that `--` is interpreted as an en-dashand `---` is interpreted as an em-dash. I don't know why in the world thisisn't the default.typogrify: Filters to make web typography easier================================================================This application provides a set of custom filters for the Djangotemplate system which automatically apply various transformations toplain text in order to yield typographically-improved HTML.Version 2 changes-----------------* Django is no longer a requirement. The typogrify filters can be used in anyenvironment by importing them from typogrify.filters* Experimental jinja2 support added in typogrify.templatetags.jinja_filters –untested and defintely needs some eyes on it. Might trigger a point releasesoon to update.Requirements============``typogrify`` is a set of functions that take text or html input and mark them up with HTML.it requires `the Python port of John Gruber's SmartyPants`_ for tokenization.It includes optional template filters for Django. So you'll need Django if you want to use those..._ The Python port of John Gruber's SmartyPants: http://web.chad.org/projects/smartypants.py/To use with Django==================BACKWARDS INCOMPATIBILTY NOTE: Version 2 of typogrify has moved the typogrifytag to {% load typogrify_tags %} – This necessary to allow the tags files toimport from the rest of the library.Once ``typogrify`` is installed on your system, you can add it to the``INSTALLED_APPS`` setting of any Django project in which you wish touse it, and then use ``{% load typogrify_tags %}`` in your templates toload the filters it provides.Included filters================``amp``-------Wraps ampersands in HTML with ``<span class="amp">`` so they can bestyled with CSS. Ampersands are also normalized to ``&amp;``. Requiresampersands to have whitespace or an ``&nbsp;`` on both sides. Will notchange any ampersand which has already been wrapped in this fashion.``caps``--------Wraps multiple capital letters in ``<span class="caps">`` so they canbe styled with CSS.``initial_quotes``------------------Wraps initial quotes in ``<span class="dquo">`` for double quotes or``<span class="quo">`` for single quotes. Works inside these blockelements:* ``h1``, ``h2``, ``h3``, ``h4``, ``h5``, ``h6``* ``p``* ``li``* ``dt``* ``dd``Also accounts for potential opening inline elements: ``a``, ``em``,``strong``, ``span``, ``b``, ``i``.``smartypants``---------------Applies ``SmartyPants``.``typogrify``-------------Applies all of the following filters, in order:* ``amp``* ``widont``* ``smartypants``* ``caps``* ``initial_quotes````widont``----------Based on Shaun Inman's PHP utility of the same name, replaces thespace between the last two words in a string with ``&nbsp;`` to avoida final line of text with only one word.Works inside these block elements:* ``h1``, ``h2``, ``h3``, ``h4``, ``h5``, ``h6``* ``p``* ``li``* ``dt``* ``dd``Also accounts for potential closing inline elements: ``a``, ``em``,``strong``, ``span``, ``b``, ``i``.