码迷,mamicode.com
首页 > 其他好文 > 详细

发布一本用 GitBook 编辑的书

时间:2019-11-24 22:43:56      阅读:129      评论:0      收藏:0      [点我收藏+]

标签:文件   会员   本地   node   ofo   内容   图片   位置   拷贝   

在上一篇的文章里,我们已经写好了一本名叫 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://your_github_id.github.io/your_github_gitbook 这个地址即可。比如我的 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.> 减压到新的位置

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

发布一本用 GitBook 编辑的书

标签:文件   会员   本地   node   ofo   内容   图片   位置   拷贝   

原文地址:https://blog.51cto.com/14489782/2453100

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!