More than 5 years have passed since last update.

Swiftのドキュメンテーションコメントをjazzyで出力

Last updated at 2016-04-12Posted at 2016-04-12

Swiftのフレームワークを作っていて、コメントからドキュメントを吐き出す必要に迫られたので、いろいろ調べていましたが、Rubyライブラリのjazzyというgemを使えばよさそうだなというところまで辿りつきました。

まずは、Rubyの環境を整えるところから。rbenvを入れるところからです。

$ brew update
$ brew install rbenv ruby-build
 
$ echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
 
$ source ~/.bash_profile
$ rbenv --version

続いて、Rubyのインストール。ここでは2.3.0をインストールしています。インストールは5～10分くらいかかる感じです。

$ rbenv install --list
$ rbenv install 2.3.0

で、インストールしたバージョンの選択。

$ rbenv global 2.3.0

jazzyのインストールは、gemで一発です。

$ sudo gem install jazzy

jazzy --min-acl public --skip-undocumented -o jazzy_doc --swift-version 2.1.1

今回はフレームワークの出力なので、出力レベル(--min-acl)はpublicです。これを指定すると、internalやprivateのメソッドは出力されません。あと、--skip-undocumentedで、ドキュメントのないソースは無視するっぽいです。-oで出力先を指定します。

ここで落とし穴

現場からは以上です。