初始化本地文件夹为网站根目录(当前环境为“G:\Blog”)

hexo init

用于初始化一个新的 Hexo 博客项目。执行此命令时,它会创建一个新的 Hexo 项目目录结构,并在其中生成一些基础文件。这个命令用于第一次设置 Hexo 博客时

创建新文章

hexo new "文章title"

使用hexo new “title”创建新文章。其中title表示文章标题,在我的PC环境下hexo会在“G:\Blog\source_posts”文件夹下自动创建.md文件,进入目录编辑该.md文件即可自由编写文章

image-20240906191115954

Front-matter

打开使用**hexo new “title”**创建的文章,可以看到.md文章开头有一段前置信息,即Front-matter,用于给Hexo渲染md文档,除了默认给出的title、date、tags三项之外,还可以自己添加配置项,常用配置项如下:

详细Front-matter介绍参考Butterfly官方文档

配置项 含义
title 【必需】文章标题
date 【必需】文章创建日期
updated 【可选】页面更新日期
comments 文章评论功能是否启动(不懂)
tags 【可选】文章标签
categories 【可选】文章分类文章分类
keywords 【可选】文章关键字
description 【可选】页面描述
aside 【可选】显示侧边栏 (默认 true)
top_img 【可选】页面顶部图片
mathjax 【可选】显示mathjax(当设置 mathjax 的 per_page: false 时,才需要配置,默认 false )
….

image-20240906193007442

生成文章

hexo generate

hexo g

用于生成静态文件,两种写法都行,一般用下面那种,更加方便

预览文章

hexo server

hexo s

生成页面后,可以开启本地服务器预览一下是否满意,默认端口为4000;由于我在阿里云图床设置了图片防盗链,只有在博客的reference打开文章才能看到文章的图片,在本地预览是看不到文章中的图片的,http://*.aliyun.com博客的域名是图床的白名单,其他reference都无法查看图片,也不允许没有reference请求头,以便节省OSS下行流量费用

部署文章到远程服务器(当前使用github pages)

hexo deploy

hexo d

用于部署网站,一般简写成hexo d,将文章部署到远端服务器上,以便能通过github pages功能实现互联网访问

清理缓存

hexo clean

用于清理缓存文件,是一个比较常用的命令。通常在 hexo g(生成静态文件)和 hexo d(部署到服务器)之前使用。它的作用是清理 Hexo 的缓存文件和生成的静态文件,以确保新的生成过程不受旧文件的影响,使用 hexo clean 可以确保生成的内容是最新的

hexo根目录文件结构

  • source/ :存放文章内容的目录,发布的文章都在这个目录下,即.md文章源码的存储地
  • themes/:存放主题的目录
  • _config.yml:Hexo 的主配置文件(重要)
  • package.json:Node.js 项目的依赖配置文件
  • scaffolds/:定义内容模板,这些模板在创建新文章或页面时自动填充一些基本内容和结构,例如时间、title



除了上面常用的命令外,hexo还有一些其他命令,但是用得比较少,也有一些可以设置参数的命令,例如hexo s

  • -p: 指定服务器端口,默认为 4000
  • -i: 指定服务器 IP 地址,默认为 0.0.0.0,localhost
  • -s: 静态模式 ,仅提供 public 文件夹中的文件并禁用文件监视

etc……