Hexo博客的理解性入门

Intro

Hexo是快速、简洁且高效的主流博客框架，然而其使用具有一定的门槛，而本文的目的是帮助初学者快速理解并掌握Hexo的基本使用方法。

须知

Hexo的 官方文档 永远是是学习Hexo使用最好的教程，本文所做的只是对其进行阐释以及针对入门进行拓展。

Hexo本质的理解

Hexo被称为“博客框架”，尽管“框架”一词专业且准确，但会造成一些功能定位上的困惑。所以笔者更倾向于将Hexo解释为可拓展的用于生成博客网站的工具，就如同IDE提供构建工程的所有功能一样，Hexo集成提供你创建一个博客的所需功能。

安装

既然Hexo是一个“工具”，那么安装Hexo实际上将Hexo cli 工具安装到你的设备上。

安装Hexo前你需要在你的设备上提前安装：

Git —— Hexo自身部分操作需要调用
Node.js —— Hexo基于Node.js实现，Node.js也包含默认包管理器npm
yarn(可选) —— npm的代替方案

接下来可以使用npm或yarn安装Hexo。 (~~但记得处理网络连接问题~~)。

1	$ npm install hexo-cli -g

提示

部分Linux发行版可能存在可用系统包管理器直接安装的软件包，如Arch的AUR中有hexo-cli包，可用yay安装。

1	$ yay -S hexo-cli

安装完成后可查看版本号验证安装

$ hexo -v

至此，Hexo的基本安装完成。

初始化一个博客项目

新建一个文件夹用于存放你的博客。

使用Hexo初始化你的博客并自动安装相应的Node.js依赖。

1	$ hexo init [文件夹]

注意

这个过程需要从Github克隆仓库并安装Node.js模块，需注意网络问题

完成后得到如下目录结构

[你的博客文件夹]
├── _config.landscape.yml # Hexo默认主题Landscape的配置文件
├── _config.yml           # Hexo的配置文件
├── scaffolds             # “脚手架”文件夹，存放各类写作模板
├── source                # 源文件夹，文章的存放位置
├── themes                # 主题文件夹
├── node_modules          # |
├── package.json          # | Node.js相关文件
└── yarn.lock             # |

提示

以上的目录结构只是Hexo的默认结构，你之后可以配置除Node.js相关文件外的其它文件结构

配置

要让你的博客正常工作以及呈现出预期的效果，你需要正确配置Hexo。

Hexo本体配置

你需要根据 官方文档 正确填写_config.yml中的内容，你也可以 使用替代配置文件 替代_config.yml。

主题

解释

“主题”一词某种意义上并不准确，实质上是一种主要负责外观修改的特殊插件，事实是很多实际功能由主题提供。

你可以通过自行搜索或查阅 官方主题列表 寻找需要的主题。

然后你需要根据主题作者提供的方式获取主题文件夹并将其置于themes(或你自定义配置的主题文件夹内)，多数作者会推荐使用Git克隆到主题目录。

更改_config.yml中theme的值为主题名称（即主题文件夹的名称）。

对于主题的配置，你需要遵循主题的文档或使用说明（因为主题是一个相对独立的部分）填写_config.[主题名].yml（或者你在_config.yml指定的theme_config）。

插件

插件是拓展Hexo的功能的JS程序，多数主题的完整功能也需额外安装插件。你可以自行搜索或在 官方插件列表 中寻找插件。

多数插件可直接使用npm/yarn安装。(btw:[插件名称]均形如hexo-xxxx)

1	$ npm install [插件名称] --save

注意

这种安装是Node.js的局部安装方案，仅对当前博客有效

若该插件采用其它安装方式，请查阅插件文档

脚手架

即“模板”，你需要配置scaffolds文件夹下的内容，修改/增添模板文件，详见 官方文档。

值得注意的是，插件或主题可能会提供另外的脚手架字段，请查询插件/主题文档使用。

创建文章

1	$ hexo new [layout] <title>

[layout] —— 布局，即你的脚手架下的模板，但不带文件拓展名
<title> —— 文章标题

现在，你可以在source/_[布局]下找到你的文章源文件，并进行文章撰写。

生成&本地预览

记住Hexo的最终目的是生成可部署的网站静态页面，在写好文章后需要将你的文章源文件生成为静态文件。

1	$ hexo generate

现在你可以在public文件夹中找到生成好的静态文件，public文件夹中的才是实际需要上线部署的静态内容。

此步骤一般在发布等场景下使用，因为本地预览时会自动（且持续地）进行生成。

Hexo 提供便捷的本地预览方案

1	$ hexo server

这将在你的本地设备上启动一个Web服务器，你可以借此进行本地预览。

默认访问地址：http://localhost:4000/

这还会监视你进行的修改并实时生成，于是你只需刷新页面即可实时预览更改。

部署

在一切就绪后你可以将博客发布。而为此，你只需将public文件夹中的内容部署到你的Web服务器上。 ~~当然如果你想直接将Hexo的本地预览服务器进行开放等操作也没人拦着你~~

Hexo也提供了内建的快捷部署方式hexo deploy，具体配置与使用见 官方文档

写在最后

到此，你应该掌握了Hexo的基本使用方式，但再次声明：本文只是帮助理解入门，要了解Hexo的更多功能，请

Hexo官方文档
主题文档
插件文档
专注于拓展功能的其它文章