1. 安装
    1. 安装hexo
    2. 初始化
    3. 本地预览
  2. 发布至Github
  3. 替换Markdown渲染器
  4. 安装主题
  5. 禁止渲染某目录下文件
  6. 生成站点地图
  7. 实时预览
  8. 常用语法
  9. 标签

hexo windows安装

hexo是一个可以运行在Github上的静态博客框架,支持Makedown

安装

安装hexo前需安装以下程序
node Git

安装hexo

1
npm install -g hexo-cli

初始化

1
2
3
4
5
6
// 新建文件夹,通过 cd命令进入博客文件夹
cd 文件夹路径
// 初始化博客
hexo init
// 安装依赖
npm install

本地预览

1
2
3
4
5
6
7
// 生成静态文件
hexo generate

// 启动服务
hexo server

// 打开 http://localhost:4000

发布至Github

1 新建github项目,项目名为 <账号名>.github.io,例如

1
Aaron-bird.github.io

注:必须为自己的账户名,其他名称无效

2 打开_config.html,更改下列选项

1
2
3
4
5
6
7
language: zh-Hans
timezone: Asia/Shanghai

deploy:
type: git
repository: git@github.com:Aaron-Bird/Aaron-Bird.github.io.git
branch: master

3 部署

1
2
3
hexo g
#上传至Github
hexo d

注:如提示 deployer not found:git, 安装 hexo-deployer-git

1
npm install hexo-deployer-git --save

替换Markdown渲染器

自带的渲染器不支持直接插入HTML代码,可使用Markdown it渲染器替换
Github hexo-renderer-markdown-it-plus

1
2
3
4
// 卸载默认渲染器
npm un hexo-renderer-marked --save
// 安装hexo-renderer-markdown-it-plus
npm i hexo-renderer-markdown-it-plus --save

如果有yarn,上面2条命令也可以使用yarn完成

1
2
3
4
// 卸载默认渲染器
yarn remove hexo-renderer-marked
// 安装hexo-renderer-markdown-it-plus
yarn add hexo-renderer-markdown-it-plus

安装完成后,打开根目录下_config.yml,添加以下内容

1
2
3
4
5
6
markdown_it_plus:
highlight: true
html: true
breaks: false
// 不转义单/双引号,如果为true.会把文章中英文引号转为中文引号
typographer: false

更多设置参数可参考Github markdown-it
最后,使用clean命令清除Hexo缓存

1
hexo clean

注: hexo-renderer-markdown-it会导致Hexo的toc方法失效 github issue
markdown-it 导致hexo toc失效的原因及解决办法

安装主题

  • 下载主题,放在 source> themes 文件夹内
  • 修改站点配置文件内容(根目录下_config.yml) theme: 主题名

禁止渲染某目录下文件

打开根目录下_config.yml,添加如下设置

1
2
3
4
5
6
7
8
// 禁止渲染source目录下html和js文件(对子文件夹无效)
skip_render:
- '*.html'
- '*.js'

// 禁止渲染source/doc目录下所有文件
skip_render:
- 'document/**'

生成站点地图

安装hexo-generator-sitemap

1
npm install hexo-generator-sitemap --save

打开根目录下_config.yml,添加

1
2
3
4
sitemap:
 path: sitemap.xml
 template: ./sitemap_template.xml
url: https://Aaron-Bird.github.io

实时预览

编写Markdown时,可使用LiveReload实时预览最终效果
需安装以下程序

Hexo渲染md文件需一定时间,因此设置LiveReload延迟400ms刷新浏览器 打开 SublimeText > Preferences > Packages settings > LiveReload >Setting User,填入

1
2
3
4
5
6
{
"enabled_plugins": [
"SimpleReloadPluginDelay",
"SimpleRefreshDelay"
]
}

LiveReload的默认延迟时间为400ms,可到如下路径文件中更改(便携版Sublime)

1
sublimetext\Data\Packages\LiveReload\SimpleReloadPluginDelay.py

常用语法

标签

标签用于描述文章信息,用hexo new命令新建文章,打开新建的.md文件,就能看到这些标签

---
title:
date: 
tags: 
    - program 
    - install
categories: software
description:
---

你可以自己手动添加需要的标签,常用的标签有:

title 标题
date 日期
tags 标签
categories 分类
description 描述