猫猫按钮 / Hiiro按钮 / Hiiro Button
https://hiiro.club/
项目地址:相关链接:
参与完善本项目
-
您可以在Issues提出您的建议。
- 若是请求添加新语音,请使用指定的issues模板,不熟悉github的用法也可以到B站和我联系
-
如果您可以进行开发,那么请Fork本项目进行修改,完成修改后在本项目中发起一个Pull Request,详细说明请查看以下条目
Pull Request请提交至dev分支
添加或修改音频/完善翻译
音频文件推荐使用mp3格式,请先音量标准化,然后放入public/voices/
目录
所有的分类和音频信息都存储在setting/translate
目录的json
文件中,添加或修改音频信息、完善翻译,你需要修改对应文件中的内容
locales.json
和category.json
分别为UI界面翻译和分类信息,请不要修改文件名,语音信息可以使用除此外的任意名称,可使用多个json
文件方便管理语音
category.json
结构示例如下:
[
{
// 分类命名
"name": "名言",
"translate": {
// 分类中文翻译
"zh-CN": "猫猫名言~",
// 分类英文翻译
"en-US": "witticism~"
}
}
]
语音文件结构示例如下:
[
{
// 语音命名
"name": "baba",
// 语音文件名
"path": "baba.mp3",
"translate": {
// 语音中文翻译
"zh-CN": "米娜我是你爸爸",
// 语音英语翻译
"en-US": "I'm your Baba"
},
// 语音所属分类(对应category的name)
"category": "名言",
// 以下属性为可选
// 添加时间
"date": "2020-11-11",
// 语音出处
"mark": {
"title": "【Hiiro】读评论 学中文 DD们的评论都是什么东西啊?",
"time": "0:01~0:03",
"url": "https://www.bilibili.com/video/BV1ET4y177A8"
}
}
]
添加usePicture
字段可以添加鼠标悬浮时显示的图片(请放到public/voices/img
目录)
参与网页开发
本项目使用Vue3.0
进行开发,使用yarn
进行包管理
要部署本地开发环境,请先安装较新版的Node
- Fork并Clone代码到本地
- 进入代码目录,运行
yarn
以安装依赖项目 - 开启本地开发服务器,运行
yarn serve
,这将会在localhost:8080
启动,在代码修改过程中,本地开发服务器可以即时反映修改的结果,并自动检查json
中相关文件的使用情况 - 要编译可供部署的文件,请运行
yarn build
,这将会在dist
目录下生成可以直接部署到静态网站托管(GitHub Pages等)或服务器的文件
使用模板
若想使用网站模板开发新的语音按钮,可以选择以下两种方式:
- 修改
public
和setting
目录下的文件以及package.json
- 若使用该项目为模板进行开发,请务必修改或删除
setting/setting.json
里用于访问统计的GA_ID
- 若使用该项目为模板进行开发,请务必修改或删除
- 使用voices-button-cli命令行工具(开发中)
计划中功能
表情包搜索直播通知动态展示
LICENSE
若使用了本项目为范本开发项目或使用了项目代码请在明显位置声明原作者(https://github.com/blacktunes) 以及本仓库(https://github.com/blacktunes/hiiro-button).