info文件内容中文说明

; $Id: garland.info,v 1.10 2010/11/07 00:27:20 dries Exp $
在一行的开头使用分号 (;),以添加注释。使用方括号 ([]) 时,是为了创建关联值的数组。让我们详细介绍在 .info 文件中必须或有可能包含的元素。

name = Garland
name 值是必需的。它应该是一个人类可读的名称,必须以字母字符开始。名称的限制与 PHP 中构成函数的限制相同,因为 Drupal 将它用作同样的用途。因此,该名称可以包含数字和下划线 (_),但没有连字符 (-)、空格或标点符号。
description = A multi-column theme that can be configured to modify colors and  switch between fixed- and fluid-width layouts
description 键是建议使用的,它应该只是主题的简要说明。您在此处输入的描述出现在主题的选择或 Appearance 页面。

package = Core

version = VERSION
尽管许多流行的主题都包括 version 关键,但我们并不鼓励使用它。如果你打算将主题托管在 Drupal 主题存储库,就没有必要包括 version,因为当一个发布被打包用于下载时,drupal.org 会自动添加版本字符串。否则,您可以包括自己喜欢的任何版本字符串。下面是其语法:version = 1.0

core = 7.x
core 键是必需的值。在所有目前受支持的 Drupal 版本中,您必须说明您的模块和主题所兼容的 Drupal 版本。在这里设置的值将与 Drupal Core Compatibility 常数(可以在 include/bootstrap.inc 文件中找到)兼容;如果没有找到匹配,则 Drupal 将禁用主题。

stylesheets[all][] = style.css
stylesheets[print][] = print.css

样式表 Drupal 主题曾经默认使用 style.css。然而,在当前版本中,如果未在 .info 文件中指定 style.css,则主题不再默认为 style.css。此外,您可以通过 .info 文件添加新的样式表。

settings[garland_width] = fluid
; Information added by drupal.org packaging script on 2011-01-05

version = "7.0"
尽管许多流行的主题都包括 version 关键,但我们并不鼓励使用它。如果你打算将主题托管在 Drupal 主题存储库,就没有必要包括 version,因为当一个发布被打包用于下载时,drupal.org 会自动添加版本字符串。否则,您可以包括自己喜欢的任何版本字符串。

project = "drupal"

base theme = garland
基础主题如果您的主题是另一个主题的子主题,那么就一定要声明其 base theme,以启用主题继承。换句话说,子主题中将可以使用基础主题 (base theme) 的文件资源。您需要输入基础主题的内部机器可读名称。

engine = phptemplate
引擎engine 键表示您的主题所使用的主题引擎种类。在大多数情况下它是必需的。如果您在 .info 文件中没有提供 engine,Drupal 假定主题是一个通过 .theme 文件实现的独立主题。在 Drupal.org 库中找到的大多数主题使用默认的 PHPTemplate 引擎,该引擎与 Drupal 核心一起打包。

regions[highlighted] =Mission Statement
区域 regions 键定义主题可用的块区域。您必须明确定义 regions 键,然后定义在方括号中的内部机器可读名称。之后,您必须将人类可读名称定义为适当的值。

如果您选择不定义区域,在 Drupal 7 主题中假定使用以下值:

regions[header] = Header
regions[highlighted] = Highlighted
regions[help] = Help
regions[content] = Content
regions[sidebar_first] = Left sidebar
regions[sidebar_second] = Right sidebar
regions[footer] = Footer

[ 区域名称文字内容 ] =这里是说明区域名称 , 您可以根据自己的特定需求覆盖这些值。如果要这样做,您必须声明该行。

Features
您可以在主题的配置页面上切换各种页面元素。在主题配置页面上所显示的复选框由 features 键控制。因此,对于主题没有定义或使用的元素,您可以禁止显示其复选框。省略一个条目,就会禁止显示该特性的复选框;如果您没有定义任何特性,那么所有复选框都将显示为假定的默认值。

在 .info 文件中的主题特性条目                
features[ ] = logo
features[ ] = name
features[ ] = slogan
features[ ] = node_user_picture
features[ ] = comment_user_picture
features[ ] = favicon
features[ ] = main_menu
features[ ] = secondary_menu

scripts[] = scripts/myscript.js
脚本 在主题的 template.php 文件中,通过调用 drupal_add_js() 等函数来包括 JavaScript 文件,这曾经是常见的做法。然而,在 Drupal 7 中,只有当您在 .info 文件指定 script.js 时,才会包括该文件。

php = 5.2.4
PHP
您在这里定义的字符串将是主题所支持的最低 PHP 版本。默认值来自 DRUPAL MINIMUM PHP 常数(位于 includes/bootstrap.inc 文件):
<?php
define('DRUPAL_MINIMUM_PHP', '5.2.4')
?>
您可以更改此值,但不需要添加字符串。

默认的 .info 值
.info 文件中包含 Drupal 为每个已安装主题假设的默认值。如果在 .info 文件中没有定义这些值,Drupal 强制主题使用默认值。但是请注意,这些值应用为一个组。这意味着,如果重写一行,如:
regions[sub_header] = Sub-header

您将需要重新定义默认区域的其余部分;否则,它们将被省略。这条规则也适用于样式表。即使样式表在技术上并不是在一个组中进行定义的,但如果在 .info 文件中定义了另一个样式表,您必须再次重新定义 style.css;否则,它将不会被包括在内。

默认的 .info 值               
regions[sidebar_first]  = Left sidebar
regions[sidebar_second] = Right sidebar
regions[content] = Content
regions[header] = Header
regions[footer] = Footer
regions[highlighted] = Highlighted
regions[help] = Help
regions[page_top] = Page Top
regions[page_bottom] = Page Bottom
engine = phptemplate
features[ ] = logo
features[ ] = name
features[ ] = slogan
features[ ] = node_user_picture
features[ ] = comment_user_picture
features[ ] = favicon
features[ ] = main_menu
features[ ] = secondary_menu
screenshot = screenshot.png