160412 通过github维护gitbook的书籍

今天群里分享了一本书籍《PHP扩展开发及内核应用》，之前并不知道这本书有中文版，所以当时读的时候就当小说读了，并没有实际去操作，并且对英文的水平只能评价为摸瞎的节奏。

这本书是中文通过github发布的，实际上很多在github上有很多书，但它本身真的不适合通过手机阅读或者kindle阅读。

那怎么办呢？

我们可以通过将书籍放到gitbook.com中，使用网站提供的导出功能导出mobi，放入到kindle中。

下文即大概迁移的方法:

1. 准备工作

你需要2个账号:

www.github.com
www.gitbook.com

同时:

并且 github设置SSH keys.
具体设置点击github右上角头像选择setting,选择SSH and GPG keys即可.

当然如果你不知道什么是SSH KEY也可以的。反正下面只是用github的https方式导出项目

当然你还需要本地安装git,生成sshkey(rsa-256)

2. fork项目

原项目地址:https://github.com/walu/phpbook,访问后点击Fork.即在自己的github中新建了一个phpbook项目，我们这里不考虑commit后request

3. gitbook.com创建书

例如博主建立了一本书：

书名叫做:php-extend-develop

则访问地址:

https://www.gitbook.com/book/cfrs2005/php-extend-develop

4. gitbook 书籍中添加github地址

https://www.gitbook.com/book/cfrs2005/php-extend-develop/settings

访问对应的settings地址，有一个GITHUB选项，
填入你的github项目的地址:
https://github.com/cfrs2005/phpbook

这时候会提示你去获取github提交代码授权，允许。

5. 导出github代码

在通过授权gitbook.com访问github后，

在你的github的phpbook项目中就会多出几个同步文件

README.md 书籍介绍
SUMMARY.md 为书籍目录结构

使用的基本结构如下

# Summary

* [关于本书](README.md)
* [PHP的生命周期](1.md)
  * [让我们从SAPI开始](1.1.md)
  * [PHP的启动与终止](1.2.md)
  * [PHP的生命周期](1.3.md)
  * [线程安全](1.4.md)
  * [小结](1.5.md)

导出项目

git clone https://github.com/cfrs2005/phpbook.git

6. phpbook项目编辑

cd phpbook
vim SUMMARY.md
//将如下内容添加

* [关于本书](README.md)
* [PHP的生命周期](1.md)
  * [让我们从SAPI开始](1.1.md)
  * [PHP的启动与终止](1.2.md)
  * [PHP的生命周期](1.3.md)
  * [线程安全](1.4.md)
  * [小结](1.5.md)

//保存
:wq
//将变更添加
git add *
//提交本地变更
git commit -m '修改目录结构'
//提交到远端master目录
git push origin master

7. 查看保存结果

https://github.com/cfrs2005/phpbook

8. 查看最终效果

https://cfrs2005.gitbooks.io/php-extend-develop/content/

大功告成就是这么easy,如遇到什么问题留言会回复的，

9.最后PHP书籍分享

PHP扩展开发及内核应用中文版下载