网页版使用教程:参考博文
本地 GUI 使用教程:参考博文
本地命令行使用及生成 PDF 教程:参考博文
本地编译成 PDF 或其他格式:参考博文
一 网站与客户端生成
1 准备
注册 GitBook,安装 GitBook Editor 并登陆。
可以直接使用网页版创建并发布;可以在本地创建并在网页版创建后使用 Git HTTPS 将本地与远程仓库关联;可以远端创建后直接在 GitBook Editor 客户端中打开。
注:title 下的路径即为本书面向公共的访问路径(直接访问本书内容)。本地客户端和网页版均无法输入中文的书名(title),在网页版的书主页设置中可更改为中文书名。
2 使用
在编辑中右上角 Publish 为发布。
若发布失败可在书主页的 UPDATES 中按哈希选择重新发布。
二 本地编译生成
1 安装、更新与卸载
安装环境:Node.js
安装 GitBook:
npm install -g gitbook-cli
检查是否安装成功:
gitbook -V
更新 GitBook:
gitbook update
卸载 GitBook:
npm uninstall -g gitbook
安装 GitBook Editor,用于图形化编辑文档。
安装 Calibre:用于生成 PDF(用到此软件的 ebook-convert)。配置环境变量,Calibre 安装目录,(Windows 下会自动配置好)。
2 编译
用 GitBook Editor 编写完成后。
命令行进入该书目录,Windows 下默认为
C:\Users\UserX\GitBook\Library\Import\XXX
预览测试:
gitbook serve
,浏览器打开http://localhost:4000
(control + c 停止)。生成 PDF:
gitbook pdf