Hexo个人博客搭建

1 前期准备

1.GitHub账号注册(官网:https://github.com/
2.Node.js下载并安装(官网:https://nodejs.org/en/
3.Git下载并安装(官网:https://git-scm.com/

推荐镜像:
Node.js 镜像:http://npm.taobao.org/mirrors/node
Git镜像:https://npm.taobao.org/mirrors/git-for-windows/

2 Git配置和SSH

2.1 配置Git信息

桌面右键点击“Git Bash Here”打开Git命令行窗口

1
2
3
4
5
6
7
8
9
//配置user信息
$ git config --global user.name "Oh-MyBug" //OhMyBug改为你的GitHub用户名
$ git config -- global user.email "OhMyBug@163.com" //OhMyBug@163.com改为你的邮箱地址
//检查配置信息是否正确
$ git config --global user.name
Oh_MyBug

$ git config --global user.email
OhMyBug@163.com

2.2 配置SSH key

step 1: GitHub新建仓库,仓库名为“Oh-MyBug.github.io”

(Oh_MyBug改为你的GitHub用户名 注意:一定要是用户名!!!)

step 2: 回到Git界面,输入命令:

1
$ ssh-keygen -t rsa -C "Oh-MyBug@163.com"

step 3: 打开用户文件夹C:\Users\xxx (xxx为你的电脑用户名),找到并打开.ssh文件夹,用编译器打开id_rsa.pub文件,即可看到ssh Key内容,将其复制

step 4: 回到GitHub界面,点击你的头像选择Settings,在左侧列表中选择“SSH and GPG keys”,点击“New SSH key”按钮添加新的Key,Title自定义,Key内容即为你刚才从id_rsa.pub文件中复制的内容,然后点击”Add SSH key”即创建成功

step 5: 回到Git界面,输入命令:

1
2
$ ssh git@github.com
$ ssh -T git@github.com

显示successfully即配置成功!

3 Hexo博客框架安装

step 1: Git界面输入命令:

1
2
$ npm -v
6.14.4

返回版本号即说明已安装(一般安装的Node自带npm)

step 2: Git界面(或者命令提示符cmd–比较快)输入命令:

1
$ npm install -g hexo

step 3: 安装成功后,找一个盘新建文件夹用于放置博客的配置文件等等,我选择的是”文档“文件夹来新建文件夹(文件夹名自定义,我的是”MyBlog”)

step 4: 关闭原来的Git界面,在”MyBlog”文件夹右键点击”Git Bash Here”进入Git界面,输入命令:

1
$ hexo init

(安装需要点时间…耐心等待)

step 5: 继续输入命令:

1
2
$ npm install
$ npm install hexo-deployer-git --save

step 6: Git输入命令:

1
$ hexo server //通过本地地址http://localhost:4000预览博客

step 7: 在GitHub仓库Oh_MyBug.github.io中找到SSH:git@github.com:Oh-MyBug/Oh-MyBug.github.io.git,然后进入”MyBlog”文件夹打开”_config.yml”文件,找到# Deployment修改内容并保存文件

1
2
3
4
deploy:
type: git
repository: git@github.com:Oh-MyBug/Oh-MyBug.github.io.git
branch: master

step 8: 返回Git界面,按”Crtl + C”停止hexo server命令,输入命令:

1
$ hexo generate

(本地预览看有没有问题,即step 6的步骤)

step 9: Git界面输入命令:

1
$ hexo deploy

step 10: 浏览器输入博客地址:Oh-MyBug.github.io,显示出博客界面就说明hexo博客框架搭建成功啦!!!

4 常见问题

4.1 问题一

问题描述:使用GitHub创建好个人主页后访问报错:404 There isn’t a GitHub Pages site here.

问题原因:出现该问题的原因是创建的Oh-MyBug/Oh-MyBug.github.io项目中没有内容。

解决方案

step 1: 进入仓库,点击Settings

step 2: 下滑页面找到GitHub Pages,点击Change theme(未设置之前是Choose theme,设置之后即可访问)

文章目录
  1. 1 前期准备
  2. 2 Git配置和SSH
    1. 2.1 配置Git信息
    2. 2.2 配置SSH key
  3. 3 Hexo博客框架安装
  4. 4 常见问题
    1. 4.1 问题一
|