叶用ImageMagick预处理器。
foliantcontrib.imagemagick的Python项目详细描述
imagemagick预处理器
此工具使用ImageMagick对标记源中引用的图像提供附加处理。
安装
$ pip install foliantcontrib.imagemagick
配置
要启用预处理器,请将imagemagick
添加到项目配置中的preprocessors
部分:
preprocessors:-imagemagick
预处理器有许多具有以下默认值的选项:
preprocessors:-imagemagick:convert_path:convertcache_dir:.imagemagickcache
convert_path
:指向convert
二进制文件(imagemagick的一部分)的路径。
cache_dir
:存储已处理图像的目录。这些文件以后可以重用。
用法
假设要将以下命令应用于图片image.eps
:
$ convert image.eps -resize 600 -background Orange label:'Picture' +swap -gravity Center -append image.jpg
此命令获取源eps图像image.eps
,调整其大小,在图片上放置文本标签,并将结果写入新文件image.jpg
。输出文件名的后缀指定必须将图像转换为JPEG格式。
要使用imagemagick预处理器执行相同的操作,请在标记源中的<<magick>
和</magick>
标记之间包含一个或多个图像引用。
<<magick command_params="-resize 600 -background Orange label:'Picture' +swap -gravity Center -append" output_format="jpg"> (leading exclamation mark here)[Optional Caption](image.eps) </magick>
使用output_format
属性指定输出文件名的后缀。将自动生成整个输出文件名。
使用command_params
属性指定应传递给imagemagickconvert
binary的参数字符串。
不使用command_params
属性,您可以将每个参数指定为具有相同名称的自己的属性:
<<magick resize="600" background="Orange label:'Picture' +swap" gravity="Center" append="true" output_format="jpg"> (leading exclamation mark here)[Optional Caption](image.eps) </magick>