具体效果
github不仅能免费提供代码托管,此外还提供了创建github博客的功能,网上有jekyll的方法,之前我试过最终由于Ubuntu下安装ruby及其他组建失败没成功,过程也比较繁琐,但有另一种方法,操作起来很简单,而且达到的效果也很好,那就是通过hexo搭建github博客。搭建环境为window,
步骤
1.安装git客户端,以及github账号:通过gitBash 生成ssh key,将公钥加入到github中,具体方法,百度搜索:为gthub配置ssh key。
2.登陆github创建仓库,注意仓库名必须和用户名相同,比如username/username.github.io 将username换成自己的用户名,是用户名不是注册邮箱。
3.安装node,去node官网下载安装包, .msi文件,通过npm安装hexo,Hexo 是一个基于nodejs 的静态博客网站生成器,作者是来自台湾的 Tommy Chen,具体安装方法参照hexo官网介绍。注意
npm install hexo-cli -g 是在安装完node后,开始菜单里会有个node的命令行工具,在这里面入的。
4.随便选择目录创建要生成博客的文件目录,进入该目录:右键选择git bash 输入
$ hexo init <folder>
$ cd <folder>
$ npm install
folder 为要创建博客的文件夹名称。
5.通过以上步骤做完后,继续输入 hexo server 启动服务器,就可以用浏览器访问localhost:4000/ 查看效果了。
博客文件目录
├── _config.yml
├── package.json
├── scaffolds
├── scripts
├── source
| ├── _drafts
| └── _posts
└── themes
根目录的_config.yml文件是站点设置,可应用于真个站点,在theme目录下也有个_config.yml该设置仅适用于当前主题,换个主题就不适用了。
根目录的_config.yml的详细配置参照
此处
目前博客仅限于本地访问,要部署到github上需要将_config.yml中的deploy改为:
deploy:
type: git
repository: https://github.com/username/username.github.io.git
branch: master
保存在gitbash中输入:hexo deploy 成功后,github在国外,估计要等上几分钟再能访问username.github.io.git 看到效果,推荐部署到gitcafe上面,很快就能看到效果,如果部署到gitcafe的话需要改为:
deploy:
type: git
repository: https://gitcafe.com/username/username.gitcafe.io.git
branch: gitcafe-pages
主题的安装:
$ cd your-hexo-site`
$ git clone https://github.com/iissnan/hexo-theme-next themes/next
next 是主题文件夹的名字,可以任意取名。如果要设置当前主题为next只需要在根目录的_config.yml文件中theme: next
注配置文件中的冒号后必须有一个空格。
这里推荐一个主题next,我个人比较喜欢,主题继承了评论,rss等功能,具体设置见此处,比如要增加多说插件,只需要在该主题文件下的_config.yml的duoshuo_shortname:name
后填写申请的名称即可,非常方便。
注意一下几点:
1.关于hexo的命令输出都是在git bash下输入的
2.配置文件中的冒号后必须有空格
3.本地文件的任何改动都需要再hexo generate一下在部署,才会生效。
我本人在安装过程中参照 http://zipperary.com/2013/05/28/hexo-guide-2/ 的文章,但其中部分内容不适合新版本的hexo。如果机子上给github生成过ssh key,再给gitcafe生成ssh key时估计会连接不上gitcafe,生成ssh key时需要指定文件名,和给github生成略有不同。具体请百度