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

Question

我经历了以下步骤:

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

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

4. 安装这些 Go 模块:

5. 去获取 bitbucket.org/pkg/inflect

6. 去获取 github.com/hashicorp/go-version

7. 去获取 github.com/russross/blackfriday

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

9. 运行 html 生成器:

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

   去运行 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

这应该可以满足您的所有需求。