Drupal8主题--利用.info.yml文件定义一个主题

翻译者:长风Drupal开发

利用.info.yml文件定义一个主题

要创建一个Drupal8的主题,你需要首先创建一个themename.info.yml文件,这类似于如何定义模块和安装文件,比如把info.yml文件中的type设置为theme来区分它。

这个页面提供一个themename.info.yml文件的例子,总览这个文件包括的信息。

创建.info.yml文件


在你的主题文件夹的根目录下创建.info.yml文件。这个文件夹必须和.info.yml文件的名字一样。如果你的主题的名字为"fluffiness",所以文件夹的名字为"fluffiness",.info.yml文件命名为“fluffiness/fluffiness.info.yml”,记住,这个主题的文字不能和已经存在的模块或者主题的名字一致,主题的名字在Drupal里面必须是唯一的,否则,主题将不能被正确加载。


如果你对yaml文件结构不熟悉,请阅读http://symfony.com/doc/current/components/yaml/yaml_format.html

1、tabs不被允许,使能使用空格

2、另起一行时,必须空两个空格


例子

name: Fluffiness
type: theme
description: 'A cuddly theme that offers extra fluffiness.'
core: 8.x
libraries:
  - fluffiness/global-styling
base theme: classy
regions:
  header: Header
  content: Content
  sidebar_first: 'Sidebar first'
  footer: Footer
stylesheets-remove:
  - '@classy/css/components/tabs.css'
  - core/assets/vendor/normalize-css/normalize.css



你可以在Drupal的网站中找到更多的.info.yml文件的例子,这些主题有Drupal核心提供。


name (必须)

type (必须)

description (必须)

package (可选)

core (必须)

php (可选)

version (可选)

libraries (可选)

libraries-override (可选)

base theme (recommended)

hidden (可选)

engine (可选)

screenshot (可选)

regions (可选)

regions_hidden (可选)

features (可选)

stylesheets (可选)

stylesheets-remove (过时的)

ckeditor_stylesheets (可选)

scripts (可选)


原文地址:https://www.drupal.org/docs/8/theming-drupal-8/defining-a-theme-with-an-infoyml-file

谢绝转载。