Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including gitbook-cli with all npm packages installed. Try it out:

var gitbookCli = require("gitbook-cli")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

gitbook-cli v2.3.2

CLI to generate books and documentation using gitbook

gitbook-cli

NPM version Linux Build Status Windows Build status

The GitBook command line interface.

Install this globally and you'll have access to the gitbook command anywhere on your system.

$ npm install -g gitbook-cli

Note: The purpose of the gitbook command is to load and run the version of GitBook you have specified in your book (or the latest one), irrespective of its version. The GitBook CLI only support versions >=2.0.0 of GitBook.

gitbook-cli store GitBook's versions into ~/.gitbook, you can set the GITBOOK_DIR environment variable to use another directory.

How to install it?

$ npm install -g gitbook-cli

How to use it?

Run GitBook

Run command gitbook build, gitbook serve (read GitBook documentation for details).

List all available commands using:

$ gitbook help

Specify a specific version

By default, GitBook CLI will read the gitbook version to use from the book configuration, but you can force a specific version using --gitbook option:

$ gitbook build ./mybook --gitbook=2.0.1

and list available commands in this version using:

$ gitbook help --gitbook=2.0.1

Manage versions

List installed versions:

$ gitbook ls

List available versions on NPM:

$ gitbook ls-remote

Install a specific version:

$ gitbook fetch 2.1.0

# or a pre-release

$ gitbook fetch beta

Update to the latest version

$ gitbook update

Uninstall a specific version

$ gitbook uninstall 2.0.1

Use a local folder as a GitBook version (for developement)

$ gitbook alias ./mygitbook latest

Metadata

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free