模板路由#

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

下方列出默认访问路径。用户可以在 Console 的系统设置中修改文章、分类和标签等路由规则，主题不应硬编码这些地址，应优先使用模板变量中的 status.permalink 和分页 URL。

#主要模板

#index.html

站点的首页模板，访问地址包括：

• /
• /index
• /page/:page
• /index/page/:page

#post.html

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

#page.html

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

#archives.html

文章归档页面的模板，访问地址包括：

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

其中 year 必须为 4 位数字，month 必须为 2 位数字，不符合格式的路径不会被匹配。

#tags.html

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

#tag.html

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

#categories.html

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

#category.html

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

#author.html

作者归档页面的模板，访问地址默认为 /authors/:name，分页地址为 /authors/:name/page/:page。页面变量请参考作者归档。

#自定义模板

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

在 theme.yaml 的 spec 节点下添加如下配置：

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/ 目录下创建

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