主题开发
主题开发
你可以创建自定义主题来定制站点外观。
主题目录结构
themes/<your-theme>/
├── layout.html # 基础布局模板
├── home.html # 首页模板
├── list.html # 列表页模板
├── detail.html # 详情页模板
└── assets/ # 静态资源
└── style.css
模板语法
主题使用 {{placeholder}} 语法进行内容替换。
简单变量
<h1>{{title}}</h1>
<p>{{content}}</p>
条件块
使用 {{#key}}...{{/key}} 包裹条件内容:
{{#has_date}}
<span>{{date}}</span>
{{/has_date}}
可用变量
| 变量 | 使用位置 | 说明 |
|---|---|---|
{{title}} | 所有模板 | 页面标题 |
{{content}} | layout, detail | 页面正文 HTML |
{{styles}} | layout | CSS 样式 |
{{nav_html}} | layout | 侧栏导航 |
{{articles_html}} | home, list | 文章列表 HTML |
{{pagination_html}} | list | 分页导航 HTML |
{{tags_html}} | detail | 标签链接 |
{{breadcrumb_html}} | list, detail | 面包屑导航 |