《博客框架 学习笔记 之 hexo》

本文详细介绍了如何使用Hexo搭建个人博客,包括安装、部署到GitHub、添加搜索功能、GitHubCorners插件和音乐播放器。涉及主题定制、图标设置、头像管理及常见问题解决方案。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >


博客框架

个人博客 访问地址如下:

在这里插入图片描述

  • 常见的博客框架hexoWordPressVuePressHugoSoloHaloTypecho、…

博客主题

  • 常见的 博客主题jekyllFluidButterflyMateryAkinaMuseMistPiscesGeminiMirages、…

主题:NexTYiliaMelodymellow、、、、、、、

hexo 主题查找


hexo

  • 简介

Hexo 是一个基于Node.js的快速、简洁且高效的静态博客框架。Hexo 支持 Markdown 解析文章,在几秒内,即可利用靓丽的主题生成静态网页

hexo 默认主题: —> landscape

在这里插入图片描述

  • hexo 版本
    在这里插入图片描述

Hexo官网
Hexo中文网


安装hexo
  • 安装 hexo 的基础依赖 —> git 和 nodejs 的安装
    在这里插入图片描述

  • step1: 创建文件夹 personal_blog_yk-ddm, 进入此文件夹
    在这里插入图片描述

  • step2: 执行 npm 包管理命令 —> 安装 hexo-cli ( hexo 命令行界面)cnpm install hexo-cli
    在这里插入图片描述
    在这里插入图片描述

  • step3: 查看 hexo 版本 : hexo -v
    在这里插入图片描述

  • step4: 初始化 hexo : hexo init myblog
    在这里插入图片描述
    在这里插入图片描述

  • step5: 进入 myblog 文件夹中,开启服务 —> hexo server
    在这里插入图片描述

关闭服务 —> Ctrl + C

在这里插入图片描述


将 hexo 部署到 GitHub
  • 修改配置文件 _config.yml
    在这里插入图片描述
  • 安装deploy-git : npm install hexo-deployer-git --save
    在这里插入图片描述

执行 hexo clean ----> 清空
执行 hexo generate -----> 生成静态文章
执行 hexo deploy ------> 部署发布至 github

在这里插入图片描述

  • 查看效果
    在这里插入图片描述
    在这里插入图片描述

为 hexo 个人博客添加站内搜索

先安装插件 cnpm install hexo-generator-search --save

在这里插入图片描述

执行 cnpm install hexo-generator-searchdb --save

在这里插入图片描述

修改项目的配置文件 _config.yml

# 添加如下内容:
search:
  path: search.xml
  field: post
  format: html
  limit: 10000

在这里插入图片描述

编辑主题文件夹的 _config.yml 配置文件,设置 Local search 的 enable 为 ture

在这里插入图片描述


为 个人博客添加 GitHub Corners

GitHub Corners 地址

在这里插入图片描述

编辑代码如下

在这里插入图片描述
在这里插入图片描述

效果展示

在这里插入图片描述


Butterfly 添加全局吸底Aplayer ( 音乐播放器 )

Butterfly添加全局吸底Aplayer教程

前往 aplayer 官网


插件安装

cnpm install hexo-abbrlink --save : 博客链接永久化

在这里插入图片描述

npm install hexo-generator-search --save ----> 搜索插件安装

在这里插入图片描述

npm i hexo-generator-feed -----> 订阅插件 RSS 安装

在这里插入图片描述


使用 iconfont 图标

step1: 从 阿里图标 官网 下载 iconfont.css 文件

step2: 将 iconfont.css 文件复制到 hexo 主题theme/source/css/ 中

在这里插入图片描述

在主题的配置文件中进行如下配置,引入刚刚存入的 css 文件

在这里插入图片描述

设置完毕,即可使用 iconfont icon-csdn1: https://blog.csdn.net/yk_ddm || CSDN

在这里插入图片描述

测试查看效果

在这里插入图片描述


设置 avatar 头像
  • 在 主题的 _config.yml 中配置
    在这里插入图片描述

草稿 draft 的使用
  • hexo new draft draft-test01
    在这里插入图片描述
  • 将 草稿文章发布到 post 中hexo publish draft newspapername , 系统会自动删除 _drafts 中对应的草稿文章
    在这里插入图片描述

常见操作

语言修改; 配置文件 _config.yml; 默认语言是 en
主题支持三种语言: default(en)、zh-CN (简体中文)、zh-TW (繁体中文)

Front-matter 即 文章开头部分(-----)

在这里插入图片描述

Butterfly 主题的使用

在这里插入图片描述

书写文章:hexo new newspapername, 注意事项 —> 文章名称不要包含空格,否则会出现文件名称不对应的情况(例如:我使用 hexo new post 《博客框架 学习笔记 之 hexo》最后得到的Markdown文件名称却为 hexo》)

hexo new [layout] ----> layout 布局方式,默认 post 布局

layout 布局方式:postpagedraft

在这里插入图片描述

_config.yml : 作为 hexo框架 的配置文件

配置文章的 永久链接 格式,方法如下:第一步,在 _config.yml 配置文件中修改 permalink 的值;第二步,在自定义文章开头书写 category 文章类别

在这里插入图片描述
在这里插入图片描述

  • 查看效果
    在这里插入图片描述
  • layout 中 page 的使用
    在这里插入图片描述

遇到的问题

{ err: TypeError: line.matchAll is not a function
在这里插入图片描述

  • 分析原因:是 node 版本问题, node 12.0.0 以上就没有此问题
    在这里插入图片描述

  • 解决: 尝试 将 _config.yml文件 修改一下
    在这里插入图片描述
    在这里插入图片描述

  • 浏览器运行查看
    在这里插入图片描述

  • problem Two:
    在这里插入图片描述

  • 分析原因: 是没有正确安装 hexo-deployer-git
    在这里插入图片描述

  • problem Three
    在这里插入图片描述

  • 分析原因: 权限问题,我之后采用 ssh 方式之后,解决问题
    在这里插入图片描述
    在这里插入图片描述

  • problem fourth : TypeError: Cannot read property 'enable' of undefined
    在这里插入图片描述

  • 分析原因:

  • problem
    在这里插入图片描述

  • 分析原因: 需要 下载包 hexo-renderer-jade hexo-generator-feed hexo-generator-sitemap hexo-browsersync hexo-generator-archive

执行 cnpm install --save hexo-renderer-jade hexo-generator-feed hexo-generator-sitemap hexo-browsersync hexo-generator-archive

theme: butterfly

在这里插入图片描述

在这里插入图片描述

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值