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" />