拓展阅读

blog-engine-01-常见博客引擎 jekyll/hugo/Hexo/Pelican/Gatsby/VuePress/Nuxt.js/Middleman 对比

blog-engine-02-通过博客引擎 jekyll 构建 github pages 博客实战笔记

blog-engine-02-博客引擎jekyll-jekyll 博客引擎介绍

blog-engine-02-博客引擎jekyll-jekyll 如何在 windows 环境安装，官方文档

blog-engine-02-博客引擎jekyll-jekyll SEO

blog-engine-04-博客引擎 hugo intro 入门介绍+安装笔记

blog-engine-05-博客引擎 Hexo 入门介绍+安装笔记

blog-engine-06-pelican 静态网站生成 官方文档

blog-engine-06-pelican 静态网站生成 windows 安装实战

blog-engine-07-gatsby 建极速网站和应用程序 基于React的最佳框架，具备性能、可扩展性和安全性

blog-engine-08-vuepress 以 Markdown 为中心的静态网站生成器

blog-engine-09-nuxt 构建快速、SEO友好和可扩展的Web应用程序变得轻松

blog-engine-10-middleman 静态站点生成器，利用了现代 Web 开发中的所有快捷方式和工具

前言

由于个人一直喜欢使用 markdown 来写 个人博客，最近就整理了一下有哪些博客引擎。

感兴趣的小伙伴也可以选择自己合适的。

middleman

Middleman 是一个静态站点生成器，利用了现代 Web 开发中的所有快捷方式和工具。

请查看 middlemanapp.com 获取详细的教程，包括 入门指南。

为什么选择 Middleman？

如今，许多网站都是以 API 为基础构建的。

与其将前端和后端打包在一起，不如分别构建和部署，利用公共 API 从后端获取数据并在前端显示。

静态网站非常快速且需要很少的 RAM。独立部署的前端可以直接部署到云端或 CDN。许多设计师和开发人员简单地向客户提供静态的 HTML/JS/CSS。

• 使用 Sass 来实现 DRY 样式表。

• 自带资产管道（WebPack、Babel、Sprockets 或其他任何工具）。

• 使用 ERb 或 Haml 进行简单的模板化。

Middleman 为独立开发者提供了所有这些工具以及许多其他工具。

安装

Middleman 基于 Ruby 构建，并使用 RubyGems 包管理器进行安装。

这些通常已预先安装在 Mac OS X 和 Linux 上。

Windows 用户可以使用 [RubyInstaller] 安装这两者。

对于 Windows 用户，还需要安装 [RubyInstaller-Devkit]。

gem install middleman

入门指南

安装完 Middleman 后，您将可以访问 middleman 命令。

首先，让我们创建一个新项目。在终端中执行：

middleman init MY_PROJECT

这将在 "MY_PROJECT" 目录中创建一个新的 Middleman 项目。该项目包含一个用于配置 Middleman 的 config.rb 文件，以及一个用于存储页面、样式表、JavaScript 和图像的 source 目录。

切换到新项目的目录，并启动预览服务器：

cd MY_PROJECT
middleman server

预览服务器允许您构建站点，通过修改 source 目录中的内容，查看您的更改在浏览器中的反映：http://localhost:4567/

要开始，请按照您通常的方式在 source 目录中构建 HTML、CSS 和 JavaScript。当您准备好使用更复杂的模板时，只需将模板引擎的扩展名添加到文件中，然后开始以该格式编写。

例如，假设我正在 source/stylesheets/site.css 上工作，并且想开始使用 Compass 和 Sass。我会将文件重命名为 source/stylesheets/site.css.scss，Middleman 将自动开始处理该文件为 Sass。对于 CoffeeScript（.js.coffee）、Haml（.html.haml）和任何其他模板引擎，都适用同样的规则。

最后，您会想将项目构建为一个独立站点。从项目目录执行：

middleman build

这将编译您的模板，并输出一个独立站点，可以轻松托管或交付给客户。构建步骤还可以压缩图像，使用 JavaScript 和 CSS 依赖管理，压缩 JavaScript 和 CSS，并运行您选择的其他代码。查看 config.rb 文件，了解可以激活的一些常见扩展。

了解更多

官方网站上提供了一整套深入的指南，详见：http://middlemanapp.com。

此外，最新生成的代码文档可以在 [RubyDoc] 上找到。

社区

官方社区论坛位于：http://forum.middlemanapp.com

Bug 报告

我们使用 Github Issues 来管理 bug 报告和功能请求。如果遇到问题，请搜索问题并提交新问题：https://github.com/middleman/middleman/issues

获得快速响应和快速修复您的 bug 的最佳方法是提交详细的 bug 报告，包括测试案例，并及时回复开发人员的问题。如果您了解 Ruby，您还可以提交包含 Cucumber 功能的 Pull Requests，描述您的功能应该如何工作或利用您提交的 bug。

如何运行 Cucumber 测试

1. 检出存储库：git clone https://github.com/middleman/middleman.git
2. 安装 Bundler：gem install bundler
3. 在项目根目录内运行 bundle install 安装 gem 依赖项。
4. 运行测试案例：bundle exec rake test