MoPress 是一个面向 MoonBit 生态的现代文档与静态站点生成器,设计上同时参考了 mdBook 与 Hakyll。
如果你只是想快速写一本文档、发布一个博客,你不应该被迫去学习一整套构建系统;但如果你的需求超出了写 Markdown、套模板,你也不应该被工具的边界卡住手脚。MoPress 试图同时兼顾这两种情况,为此提供了两种互不冲突的使用方式:
Book 模式:开箱即用,体验上接近 mdBook。只需要一份
sena.toml配置文件和一堆 Markdown 文件,不需要写任何代码。但同时又拥有许多 mdBook 所不能及的特性,比如多种插件系统、代码注入、自定义模板、frontmatter、AST 变换(即 transformers)等。Site 模式:在
site.mbt中以代码的形式声明规则(Rule)与处理管线(Pipeline),对内容如何被处理、渲染拥有完全的控制权。这一部分的设计思路直接继承自 Hakyll 的可组合编译器(composable compiler)理念。
两种模式共享同一套底层能力(Markdown 解析、模板引擎、外部插件协议等)。事实上,Site 模式旨在通用的静态网站生成器,而 Book 模式是基于 Site 模式的最佳实践示例兼预设了一套书籍文档网站构建流程的开箱即用生成器。
如果你想尽快看到效果,请从 快速开始 开始;如果你已经知道自己要用哪种模式,可以直接跳到 Book 模式 或 Site 模式 章节。