# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-typogrify
VERSION=		2.0.7
KEYWORDS=		python
VARIANTS=		v12 v13
SDESC[v12]=		Filters to enhance web typography (3.12)
SDESC[v13]=		Filters to enhance web typography (3.13)
HOMEPAGE=		https://github.com/mintchaos/typogrify
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPI/t/typogrify
DISTFILE[1]=		typogrify-2.0.7.tar.gz:main
DIST_SUBDIR=		python-src
DF_INDEX=		1
SPKGS[v12]=		single
SPKGS[v13]=		single

OPTIONS_AVAILABLE=	PY312 PY313
OPTIONS_STANDARD=	none
VOPTS[v12]=		PY312=ON PY313=OFF
VOPTS[v13]=		PY312=OFF PY313=ON

DISTNAME=		typogrify-2.0.7

GENERATED=		yes

[PY312].BUILDRUN_DEPENDS_ON=		python-smartypants:single:v12
[PY312].USES_ON=			python:v12,sutools

[PY313].BUILDRUN_DEPENDS_ON=		python-smartypants:single:v13
[PY313].USES_ON=			python:v13,sutools

[FILE:2372:descriptions/desc.single]
Typogrify provides a set of custom filters that automatically apply various
transformations to plain text in order to yield typographically-improved
HTML.
While often used in conjunction with Jinja_ and Django_ template systems,
the
filters can be used in any environment.

.. _Jinja: http://jinja.pocoo.org/
.. _Django: https://www.djangoproject.com/

Installation
============

The following command will install via pip. Pay particular attention to the
package name::

    pip install typogrify

Alternatively, you can run the following command inside the project's root
directory::

    python setup.py install

Last but not least, you can simply move the enclosed typogrify folder
into your Python path.

Requirements
============

Python 2.3 and above is supported, including Python 3. The only dependency
is
SmartyPants_, a Python port of a project by John Gruber.

Installing Jinja_ or Django_ is only required if you intend to use the
optional
template filters that are included for those frameworks.

.. _SmartyPants: http://web.chad.org/projects/smartypants.py/

Usage
=====

The filters can be used in any environment by importing them from
``typogrify.filters``::

    from typogrify.filters import typogrify
    content = typogrify(content)

For use with Django, you can add typogrify to the INSTALLED_APPS setting
of any Django project in which you wish to use it, and then use
``{% load typogrify_tags %}`` in your templates to load the filters it
provides.

Experimental support for Jinja is in
``typogrify.templatetags.jinja_filters``.

Included filters
================

amp
-------

Wraps ampersands in HTML with ``<span class="amp">`` so they can be
styled with CSS. Ampersands are also normalized to ``&amp;``. Requires
ampersands to have whitespace or an ``&nbsp;`` on both sides. Will not
change any ampersand which has already been wrapped in this fashion.

caps
--------

Wraps multiple capital letters in ``<span class="caps">`` so they can
be 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 block
elements:

* 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
-------------


[FILE:112:distinfo]
8be4668cda434163ce229d87ca273a11922cb1614cb359970b7dc96eed13cb38        12903 python-src/typogrify-2.0.7.tar.gz