EPSConvert

EPSConvert is a tool to convert EPS images into PNG format.

Installation

$ pip install foliantcontrib.epsconvert

Config

To enable the preprocessor, add epsconvert to preprocessors section in the project config:

preprocessors:
    - epsconvert

The preprocessor has a number of options:

preprocessors:
    - epsconvert:
        convert_path: convert
        cache_dir: !path .epsconvertcache
        image_width: 0
        targets:
            - pre
            - mkdocs
            - site
            - ghp

convert_path : Path to convert binary. By default, it is assumed that you have this command in PATH. ImageMagick must be installed.

cache_dir : Directory to store processed images. They may be reused later.

image_width : Width of PNG images in pixels. By default (in case when the value is 0), the width of each image is set by ImageMagick automatically. Default behavior is recommended. If the width is given explicitly, file size may increase.

targets : Allowed targets for the preprocessor. If not specified (by default), the preprocessor applies to all targets.