发布一本用 GitBook 编辑的书

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

发布一本用 GitBook 编辑的书

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

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

使用 GitHub 发布你的书籍

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

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

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

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

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

GithubPagesDocs

做完上述步骤以后开始使用 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.> 减压到新的位置

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

相关文章
|
2月前
|
Android开发
我用过的笔记 Markdown Wiki 工具
我用过的笔记 Markdown Wiki 工具
|
7月前
|
缓存 JavaScript 前端开发
hexo 命令速查小册
hexo 命令速查小册
|
API
【工具推荐】 Obsidian 插件 Obsidian to Flomo 一键同步内容到 Flomo 插件
Obsidian to Flomo 是一款可以一键发送内容到 Flomo 的Obsidian 插件。
656 0
|
5天前
|
JavaScript 搜索推荐 前端开发
《VitePress 简易速速上手小册》第2章:Markdown 与页面创建(2024 最新版)
《VitePress 简易速速上手小册》第2章:Markdown 与页面创建(2024 最新版)
21 0
|
9月前
|
前端开发 Linux C++
又一款神级插件,这下连PPT都不用装了|在VSCode中用Markdown写PPT
又一款神级插件,这下连PPT都不用装了|在VSCode中用Markdown写PPT
|
10月前
|
Java API 开发工具
vim插件开发之osc动弹插件
vim插件开发之osc动弹插件
97 0
|
机器人
gitbook 插件 阅读更多
gitbook 插件 阅读更多
|
JSON 缓存 NoSQL
重新更新VScode配置(C/C++)——负责任、手把手教学,亲测有效
对于C/C++的编程环境来说,目前我们所接触到的、所用到的,除了vim以外,大众用的、尤其是学生群体用的主要是有三种。
1116 1
重新更新VScode配置(C/C++)——负责任、手把手教学,亲测有效
|
缓存 Java 程序员
Nexus3常用功能备忘
将日常用到的nexus3功能和配置记录下来
266 1
Nexus3常用功能备忘
|
Linux C语言 C++
增设章节---VScode 的详细安装方式(已亲测)
针对网上根据很多安装vscode的文章,大多数都有一些问题,例如打不开launch.h等等。同时,应部分读者的建议和需求,特此,增设本安装vscode方法的章节
217 0
增设章节---VScode 的详细安装方式(已亲测)