mackerel.sh

是什么

Mackerel 是一个基于 Python 的极简、带类型的静态网站生成器。它的核心目标是把 Markdown 内容文件转换为静态 HTML，并通过 Jinja2 模板实现灵活呈现。典型站点包含 content、templates、mackerelconfig.toml 和构建输出目录 _build，定位更接近轻量博客、项目主页或文档站生成工具。

核心功能与技术栈

从正文看，Mackerel 提供了完整的基础工作流：mackerel init 初始化站点，mackerel build 构建静态文件，mackerel develop 启动本地服务器并在内容或模板变化时实时重建。配置文件采用 TOML，可设置内容路径、模板路径、文件后缀、构建目录、导航和用户自定义字段。内容层支持 Markdown front matter，元数据可包含 title、template、created_at、categories、excerpt 等，并提到支持 drafts、categories 和文章列表。模板使用 Jinja2，可访问当前 document、ctx.user、ctx.nav 以及自动生成的 category_lists。

定价、API 与生态

正文未提到商业定价、云服务或付费功能，安装方式包括 pip、uv、pipx、uvx，说明其主要作为 Python 命令行工具使用。API/SDK 方面未见明确说明，目前可确认的是 CLI 交互。生态集成集中在 Python、Markdown、Jinja2 和 TOML，未看到插件系统、主题市场、CMS、部署平台或 CI/CD 集成信息。

优缺点

优点是学习成本低、目录结构直观、配置清晰，且输出为纯静态 HTML，部署自由度高。本地开发服务器和 live rebuild 对内容编辑很实用。短板在于正文没有说明许可证、源码仓库、社区活跃度和维护策略，也未覆盖搜索、分页、多语言、资源管线、图片处理等更完整的静态站能力。文档以快速入门为主，示例清楚，但深度参考不足。

适合谁与中国访问

它适合熟悉 Python、Markdown、Jinja2 的开发者，用来搭建个人站、轻量博客、项目介绍页或简单文档站。若需要成熟主题生态和复杂内容功能，可比较 Hugo、Jekyll、Eleventy、MkDocs 或 Sphinx。中国访问方面，正文没有提供网络可用性、镜像、支付或托管信息，判断为未知；由于工具可本地安装并生成静态文件，实际使用更依赖 Python 包源与最终部署平台。