Hexo 主题 One Paper 常见问题解决方案-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00081/article/details/144416639

Hexo 主题 One Paper 常见问题解决方案

hexo-theme-one-paper 专注于写作，模拟纸张阅读感受的轻量 Hexo 主题。项目地址: https://gitcode.com/gh_mirrors/he/hexo-theme-one-paper

项目基础介绍

Hexo 主题 One Paper 是一个专注于写作、模拟纸张阅读感受的轻量级 Hexo 主题。该项目由 zheli-design 开发，设计于 2022 年 2 月。主题的主要特点是“小而美”，旨在为用户提供一个朴素、干净、轻量的写作环境，模拟在实体纸张上的阅读感受。

主要编程语言

该项目主要使用的编程语言包括：

CSS：用于样式设计和页面布局。
EJS：用于模板引擎，生成动态页面内容。

新手使用注意事项及解决方案

1. 安装主题后无法正常显示页面

问题描述：新手在安装 One Paper 主题后，启动 Hexo 服务时，页面无法正常显示，可能是由于主题文件未正确放置或配置文件未正确修改。

解决步骤：

检查主题文件路径：确保将 one-paper 文件夹正确放置在 hexo/themes 目录下。
修改配置文件：打开 Hexo 根目录下的 _config.yml 文件，找到 theme 配置项，将其值修改为 one-paper。
重启 Hexo 服务：在终端中运行 hexo clean 清除缓存，然后运行 hexo s 重新启动服务，预览页面。

2. 代码高亮功能未生效

问题描述：主题内置了 highlightjs 和 highlightjs-line-numbers 插件，但新手在编写代码时发现高亮功能未生效。

解决步骤：

检查 Hexo 配置：打开 Hexo 根目录下的 _config.yml 文件，找到 highlight 和 prismjs 配置项，确保它们的 enable 值为 false。
```
highlight:
  enable: false
prismjs:
  enable: false
```
重新生成静态文件：运行 hexo clean 清除缓存，然后运行 hexo generate 生成静态文件。
预览页面：运行 hexo s 启动服务，查看代码高亮效果。

3. 自定义字体未生效

问题描述：新手在自定义字体时，发现内置的 Google 字体 Montserrat 未生效，或希望使用其他字体。

解决步骤：

删除或修改字体文件：

删除 source/fonts 目录下的所有文件。
修改 source/css/fonts.css 文件中的字体配置。

修改 source/css/style.css 文件中第 21 行的字体配置，替换为所需字体。

body {
  font-family: "Your Font", "SF UI Text", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "Segoe UI", "Helvetica Neue", Helvetica, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", sans-serif;
}