hexo windows安装

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

安装

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

安装hexo

1	npm install -g hexo-cli

初始化

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

本地预览

// 生成静态文件
hexo generate

// 启动服务
hexo server

// 打开 http://localhost:4000

发布至Github

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

1	Aaron-bird.github.io

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

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

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

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

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

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

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

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,添加如下设置

// 禁止渲染source目录下html和js文件(对子文件夹无效)
skip_render:
    - '*.html'
    - '*.js'

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

生成站点地图

安装hexo-generator-sitemap

1	npm install hexo-generator-sitemap --save

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

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,填入

{
    "enabled_plugins": [
        "SimpleReloadPluginDelay", 
        "SimpleRefreshDelay"
    ]
}

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

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