drupal核心的模板和建议
原文：http://drupal.org/node/190815
译者：葛红儒， Think in Drupal,
drupal默认模板:
这些为drupal内核提供的默认模板(.tpl.php)文件.drupal模板文件内部包含了相应变量和模板用途的文档.这有对于所有模板都可用的默认变量集.
由PHPTemplate在5.x中处理的模板,也被删除了. PHPTemplate不再处理模板文件.
为了覆写这些模板,你只需要将其拷贝到你的主体目录下,并清空drupal主题注册表.
drupal Aggregator(聚合器)
"modules/aggregator/..."
- aggregator-feed-source.tpl.php
- aggregator-item.tpl.php
- aggregator-summary-item.tpl.php
- aggregator-summary-items.tpl.php
- aggregator-wrapper.tpl.php
drupal Block (区块)
"modules/system/..."
"modules/block/..."
Book (书)
"modules/book/..."
- book-all-books-block.tpl.php
- book-export-html.tpl.php
- book-navigation.tpl.php
- book-node-export-html.tpl.php
Comment (评论)
"modules/comment/..."
drupal Forum (论坛)
"modules/forum/..."
- forum-icon.tpl.php
- forum-list.tpl.php
- forum-submitted.tpl.php
- forum-topic-list.tpl.php
- forum-topic-navigation.tpl.php
- forums.tpl.php
drupal Node (节点)
"modules/node/..."
- modules/node/node.tpl.php
drupal Poll (投票)
"modules/poll/..."
- poll-bar-block.tpl.php
- poll-bar.tpl.php
- poll-results-block.tpl.php
- poll-results.tpl.php
- poll-vote.tpl.php
drupal Profile (外形)
"modules/profile/..."
drupal Search (搜索)
"modules/search/..."
User (drupal用户)
"modules/user/..."
System (drupal系统模块)
"modules/system/..."
drupal模板建议
建议只有和基模板放在同一个目录下面时,才能工作.换句话说,为了让comment-blog.tpl.php正常工作,你需要把comment.tpl.php也放到同一个目录下.
下面列出的为默认建议.如果你想定制的话,可参看使用模板建议一页.
block-[region|[module|-delta]].tpl.php
基模板: block.tpl.php
默认建议及顺序:
- block-module-delta.tpl.php
- block-module.tpl.php
- block-region.tpl.php
"module"为模块名称,而"delta"为模块分配给该区块的内部id.例如, "block-user-1.tpl.php"将用于默认用户导航区块,因为该区块由user模块创建,且内部id为1. "region"将对特定区域产生作用.
comment-[type].tpl.php
基模板: comment.tpl.php
默认建议为comment-type.tpl.php,它用于特定节点类型的评论格式,以区别站内的其它评论.与node-[type].tpl.php类似,但是它用于评论.
comment-wrapper-[type].tpl.php
基模板: comment-wrapper.tpl.php
与前者类似,但是用于包装器(wrapper)模板.
forums-[[container|topic]-forumID].tpl.php
基模板: forums.tpl.php
默认模板建议及顺序。
对于论坛容器
- forums-containers-forumID.tpl.php
- forums-forumID.tpl.php
- forums-containers.tpl.php
对于论坛话题：
- forums-topics-forumID.tpl.php
- forums-forumID.tpl.php
- forums-topics.tpl.php
maintenance-page-[offline].tpl.php
基模板: maintenance-page.tpl.php
当数据库不可用时,应用该模板建议.用来为用户展示一个不带错误信息的页面.首先需要设置维护页面的主题化.
node-[type].tpl.php
基模板: node.tpl.php
节点类型,例如"node-story.tpl.php", "node-blog.tpl.php",等等.
page-[front|internal/path].tpl.php
基模板: page.tpl.php
可以有无数个建议.具有优先级的为首页(front page).剩下的都是基于当前页面的内部路径。不要将内部路径和路径别名混淆了，这里不能使用路径别名。记住，通常使用pathauto.module来设置路径别名。
可通过"Administrator > Site configuration > Site information"来设置首页。对于设置好的首页，将会为其使用"page-front.tpl.php"模板。
下面为drupal模板建议文件，根据内部路径，越特殊的次序越靠前。如果系统为当前页面找到了一个模板建议的话，就不会再调用位于它后面的模板建议了。例如，对于http://www.example.com/node/1/edit，将会有下面的建议可用：
- page-node-edit.tpl.php
- page-node-1.tpl.php
- page-node.tpl.php
- page.tpl.php
poll-results-[block].tpl.php
基模板: poll-results.tpl.php
生成投票结果的主体函数，可供节点和区块共同使用。默认是用于节点的，但是drupal模板建议使得可以用在区块区域中。这个建议是默认的，它位于"modules/poll/poll-results-block.tpl.php"。
poll-vote-[block].tpl.php
基模板: poll-vote.tpl.php
与poll-results-[block].tpl.php类似，但用来生成投票表单。你必须自己为其提供drupal模板，以让其生效。
poll-bar-[block].tpl.php
基模板: poll-bar.tpl.php
与poll-vote-[block].tpl.php一样，但是用来生成单个的bars(细长条纹)。
profile-wrapper-[field].tpl.php
基模板: profile-wrapper.tpl.php
这个profile包装器模板，是在浏览会员列表页面时使用的。当浏览特定的字段时，在模板建议中需要使用字段名称。例如http://drupal.org/profile/country/Belgium使用的模板为"suggest profile-wrapper-country.tpl.php"。
search-results-[searchType].tpl.php
基模板: search-results.tpl.php
search-results.tpl.php是搜索结果的默认包装器。根据搜索类型的不同，使用不同的建议。例如，对于"example.com/search/node/Search+Term"，将使用"search-results-node.tpl.php"。而对于"example.com/search/user/bob"，则使用"search-results-user.tpl.php"。模块可以扩展搜索类型，并为其添加更多的建议。
search-result-[searchType].tpl.php
基模板: search-result.tpl.php
与前者相同，但是用于单个的搜索结果。
原文：http://drupal.org/node/190815
译者：葛红儒， Think in Drupal
