编辑“︁Template:IPA audio filename/doc”︁

{{Documentation subpage}}
<!-- Categories and interwikis go at the bottom of this page. -->
本模板生成IPA录音的文件名。这取决于所输入的符号。例如：<code>{{tlx|IPA audio filename|m}}</code> → <code>{{IPA audio filename|m}}</code>。本模板还可以输入非默认的音频文件名，因此可以用非默认的音频文件播放。另外本模板还可以检测是否存在对应的文件，错误提示可替换成文本或者空白。

==用法==
全部参数如下：
<pre>
{{IPA audio filename
| ipa symbol =
| soundfile  =
| checkexist =
| errortext  =
}}</pre>
:'''''匿名参数1''或''ipa symbol=''''' 这个参数可以输入国际音标符号。这个符号可以对应相应的音频文件名（使用 {{tl|IPA symbol}} 中的列表）。若不用此参数应用参数 <code>soundfile=</code>。
::<code>{{tlx|IPA audio filename|ʒ}}</code> &rarr; <code>{{IPA audio filename|ʒ}}</code>
:'''''soundfile=''''（可选，默认为none）本参数允许输入任意文件名。可以替换参数1生成的结果。这参数可用于输入 {{tl|IPA symbol}} 里面不存在的文件名。
::<code>{{tlx|IPA audio filename|ʒ|soundfile{{=}}Accordian chords-01.ogg}}</code> &rarr; <code>{{IPA audio filename|ʒ|soundfile=Accordian chords-01.ogg}}</code>

:'''''checkexist='''''（可选，默认为no）输入 yes 或 no 即可。输入 yes 就能测试文件是否存在，若不存在就会出错误提示。
::<code>{{tlx|IPA audio filename|n̪|checkexist{{=}}yes}}</code> &rarr; <code><span class="error">文件“dental nasal.ogg”不存在</span></code>
:'''''errortext='''''（可选，默认为none）提示错误的文本在此可以替换成任何提示文字。若没有错误就不会使用此参数。错误提示可以留空，像是 {{tlx|IPA audio filename|m|errortext{{=}}}}。
::<code>{{tlx|IPA audio filename|abc|errortext{{=}}文件名有问题}}</code> &rarr; <code>文件名有问题</code>
<!--
===Permanent altered from default name===
Some IPA symbols have soundfiles available in Wikipedia that are not the default name. These alternate names can be entered in this template, and will show up in the output.

Subtemplate {{tlx|IPA audio filename/filename}} contains the list of alternate names. Example:
* kʼ is named <code>{{IPA symbol|kʼ}}</code>, so this would yield default name: <code>{{IPA symbol|kʼ}}.ogg</code>
The filename however differs from that default name. The list in {{tlx|IPA audio filename/filename}} produces that different name:
* {{tlx|IPA audio filename|kʼ}} → {{IPA audio filename|kʼ}}
Currently, the following non-default names are in the list:<br><code>
:velar approximant = voiced velar approximant.ogg ( ɰ )
:voiceless labio-velar approximant = voiceless labio-velar fricative.ogg ( ʍ )
:labio-velar approximant = voiced labio-velar approximant.ogg ( w )
:alveolar ejective = alveolar ejective plosive.ogg ( tʼ )
:uvular ejective = uvular ejective plosive.ogg ( qʼ )
:bilabial ejective = bilabial ejective plosive.ogg ( pʼ )
:velar ejective = velar ejective plosive.ogg ( kʼ )
:tenuis bilabial click = clic bilabial sourd.ogg ( ʘ )
:tenuis dental click = dental click.ogg ( ǀ )
:tenuis alveolar click = postalveolar click.ogg ( ǃ )
:tenuis palatal click = palatoalveolar click.ogg ( ǂ )
:tenuis alveolar lateral click = alveolar lateral click.ogg ( ǁ )
:sj-sound = voiceless dorso-palatal velar fricative.ogg ( ɧ )
:voiceless retroflex stop = voiceless retroflex stop.oga ( ʈ )
:voiced retroflex stop = voiced retroflex stop.oga ( ɖ )
:voiceless palatal stop = voiceless palatal plosive.ogg ( c )
:voiced palatal stop = voiced palatal plosive.ogg ( ɟ )
:voiceless uvular stop = voiceless uvular plosive.ogg ( q )
:voiced uvular stop = voiced uvular stop.oga ( ɢ )
:voiceless dental sibilant affricate = voiceless dental sibilant affricate.oga ( t̪s̪ )
:voiced dental sibilant affricate = voiced dental sibilant affricate.oga ( d̪z̪ )
:voiceless alveolar sibilant affricate = voiceless alveolar sibilant affricate.oga ( ts )
:voiced alveolar sibilant affricate = voiced alveolar sibilant affricate.oga ( dz )
:labial-velar nasal = labial-velar nasal stop.ogg ( ŋm )
:near-open central vowel = near-open central unrounded vowel.ogg ( ɐ )
:near-close near-back vowel = near-close near-back rounded vowel.ogg ( ʊ )
:r-colored vowel = regular and r-colored vowels.ogg ( ɚ )
</code>
-->
===可能存在的错误===
三种出错的情况包括：
* 没有输入国际音标符号：
::{{tlx|IPA audio filename|}} &rarr; <span class="error">{{IPA audio filename|}}</span>
* 国际音标符号在 {{tlx|IPA symbol}} 里面不存在：
::{{tlx|IPA audio filename|abc}} &rarr; <span class="error">{{IPA audio filename|abc}}</span>
* Checkexist=yes 已输入，而且文件名不存在：
::{{tlx|IPA audio filename|ⱱ̟|checkexist{{=}}yes}} &rarr; <span class="error">{{IPA audio filename|ⱱ̟|checkexist=yes}}</span>

这些错误的输出可以用 <code>errortext=</code> 替换。这个参数可以为空白。这只对输出有影响，而不是替换已经出现的错误。
<!--
===Technical background===
* The template uses nested sub-templates to prevent re-calculation of repeated data. e.g. the name from {{tlx|IPA symbol}} is calculated only once, and then passed through to the next subtemplate in the nest. This is more important for the check on existence <nowiki>{{#ifexist:}}</nowiki>, which is "expensive" and should be performed only once. The nesting has three levels: {{tlx|IPA audio filename}} calls {{tlx|IPA audio filename/main1}} calls {{tlx|IPA audio filename/main2}}.
* Error texts are passed through unaltered. At the end, in [[:template:IPA audio filename/main2|<code>/main2</code>]], any error is enveloped with the errortext (if provided).
* Check existence is performed only when the filename is not an error in itself.
-->
====问题====
* Todo: 本模板须要输入|ipa symbol=...替换当前匿名参数1。

使用的子模板
* {{tlx|IPA audio filename/main1}}
* {{tlx|IPA audio filename/main2}}
* {{tlx|IPA audio filename/filename}}（在此可输入非默认文件名）
* {{tlx|IPA audio filename/checkexist}}

===参见===
* {{tlx|IPA symbol}}包括了国际音标符号及名称的列表
* {{tlx|IPA audio filename/filename}}（在此可输入非默认文件名）
* [[:Category:含有不存在的国际音标音频文件的国际音标页面]]，用于追踪的分类
{{IPA templates}}
<includeonly>
<!-- Categories and interwikis go here: -->

[[Category:IPA音频模板]]
</includeonly>