WordPress:Stepping Into Template Tags
你如果看看你的WordPress 主题上的header.php 模板文件，你就会注意到，在显示"我的博客名"的地方，不管它是什么，当你访问你的WordPress站点时，它在模板文件中不再显示"我的博客名"。事实上，它有一大堆的奇怪的箭头和括号和字母，都没有什么意思。 这是一个模板标签的一个例子。
让我们在采取一些措施，更深地学习这些是什么，它们是如何运行的。
一个模板标签是什么
一个模板标签是一个代码来指示WordPress"去做" 或者 "得到"一些东西。对于你的WordPress站点名的header.php模板标签，它看起来是这样的：
<h1><?php bloginfo('name'); ?></h1>
模板标签 <?php bloginfo(); ?> 包在一个 H1 标题标签中， bloginfo()标签从你的管理面板中的
用户个人基本资料 和选项 > 一般 得到 信息。
模板标签参数
除了在<?php bloginfo(); ?>模板标签上的名称 参数外，也可以显示其它的信息。然我们来看看这些参数中的其中的几个-在bloginfo() Codex 页面上你可以找到更多的信息和例子。
- 描述
<?php bloginfo('description'); ?> - 这个称作你的博客的"标签行"，这个通常是一些描述性的语句，显示"我的博客是关于...."。它由管理员在选项 > 一般 子面板中设置。
；管理_邮件<?php bloginfo('admin_email'); ?>:如果你想显示管理员的邮件，你不用将它输进模板文件中。这样做，它可能对邮件 harvesters开放，他会使用复杂的软件来进入并且获得邮件地址用来发表垃圾信息。 通过使用bloginfo('admin_email'), 电子邮件在访客的页面上显示，但真正的地址被harvesters掩饰了。好, 哼? 管理员的电子邮件地址在 选项 > 一般 子面板中设置了。
- 版本
<?php bloginfo('version'); ?> - 有时你想显示一下你正在使用的WordPress是哪一个版本。默认的WordPress主题在页脚模板中包含了这个信息。它只是显示了你的博客使用的WordPress版本。
显示WordPress版本，模板标签看起来像：
<p>由WordPress 版本支持 <?php bloginfo('version'); ?></p>
注意只有版本数字由版本参数产生，而不是单词"由WordPress 版本支持"。这些单词写在标签的前面，因此可以在网页上看见它们。
学习更多的关于模板标签参数，看看 一个模板标签的解析 和怎样通过标签参数。
你怎样使用模板标签?
在Codex上模板标签菜单仔细看看不同的模板标签，你就会注意到它们中的许多非常的简单，像bloginfo() 模板标签，但许多看其来使用非常复杂。让我们来看一些例子，关于怎样使用它们来帮助你了解模板标签代码的"语言"。
就如我们在bloginfo()模板标签中所见到的那样，它就用一个字来改变标签的产出。这个字叫做参数 而且它指示模板标签来做 或者 得到一些东西。在这种情况下，指示说明是得到名称来显示站点的名称。
模板标签the_title()显示了文章的标题，通常在你的文章的上方。这个标签得到文章的标题并且显示了标题，默认情况下，它在参数中也有一个do，可以帮助你改变文章标题的外观和显示。
默认情况下，标题看起来像这个：
<?php the_title(); ?>
结果看起来像这个东西：
如果你想加上一些参考来以某种方式突出标题，像一个图形或者字符体像一个箭头符号或者bullet符号。让我们放进一个日元符号，&日元;，日本钱的标记，放到我们的标题的前面。
如果你仔细看了标签the_title()的指示说明，你就会看到参数是：
<?php the_title('before', 'after', display); ?>
我们想将日元的标记放到标题的前面，在日元标记的后面和标题的前面都有一个空格，让我们把它添加到参数上：
<?php the_title('¥ '); ?>
当网页产生了，这个看起来就像：
现在，我们再深入地看看这个，并且在文章标题的后面再添加一些东西。加入你想鼓励人们阅读，那么我们添加一个小的激励的箭头( » ) 来激发他们。
<?php the_title('¥ ', ' »'); ?>
注意，我们在箭头标记的前面添加了一个空格，当网页可以浏览的时候，箭头标记与文章标题便分开了。
你也可以使用许多不同的方式来设计你的标题。下面是使用标题标签的另一个例子。
<h2><?php the_title('Post Title: '); ?></h2>
我们将整个文章的标题放到了一个H2标题中，并且在文章标题的开头添加短语"文章标题"。
注: 虽然标题是这样的，并不是所有的 模板标签 接受论据之前或者之后。查看抄本页面，找你正使用的特别的标签，看看它支持什么样的论据。
布尔书学体系的模板标签
以上的模板标签例子使用简单的参数，用引号和逗号将各自隔开。现在考虑一下Boolean 模板标签的例子，使用布尔数学体系技术将不止一个的参数连接起来。一个常见的布尔数学体系表述使用"and (&)"逻辑来连接参数。 模板标签wp_list_cats()通常能在WordPress工具条或者菜单模板文件中找到。它列出了站点的类别。
<?php wp_list_cats(); ?>
默认情况下，一些模板标签的参数是：
- 所有的 – 显示了所有的分类
- 类别_专栏 – 通过类别 ID的分类
- 类别_顺序 – 以升序的分类
- 列表-将类别设置在一个无顺序的列表上
(<ul><li>)
- optioncount-在每个分类中，没有显示文章的数目
- 隐藏_空的-以前两个参数为基础（选择性的和所有的），不显示没有文章的分类
- use_desc_for_title –使用类别描述作为链接的标题
- 孩子-显示每个列出的类别的孩子（子类别）
An example of this category list might be: 这个分类的一个例子可能是：
- 关于我的生活的故事
- 关于我的家庭的故事
- 我想分享的东西
- 关于WordPress
- 关于写作
- 关于讲故事
- 关于生活的事实和虚构小说
缩进的列表"关于 WordPress", "关于写", 和"关于讲故事" 是母 分类 "我想分享的事情"的孩子或者子类别。默认情况下，这些标题并不是类别的真正的标题，它们是你在管理 > 管理 > 类别面板上设置的类别的描述。
如果你想显示分类的真正的标题，而不是分类的描述，将模板标签改为：
<?php wp_list_cats('use_desc_for_title=0'); ?>
零将参数设置为错误的,取消将描述用作标题。现在类别标题会显示：
- 我生活的故事
- 我的家庭
- 分享
- WordPress
- 写
- 将故事
- 事实与虚构
如果你不想"分享的"子列表出现在你的列表上，你添加的参数就不会显示子列表，显示的参数只显示标题而不是表述，用布尔数学体系"并且"使用&记号标记( & )。
<?php wp_list_cats('use_desc_for_title=0&children=0'); ?>
注意在&记号标记的周围没有空格。所有的参数在一起运行，其中没有任何的空格或者引号，只是在整个参数周围有。现在类别标题显示是：
- 我生活的故事
- 我的家庭
- 分享
- 事实和虚构
另一个例子，如果你想将类别链接显示为类别标题，将列表按名称的字母表顺序分类，显示每个类别中文章的数字，而且只显示类别ID数字3("分享")的孩子（子类别），模板标签看起来就像：
<?php wp_list_cats('sort_column=name&sort_order=asc&optioncount=1&use_desc_for_title=0&child_of=3'); ?>
- 讲故事（21）
- WordPress(23)
- 写（10）
模板标签和Loop
Many of WordPress' template tags work within the WordPress Loop. This means that they are included in the template files as part of the php "loop" that generates the pages the viewer sees based upon the instructions inside of the Loop.
许多的WordPress的模板标签在WordPress Loop中运行。这意味着，它们包含在模板文件里面，作为php "loop"的一部分，产生了网页，以Loop里面的指示为基础，访客可以看。 The WordPress Loop begins with: WordPress Loop的开头是：
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
Template tags that work within the loop must be in the middle area here, before the ending section of the Loop below:
在Loop里面运行的模板标签，必须在这里的中间位置上，在下面的Loop的结尾部分之前：
<?php endwhile; else: ?>
<p><?php _e('Sorry, no posts matched your criteria.'); ?></p>
<?php endif; ?>
<?php endwhile; else: ?>
<p><?php _e('Sorry, no posts matched your criteria.'); ?></p>
<?php endif; ?>
Template tags that need to be inside of the loop include the_content(), the_excerpt(), next_post(), and previous_post(). If the template tag you want to use doesn't have to be within the Loop, like wp_list_cats() and wp_list_pages(), then you can put it anywhere you like, for instance in the sidebar, header, or footer template files.
需要包含在loop里的模板标签包括内容(), 摘录(), 下一篇文章(), 和 上一篇文章()。如果你想使用的模板标签不需要在loop里面，像wp_list_cats() 和 wp_list_pages(),你可以将它放在任何你喜欢的位置，例如在工具条，标题上，或者页脚 t 模板文件。
Learning More About Template Tags
学习更多关于模板标签
This is just a tiny step into learning about the various powerful template tags WordPress uses to generate your website. You can learn more about the different template tags WordPress uses in the following articles and resources.
这只是学习不同的强大的模板标签，WordPress用来制作你的站点的网页的微小的一步。在以下的文章和资源中，你可以学习更多的WordPress使用的不同的模板标签。
Styling Your Template Tags
设计你的模板标签
External Resources
外部资源
Template Tags and The Loop===