Модуль:Ru/doc: различия между версиями
Перейти к навигации
Перейти к поиску
Karaby (обсуждение | вклад) Karaby изменил модель содержимого страницы Модуль:Ru/doc с «Scribunto» на «вики-текст» |
Karaby (обсуждение | вклад) мНет описания правки |
||
| Строка 1: | Строка 1: | ||
<!-- {{module rating|p}} | |||
{{TOC right}} --> | |||
Этот модуль содержит основные функции преобразования текста для русского языка. | Этот модуль содержит основные функции преобразования текста для русского языка. | ||
| Строка 6: | Строка 8: | ||
* {{nobr|1=<code><nowiki>в {{#invoke:ru|locative|Москва}}</nowiki></code> →}} в {{#invoke:ru|locative|Москва}} | * {{nobr|1=<code><nowiki>в {{#invoke:ru|locative|Москва}}</nowiki></code> →}} в {{#invoke:ru|locative|Москва}} | ||
* {{nobr|1=<code><nowiki>в {{#invoke:ru|locative|Казань}}</nowiki></code> →}} в {{#invoke:ru|locative|Казань}} | * {{nobr|1=<code><nowiki>в {{#invoke:ru|locative|Казань}}</nowiki></code> →}} в {{#invoke:ru|locative|Казань}} | ||
Существует, однако, большая группа существительных, для которых формы предложного и местного падежей не совпадают (например: «лес» → «о | Существует, однако, большая группа существительных, для которых формы предложного и местного падежей не совпадают (например: «лес» → «о ле{{color|red|{{ударение<!--шаблоном — для читабельности вики-кода-->}}}}с{{color|red|е}}», но «в лес{{color|red|у́}}»). '''Данная функция не учитывает эти исключения — не используйте её в подобных случаях!''' | ||
* {{nobr|1=<code><nowiki>о {{#invoke:ru|locative|лес}}</nowiki></code> →}} о {{#invoke:ru|locative|лес}} | * {{nobr|1=<code><nowiki>о {{#invoke:ru|locative|лес}}</nowiki></code> →}} о {{#invoke:ru|locative|лес}} | ||
| Строка 15: | Строка 17: | ||
* {{nobr|1=<code><nowiki>{{#invoke:ru|pl|конь}}</nowiki></code> →}} {{#invoke:ru|pl|конь}} | * {{nobr|1=<code><nowiki>{{#invoke:ru|pl|конь}}</nowiki></code> →}} {{#invoke:ru|pl|конь}} | ||
Данная функция определяет [[Склонение (лингвистика)|склонение]] слова с помощью функции <code>guessdecl</code>. При необходимости (напр., когда <code>guessdecl</code> ошибается), склонение можно указать в явном виде во втором аргументе: | Данная функция определяет [[Склонение (лингвистика)|склонение]] слова с помощью функции <code>guessdecl</code> (см. [[#guessdecl|ниже]]). При необходимости (напр., когда <code>guessdecl</code> ошибается), склонение можно указать в явном виде во втором аргументе: | ||
* {{nobr|1=<code><nowiki>{{#invoke:ru|pl|пальто|0}}</nowiki></code> →}} {{#invoke:ru|pl|пальто|0}} (без второго аргумента: {{nobr|1=<code><nowiki>{{#invoke:ru|pl|пальто}}</nowiki></code> →}} ошибочно «{{#invoke:ru|pl|пальто}}») | * {{nobr|1=<code><nowiki>{{#invoke:ru|pl|пальто|0}}</nowiki></code> →}} {{#invoke:ru|pl|пальто|0}} (без второго аргумента: {{nobr|1=<code><nowiki>{{#invoke:ru|pl|пальто}}</nowiki></code> →}} ошибочно «{{#invoke:ru|pl|пальто}}») | ||
==== <code>guessdecl</code> ==== | ==== <code>guessdecl</code> ==== | ||
Определяет тип [[Склонение (лингвистика)|склонения]] (название функции — от {{lang-en|guess declension}}). Данная функция используется функцией <code>pl</code> (см. [[#pl|выше]]), если при вызове последней не задан второй параметр. Возвращаемые значения: | |||
* <code>0</code> — для несклоняемых существительных; | * <code>0</code> — для несклоняемых существительных; | ||
* <code>1</code>, <code>2</code> и <code>3</code> — для существительных I, II и {{nobr|III склонения}}, соответственно; | * <code>1</code>, <code>2</code> и <code>3</code> — для существительных I, II и {{nobr|III склонения}}, соответственно; | ||
| Строка 26: | Строка 28: | ||
'''Важно''': невозможно без использования словаря различать следующие случаи: | '''Важно''': невозможно без использования словаря различать следующие случаи: | ||
* слова {{nobr|III склонения}} (напр., «дверь») и оканчивающиеся на «ь» слова {{nobr|II склонения}} (напр., «конь»). Данная функция возвращает для таких слов значение <code>2</code>. Значение <code>3</code> возвращается только для слов, оканчивающихся на «''X''мя», где ''X'' — гласная (напр., «время»); в действительности, эти слова являются разносклоняемыми (см. статью [[Склонение (лингвистика)|Склонение]]) и склоняются по третьему склонению не во всех формах: исключение — форма творительного падежа единственного числа. | * слова {{nobr|III склонения}} (напр., «дверь») и оканчивающиеся на «ь» слова {{nobr|II склонения}} (напр., «конь»). Данная функция возвращает для таких слов значение <code>2</code>. Значение <code>3</code> возвращается только для слов, оканчивающихся на «''X''мя», где ''X'' — гласная (напр., «время»); в действительности, эти слова являются разносклоняемыми (см. статью [[Склонение (лингвистика)|Склонение]]) и склоняются по третьему склонению не во всех формах: исключение — форма творительного падежа единственного числа. | ||
* несклоняемые слова, форма которых совпадает с формой какого-либо склонения (напр., {{nobr|«пальто» /}} «озеро»). Для таких слов будет возвращаться неправильное значение <code>1</code>, <code>2</code> или <code>3</code> вместо правильного <code>0</code>. | * несклоняемые слова, форма которых совпадает с формой какого-либо склонения (напр., {{nobr|«пальто» /}} «озеро»). Для таких слов будет возвращаться неправильное значение <code>1</code>, <code>2</code> или <code>3</code> вместо правильного{{nbsp}}<code>0</code>. | ||
Примеры: | Примеры: | ||
| Строка 39: | Строка 41: | ||
* {{nobr|1=<code><nowiki>{{#invoke:ru|guessdecl|пальто}}</nowiki></code> →}} {{#invoke:ru|guessdecl|пальто}} (должно быть <code>0</code>) | * {{nobr|1=<code><nowiki>{{#invoke:ru|guessdecl|пальто}}</nowiki></code> →}} {{#invoke:ru|guessdecl|пальто}} (должно быть <code>0</code>) | ||
=== <code>o</code> | === <code>o</code> <small>''(латиницей)''</small> === | ||
Подбирает предлог о/об/обо: | Подбирает предлог о/об/обо: | ||
* {{nobr|1=<code><nowiki>{{#invoke:ru|o|том}}</nowiki></code> →}} {{#invoke:ru|o|том}} | * {{nobr|1=<code><nowiki>{{#invoke:ru|o|том}}</nowiki></code> →}} {{#invoke:ru|o|том}} | ||
| Строка 47: | Строка 49: | ||
==== <code>obo</code> ==== | ==== <code>obo</code> ==== | ||
Используется функцией <code>o</code>, для экспорта в другие скрипты, в invoke не работает. | Используется функцией <code>o</code>, для экспорта в другие скрипты, в invoke не работает. | ||
require("Module:Ru").obo("слово")<!--?--> | |||
=== <code>s</code> === | |||
< | Подбирает предлог с/со: | ||
* {{nobr|1=<code><nowiki>{{#invoke:ru|s|тем}}</nowiki></code> →}} {{#invoke:ru|s|тем}} | |||
* {{nobr|1=<code><nowiki>{{#invoke:ru|s|всем}}</nowiki></code> →}} {{#invoke:ru|s|всем}} | |||
==== <code>so</code> ==== | |||
Используется функцией <code>s</code> | |||
<noinclude> | |||
[[Категория:Модули:Документация]] | |||
</noinclude> | |||
Версия от 07:29, 2 июня 2025
Этот модуль содержит основные функции преобразования текста для русского языка.
Функции
locative
Формирует предложный падеж (препозитив), в большинстве случаев совпадающий с местным падежом (локативом):
в {{#invoke:ru|locative|Москва}}→ в Москвев {{#invoke:ru|locative|Казань}}→ в Казани
Существует, однако, большая группа существительных, для которых формы предложного и местного падежей не совпадают (например: «лес» → «о ле́се», но «в лесу́»). Данная функция не учитывает эти исключения — не используйте её в подобных случаях!
о {{#invoke:ru|locative|лес}}→ о лесе
pl
Формирует множественное число (название функции — от англ. plural):
{{#invoke:ru|pl|шахтёр}}→ шахтёры{{#invoke:ru|pl|трава}}→ травы{{#invoke:ru|pl|конь}}→ кони
Данная функция определяет склонение слова с помощью функции guessdecl (см. ниже). При необходимости (напр., когда guessdecl ошибается), склонение можно указать в явном виде во втором аргументе:
{{#invoke:ru|pl|пальто|0}}→ пальто (без второго аргумента:{{#invoke:ru|pl|пальто}}→ ошибочно «пальта»)
guessdecl
Определяет тип склонения (название функции — от англ. guess declension). Данная функция используется функцией pl (см. выше), если при вызове последней не задан второй параметр. Возвращаемые значения:
0— для несклоняемых существительных;1,2и3— для существительных I, II и III склонения, соответственно;a(от англ. adjective) — для прилагательных.
Важно: невозможно без использования словаря различать следующие случаи:
- слова III склонения (напр., «дверь») и оканчивающиеся на «ь» слова II склонения (напр., «конь»). Данная функция возвращает для таких слов значение
2. Значение3возвращается только для слов, оканчивающихся на «Xмя», где X — гласная (напр., «время»); в действительности, эти слова являются разносклоняемыми (см. статью Склонение) и склоняются по третьему склонению не во всех формах: исключение — форма творительного падежа единственного числа. - несклоняемые слова, форма которых совпадает с формой какого-либо склонения (напр., «пальто» / «озеро»). Для таких слов будет возвращаться неправильное значение
1,2или3вместо правильного0.
Примеры:
{{#invoke:ru|guessdecl|такси}}→ 0{{#invoke:ru|guessdecl|юноша}}→ 1{{#invoke:ru|guessdecl|дом}}→ 2{{#invoke:ru|guessdecl|дверь}}→ 3{{#invoke:ru|guessdecl|белый}}→ a
Примеры ошибок:
{{#invoke:ru|guessdecl|дверь}}→ 2 (должно быть3){{#invoke:ru|guessdecl|пальто}}→ 2 (должно быть0)
o (латиницей)
Подбирает предлог о/об/обо:
{{#invoke:ru|o|том}}→ о{{#invoke:ru|o|этом}}→ об{{#invoke:ru|o|всём}}→ обо
obo
Используется функцией o, для экспорта в другие скрипты, в invoke не работает.
require("Module:Ru").obo("слово")
s
Подбирает предлог с/со:
{{#invoke:ru|s|тем}}→ с{{#invoke:ru|s|всем}}→ со
so
Используется функцией s