文章目录
前言介绍
GitBook 是一款现代化的文档平台,这个工具链 (GitBook) 是一个使用 Git 和 Markdown 来构建书籍的工具。它可以将你的书输出很多格式:PDF,ePub,mobi,或者输出为静态网页。
GitBook工具链是开源并且完全免费的
一、nodejs安装配置
1.1 安装
到官网下载:nodejs
下载好后,无脑下一步安装。
测试是否安装成功:在cmd依次执行
node -v
npm -v
如下:
1.2 镜像配置
我们配置淘宝镜像:依次执行
1-配置全局的 registry 属性
npm config set registry https://registry.npm.taobao.org
2-检查配置结果
npm config get registry
3-测试一下
npm info express
二、本地gitbook安装配置
2.1 切换到D盘
在D盘创建一个文件夹,我就命名为write了,切换很简单:D:
这样回车即可:
为什么要切换到D盘?我开始也是C盘,尝试了,会报错没权限,所以我让大家切换到D盘。
在D盘单独创建一个文件名为write,再cd write
即可。
2.2 安装gitbook-cli
cmd执行如下命令:
npm install gitbook-cli -g
2.3 查看版本
gitbook --version
回车:
2.4 初始化gitbook
cmd继续执行:
gitbook init
如下:
应该生成两个文件:
README.md —— 书籍的介绍写在这个文件里
SUMMARY.md —— 书籍的目录结构在这里配置
但是底部报错了,经过查资料,要降低nodejs版本…
2.5 启动gitbook
cmd继续执行:
gitbook serve
但是会报错如下:
复制报错路径,找到polyfills.js:
编辑它,找到低62-65行,注释掉,保存即可:
然后再来执行:
gitbook serve
回车:
手动在浏览器复制粘贴如下本地端口:
localhost:4000
得到如下: