Hexo安装及使用教程

一.前言

为什么要搭建博客，因为某天突然看到好多大神级别的人物在发自己搭建的博客，效果特别的好，作为小白的我看了之后，蠢蠢欲动，于是乎一下走上了不归的试坑道路
搭建个人博客，一方面可以记录生活的方方面面，按照自己的需求设计自己的模块，可以说是私人订制了，另一方面就是给别人提供了一种了解你自己的渠道，可以说是自己的一个名片，因为我们需要的是让更多的人认识我们，而不是我们认识更多的人

二.为什么用hexo+码云搭建

我感觉搭建博客最简单的方法就是，在一个服务器上面去搭建，比如说阿里云，腾讯云等等，我们只需要在服务器的文件系统上传压缩包并解压，用测试域名就可以看到效果了，但是现在服务器都是收费的，从理想的角度来考虑，当然要选择一个可以长期使用而且不收费的服务器
之所以我们选择码云，因为码云上有gitee pages(免费的静态网页托管服务)，目前码云支持Jekyll、Hugo、Hexo编译静态资源
而且hexo基于Node.js实现的，而且目前主流的vue前端一般都是使用npm或者yarn来跑项目，因此使用hexo搭建博客比较简单

三.hexo 本地博客搭建

这里我以windows系统为例，因为我条件限制，希望理解

1. 准备

首先需要下载安装两个软件，去官网下载一下node.js和 git，如何git 下载比较慢的话，在下面说码云使用教程模块，也有下载链接

node.js下载

git下载

2.Node.js 的安装配置

下载完 node.js 进行安装就可以了。

3.hexo 的安装

接下来我们安装hexo，直接在桌面右键，选择Git Bash Here，打开git 命令，执行如下命令安装全局Hexo

1	$ npm install hexo-cli -g

4.初始化项目文件

在准备放项目文件的目录，可以通过windows的cmd终端或者git bash 执行如下的命令. //注意：blog为项目的文件夹名可自定义

1	$ hexo init blog

执行命令就会开始下载文件,下载后会出现以下目录

5.本地测试项目

输入常用的hexo 命令进行本地的测试

1
2
3

$ hexo clean  //清空已经存在的hexo网站文件
$ hexo generate(可简写g)  //生成网站文件
$ hexo server(可简写为s)  //启动本地服务器

我们先输入 hexo g 生成网站文件

然后再输入 hexo s 启动本地服务器，然后在浏览器输入 http://localhost:4000 就能看到样式内容了

到这里本地测试就结束了，关键要放在服务器上面，本地测试适用于一边修改代码、一边刷新网页查看修改好的样子

四.码云部署

1. 注册码云

首先需要注册码云的账号，然后在创建一个仓库，这里初次使用码云的话可以，先看一下码云入门

2. 官网注册

可以直接进入码云官网：https://gitee.com/ 都是中文一看就会的那种

3. 创建仓库

特别要注意这里有个大坑：仓库名称，使用语言(JavaScript)，访问权限(公开)

作为小白的我，成功的掉进这个坑里爬了好几天，没爬出来，最终请教大神帮忙，才发现是此处的原因。
当时，写的仓库名不是我的用户名，导致码云pages部署的路径有问题，导致相对路径不对，读不到css样式和js运行文件，所有进去后就是这个样子，所以依次告警大家不要入坑

4. 获取仓库地址

5. 修改配置文件

在blog主目录下找到 _config.yml 打开进行配置，在代码的最底下修改

deploy:
  type: git
  repo: https://gitee.com/×××/×××.git  #仓库地址
  branch: master
  massage: #自定义提交消息

特别注意这里还有个坑：修改代码时候注意空格，例如 repo：后面都是有空格的，删除空格之后，后面运行的时候就会报错，这是编码的规定，还有就是deploy一定从行首开始写，不要加空格，注意格式

6. 开始部署

输入以下命令

npm install hexo-deployer-git --save  //先安装deployer
hexo g  //生成网站文件
hexo d  //上传到远程在码云上新建的仓库
//也可以采用一键部署
hexo g --d

此时会弹出对话框让我们输入码云的用户名和密码，我们输完以后，就会开始上传，在本地文件夹中会多出来.deploy_git文件夹（上传的是此文件夹下的内容，也就是生成的网站文件，另外我们本地编译生成的html 文件保存在public文件夹下）
登录码云账户，打开和自己用户名相同的仓库观察，如果出现和.deploy_git或者public文件夹下的文件就证明文件上传成功

7. 开启pages功能

这样我们就可以点击生成的域名来看我们搭建的效果了 https://aill.gitee.io

五.博客使用

1.编写文章

给大家推荐一个软件 vsCode 这个软件占用空间很小，插件很多，功能特别强大，我们可以打开我们整个文件夹，进行修改代码，写文章，对我们提高效率很有帮助

方法一
通过命令来实现

1	hexo new hello //hello 为博客的文件名

同时会在根目录下 /source/_posts 目录下生成hello.md

方法二
手动到根目录下 /source/_posts 目录下，创建一个 makedown 文件进行编写就可以了
文件开头可以参考这里来写

---
title： file_name
tag： 标签名
categories： 分类
comment： 是否允许评论(true or false)
description：描述
---
文章的正文部分，可以参考markdown 语法格式来写

2.发布文章

还是使用命令，推送到gitee上

1	hexo g --d

推送成功之后，去观察码云的远程仓库，md格式的文件会自动生成到对应的目录，并且转化成html格式
然后浏览创建好的网站，如果发现没有找到发布的文章，就到码云的page服务，去更新
进入自己的网站后，如果没有变化，可以按 F5 刷新网站，刷新没有用的话，清空一下浏览器缓存就可以了

六.参考文献

hexo+gitee(码云)搭建个人博客避开所有坑