highlight-ranges 1.0.0

Quick start

First, install highlight-ranges. See the “Installation” section for details.

Create a directory somewhere and create a file named example.py with the following contents:

def func(x):
    y = x * 4
    return y

Now initialize a spor repository and add an anchor that will highlight the second line in the file:

spor init
spor add example.py 17 9 5

Finally, use the highlight-ranges filter to generate the pygmentized HTML of the code:

pygmentize -l python3 -f html -O full -F highlight-ranges:file=example.py example.py > example.html

If you open example.html in a browser, you should see the second line in the code emphasized.

Installation

You can install from PyPI with pip::

pip install highlight-ranges

Or you can install from source:

pip install .

Styling

The filter marks highlighted ranges of code with the Generic.Emph type. From a CSS point of view, this means you can style the highlights via the ge class.

Filter options

file

The file being pygmentized.