文章目录
  1. 1. 1, 不一定要购买域名
  2. 2. 2,使用gh_pages分支创建的页面
  3. 3. 3,举例说明
  4. 4. 4,hexo搭建
    1. 4.1. 推荐几篇好文章:
  5. 5. 5,hexo部署
  6. 6. 6,gitcafe博客
  7. 7. 7,配置评论系统和百度统计

把hexo博客的源码和生成的页面实时同步到github和gitcafe。

用搜索引擎搜索”github 博客”等关键字会出现大量很好的文章教小白一步步搭建。我这里列出一些关键点,希望可以让你少走弯路。这篇博客的markdown源代码在:https://gitcafe.com/cwjcsu/cwjcsu/blob/master/source/_posts/hexo-github-gitcafe.md
其他涉及的源码在同一个仓库可以找到。

1, 不一定要购买域名

很多文章都有介绍购买域名,并在根目录下配置CName文件,其实不一定要购买的。Github会给每个用户一个二级域名:cwjcsu.github.io。这个二级域名下,你可以定制样式、404页面等等,记住最重要的一点:你创建的github的仓库名称必须是cwjcsu.github.io,这样你只要在master分支上 仓库根目录push一个index.html,这个页面就可以通过 http://cwjcsu.github.io 访问到。cwjcsu是我的github用户名,实际操作中替换成你的即可。

2,使用gh_pages分支创建的页面

在github上,你可以为你的任何仓库添加一个网站,你只需要:

  1. 把网站的页面push到这个仓库的gh_pages分支;(github有向导可以指引你自动创建这个分支)
  2. 通过http://username.github.io/reponame 进行访问(即http://博客地址/仓库名称/)。我的github博客地址是:http://cwjcsu.github.io/,而joutable是我一个开源项目的仓库名称,它的页面可以通过http://cwjcsu.github.io/joutable 访问到

3,举例说明

我在github上面的首页是:https://github.com/cwjcsu
我在github上的博客源码仓库是:https://github.com/cwjcsu/cwjcsu.github.io
我在github上博客首页:http://cwjcsu.github.io
我的一个开源项目joutable仓库是:https://github.com/cwjcsu/joutable ,有两个分支,一个是master放置开源项目源码,一个是gh_pages放置项目介绍页面可以通过http://cwjcsu.github.io/joutable/ 访问

4,hexo搭建

hexo主页:https://hexo.io/
经过试用,hexo用来写博客真是不二选择(配合sublime Text3 +Markdown Editing,),具有下面的优势:

  1. 使用markdown,完美支持github-flavored-markdown
  2. 实时本地预览,(#hexo s 创建一个本地http-server在本地实时预览你的博客网站)
  3. 大量丰富的主题模版(https://hexo.io/themes/)
  4. 支持Tex语法(通过mathjax:https://www.mathjax.org )
  5. 一键部署到多个站点(这个是我自己写的git脚本,下面有介绍)

使用hexo需要安装nodejs,npm,以及其他的依赖工具,网上教程不少,本文不赘述(遇到问题可以给我留言),不过特别提醒以下几点:

  1. .yml 配置文件采用缩进进行分开,key和value之间至少要有一个空格;
  2. 如果hexo生成的html里面有乱码,那是对应的源文件没有用UTF-8保存,你可以使用nodepadd++或者记事本把他们保存为UTF-8,然后重新生成即可;
  3. 使用<!--more-->用来分割摘要和正文,上面部分是摘要,会出现在主页。同wordpress。
  4. description:xxx 会生成网页的description描述:<meta property="og:description" content="xxx">这是SEO需要注意的地方。

推荐几篇好文章:

hexo搭建博客:http://www.cnblogs.com/zhcncn/p/4097881.html
hexo的Jacman主题:https://github.com/wuchong/jacman
hexo配置介绍:https://hexo.io/docs/configuration.html
markdown大全:http://cwjcsu.gitcafe.io/2015/09/26/markdown-learning/

5,hexo部署

在hexo配置文件_config.yml 有个deploy的配置项目用来配置git仓库,注意type需设置为git,是hexo3中的类型,需要安装:hexo-deployer-git:

npm install hexo-deployer-git --save

网上的教程大多是hexo2的,很多文章没有指出这个区别。

#hexo deploy 可以一键部署到github仓库,但是我需要部署到不同仓库,所以没有采用hexo的自动部署,二是写了一个脚本:
在hexo生成的博客根目录cwjcsu.github.io下有个脚本:up.sh

#!/bin/bash

git commit -am "$1"
git push github master:master
git push gitcafe master:gitcafe-pages

于是,可以通过下面命令一键把生成的博客内容更新到github和gitcafe了。

#./up.sh "commit comment"

下面是我的git配置文件:cwjcsu.github.io/.git/config

[core]
repositoryformatversion = 0
filemode = false
bare = false
logallrefupdates = true
symlinks = false
ignorecase = true
hideDotFiles = dotGitOnly

[remote "gitcafe"]
url = git@gitcafe.com:cwjcsu/cwjcsu.git
fetch = +refs/heads/*:refs/remotes/gitcafe/*

[remote "github"]
url = git@github.com:cwjcsu/cwjcsu.github.io.git
fetch = +refs/heads/*:refs/remotes/github/*

[branch "master"]
remote = github
merge = refs/heads/master

可以看到有两个remote:github和gitcafe,分别配置github和gitcafe上面我的博客所在的仓库地址。up.sh脚本中gitcafe的分支是gitcafe-pages而不是master,仓库名称也不是域名而是直接用户名。这是因为gitcafe博客与github博客略有不同,下面会介绍。
为了避免每次push都提示你输入用户名和密码,你需要在github和gitcafe中添加你的公钥,具体操作本文不赘述。[user]部分我没有贴出来。

6,gitcafe博客

与github不同的是,创建gitcafe的博客,你只需要创建一个和你的用户名一样的仓库,然后把页面push到这个仓库的gitcafe-pages分支即可,然后把源码push到这个分支的master。
比如:
博客所在仓库是:https://gitcafe.com/cwjcsu/cwjcsu
博客源码的分支是master:https://gitcafe.com/cwjcsu/cwjcsu/tree/master
博客页面分支是gitcafe-pages:https://gitcafe.com/cwjcsu/cwjcsu/tree/gitcafe-pages

这两个分支与github上两个仓库代码是同一份,我又写了个脚本,用来实时push博客源码到两个仓库:blog/up.sh: (blog是博客源码所在目录)

#!/bin/bash

git commit -am "$1"
git push github master:master
git push gitcafe master:master

blog/.git/config:

[core]
repositoryformatversion = 0
filemode = false
bare = false
logallrefupdates = true
symlinks = false
ignorecase = true
hideDotFiles = dotGitOnly

[remote "gitcafe"]
url = git@gitcafe.com:cwjcsu/cwjcsu.git
fetch = +refs/heads/*:refs/remotes/gitcafe/*

[remote "github"]
url = git@github.com:cwjcsu/blog.git
fetch = +refs/heads/*:refs/remotes/github/*

[branch "master"]
remote = github
merge = refs/heads/master

[user]部分我没有贴出来。

7,配置评论系统和百度统计

我使用了国内很火的一个评论系统:多说,注册、添加站点后,只需要把ID设置到hexo主题的_config.yml文件里面即可(注意不是hexo的配置文件而是themes/jacman/_config.yml,jacman是我使用的一个主题)。添加百度统计网上教程很多不赘述。

文章目录
  1. 1. 1, 不一定要购买域名
  2. 2. 2,使用gh_pages分支创建的页面
  3. 3. 3,举例说明
  4. 4. 4,hexo搭建
    1. 4.1. 推荐几篇好文章:
  5. 5. 5,hexo部署
  6. 6. 6,gitcafe博客
  7. 7. 7,配置评论系统和百度统计