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扩展开发及内核应用中文版下载

发表评论

电子邮件地址不会被公开。 必填项已用*标注