Инструкции по обработке страницы
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/. Также см. ПомощьПоПоддержкеЯзыков.