libopenstorage.github.io

OpenStorage API Website

This stores the sources and output for https://libopenstorage.github.io. This website is created using gitbook. All sources and markdown files are in the docs directory. The output html created by gitbook is located in w directory.

Environment setup

First, you may need to install npm. Then install gitbook:

$ npm install -g gitbook-cli

To build:

make

To serve locally on http://localhost:4000 while editing, run:

make serve

Generating API Documentation

To generate it, you will need to install protoc-gen-doc

go get -u github.com/pseudomuto/protoc-gen-doc/cmd/protoc-gen-doc

Then type make api to generate the API documentation.

More information

• Gitbook
• Examples gitbook json setup
  • https://github.com/poppy-project/poppy-docs/blob/master/book.json