# FAQ

TIP

  • dev 代表只和开发有关。

有问题和建议欢迎提 Issue(opens new window)

你也可以加入 QQ 群(opens new window) (389401003)进行反馈与讨论。

如果是通用的问题(如 BUG 反馈,新功能建议),最好在 Issue 中进行反馈,以便其他朋友参与讨论,减少重复。


# 自查通用问题解决方案

检查文件或仓库命名是否错误。

检查 Hexo 工作目录下 _config.ymlurl 是否设置正确。(此部分为 Hexo 初始化时自动生成)

# If your site is put in a subdirectory
# set url as 'https://yoursite.com/child' and root as '/child/'
url: https://www.yunyoujun.cn
root: /

检查是否在 yun.yml 文件中进行主题配置,且已经保存。 检查是否已经执行如下几步:

  • hexo clean:清除本地缓存
  • hexo g:生成新的静态文件
  • hexo s:本地查看效果(如果正常,使用 hexo d 重新部署)

检查是否已强制刷新本地浏览器缓存(Windows: Ctrl + F5,Mac: Shift + Cmd + R)。

检查是否为最新版本。

检查是否因为 CDN 缓存造成的问题,(关闭 cdn.pre)。

如果仍然存在问题,你可以将你的项目代码作为 hexo 分支推送到 GitHub 上。

与远程仓库建立关联(opens new window)

使用 GitHub 源文件地址到群(389401003)内提问,或发起 ISSUE(opens new window)

# hexo server 文章只渲染部分内容 dev

开发主题的过程中,发现长篇文章只能渲染出一部分,后半部分无法正常显示。 一开始还以为是 hexo-renderer-pug 的问题,折腾了一天,兜兜转转,最后才发现似乎是开发时 hexo-browsersync 的问题。

相关 Issue :Problem with long pages(opens new window)

# 临时解决方案

在根目录的 _config.yml 中设置

server:
  compress: true

https://github.com/hexojs/hexo-browsersync/issues/15#issuecomment-573492492(opens new window)

# 标签与分类页面不显示?

标签与分类页面需要参考 页面配置(opens new window) 安装对应插件并自行生成页面。