gitbook 入门教程之使用 gitbook.com 在线开发电子书
gitbook
官网是官方提供的图书托管的在线平台,分为新版官网(需要FQ) https://www.gitbook.com/ 和旧版官网(无需FQ) https://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 : https://snowdreams1006.gitbook.io/
github : https://snowdreams1006.github.io/
注册并登陆 gitbook.com
注册信息主要包括用户名和邮箱,还有一些其他信息,没什么特殊的注意事项.
访问 https://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
呢?哈哈!
等待内容导入
根据目标仓库的大小不同,导入内容是的时长自然也不一样,耐心等待...
上线
导入完成,电子书终于正式上线了!
现在赶紧分享一下好消息吧,访问 https:// 在线阅读!
小结
本文以如何集成 github
为例,演示了 gitbook.com
发布电子书的基本流程,由于 gitbook
电子书内容来自于 github
项目,因此我们只要更新 github
仓库,我们的 gitbook
电子书网站自然也就相应更新了!
gitbook
是 markdown
和 github
的完美结合体,借助 gitbook.com
官网我们很容易发布并托管电子书.
美中不足的是,国内无法正常访问 gitbook.com
,因此并不是很推荐将电子书发布到 gitbook.com
网站.
现在国内也有类似的产品,有一种产品叫做 看云,还不错!
后续还会介绍 gitbook
如何结合 github
发布个人网站,欢迎继续关注 gitbook
系列教程!
如何打造免费的个人官网,想了解
https://snowdreams1006.github.io/
背后的故事吗?
gitbook 入门教程之使用 gitbook.com 在线开发电子书的更多相关文章
- gitbook 入门教程之小白都能看懂的 Gitbook 插件开发全流程
什么是插件 Gitbook 插件是扩展 GitBook 功能(电子书和网站)的最佳方式. 只要是 Gitbook 默认没有提供的功能,基于插件机制都可以自行扩展,是插件让 Gitbook 变得更加强大 ...
- gitbook 入门教程之从零到壹发布自己的插件
什么是插件 Gitbook 插件是扩展 Gitbook 功能的最佳方式,如果 Gitbook 没有想要的功能或者说网络上也没有现成的解决方案时,那么只剩下自食其力这条道路,让我们一起来自力更生开发插件 ...
- gitbook 入门教程之使用 gitbook-cli 开发电子书
gitbook 生成电子书主要有三种方式: gitbook-cli 命令行操作,简洁高效,适合从事软件开发的相关人员. gitbook-editor 编辑器操作,可视化编辑,适合无编程经验的文学创作者 ...
- gitbook 入门教程之环境要求
gitbook 是基于 node.js 的命令行工具,首先需要安装并配置好 node.js 环境,然后才能安装gitbook 相关工具. 由于安装工具全部都是国外网站,因此速度可能会很慢,也可能需要F ...
- gitbook 入门教程之发布电子书
输出目标文件 语法格式: gitbook build [book] [output] 默认情况下,gitbook 输出方式是静态网站,其实 gitbook 的输出方式有三种: website, jso ...
- gitbook 入门教程之快速体验
本文主要介绍三种使用 gitbook 的方式,分别是 gitbook 命令行工具,Gitbook Editor 官方编辑器和 gitbook.com 官网. 总体来说,三种途径适合各自不同的人群,找到 ...
- gitbook 入门教程之常用命令详解
不论是 gitbook-cli 命令行还是 gitbook editor 编辑器都离不开 gitbook 命令的操作使用,所以再次了解下常用命令. 注意 gitbook-cli 是 gitbook 的 ...
- gitbook 入门教程之还在搞公众号互推涨粉?gitbook 集成导流工具,轻轻松松躺增粉丝!
相信大多数博客作者都或多或少有过这样想法: 现在各种平台这么多,想要实现全平台发布就要到处复制粘贴,等我有空一定做统一平台一次性全部解决! 不知道正在阅读文章的你,有没有这样的想法? 反正我确实这么想 ...
- gitbook 入门教程之前置知识
markdown 基本知识 markdown 是一种简化的 html 语法,相比于 txt 无格式文本更强大. 你可以用专门的软件去编辑 markdown 文件,就像需要使用软件编辑 txt 文件一样 ...
随机推荐
- [Swift]LeetCode598. 范围求和 II | Range Addition II
Given an m * n matrix M initialized with all 0's and several update operations. Operations are repre ...
- [Swift]LeetCode910. 最小差值 II | Smallest Range II
Given an array A of integers, for each integer A[i] we need to choose either x = -K or x = K, and ad ...
- 小伙子,你真的搞懂 transient 关键字了吗?
先解释下什么是序列化 我们的对象并不只是存在内存中,还需要传输网络,或者保存起来下次再加载出来用,所以需要Java序列化技术. Java序列化技术正是将对象转变成一串由二进制字节组成的数组,可以通过将 ...
- 【Spark篇】---Spark故障解决(troubleshooting)
一.前述 本文总结了常用的Spark的troubleshooting. 二.具体 1.shuffle file cannot find:磁盘小文件找不到. 1) connection timeout ...
- Python 工厂函数和内建函数
工厂函数 工厂函数都是类对象, 即当你调用他们时, 创建的其实是一个类实例 例如: str(), list(), tuple()... 内建函数 内建函数通常是python自定义的一些函数, 这些函数 ...
- ECMAScript 6 学习(一)generator函数
1.ES2017标准引入async函数,那么async函数到底是个什么函数呢? async 是一个generator函数的语法糖. 2.那么generator函数到底是什么函数ne? generato ...
- Hystrix针对不可用服务的保护机制以及引入缓存
之前我写过一篇博文,通过案例了解Hystrix的各种基本使用方式,在这篇文章里,我们是通过Hystrix调用正常工作的服务,也就是说,Hytrix的保护机制并没有起作用,这里我们将在HystrixPr ...
- 从零开始学习PYTHON3讲义(八)列表类型跟冒泡排序
<从零开始PYTHON3>第八讲 前面我们见过了不少的小程序,也见过了不少不同类型的变量使用的方法.但目前我们涉及到的,还都是单个的变量和单个的立即数.以变量来说,目前我们见到的,基本都 ...
- Java基础10:全面解读Java异常
更多内容请关注微信公众号[Java技术江湖] 这是一位阿里 Java 工程师的技术小站,作者黄小斜,专注 Java 相关技术:SSM.SpringBoot.MySQL.分布式.中间件.集群.Linux ...
- ELK-log4j2异步输出+logstash
1.pom.xml配置文件 <dependency> <groupId>log4j</groupId> <artifactId>log4j</ar ...