c. 返回Typora,发现已经生成了目录结构
解释:GitBook会根据SUMMARY.md文件中描述的目录和文件生成目录结构,文件也会生成,如果之前没有创建的话。
4. 启动GitBook服务
a. 启动预览服务
gitbook serve
提示错误:
Error: ENOENT: no such file or directory, stat 'C:\Users\Administrator\Documents\01shao\test-book\_book\gitbook\gitbook-plugin-lunr\lunr.min.js'
问题解决参考:
gibook工具常见的问题记录
修改下面的问题件~指的是用户目录
~\.gitbook\versions\3.2.3\lib\output\website\copyPluginAssets.js中的112行内容
原始内容 ,主要是confirm的true需要修改为false
修改后:
再重新执行:
gitbook serve
提示“Serving book on http://localhost:4000”
,即默认是启动在localhost:4000,此时用浏览器打开此url则可看到结果:
5. 构建GitBook书籍
a. 构建书籍
gitbook build
- 当然也不用经常构建,此步骤其实就是想要打包到其他地方执行了才执行,如果有编程基础的话应该是比较容易理解的。
- 你可以像发布前端项目一样将我们的项目发布出去。
0x03 与Git完美配合
1. 提交文档到码云
a. 使用Git将代码提交到码云 => 链接跳转
我们可以将编辑好的文件,上传到云端,实现远端开发,此过程不再累赘,请参考一些Git相关的内容。
0xFF 总结
其他的操作总结
build可以指定书籍的路径以及输出路径:
gitbook build [书籍路径] [输出路径]
serve 命令也可以指定端口:
gitbook serve --port 4044
生成不同格式的电子书:
gitbook 格式 [书籍路径] [输出路径]
如:
gitbook pdf ./ ./mybook.pdf
gitbook epub ./ ./mybook.epub
gitbook mobi ./ ./mybook.mobi
最后说句心里话,体验了下后,感觉这东西也没什么用,可能对于目录的结构有那么一点点用,其他的也没什么。
参考文章:
GitBook 从懵逼到入门
gitbook安装与使用之windows下搭建gitbook平台
记坑爹的服务器端gitbook安装过程-太坑了
gitbook安装中installing gitbook xxx 时间过长的问题