Редактирование: Шаблон:Lang/doc (раздел)

== Выбор шаблона ==
Шаблон '''{{Tl|Lang}}''' входит в систему языковых шаблонов, используемых для оформления иноязычных фрагментов внутри русского текста статей (и наоборот). Большинство языковых шаблонов построены на базе шаблонов {{Tl|Lang}} и {{Tl|Langi}} — при этом {{Tl|Langi}} отличается от {{Tl|Lang}} тем, что текст в нём отображается ''[[курсив]]ом''.<!--
-->{{#ifeq: {{PAGENAME}}
| Lang-ru
| <br><br>{{Ombox|text=
'''<span style="color:red;">Внимание!</span> Не используйте шаблон {{Tl|Lang-ru}} для указания перевода иноязычных терминов,''' как в этом случае: <span style="color:#bb0000;">word ({{Lang-ru|слово}})</span>. Указанию подлежит язык источника, а язык перевода — русский — и так всем известен, ведь это русская Википедия! Для указания перевода вместе с языком источника вы можете воспользоваться шаблоном из семейства '''{{Tl|Tr}}''', чтобы получить строку наподобие <span style="color:#009900;">word ({{Tr-en|слово}})</span>. Либо, если язык источника интуитивно ясен, можно просто написать перевод в кавычках: <span style="color:#009900;">word («слово»)</span>.}}<br>
}}

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

<!---------------------------------------------------
первые два фрагмента отображаются только при включении документации в шаблоны «Lang-nn»/«Lang-nn2»
третий фрагмент отображается в всех остальных случаях
----------------------------------------------------->{{#ifeq: {{Str left|{{Lcfirst:{{#titleparts: {{PAGENAME}} | 1 | 1 }}}}|5}}
| lang-
| {{#ifeq: {{Str right|{{Lcfirst:{{#titleparts: {{PAGENAME}} | 1 | 1 }}}}|{{#expr: {{Str len|{{Lcfirst:{{#titleparts: {{PAGENAME}} | 1 | 1 }}}}}} - 1 }}}}
  | 2
  | Для оформления '''первого''' вхождения на данном языке в статье или разделе статьи следует использовать шаблон '''{{Tl|{{Str left|{{Lcfirst:{{#titleparts: {{PAGENAME}} | 1 | 1 }}}}|{{#expr: {{Str len|{{Lcfirst:{{#titleparts: {{PAGENAME}} | 1 | 1 }}}}}} - 1 }}}}}}'''. Для оформления '''последующих''' вхождений на том же языке (если в статье или разделе нет иноязычных вставок на других языках) следует использовать '''этот шаблон {{Tl|{{Lcfirst:{{#titleparts: {{PAGENAME}} | 1 | 1 }}}}}}'''.
  | Этот шаблон '''{{Tl|{{Lcfirst:{{#titleparts: {{PAGENAME}} | 1 | 1 }}}}}}''' используется для оформления '''первого''' вхождения на данном языке в статье или разделе статьи. Для оформления '''последующих''' вхождений на том же языке (если в статье или разделе нет иноязычных вставок на других языках) следует использовать шаблон '''{{Tl|{{Lcfirst:{{#titleparts: {{PAGENAME}} | 1 | 1 }}}}2}}'''.
  }}
| Для оформления '''первого''' иноязычного вхождения в статье или разделе статьи следует использовать шаблон вида '''{{Tl|Lang-nn|nolink}}''' (где ''nn'' — код языка). Для оформления '''последующих''' вхождений на том же языке (если в статье или разделе нет иноязычных вставок на других языках) следует использовать шаблон '''{{Tl|Lang-nn2|nolink}}'''.
}}

=== Когда не использовать ===
* Не надо '''оборачивать''' данными шаблонами ''русский перевод'' с указанного языка. Для этого используйте шаблон из семейства {{Tl|Tr}}. [[Транслитерация]] может быть другим случаем, см. {{Lang|en|[[:en:Template:Lang/doc#Indicating writing script]]}} и раздел «[[#См. также|См. также]]» ниже.
* В заголовках (мешает ссылкам на такие разделы).
* В шаблонах типа {{Tl|Cite web}}, {{Tl|Книга}} и др., если текст атрибута используется в ссылке. С осторожностью — в {{Tl|Карточка|text=карточках}}: ссылки от них могут быть не очень заметны.
* Шаблоны, в которых текст выводится курсивом, не следует использовать, когда курсив не нужен (см. [[ВП:Оформление статей#Курсив]]). Используйте шаблон {{Tlp|Lang|''код языка''|''текст''}}.
<!-- всё, что в шаблоне (кроме добавляемого шаблонами типа {{Tl|Lang-NN}} сокращённого русского названия языка), должно быть на указанном языке, включая текст {{Нп3|Атрибут (языки разметки)|атрибутов HTML|en|HTML attribute}} вроде ''title'' (такой случай можно обойти с помощью нескольких указаний языков). -->