由于经常用到,所以总结一下,以便未来取用。
github项目的配置
- 首先在github上新建Repositories
- 使用github Desktop克隆仓库
这样就将项目克隆到了本地文件夹下。
github Pages的发布
GitHub Pages 可以当做你或者你的项目的 Websites,那么我们可以知道 GitHub Pages 有两种最基本的用法:
一, 作为你自己(或者组织)的网站(访问地址示例:http://username.github.io)作为你某一个项目的网站(访问地址示例:http://username.github.io/projectname)
- 创建一个仓库
并以 http://username.github.io 作为仓库名,其中 username 是你 github 的用户名,这个名字不能出错。如果出错,那么需要你删掉这个仓库重来,更改仓库名是无效的。 - 为此仓库添加内容
你可以直接在 github 网站上的此项目的仓库下直接点击 create new file(比如index.html),然后输入内容,并保存。也可以将此项目从 github 克隆到本地,然后在本地添加要展示的内容,并 push 到远程仓库。 - 访问
完成以上步骤,你就可以在浏览器用 http://username.github.io 格式的网址访问你的网页了。 注意:在访问之前你可能需要等待一段时间,等待 DNS 服务器刷新 github 分配的新域名。至此,你的网站就可以正常使用了。 - 个性化设置
你可以在此项目的 Setting 选项下边更改你的个性化设置,比如绑定你的个人域名、开启 HTTPS 等等。
二,用作某一个项目的网站
- 创建一个仓库
如果是为已有项目创建,此步省略,直接进入下一步。 - 创建 index.html 并提交
这里只提一种在线操作的方式,你也可以将仓库克隆下来到本地操作- 进入目标仓库,点击 create new file
- 提交文件 ,这里需要注意的是选择提交到哪个分支,你可以像图中那样提交到 master分支,但我建议你创建一个 gh-pages 分支,这样更新项目的网站就不会影响项目的开发。
- 设置 GitHub Pages 的 source
点击项目的 Settings 按钮,找到 GitHub Pages 选项,然后选择相应的分支作为 source,如果你在上一步选择了创建 gh-pages 分支,那么这里就无需设置,因为 github 默认 gh-pages 分支作为项目的 GitHub Pages source,当你创建 gp-pages 分支的时候就会自动为你设置好。 - 访问
为项目创建的 websit 的网址格式是:http://username.github.io/projecname
用 GitHub Pages 测试静态网页
通过以上内容,你应该可以发现,GitHub Pages 是可以测试静态网页的,操作也很简单。在完成以上两种设置的任何一种后,将需要测试的文件(如:test.html)放到对应的目录下(为方便,放在和上文中的 index.html 同一目录下是最佳选择),然后就可以以一下格式网址访问静态网页:
http://username.github.io/test.html 或 http://username.github.io/projecname/test.html