Windows下使用Github+hexo搭建博客

本文最后更新于：2022年7月29日 晚上

Windows下在Github上搭建hexo博客

关于第一篇技术博客，介绍如何在Windows环境下通过Github pages搭建hexo，包括如何从WordPress转移博客到hexo上。

hexo搭建

搭建博客前小小的工作

1.Github注册

在此不再赘述，在Github官网注册即可。

2.安装node.js

node.js官网下载安装。安装完毕后打开命令行界面输入node -v如图。
node.js成功安装截图

3.安装git

Git官网安装提示默认选项安装即可。安装完毕后打开命令行输入git --version成功安装如图所示。
git成功安装截图
git安装成功后需要添加邮箱和用户名，将代码中双引号中的部分替换成你的用户名，范例邮箱替换成你的邮箱。

1
2
$ git config --global user.name "John Doe" 
$ git config --global user.email johndoe@example.com

添加完后我们需要添加SSH Key到你的Github账户，添加SSH Key是为了让你的Github账户可以绑定你的机器。
打开Git Bash执行代码：

1
ssh-keygen -t rsa -C "zym736531683@gmail.com"

Git Bash一般可以在左下角开始菜单栏中找到，同样将邮箱替换为你的邮箱。成功之后会在用户的.ssh目录下生成两个文件，如下图。.shh目录一般在:c盘 -> 用户（user）-> 用户名（我的为鸣）->.ssh
.ssh目录
使用Notepad++或其他应用打开id rsa.pub文件复制所有内容
打开Github-> 点击头像 -> Settings -> SSH and GPG keys ->New SSH keys -> 粘贴刚才复制的内容至Key框中

搭建博客

hexo本地设置

在硬盘中新建一个文件夹用来存放你的博客数据，右键文件夹点击Git Bash Here
在弹出的CLI中输入：

1
npm install -g hexo-cli

安装完毕后输入hexo检测是否安装成功
hexo安装成功截图
需要注意的是，在输入命令后CLI可能没有立即反应，耐心等待即可。
初始化hexo,后一个hexo为创建文件夹名，可修改

1
hexo init hexo

初始化成功后显示Start blogging with Hexo!
接着依次输入：

1
2
3
cd hexo
npm install     // 安装依赖文件
hexo generate   //生成静态文件

完成后启动服务器

1
hexo server

在浏览器中输入http://localhost:4000/即可看到默认的网站。假如没有成功打开请检查前面的步骤。关于安装福昕阅读器会占用4000端口的问题，请输入hexo server -p 5000进行尝试。

Github Page配置

在Github首页点击New repository
在新的页面中Repository name输入

1
xxx.github.io

xxx最好为Github用户名

部署到Github

用刚才下载的Notepad++打开hexo目录下的配置文件_config.yml在文件最后面的deploy属性中加入代码修改为：

1
2
3
type: git
repository: git@github.com:WX-JIN/WX-JIN.github.io.git
branch: master

千万注意每个冒号后面要加空格，否则hexo g会失败。详情配置见官方文档。
通过CLI在hexo目录下输入命令安装hexo-deployer-git插件：

1
npm install hexo-deployer-git --save

重要的三个命令：

1
2
3
hexo clean //若变更主题后不生效，需执行
hexo generate  //简写为hexo g ，生成静态文件，变更文章后执行
hexo deploy //简写为hexo d 部署至Github

一般变更文章需执行后两个，可结合为hexo d -g，至此已经大工告成。

从其他博客如Wordpress转移到hexo

1
hexo migrate <文件目录>

从wordpress导出文件，如何导出不再赘述，文件目录为绝对路径，可将文件导出后放入hexo文件夹根目录hexo migrate <文件>

学外拓展
博客 hexo

本博客所有文章除特别声明外，均采用 CC BY-SA 4.0 协议 ，转载请注明出处！