博客搭建之Hexo
Hexo简介
快速建站工具（主要适用：博客、文档等静态站点），可以将Markdown编写的文章解析成html页面。生成的站点可以无需服务器一键部署到github、gitlab或者gitee上。
另外Hexo有许多社区提供的：
- plugins(插件)：支持给生成的站点扩展其他能力（例如：评论、文章分类、内容加密、搜索等）；
- themes(主题)：支持使用开源主题或者自定义主题来定制页面布局、风格等；
Hexo安装
1. 环境依赖：
- nodejs(>12.0)
- git(部署时需要用到)
2. 安装hexo-cli
安装hexo命令工具到全局环境，安装后可以在shell窗口运行hexo命令。
npm install -g hexo-cli
# or
yarn global add hexo-cli
Hexo使用
hexo init demo-folder # 初始化文件夹
cd demo-folder # 进入文件夹
npm install # 安装依赖
文件夹的目录：
├── _config.yml # 配置信息
├── package.json
├── scaffolds # 模版
├── source # 资源
| ├── _drafts # 草稿
| └── _posts # 文章
└── themes # 主题
部署（先跑起来再回头看配置）
1. 安装 hexo-deployer-git
npm install hexo-deployer-git --save
2. 配置_config.yml
# 发布后的网址
url: http://krdxst.gitee.io/wenju-blog/
# 首页配置
root: /wenju-blog/
# 部署配置
deploy:
- type: git
repo: git@github.com:wenjuGao/wenju-blog.git # github
branch: gh-pages
- type: git
repo: git@gitee.com:krdxst/wenju-blog.git # gitee
branch: ge-pages
3. github配置（访问速度可能会慢）
- 新建仓库
新建仓库
- 设置Pages
新建仓库
- 部署
npm run deploy
注意：
- 新建仓库时仓库名需要和用户名保持一致不然可能会发布失败（发布之后可以修改）；
- root会影响资源加载路径；
- 该部分推送可以使用ssh（公钥推送）和https协议推送，shh需要配置公钥，https首次推送时需要提供github/gitee账号密码；
4. gitee配置
- 新建仓库
新建仓库
- 设置Pages
新建仓库
- 部署
npm run deploy
发布后需要手动回到设置Pages页面点击更新。
Hexo配置
详细配置见官方文档
以下枚举下常用配置：
参数 | 描述 |
|---|---|
title | 网站标题 |
subtitle | 网站副标题 |
description | 网站描述 |
keywords | 网站的关键词。支持多个关键词 |
author | 作者名称 |
language | 语言（多语言是会使用到）zh-CN |
url | 网址 |
root | 网站根目录 |
theme | 主题名称（自定义主题时会用到） |
theme_config | 主题配置 |
deploy | 部署配置 |
Hexo命令
详细命令见官方文档
以下枚举下常用命令：
1. new：创建一个新文章（新建一个markdown文件）
# hexo new [layout] --path [path] --replace [file] --slug [router-name] <title>
hexo new page "我的文章"
hexo new page --path about/me "关于我"
hexo new page --slug me-new "文章内容"
参数 | 描述 |
|---|---|
-p, --path | 自定义新文章的路径 |
-r, --replace | 如果存在同名文章，将其替换 |
-s, --slug | 文章的 Slug，作为新文章的文件名和发布后的 URL |
2. generate：生成静态文件（将markdown文件生产静态的html文件）
source目录下_posts文件夹之外，开头命名为 _ (下划线)的文件、文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件(图片、字体等其他资源)会被拷贝过去。
hexo generate
# or
hexo g
参数 | 描述 |
|---|---|
-d, --deploy | 文件生成后立即部署网站 |
-w, --watch | 监视文件变动 |
-f, --force | 强制重新生成文件(使用该参数的效果接近 hexo clean && hexo generate) |
-c, --concurrency | 最大同时生成文件的数量，默认无限制 |
3. publish：发表草稿
hexo publish [layout] filename
4. server：启动本地服务器（开发）
hexo server
参数 | 描述 |
|---|---|
-p, --port | 重设端口，默认端口4000 |
-s, --static | 只使用静态文件 |
-l, --log | 启动日记记录，使用覆盖记录格式 |
5. deploy：部署
hexo deploy
# or
hexo d
参数 | 描述 |
|---|---|
-g, --generate | 部署之前预先生成静态文件 |
部署完成
网站到此就部署完成喽，后面你就可以在source下创建你自定义的md或者html来展示你的内容喽。
当然，如果你觉得默认的样式和布局不是那么满足你的需求，你可以在这里找到不同的主题来丰富你的站点，另外还有这里提供的插件来满足你不同的功能需求。后续这边，关于Hexo，还会整理关于主题插件的使用。