ShowCategory 宏

ShowCategory 宏

一般嵌入到分类页面中，提供更好的分类页面显示。过去分类页面为了显示子分类或者子页面，往往用 FullSearch 宏，效率低下而且界面难看。ShowCategory 宏读取分类索引缓存提高效率，而且采用 MediaWiki 页面样式展示分类。

(!) 分类页面的创建大大简化，一般仅在分类页面中只放入一条 <<ShowCategory>> 语句即可。

用法：

  • <<ShowCategory>>

  • <<ShowCategory(all)>>

  • <<ShowCategory(分类名,参数...)>>

参数

  • (!) 说明：

    • 所有布尔值参数，例如 summary， 可以通过 summary=0 或者 summary=false 或者 nosummary 设置为 False，

      • 可以通过 summary 或者 summary=1 或者 summary=yes 设置为 "真"。

    • 参数也可以缩写，只要不合其它参数的缩写冲突即可。例如 summary 可以缩写为 su，nosummary 可以缩写为 nosu。

    • 下面参数之外的关键字作为分类名称。

    • all 显示所有分类。

    • 如果没有指定分类，使用当前页面名称作为分类。

    • categories

    是否显示子分类。缺省是

    pages

    是否显示分类包含的页面。缺省是

    summary

    是否显示分类说明等信息。缺省是

    capital

    是否显示排序头文字。缺省是

    templates

    是否显示模板文件。缺省否

    ascending|descending

    排序方式是正序还是逆序。缺省为正序

    recursive

    是否递归查找子分类或者分类包含的页面？。缺省否

    sort

    排序方式。缺省为 "title" 即按照标题排序

    • title: 按照标题排序

    • timestamp: 按照时间绰排序

    column

    缺省按照3列显示。

    items

    显示的条目总数

    skipitems

    跳过的条目数

示例：

  • Code

    Description

    <<ShowCategory(CategoryNews)>>

    显示分类 CategoryNews 页面，其中包含 CategoryNews 的子分类和子页面列表。

    <<ShowCategory>>

    显示当前页面的分类说明页面，包含子分类和子页面索引。 <!> 当前页面应该为一个分类页面

    <<ShowCategory(all)>>

    显示所有分类。参见页面：IndexPage

    <<ShowCategory(CategoryNews, nocategories)>>

    仅显示分类 CategoryNews 的子页面，不显示子分类

    <<ShowCategory(CategoryNews, nopages)>>

    仅显示分类 CategoryNews 的子分类，不显示子页面

    <<ShowCategory(CategoryNews, nocat, nosummary)>>

    不显示子分类，也不显示分类说明，仅仅显示子页面列表

    <<ShowCategory(CategoryNews, nocapital,nosum)>>

    不显示分类说明，也不显示排序的题头字母

    <<ShowCategory(CategoryNews, recursive, descending)>>

    递归显示子分类以及子页面，逆序排列

    <<ShowCategory(CategoryNews, rec, cat=0, items=20,skipitems=5,column=2,sort=timestamp)>>

    不显示分类，仅显示子页面，按照页面修改时间排序，跳过前5条记录，总共显示20条，并分两列显示

参考:

相关页面: