Инструкции по обработке страницы
Contents
Инструкции по обработке в МойнМойн имеют ту же семантику, что и в XML: они управляют способами обработки страницы. Инструкции по обработке (далее «инструкции») — строки, начинающиеся с символа решётки («`#`») и содержащие ключевое слово и опционально ряд аргументов; регистр ключевого слова игнорируется. Комментарии предваряются двумя символами решётки в начале строки и не отображаются в тексте страницы.
Все инструкции должны находиться в начале страницы. Исключение составляют инструкции-комментарии, которые могут находиться в любим месте при использовании формата «wiki» (но не какого-либо другого).
Для дополнительной информации по разметке см. КакРедактировать.
Обрабатываемые МойнМойн инструкции:
Комментарий
## Комментарий. Содержимое комментария игнорируется при обработке.
#format (формат)
Определяет формат страницы
#FORMAT спецификатор_формата дополнительные_аргументы
`спецификатор_формата` может принимать следующие значения:
wiki — вики-разметка МойнМойн
creole — ещё один вики-синтаксис (см. СправочникПоСинтаксисуCreole)
plain — неформатированный текст
python — код на языке Python с подстветкой синтаксиса
rst — разметка reStructuredText (см. ПомощьПоПарсерам/ReStructuredText)
Любое другое имя парсера. См. ПомощьПоПарсерам для информации о дополнительных доступных парсерах и репозиторий парсеров для парсеров, созданных сообществом.
Некоторые парсеры принимают дополнительные аргументы. Информация о них содержится в документации по парсеру.
#redirect (перенаправление)
Перенаправление на другую страницу (также см. PageRedirect)
#REDIRECT имя_страницы
#refresh (перезагрузка страницы)
Перенаправление на другую страницу (или внешний ресурс, или обновление той же страницы с заданным интервалом, если целевая страница не задана)
Должно быть разрешено в конфигурации вики-сервера, см. КакНастраивать.
#REFRESH задержка цель
`цель` может быть именем страницы или URL. Примеры:
#refresh 0 ГлавнаяСтраница #refresh 5 http://example.com/
#pragma (параметр)
Задаёт параметр обработки:
#PRAGMA параметр аргументы
Имена параметров регистронезависимы.
МойнМойн поддерживает некоторый набор параметров, который может быть расширен и использоваться в темах и макрокомандах. Известные параметры:
section-numbers (нумерация разделов)
Регулирует автоматическую нумерацию разделов.
#pragma section-numbers off
Значение `off` или `0` запрещает автоматическую нумерацию, `on` или `1` разрешает нумерацию. Значение по умолчанию задаётся в параметре конфигурации `show_section_numbers`.
При разрешении нумерации также возможно задать уровень заголовков для нумерации:
#pragma section-numbers 2
Данная инструкция разрешает автоматическую нумерацию только для заголовков уровня 2 и выше (3, 4, ...). Аналогично, доступны значения 3—5.
keywords (ключевые слова)
Добавляет тег `<meta>` с ключевыми словами в целях улучшения обработки поисковыми роботами.
#pragma keywords Visual Basic, бесплатные уроки скачать, Страуструп C++, Delphi бесплатные компоненты скачать
description (описание)
Добавляет тег `<meta>` с описанием страницы.
#pragma description Эта страница посвящена SEO.
supplementation (вспомогательная страница)
Используется для включения и выключения поддержки вспомогательной страницы (например, страницы обсуждения) для данной страницы:
#pragma supplementation-page on
Значение параметра `off` отключает поддержку. Также см. КакНастраивать/ВспомогательнаяСтраница для дополнительной информации.
#deprecated (устаревшее)
Помечает страницу как устаревшую.
#DEPRECATED
Дальнейшие правки страницы не будут использовать механизм контроля версий (как следствие, старые версии страницы, содержащие инструкцию `deprecated`, не будут сохраняться) и использование данной инструкции приводит к отображению как текущей версии, так и версии до установки инструкции. Это позволяет удалить всё содержимое страницы, добавить `#deprecated` и краткое сообщение о причине сего действия. Таким образом, последняя версия страницы «замораживается» и её релевантность при поиске снижается, но, тем не менее, содержимое доступно для просмотра.
- Удаление инструкции не сохранит версию страницы с предупреждением о её устаревшем статусе.
- По сравнению с инструкцией `#redirect`, эта инструкция позволяет пользователю получить информацию о том, почему данная страница более не используется и необходимо перейти на новую, в то время как `#redirect` перенаправляет на новую страницу без предоставления дополнительной информации.
- В случае оставления содержимого страницы при добавлении `#deprecated`, оно будет показано дважды.
#language (язык)
Указывает язык страницы и направление письма.
#language язык
Язык указывается в соответствии со стандартом ISO 639-1. МойнМойн игнорирует языки, которые не имеют файла перевода в `MoinMoin/i18n/`. Также см. ПомощьПоПоддержкеЯзыков.