Valine-Magic 项目常见问题解决方案

Valine-Magic 项目常见问题解决方案

Valine-Magic ✨Valine/MiniValine/Waline（已兼容新版写法，直接使用MiniValine同样的链接即可）自定义表情列表，为你的表情库“喜加亿” 项目地址: https://gitcode.com/gh_mirrors/va/Valine-Magic

Valine-Magic 是一个开源项目，它为 Valine、MiniValine 和 Waline 提供了自定义表情列表。该项目主要使用 JavaScript 编写。

新手在使用这个项目时需要特别注意的三个问题及解决步骤

问题一：如何正确引入表情包

问题描述： 新手在使用 Valine-Magic 时，不知道如何正确地引入表情包。

解决步骤：

1. 确保你的 Valine 配置中已经设置了正确的 CDN 链接。可以在项目的 README 文件中找到推荐的 CDN 链接。
2. 将 CDN 链接复制到 Valine 的 emotionUrl 配置项中。

   new Valine({
     el: '#comment',
     appId: 'your_app_id',
     appKey: 'your_key',
     placeholder: '留下你的评论~',
     emotionUrl: [
       'https://valine-emoji.bili33.top/alu',
       'https://valine-emoji.bili33.top/bilibiliHotKey'
     ]
   });
   

3. 确保表情链接的格式正确，每个表情分类的链接需要按照项目提供的格式进行配置。

问题二：表情无法显示或加载

问题描述： 用户在页面上看不到表情，或者表情加载失败。

解决步骤：

1. 检查网络连接，确保 CDN 链接可以正常访问。
2. 检查 Valine 配置中的 emotionUrl 是否正确无误。
3. 确保在 Valine 初始化之前，页面的 HTML 结构已经加载完毕。

问题三：如何添加自定义表情

问题描述： 用户想要添加自己的表情包，但不知道如何操作。

解决步骤：

1. 准备好你的表情图片，并上传到可以访问的网络位置。
2. 在 Valine 配置中添加新的表情链接。

   new Valine({
     el: '#comment',
     appId: 'your_id',
     appKey: 'your_key',
     placeholder: '留下你的评论~',
     emotionUrl: [
       'https://your-cdn-link/your-emoji-image.png'
     ]
   });
   

3. 如果你想要添加多个分类的表情，请确保在每个分类的最后一个表情后面加上 .，以便 Valine 能够正确识别。

以上是 Valine-Magic 项目新手可能会遇到的三个常见问题及其解决方案。在使用过程中遇到其他问题，可以查看项目文档或通过 GitHub 的 Issues 功能寻求帮助。

Valine-Magic ✨Valine/MiniValine/Waline（已兼容新版写法，直接使用MiniValine同样的链接即可）自定义表情列表，为你的表情库“喜加亿” 项目地址: https://gitcode.com/gh_mirrors/va/Valine-Magic