GitBook 使用
介绍
GitBook是一个基于Node.js的命令行工具,可使用 Github/Git和Markdown来制作精美的电子书,GitBook 并非关 Git的教程。
导出格式有PDF、HTML等,需要添加相应插件。
安装
安装npm
从网站 https://nodejs.org/en/download/ 上下载并安装
npm -v
查看是否安装成功。
安装gitbook
npm install -g gitbook-cli
gitbook -V
查看是否安装成功。
安装GitBook Editor
这是官方的一个客户端编辑器。可以不安装,直接在GitBook网站上编辑文档也是可以的。
下载地址:https://www.gitbook.com/editor
现在的版本是7.0.12,如果要切换到Markdown编辑器,右下角有个按钮,点击然后选择“Edit Markdown”即可使用Markdown编辑器。如果是旧的版本,
使用
直接使用
在页面上,直接点击“+New Book”,根据提示即可创建一本书,然后就可以进行编辑了。
可用editor编辑,也可以网站上直接编辑。
关联GitHub
GitHub:先在上GitHub创建一个仓库。
GitBook:然后在GitBook右上角的个人信息那里,点击“Account Settings”,在界面上选择“GitHub”这个Tab,找到“Integration”选项卡,有一个按钮“Install GitHub integration on this account”,点击,选择刚刚在GitHub创建的仓库即可。
注意:后续如果还需要继续做关联,在GitHub网站的Setting中的“Intalled GitHub Apps”,对GitBook进行配置即可。
GitBook:创建一个新书,然后点击setting,有一个GitHub选项卡,选择关联的GitHub仓库即可。
现在就可用editor编辑,也可以网站上直接编辑,还可以用GitHub进行管理了。
文件结构
除了README.md,还需要SUMMARY.md这个文件,这个是书的结构,如下:
# Summary
* 第一章
* [第一节](di-yi-zhang/di-yi-jie.md)
* [第二节](di-yi-zhang/di-er-jie.md)
* 第二章
* 第三章
文件夹“di-yi-zhang”跟SUMMARY.md都在根目录。
默认情况下,如果是直接在网页上编辑的,目录跟文件名都会是拼音,当然可以自己命名。
导出
导出HTML,会在_book文件夹下生成文件
gitbook build
如果是要导出PDF,ePub或者mobi格式的电子书时,需要安装Calibre电子书阅读/管理器和命令行工具,不然可能会报错“EbookError: Error during ebook generation: 'ebook-convert'”。
导出PDF
gitbook pdf
其他功能
https://chrisniael.gitbooks.io/gitbook-documentation/content/index.html
插件搜索地址:https://plugins.gitbook.com/
__EOF__
欢迎转载,但请注明出处!
欢迎大家一起交流学习!如果有什么疑问,大家可以在评论区一起交流!
如果您觉得文章对您有帮助,可以点击文章右下角【推荐】一下。您的鼓励是我的最大动力!