មើលកូដរបស់ ទំព័រគំរូ:IPAlink/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
{{SpecialChars}}
The template {{tlb|IPAlink}}automatically [[wikilink]] an IPA symbol to the respective sound article. IPAlink displays the bare IPA <br/>symbol. Showing IPA defined brackets like // is an input option.

{{tlb|IPAalink}}, {{tlb|IPAblink}} and {{tlb|IPAslink}} are earlier versions with predefined angular <>, square [] or slash // brackets. The conversion table is not defined in this template, but inherited from {{tl|IPAsym}}.

=== Usage ===
* '''First parameter''' or '''<code>ipa symbol=</code>''' (required): Any IPA symbol, or its IPA number.
* {{tlx|IPAlink|m}} &rarr; {{IPAlink|m}}
* {{tlx|IPAlink|ɡb}} &rarr; {{IPAlink|ɡb}}
* {{tlx|IPAlink|301}} &rarr; {{IPAlink|301}}

;Label
* '''<code>label=</code>''', or '''second parameter''': changes the label of the wikilink. 
::When set to blank, <code>label=|</code>, no label is showsn and the IPA symbol name is shown. (Note: '''<code>showsymbol=</code>''' does the same, but is deprecated)
* {{tlx|IPAlink|m<nowiki>|label=Any text</nowiki>}} &rarr; {{IPAlink|m|label=Any text}}
* {{tlx|IPAlink|m<nowiki>|showsymbol=Any text</nowiki>}} &rarr; {{IPAlink|m|showsymbol=Any text}}
* {{tlx|IPAlink|m<nowiki>|Any text</nowiki>}} &rarr; {{IPAlink|m|Any text}}
* {{tlx|IPAlink|ɡb<nowiki>|label=</nowiki>}} &rarr; {{IPAlink|ɡb|label=}}

;Brackets
* '''<code>bracket=</code>''', or '''third parameter''': set IPA bracket. Options are: <code>/ [ < (none)</code>. Default is none.
* {{tlx|IPAlink|m<nowiki>||<</nowiki>}} &rarr; {{IPAlink|m||<}}
* {{tlx|IPAlink|301<nowiki>||<</nowiki>}} &rarr; {{IPAlink|301||<}}
* {{tlx|IPAlink|m<nowiki>||[</nowiki>}} &rarr; {{IPAlink|m||[}}
* {{tlx|IPAlink|ɡb<nowiki>||[</nowiki>}} &rarr; {{IPAlink|ɡb||[}}
* {{tlx|IPAlink|ɡb<nowiki>||/</nowiki>}} &rarr; {{IPAlink|ɡb||/}}

;Error situation
If the IPA symbol is not defined in the IPAsym table, then an error message is returned.
:<tt><nowiki>{{IPAlink|pʰɪk}}</nowiki></tt> &rarr; {{IPAlink|pʰɪk}}

The latter is normally more an example of accidental misuse than intentional use, or it could be a sign that a symbol is missing from the {{tl|IPAsym}} table.

;Option "showsymbol" deprecated (use ''label='' or 2nd unnamed parameter, preferred)
The template can take the extra input like "showsymbol=A", and then ''show'' that  symbol, while ''linking'' to the appropriate article. The symbol to be shown can also be the ''second, unnamed'' parameter.
:<tt><nowiki>{{IPAlink|m|showsymbol=Anytext}}</nowiki></tt> &rarr; {{IPAlink|m|showsymbol=Anytext}}
:<tt><nowiki>{{IPAlink|ɽ͡r|showsymbol=*}}</nowiki></tt> &rarr; {{IPAlink|ɽ͡r|showsymbol=*}}

==Option name==
* {{tlx|IPAlink|m<nowiki>|/|name=yes</nowiki>}} &rarr; {{IPAlink|m|/|name=yes}} 

==Full parameter list==
In the short form:
<pre>
{{IPAlink
|
|
|
| name      =
| errortext =
| showsymbol=
}}
</pre>
Equally, the longer including optional names:
<pre>
{{IPAlink
| ipa symbol= <!-- or 1st unnamed parameter-->
| label     = <!-- or 2nd unnnamed paramter -->
| bracket   = <!-- or 3rd unnamed parameter -->
| name      = <!-- yes/no -->
| errortext =
| showsymbol= <!-- deprecated, use label= ==>
}}
</pre>
=== See also ===
* {{tl|IPAlink}} – Creates an article link
* {{tl|IPAalink}} – Creates a link in angle brackets: "‹›", for showing the IPA symbol, while linking to the named article. 
* {{tl|IPAblink}} – Creates a link in IPA brackets: "[]"
* {{tl|IPAslink}} – Creates a link in IPA slashes: "//"
{{IPA templates}}

<includeonly><!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:IPA templates|IPA symbol]]
</includeonly>