13 июн. 2000 г.

Mediawiki


Mediawiki

Инсталяция

Системные требования:
  • web-server Apache
  • PHP 5 или старше рекомендуется 5.1
  • MySQL
С системными требованиями к mediawiki можна познакомиться на оффициальном сайте
  • 1. Загрузить mediawiki можна здесь .Я брал версию mediawiki-1.10.1
  • 2. Распаковать файл в папку вашего web-server-а (если Apache, то она указана в файле httpd.conf). На linux системе это можна сделать командой tar xvzf mediawiki-*.tar.gz
  • 3. Установить права доступа для папки config. (chmod 755 config)
  • 4. Создать базу данных. Я опишу процесс создания для MySQL для остальных СУБД можна посмотреть здесь.
Если у вас есть права администратора для MySQL, то эту процедуру можна пропустить. Инсталяционный скрипт сделает все сам.
Если прав нет,то запустите /usr/local/mysql/bin/mysql -u user_name -p mysql . Эта команда запустит командную строку клиента MySQL
 
CREATE DATABASE wikidb;
GRANT CREATE, SELECT, INSERT, UPDATE, DELETE, ALTER, LOCK TABLES ON
wikidb.* TO 'wikiuser'@'localhost' IDENTIFIED BY 'password';
FLUSH privileges;\q
 
Если ваш сервер запущен на другой машине
 
GRANT CREATE, SELECT, INSERT, UPDATE, DELETE, ALTER, LOCK TABLES ON
wikidb.* TO 'wikiuser'@'mediawiki.example.com'
IDENTIFIED BY 'password';
 
Когда все эти шаги пройдены, можна запускать инсталяционный скрипт.Для этого необходимо написать в вашем браузере http:\\name_of_your_machine\wikifolder (я периименовал папку mediawiki-1.10.1 в wiki и т.о строка в браузере имеет вид http:\\slackware\wiki ). Далее вы получите предупреждение что, папка config (path_to_wiki\wiki\config) защищена от записи и предлагают вам выполнив команду
 
  cd /path/to/wiki
        chmod a+w config
 
запустить скрипт снова. После этого вам необходимо будет указать некоторые детали вашей вики (имя, тип СУБД и т.п). Для того чтобы закончить процесс инсталяции необходимо переместить файл config/LocalSettings.php на один уровень выше – именно переместить, не скопировать. Все ваша вики готова.

Настройка

Теперь вики необходимо настроить. Постараюсь описать самые важные (на мой взгляд), про остальные настройки можна прочитать здесь

Изменить название

Открываем файл LocalSettings.php, тот самый который мы переместили при инсталяции, ищем переменную $wgSitename и присваиваем ей необходимое значение.
 
    $wgSitename         = "RSDN Test";
 

Изменить лого

В мануале написано, что необходимо указать путь к новому лого-изображению (135х135)
 
    $wgLogo = “The URL of the site logo.”
 
Что я только там не указывал, а лого так и не изменилось, может я что не так делал,может баг(не было времени заглянуть в багтрекер). Необходимо заменить изображение
/path_to_wiki/skins/commons/images/wiki.png на ваше изображение. (Изображение должно быть размером 135х135).

Настроить загрузку файлов

Для того чтобы загружать файлы на вики, необходимо установить
 
    $wgEnableUploads = true;
 
и дальше заполнить массив , расширениями тех файлов, которые вы хотите разрешить загружать в вики. Например так,
 
    $wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'ppt', 'pdf', 'doc', 'psd', 'mp3','xls', 'zip');
 
Далее, необходимо иметь в виду, что ограничение на размер файла зависит от настроек php и по умолчанию это 2Мб. Нужно учесть что загрузка файлов, может быть вообще запрещена в php и это может быть причиной почему не загружаются файлы.

Настройка прав редактирования

Для того чтобы запретить незарегистрированным пользователям редактировать страницы необходимо установить
 
    $wgGroupPermissions['*']['edit'] = false;
 
а для того, чтобы запретить чтение необходимо установить
 
    $wgGroupPermissions['*']['read'] = false;
 
Про остальные настройки прав пользователей и групп можна почитать User rights

Встраиваемые картинки

Для того чтобы ваши картинки отображались на страничке необходимо установить переменную
 
    $wgAllowExternalImages = true;
 

Плагины

Из плагинов я бв отметил SyntaxHighlight_GeSHi для расскраски кода, далее CategoryTree, показывает статьи категории в виде дерева.
Все полагины ставаться одинаково, необходимо положить файл плагина в папку /path/to/wiki и затем подключить в файле LocalSettings.php этот плагин
 
require_once("{$IP}/extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php");
require_once("{$IP}/extensions/CategoryTree/CategoryTree.php" );
 
Нужно внимательно читать инструкцию по установке плагина, т.к они часто зависят либо от какого-то другого плагина, либо предполагают установку какой-то программы.

Заключение

Вики я поставил и доволен, всеми она активно не используется и врядли будет(если ребята за 7-8 лет разработки так и неудосужились написать документацию), но 2-3 пользователя ее используют активно :-). Одно из своих требований я так и не смог удовлетворить, а имеено Email нотификацию, вернее я ее сделал, но криво — через внешний mail server, а хотелось через родной mail server линукса, на котором стоит вики, но у меня не получилось настроить sendmail. Я нашел обходной путь в wiki есть рсс фид, подписавшись на который можна иметь точно такой же список измкнений как и при Email нотификации.
Полезные ссылки