Hexo 使用指南

Hexo 是一个基于 Node.js 的快速、简洁且高效的静态博客框架，允许用户通过简单的命令行操作生成静态网页，有良好的插件生态。官方文档

常用命令

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

项目配置

一、文件构建

安装 hexo

npm i -g hexo-cli

初始化项目结构

hexo init

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

hexo new page tags

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

hexo new page categories

配置 next 主题设置

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

二、配置主题

npm install hexo-theme-next
cp node_modules/hexo-theme-next/_config.yml _config.next.yml

【hexo.config】

theme: next

三、配置功能

（1）Git 上传

npm install hexo-deployer-git --save

（2）latex 公式

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

【_config.next.yml】

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

（3）本地图片

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

（4）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

（5）添加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

（6）修改样式

【_config.next.yml】

style: source/_data/styles.styl

【styles.styl】

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 文件夹下备份

问题解决博客

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

框架更新日志

2024.4.23

由于 NexT 主题此前使用的 Swig 模板引擎已停止维护，项目在去年迁移至 Nunjucks。然而，layout 目录下的模板文件后缀名并未更改。这是因为修改后缀名影响范围广泛，可能导致用户在执行 git pull 更新时出现大量冲突。为解决这些历史遗留问题，项目此次更换了仓库，并未保留之前的提交历史。综上所述，按照官网重新配置。