在你的主题中包含默认的图片样式

02/10/2025, by Ivan

Drupal 具有强大的图像管理系统，它允许创建图像样式，这些样式可以对图像应用各种效果，并从原始图像生成派生图像。这个功能可以用在主题中，如果你希望包含一组为该主题设计的默认图像样式，而不是依赖核心提供的样式。

在主题中包含图像样式的过程类似于在模块中包含默认配置的过程。

使用用户界面创建你想要包含的图像样式
将图像样式导出为 YAML
将导出的 YAML 放入主题的 config/install 目录中，并遵循相应的命名规则。

首先，通过管理界面在「配置」>「多媒体」>「图像样式」(admin/config/media/image-styles) 中创建图像样式。一旦图像样式被创建并保存，该样式的配置就会被保存在站点的活动配置中。

该配置可以通过以下方式导出：

在「配置」>「配置管理」>「单项导入 / 导出」>「导出」(admin/config/development/configuration/single/export) 中使用单项导入/导出工具。
在配置类型选择列表中选择「图像样式」
然后从配置名称的选择列表中选择你的图像样式。

图像样式的 YAML 表现形式将显示在文本区域中，可以复制并粘贴到主题的 config/install 目录下的 .yml 文件中。配置文件遵循特定的命名规则：image.style.{图像样式名称}.yml。如果你不确定文件应该使用什么名称，它会显示在导出的配置文本区域下方。

请注意，导出的配置会包含 UUID 作为第一行。这个 UUID 在复制配置到新的 image.style.{图像样式名称}.yml 文件前必须被删除。

示例 THEMENAME/config/install/image.style.black_white.yml

langcode: en
status: true
dependencies: { }
name: black_white
label: 'black & white'
effects:
  8d4f85cc-9a2d-4a30-af15-21b0833dc06d:
    uuid: 8d4f85cc-9a2d-4a30-af15-21b0833dc06d
    id: image_desaturate
    weight: 1
    data: { }
third_party_settings: { }

你可以在主题中包含任意数量的图像样式。它们都会在安装主题时被导入到活动配置中。

请注意，在安装主题后，编辑 config/install 中的图像样式 YML 文件将不会产生任何效果，同样，在 config/install 中添加额外的图像样式 YML 文件也不会生效。

额外区块类型 (EBT) - 全新的布局构建器体验❗

❗额外段落类型 (EPT) - 全新的 Paragraphs 体验

在你的主题中包含默认的图片样式

Menu