Node.js下使用API Blueprint格式写API文档的工作环境

API Blueprint使用md文档的格式，快速书写API文档，并且可以通过文档生成便于查看的HTML文档（使用aglio），也可以生成测试用的Mock服务器（使用Drakov）。

文档书写格式，请查看API Blueprint。一些文档书写例子，请查看https://github.com/apiaryio/api-blueprint/tree/master/examples

需要Node.js环境

$ git clone https://github.com/ihahoo/node-apiblueprint.git
$ npm install

通过src/index.md来写文档，运行下面的命令，可以以网页形式时时查看文档。

$ npm run doc

然后通过浏览器打开https://localhost:3000/即可查看文档，修改文档的同时可以自动刷新显示。

可以按照API Blueprint的文档格式，自动生成测试api的数据。这样描述好API文档后，前端即可进行一些调用测试。 执行以下命令：

$ npm run mock

然后通过https://localhost:3001/测试接口，在本例子中，可以通过GET https://localhost:3001/test 查看测试的接口样例。

$ npm run build

通过此命令，可将文档转换为html并保存到build目录下，即可将文档提交给其它开发人员查阅。

$ npm run clean