Шаблон:Lang/doc

Не следует путать с шаблоном tr — шаблоном для указания перевода иностранного слова на русский.

Шаблон {{Lang/doc}} используется для оформления первого вхождения фрагмента на данном языке внутри русского текста статей. Для вывода без видимого указания названия языка, а также последующих вставок иноязычного текста следует использовать шаблон {{Lang/doc2}}. Для каждого из языков существует свой шаблон вида {{lang-xx}}, где «xx» — код языка по стандарту ISO 639.

Выбор шаблона

Шаблон {{lang}} входит в систему языковых шаблонов, используемых для оформления иноязычных фрагментов внутри русского текста статей (и наоборот). Большинство языковых шаблонов построены на базе шаблонов {{lang}} и {{langi}} ({{langi}} отличается от {{lang}} тем, что текст в нём отображается курсивом).

Как правило, нет необходимости использовать шаблон {{lang}} или {{langi}} напрямую. Для каждого из языков существует свой шаблон, построенный на основе упомянутых. Названия таких шаблонов состоят из приставки «lang-» и кода языка в соответствии с стандартом ISO 639-1. Первым и, как правило, единственным параметром является текст на этом языке.

Для оформления первого иноязычного вхождения в статье или разделе статьи следует использовать шаблон вида {{lang-nn}} (где nn — код языка). Для оформления последующих вхождений на том же языке (если в статье или разделе нет иноязычных вставок на других языках) следует использовать шаблон {{lang-nn2}}.

Когда не использовать

• Не надо оборачивать данными шаблонами русский перевод с указанного языка. Для этого используйте шаблон из семейства {{tr}}. Транслитерация может быть другим случаем, см. en:Template:Lang/doc#Indicating writing script и раздел «См. также» ниже.
• В заголовках (мешает ссылкам на такие разделы).
• В шаблонах типа {{cite web}}, {{книга}} и др., если текст атрибута используется в ссылке. С осторожностью — в {{карточках}}: ссылки от них могут быть не очень заметны.
• Шаблоны, в которых текст выводится курсивом, не следует использовать, когда курсив не нужен (см. ТП:Оформление статей#Курсив). Используйте шаблон {{lang|код языка|текст}}.

Некоторые коды языков

Языковые шаблоны постоянно пополняются новыми, поэтому для поиска необходимого шаблона лучше всего просмотреть основную для всех языковых шаблонов категорию «Шаблоны lang-x». В этой таблице для иллюстрации приведены наиболее употребительные в русском разделе Википедии языковые шаблоны (более 500 включений).

Язык	Код	Шаблон	Результат	См. также, примечания
Английский язык	en	{{lang-en|текст}}	англ. текст	Lang-en Lang-en2
Немецкий язык	de	{{lang-de|текст}}	Шаблон:Lang-de
Французский язык	fr	{{lang-fr|текст}}	фр. текст	Lang-fr
Латынь	la	{{lang-la|текст}}	лат. текст	Lang-la
Испанский язык	es	{{lang-es|текст}}	Шаблон:Lang-es
Украинский язык	uk	{{lang-uk|текст}}	Шаблон:Lang-uk
Итальянский язык	it	{{lang-it|текст}}	Шаблон:Lang-it
Португальский язык	pt	{{lang-pt|текст}}	Шаблон:Lang-pt
Польский язык	pl	{{lang-pl|текст}}	Шаблон:Lang-pl
Русский язык	ru	{{lang-ru|текст}}	оьрс. текст	Для др.-рус. языка используется {{lang-orv}}, церк.-слав. — {{lang-chu}}, ст.-слав. — {{lang-cu}} Lang-ru
Башкирский язык	ba	{{lang-ba|текст}}	Шаблон:Lang-ba
Греческий язык	el	{{lang-el|текст}}	Шаблон:Lang-el	Для древнегреческого языка используется {{lang-grc}}
Древнегреческий язык	grc	{{lang-grc|текст}}	Шаблон:Lang-grc	Для современного греческого языка используется {{lang-el}} Lang-grc2 Lang-grc2/doc
Среднегреческий язык	gkm	{{lang-gkm|текст}}	Шаблон:Lang-gkm
Болгарский язык	bg	{{lang-bg|текст}}	Шаблон:Lang-bg
Грузинский язык	ka	{{lang-ka|текст}}	Шаблон:Lang-ka
Японский язык	ja	{{lang-ja|текст}}	Шаблон:Lang-ja
Нидерландский язык	nl	{{lang-nl|текст}}	Шаблон:Lang-nl
Иврит	he	{{lang-he|текст}}	Шаблон:Lang-he
Белорусский язык	be	{{lang-be|текст}}	Шаблон:Lang-be
Шведский язык	sv	{{lang-sv|текст}}	Шаблон:Lang-sv
Финский язык	fi	{{lang-fi|текст}}	Шаблон:Lang-fi
Армянский язык	hy	{{lang-hy|текст}}	Шаблон:Lang-hy
Латышский язык	lv	{{lang-lv|текст}}	Шаблон:Lang-lv
Арабский язык	ar	{{lang-ar|текст}}	араб. текст‎	Lang-ar Lang-ar-com Lang-ar-шрифт Lang-ar-шрифт/doc Lang-ar2
Китайский язык	zh	{{lang-zh|текст}}	кит. текст	Lang-zh Lang-zh/doc
Азербайджанский язык	az	{{lang-az|текст}}	Шаблон:Lang-az
Турецкий язык	tr	{{lang-tr|текст}}	Шаблон:Lang-tr
Литовский язык	lt	{{lang-lt|текст}}	Шаблон:Lang-lt
Венгерский язык	hu	{{lang-hu|текст}}	Шаблон:Lang-hu
Норвежский язык	no	{{lang-no|текст}}	Шаблон:Lang-no	Lang-noh
Сербский язык	sr	{{lang-sr|текст}}	Шаблон:Lang-sr
Чешский язык	cs	{{lang-cs|текст}}	Шаблон:Lang-cs
Эстонский язык	et	{{lang-et|текст}}	Шаблон:Lang-et
Ирландский язык	ga	{{lang-ga|текст}}	Шаблон:Lang-ga
Румынский язык	ro	{{lang-ro|текст}}	Шаблон:Lang-ro
Молдавский язык	mo	{{lang-mo|текст}}	Шаблон:Lang-mo
Крымско-татарский язык	crh	{{lang-crh|текст}}	Шаблон:Lang-crh
Датский язык	da	{{lang-da|текст}}	Шаблон:Lang-da
Каталанский язык	ca	{{lang-ca|текст}}	Шаблон:Lang-ca
Хорватский язык	hr	{{lang-hr|текст}}	Шаблон:Lang-hr
Персидский язык (фарси)	fa	{{lang-fa|текст}}	перс. текст‎	Lang-fa Lang-fa2
Санскрит	sa	{{lang-sa|текст}}	Шаблон:Lang-sa
Словацкий язык	sk	{{lang-sk|текст}}	Шаблон:Lang-sk
Индонезийский язык	id	{{lang-id|текст}}	Шаблон:Lang-id
Корейский язык (пхёджуно)	ko	{{lang-ko|текст}}	Шаблон:Lang-ko
Корейский язык (мунхвао)	ko-kp	{{lang-ko-kp|текст}}	Шаблон:Lang-ko-kp
Чеченский язык	ce	{{lang-ce|текст}}	нох. текст	Lang-ce
Осетинский язык	os	{{lang-os|текст}}	Шаблон:Lang-os
Исландский язык	is	{{lang-is|текст}}	Шаблон:Lang-is
Монгольский язык	mn	{{lang-mn|текст}}	Шаблон:Lang-mn
Хинди	hi	{{lang-hi|текст}}	Шаблон:Lang-hi
Татарский язык	tt	{{lang-tt|текст}}	Шаблон:Lang-tt
Баскский язык	eu	{{lang-eu|текст}}	Шаблон:Lang-eu
Валлийский язык	cy	{{lang-cy|текст}}	Шаблон:Lang-cy
Македонский язык	mk	{{lang-mk|текст}}	Шаблон:Lang-mk
Узбекский язык	uz	{{lang-uz|текст}}	Шаблон:Lang-uz
Словенский язык	sl	{{lang-sl|текст}}	Шаблон:Lang-sl
Казахский язык	kk	{{lang-kk|текст}}	Шаблон:Lang-kk
Албанский язык	sq	{{lang-sq|текст}}	Шаблон:Lang-sq
Малайский язык	ms	{{lang-ms|текст}}	Шаблон:Lang-ms
Гэльский язык	gd	{{lang-gd|текст}}	Шаблон:Lang-gd
Тамильский язык	ta	{{lang-ta|текст}}	Шаблон:Lang-ta

Любой непомеченный текст «получает» язык окружающего, для всей статьи это русский. Если язык указать необходимо, так как он отличается от языка окружающих слов, но вы не знаете, что это за язык, укажите пустой код: {{lang||текст}}. Существуют также специальные коды для языков совсем без кода, и для текста вообще ни на каком языке. Но в случае сомнений лучше этим не злоупотреблять: например, латинские цифры «XVII» в русском выражении обычно читаются как «семнадцать», а чтение их на латыни собьёт читателей с толку.

Для чего это нужно

• Имея информацию о языке, веб-браузеры могут выбирать шрифт, наиболее подходящий для указанного языка.
  • В японском, китайском, корейском и вьетнамском есть символы (иероглифические ключи), которые в Юникоде обозначаются одинаково, но в разных языках могут выглядеть по-разному. Примеры: первый пример, второй пример.
• Программы для озвучивания текста для людей с нарушениями зрения могут использовать эту информацию для проговаривания разных частей текста на нужном языке.
• Для программ проверки грамматики и орфографии.
• Пользователи могут применять к тексту CSS-стили по языку.
• Браузер может выбирать подходящие кавычки, а также подходящие правила переноса и соединения букв в лигатуры.
• Поисковые системы могут использовать информацию о языке при индексировании.
• Для статистики об использовании языков в Википедии.

Индивидуальные стили

Можно применять стили CSS в своей пользовательской таблице стилей. Зарегистрированные пользователи могут помещать стили в Участник: имя_участника/monobook.css.

Данные примеры могут работать по разному, в зависимости от вашего браузера.

Пример: применить шрифт к тексту на французском языке («|=» — «даже если после кода стоит „-“ или другие символы»):

  span[lang|=fr] { font-family: Garamond; }
  /* Синоним (код языка обязателен) */
  span:lang(fr) { font-family: Garamond; }

Пример: сделать зелёным текст, помеченный как на каком-либо языке (так как почти все части страницы имеют lang="ru", для практического применения может понадобиться более сложный селектор):

  span[lang] { color: green; }

Для межъязыковых ссылок

Вы можете использовать коды языков для персонального оформления блока «На других языках» в левом меню. Для выделения определённого языка можно использовать примерно такой CSS-код:

/* Выделяем жирным нужные нам языки */
li.interwiki-en, /* английский */
li.interwiki-simple, /* упрощённый английский */
li.interwiki-uk /* украинский */
 {
font-weight:bold;
text-shadow: 2px 1px 2px #a0a0a0; /* Тень */
}

Для того чтобы ненужные языки сделать менее заметными:

li.interwiki-as, /* ассамский */
li.interwiki-ba, /* башкирский */
li.interwiki-bcl, /* бикольский */
li.interwiki-vo /* волапюк */
{
opacity: 0.5;
font-size: 80%;
line-height: 90%;
}

А чтобы при наведении курсора мыши на названии языка его было проще читать:

li.interwiki-en:hover, /* английский */
li.interwiki-ba:hover, /* башкирский */
li.interwiki-yi:hover, /* идиш */
li.interwiki-xal:hover, /* калмыцкий */
li.interwiki-lbe:hover, /* лакский */
li.interwiki-mhr:hover, /* луговомарийский */
li.interwiki-mdf:hover /* мокшанский */
{
font-weight:bold;
opacity: 1;
font-size: 110%;
}

См. также

• {{slang}} — шаблон для использования сленга
• {{tr}} — шаблон для указания перевода
• {{transl}} — шаблон для указания языка и системы транслитерации
• {{transcription}} — шаблон для указания фонетического звучания слов (транскрипции)
• Коды языков

Параметры шаблона для визуального редактора

Шаблон для оформления текста на иностранном языке

Параметры шаблона

Параметр		Описание	Тип	Статус
текст	1	Текст на выбранном языке	Строковый (без форматирования)	обязательный

Пример: {{lang-la|bene}} → лат. bene

---

Все статьи, начинающиеся с Шаблон:Lang-