模板: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