说明
该标签显示已经被格式化以供用在RSS订阅中的、当前文章的内容。如果用户没有为文章提供摘要(在文章编辑界面下方的摘要字段中填写摘要),WordPress会自动截取文章的前55个单词作为摘要。该标签必须在WordPress主循环(loop)。
关于对输出内容的进一步控制,请见the_content_rss()。
用法
<?php the_excerpt_rss(); ?>
参数
该标签无参数。
注意:下文中介绍了WP 1.2版本时该标签可接收的参数。
示例
显示文章摘要,若无摘要显示正文前120个单词,供RSS订阅使用。
<description><?php the_excerpt_rss(); ?></description>
WP 1.2版本
WordPress 1.5之后,该标签不接收任何参数。下面是WP 早期版本——1.2版中该标签的相关信息。
WP 1.2用法
<?php the_excerpt_rss( $cut, $encode_html ); ?>
WP 1.2参数
$cut
(整数)结束内容前所显示的内容字数。该参数值可为任何数字。
encode_html
(整数)定义html标签过滤与特殊字符(如'&')编码。可用值包括:
- 0 ——(默认)为编号的“url脚注”解析链接
- 1 —— 用PHP函数htmlspecialchars()进行过滤,也会将cut参数设为0,因此不推荐在使用cut参数时以1作为encode_html的值
- 2 —— 去除html标签,用'&' 代替其HTML字符串实体(&)。使用cut参数时,encode_html的默认值为2。
分类:中文手册