原文：Twig in Drupal 8

Twig 是PHP的一个模板引擎，是Symfony2框架的一部分。

在Drupal 8中，Twig代替PHP模板而成为默认的模板引擎。这种变化的结果之一是，所有 theme_* 函数和基于 PHP 模板的 *.tpl.php 文件都由 *.html.twig 模板文件所代替。

 以下是英文原文，可对照阅读：

原文链接：Defining a theme with an .info.yml file

想要创建一个 Drupal 8 模板， 第一步你需要建一个 THEMENAME.info.yml 文件，此文件提供了主题的一些元数据给给 Drupal 调用。比较类似于 模块 和安装 profiles 中的定义，但是在.info.yml文件里将“type”键设为“theme”用来区分他们的不同，这个比较重要。

此页面提供演示的 THEMNAME.info.yml 文件和一些此文件可使用的功能概述。

创建一个 .info.yml 文件

在模板文件夹下，创建一个自己的文件夹,我们拿 mahonghong 举例，然后在 mahonghong 文件夹下，创建一个 mahonghong.info.yml，此时在你的网站内的 Manage > Appearance (http://example.com/admin/appearance)，应该就能看到这个模板了。

如果你想知道哪个模板生成了指定元素, 你可以使用 Twig 的 debug 功能. 主题名字旁边也显示了文件的位置.

Twing debugging 可以在 sites/default/services.yml 文件内开启, 将twig.config 下的 debug 变量改为 true. 设置后,请清除缓存.

如果你查看当前页面下的源文件, 你将看到 debug 的输出类似下面 Twing templates 被渲染.

Upgrading 7.x themes to 8.x

Drupal 7 介绍了一些新的类如: element-hidden, element-invisible and element-focusable. 从名字上比较难以理解他们的作用, 所以我们改了下名字. 新名字应该比较容易明白而且和 知名的html 5框架 Boilerplate 保持一致, 改变和使用方法如下:

注. 屏幕阅读器 - 是指盲人使用的设备!

TBD

连接和路径函数比较类似,函数可以在以下路径找到 \Symfony\Bridge\Twig\Extension\RoutingExtension

url()

path()

url_from_path()

link()

file_url()

attach_library()

// 如果检测到数组, 这个函数会收到一个可渲染的数组. render_var(), 内部使用,最好别用.

原文链接：Theming Drupal 8

这个指南说的是如何在Drupal 8 中创建模板。

比较值得关注的是 Drupal 8 和 7 之间模板系统的变化。 这个指南包括 Drupal 7 和 Drupal 8 之间的关联，然后解释一些新的概念和方法。

除了 drupal.org, 您还可以在别的地方找到模板开发指南，比如 sqndr's excellent Drupal 8 theming guide。

对主题开发者来说想要收集比较有用的材料，请查看 Theming and Front End Development with Drupal。

以下是英文原文，可对照阅读：