hexo建立github,gitcafe博客并实时同步的要点
把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上,你可以为你的任何仓库添加一个网站,你只需要:
- 把网站的页面push到这个仓库的gh_pages分支;(github有向导可以指引你自动创建这个分支)
- 通过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,),具有下面的优势:
- 使用markdown,完美支持github-flavored-markdown
- 实时本地预览,(#hexo s 创建一个本地http-server在本地实时预览你的博客网站)
- 大量丰富的主题模版(https://hexo.io/themes/)
- 支持Tex语法(通过mathjax:https://www.mathjax.org )
- 一键部署到多个站点(这个是我自己写的git脚本,下面有介绍)
使用hexo需要安装nodejs,npm,以及其他的依赖工具,网上教程不少,本文不赘述(遇到问题可以给我留言),不过特别提醒以下几点:
- .yml 配置文件采用缩进进行分开,key和value之间至少要有一个空格;
- 如果hexo生成的html里面有乱码,那是对应的源文件没有用UTF-8保存,你可以使用nodepadd++或者记事本把他们保存为UTF-8,然后重新生成即可;
- 使用
<!--more-->
用来分割摘要和正文,上面部分是摘要,会出现在主页。同wordpress。 - 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是我使用的一个主题)。添加百度统计网上教程很多不赘述。