作为一个新手,只是用Github来保管代码,一直在想有个地方可以展示出自己的项目,可以添加在简历中,原来买过域名、服务器,折腾半天。今天终于学会了如何使用Github Pages展示项目,在保管代码的同时也可以呈现出来,简直不能更棒了!
准备
想要用Github当然得对git有一定的了解,不然就跟用网盘没什么区别。用Github Pages需要大概的知道如何使用git上传代码,如何创建分支等基本概念。
首页
- 创建一个新的仓库,名字为 github用户名.github.io,例如 xxx.github.io
- 创建好之后进入仓库中,点击
settings
进入设置 - 点击Github Pages 中的
Launch automatic page generator
生成一个初始的页面
- 接下来进入的页面是一些原始页面将要呈现的信息,可以不用改,之后直接修改文件即可,直接点击
Continue to layouts
进入下一步 - 选择一个主题,可以选一个喜欢的,或者后期自己写
- 现在就已经创建好了一个属于你的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/本仓库名 查看吧