【必读】更新说明及常见问题 about hexo-theme-next

[stevenjoezhang]

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

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

[stevenjoezhang]

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

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

[wangjiezhe]

busuanzi 和 live2d 的冲突问题，我通过在 source/_data/styles.styl 中添加

#busuanzi_container_site_uv, #busuanzi_container_site_pv, #busuanzi_container_page_pv {
  display: inline !important;
}

解决了。

[Early0v0]

请问：

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

[sli1989]

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

[stevenjoezhang]

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]

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

[9201314]

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

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]

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

[AmosHuKe]

有个很蠢的办法可以解决：不蒜子和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>

[Early0v0]

在 “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]

1. 简单来说，问题就是 theme-next 团队的 owner 始终拒绝向其它任何团队成员提供足够的权限，且 owner 本人自去年 10 月起已连续半年不在线，导致其它活跃的团队成员无法管理仓库，也无法邀请新的成员。
   由于对 theme-next 团队的未来不抱有期望，我作为 theme-next 的主要贡献者，自 4 月起停止为旧的仓库贡献代码，并创建了新的组织，以确保维护工作正常进行。
2. 只要能够收到足够多的 Bugfix / Feature Request，每月更新肯定不是问题。
3. 目前已经发布的版本在这里： 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，所以我无法合并两个版本。

[jiangtj]

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

哇哦

[KuGouGo]

支持一波

[sli1989]

支持一波

[pplmx]

资瓷

[imzhangmengxin]

资瓷

[gapplef]

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

[stevenjoezhang]

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

[aixiu]

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

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

[linwhitehat]

请问我今天更新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]

@linwhitehat 试试执行 hexo g --silent

[linwhitehat]

@linwhitehat 试试执行 hexo g --silent

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

[stevenjoezhang]

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

[linwhitehat]

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

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

[bwcxyk]

我下载新版尝试运行失败

[stevenjoezhang]

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

[mianhu]

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

[sandyzikun]

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

不确定能否在这里提问，尝试了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：

1. themes/next 指向的commit 不存在https://github.com/next-theme/hexo-theme-next/tree/5927f1fe92537766c4c42e96fc89f7be1f5f759e
2. 在本地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]

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



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

[stevenjoezhang]

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

[ouuan]

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

[duchengyao]

请问我今天更新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