Skip to content

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.
Back to top