Confluence 6.15 博客頁面（Blog Posts）宏參數

參數是讓你能夠用來控制宏的格式和輸出的選項。在 Confluence 存儲格式或者 Wiki 標記（wikimarkup）中使用的參數名與在宏瀏覽器中使用的標籤名是不一樣的，在下面咱們將會用括號列出  （example）。

參數	是不是必須	默認值	說明
顯示的內容類型（Content Type to Display） (content)	No	titles	可用的值： titles — 在博客頁面中僅顯示標題。 excerpts — 爲美國博客顯示短摘要。若是博客有包含摘要宏，那麼博客頁面宏將會顯示博客摘要中的內容。若是博客沒有摘要宏，那麼博客頁面將會顯示博客的前幾個句子。 entire - 爲每個博客顯示完整的內容。
時間幀（Time Frame） (time)	No	無限制	指定 Confluence 在博客中查找的時間範圍。 可用的值： m — 分鐘 h — 小時, 若是你指定爲 '12h' 的話，那麼將會顯示最新 12 個小時添加的博客。 d — 天，若是你指定爲 '7d' 的話，那麼將會顯示博客最新七天的博客。 w — 周
標籤限制（Restrict to these Labels） (label)	No	None	經過標籤過來結果。宏將會僅僅顯示包含有你指定標籤的博客，換句話說就是按照標籤過濾。 你能夠經過逗號分隔符來指定一個或者多個標籤。 若是你但願擴展標籤的的匹配內容，你能夠在標籤名字前加一個橫線（-）。例如：若是你指定一個標籤的名字爲 -badpage 那麼你將會找到全部沒有標記爲 'badpage' 標籤的頁面。 若是你但願某一個頁面必須包含有某一個標籤值，你須要在標籤值以前加一個加號（+）。例如：若是你指定一個標籤 +superpage，+goodpage 你將會找到頁面至少包含有 2 個標籤，並且這些頁面的標籤中都包含有字符 'superpage' 和 'goodpage'。
做者限制（Restrict to theseAuthors ） (author)	No	None	對返回的結果經過做者過濾。博客頁面宏將會僅僅將你指定的做者的博客顯示出來。
空間限制（Restrict to these Spaces） (spaces)	No	@self 例如，在宏中顯示空間包含的頁面。	這個參數容許你經過空間過濾內容。若是這個參數被使用的話，將會顯示你指定空間中的博客頁面。 你能夠經過逗號分隔符來指定一個或者多個空間。 若是但願不包含某一個空間，能夠在空間名前面加一個橫線（-）。例如：若是你不但願包含有一個空間 BADSPACE，那麼你可使用 -BADSPACE 定義。 若是但願你的結果必須從某一個空間裏面來，那麼你能夠在空間名字的前面加一個加號（+）。例如：若是你指定一個空間名字爲 +GOODSPACE ，你將會僅僅獲得從 GOODSPACE 中來的內容。（請注意：這個功能不是必須的，由於每個博客必須得屬於一個空間。若是這個加號標記在一個空間名字前同時也在其餘空間名字前面，那麼這個標記將會被忽略）。 特殊值： @self — 當前空間 @personal — 全部的我的空間 @global — 全部的站點空間 @favorite — 全部你標記爲關注的空間 @favourite — 與上面 @favorite 是同樣的 @all — Confluence 站點的全部空間 * — 與上面 @all 是同樣的 當你指定一個我的空間的時候，請記住在我的空間名字前加一個波浪符（~）例如 ~jblogs 或者 ~jbloggs@example.com 。
博客頁面的最大數量（Maximum Number of Blog Posts） (max)	No	15	指定能夠顯示的的最大結果數量。請注意，在結果顯示的時候，首先會對結果進行排序，而後在對結果輸出的數量進行限制。
排序方式（Sort By） (sort)	No	creation	指定結果如何被排序。若是這個參數沒有被指定的話，那麼將會按照內容的建立時間採用降序的方式進行排序（最新的在前面）。 值： title — 按照標題字母排序 creation — 按照內容被添加的時間進行排序 modified — 按照內容被最後修改的時間進行排序
反向排序（Reverse Sort） (reverse)	No	false	選擇將排序從降序切換到升序（最老的在前面）。與參數 排序方式（Sort By）結合使用，若是你不指定排序方式的話，這個參數將會被忽略。 在存儲格式和 Wiki 格式中，可使用邊欄 true 來激活排序方式。

Wiki markup example

宏名稱： blog-posts

宏內容：None

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

https://www.cwiki.us/display/CONF6ZH/Blog+Posts+Macro