recent articles (zh-tw)
From Textpattern CMS User Documentation
Contents |
類型
recent_articles 為 單一標籤，此標籤會產生一份最近發表的文章連結列表
應用在頁面樣板或資訊欄裡。
語法
recent_articles 標籤的語法結構如下...
<txp:recent_articles />
屬性
此標籤接受下列的屬性 (註：屬性 區分大小寫)：
label="label text"- 列表上方的標語文字。沒有預設值。
labeltag="labeltag text"- 包覆標語的標籤名稱。沒有預設值。
limit="integer"- 最新文章連結列出的筆數。預設為
10。
break="tag text"- 用以分隔各項目的 HTML 標籤名稱，不包含左右單尖號。沒有預設值。
wraptag="wraptag text"- 用以包覆列表的 HTML 標籤名稱，不包含左右單尖號。沒有預設值。
category="category name"- 選擇可用的文章分類。
sort="sort option"- (請見下文)
sortdir="desc 或 asc"- asc 順序排列 :: desc 逆序排列。
class="class name"- CSS class，預設為
recent_articles。
屬性說明
- label: 附加在最上方的標語。當使用列表標記的時候（
"wraptag"是"ol"或"ul"），"label"會成為這份列表的第一個項目。 - break: 各項目之間的分隔標籤。建議使用
"br"或"hr"，如果比較喜歡列表標記，可使用"li"代替。但須注意，Textpattern 裡每個區段都必須使用正確的巢狀格式。NB: 選擇li作為分隔標籤時，wraptag 需要設成ulorol，反之亦然。 - wraptag: 包覆整分列表的標籤。建議使用
"p"，列表標記使用"ol"或"ul"。NB: 不支援如class、style或start等等額外的屬性。 - sort: 使用方式就像 SQL 查詢子句
order by一樣。以 txp_link 資料表為例，它的任何一個欄位名都可指定 。要指定排序方式，後面可跟著 SQL sort order 排序關鍵字asc(順序、由上至下、第一個到最後一個) 或desc(逆序、由下至上、最後一個到第一個)。某些標籤的排序可使用url，linkname desc，description asc，date asc，rand()等。
範例
範例 1: 列出最近發表的 5 篇文章連結
<txp:recent_articles label="Latest and Greatest" limit="5" />
範例 2: 以指定的規則列出最近發表的 10 篇文章連結
<txp:recent_articles label="Latest" limit="10" break="br" wraptag="p" category="Code" sortby="Section" sortdir="desc" />
譯：會列出分類 "Code" 下最近發表 10 筆文章，依版區逆序排序
範例 3: 以自訂樣式列出最近發表的文章連結
<txp:recent_articles label="Recently" limit="10" break="li" wraptag="ul" />
樣式表可以這樣設定
.recent_articles
{
list-style-type:none;
}
