Hexo+GitHub博客创建

发表于 更新于 分类于 阅读次数：

Hexo安装与设置，GitHub仓库创建，博客创建

1. 下载并安装git和nodejs软件

2. 安装hexo

  • 2.1. 在空闲位置新建hexo文件夹，打开hexo文件夹，右键选择Git Bash，输入命令
1
npm install -g hexo
  • 2.2. 初始化搭建博客所需要的所有文件，输入命令：
1
hexo init
  • 2.3. 安装依赖包。 安装结束后，会出现node_modules文件夹。
1
npm install

3. GitHub上创建仓库

  • 3.1 Github账号注册

  • 3.2 建立一个仓库，所填内容为 username.github.io，比如我的就是jonyafei.github.io

4. 开始部署

  • 4.1 配置 hexo目录下的 _config.yml 文件
1
2
3
4
5
author: jonyafei
language: zh-CN
timezone: Asia/Shanghai

url: http://jonyafei.com
  • 其中，url地址中.com 前为用户名
1
2
3
4
deploy:
  type: git
  repo: https://github.com/jonyafei/jonyafei.github.io.git
  branch: master
  • repo地址为GitHub上建立的仓库地址

5. 设置SSH key

  • 5.1 在Git bash输入以下指令，检查是否已存在SSH Keys。若存在，直接删除.ssh文件夹里所有文件；
1
ls -al ~/.ssh
  • 5.2 输入以下命令（邮箱为注册GitHub时的邮箱)，提示输入passphrase时可直接按Enter键忽略。
1
ssh-keygen -t rsa -C "my_email@163.com"
  • 5.3 依次输入命令：
    1
    2
    ssh-agent -s
    ssh-add ~/.ssh/id_rsa
    若出错，输入以下指令：
1
2
eval `ssh-agent -s`
ssh-add
  • 5.4 打开id_rsa.pub文件，拷贝Key：
    文件在C:/User/user/.ssh/目录下

  • 5.5 在GitHub里设置SSH Key：

  • GitHub 界面右上角 点击层级菜单里的Settings，然后点击右侧的SSH keys，点击Add SSH Key，输入Title描述，粘贴刚刚拷贝的Key内容，点击Add Key，输入GitHub密码完成SSH Key的添加，输入以下命令测试，有警告时输入yes就可以。

1
ssh -T git@github.com

6. 博客创建与发布

打开Git Bash软件，进入hexo目录

  • 6.1 常用命令
1
2
3
4
5
hexo clean
hexo n  #完整命令为hexo new，用于新建一篇文章
hexo g  #完整命令为hexo generate，用于生成静态文件
hexo s  #完整命令为hexo server，用于启动服务器，主要用于本地预览
hexo d  #完整命令为hexo deploy，用于将本地文件发布到GitHub上
  • Q1. 若出现error deployer not found:github错误，执行以下命令
1
npm install hexo-deployer-git --save
  • Q2. 若输入hexo d报下面的错误：
1
2
3
fatal: unable to auto-detect email address (got 'yafei@DESKTOP-IMNML8J.(none)')
error: src refspec HEAD does not match any
error: failed to push some refs to 'https://github.com/jonyafei/jonyafei.github.io.git'
  • 解决方案：依次输入如下两条命令，来指定GitHub上的Email和用户名
1
2
git config --global user.email "jiang_yafei730@163.com"
git config --global user.name "jonyafei"
  • 再次尝试hexo deploy命令，如出现以下提示应该就发布上去了
1
2
3
4
5
remote: Resolving deltas: 100% (6/6), done.
To https://github.com/jonyafei/jonyafei.github.io.git
new branch      HEAD -> master
Branch 'master' set up to track remote branch 'master' from 'https://github.com/jonyafei/jonyafei.github.io.git'.
INFO  Deploy done: git
1
2
hexo g
hexo s
1
hexo s -p 5000
  • 6.3 更新当前博客
1
2
3
hexo clean #可不清理
hexo g
hexo d

7. 博客移植到新电脑上

7.1 安装Git和node.js软件，同上

7.2 安装hexo

  • 7.2.1 在空闲位置新建hexo文件夹，打开hexo文件夹，右键选择Git Bash，输入命令
1
npm install -g hexo-cli

依旧用hexo -v 查看一下版本

  • 7.2.2 初始化搭建博客所需要的所有文件，输入命令：
1
hexo init myblog

myblog名字可随意取

  • 7.2.3 安装依赖包。
    cd myblog 进入myblog文件夹，然后输入
    1
    npm install
    新建完成后，指定文件夹目录下有：
    node_modules: 依赖包
    public：存放生成的页面
    scaffolds：生成文章的一些模板
    source：用来存放你的文章
    themes：主题

** _config.yml: 博客的配置文件**

hexo g
hexo server
打开hexo的服务，在浏览器输入localhost:4000就可以看到你生成的博客了。

7.3 拷贝源文件

将以前博客的source文件夹中的文件拷贝到当前source目录下
运行hexo g重新产生文件
运行hexo s查看网页端

安装hexo-deployer-git插件，在站点目录下输入下面的插件安装就好了

1
npm install hexo-deployer-git --save

指定github的账户名和邮箱

1
2
git config --global user.email "jiang_yafei730@163.com"
git config --global user.name "jonyafei"

7、配置主题文件
参考另一个博客内容