title: 使用 github + hexo 搭建博客
1.配置环境
安装 node.js
这里我推荐大家使用 v5 的版本,下载传送门:
https://nodejs.org/dist/v5.12.0/
安装 git
下载传送门:
安装 hexo
安装完git之后就可以安装hexo了,如果某些同学的电脑桌面上没有git bash,可尝试在开始菜单里查找。打开git bash 之后输入以下命令回车将hexo安装到全局。
$ npm install -g hexo
测试安装 hexo
$ hexo -v
如果显示以下内容则安装成功。版本不同可能会有少许差异,不过无伤大雅
hexo-cli: 1.0.2
os: Windows_NT 10.0.14393 win32 x64
http_parser: 2.7.0
node: 5.12.0
v8: 4.6.85.32
uv: 1.8.0
zlib: 1.2.8
ares: 1.10.1-DEV
icu: 56.1
modules: 47
openssl: 1.0.2h
安装完所需的软件之后就要在github上面新建一个库
点击绿色按钮新建库
在Repository name的输入框内写入和你的owner名字+github.io(切记一定要一致)
2.本地配置
hexo初始化
前面我们已经安装完了hexo,但是我们还需要给它初始化,在你的任意一个盘符里新建一个文件夹,这里我选择的是在C盘新建的一个hexo的文件夹。打开文件夹右键git bash,输入以下命令。
$ hexo init
生成静态页面
$ hexo generate
启动本地预览
然后在浏览器中输入http://localhost:4000/查看生成的页面效果。
$ hexo server
3.关联github
本地配置
这里打开前面自己新建的文件夹下面的_config.yml文件,用记事本打开即可。在文件的最下方,添加如下配置。(注:每一个冒号之后需要空一格,第一个Jun-Dong为Github的用户名,第二个Jun-Dong为之前New的Repository的名字,不要把我的给复制上去了,还有type一定要保持缩进)
deploy:
type: git
repository: https://github.com/Jun-Dong/Jun-Dong.github.io
branch: master
配置SSH
如果你是第一次使用github则需要配置SSH key.
右键选择git bash ,输入以下命令,your_email@youremail.com换成注册github的邮箱号。
$ ssh-keygen -t rsa -C "your_email@youremail.com"
之后会要求确认路径和输入密码,我们这使用默认的一路回车就行,成功的话会在C:\Users\Administrator下生成.ssh文件夹,如果你的电脑的用户名是中文,则会在C:\用户\电脑用户名下生成.ssh文件夹,进入该文件夹,以文本的形式打开idrsa.pub,复制里面的key,即复制文件的全部内容。如果你在这边只看见2个idrsa文件,没看到id_rsa.pub,应该是你把后缀名隐藏了,可以设置显示后缀,或者直接把两个文件都以文本的形式打开,内容短的并且以ssh-rsa开头的即为所需的SSH key。回到github,进入Settings,选择SSH and GPG Keys -> New SSH Key,title随便填,粘贴key。为了验证是否成功,在git bash下输入:
$ ssh -T git@github.com
有些童靴如果显示continue,输入yes就会看到:You’ve successfully authenticated, but GitHub does not provide shell access ,这就表示已成功连上github。
上传本地库到github
$ git config --global user.name "your name"
$ git config --global user.email "your_email@youremail.com"
继续部署github
安装所需插件
$ npm install hexo --save
$ npm install hexo-deployer-git --save
然后分别执行以下三条指令:
$ hexo clean
$ hexo g
$ hexo d
部署成功后,你在浏览器中输入yourname.github.io,就能看到和本地一样的效果了
写文章
在此处新建md文件即可