Редактирование: Модуль:Ru/doc

{{Рейтинг модуля|p}}
{{TOC right}}
Этот модуль содержит основные функции преобразования текста для русского языка.

== Функции ==
=== <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|лес}}

=== <code>pl</code> ===
Формирует [[множественное число]] (название функции — от {{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|конь}}

Данная функция определяет [[Склонение (лингвистика)|склонение]] слова с помощью функции <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|пальто}}»)

==== <code>guessdecl</code> ====
Определяет тип [[Склонение (лингвистика)|склонения]] (название функции — от {{Lang-en|guess declension}}). Данная функция используется функцией <code>pl</code> (см. [[#pl|выше]]), если при вызове последней не задан второй параметр. Возвращаемые значения:
* <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("слово")<!--?-->

=== <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>