قالب:Lang-zh/doc

 About

There were once a large number of Chinese Romanization templates: {{zh-stp}} could display simplified and traditional characters and Hanyu Pinyin; {{zh-cpwl}} could display general Han characters, pinyin and Wade–Giles, and literal translations; {{zh-full}} and its sub-templates allowed more control over display order, etc..

This template was created to combine these into one template with all needed functionality. It can display (and link to) general, simplified, or traditional Han characters; literal translation; Zhuyin (Bopomofo); and the Hanyu Pinyin, Tongyong Pinyin, Wade–Giles, Jyutping, Cantonese Yale, Sidney Lau and Pe̍h-ōe-jī romanizations. It supports reordering the output for the most commonly used orders (other orderings can easily be added).

 Usage

 Parameters

For most of the below parameter demonstrations, "China" is used as a placeholder.

To use the template, start with {{Lang-zh}} and add any parameters you like, along with what you want to be displayed. The template will display all, and only, the parameters that you give it. The following parameters are supported:

Parameter	Description	Example
|c=	Chinese	{{Lang-zh|c=中国}} صينية: 中国�
|s=	simplified Chinese	{{Lang-zh|s=中国}} صينية: 中国�
|t=	traditional Chinese	{{Lang-zh|t=中國}} صينية: 中國�
|p= or |hp=	pinyin	{{Lang-zh|p=zhōngguó}} پن‌ين: zhōngguó�
|tp=	Tongyong Pinyin	{{Lang-zh|tp=Jhongguó}} Tongyong Pinyin: Jhongguó�
|w=	Wade–Giles	{{Lang-zh|w=Chung1kuo2}} ويد–جايلز: Chung1kuo2�
|j=	Jyutping	{{Lang-zh|j=Gwong2zau1}} Jyutping: Gwong2zau1�
|cy=	Cantonese Yale	{{Lang-zh|cy=Gwóngjāu}} كانتونية يل: Gwóngjāu�
|sl=	Sidney Lau	{{Lang-zh|sl=Gwong2jau1}} لاو سيدني: Gwong2jau1�
|poj=	Pe̍h-ōe-jī	{{Lang-zh|poj=Tâi-tiong-kōan}} Pe̍h-ōe-jī: Tâi-tiong-kōan�
|zhu=	Zhuyin Fuhao	{{Lang-zh|zhu=ㄊㄠˊ ㄩㄢˊ ㄒㄧㄢˋ}} Zhuyin Fuhao: ㄊㄠˊ ㄩㄢˊ ㄒㄧㄢˋ�
|l=	literal meaning	{{Lang-zh|l=Middle Kingdom}} حرفياً: 'Middle Kingdom'�
|labels=	Display language labels	See below
|links=	Display language links	See below
|first=	Override default ordering	See below
|scase=	use sentence case	See below

 Label options

Add |labels=no anywhere in the template to disable labels, so only the text supplied as parameters appears, separated by semicolons. This minimises the length of the template, and can be used when the template is used more than once to lessen its impact. Disabling labels also suppresses links.

{{Lang-zh | t=中國| s=中国| hp=Zhōngguó| tp=Jhongguó| labels=no}}

中国؛ 中國؛ Zhōngguó؛ Jhongguó�

Add |links=no anywhere in the template to suppress label links. This is for preventing overlinking in an article or section where the template is used repeatedly.

{{Lang-zh | t=中國| s=中国| hp=Zhōngguó| tp=Jhongguó| links=no}}

الصينية المبسطة: 中国؛ الصينية التقليدية: 中國؛ Hanyu Pinyin: Zhōngguó؛ Tongyong Pinyin: Jhongguó�

Add |scase=yes anywhere in the template to use sentence case, so the first label starts with a capital letter. This allows the template to be used at the start of a sentence for example.

{{Lang-zh | t=中國| s=中国| hp=Zhōngguó| tp=Jhongguó| scase=yes}}

الصينية المبسطة: 中国؛ الصينية التقليدية: 中國؛ Hanyu Pinyin: Zhōngguó؛ Tongyong Pinyin: Jhongguó�

 Ordering

The template can be given more than one value (for example, on the article China, it has s, t, hp, tp, and w). By default, when multiple parameters are given they will be shown in the same order as the above table: first Chinese characters (simplified, then traditional), then romanizations (starting with Hanyu and Tongyong Pinyin).

This order can be overridden using |first=. It accepts a comma delimited list of values, though currently only two are supported (more can be added if needed)

• |first=t puts traditional Chinese before simplified Chinese, for example for Taiwan and Hong Kong topics
• |first=j puts the Cantonese Romanizations, Jyutping and Yale, before pinyin Romanizations, for Hong Kong topics
• They can be combined: either |first=j,t or |first=t,j can be used

Examples:

{{Lang-zh | t=臺北| s=台北| hp=Táiběi}}

الصينية المبسطة: 台北؛ الصينية التقليدية: 臺北؛ پن‌ين: Táiběi�

{{Lang-zh | t=臺北| s=台北| hp=Táiběi|first=t}}

الصينية التقليدية: 臺北؛ الصينية المبسطة: 台北؛ پن‌ين: Táiběi�

{{Lang-zh | t=九龍| s=九龙| p=Jiǔlóng|j=gau2lung4}}

الصينية المبسطة: 九龙؛ الصينية التقليدية: 九龍؛ پن‌ين: Jiǔlóng؛ Jyutping: gau2lung4�

{{Lang-zh | t=九龍| s=九龙| p=Jiǔlóng|j=gau2lung4|first=t, j}}

الصينية التقليدية: 九龍؛ الصينية المبسطة: 九龙؛ Jyutping: gau2lung4؛ پن‌ين: Jiǔlóng�

It is also possible to override the default ordering for an article, so traditional Chinese appears before simplified Chinese, i.e. so all uses of the template default to |first=t. This is done by adding the article to the list t1st at the top of Module:Zh, following the formatting of the articles already there. The module is edit-protected, so you may need to use {{edit template-protected}} on the module's talk page Module talk:Zh to request an article is added, if you cannot add it yourself.

 TemplateData

TemplateData documentation used by VisualEditor and other tools

See the monthly error report for this template. TemplateData for Lang-zh A template to facilitate consistent layout, proper formatting, categorisation and language labelling of Chinese text and its romanizations وسائط القالب هذا القالب يفضل التنسيق بنفس السطر للوسائط. وسيط وصف نوع حالة Chinese c 1 Chinese characters مثال 大名 نص مقترح Simplified Chinese s Simplified Chinese characters مثال 中国 نص مقترح Traditional Chinese t Traditional Chinese characters مثال 中國 نص مقترح Pinyin p hp Hanyu Pinyin Romanization (Mandarin) مثال Zhōngguó نص مقترح Tongyong Pinyin tp Tongyong Pinyin Romanization (Mandarin) نص اختياري Wade-Giles w Wade-Giles Romanization (Mandarin) نص اختياري Jyutping j [Cantonese] Jyutping Romanization نص اختياري Cantonese Yale cy Cantonese Yale Romanization نص اختياري Sidney Lau sl Sidney Lau Cantonese Romanization نص اختياري Pe̍h-ōe-jī poj Pe̍h-ōe-jī Romanization for Hokkien نص اختياري Zhuyin Fuhao zhu Zhuyin Fuhao/Bopomofo (typically for Mandarin) نص اختياري literally l literal [English] meaning مثال Middle Country نص اختياري Show labels? labels Whether or not to display labels. Use "no" to suppress them. غيابي yes مثال no نص اختياري Links links Whether or not to link to the article of the specific article of the language/script/romanization. Use "no" to suppress them. غيابي yes مثال no نص اختياري ordering first 't', 'j' or 't, j' to put traditional Chinese and/or Cantonese Romanizations first مثال "t, j" نص اختياري sentence case scase If this parameter is non-empty, the first label is capitalized, i.e. can start a sentence. نص اختياري

 Tracking categories

• Category:Articles containing Chinese-language text (1٬440)
• Category:Articles containing simplified Chinese-language text (3)
• Category:Articles containing traditional Chinese-language text (7)
• Category:Pages using template Zh with sup tags (5)

 See also

• {{CJKV}}, a similar template, but with Japanese/Korean/Vietnamese functionality
• {{Lang}}, a general purpose template used for single items. E.g. {{Lang|zh|中国}} produces similar output to {{Lang-zh|c=中国|labels=no}}.
• {{Infobox Chinese}}, an infobox that supports traditional and simplified Chinese as well as other common romanizations.
• {{Old Chinese}}, for reconstructed Old Chinese phonology
• {{Rarely-used Chinese characters}}, to describe characters that may have trouble rendering properly.