Hexo 使用指南

官方文档

常用命令

方法	代码
快速部署	hexo g -d
清除缓存	hexo clean
预览	hexo s
部署	hexo d
生成静态页面	hexo generate

初始化配置

初始化项目结构

hexo init

新增标签页，设置属性（type: “tags”）

hexo new page tags

新增分类，设置属性（type: “categories”）

hexo new page categories

配置 next 主题设置

• 设置 menu 菜单栏
• 打开 code 代码复制

Debug

hexo clean --debug
hexo s --debug

Git 上传插件

npm install hexo-deployer-git --save

latex 公式

安装 hexo-renderer-markdown-it-plus 后，Katex 与 mathJax 会重复，需要在 next 中配置

mathjax:
    enable: false
    tags: none
katex:
    enable: true
    copy_tex: false

本地图片

配置本地图片上传 Link Link

npm install hexo-asset-img --save  // 代替 hexo-asset-image

Markdown 文字高亮

Link

npm un hexo-renderer-marked --save
npm install hexo-renderer-markdown-it-plus --save

_config.yml

markdown:
    preset: "default"
    plugins:
        - markdown-it-mark

添加Sitemap

为自己的网站配置sitemap，可以有效地提升SEO

npm install hexo-generator-sitemap --save
npm install hexo-generator-baidu-sitemap --save

并在站点配置文件_config.yml的末尾添加：

sitemap:
  path: sitemap.xml
baidusitemap:
  path: baidusitemap.xml

改 blockquote 颜色

blockquote {
  background: #d0a7020d;
  border-left: 4px solid #d0a702;
  color: var(--blockquote-color);
  margin: 0;
  padding: 0 15px;

  cite::before {
    content: '-';
    padding: 0 5px;
  }
}

备份本地博客

利用mklink实现OneDrive自定义文件双向同步

MKLINK [[/D] | [/H] | [/J]] Link Target

        /D      创建目录符号链接。默认为文件符号链接。
        /H      创建硬链接而非符号链接。
        /J      创建目录联接。
        Link    指定新的符号链接名称。
        Target  指定新链接引用的路径
                (相对或绝对)。

管理员 PowerShell cmd /c mklink /D 目标地址 源地址 将博客硬链接到 OneDrive 文件夹下备份

更新主题 Next

由于 NexT 以前使用的 swig 模版引擎停止维护，去年迁移到了 Nunjucks，但是 目录下的模版文件后缀名没有更改。原因是修改后缀名影响太广，会使用户在执行 进行更新时产生大量的冲突。这次更换仓库为了解决这些历史遗留问题，没有保留之前的 commit 历史。

2024.4.23 按照官网配置

DeBug

Git 提交文件名全变小写问题