## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnMacros
##master-date:2013-03-16T17:05:37Z
#acl -All:write Default
#format wiki
#language ru

<<Navigation(children)>>

= Макрокоманды =

<<TableOfContents>>

Макрокоманды позволяют вставлять в обычные вики-страницы результаты работы функций самого вики-движка. Т.&nbsp;н. «специальные страницы» (например, ПоследниеИзменения или SystemInfo — системная информация) реализованы путём добавления в их содержимое макрокоманд. Достаточно посмотреть исходную разметку этих страниц, чтобы понять, как именно это сделано.

Более подробную информацию о собственно разметке см. на страницах КакРедактировать и СправочникПоСинтаксису.

== Поисковые макрокоманды ==
Поисковая подсистема МойнМойн позволяет создавать довольно сложные поисковые запросы как непосредственно в поле поиска, так и при вызове любой поисковой макрокоманды, подробнее см. КакИскать. В частности, вместо поиска подстроки может использоваться поиск регулярного выражения, составной поиск, применяться фильтрация по языку и&nbsp;т.&nbsp;п.

||<tablewidth="100%" width="33%" rowbgcolor="#ffffcc"> '''Макрокоманда''' || '''Описание'''  ||
|| {{{<<AdvancedSearch>>}}}                                               || Добавляет на страницу форму расширенного поиска, см. НайтиСтраницу. ||
|| {{{<<TitleSearch>>}}}                                                  || Добавляет на страницу поле для поиска по заголовкам, см. НайтиСтраницу. ||
|| {{{<<FullSearch>>}}}                                                   || Добавляет на страницу поле для поиска по всему содержимому сайта, см. НайтиСтраницу. ||
|| {{{<<FullSearch()>>}}}                                                 || Выводит список страниц, ссылающихся на данную; то же самое происходит, если кликнуть на заголовок страницы. См., например, КатегорияКатегория. ||
|| {{{<<FullSearch(текст[, highlight_titles={0|1}, highlight_pages={0|1}])>>}}} || Выводит список страниц, содержащих `текст`. Если [[КакНастраивать#search_macro|параметр конфигурации]] `search_macro_parse_args` включен, то параметр `highlight_titles` позволяет управлять выделением части имён страниц в генерируемом списке, соответствующей условию, а параметр `highlight_pages` отвечает за добавление параметра `highlight=` к URL ссылок в списке страниц. ||
|| {{{<<FullSearchCached(текст[, highlight_titles={0|1}, highlight_pages={0|1}])>>}}} || аботает аналогично {{{FullSearch}}}, плюс к тому сохраняет результаты поиска в кеше страницы. Это даёт значительный выигрыш в производительности, но сами результаты, возможно, окажутся устаревшими. Поведение параметров `highlight_titles` и `highlight_pages` аналогично поведению их в макрокоманде `FullSearch`. ||
|| {{{<<GoTo>>}}}                                                         || Добавляет на страницу поле для перехода на определённую страницу, см. НайтиСтраницу.  ||
|| {{{<<PageList(Имя[, highlight_titles={0|1}])>>}}}                      || Выводит список страниц, заголовки которых содержат `Имя`. Используется, например, на странице СправочныйУказатель. Поведение параметра `highlight_titles` такое же, как и у макрокоманды `FullSearch`. ||

== Навигационные макрокоманды ==

Макрокоманды, упрощающие навигацию по сети вики-страниц и связанных с ними объектов.

||<tablewidth="100%" width="33%" rowbgcolor="#ffffcc"> '''Макрокоманда''' || '''Описание'''  ||
|| {{{<<RecentChanges>>}}}                                                || Список страниц, которые недавно редактировались. См. ПоследниеИзменения. ||
|| {{{<<TitleIndex>>}}}                                                   || Список всех страниц. См. АлфавитныйУказатель. ||
|| {{{<<WordIndex>>}}}                                                    || Список всех слов, встречающихся в именах страниц. См. ПредметныйУказатель. ||
|| {{{<<WantedPages>>}}}                                                  || Список несуществующих страниц, на которые имеются ссылки. См. НенаписанныеСтраницы. ||
|| {{{<<OrphanedPages>>}}}                                                || Список страниц, на которые никто не ссылается. См. ОдинокиеСтраницы. ||
|| {{{<<AbandonedPages>>}}}                                               || Список страниц, которые давно уже никто не редактировал. См. БрошенныеСтраницы ||
|| {{{<<RandomPage>>}}}                                                   || Ссылка, всякий раз ведущая на случайную страницу. См. СтраницаНаугад. ||
|| {{{<<RandomPage(N)>>}}}                                                || Список из `N` ссылок, ведущих на случайные страницы. ||
|| {{{<<TableOfContents([глубина])>>}}}                                   || Выводит содержание текущей страницы (иерархический список ссылок на заголовки). Можно ограничить уровень упоминаемых заголовков уровнем `глубина`. Пример — в начале этой страницы. ||
|| {{{<<Anchor(якорь)>>}}}                                                || Макрокоманда, помещающая якорь в текущее место страницы. ||
|| {{{<<Navigation(children[,maxdepth])>>}}}                              || Выводит список всех вложенных страниц текущей страницы. Можно ограничить уровень упоминаемых вложенных страниц `глубиной`. Пример — в начале этой страницы. ||
|| {{{<<Navigation(siblings[,maxdepth])>>}}}                              || Выводит список всех страниц того же уровня, что и текущая; иными словами, список вложенных страниц ''родительской'' страницы. Пример — страница /MailTo. ||
|| {{{<<Navigation(slideshow)>>}}}                                        || Вставляет переключатель между режимом слайд-шоу и обычным, а также ссылку на начало слайд-шоуа и режим раздаточных материалов, в котором текст всех слайдов представлен без вики-оформления. См. КакДелатьСлайды. ||
|| {{{<<Navigation(slides)>>}}}                                           || Вставляет ссылки на первый, предыдущий, следующий и последний слайды. См. КакДелатьСлайды. ||
|| {{{<<AttachInfo>>}}}                                                   || Показывает количество приложенных к текущей странице файлов. См ПомощьПоДействиям/AttachFile. ||
|| {{{<<AttachInfo(ИмяСтраницы)>>}}}                                      || Показывает количество приложенных к странице `ИмяСтраницы` файлов. См ПомощьПоДействиям/AttachFile. ||
|| {{{<<AttachList([ИмяСтраницы])>>}}}                                    || Показывает список ссылок на файлы, приложенные к текущей странице (или к странице `ИмяСтраницы`, если этот параметр указан). См. ПомощьПоДействиям/AttachFile. ||
|| {{{<<AttachList([ИмяСтраницы[,тип MIME[,фильтр поиска]]])>>}}}         || Показывает список ссылок только на файлы, прикреплённые к странице `ИмяСтраницы`, имеющие тип `тип MIME` и удовлетворяющие регулярному выражению, указанному в параметре `фильтр поиска`. См ПомощьПоДействиям/AttachFile. ||

== Информационные макрокоманды ==

||<tablewidth="100%" width="33%" rowbgcolor="#ffffcc"> '''Макрокоманда''' || '''Описание'''  ||
|| `<<Hits([all=(False, True)][,` `event_type=(VIEWPAGE, SAVEPAGE)])>>`   || Cчётчик количества обращений к странице. Параметр `all` определяет, должна ли статистика отображать для всех страниц (в случае, если значение параметра равно «`True`») или только для страницы, на которой расположена макрокоманда (при значении «`False`» параметра, поведение по умолчанию). Параметр `event_type` указывает используемый счётчик действий, значений которого необходимо отображать; «`VIEWPAGE`» (используется по умолчанию) — просмотры страницы, «`SAVEPAGE`» — правки. ||
|| {{{<<InterWiki>>}}}                                                    || Cписок ИнтерВики-имён. ||
|| {{{<<SystemInfo>>}}}                                                   || Информация о версии вики-сервера, интерпретатора Python и базовой операционной системы. ||
|| {{{<<PageCount([exists])>>}}}                                          || Общее количество имён страниц. Если в качестве параметра указано {{{{exists}}}, подсчитываются только существующие страницы. ||
|| {{{<<PageSize>>}}}                                                     || Выводит список страниц, отсортированный по их размеру (размер тоже выводится). /!\ Осторожно! Эта макрокоманда довольно ресурсоёмка! См. РазмерыСтраниц ||
|| {{{<<StatsChart(тип)>>}}}                                              || Показывает различную статистику по страницам. Допустимые значения параметра `тип`: `hitcounts`, `pagesize`, `useragents`, `languages`. См. страницу СтатистикаПросмотров и её вложенные страницы. ||
|| {{{<<SystemAdmin>>}}}                                                  || Информация для администратора вики. ''Доступна только суперпользователю''. ||
|| {{{<<EditedSystemPages>>}}}                                            || Список изменённых системных страниц. ||
|| {{{<<WikiConfig>>}}}                                                   || Список изменённых или не заданных настроек вики-сервера. ''Доступен только суперпользователю'' ||
|| {{{<<WikiConfigHelp>>}}}                                               || Полный список настроек вики-движка и их описание. ||
|| {{{<<HighlighterList>>}}}                                              || Список доступных лексеров Pygments. См. MoinMoin:MacroMarket/HighlighterList/Ru для дополнительной информации. ||

== Разное ==

||<tablewidth="100%" width="33%" rowbgcolor="#ffffcc"> '''Макрокоманда''' || '''Описание'''  ||
|| `<<Action(действие[,` `пояснительный текст])>>`                        || Ссылка на страницу, порождаемую соответствующим `действием` (см. ПомощьПоДействиям); допустим необязательный параметр `пояснительный текст`. Пример: `<<Action(print, Напечатать эту страницу)>>` преобразуется в <<Action(print, Напечатать эту страницу)>>. ||
|| {{{<<Icon(иконка)>>}}}                                                 || Показывает значок `иконка`. См. КакОриентироваться. ||
|| {{{<<BR>>}}}                                                           || Вставляет перевод строки. ||
|| {{{<<RandomQuote([СборникЦитат])>>}}}                                  || Показывает случайную цитату со страницы `СборникЦитат` (если параметр не указан — со страницы {{{FortuneCookies}}}). ||
|| `<<Include(СтраницаДляВстраивания[,` `"заголовок"[, уровень]])>>`      || Вставляет содержимое страницы `HelloWorld`. См. [[/Include]]. ||
|| {{{<<FootNote(текст сноски)>>}}}                                       || Добавляет в хранилище сносок сноску<<FootNote(текст сноски не должен содержать вики-разметки)>> и вставляет ссылку на неё. Если `текст сноски` опущен, выводит содержимое хранилища сносок со ссылками на соответствующие пометки в тексте. Если вызов макрокоманды `<<FootNote>>` без параметров отсутствует в тексте страницы, то сноски будут добавлены с её конец. ||
|| {{{<<Date([timestamp])>>}}}                                            || Вставляет дату (по умолчанию — текущую) в соответствие с системными настройками; пример: <<Date>>. ||
|| {{{<<DateTime(timestamp)>>}}}                                          || Вставляет дату и время<<FootNote(параметр «`timestamp`» можно опускать (что соответствует текущей дате), выражаться количеством секунд, прошедших с начала 1970 года (т. н. «[[WikiPedia:UNIX time]]»), либо время в стандарте W3C («2002-01-23T12:34:56», см. [[RFC:822|RFC 822]], раздел 5. )>> в соответствие с системными на стройками; пример:<<DateTime>>. ||
|| {{{<<GetText(текст)>>}}}                                               || ~-(используется чаще всего в страницах помощи)-~ Показывает переведённый текст, если таковой существует в подсистеме локализации. Пример: «!RecentChanges» переводится как «<<GetText(RecentChanges)>>». ||
|| `<<GetText2(`,`сообщение`,`параметр1`,`параметр2,` `...)>>`            || ~-(используется чаще всего в страницах помощи и в автоматически создаваемых разделах страниц)-~ Подставляет в I18N-перевод `сообщения` на место каждого вхождения `%s` очередной `параметр`; результат выводит.<<BR>> <!> Особенность этой макрокоманды: первый символ внутри скобок используется в качестве разделителя `сообщения` и `параметров` (в примере ниже это минус `-`); пробельные и управляющие символы в качестве разделителя должны экранироваться с помощью обратной косой черты `\\`. Пример: «`<<GetText2(-[You may not read %s]-FooBar)>>`» переводится как «<<GetText2(-[You may not read %s]-FooBar)>>». <<BR>>Для именованных параметров в строке формата указывайте используйте "=" для разделения имени и значения в аргументах, например: «`<<GetText2(,Upload new attachment \"%(filename)s\",filename=файл.txt)>>`» будет отображён как «<<GetText2(,Upload new attachment \"%(filename)s\",filename=файл.txt)>>». ||
|| {{{<<TeudView>>}}}                                                     || Используется главным образом разработчиками для просмотра документации, порождаемой `pydoc`, которая форматируется посредством XSLT-преобразования. См. [[http://twistedmatrix.com/wiki/python/TeudProject]]. ||
|| {{{<<MailTo(email)>>}}}                                                || Позволяет записывать почтовый адрес в виде, непригодном для спам-ботов. См. /MailTo. ||
|| `<<NewPage(ШаблонСтраницы,` `НадписьНаКнопке[,` `(РодительскаяСтраница | @ME | @SELF)][,` `ШаблонИмени])>>` || Позволяет быстро создавать (вложенные) страницы по шаблону {{{ШаблонСтраницы}}} для содержимого и {{{ШаблонИмени}}} для имени страницы<<FootNote(`ШаблонИмени` форматируется функцией `time.strftime()`, причём если в нём присутствует подстрока `%s`, то показывается также поле ввода и она заменяется на строчку, введённую пользователем; по умолчанию `ШаблонИмени` — это `%s`)>>. Вместо параметра {{{РодительскаяСтраница}}} можно использовать `@ME` (в этом случае будет создана вложенная страница домашней страницы пользователя) и `@SELF` (в этом случае создастся вложенная страница той страницы, где была вызвана макрокоманда). ||
|| `<<GetVal(СтраницаСоСловарём,` `ЗаголовокСтатьи)>>`                    || Показывает словарную статью со `СтраницыСоСловарём`. Например, если существует страница RussianDict, а в ней — статья ''Test'', здесь должен появиться перевод: <<GetVal(RussianDict,Test)>>. ||
|| {{{<<MonthCalendar(,,12)>>}}}                                          || показывает календарь и ссылки в нём на вложенные страницы, соответствующие дням. См. /MonthCalendar. ||

<<FootNote>>
