gorm/gitbook/docs/setup.md
2016-02-26 22:05:59 +08:00

1.3 KiB
Raw Blame History

Setup and Installation of GitBook

Getting GitBook installed and ready-to-go should only take a few minutes.

GitBook.com

GitBook.com is an easy to use solution to write, publish and host books. It's best and easier solution for publishing your content and collaborate on it.

It integrates well with the GitBook Editor.

Local Installation

Requirements

Installing GitBook is easy and straight-forward, but there are a few requirements youll need to make sure your system has before you start.

  • NodeJS (v4.0.0 and above are adviced)
  • Windows, Linux, Unix, or Mac OS X
Install with NPM

The best way to install GitBook is via NPM. At the terminal prompt, simply run the following command to install GitBook:

$ npm install gitbook-cli -g

gitbook-cli is an utility to install and use multiple versions of GitBook on the same system. It will automatically install the required version to build a book.

Using pre-releases

gitbook-cli makes it easy to install and test other versions of GitBook with your book:

$ gitbook install beta
Debugging

You can use the options --log=debug and --debug to get better error messages (with stack trace). For example:

$ gitbook build ./ --log=debug --debug