diff options
author | Samy Pessé <samypesse@gmail.com> | 2016-02-26 09:41:26 +0100 |
---|---|---|
committer | Samy Pessé <samypesse@gmail.com> | 2016-02-26 09:41:26 +0100 |
commit | d3d64f636c859f7f01a64f7774cf70bd8ccdc562 (patch) | |
tree | 4f7731f37c3a793d187b0ab1cd77680e69534c6c /docs/setup.md | |
parent | 4cb9cbb5ae3aa8f9211ffa3ac5e3d34232c0ca4f (diff) | |
parent | eef072693b17526347c37b66078a5059c71caa31 (diff) | |
download | gitbook-d3d64f636c859f7f01a64f7774cf70bd8ccdc562.zip gitbook-d3d64f636c859f7f01a64f7774cf70bd8ccdc562.tar.gz gitbook-d3d64f636c859f7f01a64f7774cf70bd8ccdc562.tar.bz2 |
Merge pull request #1109 from GitbookIO/3.0.0
Version 3.0.0
Diffstat (limited to 'docs/setup.md')
-rw-r--r-- | docs/setup.md | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/docs/setup.md b/docs/setup.md new file mode 100644 index 0000000..3ce416e --- /dev/null +++ b/docs/setup.md @@ -0,0 +1,45 @@ +# Setup and Installation of GitBook + +Getting GitBook installed and ready-to-go should only take a few minutes. + +### GitBook.com + +[GitBook.com](https://www.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](https://www.gitbook.com/editor). + +### Local Installation + +##### Requirements + +Installing GitBook is easy and straight-forward, but there are a few requirements you’ll 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 +``` + |