Hexo+Gitee搭建个人博客

一、准备工作

1. git安装

git下载地址：gitforwindows.org

2. node.js安装

node.js 下载地址：https://nodejs.org/en/，选择稳定版本即可，node.js的安装非常简单，一步一步next即可。

二、Hexo 本地搭建

在磁盘中新建一个文件夹专门用来存 myBlog博客相关的文件。 文件夹内右键打开 Git Bash Here，在此窗口内执行以下所有命令。

1、安装 Hexo

先安装cnpm (避免直接用npm安装比较缓慢或失败,所以改用阿里的NPM镜像)

$ npm install -g cnpm --registry=https://registry.npm.taobao.org

用 cnpm 安装 hexo

$ cnpm install -g hexo-cli

安装可能有一些缓慢，当然这还是取决于你的带宽，这个过程中会出现的WARN提示不用理会。

$ cnpm install hexo --save

到这hexo就安装好了，检查一下hexo -v是否安装成功

$ hexo -v
hexo: 4.2.0
hexo-cli: 3.1.0
os: Windows_NT 10.0.17763 win32 x64
http_parser: 2.8.0
node: 10.16.0
v8: 6.8.275.32-node.52
uv: 1.28.0
zlib: 1.2.11
brotli: 1.0.7
ares: 1.15.0
modules: 64
nghttp2: 1.34.0
napi: 4
openssl: 1.1.1b
icu: 64.2
unicode: 12.1
cldr: 35.1
tz: 2019a

安装完成后目录图如下(hexo文件夹是后面初始化hexo时手动新建的):

2、初始化 Hexo

Hexo安装完以后需要进行初始化操作。

注意：初始化前需要先在myBlog文件中，创建一个新的文件夹用来存放hexo博客文件。否则执行hexo init命令会报错。

进入hexo文件夹内右键打开 Git Bash Here，在此窗口内执行后边的所有命令。

 $ hexo init

初始化成功后，hexo文件夹内会出现如下的文件：

node_modules: 依赖包 public(第一次初始化时这个文件夹是不存在的)：存放生成的页面 scaffolds：生成文章的一些模板 source：用来存放你的文章 themes：放下下载的主题 _config.yml: 博客的核心配置文件（设置主体、标题等属性）

接着需要执行一下cnpm install命令，要不下边的启动会提示命令不合法。

cnpm install

最后用 hexo s -g 命令来启动安装好的 hexo。

$ hexo s -g
INFO  Start processing
INFO  Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.

直接访问http://localhost:4000显示如下页面，本地博客搭建成功

三、Hexo 托管至 Gitee

ps: 如果没有码云(https://gitee.com/)账号需要先去官网注册，教程自行百度。

1、创建Gitee仓库

这里仓库命名以gitee上面注册的用户名作为仓库名

2、配置_config.yml文件

修改_config.yml文件，添加你创建的Gitee仓库地址

注意: 这个文件的值前面必须要有一个空格（比如: type: git）

deploy:
  type: git
  repository: https://gitee.com/deanleef/deanleef.git
  branch: master

安装部署命令deploy-git ，这样你才能用命令部署到Gitee。

$ cnpm install hexo-deployer-git  --save

上边修改完毕以后，依次执行以下命令，提交本地hexo文件到Gitee。

首次发布可能需要在shell中输入账号和密码

$ hexo clean && hexo g && hexo d

提交完成后进入对应的仓库地址查看是否提交成功。

四、开启并设置Gitee Pages

先开启Pages功能(如果没有开启Gitee Pages,访问会一直显示 404)

在项目的服务中选择Gitee Pages选项

选择 master分支，点击 部署/更新，完成后:

然后浏览器访问 http://deanleef.gitee.io

以上就是Hexo+Gitee 的整个过程，整体来说还是比较简单的。

五、主题下载和安装

Hexo官网上提供了丰富的主题可选，你只需要打开对应的界面（https://hexo.io/themes/）选择喜欢的，然后点击名称跳转到GitHub仓库选择下载或者克隆对应的zip文件到本地，并且解压到网站目录下的themes目录即可。

克隆到本地方式(以matery主题为例):

git clone https://github.com/blinkfox/hexo-theme-matery.git

然后接下来，你需要进入hexo文件夹找到 _config.yml 打开并修改配置文件：

这里的theme 的值就是克隆下来的主题文件名(不要去修改克隆/下载下来的主题名称)

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: hexo-theme-matery-develop

修改完成后保存，并再次提交到Gitee上

$ hexo clean && hexo g && hexo d

注意: 提交完成后，需要进入服务中的Gitee Pages选项进行手动更新项目(免费的Gitee Pages需要每次手动更新), 否则主题不会生效。更新完成后重新进入博客地址就可以看到最新的主题了。

六、Hexo博客中插入图片

一般而言Markdown都提供插入外链图片的方式，然而由于各种网络传输问题，容易导致由此生成的静态网页中的图片无法成功加载，因此本文推荐一种适用于Hexo 3.0以上版本的简单插入图片的方式。

• 首先修改网站中配置文件(_config.yml)中的代码为：post_asset_folder: true

• 然后在网站目录下运行Git Bash Here，执行命令

hexo new 'Hexo+Gitee搭建个人博客'

• 运行成功之后就会在网站下的source/_posts中分别生成对应的Markdown文件与同名空目录；

• 你的博客文章直接在生成的*.md文件中编辑，而引用的图片则以Markdown标准形式![]*(图片名)的形式进行，格式: ![](图片名字.图片格式),例如![](1.png)。

image-20200406212018847.png

然后运行 hexo s -g 查看本地图片是否成功，之后运行hexo d部署到Gitee即可

附上我的个人博客地址: https://lijingdu.me