共计 1579 个字符,预计需要花费 4 分钟才能阅读完成。
GitBook 是一个基于 Node.js 的命令行工具,可应用它来制作精美的电子书,同时 GitBook 提供了大量的插件,以应答各种需要。
本文笔者就来具体记录一下 GitBook 装置过程,并记录在学弟学妹机器中呈现的各种“幺蛾子”。
因为 GitBook 依赖于 node.js,因而在装置 GitBook 前确保曾经装置好了 node.js 环境。Node 版本肯定不要太高,网上倡议 v12.16.2 否则会产生如下状况:
1. 装置 GitBook 命令行工具
npm install gitbook-cli -g
问题一:gitbook : 无奈加载文件×××××××××因为在此零碎上禁止运行脚本。
解决问题一:
- 关上 Windows PowerShell ISE 在搜寻框内搜寻 windows powershell ise,而后右击以管理员身份运行;
- Set-ExecutionPolicy RemoteSigned,抉择全是即可。
2. 装置 GitBook
gitbook -V
输出上述指令,会主动下载 GitBook;
问题二:TypeError: cb.apply is not a function
解决问题二:点击链接中提醒的文件后对文件进行编辑并正文掉上面几行代码即可
3.GitBook 我的项目初始构建
gitbook init
执行上述命令后,会主动生成两个必要的文件 README.md 和 SUMMARY.md。README.md: 书的介绍文字,如前言、简介,在章节中也可做为章节的简介。SUMMARY.md: 定制书籍的章节构造和程序。
此时若呈现如下问题,则是 node 版本的问题:
4.GitBook 依赖下载
gitbook install
5.GitBook 插件配置及下载
在 book.json 文件 ”pluginsConfig” 中配置所须要的插件(记得援用前下载)。罕用插件及详解
笔者的配置如下:
"pluginsConfig": {
"prism": {
"css": ["prismjs/themes/prism.css"]
},
"insert-logo": {
"url": "/logoPic/logo.png",
"style": "background:none;max-height:129px;margin-right:200px"
},
"github": {"url": "https://github.com/zhangjikai"},
"hide-element": {
"elements": [".gitbook-link"]
},
"download-pdf-link": {
"base": "https://www.gitbook.com/book/poppy-project/poppy-docs/",
"label": {
"en": "Download PDF",
"fr": "Télécharger le PDF"
}
}
}
5.GitBook 目录配置
6.GitBook 服务启动
gitbook serve
7.GitBook 服务启动
运行后果如下图:
8.GitBook 打包
键入 gitbook build
即可生成_book 文件,用于部署 GitBook 我的项目,笔者这里在阿里云服务器中部署了一个 gitbook 我的项目如下图,部署和 Web 我的项目雷同,在此便不具体解释。
附上:
## 插入视频
<video controls="controls" width="100%">
<source src="../courseResources/mp4.mp4" type="video/mp4">
</video>
## 插入 pdf
<embed src="../courseResources/pdf.pdf" width="500" height="375" />
## 插入 ppt
<embed src="../courseResources/pptTest.pdf" width="100%" height="500px" />
正文完