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 的前缀,比如 folder
或 category
, 具体由模板本身决定。
limit: 每页的照片数
关于相册类型模板配置项的说明(以 theme_prefix 为 waterfall
为例):
waterfall_root: 相册相关数据的根目录所在
waterfall_album_sort: 相册详细页的文档排序方式,默认为-date
,也可以设定为date
。
说明: 本段提及的文档类型
是字符串类型,可以是post
、folder
、image
的复合,比如多个类型构成的,使用+
连接,如folder+image
。