Difference between revisions of "Template:IPAc-cmn/doc"

From blackwiki
Jump to navigation Jump to search
imported>Vanisaac
m (→‎See also: clean up per WP:CAT#T and WP:AWBREQ add template:Sandbox other)
imported>Sheila1988
(→‎Tones: neutral)
 
(One intermediate revision by one other user not shown)
Line 8: Line 8:
  
 
Normal usage:
 
Normal usage:
*<tt><nowiki>{{IPAc-cmn|zh|ong|1|h|ua|2}}</nowiki></tt> produces {{IPAc-cmn|zh|ong|1|h|ua|2}}
+
*<code><nowiki>{{IPAc-cmn|zh|ong|1|h|ua|2}}</nowiki></code> produces {{IPAc-cmn|zh|ong|1|h|ua|2}}
*<tt><nowiki>{{IPAc-cmn|r|en|2|m|in|2|-|g|ong|4|h|e|2|g|uo|2}}</nowiki></tt> produces {{IPAc-cmn|r|en|2|m|in|2|-|g|ong|4|h|e|2|g|uo|2}}
+
*<code><nowiki>{{IPAc-cmn|r|en|2|m|in|2|-|g|ong|4|h|e|2|g|uo|2}}</nowiki></code> produces {{IPAc-cmn|r|en|2|m|in|2|-|g|ong|4|h|e|2|g|uo|2}}
  
 
With an audio file:
 
With an audio file:
*<tt><nowiki>{{IPAc-cmn|AUD|Zh-hànyǔ.ogg|h|an|4|yu|3}}</nowiki></tt> produces {{IPAc-cmn|AUD|Zh-hànyǔ.ogg|h|an|4|yu|3}}
+
*<code><nowiki>{{IPAc-cmn|AUD|Zh-hànyǔ.ogg|h|an|4|yu|3}}</nowiki></code> produces {{IPAc-cmn|AUD|Zh-hànyǔ.ogg|h|an|4|yu|3}}
  
 
To change the delimiters (for example, if several instances of the template need to be strung together because of the limit on the number of parameters):
 
To change the delimiters (for example, if several instances of the template need to be strung together because of the limit on the number of parameters):
*<tt><nowiki>{{IPAc-cmn|[-|zh|ong|1|h|ua|2|-|r|en|2|m|in|2|-|g|ong|4|h|e|2|g|uo|2}}</nowiki></tt> produces {{IPAc-cmn|[-|zh|ong|1|h|ua|2|-|r|en|2|m|in|2|-|g|ong|4|h|e|2|g|uo|2}}
+
*<code><nowiki>{{IPAc-cmn|[-|zh|ong|1|h|ua|2|-|r|en|2|m|in|2|-|g|ong|4|h|e|2|g|uo|2}}</nowiki></code> produces {{IPAc-cmn|[-|zh|ong|1|h|ua|2|-|r|en|2|m|in|2|-|g|ong|4|h|e|2|g|uo|2}}
*<tt><nowiki>{{IPAc-cmn|-]|zh|ong|1|h|ua|2|-|r|en|2|m|in|2|-|g|ong|4|h|e|2|g|uo|2}}</nowiki></tt> produces {{IPAc-cmn|-]|zh|ong|1|h|ua|2|-|r|en|2|m|in|2|-|g|ong|4|h|e|2|g|uo|2}}  
+
*<code><nowiki>{{IPAc-cmn|-]|zh|ong|1|h|ua|2|-|r|en|2|m|in|2|-|g|ong|4|h|e|2|g|uo|2}}</nowiki></code> produces {{IPAc-cmn|-]|zh|ong|1|h|ua|2|-|r|en|2|m|in|2|-|g|ong|4|h|e|2|g|uo|2}}  
  
 
The full range of special values for the first parameter (changing the delimiters and/or specifying that the next parameter is an audio file) is as follows:
 
The full range of special values for the first parameter (changing the delimiters and/or specifying that the next parameter is an audio file) is as follows:
*<tt>-- [- -] // /- -/ AUD -]AUD //AUD -/AUD</tt>
+
*<code>-- [- -] // /- -/ AUD -]AUD //AUD -/AUD</code>
  
 
For example, to link an audio clip as well as change delimeters:
 
For example, to link an audio clip as well as change delimeters:
*<tt><nowiki>{{IPAc-cmn|-/AUD|Zh-hànyǔ.ogg|h|an|4|yu|3}}</nowiki></tt> produces {{IPAc-cmn|-/AUD|Zh-hànyǔ.ogg|h|an|4|yu|3}}
+
*<code><nowiki>{{IPAc-cmn|-/AUD|Zh-hànyǔ.ogg|h|an|4|yu|3}}</nowiki></code> produces {{IPAc-cmn|-/AUD|Zh-hànyǔ.ogg|h|an|4|yu|3}}
  
  
Line 28: Line 28:
  
 
The following initials are used as in Pinyin, and represent their normal sounds in Standard Mandarin:
 
The following initials are used as in Pinyin, and represent their normal sounds in Standard Mandarin:
*<tt>b p m f d t n l g k h j q x zh ch sh r z c s</tt>
+
*<code>b p m f d t n l g k h j q x zh ch sh r z c s</code>
  
 
====Finals====
 
====Finals====
  
 
Each final should be entered as a whole parameter, and as if it were not preceded by an initial, though in most cases either form is acceptable:
 
Each final should be entered as a whole parameter, and as if it were not preceded by an initial, though in most cases either form is acceptable:
*<tt>yong</tt> (or <tt>iong</tt>), <tt>wa</tt> (or <tt>ua</tt>), etc.
+
*<code>yong</code> (or <code>iong</code>), <code>wa</code> (or <code>ua</code>), etc.
  
But note that the finals with ⟨ü⟩, despite usually being written ⟨u⟩ in Pinyin, must either be substituted with <tt>yu ü v</tt>, or written together with the initial j, q, or x. Similarly, the null final of ''shi, ri'', etc. must either be substituted with <tt>^</tt> (a caret), or written together with the initial z(h) c(h) s(h) or r.
+
But note that the finals with ⟨ü⟩, despite usually being written ⟨u⟩ in Pinyin, must either be substituted with <code>yu ü v</code>, or written together with the initial j, q, or x. Similarly, the null final of ''shi, ri'', etc. must either be substituted with <code>^</code> (a caret), or written together with the initial z(h) c(h) s(h) or r.
  
[[Erhua]] is indicated simply with an ‹-r› as part of the final, e.g., <tt>angr</tt>.
+
[[Erhua]] is indicated simply with an ‹-r› as part of the final, e.g., <code>angr</code>.
  
 
{{Collapse top|List of Pinyin finals accepted for template input}}
 
{{Collapse top|List of Pinyin finals accepted for template input}}
 
<!--{{col-begin}}
 
<!--{{col-begin}}
 
{{col-4}}-->
 
{{col-4}}-->
*<tt>^</tt> = {{IPAc-cmn|^}}
+
*<code>^</code> = {{IPAc-cmn|^}}
*<tt>ai</tt> = {{IPAc-cmn|ai}}
+
*<code>ai</code> = {{IPAc-cmn|ai}}
*<tt>an</tt> = {{IPAc-cmn|an}}
+
*<code>an</code> = {{IPAc-cmn|an}}
*<tt>a</tt> = {{IPAc-cmn|a}}
+
*<code>a</code> = {{IPAc-cmn|a}}
*<tt>ang</tt> = {{IPAc-cmn|ang}}
+
*<code>ang</code> = {{IPAc-cmn|ang}}
*<tt>ao</tt> = {{IPAc-cmn|ao}}
+
*<code>ao</code> = {{IPAc-cmn|ao}}
*<tt>ei</tt> = {{IPAc-cmn|ei}}
+
*<code>ei</code> = {{IPAc-cmn|ei}}
*<tt>en</tt> = {{IPAc-cmn|en}}
+
*<code>en</code> = {{IPAc-cmn|en}}
*<tt>ê</tt> = {{IPAc-cmn|ê}}
+
*<code>ê</code> = {{IPAc-cmn|ê}}
*<tt>e</tt> = {{IPAc-cmn|e}}
+
*<code>e</code> = {{IPAc-cmn|e}}
*<tt>eng</tt> = {{IPAc-cmn|eng}}
+
*<code>eng</code> = {{IPAc-cmn|eng}}
*<tt>yi, i</tt> = {{IPAc-cmn|yi}}
+
*<code>yi, i</code> = {{IPAc-cmn|yi}}
*<tt>yin, in</tt> = {{IPAc-cmn|yin}}
+
*<code>yin, in</code> = {{IPAc-cmn|yin}}
*<tt>ying, ing</tt> = {{IPAc-cmn|ying}}
+
*<code>ying, ing</code> = {{IPAc-cmn|ying}}
*<tt>ya, ia</tt> = {{IPAc-cmn|ya}}
+
*<code>ya, ia</code> = {{IPAc-cmn|ya}}
*<tt>yang, iang</tt> = {{IPAc-cmn|yang}}
+
*<code>yang, iang</code> = {{IPAc-cmn|yang}}
*<tt>yao, iao</tt> = {{IPAc-cmn|yao}}
+
*<code>yao, iao</code> = {{IPAc-cmn|yao}}
 
<!--{{col-4}}-->
 
<!--{{col-4}}-->
*<tt>ye, ie</tt> = {{IPAc-cmn|ye}}
+
*<code>ye, ie</code> = {{IPAc-cmn|ye}}
*<tt>yan, ian</tt> = {{IPAc-cmn|yan}}
+
*<code>yan, ian</code> = {{IPAc-cmn|yan}}
*<tt>you, iu</tt> = {{IPAc-cmn|you}}
+
*<code>you, iu</code> = {{IPAc-cmn|you}}
*<tt>yo, io</tt> = {{IPAc-cmn|yo}}
+
*<code>yo, io</code> = {{IPAc-cmn|yo}}
*<tt>yong, iong</tt> = {{IPAc-cmn|yong}}
+
*<code>yong, iong</code> = {{IPAc-cmn|yong}}
*<tt>ou</tt> = {{IPAc-cmn|ou}}
+
*<code>ou</code> = {{IPAc-cmn|ou}}
*<tt>o</tt> = {{IPAc-cmn|o}}
+
*<code>o</code> = {{IPAc-cmn|o}}
*<tt>wu</tt> = {{IPAc-cmn|wu}}
+
*<code>wu</code> = {{IPAc-cmn|wu}}
*<tt>yue, üe, ve</tt> = {{IPAc-cmn|yue}}
+
*<code>yue, üe, ve</code> = {{IPAc-cmn|yue}}
*<tt>yuan, üan, van</tt> = {{IPAc-cmn|yuan}}
+
*<code>yuan, üan, van</code> = {{IPAc-cmn|yuan}}
*<tt>ong</tt> = {{IPAc-cmn|ong}}
+
*<code>ong</code> = {{IPAc-cmn|ong}}
*<tt>wa, ua</tt> = {{IPAc-cmn|wa}}
+
*<code>wa, ua</code> = {{IPAc-cmn|wa}}
*<tt>wai, uai</tt> = {{IPAc-cmn|wai}}
+
*<code>wai, uai</code> = {{IPAc-cmn|wai}}
*<tt>wan, uan</tt> = {{IPAc-cmn|wan}}
+
*<code>wan, uan</code> = {{IPAc-cmn|wan}}
*<tt>wang, uang</tt> = {{IPAc-cmn|wang}}
+
*<code>wang, uang</code> = {{IPAc-cmn|wang}}
*<tt>wei, ui</tt> = {{IPAc-cmn|wei}}
+
*<code>wei, ui</code> = {{IPAc-cmn|wei}}
*<tt>wen, un</tt> = {{IPAc-cmn|wen}}
+
*<code>wen, un</code> = {{IPAc-cmn|wen}}
 
<!--{{col-4}}-->
 
<!--{{col-4}}-->
*<tt>weng</tt> = {{IPAc-cmn|weng}}
+
*<code>weng</code> = {{IPAc-cmn|weng}}
*<tt>wo, uo, o</tt> = {{IPAc-cmn|wo}}
+
*<code>wo, uo, o</code> = {{IPAc-cmn|wo}}
*<tt>yu, ü, v</tt> = {{IPAc-cmn|yu}}
+
*<code>yu, ü, v</code> = {{IPAc-cmn|yu}}
*<tt>yun, ün, vn</tt> = {{IPAc-cmn|yun}}
+
*<code>yun, ün, vn</code> = {{IPAc-cmn|yun}}
*<tt>er, ar, air, anr</tt> = {{IPAc-cmn|er}}
+
*<code>er, ar, air, anr</code> = {{IPAc-cmn|er}}
*<tt>angr</tt> = {{IPAc-cmn|angr}}
+
*<code>angr</code> = {{IPAc-cmn|angr}}
*<tt>aor</tt> = {{IPAc-cmn|aor}}
+
*<code>aor</code> = {{IPAc-cmn|aor}}
*<tt>^r</tt> = {{IPAc-cmn|^r}}
+
*<code>^r</code> = {{IPAc-cmn|^r}}
*<tt>eir, enr</tt> = {{IPAc-cmn|eir}}
+
*<code>eir, enr</code> = {{IPAc-cmn|eir}}
*<tt>engr</tt> = {{IPAc-cmn|engr}}
+
*<code>engr</code> = {{IPAc-cmn|engr}}
*<tt>e'r</tt> = {{IPAc-cmn|e'r}}
+
*<code>e'r</code> = {{IPAc-cmn|e'r}}
*<tt>yar, iar</tt> = {{IPAc-cmn|yar}}
+
*<code>yar, iar</code> = {{IPAc-cmn|yar}}
*<tt>yanr, ianr</tt> = {{IPAc-cmn|yanr}}
+
*<code>yanr, ianr</code> = {{IPAc-cmn|yanr}}
*<tt>yangr, iangr</tt> = {{IPAc-cmn|yangr}}
+
*<code>yangr, iangr</code> = {{IPAc-cmn|yangr}}
*<tt>yaor, iaor</tt> = {{IPAc-cmn|yaor}}
+
*<code>yaor, iaor</code> = {{IPAc-cmn|yaor}}
*<tt>yinr, inr, yir, ir</tt> = {{IPAc-cmn|yir}}
+
*<code>yinr, inr, yir, ir</code> = {{IPAc-cmn|yir}}
*<tt>yer, ier</tt> = {{IPAc-cmn|yer}}
+
*<code>yer, ier</code> = {{IPAc-cmn|yer}}
*<tt>yingr, ingr</tt> = {{IPAc-cmn|yingr}}
+
*<code>yingr, ingr</code> = {{IPAc-cmn|yingr}}
 
<!--{{col-4}}-->
 
<!--{{col-4}}-->
*<tt>your, iur</tt> = {{IPAc-cmn|your}}
+
*<code>your, iur</code> = {{IPAc-cmn|your}}
*<tt>yongr, iongr</tt> = {{IPAc-cmn|yongr}}
+
*<code>yongr, iongr</code> = {{IPAc-cmn|yongr}}
*<tt>our</tt> = {{IPAc-cmn|our}}
+
*<code>our</code> = {{IPAc-cmn|our}}
*<tt>yuanr, üanr, vanr</tt> = {{IPAc-cmn|yuanr}}
+
*<code>yuanr, üanr, vanr</code> = {{IPAc-cmn|yuanr}}
*<tt>yur, ür, vr, yunr, ünr, vnr</tt> = {{IPAc-cmn|yur}}
+
*<code>yur, ür, vr, yunr, ünr, vnr</code> = {{IPAc-cmn|yur}}
*<tt>yuer, üer, ver</tt> = {{IPAc-cmn|yuer}}
+
*<code>yuer, üer, ver</code> = {{IPAc-cmn|yuer}}
*<tt>ongr</tt> = {{IPAc-cmn|ongr}}
+
*<code>ongr</code> = {{IPAc-cmn|ongr}}
*<tt>war, uar, wair, uair, wanr, uanr</tt> = {{IPAc-cmn|war}}
+
*<code>war, uar, wair, uair, wanr, uanr</code> = {{IPAc-cmn|war}}
*<tt>wangr, uangr</tt> = {{IPAc-cmn|wangr}}
+
*<code>wangr, uangr</code> = {{IPAc-cmn|wangr}}
*<tt>weir, uir, wenr, unr</tt> = {{IPAc-cmn|weir}}
+
*<code>weir, uir, wenr, unr</code> = {{IPAc-cmn|weir}}
*<tt>wengr</tt> = {{IPAc-cmn|wengr}}
+
*<code>wengr</code> = {{IPAc-cmn|wengr}}
*<tt>wur</tt> = {{IPAc-cmn|wur}}
+
*<code>wur</code> = {{IPAc-cmn|wur}}
*<tt>wor, uor</tt> = {{IPAc-cmn|wor}}
+
*<code>wor, uor</code> = {{IPAc-cmn|wor}}
*<tt>M</tt> = {{IPAc-cmn|M}}
+
*<code>M</code> = {{IPAc-cmn|M}}
*<tt>N</tt> = {{IPAc-cmn|N}}
+
*<code>N</code> = {{IPAc-cmn|N}}
*<tt>NG</tt> = {{IPAc-cmn|NG}}
+
*<code>NG</code> = {{IPAc-cmn|NG}}
 
<!--{{col-end}}-->
 
<!--{{col-end}}-->
 
{{Collapse bottom}}
 
{{Collapse bottom}}
Line 122: Line 122:
 
{| class="wikitable" style="margin:auto;"
 
{| class="wikitable" style="margin:auto;"
 
|-
 
|-
! Tone number !! Input !! Result !! Pinyin
+
! Tone number!!description !! Input !! Result !! Pinyin
 
|-
 
|-
| 1 || {{demo|<nowiki>{{IPAc-cmn|a|1}}</nowiki>|br={{!}}{{!}}}} || ā
+
| 1 ||high|| {{demo|<nowiki>{{IPAc-cmn|a|1}}</nowiki>|br={{!}}{{!}}}} || ā
 
|-
 
|-
| 2 || {{demo|<nowiki>{{IPAc-cmn|a|2}}</nowiki>|br={{!}}{{!}}}} || á
+
| 2 ||rising|| {{demo|<nowiki>{{IPAc-cmn|a|2}}</nowiki>|br={{!}}{{!}}}} || á
 
|-
 
|-
| 3 || {{demo|<nowiki>{{IPAc-cmn|a|3}}</nowiki>|br={{!}}{{!}}}} || ǎ
+
| 3 ||low|| {{demo|<nowiki>{{IPAc-cmn|a|3}}</nowiki>|br={{!}}{{!}}}} || ǎ
 
|-
 
|-
| 4 || {{demo|<nowiki>{{IPAc-cmn|a|4}}</nowiki>|br={{!}}{{!}}}} || à
+
| 4 ||falling|| {{demo|<nowiki>{{IPAc-cmn|a|4}}</nowiki>|br={{!}}{{!}}}} || à
 
|-
 
|-
| 5 || {{demo|<nowiki>{{IPAc-cmn|a|5}}</nowiki>|br={{!}}{{!}}}} || a
+
| 5 || neutral||{{demo|<nowiki>{{IPAc-cmn|a|5}}</nowiki>|br={{!}}{{!}}}} || a
 
|}
 
|}
  
Line 138: Line 138:
  
 
The following parameters have special meanings:
 
The following parameters have special meanings:
*<tt>-</tt> (hyphen) for a space between words
+
*<code>-</code> (hyphen) for a space between words
*<tt>.</tt> (period) for a syllable break
+
*<code>.</code> (period) for a syllable break
*<tt>'</tt> (apostrophe) for a primary stress mark (placed before the stressed syllable)
+
*<code>'</code> (apostrophe) for a primary stress mark (placed before the stressed syllable)
*<tt>,</tt> (comma) for a secondary stress mark (placed before the stressed syllable)
+
*<code>,</code> (comma) for a secondary stress mark (placed before the stressed syllable)
  
 
Other values used as parameters will be displayed unconverted. (The conversion system is coded in [[Template:c-cmn]].  The tones are encoded in [[Template:tone-cmn]])
 
Other values used as parameters will be displayed unconverted. (The conversion system is coded in [[Template:c-cmn]].  The tones are encoded in [[Template:tone-cmn]])

Latest revision as of 22:48, 3 August 2020

This template is used to produce a phonetic or phonemic representation (using the IPA system) of Mandarin Chinese words or sounds, using Pinyin input to avoid the need to search for the correct phonetic symbols. The result is wikilinked to Help:IPA for Mandarin. Optionally, an audio file can also be specified.

Usage

The number of parameters is always limited to 41 (Note: parameter #41 can only be a tone number).

Normal usage:

With an audio file:

To change the delimiters (for example, if several instances of the template need to be strung together because of the limit on the number of parameters):

The full range of special values for the first parameter (changing the delimiters and/or specifying that the next parameter is an audio file) is as follows:

  • -- [- -] // /- -/ AUD -]AUD //AUD -/AUD

For example, to link an audio clip as well as change delimeters:


Initials

The following initials are used as in Pinyin, and represent their normal sounds in Standard Mandarin:

  • b p m f d t n l g k h j q x zh ch sh r z c s

Finals

Each final should be entered as a whole parameter, and as if it were not preceded by an initial, though in most cases either form is acceptable:

  • yong (or iong), wa (or ua), etc.

But note that the finals with ⟨ü⟩, despite usually being written ⟨u⟩ in Pinyin, must either be substituted with yu ü v, or written together with the initial j, q, or x. Similarly, the null final of shi, ri, etc. must either be substituted with ^ (a caret), or written together with the initial z(h) c(h) s(h) or r.

Erhua is indicated simply with an ‹-r› as part of the final, e.g., angr.

List of Pinyin finals accepted for template input

Tones

The tones are indicated by their traditional tone number, entered as the parameter after the final of the syllable. Note that this template uses IPA tone diacritics, which are different from the Pinyin tone diacritics:

Tone number description Input Result Pinyin
1 high
{{IPAc-cmn|a|1}}
[[Help:IPA/Mandarin|[aTemplate:Tone-cmn]]] ā
2 rising
{{IPAc-cmn|a|2}}
[[Help:IPA/Mandarin|[aTemplate:Tone-cmn]]] á
3 low
{{IPAc-cmn|a|3}}
[[Help:IPA/Mandarin|[aTemplate:Tone-cmn]]] ǎ
4 falling
{{IPAc-cmn|a|4}}
[[Help:IPA/Mandarin|[aTemplate:Tone-cmn]]] à
5 neutral
{{IPAc-cmn|a|5}}
[[Help:IPA/Mandarin|[aTemplate:Tone-cmn]]] a

Special parameters

The following parameters have special meanings:

  • - (hyphen) for a space between words
  • . (period) for a syllable break
  • ' (apostrophe) for a primary stress mark (placed before the stressed syllable)
  • , (comma) for a secondary stress mark (placed before the stressed syllable)

Other values used as parameters will be displayed unconverted. (The conversion system is coded in Template:c-cmn. The tones are encoded in Template:tone-cmn)

See also