Условная разметка
Эта страница документации взята с pmwiki.org.
Чтобы улучшить перевод, отредактируйте оригинал на pmwiki.org.
Изменения со временем появятся здесь.
Кстати, в песочнице pmwiki.org можно экспериментировать.
авторам, администраторам (продвинутый)
Использование директивы (:if:)
Директива (:if:)
позволяет включать или выключать обработку части страницы.
Общая форма этой директивы такая:
(:if условие параметр:) текст (:ifend:)
где "условие" - это проверяемое условие (описано ниже), а "параметр" - это параметр или аргумент условия. Если условие "истинно"(TRUE), то текст
будет включен, а если "ложно"(FALSE) - исключен из обработки страницы.
Встроеные условия включают:
| (:if name ИМЯСТРАНИЦЫ:)
| - | текущая страница называется "ИМЯСТРАНИЦЫ "
|
(:if group ИМЯГРУППЫ:)
| - | текущая группа называется "ИМЯГРУППЫ "
| |
(:if auth УРОВЕНЬ:)
| - | пользователь имеет авторизационный "УРОВЕНЬ ", где УРОВЕНЬ может быть: read , edit , upload , attr или admin
| |
(:if authid:)
| - | пользователь авторизован | |
(:if true:)
| - | всегда включает обработку текста | |
(:if false:)
| - | всегда выключает текст (тоже что и коментарий) | |
(:if attachments:)
| - | у текущей страницы есть присоеденённые файлы | |
(:if date ДАТА:)
| - | настоящая дата совпадает с ДАТА
| |
(:if date ДАТА..:)
| - | настоящая дата совпадает с ДАТА или позднее (неограничено)
| |
(:if date ДАТА1..ДАТА2:)
| - | нынешняя дата в диапазоне между ДАТА1 и ДАТА2 (включительно)
| |
все даты в формате гггг-мм-чч или ггггммчч | |||
(:if enabled VAR:)
| - | PHP переменная VAR истинна (==true) | |
(:if equal СТРОКА1 СТРОКА2:)
| - | СТРОКА1 совпадает с СТРОКА2
| |
(:if match РЕГВЫР:)
| - | имя текущей страницы подходит под регулярное выражение РЕГВЫР
| |
(:if exists ИмяСтраницы:)
| - | страница ИмяСтраницы существует |
Также работают обратные формы условий:
| (:if !attachments:)
| - | у страницы нет добавленых файлов |
(:if ! name ИмяСтраницы:)
| текущая страница не называется "ИмяСтраницы "
| ||
(:if name -ИмяСтраницы :)
| |||
(:if name !ИмяСтраницы :)
|
Любая директива (:if:)
автоматически прерывает предыдущую, так что можно легко сделать выбор варианта(без вложености):
| (:if auth read:)* Вам дозволено читать
|
(:if auth edit:)* Вам дозволено редактировать
| |
(:if auth upload:)* Вам дозволено закачивать файлы
| |
(:ifend:)
|
Использование символов обобщения ('*' и '?')
Знак звезда (*
) - это обощение обозначающее любую последовательность символов, в том числе и пусто, которая может быть расположена на его месте.
А знак вопроса (?
) - это обобщение обозначающее любой символ на его месте.
Символы обобщения (*
и ?
) используются в условной разметке:
| (:if name PmCal.2005* :)
| - | текущая страница принадлежит группе PmCal и её имя начинается с 2005 |
(:if group PmWiki* :)
| - | имя группы страницы начинается с PmWiki
| |
(:if name Profiles.*,-Profiles.Profiles :)
| - | страница в группе Profiles , но не Profiles.Profiles
|
Смешаные условия
Условия (определённые ранее) можно комбинировать в более сложные выражения. Для этого используется одна из трёх эквивалентных форм:
| (:if expr ВЫРАЖЕНИЕ :)
|
(:if [ ВЫРАЖЕНИЕ ] :)
| |
(:if ( ВЫРАЖЕНИЕ ) :)
|
Условия комбинируются в выражения с помощью двоичных операторов и скобок. В следующей таблице, буквами А и Б обозначаются условия или подвыражения взятые в скобки:
Выражение | Оператор | Результат "истинно" |
---|---|---|
А and Б | And | Если А и Б истинны |
А or Б | Or | Если А или Б истинно |
А xor Б | Xor | Если А и Б истинны, или А и Б ложны |
! A | Not | Если А ложно |
А && Б | And | Если А и Б истинны |
А || Б | Or | Если А или Б истинно |
Обратите внимание, что:
- пробелы вокруг операторов и скобок обязательны;
- При синтаксических ошибках или непарных скобках поведение условий непредсказуемо.
Отсюда запись:
| (:if expr auth admin || auth attr || auth edit :)
|
[[Logout -> {$Name}?action=logout]]
| |
(:if:)
|
предлагает logout ссылку только когда авторизация с правами больше, чем 'read'(просмотр).
администраторам (продвинутый)
Добавление новых условий
Смотри Cookbook:ConditionalMarkupSamples.
<< InterMap ссылки | Документация | Списки страниц >>
Перевод страницы PmWiki.ConditionalMarkup -
Оригинал перевода PmWikiRu.ConditionalMarkup -
Ссылаются
PmWikiRu.ConditionalMarkup: редакция от 2011-09-10, 22:48
PmWiki.ConditionalMarkup: редакция от 2020-08-28, 13:30