Info文件,就是THEMENAME.info.yml文件,提供Durpal主题所需的元数据、支持的功能和定义区域。这个文件是必须的,创建这个文件通常是你创建主题的第一步。 在本篇教程中: - 创建一个.info.yml文件,然后定义一个主题 - 回顾必须的key/value - 在Drupal界面中启用新主题

创建info文件

最快的方法是通过Durpal命令:drupal generate:theme,然后它会提示你所有需要的值。

Create an info file from scratch

手动创建info文件

如果你想要手动创建info文件,或者深入理解了info文件的作用,你可以往下看:

1 选择一个名字

第一件事是给你的主题起一个名字 - 一个显示在你Durpal后台,容易理解的名字,还有一个机读名字。本例中,我们给主题起名Ice Cream, 机读名icecream。

注意:机读名必须全部小写,以字母开口,用下划线替代空格,不能包含其他字母。可以是icecream, ice, 但不可以是ice cream 和 6icecream。

机读名就是我们info.yml文件的名字。以后代码中都用这个名字。

2 创建一个info文件

文件路径themes/icecream/icecream.info.yml

3 编辑info文件

打开themes/icecream/icecream.info.yml,用你最喜欢的编辑器,然后加入下面的代码:

'' # THEMENAME.info.yml file for Ice Cream example theme. '' name: Ice Cream '' type: theme '' base theme: classy '' description: 'A great theme for warm summer days.' '' package: Custom '' core: 8.x

下面来解释一下这些字段的含义: name(必须)可读的主题名,显示在Drupal后台。 type (必须)告诉Drupal项目的类型,如果是主题的话,就设置成’theme’ description A short one-line description used in the UI when listing your theme. 简短的一行描述,显示在后台 package 你的主题所属的包,用来把项目归类在一起。 core (必须)你的主题适用的Drupal core的版本。必填字段。如果是Drupal 8的话,就设置成’8.x’ base theme (default = Stable)base主题的机读名字。如果没有,那么就会适用自带的”Stable”主题。Classy是另一个内核提供的主题。如果不想使用base主题,那么设置成false

4 清空缓存

完成了themes/iceream.info.yml, Druapl就能发现你的主题,并且显示在Appearance页面上。你只需要清空缓存(Configuration > Performance (admin/config/development/performance),Drupal就回重建主题列表,然后根据.info.yml识别出新的主题。

5 验证主题

最后,打开Appearance (admin/appearance) 页面,你就能看到Ice Cream主题显示在Uninstalled themes下面。