顯示的內容型別（Content Type to Display）

(content)

可用的值：

• titles — 在部落格頁面中僅顯示標題。
• excerpts
   — 為美國部落格顯示短摘要。如果部落格有包含摘要巨集，那麼部落格頁面巨集將會顯示部落格摘要中的內容。如果部落格沒有摘要巨集，那麼部落格頁面將會顯示部落格的前幾個句子。
• entire - 為每一個部落格顯示完整的內容。

指定 Confluence 在部落格中查詢的時間範圍。

可用的值：

• m — 分鐘
• h — 小時, 如果你指定為 '12h' 的話，那麼將會顯示最新 12 個小時新增的部落格。
• d — 天，如果你指定為 '7d' 的話，那麼將會顯示部落格最新七天的部落格。
• w — 周

通過標籤過來結果。巨集將會僅僅顯示包含有你指定標籤的部落格，換句話說就是按照標籤過濾。

你可以通過逗號分隔符來指定一個或者多個標籤。

• 如果你希望擴充套件標籤的的匹配內容，你可以在標籤名字前加一個橫線（-）。例如：如果你指定一個標籤的名字為 -badpage 那麼你將會找到所有沒有標記為 'badpage' 標籤的頁面。
• 如果你希望某一個頁面必須包含有某一個標籤值，你需要在標籤值之前加一個加號（+）。例如：如果你指定一個標籤 +superpage，+goodpage 你將會找到頁面至少包含有 2 個標籤，而且這些頁面的標籤中都包含有字元 'superpage' 和 'goodpage'。

作者限制（Restrict to theseAuthors ）

(author)

空間限制（Restrict to these Spaces）

(spaces)

這個引數允許你通過空間過濾內容。如果這個引數被使用的話，將會顯示你指定空間中的部落格頁面。

你可以通過逗號分隔符來指定一個或者多個空間。

• 如果希望不包含某一個空間，可以在空間名前面加一個橫線（-）。例如：如果你不希望包含有一個空間 BADSPACE，那麼你可以使用 -BADSPACE 定義。
• 如果希望你的結果必須從某一個空間裡面來，那麼你可以在空間名字的前面加一個加號（+）。例如：如果你指定一個空間名字為 +GOODSPACE ，你將會僅僅得到從 GOODSPACE 中來的內容。（請注意：這個功能不是必須的，因為每一個部落格必須得屬於一個空間。如果這個加號標記在一個空間名字前同時也在其他空間名字前面，那麼這個標記將會被忽略）。

特殊值：

• @self — 當前空間
• @personal — 所有的個人空間
• @global — 所有的站點空間
• @favorite — 所有你標記為關注的空間
• @favourite — 與上面 @favorite 是一樣的
• @all — Confluence 站點的所有空間
• * — 與上面 @all 是一樣的

當你指定一個個人空間的時候，請記住在個人空間名字前加一個波浪符（~）例如 ~jblogs 或者 ~jbloggs@example.com 。

部落格頁面的最大數量（Maximum Number of Blog Posts）

(max)

指定結果如何被排序。如果這個引數沒有被指定的話，那麼將會按照內容的建立時間採用降序的方式進行排序（最新的在前面）。

值：

• title — 按照標題字母排序
• creation — 按照內容被新增的時間進行排序
• modified — 按照內容被最後修改的時間進行排序

選擇將排序從降序切換到升序（最老的在前面）。與引數 排序方式（Sort By）結合使用，如果你不指定排序方式的話，這個引數將會被忽略。

在儲存格式和 Wiki 格式中，可以使用邊欄 true 來啟用排序方式。

{blog-posts:content=titles|spaces=@self,ds|author=jsmith|time=4w|reverse=true|sort=creation|max=10|label=chocolate,cookies}