基于HEXO的博客搭建

基于HEXO+FLUID 样式的博客搭建

环境准备

  1. 7.3版本的Hexo 要求node.js 的版本在18.0以上,centos7 所能拉取到的node.js 版本在11.0 。考虑到需要处理依赖所以直接换成了alibaba cloud 系统

  2. 安装 npm和hexo-cli 命令行工具

    1
    2
    dnf install npm
    npm install hexo-cli -g
  3. Github 集成

    因为后续需要设置到github page ,所以先配置git和密钥

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12

    ssh-keygen # 使用ssh-keygen 创建密钥
    cat /root/.ssh/id_rsa.pub # 从目录文件夹查询公钥,
    # 配置到github -> settings -> SSH and GPG keys -> New SSH key

    dnf install git # 安装git

    git config --global user.name "用户名"
    git config --global user.email "邮箱"

    ssh -T git@github.com # 测试到github的连接

HEXO 框架安装

初始化hexo :

1
2
3
hexo init myhexo/  #  初始化文件夹
cd myhexo # 移动到博客目录
npm install hexo-deployer-git --save # 安装并存储hexo项目

修改部署方式:

1
2
3
4
5
6
7
deploy:
type: git # 类型是 git
repo: git@github.com:username/username.github.io.git
#在github上创建username.github.io的仓库,确认仓库名是否一致!
#这里可以使用ssh的方式,也可以使用https的方式,但是ssh更稳定
branch: master # 设置分支为master

修改后 使用 hexo deploy 进行安装,安装过程中会提示输入用户名和密码‘

用户名就是登录账户的名称

密码需要通过 settings → Developer Settings → Personal access tokens → Generate new token 创建token 作为密码

等待几分钟可以通过访问 https://username.github.io 查看是否创建成功

插件安装

hexo 支持多种样式风格的插件

以安装fluid为例 , 安装插件 :

1
npm install --save hexo-theme-fluid

这时可以将 下载对应主题文件 放到theme 文件夹,在_config.yml配置theme 为fluid

或者直接在根目录创建 _config.fluid.yml 来进行配置。 _config.fluid.yml 的配置优先级高于 _config.yml 。 一些基本配置 :

1
2
3
4
5
title: '' #标签页主题
language: '' #语言
timezone: '' #时区
theme: '' #主题

1
hexo new page about  # 关于页需要自行创建

扩展配置可以参考 : https://fluid-dev.github.io/hexo-fluid-docs/

在调试时 可以通过

1
2
3
4
5
6
7
8
hexo g --debug 来查看具体的配置信息  如归档标签页的配置信息

"archive": {
"banner_img": "/img/default.png", # 指定背景图片
"banner_img_height": 60, # 图片占全屏的比例
"banner_mask_alpha": 0.3 # 不透明度
},

每次修改后需要使用hexo clean 再进行 生成和部署。

然后就可以开始 创建文章了,创建后会提示你md文件的地址,就可以进行编辑了。

1
hexo new "hello world"

相关内容 : https://hexo.io/zh-cn/


基于HEXO的博客搭建
http://gadoid.io/2025/03/21/基于HEXO的博客搭建/
作者
Codfish
发布于
2025年3月21日
许可协议