使用apiblueprint使用md文件和模板文件生成output.html时，生成的文件为空

Question

我经历了以下步骤：

1. 安装go并将$ GOPATH env变量添加到新的空目录。
2. 安装snowcrash。根据apiblueprint解析降价文件 规格。

3. 安装mercurial。在使用自制软件的Mac上：brew install hg

4. 安装这些Go模块：

5. go get bitbucket.org/pkg/inflect

6. go get github.com/hashicorp/go-version

7. go get github.com/russross/blackfriday

8. 将此repo的生成器目录符号链接到$ GOPATH / src / generator

9. 运行html生成器：

   一个。 cd $GOPATH/src/generator/main

   湾go run main.go -spec ~/projects/repo/filename.md -template ~/projects/repo/filename.tmpl -out test.html

Answer 1

我建议您查看aglio，这是一个API蓝图渲染器，可以将您的API蓝图渲染为HTML。

$ npm install -g aglio
$ aglio -i input.apib -o output.html

这应该做你需要的一切。