whiteboard - 简化编写漂亮API文档的项目
Whiteboard
whiteboard - 简化编写漂亮API文档的项目.
这个项目源于流行的Slate API文档工具的一个分支。因为用到了ruby,所以初始化Slate相当麻烦,而这个项目基于NodeJS开发。
Check out a Whiteboard example API documentation.
Getting Started with Whiteboard
Prerequisites
You're going to need:
Yes, that's it!
Getting Set Up
- Clone this repository to your hard drive with
git clone https://github.com/mpociot/whiteboard.git
cd whiteboard
- Install the dependencies:
npm install
- Start the test server:
npm start
Now go ahead and visit http://localhost:4000 and you will be presented with a beautiful example API documentation as a starting point.
Go ahead and modify the markdown file at source/index.md
to suit your needs.
Publishing your API documentation
The easiest way to publish your API documentation is using this command within your whiteboard
directory:
npm run-script generate
This will generate a public
folder which you can upload anywhere you want.
Windows users: You need to install the global
hexo-cli
package usingnpm install -g hexo-cli
. To publish your API documentation under windows usehexo generate
.
If you want other (more automated) deployment options like git, heroku, rsync or ftp - please take a look at the Hexo deployment documentation.
Slate compatibility
Since both Whiteboard and Slate use regular markdown files to render the API documentation, your existing Slate API documentation should work just fine. If you encounter any issues, please submit an issue.
In depth documentation
For further documentation, read the Slate Wiki or the hexo documentation.
Documentations built with Whiteboard
None yet - Feel free to submit a PR with a link to your documentation.
Contributors
Slate was built by Robert Lord while at TripIt.
Whiteboard was built by Marcel Pociot.