CircleCI
swagger
asciidoc

swagger.json を 静的html やPDFに変換するCircleCI 2.0 workflow

swagger.json を ドキュメント化して参照したいけどSwagger UIは使わない(運用したくない)。S3などで静的なHTMLサイトとして配信して楽したい。

https://github.com/nikushi/test-swagger-json-to-static-html

は circle yml のexample。

CircleCIのビルドパイプライン(workflow)でswagger.json -> asciidoc -> html -> S3 upload の順にビルドする流れ。git push してほったらかすといい感じドキュメントが仕上がる。

htmlではなくPDFなど他のフォーマットで生成するときは asciidoctor の引数を変更すればOKそう。

それぞれ dockerimage が用意されていたので簡単だ。