gitbook安装教程

x33g5p2x  于2021-10-20 转载在 其他  
字(0.8k)|赞(0)|评价(0)|浏览(383)

前言介绍

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

得到如下:

相关文章