【必读】更新说明及常见问题 #4

stevenjoezhang · 2020-04-07T15:27:53Z

The following is the Chinese translation of the update notes. See
https://github.com/next-theme/hexo-theme-next/releases
and
https://theme-next.js.org/docs/troubleshooting.html#Quick-Debug-Instructions
for the English version.

以下是对 NexT 使用过程中常见问题的说明。

NexT 主题会尽可能保证配置文件向下兼容，使得用户能够平滑升级。但在 NexT 主题不断发展和完善的过程中，难免会出现配置和使用方式的变化。因此，在每次更新主题前，请务必阅读更新说明，特别是Breaking Change部分（这涉及到了一些重大更新，可能影响先前的用户配置或自定义）。切勿在不了解更新内容的情况下进行更新。

为了避免操作失误导致配置文件冲突或源码丢失，我们建议使用 Git 等工具对博客源码做好版本管理和备份。这样做有很多好处，比如你可以使用 GitHub Actions 来自动进行博客部署，也可以随时通过 Git 切换历史版本。

NexT 一贯以「开箱即用」为目标，尽量将简洁易懂的配置提供给用户。不过，虽然 _config.yml 配置文件中对很多配置选项都提供了注释，但一些选项的细节并没有完全展现。为了避免出现问题，请在进行配置和使用前阅读网站 https://theme-next.js.org 上对应的文档。对于文档中描述不清楚的地方，欢迎提出改进建议 😊

此外，通过搜索引擎可以找到许多 NexT 热心用户创作的教程文章。不过，在过去的数年时间里，NexT 新增了大量的 Feature，有部分内容是常见的教程没有涵盖的。后文中摘录了部分 NexT v7 版本的新功能及使用说明，供参考。

问题反馈方式

使用 NexT 时遇到了问题？不用担心！有许多种方法可以与 NexT 主题开发/维护者团队（下称「NexT 团队」）或其他用户取得联系，共同解决问题：

Discord Server（中文/英文）: https://discord.gg/qmkgkY3jaG
Gitter（英文）: https://app.gitter.im/#/room/#next:gitter.im
Telegram 群（中文）：https://t.me/theme_next_cn
使用 GitHub Discussions 功能发帖：https://github.com/next-theme/hexo-theme-next/discussions

环境

操作系统

我们通过 GitHub Actions 进行自动化测试，确保 NexT 可以在 Windows，macOS 以及 Linux 上正常使用： https://github.com/next-theme/hexo-theme-next/actions?query=workflow%3ATester

Hexo 支持直接在 Windows 上运行，安装 Node.js 即可。使用 WSL 安装也是可以的。不推荐使用 mingw 环境。

Hexo 与 NexT 兼容性

如果可能，请始终使用最新版本的 Hexo 和 NexT。新版本 Hexo 带来的渲染性能的提升非常显著。

NexT 仓库

NexT 一共有三个不同的仓库：

版本	年份	仓库
v5.1.4 或更低	2014 ~ 2017	https://github.com/iissnan/hexo-theme-next
v6.0.0 ~ v7.8.0	2018 ~ 2019	https://github.com/theme-next/hexo-theme-next
v8.0.0 或更高	2020 至今	https://github.com/next-theme/hexo-theme-next

一些网络教程可能使用了旧仓库的链接。为了避免安装过时的 NexT 版本，请务必按照本仓库 README 中提供的几种安装方式进行操作。
跨版本的升级可能并不顺滑（例如由 v5.1.4 或 v7.8.0 升级至 v8.0.0），请备份配置文件及修改过的文件（例如自定义模板文件）后，重新安装新的主题。具体操作请阅读文档： https://theme-next.js.org/docs/getting-started/upgrade.html

NexT 自定义

NexT 支持在不修改主题仓库内文件的情况下进行配置和自定义，因此无论是使用 Git 还是 npm 安装的主题都能顺利更新。

`_config.next.yml` 配置文件

为了避免更新出现冲突，推荐使用 Alternate Theme Config 存储配置：https://theme-next.js.org/docs/getting-started/configuration.html
注：在升级到 Hexo 5.0 版本后，请留意配置方式上的改变，使用 Hexo 支持的 _config.next.yml 代替 source/_data/next.yml。旧的 next.yml 配置方式诞生于 2015 年（iissnan/hexo-theme-next#328），已经完成其历史使命，于 NexT v8.1.0 版本后停止支持。

v7.3.0 Custom Files 用法

PR theme-next/hexo-theme-next#868 调整了自定义布局或样式的方式，取消原本主题目录下的自定义文件（例如 _custom/custom.styl），只保留在配置文件中指定自定义文件的方式。自定义文件与主题文件分离是个好的实践，这样可以在不修改任何主题原始代码的情况下加入自定义内容；可以避免由于 git merge 产生冲突，同时也允许在通过 npm 安装主题时方便地进行自定义。

你可以将所有自定义布局或样式放在一个位置特定位置（比如：hexo-site/source/_data），然后取消注释主题配置文件中 custom_file_path 部分下对应的内容（注意文件名与路径要一致），即可完成对于主题的自定义。这个页面提供了几个使用 Custom Files 的例子，例如加载看板娘、修改页面宽度、隐藏 cheers 等等： https://theme-next.js.org/docs/advanced-settings/custom-files.html

Custom Files 在向页面中增加内容时非常方便。如果要在不修改主题源码的情况下修改或删除内容，请使用插件 https://github.com/jiangtj/hexo-extend-theme

NexT 插件

除了 custom_file_path，我们还提供了更加灵活的自定义方式（theme_inject），可以阅读文档： https://theme-next.js.org/docs/advanced-settings/injects.html

这一特性使得 NexT 主题拥有了一套不同于 Hexo 的插件系统。不妨看看这个仓库： https://github.com/next-theme/awesome-next
如果有新颖的想法，或着撰写了关于 NexT 主题的教程，抑或是希望将自己的博客作为 NexT 主题演示站，欢迎在这里提交 Pull Request！

v7.4.2 Nunjucks 引擎

鉴于 swig 缺乏维护，NexT 自 7.4.2 版本开始，使用 Nunjucks 代替 swig 作为模版引擎。如果此前根据 swig 的语法写过自定义内容，请在更新前确认它们是与 Nunjucks 兼容的，否则会报错，且生成的页面为空白。例如， Nunjucks 只支持 and 运算符，需要替换掉 swig 中的 &&。见 http://mozilla.github.io/nunjucks/getting-started.html

Hexo 5.0 版本移除了对于 swig 模版的支持。如果你发现 Hexo 生成的 html 中输出了 NexT 模版源码，说明你正在使用旧版本的 NexT，请重新安装或升级 NexT。

v7.6.0 `auto_excerpt`

自 7.6.0 版本开始，auto_excerpt 功能被移除，因为按照字数截断文章，必须先移除其中的 HTML 标签，这将导致图片、代码块显示错误，不符合 NexT 的设计原则。我们推荐通过  来精确控制 Read More 的位置。当然，也可以自行安装第三方插件：

https://github.com/chekun/hexo-excerpt
https://github.com/ashisherc/hexo-auto-excerpt

作出以上改动后，请执行 hexo clean。

v7.6.0 访问量统计

如果开启了访问量统计功能，请确保 Hexo 配置文件中的url正确设置为了你的网站域名，否则统计不会生效（这是为了屏蔽来自 http://localhost:4000 的流量）；如果使用 GitHub pages 和自定义域名，请将 url 设置为自定义域名而不是 *.github.io；如果同时使用了带有 www 和不带 www 的域名，请进行 301 重定向。

v7.7.2 升级 MathJax

7.7.2 版本中，NexT 主题升级了内置的 MathJax 的版本。旧版本的 NexT 文档中建议使用 MathJax 的用户安装 hexo-renderer-kramed，但由于这一插件已经停止维护，在这次 MathJax 升级后将不再被 NexT 支持，请使用 hexo-renderer-pandoc 代替（需要先安装 pandoc）。此外，如果在 vendors 中设置了 CDN 链接，请更新或移除它们以使用默认的 CDN 配置，否则会加载失败。

NexT 除内置的 MathJax 和 KaTeX 引擎外，还提供了 hexo-filter-mathjax 插件用于后端渲染，无需加载前端脚本，欢迎使用。

v7.7.2 Dark Mode

7.7.2 版本中，NexT 主题加入了对暗色模式的支持。在配置文件中设置 darkmode: true，并在启用了暗色模式的操作系统中，使用支持 prefers-color-scheme 属性的浏览器即可体验。
见 https://caniuse.com/prefers-color-scheme

v8.0.0-rc.1 自定义图标

NexT 主题自 8.0.0 版本开始，将自带的 Font Awesome 图标库由 4.7.0 版本升级为了 5.13.0 版本。此次升级并不向下兼容，请修改配置文件中与 Font Awesome 相关的内容，否则图标可能无法正常显示。
全部可选图标在此： https://fontawesome.com/icons
如果要使用 Font Awesome 没有收录的图标，请看这篇文章： https://blog.dlzhang.com/posts/32/

v8.0.0-rc.5 动画效果

鉴于 Velocity.js 缺乏维护，NexT 使用 Animate.css 代替之。两者的动画效果几乎完全一致，除了动画名称略有不同。如果在配置文件中设置了旧的名称（例如 slideDownIn），请将其移除或根据此网页选择新的动画效果：
https://theme-next.js.org/animate/

v8.0.0 CDN 设置

NexT 已支持一键切换 CDN 服务商，而不需要为每个插件单独设置 CDN 地址。见 https://theme-next.js.org/docs/advanced-settings/vendors.html
手动设置 CDN 地址会增加管理成本，并且可能错误地加载不兼容的脚本。我们不建议用户继续使用这一方式。

v8.1.0 移除 Valine

Valine 使用 Leancloud 作为后端，是一个深受静态博客用户喜爱的评论系统。然而 Valine 暴露出了一些令人担忧的问题：

Valine 自 1.4 版本起不再开源，发布的打包版本中存在未告知用户的百度统计代码；
2020 年 11 月下旬出现了针对 Valine 的垃圾评论攻击；
CVE-2021-34801

考虑到这些问题已经严重影响到 NexT 用户的数据安全，我们决定将其移除，需要继续使用的用户请安装插件： https://github.com/next-theme/hexo-next-valine
（插件的配置项使用驼峰命名，与 Valine 本身一致，需要注意将 appid 和 appkey 改为 appId 和 appKey）
由于 Valine 不再开源，NexT 团队无法对其 Debug。如果在使用时出现任何问题，请在这里反馈： https://github.com/xCss/Valine/issues
从 Valine 迁移到 Disqus： https://github.com/YunYouJun/valine-to-disqus

v8.10.0 Highlight.js 兼容性

NexT 为了支持 highlight.js 提供的近百个代码高亮主题，使用正则表达式从 css 中提取代码块的前景、背景色。虽然这样做可能无法完全支持 css 的语义信息，但对现有的绝大多数 highlight.js 主题都适用。highlight.js 11.0 版本后发布的 css 经过了压缩，导致原有的正则表达式失效，因此向 stylus 引擎传递了空值。这一问题在 NexT 的 8.10.0 版本中被修复。NexT 此前默认的暗色代码高亮主题 tomorrow-night 同样跟随 Highlight.js 更新，请手动将其更改为 base16/tomorrow-night。

可能导致 Hexo 或 NexT 出现问题的插件或服务

名称	问题描述	解决方案	Issue
hexo-helper-live2d	会导致不蒜子计数无法加载	不要同时使用	theme-next/hexo-theme-next#1233 (comment)
aplayer	导致中文目录无法点击	不要使用 aplayer	DIYgod/APlayer#242

参考文章：busuanzi 访问量统计与 live2d 插件同时使用导致 busuanzi 不显示的根本原因以及解决方法 - ouuan's blog

其它常见问题

在 Hexo 的 _config.yml 中有一些选项可以修改页面的永久链接形式（permalink）。而 NexT 所集成的评论系统可能需要通过页面的 URL 加载对应的数据。如非必要，请不要修改有关设置，以免评论数据丢失。
如果自定义了部分元素的 opacity，那么这会创建新的层叠上下文，进而影响其它元素的 z-index 表现，例如导致搜索框显示不正常（本地搜索框被覆盖 theme-next/hexo-theme-next#914）
Group Picture 推荐与 FancyBox 插件一同使用。如果在一行中包含宽高比不同的图片，MediumZoom 可能会在放大时错误地计算图片尺寸。(images in a row with hardcoded height, look bad when zoomed in francoischalifour/medium-zoom#147 (comment))
不蒜子计数依赖于浏览器请求中的 Referer 信息来获取页面的访问量数据。如果你使用的浏览器具有阻止跨站追踪功能（例如 Safari），那么浏览器可能会忽略网站设定而使用最严格的 Referrer-Policy，导致加载的访问量数据不准确。另见 https://caniuse.com/referrer-policy

Issue 和 Pull Request 规范

NexT 团队仅对使用最新版本 NexT 主题的用户提供技术支持，并将拒绝解答使用旧版本 NexT 出现的任何问题。 如果使用版本号为 5.x 至 7.x 的主题出现问题，请到对应的旧的仓库中提交 Issue。
1.1 如果使用 npm 安装主题，那么默认是本仓库的最新版本，不用担心。
1.2 如果使用 git 安装主题，请务必检查主题的 package.json 中 version 字段版本号是否正确。

提交 Issue

如果在使用中遇到问题，欢迎提交 Issue。在提交 Issue 前，可以先在已有的 Issue 中搜索一下，或许就能找到相似的问题；尽量不要重复提交。

提交 Issue 时，请务必根据模版，提供网站的链接、源码仓库和有关截图。 需要这些信息的原因是：

有时一些 bug 需要在特定的条件下才能够复现（例如，安装了某个 Hexo 插件，或者使用了某个特定的浏览器），提供尽可能多的信息，能够使 NexT 团队更快地定位问题
在未来，可能有其他遇到了相同问题的用户，如果 Issue 中只提供了网站链接，而链接发生变化，那么这个 Issue 就无法参考了。

关于 Bug

为了更快地解决问题，在使用 NexT 主题遇到 Bug 时，可以先自行按照以下方法排查（因为问题可能并非来自 NexT 主题本身）： https://theme-next.js.org/docs/troubleshooting.html#Quick-Debug-Instructions

如果对主题进行过自定义，那么请移除全部的自定义文件，检查 Bug 是否仍然存在。

如果是在升级 Hexo 或 Hexo 插件后遇到的问题，请尝试：

将全部 Hexo 插件都升级到最新版本（以避免 Hexo 版本兼容性问题），可以使用 npm-check 等工具辅助；
如果报错信息来自第三方插件，可以卸载插件或将 Hexo 退回旧版本，一些插件可能由于长时间未更新，与新版 Hexo 不兼容；
按照本「更新说明」的指导，在清楚更新内容的情况下，升级 NexT 主题至最新版本。

如果这并非一个来自于 NexT 主题的 bug，可以尝试向 Hexo 团队寻求帮助：https://github.com/hexojs/hexo/issues

另见： https://github.com/next-theme/hexo-theme-next/blob/master/docs/zh-CN/CONTRIBUTING.md#你需要了解的

关于 Feature Request

使用前文介绍的 custom_file_path ，可以轻松地将自定义的 HTML，JavaScript 和 CSS 插入到页面中。因此，对于一些简单且小众的功能，我们建议用户自行实现，并通过 Awesome NexT 进行推广。例如，想要在页面中隐藏一个组件，往往用一行 CSS 就可以实现。这时我们一般不会考虑专门为此在配置文件中增加新的选项。

关于 Pull Request

我们非常欢迎通过 Pull Request 来加入新功能或修复 Bug。在修改主题的样式时，请注意考虑 NexT 主题四个 Scheme 之间的差异。这可能要求额外的代码来确保样式的一致性，并避免改动对于其它 Scheme 的破坏。此外，配色方案的设计也需要考虑暗色模式的支持。

写在最后：如果你希望 NexT 主题变得更好，那么欢迎加入 Telegram 群聊或参与 GitHub 上的讨论，因为许多关键的改动都会通过投票的方式征求意见。我们非常希望用户的反馈能够产生积极的效果。对 NexT 社区做出贡献的方法有很多，如果你是开发者，那么提交代码是最直接的方式；而对于广大用户而言，及时地将使用体验反馈给 NexT 团队同样是非常重要的。

感谢各位对 NexT 主题及 NexT 团队的支持。祝使用愉快！

The text was updated successfully, but these errors were encountered:

Early0v0 · 2020-05-09T14:32:20Z

在 “v8.0.0 自定义图标”

NexT 主题自 8.0.0 版本开始，将自带的 Font Awesome 5 图标由 4.7.0 版本升级为了 5.13.0 版本。此次升级并不向下兼容，请修改配置文件中与 Font Awesome 相关的内容。
此外，Font Awesome 可能缺少一些社交网站的图标，解决方案见这篇文章： https://blog.dlzhang.com/posts/89dad1c1/

这里的链接应为 https://blog.dlzhang.com/posts/32/

Early0v0 · 2020-05-09T14:51:20Z

请问：

团队 theme-next 与 next-theme 是什么关系？
NexT 仍会保证每个月更新吗？（月初追求：更新 NexT）
v8.0.0 是还没正式发布吗？

stevenjoezhang · 2020-05-09T16:59:43Z

简单来说，问题就是 theme-next 团队的 owner - Ivan Nginx 始终拒绝向其它任何团队成员提供足够的权限，且 owner 本人自 2019 年 10 月起已连续半年不在线，导致其它活跃的团队成员无法管理仓库，也无法邀请新的成员。
由于对 theme-next 团队的未来不抱有期望，我作为 theme-next 的主要贡献者，自 2020 年 4 月起停止为旧的仓库贡献代码，并创建了新的组织，以确保维护工作正常进行。
只要能够收到足够多的 Bugfix / Feature Request，每月更新肯定不是问题。
目前已经发布的版本在这里： https://github.com/next-theme/hexo-theme-next/releases
v8.0.0 版本计划在 Hexo 5.0 版本后发布。

（历史总是惊人地相似： iissnan/hexo-theme-next#2061 (comment) ）

Early0v0 · 2020-05-12T11:29:22Z

简单来说，问题就是 theme-next 团队的 owner 始终拒绝向其它任何团队成员提供足够的权限，且 owner 本人自去年 10 月起已连续半年不在线，导致其它活跃的团队成员无法管理仓库，也无法邀请新的成员。
由于对 theme-next 团队的未来不抱有期望，我作为 theme-next 的主要贡献者，自 4 月起停止为旧的仓库贡献代码，并创建了新的组织，以确保维护工作正常进行。

只要能够收到足够多的 Bugfix / Feature Request，每月更新肯定不是问题。

目前已经发布的版本在这里： https://github.com/next-theme/hexo-theme-next/releases
v8.0.0 版本计划在 Hexo 5.0 版本后发布。

感谢！

请问如何从原仓库（theme-next/hexo-theme-next）的 v7.8.0 更新到 v8.0.0-rc.x？
本仓库并没有 v7.8.0 的 tag，所以我无法合并两个版本。

stevenjoezhang · 2020-05-12T14:22:54Z

更新的话需要备份当前的更改（例如自定义文件），~~然后重新执行 git clone~~。更新：现在可以通过 npm 安装主题了

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

jiangtj · 2020-05-13T01:30:45Z

这次更换仓库为了解决这些历史遗留问题，没有保留之前的 commit 历史。

哇哦

KuGouGo · 2020-05-14T00:13:35Z

支持一波

sli1989 · 2020-05-14T01:44:49Z

支持一波

pplmx · 2020-05-14T05:31:10Z

资瓷

imzhangmengxin · 2020-05-14T05:40:54Z

资瓷

gapplef · 2020-05-14T05:45:33Z

@stevenjoezhang 原先的NexT Telegram中文群已经荒废，希望能建立新的互助讨论群

stevenjoezhang · 2020-05-14T06:24:44Z

OK，建了一个新的群： https://t.me/theme_next_cn

sli1989 · 2020-05-20T07:53:28Z

可以把命名规则都变为next-theme吗。fork带编号，强迫症。

aixiu · 2020-05-20T10:21:14Z

@stevenjoezhang 我的天，我终于知道为什么这些天没更新了。还好，我找到新家！~！感谢！看来，我需要一个很大的工作量了。来把之前的主题转移到新的上边来！
还有一个小问题：

markdown 设置了如：[Github](http://github.com "Github") - 国外知名的代码托管
但是这个title默认不会显示，如上图。

stevenjoezhang · 2020-05-20T11:43:12Z

Hexo 移除 cheerio 后，NexT 使用正则对 exturl 进行替换。目前由于技术原因，设置 exturl: true 时无法显示 title。见

hexo-theme-next/scripts/filters/post.js

Line 15 in f4a12dc

    
           data.content = data.content.replace(/<a[^>]* href="([^"]+)"[^>]*>([^<]+)<\/a>/img, (match, href, html) => {

hexo-theme-next/source/js/utils.js

Line 56 in f4a12dc

link.title = element.title;

aixiu · 2020-05-20T11:54:36Z

感谢。为next-theme工作，辛苦了

9201314 · 2020-06-29T09:00:48Z

针对“其它已知问题”中的第二条：不要同时使用 busuanzi 和 hexo-helper-live2d
如果开启 Tidio，则 busuanzi+hexo-helper-live2d+Tidio，三者都能正常使用
不知道是什么原因，但这不失为一个“同时使用 busuanzi 和 hexo-helper-live2d”的好方法😂
附上三者都能正常运行的博客链接（如有违规请联系我删除）：我爱IT - 爱信息安全

linwhitehat · 2020-07-20T02:03:32Z

请问我今天更新hexo博客next主题配置后，执行hexo g发现出现错误提示如下：

ERROR The upstream repository of theme NexT has been changed.
ERROR For more information: https://github.com/next-theme/hexo-theme-next
ERROR Documentation: https://theme-next.js.org

请问导致的原因是什么？我目前使用的是next7.7.0版本，并没有更新到新版，只是个人修改了主题配置，这个问题如何解决呢？

stevenjoezhang · 2020-07-20T02:11:27Z

@linwhitehat 试试执行 hexo g --silent

linwhitehat · 2020-07-20T02:14:24Z

@linwhitehat 试试执行 hexo g --silent

嗯嗯好的，我试试，但是这个报错的原因是什么呢？上周还没有这个报错，我也一直没有更新新版主题，只是自己根据需求去修改配置内容，但是对博客好像也没有运行上的影响，纳闷

stevenjoezhang · 2020-07-20T02:22:22Z

@linwhitehat 这个没什么影响，可以忽略～

linwhitehat · 2020-07-20T02:25:32Z

@linwhitehat 这个没什么影响，可以忽略～

好吧，那这是因为我的next版本低导致的吗？还是因为原主题维护团队没有维护了，所以才产生的这个提示

bwcxyk · 2020-10-15T03:33:58Z

我下载新版尝试运行失败

stevenjoezhang · 2020-10-16T17:03:27Z

@bwcxyk 报错是因为没有找到 hexo-util 的 url_for。请检查你的 Hexo、hexo-util 及 npm 版本。

ghost · 2021-02-01T13:08:18Z

Hexo 移除 cheerio 后，NexT 使用正则对 exturl 进行替换。目前由于技术原因，设置 exturl: true 时无法显示 title。见

hexo-theme-next/scripts/filters/post.js

Line 15 in f4a12dc

data.content = data.content.replace(/<a[^>]* href="([^"]+)"[^>]*>([^<]+)<\/a>/img, (match, href, html) => {

hexo-theme-next/source/js/utils.js

Line 56 in f4a12dc

link.title = element.title;

~~也许 hexo 所使用的 htmlparser2 能用在这上面代替正则?~~ 正则也挺好

TrumanDu · 2021-03-15T08:20:37Z

已升级新版本，很赞，修复备案网址和utterances

AmosHuKe · 2021-07-03T05:12:49Z

有个很蠢的办法可以解决：不蒜子和hexo-helper-live2d不兼容，会把不蒜子display掉的问题。
思路：在不蒜子上方再写一遍不蒜子的代码，下面的不蒜子就不会被搞掉~像下面这样。

<!-- 被干掉的不蒜子  -->
<div style="display: none;">
    <span id="busuanzi_container_site_uv"></span><span id="busuanzi_container_site_pv"></span>
</div>

<!-- 能正常显示的不蒜子  -->
<div>
    <span id="busuanzi_container_site_uv">你是第<span id="busuanzi_value_site_uv"></span>位</span> / 
    <span id="busuanzi_container_site_pv">总访问量<span id="busuanzi_value_site_pv"></span>次</span>
</div>

mianhu · 2021-07-09T06:54:31Z

只有使用NEXT主题显示白屏怎么办，其他主题正常显示

sandyzikun · 2021-12-17T10:08:00Z

简单来说，问题就是 theme-next 团队的 owner 始终拒绝向其它任何团队成员提供足够的权限，且 owner 本人自 2019 年 10 月起已连续半年不在线，导致其它活跃的团队成员无法管理仓库，也无法邀请新的成员。
由于对 theme-next 团队的未来不抱有期望，我作为 theme-next 的主要贡献者，自 2020 年 4 月起停止为旧的仓库贡献代码，并创建了新的组织，以确保维护工作正常进行。

只要能够收到足够多的 Bugfix / Feature Request，每月更新肯定不是问题。

目前已经发布的版本在这里： https://github.com/next-theme/hexo-theme-next/releases
v8.0.0 版本计划在 Hexo 5.0 版本后发布。

（历史总是惊人地相似： iissnan/hexo-theme-next#2061 (comment) ）

前排資瓷

差點笑死，真的是驚人的相似，簡直完全一致。高考前我記得真正的hexo-theme-nextrepo是在theme-next名下，然後兩個月前回去看發現它還停留在2020年的版本，今天因爲需要回來找，發現官網指向這個repo，然後同時打開theme-next/hexo-theme-next和next-theme/hexo-theme-next的issues才發現原來發生了這樣的事情:joy:

galaxy-dot · 2022-02-18T04:40:28Z

不确定能否在这里提问，尝试了telegram，好像无人应答，姑且在这里再试一次。
问题：在local可以生成html，但是在travis-ci里无法生成，错误信息为
6.17s$ git submodule update --init --recursive Submodule 'themes/next' (https://github.com/next-theme/hexo-theme-next) registered for path 'themes/next' Cloning into '/home/travis/build/[secure]/[secure].github.io/themes/next'... fatal: remote error: upload-pack: not our ref 5[9]()27f1fe92537766c4c42e96fc89f7be1f5f759e fatal: Fetched in submodule path 'themes/next', but it did not contain 5927f1fe92537766c4c42e96fc89f7be1f5f759e. Direct fetching of that commit failed. fatal: The command "eval git submodule update --init --recursive " failed. Retrying, 2 of 3.

repo：https://github.com/wendyli-repos/wendyli-repos.github.io
已尝试过的debug：

themes/next 指向的commit 不存在https://github.com/next-theme/hexo-theme-next/tree/5927f1fe92537766c4c42e96fc89f7be1f5f759e
在本地themes/next里执行过 git pull 以便更新到最新版本。

问题所在：从themes/next 的 git log中发现，5927f1fe92537766c4c42e96fc89f7be1f5f759e是我的commit，因此无法在https://github.com/next-theme/hexo-theme-next/tree/ 中找到，因此返回404.

解决办法：在本地themes/next文件夹内执行一下2行git cmd，则可重置HEAD到https://github.com/next-theme/hexo-theme-next/ 的origin master 最新commit。问题解决！🎉
git fetch origin git reset --hard origin/master

在@ljcbaby 的debug下以上问题解决，谢谢！🤝

HanHuiOnLine · 2022-08-05T08:49:42Z

我觉得是有问题的，我按照正常的步骤去操作的，结果在hxo generate的时候各种报错



如果你也碰到上面的问题，说明在初始化的时候很多东西下载失败了
删除node_modules，再使用npm或者cnpm重新install，即可

stevenjoezhang · 2022-08-05T10:55:01Z

如果是用 pnpm 安装的，Hexo 可能找不到依赖

ouuan · 2022-08-05T14:02:41Z

关于 busuanzi 和 live2d 共同使用的问题，我找到了根本原因，写了篇博客: https://ouuan.moe/post/2022/08/busuanzi-and-live2d

duchengyao · 2023-12-26T08:34:20Z

请问我今天更新hexo博客next主题配置后，执行hexo g发现出现错误提示如下：
ERROR The upstream repository of theme NexT has been changed.
ERROR For more information: https://github.com/next-theme/hexo-theme-next
ERROR Documentation: https://theme-next.js.org
请问导致的原因是什么？我目前使用的是next7.7.0版本，并没有更新到新版，只是个人修改了主题配置，这个问题如何解决呢？

@linwhitehat

npm i theme-next/next-util

see https://s1nh.com/post/theme-next-warnning/ for detail

stevenjoezhang pinned this issue Apr 7, 2020

stevenjoezhang added the Discussion label May 7, 2020

kuretru mentioned this issue May 14, 2020

A fork or a new home for the theme? theme-next/hexo-theme-next#1508

Closed

3 tasks

aixiu mentioned this issue May 23, 2020

PJAX开启后，如何设置才能自动加载评分与addthis分享 theme-next/hexo-theme-next#1500

Closed

3 tasks

stevenjoezhang mentioned this issue Jun 23, 2020

本仓库与 theme-next/hexo-theme-next 的区别是什么？ #36

Closed

This was referenced Aug 2, 2020

本地搜索框被覆盖 theme-next/hexo-theme-next#914

Closed

NexT v8 Roadmap #3

Closed

sli1989 mentioned this issue Aug 27, 2020

Home Page is 404 now theme-next/hexo-theme-next#1492

Closed

3 tasks

stevenjoezhang mentioned this issue Sep 14, 2020

【HELP】 hexo generate '<' to '<' and '>' to '>' in index.html hexojs/hexo#4531

Closed

5 tasks

BladeCode mentioned this issue Nov 18, 2020

theme-next 组织是不是迁移到了 next-theme？ theme-next/hexo-theme-next#1581

Closed

MHuiG mentioned this issue Nov 27, 2020

希望增加对 Hexo NexT 主题的支持 walinejs/waline#20

Closed

stevenjoezhang mentioned this issue Dec 28, 2020

Mathjax2 not rendering until page refresh #167

Closed

3 tasks

stevenjoezhang mentioned this issue Jan 25, 2021

Why remove the valine comment in the latest version？ #188

Closed

ghost mentioned this issue Feb 1, 2021

fix(exturl): Return encrypted URL with title. #193

Merged

12 tasks

stevenjoezhang closed this as completed in #193 Feb 8, 2021

stevenjoezhang reopened this Feb 9, 2021

MHuiG mentioned this issue Apr 20, 2021

MiniValine 已放弃或终止对 hexo-theme-next 主题的支持 MHuiG/MiniValine#328

Closed

PaperStrike mentioned this issue Jul 14, 2021

Do not fix the deps version next-theme/utils#11

Closed

jiangtj mentioned this issue Jul 21, 2021

关于next6更新至next7后出现Template render error的问题 theme-next/hexo-theme-next#1403

Closed

3 tasks

BladeCode mentioned this issue Jul 24, 2021

force update next 1156721874/1156721874.github.io#7

Merged

noraj mentioned this issue Aug 6, 2021

next-theme fork and theme next future #340

Closed

3 tasks

ljcbaby mentioned this issue Aug 7, 2021

next-theme fork and theme next future theme-next/hexo-theme-next#1663

Closed

3 tasks

fish-404 mentioned this issue Jul 4, 2022

Upgrade NexT fish-404/fish-404.github.io#3

Closed

ljcbaby mentioned this issue Jul 20, 2022

两个 next-theme GitHub Repo 的区别 #546

Closed

3 tasks

ouuan mentioned this issue Jan 21, 2023

2023/01/01/Diary-2023-01/ Chiyuru/chiyuru.github.io#20

Open

richardmyu mentioned this issue Jan 19, 2024

Hexo 搭建博客问题 richardmyu/blog#17

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

【必读】更新说明及常见问题 #4

【必读】更新说明及常见问题 #4

stevenjoezhang commented Apr 7, 2020 •

edited

Loading

Early0v0 commented May 9, 2020

Early0v0 commented May 9, 2020

stevenjoezhang commented May 9, 2020 •

edited

Loading

Early0v0 commented May 12, 2020

stevenjoezhang commented May 12, 2020 •

edited

Loading

jiangtj commented May 13, 2020

KuGouGo commented May 14, 2020

sli1989 commented May 14, 2020

pplmx commented May 14, 2020

imzhangmengxin commented May 14, 2020

gapplef commented May 14, 2020

stevenjoezhang commented May 14, 2020

sli1989 commented May 20, 2020

aixiu commented May 20, 2020 •

edited

Loading

stevenjoezhang commented May 20, 2020 •

edited

Loading

aixiu commented May 20, 2020

9201314 commented Jun 29, 2020

linwhitehat commented Jul 20, 2020

stevenjoezhang commented Jul 20, 2020

linwhitehat commented Jul 20, 2020

stevenjoezhang commented Jul 20, 2020

linwhitehat commented Jul 20, 2020

bwcxyk commented Oct 15, 2020

stevenjoezhang commented Oct 16, 2020

ghost commented Feb 1, 2021 •

edited by ghost

Loading

TrumanDu commented Mar 15, 2021

AmosHuKe commented Jul 3, 2021

mianhu commented Jul 9, 2021

sandyzikun commented Dec 17, 2021

galaxy-dot commented Feb 18, 2022 •

edited

Loading

HanHuiOnLine commented Aug 5, 2022 •

edited

Loading

stevenjoezhang commented Aug 5, 2022

ouuan commented Aug 5, 2022

duchengyao commented Dec 26, 2023

【必读】更新说明及常见问题 #4

【必读】更新说明及常见问题 #4

Comments

stevenjoezhang commented Apr 7, 2020 • edited Loading

问题反馈方式

环境

操作系统

Hexo 与 NexT 兼容性

NexT 仓库

NexT 自定义

_config.next.yml 配置文件

v7.3.0 Custom Files 用法

NexT 插件

v7.4.2 Nunjucks 引擎

v7.6.0 auto_excerpt

v7.6.0 访问量统计

v7.7.2 升级 MathJax

v7.7.2 Dark Mode

v8.0.0-rc.1 自定义图标

v8.0.0-rc.5 动画效果

v8.0.0 CDN 设置

v8.1.0 移除 Valine

v8.10.0 Highlight.js 兼容性

可能导致 Hexo 或 NexT 出现问题的插件或服务

其它常见问题

Issue 和 Pull Request 规范

提交 Issue

关于 Bug

关于 Feature Request

关于 Pull Request

Early0v0 commented May 9, 2020

Early0v0 commented May 9, 2020

stevenjoezhang commented May 9, 2020 • edited Loading

Early0v0 commented May 12, 2020

stevenjoezhang commented May 12, 2020 • edited Loading

jiangtj commented May 13, 2020

KuGouGo commented May 14, 2020

sli1989 commented May 14, 2020

pplmx commented May 14, 2020

imzhangmengxin commented May 14, 2020

gapplef commented May 14, 2020

stevenjoezhang commented May 14, 2020

sli1989 commented May 20, 2020

aixiu commented May 20, 2020 • edited Loading

stevenjoezhang commented May 20, 2020 • edited Loading

aixiu commented May 20, 2020

9201314 commented Jun 29, 2020

linwhitehat commented Jul 20, 2020

stevenjoezhang commented Jul 20, 2020

linwhitehat commented Jul 20, 2020

stevenjoezhang commented Jul 20, 2020

linwhitehat commented Jul 20, 2020

bwcxyk commented Oct 15, 2020

stevenjoezhang commented Oct 16, 2020

ghost commented Feb 1, 2021 • edited by ghost Loading

TrumanDu commented Mar 15, 2021

AmosHuKe commented Jul 3, 2021

mianhu commented Jul 9, 2021

sandyzikun commented Dec 17, 2021

galaxy-dot commented Feb 18, 2022 • edited Loading

HanHuiOnLine commented Aug 5, 2022 • edited Loading

stevenjoezhang commented Aug 5, 2022

ouuan commented Aug 5, 2022

duchengyao commented Dec 26, 2023

stevenjoezhang commented Apr 7, 2020 •

edited

Loading

`_config.next.yml` 配置文件

v7.6.0 `auto_excerpt`

stevenjoezhang commented May 9, 2020 •

edited

Loading

stevenjoezhang commented May 12, 2020 •

edited

Loading

aixiu commented May 20, 2020 •

edited

Loading

stevenjoezhang commented May 20, 2020 •

edited

Loading

ghost commented Feb 1, 2021 •

edited by ghost

Loading

galaxy-dot commented Feb 18, 2022 •

edited

Loading

HanHuiOnLine commented Aug 5, 2022 •

edited

Loading