Skip to content

图像处理

MkDocs 的 Material 依赖于几个库,以允许在构建管道中进行图像处理,包括社交卡片图像优化。因此,必须在主机系统上安装一些外部库。本节解释如何安装它们。

依赖项

使用以下命令安装图像处理的 Python 依赖项:

pip install pillow cairosvg

Cairo Graphics

Cairo Graphics是一个图形库,也是Pillow的依赖项,MkDocs 的 Material 使用它来生成社交卡片并执行图像优化。看下面的部分,它解释了如何在你的系统上安装Cairo Graphics及其依赖项:

macOS

确保安装了Homebrew,这是macOS的现代包管理器。接下来,使用以下命令安装所有必要的依赖项:

brew install cairo freetype libffi libjpeg libpng zlib

Windows

安装指南中所述,在Windows上安装Cairo Graphics库的最简单方法是安装GTK+,因为它依赖于Cairo。你也可以下载并安装预编译的GTK运行时

Linux

Linux有几个包管理器,每个发行版的可用性各不相同。安装指南解释了如何为你的发行版安装Cairo Graphics库:

Ubuntu

apt-get install libcairo2-dev libfreetype6-dev libffi-dev libjpeg-dev libpng-dev libz-dev

Fedora

yum install cairo-devel freetype-devel libffi-devel libjpeg-devel libpng-devel zlib-devel

openSUSE

zypper install cairo-devel freetype-devel libffi-devel libjpeg-devel libpng-devel zlib-devel

以下环境带有预安装的Cairo Graphics版本:

pngquant

pngquant是一个优秀的用于有损 PNG 压缩的库,是内置优化插件的直接依赖项。看下面的部分,它解释了如何在你的系统上安装pngquant

macOS

确保安装了Homebrew,这是macOS的现代包管理器。接下来,使用以下命令安装所有必要的依赖项:

brew install pngquant

Windows

在Windows上安装pngquant稍微复杂一些。pngquant-winbuild仓库包含了如何在Windows上建立pngquant环境的指南。

Linux

所有流行的Linux发行版,无论包管理器是什么,都应该允许使用捆绑的包管理器安装pngquant。例如,在Ubuntu上,可以使用以下命令安装pngquant

apt-get install pngquant

对于yumzypper也是如此。