note.js安装以及gitbook的使用

最新推荐文章于 2023-08-12 12:00:00 发布

K_Lily

最新推荐文章于 2023-08-12 12:00:00 发布

阅读量393

点赞数

本文链接：https://blog.youkuaiyun.com/K_Lily/article/details/105291511

版权

本文档介绍了如何安装Node.js、Gitbook及其插件，解决安装过程中遇到的问题，包括初始化书籍、编辑内容、本地预览及生成不同格式的电子书。通过`gitbook init`创建基本结构，编辑SUMMARY.md定义目录，使用`gitbook serve`预览，`gitbook build`生成HTML，以及转换为PDF、EPUB和MOBI格式。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

下载地址https://nodejs.org/en/download/

在git控制台检查是否安装成功 $ node -v

安装gitbook

npm install -g cnpm（加速安装）

运行下面的命令进行安装

cnpm install gitbook-cli -g

gitbook install

出现问题

Error: ENOENT: no such file or directory, stat 'D:\aspirecn\devops-project-public-docs\_book\gitbook\gitbook-plugin-sharing\buttons.js'

解决办法

vim ~/.gitbook/versions/3.2.3/lib/output/website/copyPluginAssets.js

更改 confirm里面的 true 改为 false

检查版本 gitbook -V

启动gitbook gitbook serve

初始化

初始化一本书

gitbook init

在使用 gitbook init 之后本地会生成两个文件 README.md 和 SUMMARY.md ，这两个文件都是必须的，一个为介绍，一个为目录结构。

编辑电子书

首先，GitBook使用SUMMARY.md文件组织整个内容的目录，比如可以新建 Faq.md 文件，来记录常见问题，并在 SUMMARY.md 文件中添加目录。

# Summary

* [简介](README.md)

* [常见问题](Faq.md)

本地预览

当内容书写完毕后，可以在终端中输入如下命令，实现实时预览

gitbook serve

gitbook serve ./{book_name}

gitbook serve 命令实际会先调用 gitbook build 编译书籍，完成后打开 web 服务器，默认监听本地 4000 端口，在浏览器打开 http://localhost:4000 即可浏览电子书。

发布电子书

gitbook build

gitbook build ./{book_name} --output=./{outputFolde}

gitbook build ./ --log=debug --debug

当电子书内容制作好之后，可以使用如下命令来生成 HTML 静态网页版电子书。该命令会在当前文件夹中生成 _book 文件夹，这个文件夹中的内容就是静态网页版电子书。

使用 --log=debug --debug 可以用来调试，会打印出 stack trace。

build 命令可以指定路径：

gitbook build [书籍路径] [输出路径]

serve 命令也可以指定端口：

gitbook serve --port 2333

你还可以生成 PDF 格式的电子书：

gitbook pdf ./ ./mybook.pdf

生成 epub 格式的电子书：

gitbook epub ./ ./mybook.epub

生成 mobi 格式的电子书：

gitbook mobi ./ ./mybook.mobi

gitbook常用命令：

gitbook -V 查看版本号
gitbook init 初始化
gitbook serve 预览
gitbook build 生成
gitbook build --gitbook=2.6.7 生成时指定gitbook的版本, 本地没有会先下载
gitbook uninstall 2.6.7 卸载指定版本号的gitbook
gitbook fetch [version] 获取[版本]下载并安装<版本>
gitbook --help 显示帮助文档
gitbook ls-remote 列出NPM上的可用版本