说明

自己在使用hexo搭建静态博客的时候踩了许多坑,最终去官网看教程搞定了,  
建议用hexo搭建个人博客的时候,最好看清教程的日期和使用的版本,这样就  
不会因为版本的不同导致的问题了.建议先去hexo官网了解一下

hexo官网

1.准备工作

1. 安装nodejs

   • 去官网下载nodejs安装(推荐安装0.12.x),安装之后在命令行 node -v,如果成功说明node环境ok,不成功就去环境变量配置一下.

2. 安装hexo

   • 使用命令 npm install hexo -g,执行hexo -v 查看版本,本教程适合3.1.1版本

3. 安装git

   • 去官网下载git安装,不会自行百度

4. 配置git

   • 配置ssh私钥,上传到github上

2.github-pages和gitcafe-page的说明

1. github有两种主页,一种是github-page(个人主页),一种是项目主页,本教程针对个人主页

2. gitcafe-page的个人主页只是在项目下有一个gitcafe-pages的分支,部署成功后访问主页即可

3. github-page需要将hexo博客发布到repository的master(主干)即可

4. gitcafe需要将hexo博客发布到repository的gitcafe-pages的分支

5. github的个人主页要求repository的名称和username一致，加入username是tom，则repository的名称为tom.github.io

3.使用hexo写博客

• 新建一个文件夹myblog,

• 右键git bash here使用git的shell

• 在shell中输入hexo init,回车执行

• 在shell中输入hexo g ,回车

• 在shell中hexo s,回车

• 去浏览器访问http://localhost:4000,访问到主页,然后在shell中ctrl c停止

• 在shell中hexo new “first-blog”,回车

• 在shell中hexo g ,回车

• 在shell中hexo s ,回车,在访问

• ok,在本地测试就没问题了

4.发布到github和gitcafe

• 打开项目根部录下的.config.yml,找到deploy,修改如下:

   deploy:
    - type: git
      repo: git@github.com:yourname/yourname.github.io.git,master
    - type: git 
      repo: git@gitcafe.com:yourname/yourname.git,gitcafe-pages

• 如果只发布到github或者gitcafe上,修改如下:git的branch是master,gitcafe的是gitcafe-pages

deploy:
  type: git
  repo: <repository url>
  branch: [branch]
  message: [message]

访问地址就是 http://tom.github.io/

5.常见问题

1. 部署时出现git not found

   • npm install hexo-deployer-git –save 安装依赖包

6.详细设置

• 每个人对自己的博客都有不一样的要求，比如主题，分类，标签，评论插件的选择，
  这些对程序员的你来说，都是小菜一碟，下面是官网教程：

hexo官方文档

7.gitcafe博客迁移到coding

• 由于gitcafe被coding收购,所以不能往gitcafe提交代码了,迁移到coding是很简单的.
  coding也同样提供个个人的page功能,也是免费的.如何使用coding和hexo搭建博客?

参考我的文章 hexo和coding搭建个人博客

博客效果可以看我的个人博客 我的个人博客