Drupal主题开发 – 通过.info.yml定义新主题

张志军 11个月前 (05-22) 396次浏览 0个评论

在创建Drupal主题的时候,必选先创建一个THEMENAME.info.yml的文档(THEMENAME为你的主题名称,与主题文件夹同名)。THEMENAME.info.yml文档包含了主题的一些元信息(meta-data)。THEMENAME必须以字母开头,且只能包含小写字母,数字和下划线。同时......

在创建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

0 0 投票数
文章评分

版权申明:

本博客所有文章除特别声明外均采用BY-NC-SA 4.0许可协议。依据BY-NC-SA 4.0许可协议,转载请附上原文出处链接及本声明。

原文链接:https://ilearning.org.cn/program/web/drupal-theme-development-begin-with-info-yml.html

客官,说点什么吧!

订阅评论
提醒
guest

0 评论
内联反馈
查看所有评论
关于本站
立学网是一个分享个人学习总结的知识网站,内容覆盖编程技术讨论,金融经济,历史哲学,读书笔记,生活随笔等内容。
关注我们
关注微信公众号 关注微博