## 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>> Макрокоманды позволяют вставлять в обычные вики-страницы результаты работы функций самого вики-движка. Т. н. «специальные страницы» (например, ПоследниеИзменения или SystemInfo — системная информация) реализованы путём добавления в их содержимое макрокоманд. Достаточно посмотреть исходную разметку этих страниц, чтобы понять, как именно это сделано. Более подробную информацию о собственно разметке см. на страницах КакРедактировать и СправочникПоСинтаксису. == Поисковые макрокоманды == Поисковая подсистема МойнМойн позволяет создавать довольно сложные поисковые запросы как непосредственно в поле поиска, так и при вызове любой поисковой макрокоманды, подробнее см. КакИскать. В частности, вместо поиска подстроки может использоваться поиск регулярного выражения, составной поиск, применяться фильтрация по языку и т. п. ||<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>>