3.4 查看帮助
3.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 分支
我的实际操作:
接下来,输入下面的一系列命令:
然后,等十来分钟后,你就可以访问到你的在线图书了。以后,只要你每次修改之后,将生成静态网站 Copy 到 book
目录,然后运行上面三条命令一下就 OK 了。