Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Jinja Filters for Pelican.

Project description

Jinja Filters is a plugin for Pelican, a static site generator written in Python.

Jinja Filters provides a selection of functions (called filters) for templates to use when building your website. They are packaged for Pelican, but may prove useful for other projects that make use of Jinja2.

Installation

The easiest way to install Jinja Filters is through the use of pip. This will also install the required dependencies (currently pelican and titlecase) automatically.

pip install minchin.pelican.jinja_filters

Then, in your pelicanconf.py file, add Jinja Filters to your list of plugins:

PLUGINS = [
            # ...
            'minchin.pelican.jinja_filters',
            # ...
          ]

And that’s it! The filters are now available for use in your templates.

Usage

At present, the plugin includes the following filters:

  • datetime – allows you to change to format displayed for a datetime object. Optionally supply a datetime format string to get a custom format.
  • article_date – a specialized version of datetime that returns datetimes as wanted for article dates; speciefically Friday, November 4, 2016.
  • breaking_spaces – replaceds non-breaking spaces (HTML code &nbsp) with normal spaces.
  • titlecase – Titlecases the supplied string

For example, within your theme templates, you might have code like:

<span class="published">
    Article Published {{ article.date | article_date }}
</span>

gives:

Article Published Friday, November 4, 2016

Or with your own dateformat:

<span class="published">
    Article Published {{ article.date | datetime('%b %d, %Y') }}
</span>

gives:

Article Published Nov 04, 2016

Fitlers can also be chained, or applied in sequence. For example to remove breaking spaces and then titlecase a catgory name, you might have code like:

<a href="{{ SITEURL }}/{{ article.category.url }}">
    {{ article.category | breaking_spaces | titlecase}}
</a>

Known Issues

  • the setup.py file for this project does not run on Python 2.7. However, wheels of this project are “universal” and so can be generated by Python 3 and subsquently installed by Python 2.7.

License

Jinja Filters is under the MIT License. See attached License.txt for full license text.

Project details


Release history Release notifications

This version
History Node

1.0.4

History Node

1.0.1

History Node

1.0.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
minchin.pelican.jinja_filters-1.0.4-py2.py3-none-any.whl (7.8 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Apr 17, 2017
minchin.pelican.jinja_filters-1.0.4.tar.gz (5.1 kB) Copy SHA256 hash SHA256 Source None Apr 17, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page