Theme

namespace 为 theme,主要功用是提供一些 Theme (主题) 常用的逻辑(汇总、简化)。

函数

get_album_docs_data

作用: 相册类型获取文档列表等信息,由于相册类型的模板,在一些设定项、数据获取的逻辑有很多重复的地方,故有此函数。
接受参数: <theme_prefix, album_url_prefix, limit=15>
返回数据类型: dict, 包含两个属性,一个是page_title (字符串), 一个是 docs (list 类型)

theme_prefix: 表示模板的前缀名,比如 waterfall, 从而可以获得指定的site.configs 上 对应的属性配置。
album_url_prefix: 如果是某个相册的详细页面,其 URL 的前缀,比如 foldercategory, 具体由模板本身决定。
limit: 每页的照片数

关于相册类型模板配置项的说明(以 theme_prefix 为 waterfall为例):
waterfall_root: 相册相关数据的根目录所在
waterfall_index_doc_type: 首页时的文档类型, 默认为 image+folder
waterfall_album_doc_type: 相册详细页时的文档类型,默认为 image+folder
waterfall_index_sort: 首页时文档的排序方式,默认为 -date(按时间倒序), 也可以设定为 date
waterfall_album_sort: 相册详细页的文档排序方式,默认为-date,也可以设定为date

说明: 本段提及的文档类型 是字符串类型,可以是postfolderimage的复合,比如多个类型构成的,使用+连接,如folder+image