Начальная настройка

Эта страница документации взята с pmwiki.org.
Чтобы улучшить перевод, отредактируйте оригинал на pmwiki.org.
Изменения со временем появятся здесь.

Кстати, в песочнице pmwiki.org можно экспериментировать.

администраторам (основы)

Теперь, когда на вашем сайте есть работающая PmWiki (смотри Установка), настало время для её настройки под ваши частные запросы.

Большинство настроек PmWiki находится в файле local/config.php. Но некоторые настройки, такие, как меню Site.SideBar, сделаны на специальных страницах группы Site.

Файл конфигурации (local/config.php)

После первой установки PmWiki файл local/config.php отсутствует. Чтобы его создать, скопируйте файл sample-config.php (из папки docs/) в local/config.php и используйте его как отправную точку. Конечно, Вы могли бы создать файл local/config.php с нуля, но sample-config.php для удобства уже заполнен множеством опций готовых для правки.

Вот пример короткого файла config.php:

<?php if (!defined('PmWiki')) exit();
$WikiTitle = "My New Wiki";
$PageLogoUrl = "http://www.example.com/mylogo.gif";

$DefaultPasswords['admin'] = crypt('onesecret');

$EnableUpload = 1;
$DefaultPasswords['upload'] = crypt('secrettwo');

putenv("TZ=EST5EDT");
$TimeFmt = '%B %d, %Y, at %I:%M %p EST';

Заметьте, что config.php начинается с <?php . Завершающий тэг PHP ?> не обязателен и для улучшения совместимости с некоторыми системами может быть опущен. Непременно убедитесь в отсутствии пустых строк или пробелов перед тэгом <?php и после ?>. В противном случае вы можете получить в начале ваших страниц странные сообщения о PHP-ошибках.

Файл config.php, указанный выше, устанавливает значения четырёх PHP-переменных используемых PmWiki:

  • $WikiTitle назначает имя вашего сайта, отображаемое в заголовке браузера пользователя. Если вы хотите ввести название сайта на русском языке, то не забудьте, что для редактирования файла config.php нужно будет использовать текстовый редактор, поддерживающий UTF-8 без BOM.
  • $PageLogoUrl указывает путь к пиктограмме (логотипу), видимому в левом верхнем углу каждой вики страницы.
  • $DefaultPasswords['admin'] определяет пароль администратора.
  • Установка $EnableUpload в "1" разрешает Закачки ("Прикреплёные файлы"). $DefaultPasswords['upload'] устанавливает пароль на закачку.
  • Переменная окружения TZ определяет часовой пояс.
  • $TimeFmt определяет формат времени и (вместе с TZ) настраивает wiki на конкретную зону времени.

Установкой этих (и других) переменных в local/config.php изменяется внешний вид и поведение PmWiki. Полный список переменных PmWiki смотрите на странице Переменные, а примеры сайтов, использующих PmWiki на странице PmWiki:PmWikiUsers .

Установка пароля администратора

Страницы в группе Site (за исключением Site.SideBar) по умолчанию закрыты. Чтобы разрешить редактировать страницы этой группы, вам надо в файле local/config.php назначить пароль администратора. Пароль администратора в значение "mysecret" устанавливается так:

$DefaultPasswords['admin'] = crypt('mysecret');

Выбирайте пароль с каким-либо осмысленным значением. Подробнее о более безопасном определении паролей смотрите Администрирование паролей

Не меняйте и не переименовывайте pmwiki.php

PmWiki разработана таким образом, чтобы настройка не затрагивала файлы дистрибутива. Одно из достоинств такой организации - это обеспечение простого обновления. PmWiki никогда не меняет файлы в директориях local/ и cookbook/, так что размещение в них ваших настроек упрощает отслеживание изменений и обновление PmWiki без потерь настроек.

При конфигурировании вашего сайта либо изменяйте файл local/config.php, либо добавляйте файлы в папки cookbook/ и pub. Не трогайте pmwiki.php или файлы в директории scripts/, так как они предположительно будут перезаписаны во время обновления.

Вам не следует также переименовывать pmwiki.php. Если вы переименуете его, то он не будет перезаписан во время обновления ПО, что приведёт к возможным сбоям.

Многие администраторы добавляют в папке pmwiki "сценарий оболочку" index.php, который содержит одну строку:

<?php include('pmwiki.php');

Другие настройки

После настройки файла local/config.php вы можете пожелать сделать другую подгонку. Большое количество дополнений вы найдёте на странице Рецептурник PmWiki. И не бойтесь брать из него рецепты - они все хорошо приготовлены, так что большинство из них требуют загрузки всего одного файла, добавки однострочной команды вставки в config.php, и вуаля! - они заработали!

Если вы (или другие совладельцы вашего сервера) захотите поддержать более, чем одну вики на одном сервере, то почитайте страничку ВикиФермы.

Что теперь?

Не забудьте присоединиться к списку рассылок PmWiki, где вы можете списаться с другими вики администраторами для получения помощи в переделке PmWiki и поучаствовать в обсуждениях исправлений PmWiki. Имея же свой собственный действующий PmWiki сайт, не стесняясь, добавьте его на страницу PmWiki:PmWikiUsers так, чтобы другие о вас знали!

<< Установка | Документация | Местная подстройка >>

Перевод страницы PmWiki.InitialSetupTasks -
Оригинал перевода PmWikiRu.InitialSetupTasks -
Ссылаются

PmWikiRu.InitialSetupTasks: редакция от 2012-01-06, 21:35

PmWiki.InitialSetupTasks: редакция от 2019-12-29, 10:27