作为一个新手,只是用Github来保管代码,一直在想有个地方可以展示出自己的项目,可以添加在简历中,原来买过域名、服务器,折腾半天。今天终于学会了如何使用Github Pages展示项目,在保管代码的同时也可以呈现出来,简直不能更棒了!

准备


想要用Github当然得对git有一定的了解,不然就跟用网盘没什么区别。用Github Pages需要大概的知道如何使用git上传代码,如何创建分支等基本概念。

首页


  • 创建一个新的仓库,名字为 github用户名.github.io,例如 xxx.github.io
  • github pages 绑定域名 github pages教程_用户名

  • 创建好之后进入仓库中,点击settings进入设置
  • github pages 绑定域名 github pages教程_git_02

  • 点击Github Pages 中的 Launch automatic page generator生成一个初始的页面

github pages 绑定域名 github pages教程_github_03

  • 接下来进入的页面是一些原始页面将要呈现的信息,可以不用改,之后直接修改文件即可,直接点击Continue to layouts进入下一步
  • github pages 绑定域名 github pages教程_github pages 绑定域名_04

  • 选择一个主题,可以选一个喜欢的,或者后期自己写
  • github pages 绑定域名 github pages教程_git_05

  • 现在就已经创建好了一个属于你的Github Pages了,点开这个项目可以看到生成的HTML、js、css代码,可以自己克隆到本地来修改为你的主页啦。用浏览器登录 用户名.github.io就可以看到效果啦。

项目展示


第一种方法

  • 可以通过上面的方法点击settings在项目仓库中直接创建一个page,此时会自动创建一个新的分支 gh-pages ,不懂分支的同学可以去搜索一下,有点点支线任务的感觉吧哈哈。将项目代码传到此分支中即可在 用户名.github.io/本仓库名 中看到效果

第二种方法

  • 第一种方法比较麻烦,下面有一个更简单的方法,建议学习git之后再学习此方法
  • 有些项目的最终代码会放在dist目录中,例如压缩等等操作之后的存放文件夹,可以将这个文件夹传入项目的gh-pages分支中即可达到展示项目的目的
  • 可以在本地仓库中打开git-bash(需要安装git),命令行中输入git subtree push --prefix=dist origin gh-pages ,这条命令可以创建gh-pages分支,并把dist文件传到项目的gh-pages分支中。
  • 也可以把整个项目放在gh-pages分支中,用git push origin gh-pages命令将其放入分支
  • 最后 浏览器输入 用户名.github.io/本仓库名 查看吧