Install Hexo and Deploy It to Github

Hexo 是快速、简洁且高效的博客框架，支持 Markdown 语法，发布静态网站内容，支持一键部署到 GitHub Pages, Heroku。

安装 Hexo

前提是本地已安装好 Node.js 和 Git

安装 Hexo：

1
npm install -g hexo-cli

创建博客

1
2
3
hexo init my_blog
cd my_bloc
npm install
  1. 使用 hexo 创建一个目录 my_blog，并初始化
  2. 在该目录下
  3. 安装需要的依赖

配置

在博客项目根目录下，找到 _config.yml 可以对站点进行配置，具体参考文档

部署

在 _config.yml 中最下方，编辑以下内容：

1
2
3
4
5
deploy:
  type: git
  repo: <repository url>
  branch: [branch]
  message: [message]
  1. deployment 配置
  2. 使用 git
  3. git 仓库
  4. 分支，如 gh_pages，默认为 master 可以不设置。
  5. 自定义 commit message，具体参见 https://hexo.io/docs/deployment.html#Git

Github Pages 通过 CNAME 配置自定义域名，CNAME 文件放在网站仓库根目录下，在 hexo 中，可以放在 source 目录下，在部署时可以自动同步。

本地预览

1
hexo server

常用命令

  • hexo new "Article Title" 新建一篇名为 Article Title 的文章
  • hexo new draft "Draft Title" 新建一篇名为 Draft Title 的草稿
  • hexo deploy -g 或 hexo generate -d 生成文章并部署站点。

自定义主题

stylus

hexo 使用 stylus 编译样式表

widgets

在 hexo 默认主题目录下的 _config.yml 中有 widgets 相关配置

摘要

如果要在首页列表显示文章摘要，可以使用 <!-- more -->，如：

1
2
3
这里是摘要
<!-- more -->
文章正文

更多内置 Tag 参考：https://hexo.io/docs/tag-plugins.html