Hexo - Redefine Theme 踩过的坑

2023-12-21 21:28:12

众所周知,在自建博客这一界有个很强的东西:Hexo

但这其中的,可谓是劝退了不少初学者……

所以,今天我就来帮大家避一下

这篇文章的所有内容都是建立在 Hexo 的其中一个主题 Redefine 上的,且仅针对 Windows 系统,原因嘛……就是我现在在用这款主题。

PS: 这篇文章的内容对于其他主题和其他操作系统是否有效暂时未知,本文仅供参考。

新手教程

Hexo

安装

友情链接:Hexo安装文档

其实一开始和官网的教程差不多,可以直接 npm 全局安装。

如果有不了解 Node.js 的同学,我以后会单独出一篇教程来详细解说……

npm install -g hexo-cli

此外,如果你对 npm 熟悉一点,那么你可以仅局部安装 Hexo

npm install hexo

初始化

hexo-cli 中初始化一个博客项目的命令为 hexo init <folder>,其中 <folder> 为目录名(亦为项目名)。

hexo init <folder>
cd <folder>
npm install

接下来更详细的初始化步骤见 建站 | Hexo

启动

通过 hexo s 命令启动本地博客。

hexo s

主题:Redefine

友情链接:Redefine官方文档

安装

npm install hexo-theme-redefine@latest

启用

在 Hexo 根目录下(也就是刚才所说的<folder>)的 _config.yml,把 theme 值修改为 redefine

theme: redefine

配置

在 Hexo 根目录下创建 _config.redefine.yml 文件,并将 此处 的所有内容复制进去。

本文件会自动覆盖主题的配置项,创建本文件的目的是为了方便你在升级主题时,不会丢失你的配置。

主题初始化完成

接下来你可以启动 Hexo 看看效果。

踩过的坑

接下来是咱们今天的重点……

Hexo 版本

Hexo 的版本一定要不能升到最新版(@7.0.0),就目前作者试验,最高可以升到 @6.3.0 版本,否则 tags 可能会报错 site.tags.date is not iterable,可以通过 npm list 查看当前所有包的版本,如果需要升级的,可以执行以下指令。

npm install hexo@6.3.0

LaTeX 渲染

如果想要完整显示所有 LaTeX 公式,首先需要安装插件 hexo-filter-mathjax

npm install hexo-filter-mathjax

然后在 Hexo 配置文件 _config.yml 最底下增加如下配置。

mathjax:
  tags: none               # 或 'ams' 或 'all'
  single_dollars: true     # 启用单个美元符号作为内联(行内)数学公式定界符
  cjk_width: 0.9           # 相对 CJK 字符宽度
  normal_width: 0.6        # 相对正常(等宽)宽度
  append_css: true         # 将 CSS 添加到每个页面
  every_page: true         # 如果为 true,那么无论每篇文章的前题中的 `mathjax` 设置如何,每页都将由 mathjax 呈现

接着必须把 Hexo 原先内置的 Markdown 渲染工具 hexo-renderer-marked 卸载,其次安装 hexo-renderer-pandoc

npm uninstall hexo-renderer-marked
npm install hexo-renderer-pandoc

此时你可以尝试启动 Hexo 本地服务器看看效果,如果执行到 hexo g 时报错,那么你需要额外安装一个开源项目 Pandoc,仓库地址为 Pandoc,最后启动 Hexo 服务器,可以看到所有 LaTeX 及 数学公式 都显示出来了。


最后祝大家避过所有坑,走向成功!

文章来源:https://blog.csdn.net/Horean33_ybc/article/details/132779447
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。