跳到主要内容
版本:2.12.0-SNAPSHOT

模板路由

此文档讲解系统内部提供的路由与模板映射。

主要模板

index.html

站点的首页模板,访问地址为 /

post.html

文章详情页面的模板,访问地址默认为 /archives/:slug

page.html

独立页面详情的模板,访问地址默认为 /:slug

archives.html

文章归档页面的模板,访问地址包括:

  • /archives
  • /archives/:year
  • /archives/:year/:month

tags.html

标签集合页面的模板,访问地址默认为 /tags

tag.html

标签归档页面的模板,访问地址默认为 /tags/:slug

categories.html

分类集合页面的模板,访问地址默认为 /categories

category.html

分类归档页面的模板,访问地址默认为 /categories/:slug

自定义模板

一般情况下,上文提到的模板已经能够满足大部分的需求,但如果需要针对某个特定的页面进行自定义,可以通过自定义模板来实现。目前系统支持为 文章独立页面分类归档 设置自定义模板:

theme.yamlspec 节点下添加如下配置:

customTemplates:
{type}:
- name: {name}
description: {description}
screenshot: {screenshot}
file: {file}.html

示例:

customTemplates:
post:
- name: 文档
description: 文档类型的文章
screenshot:
file: post_documentation.html

字段说明:

  • type:模板类型,目前支持 post page category
  • name:模板名称
  • description:模板描述
  • screenshot:模板预览图
  • file:模板文件名,需要在 /templates/ 目录下创建

最终使用者即可在文章设置、独立页面设置、分类设置中选择自定义模板。

提示
  1. 自定义模板与默认模板的功能相同,区别仅在于可以让使用者选择不同于默认模板风格的模板。
  2. 自定义模板的文件名需要以 .html 结尾,且需要在 /templates/ 目录下创建。