Модуль:Ru/doc: различия между версиями

Материал из Буквицы
Перейти к навигации Перейти к поиску
ВизуальныйВики-текст
Новая страница: «Этот модуль содержит основные функции для русского языка. == Функции == ===locative=== Формирует …»
 
мНет описания правки
 
(не показаны 4 промежуточные версии этого же участника)
Строка 1: Строка 1:
Этот модуль содержит основные функции для русского языка.
<!-- {{module rating|p}} -->
{{TOC right}}
Этот модуль содержит основные функции преобразования текста для русского языка.
 
== Функции ==
== Функции ==
===locative===
=== <code>locative</code> ===
Формирует локатив.
Формирует [[предложный падеж]] (препозитив), в большинстве случаев совпадающий с [[Местный падеж|местным падежом]] (локативом):
* {{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|лес}}


<nowiki>в {{#invoke:ru|locative|Москва}}</nowiki> = в {{#invoke:ru|locative|Москва}}
=== <code>pl</code> ===
===pl===
Формирует [[множественное число]] (название функции — от {{lang-en|plural}}):
Формирует множественное число.
* {{nobr|1=<code><nowiki>{{#invoke:ru|pl|шахтёр}}</nowiki></code> →}} {{#invoke:ru|pl|шахтёр}}
* {{nobr|1=<code><nowiki>{{#invoke:ru|pl|трава}}</nowiki></code> →}} {{#invoke:ru|pl|трава}}
* {{nobr|1=<code><nowiki>{{#invoke:ru|pl|конь}}</nowiki></code> →}} {{#invoke:ru|pl|конь}}


<nowiki>{{#invoke:ru|pl|шахтёр}}</nowiki> = {{#invoke:ru|pl|шахтёр}}
Данная функция определяет [[Склонение (лингвистика)|склонение]] слова с помощью функции <code>guessdecl</code> (см. [[#guessdecl|ниже]]). При необходимости (напр., когда <code>guessdecl</code> ошибается), склонение можно указать в явном виде во втором аргументе:
====guessdecl====
* {{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|пальто}}»)
Угадывает склонение (результат используется, если в предыдущей функции не задан второй параметр)
<nowiki>{{#invoke:ru|guessdecl|шахтёр}}</nowiki> = {{#invoke:ru|guessdecl|шахтёр}}
===o===
{{слабо|(лат. буква)}} Подбирает предлог о/об/обо.


<nowiki>{{#invoke:ru|o|автомобиле}}</nowiki> = {{#invoke:ru|o|автомобиле}}
==== <code>guessdecl</code> ====
==== obo ====
Определяет тип [[Склонение (лингвистика)|склонения]] (название функции — от {{lang-en|guess declension}}). Данная функция используется функцией <code>pl</code> (см. [[#pl|выше]]), если при вызове последней не задан второй параметр. Возвращаемые значения:
Используется предыдущей функцией, для экспорта в другие скрипты, в invoke не работает.
* <code>0</code> — для несклоняемых существительных;
* <code>1</code>, <code>2</code> и <code>3</code> — для существительных I, II и {{nobr|III склонения}}, соответственно;
* <code>a</code> (от {{lang-en|adjective}}) — для прилагательных.


'''Важно''': невозможно без использования словаря различать следующие случаи:
* слова {{nobr|III склонения}} (напр., «дверь») и оканчивающиеся на «ь» слова {{nobr|II склонения}} (напр., «конь»). Данная функция возвращает для таких слов значение <code>2</code>. Значение <code>3</code> возвращается только для слов, оканчивающихся на «''X''мя», где ''X'' — гласная (напр., «время»); в действительности, эти слова являются разносклоняемыми (см. статью [[Склонение (лингвистика)|Склонение]]) и склоняются по третьему склонению не во всех формах: исключение — форма творительного падежа единственного числа.
* несклоняемые слова, форма которых совпадает с формой какого-либо склонения (напр., {{nobr|«пальто» /}} «озеро»). Для таких слов будет возвращаться неправильное значение <code>1</code>, <code>2</code> или <code>3</code> вместо правильного{{nbsp}}<code>0</code>.
Примеры:
* {{nobr|1=<code><nowiki>{{#invoke:ru|guessdecl|такси}}</nowiki></code> →}} {{#invoke:ru|guessdecl|такси}}
* {{nobr|1=<code><nowiki>{{#invoke:ru|guessdecl|юноша}}</nowiki></code> →}} {{#invoke:ru|guessdecl|юноша}}
* {{nobr|1=<code><nowiki>{{#invoke:ru|guessdecl|дом}}</nowiki></code> →}} {{#invoke:ru|guessdecl|дом}}
* {{nobr|1=<code><nowiki>{{#invoke:ru|guessdecl|дверь}}</nowiki></code> →}} {{#invoke:ru|guessdecl|время}}
* {{nobr|1=<code><nowiki>{{#invoke:ru|guessdecl|белый}}</nowiki></code> →}} {{#invoke:ru|guessdecl|белый}}
Примеры ошибок:
* {{nobr|1=<code><nowiki>{{#invoke:ru|guessdecl|дверь}}</nowiki></code> →}} {{#invoke:ru|guessdecl|дверь}} (должно быть <code>3</code>)
* {{nobr|1=<code><nowiki>{{#invoke:ru|guessdecl|пальто}}</nowiki></code> →}} {{#invoke:ru|guessdecl|пальто}} (должно быть <code>0</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|этом}}
* {{nobr|1=<code><nowiki>{{#invoke:ru|o|всём}}</nowiki></code> →}} {{#invoke:ru|o|всём}}
==== <code>obo</code> ====
Используется функцией <code>o</code>, для экспорта в другие скрипты, в invoke не работает.
  require("Module:Ru").obo("слово")<!--?-->
  require("Module:Ru").obo("слово")<!--?-->
<includeonly>[[Категория:Википедия:Модули]]</includeonly>
 
=== <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:30, 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

Источник — https://bukvica.org/w/index.php?title=Модуль:Ru/doc&oldid=229418