Hexo 参考文档
Hexo 常见配置及基本使用方法~~
关于 hexo 进阶用法，参照另一篇文章 你可能还不知道的 Hexo 拓展用法 —— Hexo 进阶
一、概要
1.0 先修
使用 Hexo 之前，掌握如下工具的基本使用有助于你快速地掌握 Hexo 的基本原理和使用方法。
- Github
- npm
- markdown
1.1 描述
A fast, simple & powerful blog framework
1.2 功能
轻量、便捷、灵活地搭建你的静态网站。
1.3 理解
我从接触 Hexo 到如今，已有一年的时间。在使用 Hexo 的这一年时间里，经历过它给写作带来的轻快感和新鲜感，体验过重装系统几乎丢失大部分数据的绝望，也在几易博客主题中享受到了Hexo 的灵活性，近日还修改了 Github 名折腾了一下。
总的来说，不是新手的我对 Hexo 的原理有一定的理解。
1.4 Hexo 安装后的目录结构
.deploy_git/，类似 github/git 的.git目录，存放一些功能性信息node_modules/，nodejs 的一些库public/，Hexo 生成的 html 内容scaffords/，post、draft、page 模板source/，用户撰写的 MD 源文件themes/，主题目录.npmignore，类似.gitignore文件，存放 npm 的忽略策略_config.yml，整个 Hexo 的配置文件db.jsonpackage.jsonPost.txt
1.4 原理
Hexo n "文章标题"—>source/_post/文件夹下，新建名为 “文章标题”（对特殊符号会做处理） 的 MD 文件，文件模板位于scaffolds/文件夹下。hexo p [layout]—> 发布草稿，将source/_draft/文件夹下的文件挪到source/_post/文件夹下。hexo g—> 将所有 MD 文件，依照theme和hexo config.yml下的规则，生成一系列的 html 页面，存放在public文件夹下，最终发布到 github 上的也是此文件夹的这些文件，你可以在构建完成后，比较 github 的博客仓库与该目录的区别。hexo s—> 在本地开启服务器，通过localhost:4000预览修改后的结果，注意：此时你对 MD 及配置文件的修改，通过刷新页面都能够即时生效。hexo d—> 发布，将最近一次在public文件夹下生成的内容，发布到 github 上。
二、安装步骤
三、Themes
Hexo 有各种主题供使用者进行使用，同时，众多程序员也加入到 Hexo 主题的开发进程中。你可以从你能找到地方下载并安装你喜欢的 Hexo 主题，从而开始你的博客搭建之旅。
本站使用到的主题为 Material。
四、Hexo Front-matter
Front-matter 内容被放在正文的头部，用于 Hexo 进行解析。
官网介绍：https://hexo.io/zh-cn/docs/front-matter.html
Hexo 通用的 Front-matter：
| 参数 | 描述 | 默认值 |
|---|---|---|
| layout | 布局 | - |
| title | 标题 | - |
| date | 建立日期 | 文件建立日期 |
| updated | 更新日期 | 文件更新日期 |
| comments | 开启文章的评论功能 | true |
| tags | 标签（不适用于分页） | - |
| categories | 分类（不适用于分页） | - |
| permalink | 覆盖文章网址 | - |
material 主题专属的 Front-matter：
| 参数 | 描述 | 默认值 |
|---|---|---|
| thumbnail | 缩略图地址 | - |
| toc 显示 | TOC 按钮 | true |
| comment | 显示评论 | true |
| notag | 不生成标签按钮 | false |
| top | 置顶 | false |
五、常用的 Hexo 命令
hexo n “我的博文” == hexo new “我的博文” #新建文章
hexo p == hexo publish
hexo g == hexo generate #生成
hexo s == hexo server #启动服务预览
hexo d == hexo deploy #部署
六、参考文章
1、使用 GitHub 和 Hexo 搭建免费静态 Blog
七、奇淫逸巧
关于 hexo 进阶用法，参照另一篇文章 你可能还不知道的 Hexo 拓展用法 —— Hexo 进阶
