NAME

Pandoc::Filter::ImagesFromCode - transform code blocks into images

DESCRIPTION

This Pandoc::Filter transforms CodeBlock elements into Image elements. Content of transformed code section and resulting image files are written to files.

Attribute title is mapped to the image title and attribute caption to an image caption, if available.

CONFIGURATION

from

File extension of input files extracted from code blocks. Defaults to code.

to

File extension of created image files. Can be a fixed string or a code reference that gets the document output format (for instance latex or html) as argument to produce different image formats depending on output format.

name

Code reference that maps the CodeBlock element to a filename (without directory and extension). By default the element's id is used if it contains characters no other than a-zA-Z0-9_-. Otherwise the name is the MD5 hash of the element's content.

dir

Directory where to place input and output files, relative to the current directory. This directory (default .) is prepended to all image references in the target document.

run

Command to transform input files to output files. Variable references $...$ can be used to refer to current values of from, to, name, dir, infile and outfile. Example:

  run => ['ditaa', '-o', '$infile$', '$outfile$'],
capture

Capture output of command and write it to outfile. Disabled by default.

force

Apply transformation also if input and output file already exists unchanged. Disabled by default.