ਫਰਮਾ:Lang/doc ਲਈ ਸਰੋਤ ਵੇਖੋ

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
{{#ifeq:{{ROOTPAGENAME}}|Lang block|{{div-based-template}}|{{span-based-template}}}}
{{lua|Module:Lang}}

=== Usage ===
This template tags pieces of text with the appropriate language code and allows for the implementation of Web Fonts.

This template is a <nowiki><span></nowiki> template.<br />
{{tl|lang block}} is the <nowiki><div></nowiki> version of this template.

<pre>{{lang|language|text}}</pre>
<pre>{{lang
 | language  = 
 | text      = 
 | direction = 
 | font      = 
 | style     =
 | class     =
 | attr      =
 | inline    =
}}</pre>

=== Parameters ===
* {{parameter|language}}: (Also <code>lang</code> or the first unnamed parameter) The code for the language being displayed, using [[w:ISO 639|ISO 639]]. This can be two or three letters depending on the specificity of the language you are declaring. For example "French" is <code>fr</code> is, but "Old French" is <code>fro</code>.
* {{parameter|text}}: (Also the second unnamed parameter) The text to be displayed.
* {{parameter|direction}}: (Also <code>dir</code>) Text direction, can be <code>ltr</code> (left-to-right) or <code>rtl</code> (right-to-left).  Left-to-right is standard; right-to-left is used for languages such as Arabic and Hebrew.  If this is not set, the template will attempt to select the correct text direction based on the language parameter.
* {{parameter|font}}: Uses the webfont extension.  See [[#Web Fonts|Web Fonts]] below.
* {{parameter|style}}: The code for other optional CSS style being applied, such as <code>font-feature-setting: 'locl';</code> for localized glyph(s).
* {{parameter|class}}: Any HTML classes to apply, such as <code>class="plainlinks"</code>.
* {{parameter|attr}}: The code for other optional HTML attributes being applied

==== Internal parameters ====
This parameter is for internal use only, to distiguish between {{tl|lang}} and {{tl|lang block}}.<br />
It shall not be used directly.
* {{parameter|inline}}: The type of template:
** <code>inline=yes (default)</code> will provide an inline template (<nowiki><span> ... </span></nowiki>); this is used internally in  {{tl|lang}}.
** <code>inline=no</code> (or != yes) will provide a block template (<nowiki><div> ... </div></nowiki>); this is used internally in {{tl|lang block}}.

This parameter can be used by <code>/s</code> templates to not close the tag, but instead leave it open, e.g. for crossing a page break. 
* {{parameter|noclose}}: The type of template:
** <code>noclose=yes (default)</code> leave the tag open
** Any other value: close the tag as normal

=== Examples ===
==== Hebrew text and unnamed parameters ====
<pre>{{lang|he|ארץ זבת חלב ודבש}}</pre>
{{lang|he|ארץ זבת חלב ודבש}}

The same text without this template: ארץ זבת חלב ודבש

==== Arabic text and named parameters ====
<pre>{{lang
 | language = ar
 | text     = المدينة‎
 | dir      = rtl
}}</pre>
{{lang
 | language = ar
 | text     = المدينة‎
 | dir      = rtl
}}

==== Arabic text and non-standard web font ====
<pre>{{lang|ar|المدينة‎|font=Amiri}}</pre>
{{lang|ar|المدينة‎|font=Amiri}}

==== Burmese text and different web fonts ====
<pre>{{lang|my|အကူအညီ}}</pre>
{{lang|my|အကူအညီ}}
<pre>{{lang|my|အကူအညီ|font=Padauk-Regular}}</pre>
{{lang|my|အကူအညီ|font=Padauk-Regular}}
<pre>{{lang|my|အကူအညီ|font=Yunghkio}}</pre>
{{lang|my|အကူအညီ|font=Yunghkio}}

==== English text (Latin script) with web font ====
<pre>{{lang|text=Lorem ipsum|font=Rufscript}}</pre>
{{lang|text=Lorem ipsum|font=Rufscript}}
<pre>{{lang|text=Lorem ipsum|font=Ubuntu}}</pre>
{{lang|text=Lorem ipsum|font=Ubuntu}}
<pre>{{lang|text=Lorem ipsum|font=UnifrakturMaguntia}}</pre>
{{lang|text=Lorem ipsum|font=UnifrakturMaguntia}}
<pre>{{lang|en|Lorem ipsum|font=Linux Libertine}}</pre>
{{lang|en|Lorem ipsum|font=Linux Libertine}}

=== Language attribute ===
As stated under parameters, the language should be set with an [[w:ISO 639|ISO 639]] language code.

However, if necessary, this can be specified even further with an [[w:ISO 15924|ISO 15924]] script code and/or an [[w:ISO 3166-1|ISO 3166-1]] country code.  Script codes can be used if the text is in a script other than that associated with the language.  Country codes can be used to specify the text's country of origin.

{| class="wikitable" {{ts|mc}}
! Use || Text || Attribute || Code || Notes
|-
| [[w:ISO 639|Language]] || {{lang|el|Χαίρε, ω χαίρε Ελευθεριά!}} || el || <code><nowiki>{{lang|el|Χαίρε, ω χαίρε Ελευθεριά!}}</nowiki></code> || Greek text. "el" = Greek language.
|-
| [[w:ISO 15924|Script]] || {{lang|el-Latn|Haire, o haire, Eleftheria!}} || el-Latn || <code><nowiki>{{lang|el-Latn|Haire, o haire, Eleftheria!}}</nowiki></code> || Transliterated into Latin script. "Latn" = Latin script.
|-
| [[w:ISO 3166-1|Country]] || {{lang|el-GR|Χαίρε, ω χαίρε Ελευθεριά!}} || el-GR || <code><nowiki>{{lang|el-GR|Χαίρε, ω χαίρε Ελευθεριά!}}</nowiki></code> || Greek origin. "GR" = Greece.
|-
| Script & Country || {{lang|el-Latn-GR|Haire, o haire, Eleftheria!}} || el-Latn-GR || <code><nowiki>{{lang|el-Latn-GR|Haire, o haire, Eleftheria!}}</nowiki></code> || Greek language in Latin script from Greece.
|-
! colspan="5" | See [[w:IETF language tag|IETF language tag]] on Wikipedia for more information.
|}

=== Web Fonts ===
This template makes use of the [[mw:Extension:UniversalLanguageSelector|Universal Language Selector extension]] installed on this project.  This extension allows for the proper display of languages where the standard font is either unavailable or of insufficient quality.

The <code>language</code> parameter will determine which font is used.  In some cases, multiple fonts are available; the preferred font can be selected with the <code>font</code> parameter.  If the <code>font</code> parameter is not used, the default font for that language will be selected. Currently no support for mobile devices.

{| class="wikitable sortable" {{ts|mc}}
|-
! Language || ISO-639 || Fonts
|-
| [[w:Khandeshi languages|Ahirani]] || ahr || Lohit Devanagari
|-
| [[w:Akkadian language|Akkadian]] || akk || Akkadian
|-
| [[w:Amharic language|Amharic]] || am || Abyssinica SIL
|-
| rowspan="3" | [[w:Arabic language|Arabic]] (Naskh script) || rowspan="3" | ar || Amiri
|-
| Scheherazade
|-
| Lateef
|-
| [[w:Nastaʿlīq script|Nastaʿlīq script]] (Aran) || || Hussaini Nastaleeq
|-
| [[w:Assamese language|Assamese]] || as || Lohit Assamese
|-
| [[w:Bengali language|Bengali]] || bn || Lohit Bengali, Siyam Rupali
|-
| [[w:Bhojpuri language|Bhojpuri]] || bh || Lohit Devanagari
|-
| [[w:Bishnupriya Manipuri language|Bishnupriya Manipuri]] || bpy || Lohit Bengali
|-
| [[w:Buginese language|Buginese]] || bug || Saweri<!--for Lontara script-->
|-
| rowspan="4" | [[w:Burmese language|Burmese]] || rowspan="4" | my || Padauk-Regular
|-
| Myanmar3
|-
| TharLon
|-
| Yunghkio
|-
| [[w:Dzongkha|Dzongkha]] || dz || Jomolhari
|-
| [[w:Gujarati language|Gujarati]] || gu || Lohit Gujarati
|-
| rowspan="3" | [[w:Hebrew language|Hebrew]] || rowspan="3" | he ||Alef
|-
| Miriam CLM
|-
| Taamey Frank CLM
|-
| [[w:Biblical Hebrew|Biblical Hebrew]] || hbo || Taamey Frank CLM
|-
| rowspan="2" | [[w:Standard Hindi|Hindi]] || rowspan="2" | hi ||Lohit Devanagari
|-
| Samyak Devanagari
|-
| rowspan="2" | [[w:Kannada|Kannada]] || rowspan="2" | kn || Lohit Kannada
|-
| Kedage
|-
| [[w:Khmer language|Khmer]] || km || Hanuman, KhmerOSbattambang, KhmerOS, Nokora, Suwannaphum
|-
| [[w:Konkani language|Konkani]] || kok || Lohit Devanagari
|-
| rowspan="9" | [[w:Latin script|Latin script]] (Latn) || rowspan="9" | &nbsp; || Charis SIL
|-
| ComicNeue
|-
| Doulos SIL
|-
| Gentium Plus
|-
| Junicode
|-
| Linux Libertine
|-
| RailwaySans
|-
| Rufscript
|-
| Ubuntu
|-
| [[w:Fraktur|Latin fraktur script]] (Latf) || &nbsp; || UnifrakturMaguntia
|-
| [[w:Makassarese language|Makassarese]] || mak || Saweri<!--for Lontara script-->
|-
| rowspan="3" | [[w:Malayalam|Malayalam]] || rowspan="3" | ml || AnjaliOldLipi
|-
| Meera
|-
| RaghuMalayalam
|-
| [[w:Maithili language|Maithili]] || mai || Lohit Devanagari
|-
| rowspan="2" | [[w:Marathi language|Marathi]] || rowspan="2" | mr || Lohit Devanagari
|-
| Samyak Devanagari
|-
| rowspan="2" | [[w:Min Dong|Min Dong Chinese]] || rowspan="2" | cdo || Charis SIL
|-
| Doulos SIL
|-
| rowspan="2" | [[w:Oriya language|Oriya]] (Odia) || rowspan="2" | or || Lohit Oriya
|-
| Utkal
|-
| rowspan="2" | [[w:Punjabi language|Punjabi]] || rowspan="2" | pa || Lohit Punjabi
|-
| Saab
|-
| rowspan="2" | [[w:Persian language|Persian]] (Farsi) || rowspan="2" | fa || IranianSans
|-
| IranianSerif
|-
| [[w:Saurashtra language|Sourashtra]] || saz || Pagul
|-
| [[w:Sanskrit|Sanskrit]] || sa || Lohit Devanagari, Samyak Devanagari
|-
| rowspan="3" | [[w:Tamil language|Tamil]] || rowspan="3" | ta || Lohit Tamil
|-
| Thendral
|-
| Thenee
|-
| rowspan="3" | [[w:Telugu language|Telugu]] || rowspan="3" | te || Lohit Telugu
|-
| Pothana2000
|- 
| Vemana2000
|-
| [[w:Standard Tibetan|Tibetan]] || bo || BabelStone Tibetan Slim
|-
| [[w:Tigrinya language|Tigrinya]] || ti || Abyssinica SIL
|-
| [[w:Yi language|Yi]] || yi || Nuosu SIL
|-
! colspan="3" | See [https://phabricator.wikimedia.org/diffusion/EULS/browse/master/data/fontrepo/ here] for a list of all available fonts.
|}

=== Language tagging ===
Texts on Wikisource should be tagged to specify the language in a machine readable format.  All pages on English Wikisource are automatically tagged as "English".  Any piece of text that is not in English should be tagged as such with this template or one of its derivatives.

[[meta:Language tagging|Language tagging]] on Meta-Wiki explains the best practice of language tagging.

=== Blocks split across pages ===
For blocks in a different language split across multiple pages, use {{tl|lang block/s}} to begin the block and {{tl|lang block/e}} to end it. {{tl|lang block/s}} takes the same parameters as <nowiki>{{lang}}</nowiki> except for {{para|inline}}, which is fixed as "no".

=== See also ===
* {{tl|el}} & {{tl|greek}} 
* {{tl|hebrew}}, {{tl|Lang-he}} & {{tl|GHGheb}}
* {{tl|syriac}} & {{tl|Lang-syc}}
* {{tl|arabic}} & {{tl|Lang-ara}}
* {{tl|japanese}}
* {{tl|armenian}}
* {{tl|Lang-hbo}}
* {{tl|Lang-sux}}
* {{tl|Insular}}
* {{t1|ISO 639 name}}
* {{tl|blackletter}}

<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Internationalization templates]]
[[Category:Typography templates]]

[[fr:Modèle:Lang]]
[[ja:Template:Lang]]
[[ru:Шаблон:Lang]]
[[zh:模板:Lang]]
</includeonly>
<templatedata>
{
	"params": {
		"language": {
			"aliases": [
				"lang",
				"1"
			],
			"label": "language",
			"description": "The code for the language being displayed, using ISO 639. ",
			"type": "string",
			"required": true
		},
		"text": {
			"aliases": [
				"2"
			],
			"label": "text",
			"description": "The text to be displayed.",
			"type": "string",
			"required": true
		},
		"inline": {
			"label": "inline",
			"description": "Determines if a span or block is generated.",
			"type": "boolean"
		},
		"font": {},
		"fonts": {},
		"style": {},
		"class": {},
		"attr": {},
		"noclose": {},
		"direction": {},
		"dir": {}
	}
}
</templatedata>