/EmbedObject /Include /MailTo /MonthCalendar |
Макрокоманды
Contents
Макрокоманды позволяют вставлять в обычные вики-страницы результаты работы функций самого вики-движка. Т. н. «специальные страницы» (например, ПоследниеИзменения или SystemInfo — системная информация) реализованы путём добавления в их содержимое макрокоманд. Достаточно посмотреть исходную разметку этих страниц, чтобы понять, как именно это сделано.
Более подробную информацию о собственно разметке см. на страницах КакРедактировать и СправочникПоСинтаксису.
Поисковые макрокоманды
Поисковая подсистема МойнМойн позволяет создавать довольно сложные поисковые запросы как непосредственно в поле поиска, так и при вызове любой поисковой макрокоманды, подробнее см. КакИскать. В частности, вместо поиска подстроки может использоваться поиск регулярного выражения, составной поиск, применяться фильтрация по языку и т. п.
Макрокоманда |
Описание |
<<AdvancedSearch>> |
Добавляет на страницу форму расширенного поиска, см. НайтиСтраницу. |
<<TitleSearch>> |
Добавляет на страницу поле для поиска по заголовкам, см. НайтиСтраницу. |
<<FullSearch>> |
Добавляет на страницу поле для поиска по всему содержимому сайта, см. НайтиСтраницу. |
<<FullSearch()>> |
Выводит список страниц, ссылающихся на данную; то же самое происходит, если кликнуть на заголовок страницы. См., например, КатегорияКатегория. |
<<FullSearch(текст[, highlight_titles={0|1}, highlight_pages={0|1}])>> |
Выводит список страниц, содержащих `текст`. Если параметр конфигурации `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`. |
Навигационные макрокоманды
Макрокоманды, упрощающие навигацию по сети вики-страниц и связанных с ними объектов.
Макрокоманда |
Описание |
<<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. |
Информационные макрокоманды
Макрокоманда |
Описание |
`<<Hits: execution failed [Cannot have arguments without name following named arguments] (see also the log)>>` |
Счётчик количества обращений к странице. Параметр `all` определяет, должна ли статистика отображать для всех страниц (в случае, если значение параметра равно «`True`») или только для страницы, на которой расположена макрокоманда (при значении «`False`» параметра, поведение по умолчанию). Параметр `event_type` указывает используемый счётчик действий, значений которого необходимо отображать; «`VIEWPAGE`» (используется по умолчанию) — просмотры страницы, «`SAVEPAGE`» — правки. |
<<InterWiki>> |
Список ИнтерВики-имён. |
<<SystemInfo>> |
Информация о версии вики-сервера, интерпретатора Python и базовой операционной системы. |
<<PageCount([exists])>> |
Общее количество имён страниц. Если в качестве параметра указано {exists, подсчитываются только существующие страницы. |
<<PageSize>> |
Выводит список страниц, отсортированный по их размеру (размер тоже выводится). Осторожно! Эта макрокоманда довольно ресурсоёмка! См. РазмерыСтраниц |
<<StatsChart(тип)>> |
Показывает различную статистику по страницам. Допустимые значения параметра `тип`: `hitcounts`, `pagesize`, `useragents`, `languages`. См. страницу СтатистикаПросмотров и её вложенные страницы. |
<<SystemAdmin>> |
Информация для администратора вики. Доступна только суперпользователю. |
<<EditedSystemPages>> |
Список изменённых системных страниц. |
<<WikiConfig>> |
Список изменённых или не заданных настроек вики-сервера. Доступен только суперпользователю |
<<WikiConfigHelp>> |
Полный список настроек вики-движка и их описание. |
<<HighlighterList>> |
Список доступных лексеров Pygments. См. MacroMarket/HighlighterList/Ru для дополнительной информации. |
Разное
Макрокоманда |
Описание |
`` `пояснительный текст]` |
Ссылка на страницу, порождаемую соответствующим `действием` (см. ПомощьПоДействиям); допустим необязательный параметр `пояснительный текст`. Пример: `Напечатать эту страницу` преобразуется в Напечатать эту страницу. |
<<Icon(иконка)>> |
Показывает значок `иконка`. См. КакОриентироваться. |
<<BR>> |
Вставляет перевод строки. |
<<RandomQuote([СборникЦитат])>> |
Показывает случайную цитату со страницы `СборникЦитат` (если параметр не указан — со страницы FortuneCookies). |
` Invalid include arguments "СтраницаДляВстраивания[,` `"заголовок"[, уровень]]"! ` |
Вставляет содержимое страницы `HelloWorld`. См. /Include. |
<<FootNote(текст сноски)>> |
Добавляет в хранилище сносок сноску1 и вставляет ссылку на неё. Если `текст сноски` опущен, выводит содержимое хранилища сносок со ссылками на соответствующие пометки в тексте. Если вызов макрокоманды `
|
<<Date([timestamp])>> |
Вставляет дату (по умолчанию — текущую) в соответствие с системными настройками; пример: 2025-01-31. |
<<DateTime(timestamp)>> |
Вставляет дату и время1 в соответствие с системными на стройками; пример:2025-01-31 13:53:18. |
<<GetText(текст)>> |
(используется чаще всего в страницах помощи) Показывает переведённый текст, если таковой существует в подсистеме локализации. Пример: «RecentChanges» переводится как «RecentChanges». |
`,` |
(используется чаще всего в страницах помощи и в автоматически создаваемых разделах страниц) Подставляет в I18N-перевод `сообщения` на место каждого вхождения `%s` очередной `параметр`; результат выводит. |
<<TeudView>> |
Используется главным образом разработчиками для просмотра документации, порождаемой `pydoc`, которая форматируется посредством XSLT-преобразования. См. http://twistedmatrix.com/wiki/python/TeudProject. |
<<MailTo(email)>> |
Позволяет записывать почтовый адрес в виде, непригодном для спам-ботов. См. /MailTo. |
` ` |
Позволяет быстро создавать (вложенные) страницы по шаблону ШаблонСтраницы для содержимого и ШаблонИмени для имени страницы2. Вместо параметра РодительскаяСтраница можно использовать `@ME` (в этом случае будет создана вложенная страница домашней страницы пользователя) и `@SELF` (в этом случае создастся вложенная страница той страницы, где была вызвана макрокоманда). |
`` |
Показывает словарную статью со `СтраницыСоСловарём`. Например, если существует страница RussianDict, а в ней — статья Test, здесь должен появиться перевод: Тест. |
<<MonthCalendar(,,12)>> |
показывает календарь и ссылки в нём на вложенные страницы, соответствующие дням. См. /MonthCalendar. |
параметр «`timestamp`» можно опускать (что соответствует текущей дате), выражаться количеством секунд, прошедших с начала 1970 года (т. н. «UNIX time»), либо время в стандарте W3C («2002-01-23T12:34:56», см. RFC 822, раздел 5. (1)
`ШаблонИмени` форматируется функцией `time.strftime()`, причём если в нём присутствует подстрока `%s`, то показывается также поле ввода и она заменяется на строчку, введённую пользователем; по умолчанию `ШаблонИмени` — это `%s` (2)