抱歉,您的浏览器无法访问本站
本页面需要浏览器支持(启用)JavaScript
了解详情 >

Volantis

中文创作者社区

通常来说,一个全新的工程全部使用默认配置是正常没有故障的。如果无法使用或者效果与示例有较大区别,可以使用 Hexo 官方提供的用于单元测试的博客应用本主题查看样式是否正常,对比 _config.yml 文件排查问题。

Hexo 官方的单元测试项目: https://github.com/hexojs/hexo-theme-unit-test


向开发者反馈问题

如何更新主题

使用主题的时候,尽量 fork 主题到自己的 GitHub,然后进行修改并使用。这样做的好处是:当主题进行重要更新的时候可以根据需要拉取合并代码,使自己 DIY 的主题能够通过更新获取 BUG 修复或者新特性。

如果不懂请自行搜索关键词:fork 更新

实用小技巧

所有需要写在主题配置文件中的配置都可以写在站点配置文件的 theme_config: 中,在 Hexo 5.0 后,还可以写在 _config.volantis.yml 文件中,详见 Hexo 官方文档:

也可以直接查看本站源码中站点配置文件的写法:_config.volantis.yml

无法成功运行本地预览

  • 可能是没有安装依赖,请按照「开始」页面中的步骤进行安装,并安装所需依赖。
  • 如果开启了某些第三方服务,请查看文档中是否要求安装插件。
  • 如果报错信息有 lastIndex,你可以尝试把博客根目录配置文件中找到 highlight,并将 auto_detect 设置为 false

主题配置修改没有生效

请确认文档中要求修改的是博客主目录的配置文件 blog/_config.yml 还是主题的配置文件 blog/_config.volantis.yml

主题样式修改没有生效

如果主题配置文件中开启了 cdn 服务,那么修改本地的样式是不会生效的,需要关闭 cdn 服务。

修改什么都没有生效

需要 hexo clean 然后重新 hexo s

如果安装了「相关文章推荐」插件后,每次修改 md 文件后都需要重新 hexo s

关掉 CDN 之后样式错乱

  • 请前往文档「开始」页面,检查是否安装了必要的依赖包。

搜索无法使用

  • 请前往文档「开始」页面,检查是否安装了必要的依赖包。
  • 检查根目录配置文件是否有 search 字段冲突。
  • 如果以上两步都无法找到问题,请下载示例源码进行对比。

搜索结果链接不正确

请检查根目录配置文件中的链接是否正确,如:

blog/_config.yml
1
2
url: https://xaoxuu.com
root: /



教程与指南

Hexo 官方文档 | Valine 官方文档

请一定要阅读官方文档!

image

可供交流的渠道

解决问题

渠道方式用途
Issues@volantis-x/hexo-theme-volantis和开发者沟通的唯一渠道,用于跟进和解决问题

请不要发送邮件

开源项目的开发者很反感别人不通过正确的途径如 Issues 而是通过私人邮件询问开源项目问题,所以一般不会回复此类邮件。

交流

渠道方式用途
论坛@volantis-x/discussions慢,相对正式,方便检索,可以给其他用户参考
QQ群1146399464 (验证码:vlts-2021)非正式,即时通讯,易于斗图;不利于给其他用户参考

佛系互动

渠道方式用途
评论区留言可以测试、灌水、推广自己的博客。

评论