drupal主题的.info文件

原文: http://drupal.org/node/171205

译者:葛红儒 ,Think in Drupal

.info配置文件是在Drupal6中新赠的,每个主题都必须有一个.info文件.该文件应该放在你主题的目录下面.如果没有该文件的话,Drupal就找不到你的主题. .info文件的后缀名必须为".info".

  主题在Drupal内部的名字源自于这个文件.例如,如果文件名为drop.info",那么在Drupal内部,主题名字就为"drop".名字里面不要包含奇怪的字符,这是由于在Drupal中，许多PHP函数都是以主题名打头的，所以主题名和函数名存在同样的限制。起始字符必须为alphabetic字母，不能包含空格，标点等字符。可以包含下划线，但是不能包含连字符。数字字符也是允许的，但不能出现在首位。

注意：

• 警告！模块的内部名称如果与主题的内部名称重名的话，那么你的站点将不能工作。因为可能会造成同名函数的存在，这在PHP中是非法的。每个安装了的部件（模块或者主题）都必须有一个唯一的名字。
• .info文件中的内容是缓存在数据库中的，所以对它的修改不会在Drupal中立马生效。（不要与主题注册表的缓存相混淆了。）为了清除缓存，须这样做：
  1. 导航到"Administer > Site configuration > Performance"，点击"clear"按钮。
  2. 如果启用了devel区块（安装了devel模块的话），点击"Empty cache"（“清空缓存”）链接。
  3. 然后导航到主题选择页面"Administer > Site building > Themes"。
•  

语法与INI（http://en.wikipedia.org/wiki/INI_file）文件类似。.info文件就是一个用来配置主题的的静态文本文件。文本文件的每一个行就是一个键值对（key-value），其中键位于左边，值位于右边，而中间则有一个等号。（例如：key = value）。分号是用来注释的。有些键使用了特殊的语法，带有中括号[],用来构建一列关联值，也就是我们常说的“数组”.如果你不熟悉数组的话，模仿Drupal默认.info文件中的例子，根据例子中的解释，完全可以依葫芦画瓢，得到自己的数组了。

Drupal可以识别下面所列的键。如果.info文件没有设置的话，Drupal将为其使用默认值（http://drupal.org/node/171206）。可参看核心主题中的例子（http://drupal.org/node/171205#example#example）。

• name ! （名字）
• description *  描述
• screenshot   截图
• version *   版本
• core !     内核
• engine *   引擎
• base theme   基主题
• regions     区域
• features     特性
• stylesheets    样式表
• scripts      脚本
• php        php