How to generate API documentation locally

January 17, 2017 ยท View on GitHub

You can generate documentation a couple ways:

Apiary Client

Apiary Client needs Ruby to run.

You can install the Apiary Client by running:

gem install apiaryio

You can now run the server:

apiary preview --path=blueprint/api.apib --server

This runs an Apiary CLI server on port 8080. You can visit the documentation by visiting localhost:8080 in your browser. Just refresh the page whenever you make changes to the documentation file at /blueprint/api.apib.

Atom

If you're developing with Atom, you can also use the API Blueprint Preview package to preview your blueprint changes in realtime.