概况
- 为什么选择GitHub Pages
1、GitHub Pages有免费的代码托管空间,资料自己管理,保存可靠;
2、学着用 GitHub,享受 GitHub 的便利,上面有很多大牛,眼界会开阔很多;
3、顺便理解 GitHub 工作原理,最好的团队协作流程;
4、GitHub建立私有仓库才会收费,所以会有很多开源代码。- GitHub Pages是什么
应用GitHub Pages创建属于自己的个人博客,GitHub将提供免费的空间。GitHub提供的域名(用户名+github+io),在Repository name对应处填写资源名,其需要使用自己的用户名,每个用户名下面只能建立一个,并且资源命名必须符合这样的规则username/username.github.io,之后勾选下面的”Initialize this repository with a README” 。- hexo出自何人
hexo出自台湾大学生 tommy351 之手,是一个基于Node.js的静态博客程序,其编译上百篇文字只需要几秒。hexo生成的静态网页可以直接放到GitHub Pages,BAE,SAE等平台上。
安装准备
环境搭建:
安装Node
到 Node.js 官网下载相应平台的 最新版本 ,一路安装即可。我用的是 node-v0.10.22-x86.msi
安装Git
Git的客户端很多,我用的是 msysgit ,喜欢用绿色版本 Portable application for official Git for Windows 1.8.4 ,下载下来设置一下环境变量即可,Git_HOME,%Git_HOME%\bin之类的,不多说。
安装Sublime
Sublime Text 2 在这里仅仅作为一个文本编辑器使用,支持各种编程语言和文件格式,当然也支持Markdown语法,实在是个不可多得的练码奇才。喜欢追鲜的也可以尝试处于beta版本的 Sublime Text 3 。
GitHub注册与配置
- 注册:
访问:GitHub,注册你的username和邮箱,邮箱十分重要,GitHub上很多通知都是通过邮箱的。注册过程比较简单,详细也可以看:
使用Github Page搭建博客, 需要遵循一定的规则, 需要在github建立仓库,仓库名为Github用户.github.io, 更多详情请参考官方文档
- 配置和使用Github
以下教程主要参考beiyuu的《使用Github Pages建独立博客》写成。
- 配置SSH keys
我们如何让本地git项目与远程的github建立联系呢?用SSH keys。
打开Git Bash工具,执行以下操作
- 检查SSH keys的设置
// 首先我们需要检查你电脑上现有的ssh key:
$ cd ~/. ssh 检查本机的ssh密钥
// 如果提示:No such file or directory 说明你是第一次使用git。
// 生成新的SSH Key:
$ ssh-keygen -t rsa -C "邮件地址@youremail.com"
Generating public/private rsa key pair.
Enter file in which to save the key
(/Users/your_user_directory/.ssh/id_rsa):<回车就好>
注意1: 此处的邮箱地址,你可以输入自己的邮箱地址;
注意2: 此处的「-C」的是大写的「C」
然后系统会要你输入密码:
Enter passphrase (empty for no passphrase):<输入加密串>
Enter same passphrase again:<再次输入加密串>
在回车中会提示你输入一个密码,这个密码会在你提交项目时使用,如果为空的话提交项目时则不用输入。这个设置是防止别人往你的项目里提交内容。
注意:输入密码的时候没有*字样的,你直接输入就可以了。
- 添加SSH Key到GitHub
- 在本机设置SSH Key之后,需要添加到GitHub上,以完成SSH链接的设置。
- 打开本地C:\Documents and Settings\Administrator.ssh\id_rsa.pub文件。此文件里面内容为刚才生成人密钥。如果看不到这个文件,你需要设置显示隐藏文件。准确的复制这个文件的内容,才能保证设置的成功。
- 登陆github系统。点击右上角的 Account Settings—>SSH Public keys —> add another public keys
- 把你本地生成的密钥复制到里面(key文本框中), 点击 add key 就ok了
- 测试
可以输入下面的命令,看看设置是否成功,git@github.com的部分不要修改:
$ ssh -T git@github.com
如果是下面的反馈:
The authenticity of host 'github.com (207.97.227.239)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)?
不要紧张,输入yes就好,然后会看到:
Hi cnfeat! You've successfully authenticated,
but GitHub does not provide shell access.
设置用户信息:
现在你已经可以通过SSH链接到GitHub了,还有一些个人信息需要完善的。
Git会根据用户的名字和邮箱来记录提交。
GitHub也是用这些信息来做权限的处理,输入下面的代码进行个人信息的设置,把名称和邮箱替换成你自己的,名字必须是你的真名,而不是GitHub的昵称。
$ git config --global user.name "cnfeat"//用户名
$ git config --global user.email "cnfeat@gmail.com"//填写自己的邮箱
SSH Key配置成功,本机已成功连接到github。
Hexo博客
Hexo
Hexo的作者是tommy351,根据官方介绍,Hexo是一个简单、快速、强大的博客发布工具,支持Markdown格式。hexo的主题列表 Hexo Themes。 我比较喜欢 pacman , modernist 、 ishgo , raytaylorism 。
安装Hexo
打开Git Bash工具(前提确保Node.js已经安装,环境配置OK)
$ npm install -g hexo
部署Hexo
在我的电脑中建立一个名字叫「Hexo」的文件夹,然后在此文件夹中右键打开Git Bash。
$ hexo init
如果无法使用右击“Git Bash”,则可以切换到指定目录
UUhike@UUhike-pc MINGW64 ~
$ cd j:/github/hexo
UUhike@UUhike-pc MINGW64 /j/github/hexo
安装依赖包
$ npm install
Hexo随后会自动在目标文件夹建立网站所需要的所有文件。
现在我们已经搭建起本地的hexo博客了,
执行以下命令(在H:\hexo),然后到浏览器输入localhost:4000看看。
本地查看
$ hexo generate #生成静态页面至public目录(最终上传这个文件到GitHub)
$ hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
部署到GitHub
编辑E:\hexo下的_config.yml,修改Deployment部分:
# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
type: git
repository: git@github.com:silvia-YQY/silvia-YQY.github.io.git
branch: master
hexo简写命令
$ hexo g #生成
$ hexo s #启动本地服务,进行文章预览调试
或者直接作用组合命令
$ hexo deploy -g
$ hexo server -g
简写:
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy