怎么使用Hexo编写博客

前言

由于网上太多关于github+hexo搭建教程，搭建这里就不多说了，推荐之前搭建参考的网址：

使用hexo+github搭建免费个人博客详细教程

GitPages+Hexo搭建个人博客

搭建完成后，怎么使用hexo这个框架，网页的排版这些就很难找到相关资料了，自己研究了下，具体整理出来，方便后面的人使用。

目录

• 博客功能配置
• 根目录_config.yml配置
• Hexo常用命令

博客功能配置

主题配置

官方提供很多主题，这里放两个主题，其他可以自行度娘，博主更偏爱material-x主题，哈哈。到指定目录下clone。

$ cd /Users/TangDan/GitHub/MyHexoBlog/themes
$ hexo clean
$ git clone https://github.com/iissnan/hexo-theme-next
$ git clone https://github.com/xaoxuu/hexo-theme-material-x themes/material-x  //本博客使用主题

现在themes目录下应该多了两个目录：next、material-x，然后到_config.yml修改theme: material-x，再执行

$ cd /Users/TangDan/GitHub/MyHexoBlog
$ hexo g
$ hexo d  //推送到远端
$ hexo server //本地查看

PS:运行中出现任何问题，可以先hexo clean再执行。

两个主题配置

这两个主题配置其实说难不难，说简单不简单，目前我是只去研究了material-x主题的配置，过程即酸爽又享受。

Next主题官方配置文档

Material-X主题官方配置文档

PS：请一定要仔细的去读官方文档，不要看了这个文档一半又跑去查其他的资料，其他的资料可能更新没官方那么快，是老版本的，到最后一顿操作猛如虎，结果等于白忙，不要问我怎么知道的，我不会告诉你，= =！

链接持久化

hexo默认的链接是http://xxx.com/2017/08/18/hello-world 这种类型的，这种路径看着也挺low的，这源于站点配置文件_config.yml里的配置: permalink: :year/:month/:day/:title/. 这种默认配置的缺点就是当我们创建的博文名包含中文的名的时候，url 链接地址经常会变成一串很长的难以理解的字符串，不利于博文的链接分享，以及搜索引擎搜索，另外就是年月日都会有分隔符。我们可以让 url 链接持久化来解决这个问。

安装hexo-abbrlink插件

$ sudo npm install hexo-abbrlink

修改站点配置文件 _config.yml

• permalink: post/:abbrlink.html

• 添加 abbrlink:

permalink: post/:abbrlink.html  # :year/:month/:day/:title/     # 文章的永久链接格式
permalink_defaults:     # 永久链接中个部分的默认值
# abbrlink config 需安装插件hexo-abbrlink
abbrlink:
  alg: crc32  # 算法： crc16(default) and crc32
  rep: hex    # 进制： dec(default) and hex

站内搜索

安装 hexo-generator-search 插件

$ sudo npm install hexo-generator-search

配置站点文件_config.yml:

# 站内搜索
search:
  path: search.xml
  field: post

local_search:
  enable: true

根目录_config.yml配置

站点配置（重要）

title: 博客名   //网站标题
subtitle: To strive, to seek, to find   //网站副标题
description: To strive, to seek, to find, and not to yield.  //网站描述
author: WenBo  //您的名字
language: zh-Hans  //网站使用的语言 简体中文 zh-Hans
timezone:   //网站时区。Hexo 默认使用您电脑的时区

URL配置

url: http://blogwenbo.com/   //网址
root: /  //网站根目录
permalink: :year/:month/:day/:title/  // 文章的 [永久链接](https://hexo.io/zh-cn/docs/permalinks.html) 格式 | `:year/:month/:day/:title/` |
permalink_defaults:  //永久链接中各部分的默认值

目录配置

source_dir: source  //资源文件夹，这个文件夹用来存放内容。默认值：source
public_dir: public  //公共文件夹，这个文件夹用于存放生成的站点文件。默认值：public
tag_dir: tags  //标签文件夹 默认值：tags
archive_dir: archives  //归档文件夹 默认值：archives
category_dir: categories  //分类文件夹  默认值：categories
code_dir: downloads/code  //Include code 文件夹 默认值：downloads/code
i18n_dir: :lang  //国际化（i18n）文件夹 默认值：:lang
skip_render: README.md  //跳过指定文件的渲染，您可使用 [glob 表达式](https://github.com/isaacs/node-glob)来匹配路径。

Git部署配置（重要）

deploy:
  type: git //填git
  repo: git@github.com:wenmobo/wenmobo.github.io.git  //SSH地址
  branch: master  //分支

Hexo常用命令

其实搭建成功后，在/Users/TangDan/GitHub/MyHexoBlog/source/_posts里默认会有生成一个hello-world.md，这个里面描述了常用的哪些命令及意义，可在里面查看。

常用创建命令：

$ hexo new "xxx" //创建一篇文章
$ hexo new page "xxx" //创建一个分类

总体来说，提交一个修改到github，最好顺序执行以下命令：

$ hexo clean
$ hexo g
// $ hexo s //这个是提交到本地
$ hexo d //推送到github