查看“︁模板:Lang/doc”︁的源代码

<includeonly><!-- 在这里加入模板的保护标识 -->{{缺乏使用说明}}</includeonly>
<!-- 在本行下编辑模板说明 -->

本模板用来标明特定语言文字（参见[[语言代码]]）。正确使用时不对条目产生可见的改变。

 <nowiki>{{</nowiki>lang|'''语言卷标'''|'''内文'''}}

使用[[ISO 639]]语言代码表。例如（该处使用<tt>fr</tt>代表[[法语]]）：

<pre>
* 她说「{{lang|fr|''Je suis française.''}}」
</pre>

在你的浏览器中显示为:
* 她说「{{lang|fr|''Je suis française.''}}」

本模板的其他版本亦可印出语言名称，一般用在第一次引用该语言的时候。例如，「{{tlx|lang-es|Español}}」和「{{tlx|lang-ru|русский язык}}」会显示「{{lang-es|Español}}」、「{{lang-ru|русский язык}}」。

语言标签也可以用来表示书写体系或语言的地区变体。[[W3C]]指出：“创建语言标签的黄金准则是越短越好。”[http://www.w3.org/International/articles/language-tags/Overview.en.php] 所以只有在非用不可的情况下才可以添加它们。 [[ISO 639-1]] 优于 [[ISO 639-2]] 和 [[ISO 639-3]].

=== 表示书写体系 ===

如有必要，可以添加[[ISO 15924]]代码来表示书写体系。 

例如：[[俄语]]通常用[[西里尔字母]]书写，所以书写代码'<tt>Cyrl</tt>'是多余的，只需用语言代码<tt>ru</tt>就可以了，不必使用<tt>ru-Cyrl</tt>。但是，当被修饰文字是拉丁[[转写]]时，要使用<tt>Latn</tt>代码，因为俄语并非用拉丁字母书写：<tt>ru-Latn</tt>。  

<pre>
* '''莫斯科'''（[[俄语]]：{{lang|ru|Москва́}}，{{lang|ru-Latn|''Moskva''}}）
</pre>
相当于
<pre>
* '''莫斯科'''（{{lang-ru|Москва́}}，{{lang|ru-Latn|''Moskva''}}）
</pre>

在你的浏览器中显示为：
* '''莫斯科'''（{{lang-ru|Москва́}}，{{lang|ru-Latn|''Moskva''}}）

<nowiki>{{lang|ru-Latn|''Moskva''}}</nowiki> 等同于 <nowiki>{{transl|ru|''Moskva''}}</nowiki>。若要指明你使用的是[[ISO 9]]西里尔字母转写，使用 <nowiki>{{transl|ru|ISO|''Moskva''}}</nowiki>：
* 莫斯科（{{lang-ru|Москва́}}，[[ISO 9]]：{{transl|ru|ISO|''Moskva''}}）

[[Internet Assigned Numbers Authority|IANA]] maintains a list specifying when the script tag should be suppressed [http://www.iana.org/assignments/language-subtag-registry]. 某些情况下，文字必须被指定清楚，比如[[塔吉克语]]，可以同等地用[[阿拉伯字母]]、[[拉丁字母]]和[[西里尔字母]]三种文字书写：
<pre>
* Tajik ({{rtl-lang|tg-Arab|تاجیکی}}, {{lang|tg-Latn|''tojikī''}}, {{lang|tg-Cyrl|тоҷикӣ}})
</pre>
你的显示器效果如下：
* Tajik ({{rtl-lang|tg-Arab|تاجیکی}}, {{lang|tg-Latn|''tojikī''}}, {{lang|tg-Cyrl|тоҷикӣ}})
注意当使用阿拉伯文字时，用模板{{tl|rtl-lang}}代替模板{{tl|lang}}，参见[[#书写方向|书写方向说明]]。

==== 未确定语言 ====

The <nowiki>{{</nowiki>lang}} template is not only used to specify the language of foreign words, but also to specify a single symbol or character in a specific script, for example when discussing about a specific writing system. Many times the character/symbol is used in several languages, but when the article refers to the [[grapheme]] itself the [[ISO 639-2]] and [[ISO 639-3]] language code <tt>und</tt> for Undetermined language. For example:

<pre>
The {{lang|und-Hani|字}} Han character has 6 strokes.
</pre>
:The {{lang|und-Hani|字}} Han character has 6 strokes.


Han characters are used in Chinese, Japanese, sometimes Korean, and formerly Vietnamese, and in this case the character is not used for any specific language. Note that the script code used is <tt>Hani</tt>, which specifies generic Han characters (Hanzi, Kanji, Hanja).

compare {{tl|script}}
<pre>
汉字{{script|Hani|字}}笔划数为6。
</pre>
:汉字{{script|Hani|字}}笔划数为6。

=== 表示语言变种 ===

In some cases, maybe it will be needed to add [[ISO 3166-1 alpha-2]] country codes (specific usage of that country). Of course the three codes can appear in the same tag, for example the code <tt>zh-Hant-TW</tt> will be used for [[Chinese language|Chinese]] text written with [[Traditional Chinese characters|Traditional Han characters]], containing words or expressions specific to [[Taiwan]]. <tt>zh-Hans</tt> is for simplified. Examples:

<pre>
* {{lang|zh-Hant-TW|台湾}}
</pre>

Results in your browser:
* {{lang|zh-Hant-TW|台湾}}

=== 书写方向 ===

<s>{{tl|rtl-lang}} is a specific template for right-to-left languages like [[Arabic language|Arabic]] or [[Hebrew language|Hebrew]].</s>

For right-to-left paragraphs (as opposed to rtl strings embedded in an English paragraph), use {{tl|rtl-para}}.

== 使用理由 ==

* 网页浏览器可以运用这些信息，来选择合适的字体。
** 这对[[中日韩统一表意文字]]尤其重要，文字可以被赋予其语言特有的形态，但若无合适字体被侦测到或优先字体有缺字，将回跌至另一种形状，例如可能该语言不使用这个文字：参见[[:en:User:Wikipeditor/CJK|这里的比较表和屏幕截图]]。
* 为了[[网络无障碍]]目的：[[屏幕阅读器]]需要语言信息，以正确地提供音讯输出。
* 为了[[拼写检查]]和文法检查。
* 帮助浏览器选择适切的[[引号]]，以及判断[[连字符]]、[[合字]]和间距。
* 用户可以对不同语种应用样式，透过自定义[[样式表单]]（对编者很有用）。
* Google及其他[[搜索引擎]]在建立[[索引]]文字时可以利用这些信息。
* 更有助于数据遴选、分析、再利用。
* 可能有益于重新发布维基百科的应用程序开发者。
* 可能有益于关于维基百科上语言统计数据的研究与搜集。

== 自定样式 ==
通过添加或修改''User:你的用户名/common.css''或对应皮肤的css，可以控制不同语言内容的显示样式。如对所有俄语的文字显示为绿色。Internet Explorer使用者要求在版本8或以上。

;示例：

*控制特定语言（这里是俄语）的显示样式：<br />span[lang|=ru] { font-family: fonteskaya; }

*控制所有语言的显示样式：<br />span[lang] { color: green; }

;注意事项：
*不要为CSS文件添加双引号。

== 杂项 ==
* <nowiki>{{DISPLAYTITLE}}</nowiki>和<nowiki>{{lang}}</nowiki>不能一起使用，如<nowiki>{{DISPLAYTITLE:{{lang|en|Good To See You}}}}</nowiki>会出错，折中办法是{{[[Template:TitleLang|TitleLang]]}}。
*使用「<nowiki><span lang="en">example</span></nowiki>」之类的语法在显示时的效果相若，但是不会自动把条目归入「Category:含有英语的条目」之类的分类。

== 参见 ==
* [[:Category:多语言支持模板]]
* [[ISO 639]]（语言代码）
* [[ISO 15924 列表]]（书写文字代码）
* [[国际标准化组织拉丁化方案列表]]（拉丁转写代码）
* {{tl|transl}} 用在并非本身以拉丁字母书写的语言之罗马化。
* {{tl|script}}
* [[:Category:语言标示模板]]，视觉上标示外部链接为外语内容。

== 参考数据 ==
* [[World Wide Web Consortium|W3C]]
** [http://www.w3.org/International/articles/language-tags/Overview.en.php Language tags in HTML and XML]—overview
** [http://www.w3.org/TR/i18n-html-tech-lang/ Internationalization Best Practices: Specifying Language in XHTML & HTML Content]—W3C Working Draft 21 July 2006
** [http://www.w3.org/International/articles/bcp47/ Understanding the New Language Tags]
** [http://www.w3.org/International/questions/qa-css-lang FAQ: Styling using the lang attribute]
* [[Internet Assigned Numbers Authority|IANA]]
** [http://www.iana.org/assignments/language-subtag-registry IANA Language Subtag Registry]
** [http://www.rfc-editor.org/rfc/rfc4646.txt Tags for Identifying Languages] (RFC 4646)
** [http://www.rfc-editor.org/rfc/rfc4647.txt Matching of Language Tags] (RFC 4647)
** [http://www.iana.org/assignments/language-tags Language tags]—(obsolete per RFC4646)

<noinclude>[[en:Template:Lang/doc]]</noinclude>
<includeonly>
<!-- 本行下加入模板的分类 -->
[[Category:语言模板|Lang]]
[[Category:多语言支持模板|Lang]]
</includeonly>