@gitbook-ng/gitbook
v3.3.6
Published
Library and cmd utility to generate GitBooks
Downloads
1,721
Readme
@gitbook-ng/gitbook
GitBook is a command line tool (and Node.js library) for building beautiful books using GitHub/Git and Markdown (or AsciiDoc).
Why Choose @gitbook-ng/gitbook instead of legacy gitbook
@gitbook-ng/gitbook fork from legacy gitbook but providing vulnerabilities fixes and will continue to maintained to provide bugs/ vulnerabilities fixes.
@gitbook-ng/gitbook Have no known vulnerabilities.
$ npm install @gitbook-ng/gitbook
...
...
found 0 vulnerabilities
Legacy gitbook have hundreds of vulnerabilities:
$ npm install gitbook
...
...
npm WARN deprecated [email protected]: please upgrade to graceful-fs 4 for compatibility with current and future versions of Node.js
npm WARN deprecated [email protected]: potential XSS vulnerability in autoescape mode, and with escape filter was fixed in v2.4.3
npm WARN deprecated [email protected]: Way too old
npm WARN deprecated [email protected]: Please update to minimatch 3.0.2 or higher to avoid a RegExp DoS issue
npm WARN deprecated [email protected]: This module relies on Node.js's internals and will break at some point. Do not use it, and update to [email protected].
npm WARN deprecated [email protected]: Please update to minimatch 3.0.2 or higher to avoid a RegExp DoS issue
npm WARN deprecated [email protected]: The sprintf package is deprecated in favor of sprintf-js.
npm WARN deprecated [email protected]: Potential REDOS vulnerability removed in v1.1.0
npm WARN deprecated [email protected]: Use uuid module instead
npm WARN deprecated [email protected]: This module moved to @hapi/hawk. Please make sure to switch over as this distribution is no longer supported and may contain bugs and critical security issues.
npm WARN deprecated [email protected]: This version has been deprecated in accordance with the hapi support policy (hapi.im/support). Please upgrade to the latest version to get the best features, bug fixes, and security patches. If you are unable to upgrade at this time, paid support is available for older versions (hapi.im/commercial).
npm WARN deprecated [email protected]: This version has been deprecated in accordance with the hapi support policy (hapi.im/support). Please upgrade to the latest version to get the best features, bug fixes, and security patches. If you are unable to upgrade at this time, paid support is available for older versions (hapi.im/commercial).
npm WARN deprecated [email protected]: This module moved to @hapi/sntp. Please make sure to switch over as this distribution is no longer supported and may contain bugs and critical security issues.
npm WARN deprecated [email protected]: This version has been deprecated in accordance with the hapi support policy (hapi.im/support). Please upgrade to the latest version to get the best features, bug fixes, and security patches. If you are unable to upgrade at this time, paid support is available for older versions (hapi.im/commercial).
...
...
found 224 vulnerabilities (30 low, 114 moderate, 76 high, 4 critical)
run `npm audit fix` to fix them, or `npm audit` for details
Getting started
No more separated gitbook-cli
is required and no more global installation.
TODO.
Quick start:
npm install @gitbook-ng/gitbook
Add build
and serve
command to package.json
:
"scripts": {
"serve": "gitbook serve",
"build": "gitbook build",
}
Then you can run:
npx gitbook init
npm run build
npm run serve
Migrate from legacy gitbook-cli
First you need uninstall gitbook-cli
(optionally, recommend to save your disk space):
npm uninstall gitbook-cli -g
rm -fr ~/.gitbook # Remove legacy gitbook global installation
Then follow Get Started.
Notice
This is a fork of GitBookIO/GitBook CLI due to GitbookIO deprecated GitBook CLI project.
There are hundreds of vulnerabilities on GitBookIO/GitBook.
This fork try to fix all the known vulnerabilities and PR is welcome for bug fixes, enhancement etc.
Like keep GitBook CLI continue to live, +1 star please.
Changes to original gitbook
There are in-compatible changes to original gitbook:
- NPM package name changed to
@gitbook-ng/gitbook
. - There is no more
gitbook-cli
required, just install@gitbook-ng/gitbook
you will be all set. - No more global installation of
gitbook
.
Licensing
GitBook is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.