在创建Drupal主题的时候,必选先创建一个THEMENAME.info.yml的文档(THEMENAME为你的主题名称,与主题文件夹同名)。THEMENAME.info.yml文档包含了主题的一些元信息(meta-data)。THEMENAME必须以字母开头,且只能包含小写字母,数字和下划线。同时也要确保不能和其它模块、主题的名称一样。另外也不能使用保留字,例如src, lib, vendor, assets, css, files, images, js, misc, templates, includes, fixtures, drupal。
THEMENAME.info.yml文件必须位于Drupal主题根目录下,例如我的主题目录和yml文件为beginner/beginner.info.yml。此外,需要注意以下两点:
- YML文件必须使用空格,而不能使用tab;
- 属性类别必须缩进2个空间;
以上两点均可以通过设置IDE进行自动转换和对齐。
THEMENAME.info.yml文件样例如下:
name: Beginner
type: theme
description: 'A CMS theme for drupal. Designed by Zhang Zhijun. copyright (c) 2023,chahauwu.com all rights reserved.'
core_version_requirement: ^10
version: '1.0.0'
libraries:
- beginner/assets
base theme: stable9
regions:
header: 'Header'
content: 'Content'
sidebar_first: 'Sidebar first'
footer: 'Footer'
features :
- logo
- seo
YML文件的必选字段有
Name:主题名称
Type:用来标识扩展类型,主要有3类:theme,module,profile
base theme:用来标识新建主题从哪个主题集成,官方推荐为stable9。
core_version_requirement:指定依赖的主题或模块的版本,如果多个的话用||分割,例如^9 || ^10。
Core: 指定Drupal core的适用版本,如果多个的话用||分割,例如^9 || ^10
参考文档:
https://www.drupal.org/docs/develop/theming-drupal/defining-a-theme-with-an-infoyml-file