Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A django app that provides a template tag and 2 filters for doing syntax highlighting with Pygments

Project Description
django-pygments is a Django app that provides a template tag and 2 filters for doing syntax highlighting with Pygments ( http://pygments.org/ ).

Dependencies:
- pygments

Installation:
- add django_pygments to your project directory and to INSTALLED_APPS in your settings.py
- if you want to see the integrated demo page, add a urls.py entry and copy/link the media files in the proper dir

Usage:
- enclose your code snippet in a pre tag with the non-standard "lang" attribute set to a supported language like this:
<pre lang="python">....</pre>
- see the view and demo template for examples on how to use the "pygmentify" and "pygmentify_inline" filters (the later is rather useful for RSS feeds) or the "pygment" tag
- While using the "pygment" template tag, you can pass keyword arguments that you would pass to Pygments HtmlFormatter class constructor by passing them as with keyword arguments along with the pygment tag. Look at demo template for examples. There is one caveat with this feature still. You can only pass Python values as argument values (like Strings wrapped within quotes or True or False boolean values, etc.). It doesn't support Django template/context variables as arguments yet.

Notes:
- the custom HTML formatter class displays each line as an ordered list element, thus implementing line numbering without interfering with copy/pasting
- to see a list of supported languages, look at the "lexer_names" variable in utils.py

The project's site is here: http://od-eon.com/labs/django-pygments/
For technical support use the github issue tracker or contact us at developers@od-eon.com
Release History

Release History

This version
History Node

0.1

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-pygments-0.1.tar.gz (3.8 kB) Copy SHA256 Checksum SHA256 Source Feb 12, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting