手把手教你GitBook使用(四)

简介: 详细的记录了一步步搭建自己的电子文档笔记

3.4 查看帮助


1.png3.5 发布

可以使用 Github Pages 服务将我们写的 gitbook 发布到互联网上,前提是你已经了解了 Git、Github 及 Github Pages 的使用。

3.5.1 发布到 Github Pages


1. 将静态网站直接发布到 Github Pages

可以将编写好的 .md 文件通过 Gitbook 处理成静态网站,然后发布到Github Pages 上。


这个参考这个:[https://www.yuque.com/docs/share/9afacf4e-005e-4c5e-8373-a81af2940a68?# 《利用 GitHub 从零开始搭建一个博客》](https://www.yuque.com/docs/share/9afacf4e-005e-4c5e-8373-a81af2940a68?# 《利用 GitHub 从零开始搭建一个博客》)


3.5.2 使用项目的 Pages 服务

除了上面的直接发布静态文件到 Github Pages 的方法以外,还可以使用一个单独的项目的 Github Pages 功能。


1. 创建仓库与分支

登陆到 Github,创建一个新的仓库,名称我们就命名为 book ,这样我就得到一个 book 仓库。(创建的时候小白推荐选上 README.md 初始化)

克隆仓库到本地: git clone git@github.com:/USER_NAME/book.git

创建一个新分支: git checkout -b gh-pages,注意,分支名必须为 gh-pages 。

将分支 push 到仓库: git push -u origin gh-pages。

切换到主分支:git checkout main。

经过这一步处理,我们已经创建了 gh-pages 分支了,有了这个分支,Github会自动为你分配一个网址。


http://USERNAME.github.io/book


同步静态网站代码到分支:


下面我们就可以将 build 好的静态网站代码同步到 gh-pages 分支中去了。


把 build 成功的文件复制到 book 本地的 book 文件夹中。


1.切换 git 分支

2.png

我的实际操作:

3.png

接下来,输入下面的一系列命令:

4.png

然后,等十来分钟后,你就可以访问到你的在线图书了。以后,只要你每次修改之后,将生成静态网站 Copy 到 book 目录,然后运行上面三条命令一下就 OK 了。

目录
相关文章
|
缓存 JavaScript 前端开发
hexo 命令速查小册
hexo 命令速查小册
|
JavaScript 开发工具 git
GitBook新手入门
GitBook是使用Git管理书籍项目,使用Markdown撰写书籍,并使用GitHub和GitBook网站进行托管的一个实用工具。下面简单说一下新手如何使用该强大的工具。
138 0
|
Python Windows
Python安装教程-手把手教你安装
Python安装教程-手把手教你安装
Python安装教程-手把手教你安装
|
缓存 JavaScript 前端开发
gulp安装教程(简单的前端自动化教程)
gulp安装教程(简单的前端自动化教程)
266 0
|
JavaScript
Hexo 入门指南(七) - 评论 & 分享
Hexo 入门指南(七) - 评论 & 分享
74 0
|
JavaScript Ubuntu
gitbook 快速入门
gitbook 快速入门
gitbook 快速入门
|
JavaScript 开发者 SEO
vuepress入门教程
vuepress入门教程
1480 0
|
JSON JavaScript 数据格式
Gitbook 使用笔记
Gitbook 使用笔记
279 0
Gitbook 使用笔记
手把手教你GitBook使用(二)
详细的记录了一步步搭建自己的电子文档笔记
159 0
手把手教你GitBook使用(二)