发布到Github Pages

这个功能主要是将我们的书籍项目编译成静态网站文件,然后将静态网站文件上传到 Github 上,使用 Github 的 Pages 服务,创建一个属于自己的静态网站的一个功能,然后就可以利用 Github 来访问我们书籍了。

Github 官网也有对提供的 Pages有详细的说明,官网参考:https://pages.github.com

申请 Github 账号

首先的条件就是需要一个自己的 Github 账号,如果没有的话,可以去官网上申请注册一个自己的 Github 账号,官网地址:https://github.com

注册如下所示:

注册Github账号
Image 7.1.1.1 - 注册Github账号

创建一个项目仓库

Github 中创建一个自己的项目仓库,名字按照你的想法去取,没有限制,当然建议大家尽量取一个有意义,简单易于理解的名字。

如下所示:

Github中创建一个仓库
Image 7.1.1.2 - Github中创建一个仓库

推送静态网站文件到Github仓库中

将自己书籍项目编译出来的静态网站文件推送到刚刚创建的 Github 中的项目中。具体推送的方法这里就不具体细细的介绍了,可以参考相关的 Git 的教程和 Github 新创建项目中的使用说明。

[!NOTE|style:flat]在这里推荐一个大家学习 Git 和 远程仓库的相关教程的学习网站,廖雪峰的Git教程:https://www.liaoxuefeng.com/wiki/896043488029600

github快速使用指南示例参考:

Github远程仓库快速指南
Image 7.1.1.3 - Github远程仓库快速指南

创建 Pages 服务并部署自己的静态网站

在需要创建 Pages 服务的项目中点击 “Settings” 按钮,滑动选项到 Pages 选项,选择需要创建 pages 服务的分支部署的目标资源目录(目前github仅支持指定项目的根目录根目录下的docs目录),选择好之后保存就可以根据提示的网址链接来访问你部署的书籍的静态网站了。

[!TIP|style:flat]

需要注意,目标仓库中必须有 index.html 才可以正常访问 !

示意图

点击Settings按钮
Image 7.1.1.4 - 点击Settings按钮
Pages配置
Image 7.1.1.5 - Pages配置
Pages设置完成
Image 7.1.1.6 - Pages设置完成
Pages在线网站访问
Image 7.1.1.7 - Pages在线网站访问

在线访问本书的github pages网站: https://jiangminggithub.github.io/gitbook/

Copyright ©JiangMing all right reserved,licensed by MIT更新时间: 2021-04-10 19:03:23

results matching ""

    No results matching ""