使用gitbook制作属于自己的电子书git
mode1：<+（github）第一种方法是直接在gitbook网站上注册账号，创建书籍；.创建书籍时选择非basic或者science即可创建保存在gitbook站点上的书籍，书籍页面进行setting等操作。此类方法创建的书籍可使用<提供的在线编辑器编辑。如果突然想让自己的书籍与github仓库建立联系，进行同步，也可以点击书籍页面的welcom的link to github，或者setting里面进行关联！mode2：<+github+gitbook editor(gitbook-cli)本地gitbook editor流程：
安装gitbook editor
使用<账号登陆
编写书籍时注意：章节名避免使用中文（解决中文问题：先英文再到SUMMARY.md和对应的md文件手动修改）
使用网页版编辑器时没有中文输入的问题！
相对书籍进行相关配置，新建book.json，输入以下内容！
关于book.json各个参数的介绍，
"title": "yangfch3's Diary",
"author": "_",
"description": "_",
"extension": null,
"generator": "website", // 使用的编译模式
"isbn": null,
"links": {
"sharing": {
"all": null,
"facebook": null,
"google": null,
"twitter": null,
"weibo": null
"sidebar": {
"yangfch3's github": "/yangfch3"
"output": null, // 自定义指定编译输出目的文件夹
"fontSize": 12,
"footerTemplate": null,
"headerTemplate": null,
"margin": {
"bottom": 36,
"left": 62,
"right": 62,
"pageNumbers": false,
"paperSize": "a4"
"fontSize": 12,
"footerTemplate": null,
"headerTemplate": null,
"margin": {
"bottom": 36,
"left": 62,
"right": 62,
"pageNumbers": false,
"paperSize": "a4"
"styles": {
"website": "styles/website.css",
"ebook": "styles/ebook.css",
"pdf": "styles/pdf.css",
"mobi": "styles/mobi.css",
"epub": "styles/epub.css"
// 用户自定义的样式，编译时对应的
"plugins": ["disqus","codeblock-filename"],
"pluginsConfig": {
"disqus": {
"shortName": "hub7diary"
"variables": {}}
新建github仓库，利用git进行commit和push
如果想为书籍添加插件
安装node.js
npm install &pacName& --save-dev
在book.json里的pluginConfig里进行插件配置（如果需要的话）
npm init创建package.json记录书籍依赖包（可以不创建，直接将依赖插件记录在book.json即可，一次性安装所有插件可以使用：gitbook install）
常用插件的使用见下方章节
使用gitbook editor的好处是无需命令行，无需node插件，无需手动新建文件，缺点是对中文支持差！
使用node.js制作书籍
安装node.js
npm install gitbook -g
npm install gitbook-cli -g
在书籍根目录建立SUMMARY.md和README.md
gitbook init
新建章节文件夹，分区编写章节保存，在SUMMARY.md里建立映射关系
# Summary* [Introduction](README.md)* [chapter1_Name](folder1/README.md)* [chapter1_Name](folder2/README.md)
* [section1_Name](folder2/section1.md)
创建book.json，设置参数（参见上文）
gitbook serve会编译书籍并建立一个临时服务器（使用gitbook build是只编译），可以再浏览器浏览（结果会有服务器IP与端口提示）
git来commit和push
插件的使用见下文
本地仓库与github仓库同步之后，可以利用github仓库来在<上新建书籍新建书籍时选择github或import即可
线上编辑与本地editor编辑混合使用容易产生错误（目录与文件对应错误，无法编译），请整理文件对应结构，然后在SUMMARY.md里手动纠正
gitbook其他设置当我们在<上建好书籍后，我们可以为书籍进行封面，主题，配置域名等设置。封面：在gitbook在线编辑器设置按钮下添加封面或者直接书籍仓库的根目录下放置一个cover.jpg即可主题：在<书籍页面的setting页面有landing page选项用于设置主题配置域名：<上书籍setting页面选择domains，设置homepage和content的域名。在书籍目录编译后的_book下添加一个CNAME文件，添加好域名即可！
具体参见：，书籍左边sidebar：在book.json的sidebar key 下设置，见上方配置代码发布到github pages：本地转换为pdf等格式：
<为我们提供了在线的转换工具，我们可以在线下载电子书的pdf、epub、mobi等格式文档，但是如果我想在本地实现pdf和其他格式文本的导出怎么办？
1. 确保全局安装`gitbook-cli`：**`npm install gitbook-cli -g`**
2. 安装**`Calibre`**
3. 运行**`gitbook pdf ./..path../BookFloder ./..path../xxx.pdf`**
2. 运行时路径不要跨盘符
3. 转换为其他类型文档时将pdf改为epub、mobi等
常用插件disqus
安装gitbook-plugin-disqus：npm install gitbook-plugin-disqus --save-dev
执行 gitbook install 将插件脚本插入书籍的每个页面
npm init一下，将插件记录到package.json的devDependence里
在< 注册账号 ===& setting&add disqus to site ===& start use engage ===& 设定siteName即讨论栏目的名字 ===& 在setting&admin&setting里进行设定 ===& 获取disqus的shortName ===& 更改book.json的pluginConfig进行配置（或者在gitbook editor里edit configuration）
在线编辑有线上插件配置的功能，在书籍编辑页面的设置里面
multipart用于书籍分割不同的部分。gitbook默认只支持章节，如果想将书籍分为几个部分，每个部分的章节顺序不受影响，则需要使用multipart
安装gitbook-plugin-multipart
npm install gitbook-plugin-multipart --save-dev
执行 gitbook install 将插件脚本插入书籍的每个页面
npm init记录本地依赖包
在SUMMARY.md里设定part名
# Book Title* Getting Started* About this guide## Part I - Introduction* Really interesting...
* Did you know?...
* Oh yes...
* I know!...
* Quite...
* Gosh...## Part 2 - Advanced* Right then
* Let's get busy
* No more mucking about
* Of course
编辑book.json添加multipart到plugins中
其他插件常见坑爹错误有时发现对于github账号对gitbook的授权老是出问题
临时解决方案：
1. 新建书籍选择basic，而不要选择一直出错的github
2. 账户设置 ===& 提高对github的授权级别
3. 再将新建书籍与github仓库建立联系（link to github）
4. 本地推送更新到github仓库
5. 此时空的书籍便会更新同步了
参考资料兼实例展示
添加新批注
在作者公开此批注前，只有你和作者可见。
查看更早的 5 条回复Gitbook使用入门_百度文库
两大类热门资源免费畅读
续费一年阅读会员，立省24元！
Gitbook使用入门
上传于||暂无简介
阅读已结束，如果下载本文需要使用1下载券
想免费下载本文？
定制HR最喜欢的简历
下载文档到电脑，查找使用更方便
还剩12页未读，继续阅读
定制HR最喜欢的简历
你可能喜欢GitBook首页、文档和下载 - 基于Git制作电子书 - 开源中国社区
当前访客身份：游客 [
当前位置：
GitBook 是一个基于 Node.js 的命令行工具，可使用 Github/Git 和 Markdown 来制作精美的电子书，GitBook 并非关于 Git 的教程。
使用GitBook生成的电子书
GitBook支持输出多种文档格式：
静态站点：GitBook默认输出该种格式，生成的静态站点可直接托管搭载服务上；
PDF：需要安装依赖；
eBook：需要安装；
单HTML网页：支持将内容输出为单页的HTML，不过一般用在将电子书格式转换为PDF或eBook的中间过程；
JSON：一般用于电子书的调试或元数据提取。
使用GitBook制作电子书，必备两个文件：README.md和SUMMARY.md。README.md多为电子书的简介内容，SUMMARY.md用来定义电子书章节结构，如：
同时，GitBook还支持嵌入JavaScript的交互式内容，未来版本会支持Python、Ruby等语言。
两本使用 GitBook 制作的电子书例子：
授权协议：
开发语言：
操作系统：&跨平台&
收录时间： 日
modernizr 发表于2年前
，最后回答(6个月前)：
翟志军 发表于3年前
，最后回答(10个月前)：
杭电任宇翔 发表于1年前
，最后回答(1年前)：
codepiano 发表于2年前
，最后回答(2年前)：
使用 GitBook 中的任何问题
：写书利器
共有 382 个类似软件
Atom 是 Github 专门为程序员推出的一个跨平台文本编辑器。具有简洁和直观的图形用...
Vim是Linux上的著名的文本编辑器，他是早年的Vi编辑器的加强版。这个GVim是windows...
Brackets 是 Adobe 的开源 HTML/CSS/JavaScript 集成开发环境。Brackets 当前为Mac...
Fredrik Ehnbom用Go语言开发了新代码编辑器 Lime Text，号称Sublime Text的开源实现...
TextMate是Mac下的著名的文本编辑器软件，与BBEdit一起并称苹果机上的Emacs和Vim。...
jEdit是一个用Java语言开发的文本编辑器，在GPL下发布。它可以在Windows、Linux、M...
MarkdownPad 是 Windows 下的一款全功能的 Markdown 编辑器。...
jquery-dynatable 一款提供简单、可扩展的 API ，能更容易的查看大数据集合、与大数...
CotEditor 是一款主要由日本开发者开发的轻量级的 OS X 原生编辑器,支持多种编程语...
MediumEditor 是一个模仿 Medium 的开源编辑器。MediumEditor 使用 Vanilla JavaSc...
一个将gitbook电子书打包成android离线电子书应用的项目。
共有 52 人关注 GitBook}