本文由Sciuridae翻译。
当前不接受新的提交。
吟游诗人是专门为完成任务或掉落物品之类的事件设计自定义交互音效的Habitica贡献者。
音效页面记录了Habitica上可以使用的音效主题。想要创作新主题的吟游诗人应阅读此页面以了解需要制作何种音效。以下信息将帮助你创作你的主题。
如果你对创作过程有疑问或者不确定设想的主题是否合适,可以询问Aspiring Legends: Contributing to Habitica公会中的成员。
音频文件格式[]
你创建的音频文件必须拥有ogg和mp3两种版本以在所有浏览器上获得支持(例如,对于一个奖励音效,你应同时创建Reward.mp3
及Reward.ogg
)。
有各种可以转换音频格式的工具。如果你创建的音频最初是*.wav文件,那你或许会想要使用oggenc和lame命令行工具:
# convert wav to ogg: oggenc -q 3 filename.wav
# convert wav to mp3: lame -V 5 filename.wav
音频文件名[]
正确命名你的音频文件很重要。
- 如果你正在创作一项新的主题,那就浏览现有主题的文件名,用完全一致的名字命名你的文件。
- 如果你正在创作那项主题中并不存在的新的音效,那就尝试选择与那些已使用过的文件名样式类似的名称。请注意,新的音效可能不会投入使用——请先在Aspiring Legends: contributing to Habitica公会中咨询情况。
将你的文件添加至“habitica”存储库[]
制作好音效文件后,你需要将它们上传到GitHub上的habitica存储库,并多次修改Habitica站点上的文件。本节将描述如何操作。
如果你不想亲自操作,铁匠(开发者)可以帮你!把你的音效文件压缩成zip后上传至互联网任一位置,然后去Aspiring Blacksmiths (Coding for Habitica)公会。在公会里说明你已经制作了新的音效主题,并告诉他们主题的名称(例如,‘Frankie的主题(Frankie's Theme)’、‘英勇战士主题(Brave Warrior Theme)’),给他们提供zip文件的链接。你还要告诉他们,要阅读此wiki页面来获取如何继续操作的信息,因为他们可能不知道有此页面。如果几天后你还没有收到回复就再询问一遍。可能要过几天开发者才会有空,但总会有人帮你的!
给GitHub添加音效主题的吟游诗人或铁匠应遵循以下信息。
- 阅读铁匠指南来获取有关Habitica编码的信息。
- 按照在本地建立Habitica中的说明在本地安装Habitica。
- 按照使用本地安装以修改Habitica网站及API中的所有说明以及下列步骤进行更改以执行音频文件。这些步骤将为你提供针对音效主题的附加信息。
- 若要向现有主题中添加新的音效,请将音频文件复制到新分支的website/static/audio/下合适的子目录中。
- 若要添加新主题:
- 在website/static/audio/下创建一个新的子目录(例如,business),将音频文件复制到此处。子目录名称中不要出现空格或标点。
- 编辑website/common/locales/en/generic.json,仿照针对现有主题所做的工作添加类似的文本(在文件中搜索audioTheme_)。你所添加文本的键名必须是“audioTheme_xyz”,“xyz”要与你在website/static/audio/下创建的目录名称完全一致。
- 在编辑器中打开website/common/script/content/index.js,在其中搜索现有主题的名称(例如,‘danielTheBard’)。你将会找到包含主题列表的一行信息。将新主题添加至此行中,使用与现有主题完全一致的句法。你添加的文本必须与你创建的目录名称完全一致。
- 在本地站点手动测试更改时,你需要测试新的音频菜单项以及所有音频。没有必要为这类更改创建自动化测试。
- 创建pull request时,如果你并非音频文件作者,那你需要在pull request中注明作者。若有可能,也请列入他们的Habitica昵称和用户ID。
申请贡献者等级[]
你真好运!吟游诗人及帮助他们的铁匠不需要任何手续来申请贡献者等级。管理员将在审查及接受提交时酌情授予贡献者等级。吟游诗人和铁匠都会受到表彰。
合作项目[]
海盗福利[]
详情请询Pirate Foley guild。
不知道如何使用音频编辑软件?我们可以免费帮助你学习!