Minimal Mistakes：把 Jekyll 博客做成可扩展的双栏主题
:triangle_ruler：用於建立個人網站、部落格、專案文件或作品集的 Jekyll 主題。
秒懂
- 它是什麼？
- 一个以主题 gem 形式分发的 Jekyll 主题，提供 GitHub Pages 兼容性、响应式布局、皮肤、导航、搜索和多种内容组件。
- 適合誰用？
- 适合已经采用 Jekyll、希望从现成布局和配置扩展个人站点或博客的维护者。它的关键前置条件是保留 jekyll-include-cache 插件并同步检查 Gemfile 与 _config.yml；主题的具体效果应在目标 Ruby、Jekyll 和 GitHub Pages 环境中构建预览后判断。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 8 天前。
- 用什麼語言寫的？
- 主要是 HTML（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
主题提供的内容 · mmistakes-minimal-mistakes-deep-analysis
Minimal Mistakes 是一个两栏 Jekyll 主题，适用于个人站点、博客和作品集。README 将其风格描述为刻意极简，以便站点所有者自行增强和定制。主题自带响应式布局选项，包括单一布局、归档索引、搜索、启动页和分页首页。它支持页眉图像、自定义侧边栏、目录、图库、相关文章、面包屑链接和导航列表。它还内置了对 Disqus、Facebook、Google+、Discourse、Staticman、utterances 和 giscus 等评论系统的支持，以及通过 Google Analytics 和 Swetrix 进行统计的功能。界面文本本地化为 30 多种语言，默认语言为英语。主题利用 Jekyll 内置的 Sass/SCSS 预处理器，用户无需脱离 Jekyll 工具链即可调整样式。
專案核對 0：請在 mmistakes-minimal-mistakes-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。
外观与视觉变体 · mmistakes-minimal-mistakes-deep-analysis
README 列出了默认外观之外的 11 种命名外观：air、contrast、dark、dirt、mint、sunrise、aqua、neon、plum、catppuccin_latte 和 catppuccin_mocha。每种外观都会改变主题的配色。README 没有说明选择外观的具体配置键；这需要查阅主题的单独文档。主题还使用 Jekyll 内置的 Sass/SCSS 预处理器，允许在预设外观之外进行更深入的样式修改。README 特别指出，样式本应被用户增强和定制，因此默认外观有意保持精简。
專案核對 1：請在 mmistakes-minimal-mistakes-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。
安装方式 · mmistakes-minimal-mistakes-deep-analysis
README 描述了三种安装路径。基于 gem 的方法需要在 Gemfile 中添加 gem "minimal-mistakes-jekyll"，运行 bundle，并在 _config.yml 中设置 theme: minimal-mistakes-jekyll。远程主题方法适用于 GitHub Pages：使用 github-pages gem，将 jekyll-include-cache 添加到 plugins 数组，运行 bundle，并在 _config.yml 中设置 remote_theme: "mmistakes/minimal-mistakes@4.28.0"。第三种方法是直接 fork 或复制所有主题文件到项目中。无论采用哪种方法，主题都要求安装 jekyll-include-cache 插件；否则构建会报错，提示 "Unknown tag 'include_cached'"。README 在开头附近对此给出了警告。
專案核對 2：請在 mmistakes-minimal-mistakes-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。
配置与文档 · mmistakes-minimal-mistakes-deep-analysis
README 指向主题文档网站 https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/，那里有关于配置、定制和内容迁移的详细说明。它还链接了一个远程主题起始仓库，可以从模板直接生成新的 GitHub Pages 站点。README 本身没有列出完整的配置项；这些信息都在文档站点上。用户需要阅读文档来了解如何设置导航、侧边栏、SEO 和其他选项。README 还提到了 CHANGELOG 文件，用于查看更新内容。
專案核對 3：請在 mmistakes-minimal-mistakes-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。
演示内容与源码结构 · mmistakes-minimal-mistakes-deep-analysis
仓库中的 /docs 目录同时包含文档页面和演示站点。演示站点展示了带页眉图像的帖子、包含 HTML 标签和格式的帖子、语法高亮帖子、带图库的帖子、示例集合页面、分类归档和标签归档。README 中提供了这些示例的链接。演示和文档的源文件都位于 /docs 下，贡献者可以查看主题如何处理每种布局。演示站点还提供了按年份归档的额外示例帖子。
專案核對 4：請在 mmistakes-minimal-mistakes-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。
贡献与开发 · mmistakes-minimal-mistakes-deep-analysis
README 邀请用户提交 issue 或 pull request 来报告 bug 和拼写错误。首次贡献者被引导阅读 GitHub Flow。开发流程从运行 bundle install 开始。要测试修改，运行 bundle exec rake preview 并在浏览器中打开 http://localhost:4000/test/；该服务器使用 test/ 目录中的内容，并在修改后重新生成。Pull request 应针对 master 分支提交。README 建议给分支起有意义的名称，并在 pull request 中描述功能或修复内容。
專案核對 5：請在 mmistakes-minimal-mistakes-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。
许可证与包含的组件 · mmistakes-minimal-mistakes-deep-analysis
Minimal Mistakes 以 MIT 许可证发布，版权归 Michael Rose 及贡献者所有（2013-2024）。许可证允许使用、复制、修改、合并、出版、分发、再许可和销售，但必须包含版权声明。软件按"原样"提供，不附带任何保证。主题还包含多个第三方资源：来自 The Noun Project 的图标（CC BY 3.0 US）、Font Awesome（SIL OFL 1.1 和 MIT）、Unsplash 的照片，以及 Susy、Breakpoint、FitVids.js、Magnific Popup、Smooth Scroll、Gumshoe、jQuery throttle/debounce、GreedyNav.js、Jekyll Group-By-Array、基于 Liquid 的目录、Lunr 和 clipboard.js 等库。每个组件在 README 中均列出了其各自的许可证。
專案核對 6：請在 mmistakes-minimal-mistakes-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。
編輯結論
适合已经采用 Jekyll、希望从现成布局和配置扩展个人站点或博客的维护者。它的关键前置条件是保留 jekyll-include-cache 插件并同步检查 Gemfile 与 _config.yml；主题的具体效果应在目标 Ruby、Jekyll 和 GitHub Pages 环境中构建预览后判断。
社群筆記