Skip to content

Latest commit

 

History

History
35 lines (25 loc) · 1.47 KB

Readme.md

File metadata and controls

35 lines (25 loc) · 1.47 KB
Raw

ipe-pygments

Ipelet to format source code snippets in Ipe documents using Pygments.

Motivation

A popular option to format source code in LaTeX documents is the minted package, which uses Pygments internally. Unfortunately, this requires latex to be run with the -shell-escape option, which is currently not possible in Ipe. This ipelet sidesteps this problem by interacting with Pygments directly from within Ipe.

Getting started

Besides Ipe, you will need a Python version with Pygments installed.

Installing

Copy the pygments.lua file to your ipelet directory. Then, in your preferred place, set the following two preference entries:

prefs.pygments = {
    pygmentize = '/path/to/pygmentize',
    python = '/path/to/python',
}

The latter must point to the Python interpreter that has Pygments installed.

Usage

There are three actions provided under Ipelets -> Pygments:

  • Format: formats the text in the selected text object. After this, you will have to run LaTeX to view the result (Ctrl-L/Cmd-L or File -> Run Latex). Running LaTeX from within the ipelet is possible but unfortunately results in a segmentation fault, crashing Ipe entirely.
  • Edit: opens a dialog allowing you to edit both the source code and language for the selected text object.
  • Revert: reverts the content of the selected text object back to just the plain source code.