Inclusión de estilos de imagen predeterminados con tu tema

Drupal tiene un sistema poderoso de gestión de imágenes que permite crear estilos de imagen que pueden aplicar diversos efectos a la imagen y generar derivados a partir de la imagen original. Esta funcionalidad puede ser usada en temas que desean incluir un conjunto de estilos de imagen predeterminados, creados para funcionar con el tema en cuestión, en lugar de depender de los que proporciona el núcleo.

El proceso para incluir un estilo de imagen en tu tema es similar al proceso de incluir configuración predeterminada en un módulo.

• Crea el estilo de imagen que quieres incluir usando la interfaz de usuario.
• Exporta el estilo de imagen como YAML.
• Incluye el YAML exportado en el directorio config/install de tu tema, siguiendo las reglas de nomenclatura correspondientes.

Comienza creando un estilo de imagen mediante la interfaz administrativa en Configuración > Multimedia > Estilos de imagen (admin/config/media/image-styles). Una vez creado y guardado el estilo de imagen, la configuración que compone este estilo se guarda en la configuración activa de tu sitio.

Esta configuración puede exportarse mediante:

• La herramienta de importación/exportación única en Configuración > Gestión de configuración > Importación/Exportación única > Exportar (admin/config/development/configuration/single/export).
• Desde el selector de tipo de configuración, selecciona "Estilo de imagen".
• Luego selecciona tu estilo de imagen desde el selector de nombres de configuración.

La representación YAML del estilo de imagen aparecerá en el área de texto y puede copiarse y pegarse en un archivo .yml dentro del directorio config/install de tu tema. Los archivos de configuración siguen un esquema de nomenclatura específico: image.style.{nombre_del_estilo_de_imagen}.yml. Si no estás seguro del nombre que debe usar tu archivo, este aparece justo debajo del área de texto con la configuración exportada.

Ten en cuenta que la configuración exportada incluirá una clave UUID como primera línea. Este UUID debe eliminarse antes de copiar la configuración al nuevo archivo image.style.{nombre_del_estilo_de_imagen}.yml.

Ejemplo 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: { }

Puedes incluir cualquier cantidad de estilos de imagen con tu tema. Todos ellos serán importados a la configuración activa al instalar el tema.

Ten en cuenta que después de instalar el tema, editar el archivo YML del estilo de imagen en config/install no tendrá ningún efecto, al igual que añadir un archivo YML adicional de estilo de imagen en config/install.