图像处理
MkDocs 的 Material 依赖于几个库,以允许在构建管道中进行图像处理,包括社交卡片和图像优化。因此,必须在主机系统上安装一些外部库。本节解释如何安装它们。
依赖项
使用以下命令安装图像处理的 Python 依赖项:
Cairo Graphics
Cairo Graphics是一个图形库,也是Pillow的依赖项,MkDocs 的 Material 使用它来生成社交卡片并执行图像优化。看下面的部分,它解释了如何在你的系统上安装Cairo Graphics及其依赖项:
macOS
确保安装了Homebrew,这是macOS的现代包管理器。接下来,使用以下命令安装所有必要的依赖项:
Windows
如安装指南中所述,在Windows上安装Cairo Graphics库的最简单方法是安装GTK+,因为它依赖于Cairo。你也可以下载并安装预编译的GTK运行时。
Linux
Linux有几个包管理器,每个发行版的可用性各不相同。安装指南解释了如何为你的发行版安装Cairo Graphics库:
以下环境带有预安装的Cairo Graphics版本:
- DockerImage 中无需安装
- GitHubActions (Ubuntu)中无需安装
pngquant
pngquant是一个优秀的用于有损 PNG 压缩的库,是内置优化插件的直接依赖项。看下面的部分,它解释了如何在你的系统上安装pngquant:
Windows
在Windows上安装pngquant稍微复杂一些。pngquant-winbuild仓库包含了如何在Windows上建立pngquant环境的指南。