发布一本用 GitBook 编辑的书

用户头像
耳东
关注
发布于: 2020 年 07 月 19 日



在上一篇的文章里,我们已经写好了一本名叫 erdong-first-book 的书,但是在本地浏览很不方便,我们希望放到网络上,可以随时、方便的访问这个书籍。这个需求可以使用多种方式来实现,比如第一种,可以通过 GitBook 官网来发布这本书,GitBook 除了是一个电子书的工具以为,自身也有一个网址,在该网站注册成为会员后,可以发布自己的电子书,并且可以和 GitHub 进行关联。



除了使用 GitBook 官网以外,可以直接将电子书放在 GitHub 上,通过 GitHub Pages 来发布这本书。

使用 GitHub 发布你的书籍



接下来我们看一下如何使用 GitHub Pages 来发布一本书。



首先你需要一个 GitHub 的账号,在你的账号下创建一个用来放置你书籍的仓库,这两个步骤在网络上有太多的资料,很容易就可以达成了。



创建好仓库以后,在仓库中创建一个 docs 文件夹,用来放置 GitBook 生成的静态文件。



打开 GitHub 仓库的设置页面,找到 GitHub Pages 选项,选择 master branch /docs folder 选项即可。



注意:一定要先在仓库中创建 docs 文件夹,否则无法勾选该选项。





做完上述步骤以后开始使用 Git 上传你写好的内容到 GitHub , 关键点是将 GitBook 生成的静态文件 _book 重命名为 docs 上传替换刚才创建的 docs 文件夹即可。



这个时候使用浏览器打开 http://yourgithubid.github.io/yourgithubgitbook 这个地址即可。比如我的 GitBook 地址是

http://erdong.github.io/gitbook-notes-samples ,大家在点击以后发现会自动跳转到 https://erdong.site/gitbook-notes-samples 是因为我做了域名绑定。

本地 GitBook 迁移



在迁移前可以使用如下命令查看一下曾经使用 npm 安装过什么模块



npm list -g --depth 0
  • list : 已经安装的 node 包

  • -g : 全局的安装包

  • --depth : 包的显示层级,0 代表显示第一级的包,数字越大,显示的越全。



迁移其实非常简单,你在原来的环境将整本书打包,最好把文件夹里的node_modules 目录也一起打包,这样在新的环境就不需要安装这些组件了。在新的环境按照如下顺序依次进行安装你之前安装过的组件



< 1.> 安装 npm

< 2.> 安装 gitbook

< 3.> 拷贝打包好的文件夹

< 4.> 减压到新的位置



这样就完成了你的书的迁移。你在新的位置可以继续进行内容的编写、静态文件的生成,和之前一样,没有任何区别。



发布于: 2020 年 07 月 19 日 阅读数: 35
用户头像

耳东

关注

还未添加个人签名 2020.05.24 加入

还未添加个人简介

评论

发布
暂无评论
发布一本用 GitBook 编辑的书