Шаблон:Lang/doc: различия между версиями
Перейти к навигации
Перейти к поиску
Maqivi (обсуждение | вклад) Нет описания правки |
Maqivi (обсуждение | вклад) Нет описания правки |
||
| (не показана 1 промежуточная версия этого же участника) | |||
| Строка 1: | Строка 1: | ||
<noinclude>{{docpage}}</noinclude> | <noinclude>{{docpage}}</noinclude> | ||
== Выбор шаблона == | == Выбор шаблона == | ||
Шаблон '''{{t}}''' входит в систему языковых шаблонов, используемых для оформления иноязычных фрагментов внутри русского текста статей (и наоборот). Большинство языковых шаблонов построены на базе шаблонов {{t|lang}} и {{t|langi}} ({{t|langi}} отличается от {{t|lang}} тем, что текст в нём отображается '' | Шаблон '''{{t}}''' входит в систему языковых шаблонов, используемых для оформления иноязычных фрагментов внутри русского текста статей (и наоборот). Большинство языковых шаблонов построены на базе шаблонов {{t|lang}} и {{t|langi}} ({{t|langi}} отличается от {{t|lang}} тем, что текст в нём отображается ''курсивом'').<!-- | ||
-->{{#ifeq:{{PAGENAME}}|Lang-ru| | -->{{#ifeq:{{PAGENAME}}|Lang-ru| | ||
'''<font color=red>Внимание!</font> Не используйте шаблон {{t|lang-ru}} для указания перевода иноязычных терминов,''' как в этом случае: <font color=#BB0000>word ({{lang-ru|слово}})</font>. Указанию подлежит язык источника, а язык перевода — русский — и так всем известен, ведь это русская Википедия! Для указания перевода вместе с языком источника вы можете воспользоваться шаблоном из семейства '''{{tl|tr}}''', чтобы получить строку наподобие <font color=#009900>word ({{tr-en|слово}})</font>. Либо, если язык источника интуитивно ясен, можно просто написать перевод в кавычках: <font color=#009900>word («слово»)</font>.}} | '''<font color=red>Внимание!</font> Не используйте шаблон {{t|lang-ru}} для указания перевода иноязычных терминов,''' как в этом случае: <font color=#BB0000>word ({{lang-ru|слово}})</font>. Указанию подлежит язык источника, а язык перевода — русский — и так всем известен, ведь это русская Википедия! Для указания перевода вместе с языком источника вы можете воспользоваться шаблоном из семейства '''{{tl|tr}}''', чтобы получить строку наподобие <font color=#009900>word ({{tr-en|слово}})</font>. Либо, если язык источника интуитивно ясен, можно просто написать перевод в кавычках: <font color=#009900>word («слово»)</font>.}} | ||
Нет необходимости использовать шаблон {{t|lang}} или {{tl|langi}} напрямую. '''Для каждого из языков существует свой шаблон''', построенный на основе упомянутых. Названия таких шаблонов '''состоят из приставки «lang-» и кода языка''' в соответствии с стандартом | Нет необходимости использовать шаблон {{t|lang}} или {{tl|langi}} напрямую. '''Для каждого из языков существует свой шаблон''', построенный на основе упомянутых. Названия таких шаблонов '''состоят из приставки «lang-» и кода языка''' в соответствии с стандартом ISO 639-1. Первым и, как правило, единственным параметром является текст на этом языке. | ||
<!-- | <!-- | ||
| Строка 15: | Строка 15: | ||
|Для оформления '''первого''' вхождения на данном языке в статье или разделе статьи следует использовать шаблон '''{{t|{{str left|{{lcfirst:{{#titleparts:{{PAGENAME}}|1|1}}}}|{{#expr:{{str len|{{lcfirst:{{#titleparts:{{PAGENAME}}|1|1}}}}}}-1}}}}}}'''. Для оформления '''последующих''' вхождений на том же языке (если в статье или разделе нет иноязычных вставок на других других языках) следует использовать '''этот шаблон {{t|{{lcfirst:{{#titleparts:{{PAGENAME}}|1|1}}}}}}</span>'''. | |Для оформления '''первого''' вхождения на данном языке в статье или разделе статьи следует использовать шаблон '''{{t|{{str left|{{lcfirst:{{#titleparts:{{PAGENAME}}|1|1}}}}|{{#expr:{{str len|{{lcfirst:{{#titleparts:{{PAGENAME}}|1|1}}}}}}-1}}}}}}'''. Для оформления '''последующих''' вхождений на том же языке (если в статье или разделе нет иноязычных вставок на других других языках) следует использовать '''этот шаблон {{t|{{lcfirst:{{#titleparts:{{PAGENAME}}|1|1}}}}}}</span>'''. | ||
|Этот шаблон '''{{t|{{lcfirst:{{#titleparts:{{PAGENAME}}|1|1}}}}}}</span>''' используется для оформления '''первого''' вхождения на данном языке в статье или разделе статьи. Для оформления '''последующих''' вхождений на том же языке (если в статье или разделе нет иноязычных вставок на других других языках) следует использовать шаблон '''{{t|{{lcfirst:{{#titleparts:{{PAGENAME}}|1|1}}}}2}}'''.}} | |Этот шаблон '''{{t|{{lcfirst:{{#titleparts:{{PAGENAME}}|1|1}}}}}}</span>''' используется для оформления '''первого''' вхождения на данном языке в статье или разделе статьи. Для оформления '''последующих''' вхождений на том же языке (если в статье или разделе нет иноязычных вставок на других других языках) следует использовать шаблон '''{{t|{{lcfirst:{{#titleparts:{{PAGENAME}}|1|1}}}}2}}'''.}} | ||
|Для оформления '''первого''' иноязычного вхождения в статье или разделе статьи следует использовать шаблон вида '''<span class="wp-templatelink">{{</span>lang-nn<span class="wp-templatelink">}}</span>''' (где ''nn'' — | |Для оформления '''первого''' иноязычного вхождения в статье или разделе статьи следует использовать шаблон вида '''<span class="wp-templatelink">{{</span>lang-nn<span class="wp-templatelink">}}</span>''' (где ''nn'' — код языка). Для оформления '''последующих''' вхождений на том же языке (если в статье или разделе нет иноязычных вставок на других языках) следует использовать шаблон '''<span class="wp-templatelink">{{</span>lang-nn2<span class="wp-templatelink">}}</span>'''.}} | ||
=== Когда не использовать === | === Когда не использовать === | ||
* Не надо '''оборачивать''' данными шаблонами ''русский перевод'' с указанного языка. Для этого используйте шаблон из семейства {{tl|tr}}. | * Не надо '''оборачивать''' данными шаблонами ''русский перевод'' с указанного языка. Для этого используйте шаблон из семейства {{tl|tr}}. Транслитерация может быть другим случаем, см. {{lang|en|[[:en:Template:Lang/doc#Indicating writing script]]}} и #См. также. | ||
* В заголовках (мешает ссылкам на такие разделы). | * В заголовках (мешает ссылкам на такие разделы). | ||
* В шаблонах типа {{tl|cite web}}, если текст атрибута используется в ссылке. С осторожностью — в карточках: ссылки от них могут быть не очень заметны. | * В шаблонах типа {{tl|cite web}}, если текст атрибута используется в ссылке. С осторожностью — в карточках: ссылки от них могут быть не очень заметны. | ||
* Шаблоны, в которых текст выводится курсивом, не следует использовать, когда курсив не нужен (см. | * Шаблоны, в которых текст выводится курсивом, не следует использовать, когда курсив не нужен (см. ВП:Оформление статей#Курсив). Используйте шаблон {{tp|lang|''код языка''|''текст''}}. | ||
<!-- всё, что в шаблоне (кроме добавляемого шаблоном тип {{tl|lang-en}} сокращённого названия языка), должно быть на указанном языке, включая текст {{нп3|атрибут (языки разметки)|атрибутов HTML|en|HTML attribute}} вроде ''title'' (такой случай можно обойти с помощью нескольких указаний языков). --> | <!-- всё, что в шаблоне (кроме добавляемого шаблоном тип {{tl|lang-en}} сокращённого названия языка), должно быть на указанном языке, включая текст {{нп3|атрибут (языки разметки)|атрибутов HTML|en|HTML attribute}} вроде ''title'' (такой случай можно обойти с помощью нескольких указаний языков). --> | ||
== Некоторые коды языков == | == Некоторые коды языков == | ||
Языковые шаблоны постоянно пополняются новыми, поэтому <big>'''для поиска необходимого шаблона'''</big> лучше всего просмотреть основную для всех языковых шаблонов {{c|Шаблоны lang-x|В}}. В этой таблице для иллюстрации приведены наиболее употребительные в русском разделе Википедии языковые шаблоны (более 500 включений). | Языковые шаблоны постоянно пополняются новыми, поэтому <big>'''для поиска необходимого шаблона'''</big> лучше всего просмотреть основную для всех языковых шаблонов {{c|Шаблоны lang-x|В}}. В этой таблице для иллюстрации приведены наиболее употребительные в русском разделе Википедии языковые шаблоны (более 500 включений). | ||
{{notice|Если вы не смогли найти необходимый вам шаблон, воспользуйтесь специальным | {{notice|Если вы не смогли найти необходимый вам шаблон, воспользуйтесь специальным поиско} | ||
{{notice|Для поиска по странице нажмите | {{notice|Для поиска по странице нажмите сочетание клавиш {{клавиша|Ctrl|F}} или {{клавиша|Cmd|F}}}} | ||
{| class="wide sortable" | {| class="wide sortable" | ||
| Строка 405: | Строка 405: | ||
|} | |} | ||
Любой непомеченный текст «получает» язык окружающего, для всей статьи это русский. Если язык указать ''необходимо'', так как он отличается от языка окружающих слов, но вы не знаете, что это за язык, укажите пустой код: <nowiki>{{</nowiki>[[Шаблон:lang|lang]]<nowiki>||текст}}</nowiki>. Существуют также специальные коды для языков совсем без кода, и для текста вообще ни на каком языке.<ref>{{cite web|url=http://www.w3.org/International/questions/qa-no-language|title=Tagging text with no language|author=Richard Ishida|lang=en|publisher= | Любой непомеченный текст «получает» язык окружающего, для всей статьи это русский. Если язык указать ''необходимо'', так как он отличается от языка окружающих слов, но вы не знаете, что это за язык, укажите пустой код: <nowiki>{{</nowiki>[[Шаблон:lang|lang]]<nowiki>||текст}}</nowiki>. Существуют также специальные коды для языков совсем без кода, и для текста вообще ни на каком языке.<ref>{{cite web|url=http://www.w3.org/International/questions/qa-no-language|title=Tagging text with no language|author=Richard Ishida|lang=en|publisher=W3C|datepublished=9 фев 2015|accessdate=2 мар 2015}}</ref> Но в случае сомнений лучше этим не злоупотреблять: например, латинские цифры «XVII» в русском выражении обычно читаются как «семнадцать», а чтение их на латыни собьёт читателей с толку. | ||
== Для чего == | == Для чего == | ||
* Имея информацию о языке, веб-браузеры могут выбирать шрифт, наиболее подходящий для указанного языка. | * Имея информацию о языке, веб-браузеры могут выбирать шрифт, наиболее подходящий для указанного языка. | ||
** В японском, китайском, корейском и вьетнамском есть символы,{{уточнить}} которые в | ** В японском, китайском, корейском и вьетнамском есть символы,{{уточнить}} которые в Юникоде обозначаются одинаково, но в разных языках выглядят по-разному. Примеры: [[:en:User:Wikipeditor/CJK|первый]], [[:en:Han unification#Examples of language independent characters|второй]]. | ||
* Программы для озвучивания текста для людей с нарушениями зрения могут использовать эту информацию для проговаривания разных частей текста на нужном языке.<ref>Пример со звуком: {{cite web|url=https://developer.yahoo.com/blogs/ydn/yahoo-search-results-now-natural-language-support-7318.html|title=Yahoo! search results now with natural language support|date=13 Mar 2008|author=Chris Heilmann|work= | * Программы для озвучивания текста для людей с нарушениями зрения могут использовать эту информацию для проговаривания разных частей текста на нужном языке.<ref>Пример со звуком: {{cite web|url=https://developer.yahoo.com/blogs/ydn/yahoo-search-results-now-natural-language-support-7318.html|title=Yahoo! search results now with natural language support|date=13 Mar 2008|author=Chris Heilmann|work=Yahoo! Developer Network Blog|accessdate=28 Feb 2015|lang=en|archiveurl=http://web.archive.org/web/20090125024422/http://developer.yahoo.net/blog/archives/2008/03/yahoo_search_re.html|archivedate=25 Jan 2009|dead-url=no}}</ref> | ||
* Для программ проверки грамматики и орфографии. | * Для программ проверки грамматики и орфографии. | ||
* Пользователи могут применять к тексту | * Пользователи могут применять к тексту стили по языку. | ||
* Браузер может выбирать подходящие кавычки, подробности | * Браузер может выбирать подходящие кавычки, подробности переноса,<ref name="qa-lang-why">{{cite web|url=http://www.w3.org/International/questions/qa-lang-why|title=Why use the language attribute?|date=18 Nov 2014|authors=Richard Ishida, W3C. Previously by: Deborah Cawkwell, BBC World Service|accessdate=1 Mar 2015}}</ref> лигатур.<ref>{{cite web|url=http://www.w3.org/TR/css3-fonts/#font-variant-ligatures-prop|title=6.4 Ligatures: the font-variant-ligatures property|work=CSS Fonts Module Level 3 W3C Candidate Recommendation 3 October 2013|lang=en}}</ref> | ||
* | * Поисковые системы могут использовать информацию о языке при индексировании. | ||
* Для статистики об использовании языков в Википедии. | * Для статистики об использовании языков в Википедии. | ||
| Строка 420: | Строка 420: | ||
<!-- | <!-- | ||
You can apply | You can apply CSS styles in your user style sheet. Registered users can put styles into User:XXX/monobook.css, where ''XXX'' is the user name. | ||
These examples may work in | These examples may work in Internet Explorer 8; prior versions do not support attribute selectors. Alternatively, try another browser such as Firefox. | ||
--> | --> | ||
Пример: применить шрифт к тексту на французском языке («<code>|=</code>» — «даже если после кода стоит „<code>-</code>“ и что-то ещё»): | Пример: применить шрифт к тексту на французском языке («<code>|=</code>» — «даже если после кода стоит „<code>-</code>“ и что-то ещё»): | ||
| Строка 447: | Строка 447: | ||
==== Для межъязыковых ссылок ==== | ==== Для межъязыковых ссылок ==== | ||
Вы можете использовать | Вы можете использовать коды языков для персонального оформления блока '''«на других языках»'''. Для выделения определенного языка можно использовать примерно такой CSS код: | ||
<source lang="css"> | <source lang="css"> | ||
/* Выделяем жирным нужные нам языки */ | /* Выделяем жирным нужные нам языки */ | ||
| Строка 487: | Строка 487: | ||
== См. также == | == См. также == | ||
* Для указание перевода — используйте шаблон из семейства {{tl|tr}} | * Для указание перевода — используйте шаблон из семейства {{tl|tr}} | ||
* {{tl|transl}} — шаблон для указания языка и системы транслитерации | * {{tl|transl}} — шаблон для указания языка и системы транслитерации | ||
* Для указания фонетического звучания слов ( | * Для указания фонетического звучания слов (транскрипции) существует специальный шаблон — {{tl|transcription}} | ||
* | * Коды языков | ||
== Примечания == | == Примечания == | ||
| Строка 515: | Строка 512: | ||
<includeonly>{{#ifeq:{{PAGENAME}}|Lang||[[Категория:Шаблоны lang-x|{{str sub|{{PAGENAME}}|5|10}}]]}} | <includeonly>{{#ifeq:{{PAGENAME}}|Lang||[[Категория:Шаблоны lang-x|{{str sub|{{PAGENAME}}|5|10}}]]}} | ||
</includeonly><noinclude> | </includeonly><noinclude> | ||
[[Категория:Шаблоны:Заготовки документации]] | [[Категория:Шаблоны:Заготовки документации]] | ||
</noinclude> | </noinclude> | ||
Текущая версия от 18:13, 13 апреля 2022
Выбор шаблона
Шаблон {{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}}, если текст атрибута используется в ссылке. С осторожностью — в карточках: ссылки от них могут быть не очень заметны.
- Шаблоны, в которых текст выводится курсивом, не следует использовать, когда курсив не нужен (см. ВП:Оформление статей#Курсив). Используйте шаблон Шаблон:Tp.
Некоторые коды языков
Языковые шаблоны постоянно пополняются новыми, поэтому для поиска необходимого шаблона лучше всего просмотреть основную для всех языковых шаблонов Шаблон:C. В этой таблице для иллюстрации приведены наиболее употребительные в русском разделе Википедии языковые шаблоны (более 500 включений). {{notice|Если вы не смогли найти необходимый вам шаблон, воспользуйтесь специальным поиско} Шаблон:Notice
Любой непомеченный текст «получает» язык окружающего, для всей статьи это русский. Если язык указать необходимо, так как он отличается от языка окружающих слов, но вы не знаете, что это за язык, укажите пустой код: {{lang||текст}}. Существуют также специальные коды для языков совсем без кода, и для текста вообще ни на каком языке.[1] Но в случае сомнений лучше этим не злоупотреблять: например, латинские цифры «XVII» в русском выражении обычно читаются как «семнадцать», а чтение их на латыни собьёт читателей с толку.
Для чего
- Имея информацию о языке, веб-браузеры могут выбирать шрифт, наиболее подходящий для указанного языка.
- В японском, китайском, корейском и вьетнамском есть символы,Шаблон:Уточнить которые в Юникоде обозначаются одинаково, но в разных языках выглядят по-разному. Примеры: первый, второй.
- Программы для озвучивания текста для людей с нарушениями зрения могут использовать эту информацию для проговаривания разных частей текста на нужном языке.[2]
- Для программ проверки грамматики и орфографии.
- Пользователи могут применять к тексту стили по языку.
- Браузер может выбирать подходящие кавычки, подробности переноса,[3] лигатур.[4]
- Поисковые системы могут использовать информацию о языке при индексировании.
- Для статистики об использовании языков в Википедии.
Индивидуальные стили
Пример: применить шрифт к тексту на французском языке («|=» — «даже если после кода стоит „-“ и что-то ещё»):
span[lang|=fr] { font-family: Garamond; }
/* Синоним (код языка обязателен) */
span:lang(fr) { font-family: Garamond; }
Для межъязыковых ссылок
Вы можете использовать коды языков для персонального оформления блока «на других языках». Для выделения определенного языка можно использовать примерно такой 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%;
}См. также
- Для указание перевода — используйте шаблон из семейства {{tr}}
- {{transl}} — шаблон для указания языка и системы транслитерации
- Для указания фонетического звучания слов (транскрипции) существует специальный шаблон — {{transcription}}
- Коды языков
Примечания
- ↑ Richard Ishida. Tagging text with no language (англ.). W3C (9 фев 2015). Проверено 2 мар 2015.
- ↑ Пример со звуком: Chris Heilmann. Yahoo! search results now with natural language support (англ.). Yahoo! Developer Network Blog (13 Mar 2008). Проверено 28 февраля 2015. Архивировано из первоисточника 25 января 2009.
- ↑ Why use the language attribute? (18 Nov 2014). Проверено 1 марта 2015.
- ↑ 6.4 Ligatures: the font-variant-ligatures property (англ.). CSS Fonts Module Level 3 W3C Candidate Recommendation 3 October 2013.
- ↑ http://www.w3.org/TR/CSS2/selector.html#lang
- ↑ http://dev.w3.org/csswg/selectors-3/#lang-pseudo
Параметры шаблона для визуального редактора
Шаблон {{lang-xx}} используется для оформления первого вхождения фрагмента на данном языке внутри русского текста статей. Для вывода без видимого указания названия языка, а также последующих вставок иноязычного текста следует использовать шаблон {{lang-хх2}}. Для каждого из языков существует свой шаблон вида {{lang-xx}}, где «xx» — код языка по стандарту ISO 639. См. https://ru.wikipedia.org/wiki/Шаблон:Lang
| Параметр | Описание | Тип | Статус | |
|---|---|---|---|---|
| текст | 1 | Текст на выбранном языке | Строковый (без форматирования) | обязательный |