Hexo快速、简洁且高效的博客框架

依赖

nodejs Node.js 12.0 及以上版本,14.0以下版本(推荐12.16.2)

安装

全局安装

1
npm install -g hexo-cli

在要创建站点的文件夹下执行

1
2
3
hexo init myblog
cd myblog
npm install

新建完成后,指定文件夹的目录如下:

1
2
3
4
5
6
7
8
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

_config.yml 网站的 配置 信息,您可以在此配置大部分的参数

scaffolds
模版 文件夹。当您新建文章时,Hexo 会根据 scaffold 来建立文件。

Hexo的模板是指在新建的文章文件中默认填充的内容。例如,如果您修改scaffold/post.md中的Front-matter内容,那么每次新建一篇文章时都会包含这个修改。

source
资源文件夹是存放用户资源的地方。除 _posts 文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。

themes
主题 文件夹。Hexo 会根据主题来生成静态页面。

创建文章

1
hexo new 我的第一篇文章

默认在source/_posts文件夹中创建 我的第一篇文章.md
文章默认信息如下

1
2
3
4
5
6

---
title: 我的第一篇文章
date: 2022-01-25 21:07:45
tags:
---

然后编写自己的blog

运行

启动命令

1
hexo server

默认 http://localhost:4000 查看自己些的博客

启动命令也可简写

1
hexo s

打包

打包文件

1
hexo generate

打包之后生成的静态文件在public 文件夹

然后将public文件夹内的静态文件,放到自己网站的根目录就可以了

启动命令也可简写

1
hexo g

也可用dabug 方式监控生成情况

1
hexo g --debug

官网地址

更加详细的说明,请参考官网:

https://hexo.io

安装问题处理

关于hexo搭建博客——生成index.html页面为空

第一种:nodejs版本不兼容

主要原因是 nodejs版本不兼容,14+的版本都不行。
导致生成的index.html文件是空白的。
解决办法
重新安装nodejs 推荐12.16.2
安装完毕之后,
执行hexo g 会在本地Blog文件夹下,生成启动文件,打开里面的index.html如果有,内容说明问题解决了。

第一种:缺少相应包文件

问题情况: hexo g 命令后无相应静态文件index.html生成。
结局办法

hexo g 无法生成 index

但是一些文件没有生成,如 index.html 文件。

查看 npm 安装各 hexo 插件的情况
npm ls –depth 0
hexo 的一些插件未安装插件
npm ERR! missing npm ERR! missing hexo-generator-archive…

解决
逐一安装缺失的包

npm install hexo-generator-archive –save

安装完后重新构建即可解决。

第二种:缺失相应配置文件

问题情况:生成了index.html,但是此文件大小为0kb,博客首页文章预览正常显示,点开跳转为空白页面。
解决方案:git bush后运行hexo g –debug,即可在出现的结果中找到相应错误。例如会出现”can’t find xxxxxx”。即说明某个配置文件被引用,但你的文件里并没有这个文件,进行添加即可。

第三种:缺少.md文件

问题情况: hexo g 命令后无相应静态文件index.html生成。
解决方案:查找_post文件夹是否有相应的.md文件

一辈子很短,努力的做好两件事就好:
第一件事是热爱生活,好好的去爱身边的人;
第二件事是努力学习,在工作中取得不一样的成绩,实现自己的价值,而不是仅仅为了赚钱。

继开 wechat
欢迎加我的微信,共同交流技术