Hexo搭建指南

Hexo更像是一个工具，使用配置以及md文档来生成属于你的静态网页。它可以高定制化，同时也可以不需要服务器来支持网页的运行。这让它可以直接扔到github的网页上来部署。

它不像Halo等建站工具能在线书写和发布。但它可以配合网络仓库来随时随地部署。现在我们就是来开始琢磨它吧！顺带也能帮忙磨练MarkDown语法。

在此，我使用的是Hexo+Butterfly(主题)的方式来进行建站，同时我也在进行摸索，如果有好的建议也欢迎来一起探讨

Hexo的部署

首先是hexo的官方文档，这里有hexo需要环境的描述。

从官方文档确认我们需要的两样东西：Node.js和Git

准备环境

1、Node.js

推荐从官方的途径获得Node.js的安装方式或安装程序/独立文件(需科学上网)：Nodejs官方下载地址

或者自行在网络上搜索Node.js的安装教程。只需版本高于12即可，最好是选择LTS(长期支持版)

2、Git

Git的Windows下载地址在这，应该是可以直接访问的：Git官方下载地址

同时Git官方有着中文的简单教程：官方安装教程

安装Hexo

准备好环境并验证好可用后，开始下载hexo的库

Windows建议先建好一个文件夹，然后在文件夹中启动cmd来安装，后续初始化也在此文件夹

1 2	# 下载hexo库 npm install -g hexo-cli

经过漫长的等待后，下一步是初始化，让hexo生成能供我们使用的文件

1
2
3

# 如果无法运行在前面加上npx
# 不填文件名即在当前文件夹新建所需文件
hexo init <文件夹名>

初始化完成后，项目文件夹应有以下文件

.
├── _config.yml		网站配置，以及自定义
├── package.json	所需要的包
├── scaffolds		模板，之后创建新的文章等都会使用这里的模板来创建
├── source			资源文件夹，之后的文章和页面都是存放在这里		
|   └── _posts		文章文件夹，使用post参数创建的文章都在这
└── themes			主题文件夹，之后可以下载第三方主题来使用

创建完成后，进入你所创建的文件夹(没填就是在当前文件夹)，这也就是之后所说的根目录。安装Hexo服务需要的包

1
2
3

# 如果之后出现了运行失败等问题，可能就是这里的包没安装完全，可以考虑更换镜像源
# 直接搜npm临时使用镜像源或npm更换镜像源就可找到其他教程
npm install

到这里Hexo本体就以及安装完了，但我们是使用Butterfly来辅助我们更快的创建个性化站点，所以还需要安装主题

安装Butterfly主题

Butterfly官方也自己建了一个站，里面有很多关于页面的元素配置技巧：Butterfly博客

同样在初始化后的文件夹里：

国内下载方法：
git clone -b master https://gitee.com/immyw/hexo-theme-butterfly.git themes/butterfly

国外下载方法：
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

下载好后根据官方推荐的方式，进到./themes/butterfly文件夹中将_config.yml复制一份，命名为_config.butterfly.yml放置到根目录下。同级目录下应该是会有一个_config.landscape.yml的空文件，和它同级就行了。

之后更新Butterfly就不会导致config文件需要重新配置了

应用主题

主题装好后，我们要告诉Hexo我们要用这个主题，通过vs或者记事本打开_config.yml(根目录下的)。按ctrl+F查找，并改为以下格式

1	theme: butterfly

同时安装渲染器(pug、stylus)

1	npm install hexo-renderer-pug hexo-renderer-stylus --save