Gitbook教程

1.node.js的安装

Node.js 安装包及源码下载地址为:https://nodejs.org/en/download/

注意:使用最新版本的node.js后出现问题,只能降低版本:现在node:V12.14.0和gitbook:3.2.3能够运行

如果需要使用gitbook,Node版本建议为v12.14.0

使用的GitBook 3.2.3

检查Node.js版本:node --version

image.png

修改全局安装和cashe路径后

npm config set prefix "D:\Environment\nodejs\node_global"

npm config set cache "D:\Environment\nodejs\node_cache"


2.编辑工具的安装

下载地址:https://www.typora.io/

3.Gitbook的使用

安装gitbook:

npm install gitbook-cli -g

检查gitbook版本:

image.png

。。。。。。一直等待。。。。。。

新建文件夹,并cd进入该文件夹,执行  gitbook init

文件夹里会多两个文件

README.md(书籍的介绍在这个文件里)

SUMMARY.md(书籍的目录结构在这里配置)


也可以根据SUMMARY.md。例如:

# Summary

* [Introduction](README.md)
* [前言](readme.md)
* [第一章](part1/README.md)
    * [第一节](part1/1.md)
    * [第二节](part1/2.md)
    * [第三节](part1/3.md)
    * [第四节](part1/4.md)
* [第二章](part2/README.md)
* [第三章](part3/README.md)
* [第四章](part4/README.md)

再次执行gitbook init Gitbook会查找SUMMARY.md中描述的目录和文件,如果没有则会创建


4.生成电子书

执行 gitbook serve ;执行后会把Markdown格式的文档转换为html格式

http://localhost:4000




5.优化

gitbook 解决html不能跳转问题

找到gitbook文件夹,进入找到theme.js文件

建议使用sublime,打开theme.js文件,然后通过搜索找到if(m)for(n.handler&&,把m修改为false,保存文件 ,就可以实现html跳转了


上一篇:
下一篇: