您可以使用显示文章简码向不同的页面添加博文列表。您可以使用参数按照分类或标签显示特定文章。

简码是专为 WordPress 设计的小段代码，您可以使用这些代码为您的站点或博客添加各种功能。您可以在此处查看有关简码的更多信息。

---

以下是您可能想要使用显示文章简码的几个原因。

• 您想要在主页上显示文章的简短列表，而且您的主题不含推荐文章选项，或该选项没有按照您希望的方式显示文章。
• 您想在您的站点上创建一个作者页面，其中带有作者简介和他们最近发表的一些作品。
• 您想在某页面上突出显示特定文章，例如通告。
• 您要向边栏或页脚中的小工具添加特定文章列表。
• 等等。

---

以下说明适用于编辑页面、文章或文本小工具。添加以下代码后，您只会在编辑器中看到代码占位符。但是当您发布页面后，您会看到简码结果。

新文章和现有文章的更新最多可能需要一个小时才能在您使用此简码的所有位置显示。

默认情况下，显示文章简码将显示 10 篇最新文章的项目符号列表。您可以定制文章数量及风格，也可以定制列表中显示的文章要素（标题、精选图片、摘要等等）。

---

参数用来定制文章的显示方式。以下是您可以添加到显示文章简码的常用参数列表，以及添加参数后简码显示方式示例。

author
指定文章作者
默认：空
示例：[display-posts author="bill"]

category
指定分类数据域（或以逗号分隔的分类数据域列表）。在此示例站点上查看实际使用的简码。
默认：空
示例：[display-posts category="fishing,hiking"]

date_format
include_date 为 true 时，指定使用的日期格式。有关详细信息，请参阅 Codex 上的设置日期和时间格式。
默认：'(n/j/Y)’
示例：[display-posts include_date="true" date_format="F j, Y"]

id
指定要显示的特定文章 ID（或多个文章 ID）。
默认：空
示例：[display-posts id="9, 10"]

image_size
如果文章有图片，请指定显示特色图片时使用的图片尺寸。image_size 可以设置为 thumbnail、medium、large（均在“设置”>“媒体”下设置）。
默认：空
示例：[display-posts image_size="thumbnail"]

如果您使用的主题支持内容选项，且您已将其设置为不在页面上显示推荐图片，则 image_size 参数也不会对站点页面上使用的简码产生影响，推荐图片不会在通过简码添加的文章中显示，即使简码指示需显示也是如此。

include_content
在标题后包括完整的文章内容。
默认：空
示例：[display-posts include_content="true"]

include_date
在文章标题后包含文章的日期。默认格式为 (7/30/12)，但您可以使用“date_format”参数进行定制设置。
默认：空
示例：[display-posts include_date="true"]

include_excerpt
在标题后包含文章的摘要（以及日期，如果提供）。
默认：空
示例：[display-posts include_excerpt="true"]

offset
跳过的文章数
默认：0
示例：[display-posts offset="3"]

order
指定文章是按降序 (DESC) 还是升序 (ASC) 排列。
默认：DESC
示例：[display-posts order="ASC"]

orderby
指定文章的排序方式。点击此处查看可用参数。
默认：日期
示例：[display-posts orderby="title"]

portfolio_type
如果您使用的是“文件夹”文章类型，请使用此简码从特定的文件夹类型中获取文章。

post_parent
显示特定页面的子页面。您可以指定 ID 或“current”，显示当前页面的子页面。
默认：空
示例：[display-posts post_type="page" post_parent="8"]

post_status
显示与特定文章状态相关联的文章
默认：发布
示例：[display-posts post_status="publish, future"]

post_type
指定要使用的文章类型。您可以使用默认类型（文章或页面）。如果是文件夹，请使用“jetpack-portfolio”。同样，如果是褒奖页面，请使用“jetpack-testimonial”。
默认：文章
示例：[display-posts post_type="page"]

posts_per_page
要显示的文章数。
默认：10
示例：[display-posts posts_per_page="5"]

tag
指定标签别名（或标签别名的逗号分隔列表）
默认：空
示例：[display-posts tag="tag1, tag2"]

taxonomy、tax_term 和 tax_operator
使用这些参数进行高级分类查询。针对您要查询的分类使用“taxonomy”，针对要包括的术语数据域（或术语）使用“tax_term”，并使用“operator”更改查询使用这些术语的方式（最大的可能是不需要此字段）。
默认：’taxonomy’ = empty , ‘tax_term’ = empty , ‘tax_operator’ = ‘IN’
示例：[display-posts taxonomy="color" tax_term="blue, green"]

wrapper
应使用哪种类型的 HTML 显示列表。可以是无序列表 (ul)、有序列表 (ol) 或分区 (div)，您可以设计自己的风格。
默认：ul
示例：[display-posts wrapper="ol"]

---