搭建Hexo博客

环境

Hexo是一款静态博客引擎。可以解析Markdown在内的多种文件类型，将它们输出为静态的HTML文件以供部署。需要准备的环境有：

  • Node
  • Git

Hexo项目

首先安装Hexo CLI工具

1
npm install hexo-cli -g

初始化项目

1
2
3
hexo init <hexo-project>
cd <hexo-project>
yarn

等待依赖安装完成，运行：

1
hexo server --debug

访问http://localhost:4000，如果能看到下面的页面，博客项目已经建立完成了

博客初始页面

事实上，你可以在Hexo的官网上查看这些信息，上面比我描述的要详细很多。

安装Fluid主题

可以使用包管理工具安装

1
yarn add hexo-theme-fluid

安装完成后在项目的根目录下建立主题配置文件_config.fluid.yml，并将配置文件的内容拷贝进去即可。

使用github.io托管

在GitHub中新建一个repo，命名为username.github.io。注意，username必须使用的GitHub用户名，否则无法直接通过github.io提供的二级域名访问。

在Hexo的配置文件_config.yml中进行如下配置

1
2
3
4
5
6
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repo: git@github.com:jbiter/jbiter.github.io.git
  branch: main

确保项目中已经安装了用于发布博客的依赖hexo-deployer-git，使用Hexo CLI提供的命令即可将博客发布到github.io中。发布前新建source/CNAME文件，若未解析自定义域名，留空即可。

1
hexo generate --deploy

有用的依赖

1
2
3
4
5
6
dependencies = [
    "hexo-deployer-git", // 用于自动化发布博客
    "hexo-generator-sitemap",
    "hexo-generator-baidu-sitemap", // 生成站点地图
    "hexo-memorial-day" // 在纪念日将网站置灰
]
实践记录
#Hexo #Markdown #Mermaid
搭建Hexo博客
https://jbiter.github.io/p/c1d5d64c.html
作者
布衣
发布于
2021年1月15日
许可协议