Hexo简易教程

这个博客是用Hexo搭建的,那么第一篇内容就简单写一下Hexo的使用教程吧!

本文章以Windows平台为准

安装NodeJS

Hexo是需要NodeJS才能运行的,需要先安装NodeJS,如果已经安装最新版本则跳过这一步

NodeJS下载地址

https://nodejs.org/zh-cn

点击左边的绿色按钮下载“长期维护版”

下载回来是个安装包,一直点下一步直到安装完成即可

安装Git

Git 是用来下载代码的软件,Hexo需要Git下载代码模板

Git下载地址

https://git-scm.com/

点击“Download for Windows”按钮下载

下载回来也是个安装包,一直点下一步直到安装完成即可

安装Hexo

按Win+R打开“运行”对话框,输入cmd回车,打开“命令提示符”

输入下面的命令安装Hexo

npm install hexo-cli -g

等黑框中的文字不再变化,命令执行完成之后,则安装完成,可以关闭命令提示符

初始化博客

首先新建一个文件夹来存放博客的相关文件,例如在C盘根目录创建一个blog的文件夹

然后进入这个文件夹,在地址栏中输入cmd,会自动打开命令提示符并切换到这个文件夹

输入下面的命令来初始化博客

hexo init

看到下面几行提示就表示初始化完成

INFO  Cloning hexo-starter https://github.com/hexojs/hexo-starter.git
INFO  Install dependencies
INFO  Start blogging with Hexo!

查看已初始化的博客

就在上一步的命令提示符中,输入下面的命令

hexo server

会看到下面的提示,表示已经启动好了测试服务器,用浏览器打开提示中的网址可以看效果,这里的网址是
http://localhost:4000/

INFO  Validating config
INFO  Start processing
INFO  Hexo is running at http://localhost:4000/ . Press Ctrl+C to stop.

确认到博客能正常访问后,在命令提示符中点击Ctrl+C关闭测试服务器

修改博客设置

博客的设置在_config.yml里面,该文件内容不少,但是改动不大的话需要修改的地方不多,用文本编辑器修改以下几项即可

title: 网站标题

网站标题,按需修改

subtitle: ''

网站副标题,没有可以保持原样

description: ''

网站描述,没有可以保持原样

keywords:

网站搜索关键字,没有可以保持原样

author: Author

网站作者,按需修改

language: zh-CN

网站语言,中文网站的话就按上面这样写

timezone: 'Asia/Shanghai'

网站时区,中文网站的话就按上面这样写

修改博客文章

初始化博客后会自动创建一个欢迎文章,在source文件夹的_posts文件夹里面会有个hello-world.md的文件,这个是默认创建的欢迎文章

Hexo的文章默认都是用Markdown的格式编写的,可以使用Markdown在线编辑器编写和修改博文,例如:

https://tool.lu/markdown/

修改完成后,启动前一步的测试服务器,可以看到效果

创建新博文

在命令提示符中,执行下面命令可以创建一个新的博文

hexo new "博文标题"

会看到下面的提示

INFO  Validating config
INFO  Created: C:\blog\source\_posts\博文标题.md

在source文件夹的_posts文件夹里面会出现文件名为刚刚新建的标题的md文件,用编辑器修改编辑保存即可

输出网页文件

写好博文以后,在命令提示符中,执行下面命令可以输出网页文件

hexo generate

会看到下面的提示

INFO  Validating config
INFO  Start processing
INFO  Files loaded in 79 ms
INFO  Generated: archives/index.html
INFO  Generated: archives/2023/index.html
INFO  Generated: index.html
INFO  Generated: archives/2023/06/index.html
INFO  Generated: js/script.js
INFO  Generated: css/style.css
INFO  Generated: fancybox/jquery.fancybox.min.css
INFO  Generated: js/jquery-3.6.4.min.js
INFO  Generated: fancybox/jquery.fancybox.min.js
INFO  Generated: 2023/06/12/博文标题/index.html
INFO  Generated: css/images/banner.jpg
INFO  Generated: 2023/06/12/hello-world/index.html
INFO  12 files generated in 256 ms

生成的网页文件都在public目录里面,把文件上传到你的服务器就发布完成了

参考

Hexo官网 https://hexo.io/zh-cn/