You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2.1 KiB
2.1 KiB
| title | description |
|---|---|
| 模板路由 | 本文档介绍路由与模板的映射关系，以及自定义模板。 |
此文档讲解系统内部提供的路由与模板映射。
主要模板
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.yaml 的 spec 节点下添加如下配置：
customTemplates:
{type}:
- name: {name}
description: {description}
screenshot: {screenshot}
file: {file}.html
示例：
customTemplates:
post:
- name: 文档
description: 文档类型的文章
screenshot:
file: post_documentation.html
字段说明：
type：模板类型，目前支持postpagecategory。name：模板名称description：模板描述screenshot：模板预览图file：模板文件名，需要在/templates/目录下创建
最终使用者即可在文章设置、独立页面设置、分类设置中选择自定义模板。
:::info 提示
- 自定义模板与默认模板的功能相同，区别仅在于可以让使用者选择不同于默认模板风格的模板。
- 自定义模板的文件名需要以
.html结尾，且需要在/templates/目录下创建。
:::