Дидани манбаъи Шаблон:Infobox IPA/doc

{{documentation subpage}}
==Usage==
This template can be used to add an infobox for a ''phonetic sound''. 

This infobox can be used to describe a phonetic sound, both by its name and its IPA symbol. Additional information can be added, like the X-SAMPA letters and a graphic image file. 

In general, the descriptive name corresponds with the article name. The infobox is then placed on that article page.

==Parameters==
===Basic parameters===
Only a few parameters are required to produce a useful infobox. The '''above header''' can be set, and up to four '''IPA symbols''' can be shown:

For common IPA symbols, the '''[[IPA number]]''' defines the article name and the default soundfile name. '''Decimals''' are decimal character references, also known as "Entity", to define the symbol in HTML. The template tries to find all known information with these two numbers.
{{Infobox IPA
| ipa number  = 149
| decimal1    = 622
}}
<pre>
{{Infobox IPA
| ipa number  = 149
| decimal1    = 622
}}</pre>
{{clear}}

Some more basic parameters:
{{Infobox IPA
| above       = Voiced velar stop
| ipa number  = 110
| decimal     = 609
| imagefile   = Voiced velar stop (vector).svg
| imagesize   = 150px
| x-sampa     = g
| kirshenbaum = g
| braille     = g
}}
<pre>{{Infobox IPA
| above       = Voiced velar stop
| ipa number  = 110
| decimal     = 609
| imagefile   = Voiced velar stop (vector).svg
| imagesize   = 150px
| x-sampa     = g
| kirshenbaum = g
| braille     = g
}}</pre>{{clear}}

==Full parameter list==
<pre>
{{infobox IPA
| above        =
| ipa symbol   =
| ipa symbol2  =
| ipa symbol3  =
| ipa symbol4  =

| imagefile    =
| imagecaption =
| imagesize    =

| ipa number   =
| ipa link     =
| decimal1     =
| decimal2     =
| decimal3     =
| decimal4     =
| note1 label  =
| note1        =

| unicode      =
| x-sampa      =
| kirshenbaum  =
| braille      = 
| braille2     = 
| braille3     = 
| braille4     = 
| note2 label  =
| note2        =

| soundfile    =
}}
</pre>

;Decimal numbers
Up to four decimal values can be entered, to compose the symbol:
{{infobox IPA
| ipa symbol = ʎ̥˔
| ipa number = 157 402A 429
| decimal1   = 654
| decimal2   = 805
| decimal3   = 724
| decimal4   =
}}
<pre>
| ipa symbol = ʎ̥˔
| ipa number = 157 402A 429
| decimal1   = 654
| decimal2   = 805
| decimal3   = 724
| decimal4   =
</pre>
{{clear}}

===Multiple symbols===
Up to eight symbols can be shown in big font.
{{Infobox IPA
| above = Downstep and upstep
| ipa symbol  = ꜛ◌
| ipa symbol2 = ꜜ◌
| ipa symbol3 =
| ipa symbol8 =
}}
<pre>
| above = Downstep and upstep
| ipa symbol  = ꜛ◌
| ipa symbol2 = ꜜ◌
| ipa symbol3 =
...
| ipa symbol8 =
</pre>{{clear}}

===Image===
Adding an image of the symbol:
{{infobox IPA
| ipa symbol = ʎ̥˔
| imagefile    = Lateral fricatives.svg
| imagecaption = image example
| imagesize    = 50px
}}
<pre>
{{infobox IPA
| ipa symbol = ʎ̥˔
| imagefile    = Lateral fricatives.svg
| imagecaption = image example
| imagesize    = 50px
}}
</pre>{{clear}}

===More input options===
{{infobox IPA
| ipa symbol   = a
| note1 label  = Extra note 1
| note1        = This is my first note

| unicode      = U+9999
| x-sampa      = X-S
| kirshenbaum  = K
| note2 label  = Extra note 2
| note2        = Another note by me here
}}
<pre>
| ipa symbol   = a
| note1 label  = Extra note 1
| note1        = This is my first note

| unicode      = U+9999
| x-sampa      = X-S
| kirshenbaum  = K
| note2 label  = Extra note 2
| note2        = Another note by me here
</pre>{{clear}}

===Soundfile===
The template tries to determine the default soundfile name by using the sound name (as determined by the IPA number, or IPA symbol):
* {{tlx|IPA symbol|m}} → {{IPA audio filename|m|checkexist=no}}
* If this fails, the file name can be entered.

When the file exists, the soundbutton is shown. Otherwise, no soundbutton is shown at all.

{{infobox IPA
| ipa symbol = abc
| note2      = Example non default soundfile
| soundfile  = Accordion registers.ogg
}}
<pre>
| ipa symbol = abc
| note2      = Example non default soundfile
| soundfile  = Accordion registers.ogg
</pre>

''Note''
:See {{tlx|IPA audio filename}} for more information on the naming of the phonetic soundfiles.{{clear}}

===Deprecated parameters===
The next parameters are deprecated. They can still be used, and may be present in articles.

Old parameters are treated as input for new ones, e.g. input <code>ipa-image=...</code> is read as input for <code>imagefile=...</code>.
<pre>
old parameter goes into new parameter:<br>
ipa-number    => ipa number
ipa-text      => ipa symbol
ipa-image     => imagefile
decimal       => decimal1
xsampa        => x-sampa
sound         => soundfile
</pre>

==Priorities in parameters==
The template tries to get as much information as possible from the input.
Overwriting:
<pre>
| above        = (overwrites ipa symbol name (IPA symbol) in header)
| ipa symbol   = (overwrites big symbol that was created by the decimal numbers)
| unicode      = (overwrites Unicode numbers that were determinated by the decimal numbers)
| soundfile    = (overwrites any default soundfile name that was derived by the IPA symbol name or number)
</pre>

==See also==
* {{tl|IPA audio filename}} &ndash; produces the name of the soundfile
* {{tl|IPA soundbox}} &ndash; creates the soundbox as is used in this template
{{IPA templates}}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
<!--Categories below this line, please; interwikis at Wikidata-->
{{DEFAULTSORT:Infobox Ipa}}
[[Гурӯҳ:Language infobox templates|Ipa]]
[[Гурӯҳ:IPA templates]]
}}</includeonly>