MallokMallok

Themes内置五套设计

主题决定外观,内容原地不动。

Mallok 自带五套 Liquid 主题。每套主题就是项目里的一个模板目录加一份样式表,部署时打包进 Worker。选一套,在后台调整它的选项,或者自己写一套。

01主题一览

Atelier 展示的是演示站上的真实效果。另外四套是按各主题自己的配色和布局描述绘制的,并标注为示意图。

Atelier 主题在演示站上的截图:一家虚构钛材供应商的首页,包含首屏轮播、产品导航和询价按钮。

Atelier默认

以材料为中心的工业产品目录,B2B 站点的默认起点:产品系列、规格卡片、案例、FAQ,每个产品页都有询价入口。

适合
有产品目录的制造商、供应商和贸易公司
内容类型
页面、产品、产品系列、案例、FAQ、资讯
后台可调选项
首屏标题、段落与徽标、数据亮点、资质认证等
客户端脚本
仅首页有一个已声明、零依赖的轮播脚本(约 4 KB),其余页面都没有脚本。
自带
浅色与深色;英文、中文语言包
配色
#152b40#1748bd#dce4eb#f0f4f8

打开 Atelier 演示站

演示站为只读;其中的企业与内容均为虚构,也不收集询盘。

Field Notes Articles About RSS 2026-08-14Notes on a slower release cycle4 min read2026-07-30What we learned from ten audits4 min read2026-07-02Writing specifications people read4 min read 示意图,非截图

Journal

安静的文章与页面主题:一栏舒适的阅读宽度、日期、可选的阅读时长,没有任何多余的干扰。

适合
博客、随笔、企业动态
内容类型
页面、文章
后台可调选项
强调色、是否显示阅读时长
客户端脚本
无
自带
浅色与深色;英文、中文语言包
配色
#1f2937#1d4ed8#e5e7eb#ffffff
VOL. 12 · TRADE EDITION Subscribe The Gazette MARKETS POLICY LOGISTICS TECHNOLOGY OPINION MARKETS Specialty metals open the week on firmer footing LATEST 01Licence quotas tighten02Sponge prices steady03New mill capacity04Freight index eases The morning wire, 06:30 daily. Subscribe 示意图,非截图

Gazette

行业新闻杂志:衬线报头、带配图的头条、最新报道栏,以及默认指向站点 RSS 的订阅横幅。

适合
行业新闻、市场报告、媒体类站点
内容类型
页面、报道
后台可调选项
报头链接,订阅横幅的标题、文字和链接
客户端脚本
无
自带
浅色与深色;英文、中文语言包
配色
#16171a#a11d33#ebebe8#ffffff
Handbook Guides Reference Changelog Documentation Operator handbook 01Install02Configure03Maintain 1.0Commissioning checklist2.0Routine inspection3.0Troubleshooting faults 示意图,非截图

Manual

认真做文档的主题:居中的首屏、快速上手卡片、指南列表,每篇文章的章节都带编号。

适合
产品手册、操作指南、帮助中心
内容类型
页面、指南
后台可调选项
首屏徽标与标题,帮助框的标题、文字和链接
客户端脚本
无
自带
浅色与深色;英文、中文语言包
配色
#1a1c1e#c2410c#ffedd5#fdf7f2
Studio Work Journal Enquire SELECTED WORK · 2024–2026 Objects, interiors and considered spaces. 01 — FEATURED Harbour pavilion Reading room02Courtyard house03Oak series04 示意图,非截图

Folio

浅色画廊式作品集:超大衬线引言、通栏的精选项目,其余作品以编辑式网格排列。

适合
工作室、设计师、项目展示
内容类型
页面、项目、文章
后台可调选项
引言段落、说明行、咨询链接
客户端脚本
无
自带
浅色与深色;英文、中文语言包
配色
#1c1a17#7a2b33#e3ddd2#faf8f4

02切换主题

改一行源码,重新部署一次。不是点一下就行。

主题是站点 Worker 入口里的构建期选择。更换主题就是改这一行,然后构建、部署——Mallok 的后台会如实告知,而不是放一个假装能热切换的开关。

  • 不迁移内容,不改内容 id,默认也不改任何公开 URL。
  • 新主题没有声明的内容类型,会用它的页面布局渲染;内容和 URL 都保留。
  • 主题开放的选项——标题、颜色、链接——在后台修改,立即生效。
  • 模板随 Worker 打包,静态资源交给 Static Assets;主题不会存进 D1 或 R2。
src/worker/index.ts你生成的站点项目
import { atelier, createMallok, inquiry } from 'mallok/worker';

export default createMallok({
  // One of: atelier, folio, gazette, journal, manual.
  // Or your own, built with defineTheme.
  theme: atelier,
  plugins: [inquiry],
});

03编写主题

声明式设计,构建时即可校验。

第三方主题和内置主题用的是同一份公开的约定,不存在只有官方主题才能用的私有接口。

theme.json

声明主题的内容类型及其字段、开放给后台的选项、语言包,以及用到的客户端脚本。

受限的 Liquid

布局和局部模板使用受限的 Liquid 子集,渲染一份有文档的视图对象。主题里不会运行任意 JavaScript。

以源码分发

把主题目录复制进项目,或从 starter 开始。它会进入你的构建产物,所以请像审查其他上线代码一样审查它。

阅读主题格式文档(英文)

一条命令,部署到你自己的账号。

Mallok 会在你自己的 Cloudflare 账号里创建 Worker、D1 数据库和 R2 存储桶,并把网站部署上去。Mallok 不托管任何东西,也不需要注册 Mallok 账号。

npx mallok create my-site

需要 Node.js 22 及以上,并先执行 wrangler login。加上 --no-deploy 只在本地生成并检查项目,不创建云资源。当前为 0.1 候选版。