一、搭建博客教程

如何用Hexo搭建个人博客? (fiveth.cc)

二、更换主题教程

开始使用 | Hexo Fluid 用户手册 (fluid-dev.com)

三、常用命令

1、生成新文章

我们在Blog文件夹中打开git bash,输入下方代码就可以生成新的文章md文件

1
hexo new 文章标题

文章是.md格式,在我们的Blog文件夹中的source/_posts中

2、预览+上传

这条命令会:

  1. hexo clean - 清理旧缓存(几秒)
  2. hexo generate - 重新生成所有文件(耗时的主要部分)
  3. hexo server - 启动服务器(瞬间完成)
1
hexo clean && hexo generate && hexo server

最后的上传

1
hexo d

3、直接上传

清除缓存可以用

1
hexo clean

最后的上传

1
2
hexo g
hexo d

4、关于页layout

参考官方文档:开始使用 | Hexo Fluid 用户手册

layout:会影响文章显示的方式,会失去侧边栏标题

首次使用主题的「关于页」需要手动创建:

1
$ hexo new page about

创建成功后修改 /source/about/index.md,添加 layout 属性。

修改后的文件示例如下:

1
2
3
4
5
6
---
title: 标题
layout: about
---

这里可以写正文,支持 Markdown, HTML

WARNING

layout: about 必须存在,并且不能修改成其他值,否则不会显示头像等样式。

四、常用路径

博客中插入图片推荐路径:

1
D:\Hexo\blog\source\img

博客文档目录

1
D:\Hexo\blog\source\_posts

五、Front-matter

Hexo 博客里常说的 Front-matter,可以把它想象成一篇文章的 “身份证”和“控制面板” ,位于 Markdown 文件最上方 --- 围起来的区域,专门用来给文章设置独立属性和样式。它会覆盖主题的全局设置,让你能实现更个性化的定制。

参考链接:Front-matter | Hexo

具体到你给出的这几个参数,它们的作用分别是:

参数 作用 示例值
title 设置网页浏览器标签栏上显示的文章标题,也是博客页面通常显示的标题。 title: B站相关
date 指定文章的发布日期和时间。 date: 2024-12-21 19:58:49
description 写一段文章摘要。这会显示在搜索引擎结果和社交平台分享卡片中,对 SEO 很友好。 description: B站那些事
layout 指定文章使用哪个布局模板。post 就是普通的文章页布局。 layout: post
cover 指定在博客首页、归档页列表中显示的文章封面图。如果不想显示封面,可以设为 false cover: /img/bilibili.jpg
index_img 文章在首页的封面图 index_img: /img/example.jpg
excerpt 这是摘要;无论哪种摘要都最多显示 3 行,当屏幕宽度不足时会隐藏部分摘要。优先级: 手动摘要 > 自动摘要。 excerpt: 这是摘要
hide 如果想把某些文章隐藏,不在首页和其他归档分类页里展示,就写true。隐藏后依然可以通过文章链接访问,所以可以用于一些需要链接跳转的特殊文章。 hide: true

六、报错

hexo d的时候报错:spawn failed

Hexo错误:spawn failed的解决方法 | 张洪Heo