MENU

添加自定义表情 - Mirages 帮助文档

• March 11, 2019 • Read: 2971 • 教程

该页面为在评论和文章的表情框中添加自定义表情的内容。

该功能在 Mirages 1.7.8.DEV6 及以上版本可用

准备并上传表情文件

首先,你需要准备要添加的表情文件,对于表情文件,有如下要求和建议:

  • 同一种表情中,所有后缀名必须相同
  • 鉴于文件名编码的不确定性,文件名部分建议使用英文
  • 有能力的话,建议同时准备一份 2x 的表情图像,用于高分屏展示

表情文件准备好后,上传到 主题目录/usr/biaoqing/目录下

修改 OwO.json 文件

修改 主题目录/usr/biaoqing/OwO.json文件,如果没有,从主题目录/js/OwO.json复制一份即可。

注意,不要修改主题目录/js/OwO.json 文件

泡泡阿鲁颜文字的上一行,按照如下格式添加代码:

  "表情名称": {
    "type": "usr",
    "name": "dir_name",
    "suffix": ".png",
    "retinaSuffix": ".png",
    "imgClass": "small",
    "container": [
      {
        "icon": "hematemesis",
        "text": "吐血"
      },
      {
        "icon": "1huaji",
        "text": "滑稽"
      },
      {
        "icon": "amazing",
        "text": "吃惊"
      }
    ]
  },

参数说明如下:

字段名称使用说明
表情名称即在表情面板显示的名称,一般为中文名称
type固定值,永远填 usr
name表情英文名,和上传的文件夹的名称一致
suffix文件名后缀,例如 .png
retinaSuffix高分屏下使用的文件名后缀,例如 _2x.png,如果未准备 @2x 的图片,则和 suffix 字段保持一致
imgClass表情 class,内置的有:smallmiddlemediumlarge,对应不同的表情大小。你也可以自己写 class 来精确的控制表情的展示效果
container表情列表,icon 即为表情的文件名(不包含后缀),text 为表情的描述

其中,container部分可以进行简化,不填写 text,简化后的示例:

    "container": [
        "hematemesis",
        "1huaji",
        "amazing"
    ]

其余部分保持一致。

例如上述的 icon为 amazing的表情,在普通屏幕上对应的图片为 主题目录/usr/biaoqing/dir_name/amazing.png,在高分屏下(假如retinaSuffix字段值为 _2x.png)对应的图片为主题目录/usr/biaoqing/dir_name/amazing_2x.png

检查是否可用

打开评论和文章的表情框,检查自己的表情是否正确加载。

Archives QR Code Tip
QR Code for this page
Tipping QR Code