Gitbook | 编辑与发布

如何编辑、发布和远程访问电子书?

Posted by Haauleon on March 12, 2021

本地编辑电子书

  需要使用 Gitbook 官方的图形化编辑工具 Gitbook Editor 来编辑电子书。
  首先还是需要下载安装 Gitbook Editor,安装好后运行它。这里我选择的是Do that later,因为 Gitbook 平台的账号登录功能需要翻墙才能使用。其实 Gitbook Editor 编辑器的使用同大多数 Markdown 编辑器的使用差不多,所以之后基于图形界面的操作就省略了,先来看一下 Gitbook Editor 编辑页面是什么样子。




生成静态页面资源

  Gitbook Editor 编辑电子书完成之后进入书籍目录,执行$ gitbook build 或者 $ gitbook serve 命令即可生成静态页面资源存于_book目录下。这两个命令的不同之处在于,使用$gitbook serve命令在生成静态资源的同时还可以打开浏览器输入localhost:4000 在本地预览电子书。

1
2
3
4
5
$ cd 书籍目录
$ gitbook build

或者:
$ gitbook serve



发布电子书

  本地库的电子书编辑好了后要想发布并进行远程访问,首先需要在 Gitbook 官网使用平台账号或者第三方账号进行登录,然后在此平台创建跟本地相同的书名等等,后面的就没有再研究了,因为需要翻墙。下面列举了几个可以远程访问电子书的方法。



方法一:发布到私有云服务器

  此处省略一千字。



方法二:托管到第三方平台

  详见下一章:使用 Github Pages 托管静态资源。



方法三:发布到看云

  先进行本地仓库备份到github远程库,在看云https://www.kancloud.cn上导入github仓库,编辑完成同步到版本库后直接发布,即可访问电子书。还可在自己的域名解析内增加一条记录,即自定义域名。比如这本书的访问地址是book.haauleon.com