name = A fantasy name
Drupal文档教程翻译 - .info文件结构详解(1)
本站原创编译,转载请给面子,尊重劳动果实,欢迎交流指正。
假期结束;一直忙于各种事务,疏于更新,现在几乎忘记自己网站的域名...一个假期都风和日丽天高云淡的,今天却风雨起来,但我们的Drupal文档教程翻译仍要继续。假期第一天的时候我们结束掉了“子主题的结构及继承机制”,今天来看Drupal主题的.info文件的结构。
有关.info文件的作用,我们已经在“Drupal文档教程翻译 - 模板主题文件概览(1)”一文中做过大致了解了。.info文件的句法和INI文件类似;对Joomla熟悉的朋友可以发散联想下Joomla中用于保存参数设置的INI文件。
.info文件,它基本就是个用于保存主题设置信息的静态文本文件,每一行都是“键=值”的形式(key=value),左边是key,右边是相应的value,中间用等号连接起来。在某行前面使用分号就可以将该行注释掉。使用方括号可以将多个value以数组的形式赋给一个键。
Drupal可以识别下面这些键的名称;对于那些非必要的没有在.info文件中明确定义出来的键,Drupal会使用默认值。
- name(必要)
- description(推荐)
- screenshot
- version(不推荐)
- core(必要)
- engine(多数情况下必要)
- base theme
- regions
- features
- stylesheets
- scripts
- php
抓紧时间来看看前面三个先。
name(必要)
当前主题的用户可读名称(human readable name),区别于机器可读名称(machine readable name),在拼写规则上没有什么限制,比如大小写、下划线一类的使用规则。
description(推荐)
对主题的简短描述,会在站点后台的主题管理(Administer>Site building>themes)中呈现给使用者。
description = Tableless multi-column theme designed for blogs.
screenshot
该主题的演示缩略图,会在站点后台的主题管理中呈现给使用者,便于识别。如果没有特别指定,那么Drupal默认会在主题路径中寻找名为“screenshot.png”的图片。
所以呢,除非我们的缩略图文件名称不是“screenshot.png”,否则没有必要在.info文件中进行声明;或者如果我们的缩略图文件并不是存放在主题路径下,那么可以将指定路径声明给系统,比如:
screenshot = images/screenshot.png
今天就到这里,明天继续看剩下的键值介绍。
译者:Viiiix7210
如需转载,请注明官方英文文档及本人译文的出处,谢谢。查看英文原文: Structure of the .info file
| < Prev | Next > |
|---|
