页面模式¶
三种页面形态由 front-matter 的 layout 决定,生成器产出的页面(index / category / tag / archive)
layout 不一定有值,主题会用 __index、is_home() 兜底。
layout |
形态 | 侧边栏 |
|---|---|---|
home |
全宽个人主页 | 无 |
page |
常规页(关于、作品集…) | 无 |
未指定 / wiki |
常规页 | 有 |
post |
笔记正文 | 有 |
任意页面都可以用 front-matter 强制开关侧边栏:
wiki: true # 强制带目录树
用法示例¶
个人主页:
---
title: Home
layout: home
---
独立页面(无侧边栏):
---
title: About
layout: page
---
让一篇普通页面带上目录树:
---
title: 专题索引
wiki: true
---
模式是怎么决定的¶
layout.ejs 里按这个顺序判断:
page.layout是home/landing→homepage.wiki === true,或layout是notes/index/category/tag/archive, 或page.__index === true,或is_home()/is_post()→wiki- 其余 →
page
模式会写到 <body class="mode-xxx"> 上,样式按这个类名切换;
同时决定侧边栏是否渲染、内容容器是否全宽。