主题

主题

三个官方主题随仓库发布,分别面向博客、文档与作品集。它们既是开箱即用的设计,也是主题契约的参考实现。

ink

ink

参考默认主题

极简博客主题。衬线字体、单栏布局、纸墨质感。包含全套模板、feeds、sitemap、代码高亮与 params 主题化。是学习主题契约的起点。

blogtypographydark mode
man

manual

文档 / 手册

面向文档站点。无衬线字体、顶部搜索栏、页内目录(TOC)、section 导航,并生成 search.json 供客户端搜索。

docsTOCsearch
fol

folio

作品集 / 视觉

面向作品集与视觉展示。粗体展示字、响应式画廊网格、项目卡片,支持 columns 参数调整布局。

portfoliogallerylanding

安装主题

anycms theme install ../themes/ink --root ./my-site

然后在 site.kdl 中启用,并删除 site 自带的 templates/sass/ 让主题接管(见快速开始):

theme "ink"

主题契约速览

每个主题是一个 bundle:theme.kdl manifest(含 engine-versionparams 声明)+ 必需的 templates/ + 可选 static/ / sass/。详见主题文档

本官方网站不使用任何主题——它自带 templates/sass/,完全自包含。这也是一种合法的用法:当你想要完全定制的设计时,直接在 site 内写模板即可。