Revised version of my prior pull request for this feature ( #33 ), now with documentation and tests. I went with a field name of "solr_highlights" instead of "solr:highlights" because the : in the field name (while guaranteeing it won't collide with an existing field name) is also problematic (read: impossible to use) in Django templates, which is my primary motivation for adding this.
Hope the tests are general what you were looking for; hope the docs are clear without being too Django specific. --I tried to also draw on the examples in posts to the google group.
Hope you don't have to do much revision.
per-item highlights on individual result items (with docs & tests)
Minor suggestion. We might want to use … instead of the ... in the example.