解决Gitbook目录生成问题:
gitbook不支持markdown的TOC
命令自动生成目录。
解决方案:
使用gitbook插件gitbook-plugin-toc。
在book.json
中添加
{ "plugins": ["toc"] }
在book.json
所在目录运行gitbook install
,安装完成后,在使用TOC
命令的地方使用<!-- toc -->
代替。即可自动生成文档目录。
Gitbook 学习链接:http://gitbook.hushuang.me/structure.html
在系统上使用gitbook命令,需要安装“gitbook CLI”,执行以下命令
//安装命令
npm install -g gitbook-cli
//卸载命令
npm uninstall -g gitbook
但npm的服务器在境外,安装cnpm后安装软件速度会更快,用下述命令可将npm指向国内镜像源:
npm install cnpm -g --registry=https://registry.npm.taobao.org
然后,用cnpm命令安装gitbook-cli,cnpm install -g gitbook-cli
1)创建自己的gitbook目录,mkdir d:\gitbook
2)进入自己的gitbook目录下,初始化gitbook,输入gitbook init
3)初始化后,生成HTML发布,输入gitbook build
在cmd中输入gitbook serve
,启动gitbook服务:
在浏览器访问:http://127.0.0.1:4000,就可以看到自己的电子书了!
注:启动服务前可以修改README.md,和SUMMARY.md,增加自己的markdown文件。
README.md一般是这本书的简介部分。SUMMARY.md是gitbook的目录结构,可以参照格式增加章节目录。01.md就是每个章节的markdown文件。
gitbook不支持markdown的TOC
命令自动生成目录。
使用gitbook插件gitbook-plugin-toc。
在book.json
中添加
{ "plugins": ["toc"] }
在book.json
所在目录运行gitbook install
,安装完成后,在使用TOC
命令的地方使用<!-- toc -->
代替。即可自动生成文档目录。
原文:https://www.cnblogs.com/xiaozengzeng/p/13363664.html