hexo config


Hexo 是一款快速、简洁并且高效博客框架,几乎不需要了解前端知识就能搭建,有很多主题可供选择,容易上手,非常适合自建博客网站。

Prepare the environment

  • Node.js >= 12.0
  • npm
  • git
  • hexo >= 5.0

前三个环境搭建若不会建议问 Google,这里着重介绍 hexo 的安装及部署

Init hexo

# 全局安装 hexo 命令行客户端
npm install hexo-cli -g
# 新建空文件夹
mkdir blog
cd blog
# 初始化基础文件
hexo init
# 安装 Node.js 相关依赖库
npm install

上述命令完成后,应该会有如下目录

.
├── _config.yml     // 基本配置信息
├── node_modules    // 依赖库
├── package.json    // 项目信息
├── scaffolds       // 文章模板文件夹
├── source          // 文章资源
|   ├── _drafts     // 草稿目录
|   └── _posts      // 文章目录
└── themes          // 可配置主题,用于生成静态页面

Quick Start

Create a new post

# 默认使用 _config.yml 中的 default_layout 参数代替。默认参数为 post, 即要发布的文章
hexo new "My New Post"
# 可以在 new 后面添加 `post` `draft` `page` 等选项创建不同的文件
# 新建草稿
hexo new draft "new draft"
# 发布草稿, 将草稿移动至文章目录下
hexo publish draft "new draft"

More info: Writing

Run server

hexo server
# 简化
hexo s

More info: Server

Generate static files

hexo generate
# 简化
hexo g

More info: Generating

Deploy to remote sites

hexo deploy
# 简化
hexo d

注意:若 Github 设置自定义域名,部署之后,CNAME 文件会被覆盖,导致网站不可用,可以将 CNAME 文件放在themes/[theme-name]/source目录下,这样编译静态文件会自动带过去,之后会一同推送到远端

More info: Deployment

Clean

hexo clean

清除缓存文件 (db.json) 和已生成的静态文件 (public)。建议有删除文章后先 clean,再编译

Change theme

hexo 有许多优秀主题可供切换,本博客使用的主题是matery,具体修改配置参见README


文章作者: MaZhuang
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 MaZhuang !
  目录