GitBook
文章目录
基于NPM利用GitBook创建自己的电子书
依赖Node.js
Node.js
Node简介
Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时。
Node教程
Node.js安装配置
下载位置,安装完就完事。
报错
无法加载文件C:\Users\Administrator\AppData\Roaming\npm\tsc.ps1,因为在此系统上禁止运行脚本
解决
使用管理员身份运行并输入命令:set-ExecutionPolicy RemoteSigned
弹出窗口选择:Y/A即可。
NVM使用
Python的pip,Java的Maven一样的作用,包管理,npm管理包而已。
安装
其中nvm-noinstall.zip
需要配置,nvm-setup.zip
解压后直接安装即可,其他的Source是源码,直接一直点击Next安装就可以了。
修改nvm/setting.txt文件内容为(下面是淘宝镜像):
root: C:\Users<name>\AppData\Roaming\nvm
path: C:\Program Files\nodejs
arch: 64
proxy: none
node_mirror: http://npm.taobao.org/mirrors/node/
npm_mirror: https://npm.taobao.org/mirrors/npm/
常用命令
nvm ls // 查看目前已经安装的版本
nvm install 10.5.0 // 安装指定的版本的nodejs
nvm use 10.5.0 // 使用指定版本的nodejs
复制代码
NPM使用
由于新版Node.js已经集成了Npm所以直接开始使用就可以了。npm -v
查看版本信息,验证是否已经完成安装;sudo npm install npm -g
命令用于升级更新旧版本(Linux),Win下面使用npm install npm -g
(附:推荐使用TB镜像npm install -g cnpm --registry=https://registry.npm.taobao.org
)添加以前的版本,举例:npm install npm@6.14.10 -g
使用npm命令安装模块(略)
npm install express # 本地安装
npm install express -g # 全局安装
安装Gitbook
使用命令行安装,选择好gitbook editor或者Typora等你喜欢的markdown编辑器
问题
安装缓慢
国内Gitbook安装缓慢的话,建议科学上网或者改用淘宝镜像
Node.js版本问题
说明Node.js的版本环境有问题,需要降低Node版本。最新稳定版本是v12.18.3,下面展示上述报错的解决方案。(注:该方法可能只使用于Win10操作系统)
-
解决办法1:
卸载已下载版本,重新下载10.22.0版本的Node.js。缺点:对未来Node.js版本的更新或多个版本之间的切换使用不太方便 -
解决办法2: 使用Windows系统下的Node.js的版本管理器nvm-windows(Node.js Version Manager for Windows)。nvm-windows可以帮助实现在同一台设备上进行多个node版本之间的切换。下载nvm并配置环境路径即可。
Gitbook使用
1、安装gitbook命令行
$ npm install -g gitbook-cli
2、查看是否安装成功
$ gitbook -V
3、开始使用
(1)初始化
$ mkdir test_gitbook
$ cd test_gitbook
$ touch README.md
$ touch SUMMARY.md
$ vi SUMMARY.md
\* [简介](README.md)
\* [第一章](chapter1/README.md)
\- [第一节](chapter1/section1.md)
\- [第二节](chapter1/section2.md)
\* [第二章](chapter2/README.md)
\- [第一节](chapter2/section1.md)
\- [第二节](chapter2/section2.md)
\* [结束](end/README.md)
(2)生成目录结构
$ gitbook init
(3)查看目录结构
$ tree
.
├── README.md
├── SUMMARY.md
├── chapter1
│ ├── README.md
│ ├── section1.md
│ └── section2.md
├── chapter2
│ ├── README.md
│ ├── section1.md
│ └── section2.md
└── end
└── README.md
(4)本地预览
$ gitbook serve