模板:IPA soundbox/doc

本模板用于生成播放音频文件的框，并有一个额外的功能来链接到语言文件。还可以自定义提示错误的文字。

• {{IPA soundbox|ə}} →
  [[Template:IPAsym|ə]]

  [[File:Template:IPA audio filename/main1| center| 250px]]
• {{IPA soundbox||χ|Voiceless_uvular_fricative.ogg}} →
  [[Template:IPAsym|χ]]

  [[File:Template:IPA audio filename/main1| center| 250px]]

用法

其用法分成三步：
第一、选择音频文件

- 输入国际音标符号：

XML Example

ipa symbol=p

→

[[Template:IPAsym|p]]

[[File:Template:IPA audio filename/main1| center| 250px]]

- 输入音频文件名：

XML Example

soundfile=bilabial click.ogg

→

[[Template:IPAsym|ʘ]]

[[File:Template:IPA audio filename/main1| center| 250px]]

第二、测试文件是否存在
这样可以避免红字和不必要的重复测试

第三、在页面生成播放器，使用 [[File:soundfile]]。在此一些可选的选项如尺寸也可以使用，并能生成音频文件的播放器。

• {{IPA soundbox|p|size=60px}} →
• [[Template:IPAsym|p]]

  [[File:Template:IPA audio filename/main1| center| 60px]]

全部参数：

{{IPA soundbox
<!-- GENERAL -->
| ipa symbol    =
| style         =
| errortext     =
<!-- ABOVE -->
| show box above=
| showsymbol    =
| line-height   =
<!-- PLAYER -->
| soundfile     =
| checkexist    =
| showicon      =
| width         =
| size          =
}}

可能的错误：

1. 国际音标符号不在列表中

2. 文件不存在

发生错误的时候就不会显示播放按钮

参见

• {{IPA audio filename}}
• {{infobox IPA}}（内联本模板）
• {{IPA vowels audio}}（内联本模板）
• {{IPA pulmonics audio}}（内联本模板）
• Wikipedia:Extended image syntax