Sample plugin for GitBook
Last updated 6 years ago by samypesse .
Apache 2 · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install gitbook-plugin 
SYNC missed versions from official npm registry.

GitBook Sample Plugin

This is a sample plugin for GitBook.

Install it using: $ npm install gitbook-plugin

How GitBook plugin works?

A plugin for GitBook is a node package that can be published on NPM.



The package name should begin with gitbook-plugin-. And if your plugin is a theme, it should begin with gitbook-theme-.

Examples: gitbook-plugin-mixpanel, gitbook-plugin-googleanalytics, gitbook-theme-dark


The package.json should contain a engine field using the standard norm.

"engines": {
    "gitbook": "*"

For example if you want your plugin to supports only GitBook version supperior to 0.3.1:

"engines": {
    "gitbook": ">=0.3.1"

entry point

The plugin entry point should return an object with some metadata.


Type: Object Default value: {}


Type: String Default value: null

Path to the assets folder to copy


Type: Array Default value: []

List of javascript file to add to the html pages (relative to the assets fodler).


Type: Array Default value: []

List of css file to add to the html pages (relative to the assets fodler).


Type: Object Default value: {}

Templates to override default templates, only use this option if you want to change entirely how the book is rendered.

This object is a map: "name" -> "file", with names:

  • "site": page for a file from the site format
  • "page": page for the page format


Type: Object Default value: {}

Map of "name" -> Function that needs to be called during build process. With names:

  • "init": just after initialization, before generation
  • "finish": after generation and everuthing is finished

Each hook can return a promise.

Current Tags

  • 0.0.2                                ...           latest (6 years ago)
  • 4.0.0-alpha.6                                ...           pre (3 years ago)

8 Versions

  • 4.0.0-alpha.6                                ...           3 years ago
  • 4.0.0-alpha.5                                ...           3 years ago
  • 4.0.0-alpha.4                                ...           3 years ago
  • 4.0.0-alpha.3                                ...           3 years ago
  • 4.0.0-alpha.2                                ...           3 years ago
  • 4.0.0-alpha.1                                ...           3 years ago
  • 0.0.2                                ...           6 years ago
  • 0.0.1                                ...           6 years ago
Maintainers (1)
Today 1
This Week 3
This Month 3
Last Day 0
Last Week 17
Last Month 58
Dependencies (0)
Dev Dependencies (0)

Copyright 2014 - 2016 © |