该页面为在评论和文章的表情框中添加自定义表情的内容。
该功能在 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,内置的有:small 、middle 、medium 、large ,对应不同的表情大小。你也可以自己写 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
检查是否可用
打开评论和文章的表情框,检查自己的表情是否正确加载。