备注：
记录对使用Halo的时候出现的问题和解决方式。

配置环境：

  1. Halo2.0以上版本

  2. Hao主题

  3. 实用插件（各种使用插件会备注在下面）

  4. 腾讯云服务器

一、Halo问题合集

1、Halo使用过程中存在的问题和解决方案

（1）Halo的更新方式都有哪些？

（2）Halo文章出现点击当前文章跳转出另一篇文章的问题

问题解决：
需通过修改文章别名的方式修改正常了，文章别名出现了相同的会出现文章选择跳转到另一个别名相同的文章页面中。需要特别注意别名问题。

2、Halo定制化需求解决方案

3、Halo的Bug问题的解决方案

二、Hao主题问题合集

1、Hao主题使用过程中存在的问题和解决方案

（1）图标引用和导入问题


2、Hao主题定制化需求解决方案

（1）右下角音乐插件30s播放问题

（2）右下角音乐插件开启默认播放设置

问题解决：

  1. 修改配置文件settings 的配置模块（路径：）【在settings中，确保音乐播放器的 autoplay 设置为 true，并且默认启用音乐。】

    music:
    enabled: true # 启用音乐
    autoplay: true # 默认自动播放
    server: "netease" # 音乐服务，选择合适的服务
    i "xxxxxx" # 歌单的ID
    api: "https://api.i-meto.com/meting/api?server=:server&type=:type&id=:id&r=:r" # 音乐API

  2. 在前端模版中启动自动播放

  3. 确保配置生效

  4. 根据你使用的 Halo 版本，配置修改后可能需要重新加载或者刷新页面才能生效。需要在云服务器中重启Halo的容器，并且清除浏览器缓存或者使用另一个浏览器打开测试，不然可能出现样式依旧保持原样的情况。

  5. 处理自动播放限制（以上情况都测试过后没有效果的话可以试试）

    如果浏览器因为自动播放限制导致音乐无法播放，可以尝试添加 muted=“true” 来绕过限制：

    <meting-js th:id="${theme.config.tool.nav_music.id}"
           th:server="${theme.config.tool.nav_music.server}"
           type="playlist"
           mutex="true"
           preload="none"
           theme="var(--heo-main)"
           data-lrctype="0"
           order="random"
           autoplay="true"
           muted="true">
</meting-js>