Help?

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 需要設成 ul or ol,反之亦然。
  • wraptag: 包覆整分列表的標籤。建議使用 "p",列表標記使用 "ol""ul"。NB: 不支援如 classstylestart 等等額外的屬性。
  • sort: 使用方式就像 SQL 查詢子句 order by 一樣。以 txp_link 資料表為例,它的任何一個欄位名都可指定 。要指定排序方式,後面可跟著 SQL sort order 排序關鍵字 asc(順序、由上至下、第一個到最後一個) 或 desc(逆序、由下至上、最後一個到第一個)。某些標籤的排序可使用 urllinkname descdescription ascdate ascrand() 等。

範例

範例 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;
}
Translations [?]