Thumbnailer：Pelican插件

Thumbnailer是一个Pelican插件，可以在特定目录下为所有图像创建各种尺寸的缩略图。

安装

此插件可以通过以下方式安装

python -m pip install pelican-thumbnailer

Pillow 将自动安装以调整图像大小，并且只有在缩略图不存在时才会重建缩略图（以节省处理时间）。根据您的本地环境和图像类型，您可能还需要安装 外部库 以支持某些图像文件格式。

只要您没有在 Pelican 设置文件中显式添加 PLUGINS 设置，新安装的插件应该会自动检测并启用。否则，您必须将 thumbnailer 添加到现有的 PLUGINS 列表。更多信息，请参阅 如何使用插件 文档。

配置

• IMAGE_PATH 是图像目录的路径。它应位于您的内容目录中，默认为 pictures。
• THUMBNAIL_DIR 是生成缩略图的输出子目录的路径。
• THUMBNAIL_SIZES 是一个将尺寸名称映射到尺寸规范的字典。生成的文件名将是 originalname_thumbnailname.ext，除非设置 THUMBNAIL_KEEP_NAME。
• THUMBNAIL_KEEP_NAME 是一个布尔值，如果设置，则将具有原始名称的文件放在一个名为 thumbnailname 的文件夹中，其名称与 THUMBNAIL_SIZES 中的键相同。
• THUMBNAIL_KEEP_TREE 是一个布尔值，如果设置，则保存图像目录树。
• THUMBNAIL_INCLUDE_REGEX 是一个可选字符串，用作正则表达式以限制缩略图到匹配的文件。默认情况下，所有不以点开头的文件都被尊重。

可以使用以下任何格式指定尺寸

• wxh 将精确调整为 wxh，并根据需要裁剪以获取该尺寸
• wx? 将调整大小，使宽度为指定的尺寸，高度将按比例缩放以保留宽高比
• ?xh 与 wx? 相同，但高度为设置的尺寸
• s 是 wxh 的简称，其中 w=h

贡献

欢迎并非常感谢贡献。每一份贡献都很重要。您可以通过改进文档、添加缺失功能以及修复错误来做出贡献。您还可以通过审查和评论 现有问题 来提供帮助。

要开始为这个插件做出贡献，请查阅 为 Pelican 做出贡献 文档，从 贡献代码 部分 开始。