Manual:Running MediaWiki on Windows/ru

Установка MediaWiki на локальный компьютер с операционной системой Windows

Прежде чем читать инструкцию дальше, следует учесть, что после установки сервера приложений на компьютер, подключённый к общедоступной сети, любой человек может получить административный доступ к базе данных через phpmyadmin! Чтобы этого избежать, установите firewall (брандмауэр) и закройте от внешнего доступа порты 80, 443 и 3306 перед началом установки. При использовании Windows XP SP2 можно просто включить встроенный брандмауэр — по умолчанию он запрещает любые соединения на любые порты.

Установка сервера приложений

Перед непосредственной установкой MediaWiki вам необходимо установить на компьютер такие приложения, как Apache, PHP и MySQL. Начинающие пользователи могут сделать это с помощью установки сервера этих приложений. В качестве сервера приложений можно выбрать STPServer 1.0 (не работает в Windows Vista) или XAMPP (MySQL может не запуститься без перезагрузки компьютера).

Популярным решением для установки Apache, PHP и MySQL на локальную Windows-машину является Денвер.

Следующий текст описывает установку сервера приложений STPServer 1.0.

Скачайте сервер приложений STPServer 1.0. Установите его на ваш компьютер. На вашем компьютере появится дополнительный виртуальный диск. Как правило, это диск T:

Запустите ваш браузер и в строке адреса введите: http://localhost/

Если вы увидели стартовую страницу, то это значит, что установка сервера приложений прошла нормально.

Создание базы данных

На стартовой странице сервера приложений перейдите в панель администрирования: http://admin

Если зайти не удалось (страница недоступна), то подредактируйте файл C:\WINDOWS\system32\drivers\etc\hosts таким образом, чтобы он содержал следующую строку

127.0.0.1 localhost admin second prime test

Если страница нашлась, то в меню авторизации введите имя и пароль (по умолчанию, оба - admin)

В меню выберите MySQL.

В правом окне выберите приложение phpmyadmin.

Запустите http://localhost/phpmyadmin/ — это утилита администрирования MySQL.

В поле справа Язык - Language выберите язык Russian.

В поле Новая база данных впишите имя базы данных (wikidb).

В поле Сравнение выберите utf8_unicode_ci (как вариант utf8_general_ci).

Нажмите кнопку Создать.

Вы должны получить сообщение: База данных wikidb была создана.

Нажмите в браузере кнопку "Назад" и выберите пункт Привилегии.

Нажмите на Добавить нового пользователя.

• В поле Имя пользователя укажите - wikiuser
• Для поля Хост из выпадающего списка выберите Локальный или localhost
• В полях Пароль и Подтверждение укажите пароль пользователя (например 123456)
• Назначьте глобальные привилегии с помощью ссылки Отметить все

Нажмите кнопку Пошёл.

Вы должны получить сообщение: Был добавлен новый пользователь.

Создание базы данных вручную

При установке MediaWiki на локальный компьютер под управлением OC Windows следующие разделы по созданию базы данных вручную можно пропустить и сразу перейти в раздел Установка программного обеспечения MediaWiki.

Если Вам известен пароль от пользователя root, установочный скрипт MediaWiki сможет создать базу даных автоматически. В этом случае, Вы можете перейти к секции Запуск инсталляционного скрипта. Если же этот пароль Вы не знаете, к примеру если Вы пользуетесь услугами веб-хостера, Вам необходимо создать базу данных вручную. В данный момент MediaWiki поддерживает СУБД MySQL и PostgreSQL.

MySQL

• Вам необходимо создать базу данных и пользователя, прежде чем устанавливать MediaWiki. Данные операции можно сделать через различные веб-приложения, такие как PhpMyAdmin. Также, Вы можете подключиться к серверу посредством ssh и ввести нужные команды в командную строку MySQL.
  1. Загрузите и установите MySQL 5.0.
     
  2. Проверьте запустился ли сервер баз данных («/usr/local/mysql/bin/mysqladmin status»), если нет - выполните sudo /usr/local/mysql/bin/safe_mysqld &.
     (В ОС Fedore Core 5, используйте /usr/bin/mysqld_safe)
     
     1. Администратор также может выполнить скрипт «configure» в корневом каталоге установки. Скрипт создаст начальные таблицы и автоматически запустит демона mysql.
  3. Назначьте пароль для пользователя «root» в вашем сервере баз данных: usr/local/mysql/bin/mysqladmin -u root password вашпароль
     
  4. Настройте пользователя MySQL для Вашей Вики - выполните в терминале: /usr/local/mysql/bin/mysql -u root -p mysql
     
  5. Запустится клиент MySQL, с помощью него создайте базу данных для Вики и назначьте пользователю нужные права на неё:

 create database wikidb;
 grant create, select, insert, update, index, delete, alter, lock tables on wikidb.* to 'wikiuser'@'localhost' identified by 'password';
 flush privileges;
 \q

Если СУБД работает не на том же сервере, что и веб-сервер, то пользователю wikiuser необходимо вписать соответствующий параметр. В примере вверху, исправьте localhost на mediawiki.example.com, естественно подставив правильный хост:

 grant create, select, insert, update, delete, alter, lock tables on wikidb.* to
 'wikiuser'@'mediawiki.example.com' identified by 'password';

Postgres

If you are using Postgres, you will need to either have a database and user created for you, or simply supply the name of a Postgres user with "superuser" privileges to the configuration form. Often, this is the database user named postgres.

The database that MediaWiki will use needs to have both plpgsql and tsearch2 installed. The installer script will try to install plpgsql, but you may need to install tsearch2 yourself. (tsearch2 is used for searching the text of your wiki). Here's one way to do most of the setup. This is for a Unix-like system, and assumes that you have already installed the plpgsql and tsearch2 modules. In this example, we'll create a database named wikidb, owned by a user named wikiuser. From the command-line, as the postgres user, perform the following steps.

 createuser -S -D -R -P -E wikiuser (then enter the password)
 createdb -O wikiuser wikidb
 createlang plpgsql wikidb

Adding tsearch2 to the database is not a simple step, but hopefully it will already be done for you by whatever packaging process installed the tsearch2 module. In any case, the installer will let you know right away if it cannot find tsearch2.

The above steps are not all necessary, as the installer will try and do some of them for you if supplied with a superuser name and password.

For installing tsearch2 to the wikidb database under Windows, do the following steps:

1. find tsearch2.sql (probably under .\PostgreSQL\8.x\share\contrib) and copy it to the postgresql\8.x\bin directory;
2. from a command prompt at the postgresql\8.x\bin directory, type "psql wikidb < tsearch2.sql -U wikiuser";
3. it will prompt you for the password for wikiuser;

That's it!

Point (2) seems only to work on windows, cause on debian linux 4.0 (etch) only user postgres is allowed to use language c. so there it must be called by:

su - postgres -c psql wikidb < tsearch2.sql

afterwards you must grant select rights to wikiuser to the tsearch tables and insert the correct locale.

su - postgres
psql -d wikidb -c "grant select on pg_ts_cfg to wikiuser;"
psql -d wikidb -c "grant select on pg_ts_cfgmap to wikiuser;"
psql -d wikidb -c "grant select on pg_ts_dict to wikiuser;"
psql -d wikidb -c "grant select on pg_ts_parser to wikiuser;"
psql -d wikidb -c "update pg_ts_cfg set locale = current_setting('lc_collate') where ts_name = 'default' and prs_name='default';"

If you receive an error similar to "ERROR: relation "pg_ts_cfg" does not exist" when executing the above statements, try installing tsearch2 to the wikidb database again, but instead use these two separate steps (and then try the grant statements again):

1) su - postgres
2) psql wikidb -f tsearch2.sql

Загрузка MediaWiki

Загрузите программный пакет MediaWiki с официальной страницы загрузки или с помощью клиента клиента SVN.

С помощью любого подходящего архиватора (7-Zip (открытое ПО), WinZip, WinRAR) распакуйте файлы из архива MediaWiki. Будет создана папка с инсталляционными файлами MediaWiki, например папка mediawiki-1.12.0.

С помощью FTP-клиента (FileZilla (открытое ПО, Windows) или Cyberduck) закачайте файлы на ваш сервер в правильный каталог. Для веб-сервера Apache путь до каталога с веб-сайтами прописывается в файле http.conf. Также, вы можете скопировать файлы в любой каталог на вашем сервере и сделать символьную ссылку на эту папку из веб-директории вашего сервера.

Инсталляция MediaWiki при использовании сервера приложений

Всё содержимое разархивированной папки (все файлы и вложенные папки) скопируйте в папку T:\home\virtual\prime\. Перейдите в эту папку и удалите из неё файлы index.html и index.htm. Эти файлы были скопированы сервером приложений, но они нам уже не нужны.

В строке браузера наберите адрес http://prime.

Вы должны увидеть сообщение:

You’ll have to set the wiki up first! 

Перейдите по ссылке set the wiki up.

В разделе Site config заполните поля:

• Site name — Википедия
• Language — выберите Русский
• Sysop account name — укажите любое имя (это будет пользователь с правами администратора Википедии)
• Sysop account password — укажите пароль, в поле again его нужно повторить

В разделе Database config заполните поля:

• Database name — имя базы данных. Можно оставить значение по умолчанию wikidb
• DB username — имя пользователя для подключения к базе. Можно оставить значение по умолчанию wikiuser. Он понадобится только в процессе настройки.
• DB password — пароль пользователя. Например 123456, в поле again его нужно повторить
• Super user — введите то же что и в DB username
• Password — введите то же что и в DB password

Нажмите Install!.

Должно появиться сообщение:

Success! Move the config/LocalSettings.php file into the parent directory, then follow this link to your wiki.

Перенесите (именно перенесите, а не скопируйте!) файл T:\home\virtual\prime\config\LocalSettings.php в папку T:\home\virtual\prime\.

Удалите папку T:\home\virtual\prime\config\.

Вернитесь в браузер и нажмите ссылку this link, то есть перейдите по адресу http://prime.

Вы увидите пустую Википедию. Поздравляем вас с удачной установкой MediaWiki!

Для того чтобы закачать в Википедию базу данных статей (дамп Википедии) необходимо проделать ещё ряд действий.

Смотри также:

ru:Википедия:Как_сделать_копию_Википедии

Запуск инсталляционного скрипта

Как только все предыдущие шаги будут пройдены, следует запустить конфигурационный скрипт в веб-браузере. См. подробную информацию в разделе Manual:Config script/ru.

Дополнительное программное обеспечение

Поддержка математики

MediaWiki использует программу называемую texvc для преобразования математических выражений в приятные глазу PNG.

Есть способ установить вывод мат. формул на основе JavaScript.

• MathJax http://www.mathjax.org/ Расширение для MediaWiki: Extension:MathJax
• JsMath http://www.math.union.edu/~dpvc/jsmath/welcome.html Расширение для MediaWiki: Extension:JsMath

Эти способы не требуют наличия специальных знаний по конфигурированию Линукс.

Так как texvc была разработана на и для Linux, достать и запустить её на Windows может быть довольно хлопотно, так что рекомендуется использовать способ приведенный ниже.

Примечание: Поддержка математики является строго дополнительной опцией. Ваша вики будет прекрасно работать и без неё, хотя она вам понадобится, если вы хотите ввести сложные формулы.

Использование LatexRender

Решение с использованием LatexRender (благодарности Бенджамину Зеиссу (Benjamin Zeiss), завершена MetaSharp). Пути даны как пример, вы можете использовать свои собственные, но имена должны быть короткими и не содержать пробелов. Этот метод был успешно протестирован на различных версиях MediaWiki: 1.10.0, 1.13.1, 1.15.1 и на MediaWiki 1.16.0.

Установка

1. Установите полную версию MikTeX (используйте сетевой установщик MiKTeX Net Installer для установки Сomplete MiKTeX System) в C:\wikitex\miktex
2. установите статическую (static) версию ImageMagick в C:\wikitex\imagick (убедитесь что в выбранных вами путях нет пробелов)
3. установите AFPL GhostScript в C:\wikitex\ghostscript
4. сделайте копию файла gswin32c.exe расположенного в С:\wikitex\ghostscript\gs8.54\bin\ переименовав его в gs.exe.

   (цифра 8.54 может быть другой в зависимости от установленной вами версии)

5. добавьте системную переменную PATH с значением: C:\wikitex\ghostscript\gs8.54\bin

   (Пуск -> Панель управления -> Система -> Дополнительно -> Переменные среды)

6. откройте командную строку

   (Пуск -> Выполнить -> cmd.exe)

7. проверьте работоспособность следующих команд:

latex
dvips
convert (не встроенный windows инструмент!)
gs

Настройки

(ваша папка с Вики = $)

• замените файл $/includes/Math.php на этот
• вставьте в $/LocalSettings.php:

$wgUseTeX= true;

• вставьте в $/LocalSettings.php:

#ImageMagick
$wgImageMagickConvertCommand    = 'C:\wikitex\imagick\convert.exe';
$wgImageMagickIdentifyCommand   = 'C:\wikitex\imagick\identify.exe';
#Tex
$wgLaTexCommand                 = 'C:\wikitex\miktex\miktex\bin\latex.exe';
$wgDvipsCommand                 = 'C:\wikitex\miktex\miktex\bin\dvips.exe';

• перезагрузитесь если необходимо, чтобы пути переменных обновились

Проверка

• и вуаля ;) Теперь вы можете попробовать посмотреть работает ли она. Введите в статье что-то вроде этого

<math>\sqrt{2}</math>

если всё работает, то вы увидите:

$\sqrt{2}$

• папки "math" и "tmp" создадутся в "images" автоматически.