# gitbook-plugin-ck-theme

**Repository Path**: ckttty/gitbook-plugin-ck-theme

## Basic Information

- **Project Name**: gitbook-plugin-ck-theme
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-12-29
- **Last Updated**: 2022-11-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# gitbook-plugin-ck-theme


This is a plugin for Gitbook that uses the comScore color scheme.

Add to a Gitbook by including the following in `book.json`.

``` json
{
"plugins": [
        "ck-theme"
    ]
}
```

Then run the following script:
``` bash
npm i -g gitbook-cli // maybe need sudo permission
gitbook install
```

## How GitBook plugin works?

A plugin for GitBook is a node package that can be published on [NPM](http://www.npmjs.org).

### package.json

#### name

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

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

#### engine

The package.json should contain a `engine` field using [the standard norm](https://www.npmjs.org/doc/json.html#engines).

```
"engines": {
    "gitbook": "*"
}
```

### entry point

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

#### "book"

Type: `Object`
Default value: `{}`

#### "book.assets"

Type: `String`
Default value: `null`

Path to the assets folder to copy

#### "book.js"

Type: `Array`
Default value: `[]`

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

#### "book.css"

Type: `Array`
Default value: `[]`

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

#### "book.html"

Type: `Object`
Default value: `{}`

Map of position -> code, html snippets to add to each page. The code could be a fucntion.

#### "book.templates"

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

#### "hooks"

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 everything is finished

Each hook can return a promise.