Местная подстройка
Пожалуйста, экспериментируйте в песочнице!
ВикиАдминистратор может сделать некоторые подстройки простой установкой переменных в файле local/config.php. Любая группа или страница также может иметь собственный конфигурационный файл.
С самого начала PmWiki была задумана так, чтобы ВикиАдминистраторы могли сильно перестраивать вывод страниц и последовательности разметки используемые для образования страниц. (Это даже явно указано на странице Философия червёртым правилом). В результате, сценарий ядра pmwiki.php всячески пользуется переменными для определения как обработать последовательности разметки и что каждая отдельная страница выведет.
Основная часть этой страницы описывает в общих чертах как работают подстройки, некоторые наиболее часто используемые смотри в Documentation Index, включая:
Простейший тип подстройки это установка переменной в значение 1(или TRUE). Вот пример включающий операции ?action=diag и ?action=phpinfo:
$EnableDiag = 1;
Для добавления комментария в начале строки можно поставить "#" (знак числа, известный как решётка или знак фунта). Кроме того, некоторые встроеные переменные PmWiki принимают другие значения, нежели 1 или 0 (истина или ложь). Вот ещё пример включающий расположение вики к поисковым роботам (смотри Cookbook:ControllingWebRobots):
# Разрешает индексировать сайт поисковыми системами. $MetaRobots = 'index,follow'; $EnableRobotCloakActions = 1;
Подпапка scripts/ (относительно папки со сценарием pmwiki.php) содержит много подстроек. Рецептурник PmWiki содержит много примеров подстроек(рецептов), которые вы можете скачать в папку cookbook/. Первые пять строк каждого такого сценария в основном содержат инструкции как включить (и использовать) функции предлагаемые этим сценарием.
Такие подстройки включаются в ваш файл конфигурации сайта config.php. Для большинства сценариев включение делается простым добавление строк вроде
include_once("cookbook/recipefile.php");
и
include_once("scripts/scriptfile.php");
в конец файла config.php.
Некоторые сценарии автоматически включены для вас через сценарий scripts/stdconfig.php пока вы не выключите их установкой
в local/config.php.
$EnableStdConfig
=0;
Заметьте, что вы должны усиленно сопротивляться соблазну напрямую изменить сценарий pmwiki.php или файлы в папке scripts/. Все изменения сделаные вами в этих файлах будут потеряны после выполнения обновления. Напротив, посмотрите на некоторые сценарии из примеров подстроек выполняемые из config.php. Вы даже можете создать свои собственные сценарии для подстройки и воспользоваться include_once(...)
для вставки его в config.php. Если вы сделали собственный сценарий, вы можете его спокойно положить в папку cookbook/. И он не будет потерян при обновлении. Вы также можете захотеть представить вашу подстройку в списке рассылки пользователей pmwiki? или в Рецептурнике так, что другие могут воспользоваться вашим достижением. И даже возможно она может будет включена в будущий выпуск PmWiki.
<< Начальная настройка | Документация | Внешность >>
Как мне получить имя группы или страницы в локальной файле настроек (т.е. local/config.php)?
Используйте следующие функции в pmwiki-2.1.beta21 или новее:
## Получить имя группы или страницы $pagename = ResolvePageName($pagename); $group = PageVar($pagename, '$Group'); $name = PageVar($pagename, '$Name');
Перевод страницы PmWiki.LocalCustomizations -
Оригинал перевода PmWikiRu.LocalCustomizations -
Backlinks
PmWikiRu.LocalCustomizations: редакция от September 10, 2011, at 10:48 PM
PmWiki.LocalCustomizations: редакция от March 12, 2023, at 07:08 PM