Изворни код странице Шаблон:Јез/док

{{documentation subpage}}
Сврха овог шаблона је да означи да дати текст припада одређеном језику (в. [[Списак ISO 639-1 кодова|језички кодови]]):
:<code><nowiki>{{јез|језички код|текст}}</nowiki></code>

Употребити [[Списак ISO 639 кодова|-{ISO}- 639 језичке кодове]]. На пример (<tt>-{fr}-</tt> је код за [[француски језик]]):
:<code><nowiki>* Она рече: „{{јез|fr|''Je suis française.''}}”</nowiki></code>
у прегледачу даје:
* Она рече: -{„{{lang|fr|''Je suis française.''}}”}-

Такође постоје и верзије овог шаблона за сваки језик, које које служе за исписивање имена самог језика (користити када се језик појави у чланку први пут). На пример, <code><nowiki>{{tlx|јез-шпа|-{español}-}}</nowiki></code> и <code><nowiki>{{tlx|јез-рус|-{русский язык}-}}</nowiki></code> даје „{{јез-шпа|español}}” и „{{јез-рус|русский язык}}” (без наводника).

== Означавање врсте писма ==
=== Одређени језици ===
==== Ћирилички (<tt>-{Cyrl}-</tt>) и латинички (<tt>-{Latn}-</tt>) кодови ====
Ако је потребно, додати [[Списак ISO 15924 кодова|-{ISO}- 15924]] код да би се означило писмо.

На пример, [[руски језик]] је обично писан у [[ћирилица|ћирилици]], зато је код <tt>-{Cyrl}-</tt> за писмо сувишан и језички код ће бити <tt>-{ru}-</tt> уместо <tt>-{ru-Cyrl}-</tt>. Међутим, када је тај текст [[транслитерација]] онда код <tt>-{Latn}-</tt> (латиница) треба се користити јер то није обично писмо за руски језик: <tt>-{ru-Latn}-</tt>. На пример:
:<code><nowiki>* Москва ([[руски језик|рус.]] {{јез|ru|''Москвá''}}, {{јез|ru-Latn|''Moskva''}})</nowiki></code>
је исто као:
:<code><nowiki>* Москва ({{јез-рус|Москвá}}, {{јез|ru-Latn|''Moskva''}})</nowiki></code>

Резултат у вашем прегледачу:
* -{Москва ([[руски језик|рус.]] {{јез|ru|''Москвá''}}, {{јез|ru-Latn|''Moskva''}})}-
* -{Москва ({{јез-рус|Москвá}}, {{јез|ru-Latn|''Moskva''}})}-

Такође, <code><nowiki>{{јез|ru-Latn|''Moskva''}}</nowiki></code> је исто што и <code><nowiki>{{transl|ru|''Moskva''}}</nowiki></code>.

==== Транслитерација ћирилице (-{ISO}- / -{ISO}- 9) ====
Да би се означила употреба [[ISO 9|-{ISO}- 9]] транслитерације ћирилице, употребити <code><nowiki>{{transl|ru|ISO|''Moskva''}}</nowiki></code>. На пример:
:<code><nowiki>* Москва ({{јез-рус|Москвá}}, [[ISO 9|-{ISO}- 9]]: {{transl|ru|ISO|''Moskva''}})</nowiki></code>
у прегледачу даје:
* -{Москва ({{јез-рус|Москвá}}, [[ISO 9|-{ISO}- 9]]: {{transl|ru|ISO|''Moskva''}})}-

==== Одабир писма ({{tl|rtl-lang}}) ====
[[Internet Assigned Numbers Authority|-{IANA}-]] одржава листу наводећи када ознака писма треба бити потиснута (в. [http://www.iana.org/assignments/language-subtag-registry]). У неким сличајевима писмо треба увек бити наведено, као што је то случај са [[таџички језик|таџичким језиком]] који може бити писан поједнако у [[арапски алфабет|арапском алфабету]], [[латиница|латиници]] и [[ћирилицa|ћирилици]]. На пример:
:<code><nowiki>* Таџички ({{rtl-lang|tg-Arab|تاجیکی}}, {{јез|tg-Latn|''tojikī''}}, {{јез|tg-Cyrl|тоҷикӣ}})</nowiki></code>
у прегледачу даје:
* Таџички ({{rtl-lang|tg-Arab|تاجیکی}}, {{јез|tg-Latn|''tojikī''}}, {{јез|tg-Cyrl|тоҷикӣ}})
Уочити употребу {{tl|rtl-lang}} уместо {{tl|јез}} када се употребљава арапско писмо (в. [[#Смер писања|смер писања]]).

=== Неодређени језици ===
Шаблон {{tl|јез}} се употребљава не само када се наводи језик страних речи, већ и када се наводи један симбол или слово из одређеног писма, на пример када се разговара о одређеном систему писања. Много пута се слово/симбол употребљава у неколико језика, али кад се чланак односи на саму [[графема|графему]] употребљава се [[ISO 639-2|-{ISO}- 639-2]] и [[ISO 639-3|-{ISO}- 639-3]] језички код <tt>-{und}-</tt> за неодређени језик. На пример:
:<code><nowiki>* {{јез|und-Hani|字}} кинеско слово има 6 потеза.</nowiki></code>
у прегледачу даје:
* -{{{lang|und-Hani|字}} кинеско слово има 6 потеза.}-

Кинеска слова се употребљавају у кинеском, јапанском, некада корејском, а у прошлости и вијетнамском; у овом случају слово се не употребљава за спечифичан језик. Уочити да код за писмо <tt>-{Hani}-</tt> одређује општа кинеска слова (ханџи, канђи, ханђа).

==== Одабир писма ({{tl|script}}) ====
Упоредити са коришћењем {{tl|script}} синтаксе:
:<code><nowiki>* {{script|Hani|字}} кинеско слово има 6 потеза.</nowiki></code>
у прегледачу даје:
* -{{{script|Hani|字}} кинеско слово има 6 потеза.}-

=== Означавање регионалне варијанте ===
У неким случајевима потребно је додати [[ISO 3166-1 alpha-2|-{ISO}- 3166-1 -{alpha}--2]] код за државу (специфична употреба те земље). Наравно, три кода се могу појавити у истом коду (тагу, ознаци); на пример, код <tt>-{zh-Hant-TW}-</tt> ће бити употребљен за текст [[кинески језик|кинеског језика]] писан [[традиционално кинеско писмо|традиционалним кинеским знаковима]], који садржи речи или изразе специфиче за [[Тајван]]. На пример:
:<code><nowiki>* {{јез|zh-Hant-TW|臺灣}}</nowiki></code>
у прегледачу даје:
* {{јез|zh-Hant-TW|臺灣}}

=== Смер писања ===
{{tl|rtl-lang}} је специфичан шаблон за језике који се пишу здесна налево, као што је то случај са [[арапски језик|арапским]] или [[хебрејски језик|хебрејским језиком]].

За пасусе који треба цели да се испишу здесна налево, употребити шаблон {{tl|rtl-para}}. Префикс <code>rtl-</code> није потребан ако се користи облик <code>{{tlx|lang-xx}}</code>, јер је његова функција условљења самим језиком; на пример, <code>{{tlx|rtl-lang-ar}}</code> не постоји, већ само <code>{{tlx|lang-ar}}</code>.

== Зашто употребљавати шаблон ==
* [[Интернет прегледач]]и могу користити одговарајуће [[:Категорија:Шаблони за језике|шаблоне за језике]] да изаберу жељени фонт.
** Ово је одлично за кинески, јапански и корејски језик, где карактер може имати свој одређен језички облик, али ће одступити од истог ако се не нађе одговарајући фонт или ако жељени фонт нема слово које треба да се прикаже; на пример, јер језик не користи тај знак.
* Због [[Приступачност вебу|приступачности вебу]], [[читачи екрана]] морају имати информацију о језику на којем је одређена реч написана да би се остварила тачна звучна репродукција садржаја.
* Неопходно за [[алатке за проверу правописа]] (спеловање и граматика).
* Гугл и други [[Претраживач веба|претраживач]]и могу користити информацију о језику када [[индексирање (претраживач веба)|индексирају]] текст.
* Може бити корисно за [[програмер]]е који штампају Википедију.
* Може бити корисно за истраживање или [[Компилатор|компилирање]] статистике о коришћењу језикā на Википедији.

== TemplateData ==
<templatedata>
{
	"params": {
		"1": {
			"aliases": [
				"code",
				"language_code"
			],
			"label": "Језички код",
			"description": "Језички код језика на којем се налази доленаведени текст.",
			"example": "fr",
			"type": "string",
			"required": true,
			"suggested": true
		},
		"2": {
			"aliases": [
				"text"
			],
			"label": "Текст",
			"description": "Текст на горенаведеном језику.",
			"example": "Je suis française.",
			"type": "string",
			"required": true,
			"suggested": true
		}
	},
	"description": "Овај шаблон се користи за приказивање текста са другог језика у зависности од језичког кода.",
	"format": "inline"
}
</templatedata>

== Види још ==
* [[Списак ISO 639-1 кодова|Списак -{ISO}- 639-1 кодова]] (језички кодови)
* [[Списак ISO 15924 кодова|Списак -{ISO}- 15924 кодова]] (кодови за писмо)
* [[Списак ISO транслитерација|Списак -{ISO}- транслитерација]] (кодови за транслитерацију)

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

<includeonly>
<!-- МОЛИМ ДОДАВАТИ КАТЕГОРИЈЕ ИСПОД ОВЕ ЛИНИЈЕ -->
[[Категорија:Шаблони за језике|{{PAGENAME}}]]
</includeonly>