页面配置
页面配置即定义在 Front Matter 中的变量,除了会用到静态网站生成器预定义与约定俗成的变量之外,本主题也自定义了一些——
资源注入
除了整站共用的个别静态资源会写死在 </head>
与 </body>
前方之外,有些只跟特定布局和页面绑定的静态资源得按需注入,可与设置页面配置默认值的能力相结合:
变量名 | 值类型/可选值 | 说明 |
---|---|---|
ksio_asset_js | string | string[] | 省略扩展名的 JS 文件路径 |
ksio_asset_css | string | string[] | 省略扩展名的 CSS 文件路径 |
布局插槽
主题预置布局模板中部分区域的内容可在外部自定义,这些区域叫做「插槽」:
变量名 | 值类型/可选值 | 说明 |
---|---|---|
ksio_slot_banner | string | 头图 |
ksio_slot_header | string | 头部 |
ksio_slot_title | string | 标题 |
ksio_slot_meta | string | 作者、标签等信息 |
ksio_slot_content | string | 正文 |
ksio_slot_footer | string | 底部,大尺寸设备中视觉上是正文右侧 |
ksio_slot_aside | string | 侧边栏 |
功能开关
变量名 | 值类型/可选值 | 说明 |
---|---|---|
ksio_shareable | boolean | 是否显示分享按钮 |
SEO
影响生成 SEO 相关信息的变量:
变量名 | 值类型/可选值 | 说明 |
---|---|---|
ksio_seo_title | string | 显示在 <title> 中的页面标题,不指定则使用 title |
ksio_seo_role | 'writer' | 'developer' | 根据角色生成特定的页面描述 |