gitbook 入门教程之使用 gitbook.com 在线开发电子书

gitbook 官网是官方提供的图书托管的在线平台,分为新版官网(须要FQ) www.gitbook.com/ 和旧版官网(无需FQ) legacy.gitbook.com 两个网站.

目前均正常提供服务,但使人遗憾的是,两个网站的信息相互独立,并且如今注册的帐号默认只能在新版官网中使用,而新版官网的访问速度简直比 github 还要慢,因此国内用户在线访问你的电子书真的须要点技术手段了!

本文主要介绍 www.gitbook.com 官网的基本使用,而 legacy.gitbook.com 网站我就算是想介绍也没有帐号测试啊.

"巧妇难为无米之炊",明明你就在那里,可我却什么也作不了.

先大概说一下 gitbook.com 网站的一些我的总结吧.

gitbook.com 提供收费和免费服务,有点像早期的 github ,免费帐号只能建立一个私有的命名空间,其余命名空间只能是公开的,这里的命名空间能够理解为一本书.

这一点是否是有点像早期的 github.com?免费帐号没法建立私有仓库,只能是公开仓库. (如今 github.com 已被微软收购,目前能够建立无限量的私有仓库了!)

再说 gitbook 的帐号问题,像 github 同样提供用户名和邮箱登陆方式,他们的用户名均可以做为二级域名,好比个人用户名是snowdreams1006,那么个人 gitbook 第一本电子书网址就是 https://snowdreams1006.gitbook.io/index/ ,再看一下个人 github 我的网址 https://snowdreams1006.github.io/ ,这两个是否是很相似?!

若是不仔细看的话,八成你会以为同样,一个是**gitbook.io,另外一个是github.io**.

因此我严重怀疑他俩是否是有着鲜为人知的私密关系,太多的类似性,鼓励分享,限制私有等等特色.

无图无真相,趁着此次教程顺便将 github 我的网站项目同步到 gitbook 电子书项目了,这样的好处是本地只须要推送到 github ,自动更新 github.io 网站(利用的是github 静态网站托管服务) ,而后再自动同步到 gitbook.io 网站.

是否是很神奇,一份源码,两个官网!

gitbook : snowdreams1006.gitbook.io/

github : snowdreams1006.github.io/

注册并登录 gitbook.com

注册信息主要包括用户名和邮箱,还有一些其余信息,没什么特殊的注意事项.

访问 www.gitbook.com/ 须要 FQ

新建命名空间(电子书)

注册帐后后会默认生成一个私有的命名空间,由于并不打算将私有电子书托管到 gitbook,因此接下来直接将其转变成公开电子书进行演示.

个性性配置

标题和图片

主题颜色和页面反馈

观众

观众指的是当前电子书面向的受众是谁,公开的和私有的的区别以及设置是否被谷歌搜索收录.

域名

默认域名是 https://snowdreams1006.gitbook.io/<space>,若是须要自定义域名,请保证 dns 可以正确解析到该网站.

url 设置的命名空间是 index,所以最终访问路径是 https://snowdreams1006.gitbook.io/index/

整合

gitbook 默认提供4种整合方式,在下孤陋寡闻只了解 github ,其他三种没接触过,暂不涉及.

选择 github 进行整合

登陆 github 并受权

选择列出公开的仓库,而后输入用户名和密码进行登陆并受权.

选择目标仓库

受权成功后会列出当前 github 帐号下所有的公开仓库,选择目标仓库并点击下一步.

这里以 snowdreams1006.github.io 公开仓库为例,由于该仓库是本人官网源码项目.

同步内容

选择同步分支

根据实际状况选择同步分支,由于我通常是直接推送到 master 分支,因此 master 分支是我的网站的维护分支,所以这一步我选择的是 master.

选择同步内容

选择同步内容的方式,是从 github 同步到 gitbook,仍是从 gitbook 同步到 github,由于个人项目已托管到 github ,因此初次同步内容选择的是 github --> gitbook.

显示 github 按钮

生成的电子书网站是否显示 github 按钮,做用是点击该按钮会跳转到关联的github 仓库上.

此时内心在想,万一点进 github ,随手就是一个 star 呢?哈哈!

等待内容导入

根据目标仓库的大小不一样,导入内容是的时长天然也不同,耐心等待...

上线

导入完成,电子书终于正式上线了!

如今赶忙分享一下好消息吧,访问 .gitbook.io/ 在线阅读!

小结

本文以如何集成 github 为例,演示了 gitbook.com 发布电子书的基本流程,因为 gitbook 电子书内容来自于 github 项目,所以咱们只要更新 github 仓库,咱们的 gitbook 电子书网站天然也就相应更新了!

gitbook 是 markdown 和 github 的完美结合体,借助 gitbook.com 官网咱们很容易发布并托管电子书.

美中不足的是,国内没法正常访问 gitbook.com ,所以并非很推荐将电子书发布到 gitbook.com 网站.

如今国内也有相似的产品,有一种产品叫作 看云,还不错!

后续还会介绍 gitbook 如何结合 github 发布我的网站,欢迎继续关注 gitbook 系列教程!

如何打造免费的我的官网,想了解 https://snowdreams1006.github.io/ 背后的故事吗?