Manual:Wiki family/ru


 * Требуется помощь с переводом и правка, ибо справка на английском Manual:Wiki family не является достаточной.

Эта страница описывает установку и настройку малых wiki-сайтов.

Сценарий 1: Использование "виртуальных каталогов" на виртуальном хостинге для отображения нескольких вики.
Этот метод использует преимущества символических ссылок ОС семейства Unix. Этот метод можно реализовать и в Windows, установив программное обеспечение, реализующее символические ссылки.

Как заставить работать несколько вики на одном сервере, используя тот же исходный код (т.е. один набор файлов MediaWiki), ту же базу данных, на виртуальном хостинге под ОС семейства Unix при помощи "виртуальных каталогов":

См. руководство, включающее подробные пошаговые инструкции: http://www.steverumberg.com/wiki/WikiHelp_-_Method_One

Заметим, что возможность создания поддоменов как в wikipedia.org (en.example.com, fr.example.com итд.) позволяет вам использовать Метод 2, обеспечивающий простую дифференциацию нескольких вики при помощи виртуальных хостов (VirtualHosts).

Сценарий 2: Быстрая установка
Вы хотите установить несколько вики на один сервер, используя тот же исходный код (т.е. один набор файлов MediaWiki) и одну базу данных?
 * Во избежание путаницы папками называются фактические каталоги в файловой системе сервера, а директориями - виртуальные каталоги, отображаемые в url.


 * 1) Проверьте требования.
 * 2) Загрузите файлы MediaWiki в папку на веб-сервере.
 * 3) Откройте директорию с вики в браузере (например, если ваш веб-сервер доступен по адресу   и файлы MediaWiki загружены в папку , тогда ссылка на вики будет выглядеть так:  ) вы попадете на страницу со ссылкой Please set up the wiki first. Нажмите на ссылку, заполните необходимые поля и установите первую вики (например, MyWiki). Более подробную информацию смотрите на Manual:Config script.
 * 4) После успешной установки переместите LocalSettings.php в корневую папку вашей вики и переименуйте его таким образом, чтобы вы легко смогли понять к какой из вики относится данный конфигурационный файл (например, myWikiLocalSettings.php)
 * 5) Повторите шаги 3 и 4, создавая и переименовывая файл   для каждой вики (например, anotherWikiLocalSettings.php, итд.)
 * 6) Если две или более ранее установленных отдельно вики должны быть объединены (должны использовать тот же исходный код, т.е. один набор файлов MediaWiki), то после переименования и перемещения каждого файла   в корневую папку вики, измените переменную $wgScriptPath в каждом файле , указав текущую корневую папку вики.
 * 7) Создайте файл LocalSettings.php, в котором будут храниться глобальные настройки. Далее возможны два варианта:
 * 8) * Вариант 1: Различные вики используют различные поддомены и одну директорию. Например,,  ,
 * 9) * Вариант 2: Различные вики используют один поддомен и разные директории. Например, ,


 * Вариант 1: Если у вас разные домены/поддомены, которые ссылаются на одну и ту же директорию на вашем сервере:
 * Чтобы разные поддомены ссылались на одну директорию на сервере вам необходимо отредакировать конфигурационный файл вашего сервера ( не достаточно, попробуйте изменить  ), или если ваш сайт имеет собственный ip-адрес, изменить конфигурацию DNS для вашего сайта.

Содержимое :


 * Вариант 2: Если ваши вики находятся в разных директориях (например,,   итд.) и ссылаются на главную директорию вики на вашем сервере (скажем,  ), используйте следующий метод:


 * Если функция strpos найдет искомую строку в начале $callingurl, то функция вернет результат 0 (т.е. искомая строка начинается с позиции 0). Например, если мы обращаемся к адресу, переменная $callingurl будет содержать строку  . Если искомой строкой будет  , вместо приведенной в примере  , то strpos вернет 0. В таком случае вы должны изменить   на.


 * Если вы используете Short URL с Вариантом 2, то вы должны проверять две директории:, для проверки обращений напрямую к папке , и адаптации.

Вы можете использовать разные базы MySQL для каждой вики (смотрите $wgDBname) ИЛИ вы можете использовать разные префиксы таблиц для каждой вики (для Postgresql вы можете достичь аналогичного эффекта с помощью различных схем) (смотрите $wgDBprefix).

Также этот может быть полезен для перенаправления с несуществующих вики на главную вики, вместо дешевой надписи "Эта вики (бла-бла) недоступна. Проверьте конфигурацию."

Обновление вики-хостинга (wikifarm) из командной строки
Этот метод требует установки переменной  для запуска , что, конечно же, невозможно сделать из командной строки. Это ограничение обходится путем создания простого сценария PHP  (Все операции проделываются в корневом каталоге MediaWiki):

Теперь вы можете запустить обновление: php update_subdomain.php subdomain_prefix
 * Кажется невозможным многократный запуск скрипта обновления из этого php скрипта, так как после первого запуска мы не сможем распознать изменившуюся переменную . (Может быть попробовать установить переменные (домены) напрямую в скрипте, как это сделано в ?) Это ограничение обходится путем создания bash скрипта для многоразового запуска нашего php скрипта (назовем скрипт "update_wikifarm.sh"):

Измените префиксы поддеменов на префиксы вашего вики-хостинга, сделайте ваш скрипт исполняемым и запустите его:

chmod ug+x update_wikifarm.sh ./update_wikifarm.sh

Сценарий 3: Drupal-стиль сайтов
Как и ранее, этот сценарий позволяет установить несколько вики на один сервер, используя тот же исходный код (т.е. один набор файлов MediaWiki) и одну базу данных. Преимущества этого метода в том, что он полностью прозрачен для пользователей и достаточно безопасен с точки зрения каталога изображений.


 * 1) Создайте корневую папку, в которой будут располагаться все файлы MediaWiki. Например,.
 * 2) Установите MediaWiki и дополнительные расширения в подпапку с указанием версии движка (Например,  ).
 * 3) Создайте симлинк на эту директорию. Например,
 * 4) Создайте папку sites для хранения конфигураций и рисунков:
 * 5) Установите вики из папки /code.
 * 6) После успешной установки переместите   в необходимую папку. Например, для сайта http://mysite.com/mywiki, создайте папку mysite.com.mywiki. Например,  . Более подробную информацию смотрите в описании файла settings.php Drupal'а.
 * 7) Если вы собираетесь загружать медиафайлы, создайте для них подпапку в папке вашего сайта. Например,  . Пользователь, под которым работает Apache, должен иметь права на запись в эту папку.
 * 8) Поместите файл Drupal-style LocalSettings.php в корневую папку вашей вики:
 * 9) Модифицируйте LocalSettings.php для каждого сайта так, чтобы он указывал на правильное место:
 * 10) * Сначала закомментируйте, касающиеся переменной, (строки 16-20 в 1.15.3), эта переменная будет установлена в файлом   и будет содержать путь к папке code.
 * 11) * Вставьте следующие строки для возможности загрузки и отображения изображений, например:  and  . Их нужно добавить после вызова файла   (строка 25 в 1.15.3), иначе эти переменные будут сброшены в значения по умолчанию.
 * 12) * Сделать дополнительные изменения по необходимости.

 ServerAdmin postmaster@mysite.com DocumentRoot /home/web/wiki.mysite.com ServerName wiki.mysite.com CustomLog /var/log/apache2/wiki.mysite.log common # Алиас для доступности сайта Alias /mediawiki/code /home/web/mediawiki/code # Алиас для папки с изображениями Alias /images /home/web/mediawiki/sites/wiki.mysite.com/images # Если вы хотите защитить паролем ваш сайт #  #   AuthType Basic #   AuthName "My protected Wiki" #   AuthUserFile /etc/apache2/htpasswd/users-mywiki #  require valid-user #  
 * 1) Подготовка Apache 2. Пример приведен для сайта wiki.mysite.com
 * 2) * Создайте линк на папку code, если это необходимо. Например,
 * 3) * Создайте конфигурацию для виртуального хоста:


 * 1) Если вы настраивали сайт локально, обновите ваш файл   вписав имена сайтов.

Теперь ваш сайт должен работать. В моем случае, я сделал еще одну копию кода, из которой я устанавливал и обновлял LocalSettings.php и базы данных.

Учтите, что используемая Drupal'ом переменная  не будет установлена, если скрипты обслуживания запущены из командной строки, поэтому данное решение не позволит вам использовать скрипты обслуживания без некоторых модификаций.

Сценарий 4: Распределение общих ресурсов между несколькими вики
You want to have some wikis in different languages, sharing the same media-files in another, single wiki.

For example:


 * en.yourwiki.org - English language
 * fr.yourwiki.org - French language
 * de.yourwiki.org - German language
 * pool.yourwiki.org - media-files for all of these wikis (like Commons).
 * As there is already an Interwikilink named commons for Wikimedia Commons, we name our media-files-wiki "pool".
 * Think before being creative; if you call your media-files-wiki something like "media" (e.g. media.example.com), it might collide with internal namespaces and nomenclature for embedded media files ( [[media:file.ext]] ).

Установка Install
On your filesystem, create a folder for each wiki. Run the install script for each wiki.

(This solution duplicates source code. You may wish to replace the include, skin, language and extension directories for non-pool installations with symbolic links to the pool's directories [rm -r include && ln -s pooldir/include etc.] to improve cache performance.)

Интервики Interwiki
Now you have to set Interwikilinks between all wikis, by editing their MySQL-Databases (if you prefer, install and use Extension:Interwiki)
 * Table Interwiki
 *  iw_prefix - enter the language-code of the wikis, "de" for German, "en" for English, "fr" for French and "pool" for the mediapoolwiki
 *  iw_url - this is the place for the complete URL to the wikis, e.g. " http://de.yourwiki.org/index.php/$1 " for the German wiki (don't forget the "$1" !).

Now you can link an article to the same in another languages. Adding Hauptseite on your English Main_Page will create a link "Deutsch" (under the Navigation bar) which leads to the Main_Page of the German wiki (Hauptseite). For further information visit Help:Interwiki linking

Загрузка
Make sure that folder "images" of the pool-wiki is writable.

It is useful to change the "Upload file"-Link of the language-wikis to point to poolwiki's upload-site. Open the "LocalSettings.php" of each language-wiki and add:

Использование общих файлов
To use poolwiki's files in the languagewikis, open "LocalSettings.php" for each languagewiki and add:

Now you can integrate pool's files with (e.g.) in the languagewikis.

Описание изображения
In each languagewiki, open (as an admin) the message MediaWiki:Sharedupload.

Change the text to something like: This file is stored in our data-pool. For information and description, please visit the

description there. (And note the ':' at the beginning of the line, which stops 'pool' from being included in the interwiki list at the left of the page.)

If you want to output the media-description, stored in the PoolWiki, too, add to the "LocalSettings.php" of the languagewikis:

Общие настройки
If you have multiple wikis, you'll probably want to share similar settings across them all. Here is how to do that. We recommend that you separate your Extension settings into a different file than your other settings, as detailed below. They can be all put into one large file, but it's not as flexible depending upon your specific needs.

Here is an example directory structure if you do all of the following: en/ es/ pl/ ja/ pool/ ExtensionSettings.php WikiFamilySettings.php SharedMediaSettings.php

Extension Settings

 * Step 1
 * Create a file called ExtensionSettings.php with the following contents, and place it in a location similar to the example above.
 * Step 2
 * Edit the LocalSettings.php file of each wiki that you want to use the shared settings, and add the following.
 * Step 3
 * Now just add all the references to your various extensions

Wiki Family Settings
These are settings that you want to apply to the entire wiki family. For example, maybe you want to be able to easily put all the wikis into read-only mode at the same time. You can also store the username/password for the database(s), if they are all the same. Additionally, you could control user permissions across your entire wiki from this one file.

Note: If you use a Images/Media commons or pool, we recommend that you not put these settings in the WikiFamilySettings.php file. That information only applies to every wiki in your wiki family other than your repository. We recommend putting it in a separate file.

Shared database tables
See Manual:Shared database for instructions on setting up shared database tables.

Сценарий 5: Несколько проектов Вики посредством Правил Подстановки
Этот подход основан на работе Мизэнура Рахмана (Mizanur Rahman) (см. Boolean Dreams Article и также есть элементы, указанные выше в . Следуйте за шагами 1-5 в чтобы установить отдельный Вики-проект. Затем модифицируйте файл LocalSettings.php для каждого Вики-проекта, внеся примерно следующие строки:

Wiki 1 Local Settings File:

Similarly for Wiki 2 Local Settings File:

Необходимо также создать главный файл настроек, с примерным содержанием, описанным в шаге 7 в, чтобы выбрать соответствующий файл локальных настроек (local settings file) для wiki1 или wiki2 лежащий в основе URL.

Наконец, в файл .htaccess необходимо внести Правило Подстановки (RewriteRules), чтобы URL статей отображались в виде стандартных URL Вики, а нестатейные URL указывали на директорию, с исходниками Вики. Если предположить, что исходники Вики физически установлены на сервере в директорию '/w/', то файл .htaccess должен содержать примерно следующие строки:

Fix для скриптов обслуживания
Скрипты обслуживания работают напрямую, не через URL, таким образом Правила Подстановки не будут обеспечивать соответствующий URL для главного файла настроек LocalSettings.php в $_SERVER["SERVER_NAME"] или $_SERVER['REQUEST_URI']. Чтобы работало окружение, используйте отдельную глобальную переменную, чтобы предложить альтернативный метод выбора (или выбор метода) и задать переменную после командной строки, вызывающей скрипты обслуживания. Правильный главный файл настроек LocalSettings.php должен выглядеть примерно так:

Затем, из командной строки запускается скрипт обслуживания, такой как importImages.php:

В данном случае параметр -d модифицирует настройку auto_prepend_file в php.ini, чтобы выполнить файл перед скриптом importImages.php. Этот файл задает глобальную переменную для выбора Вики-проекта:

Другими словами мы можем определить, какой Вики-проект мы обслуживаем, и выделяем необходимый файл AdminSettings.php. Можем радоваться (танец с бубном закончен)...

Итоговое минималистское решение
Итоговое минималистское решение состоит из символьных ссылок, $ ls -og lrwxrwxrwx 1 16 2008-11-03 06:29 aaa.example.org -> mediawiki lrwxrwxrwx 1 16 2008-11-03 06:29 bbb.example.org -> mediawiki lrwxrwxrwx 1 16 2008-11-03 06:29 ccc.example.org -> mediawiki Посмотрим реальный пример. В реальной ситуации у вас будут, вероятно, незначительные отличия в именах сайтов и баз данных, которыми Вы управляете. Примечательно, что мы и поныне отдельно подготавливаем задачи, связанные с базой данных, например php update.php. (Вышеуказанный код должен определить к каким вики-проектам обращается update.php.) Обновление просто, если Вы используете SVN (download from SVN). (Надеюсь нет больше кода (code), который предполагает, что есть только один Вики-проект на диске...)

Изображения
Если вы не позволяете загрузку или позволяете только для вашего пула wiki, Вы должны создать отдельные каталоги изображений и указать их псевдонимы в вашей vhost конфигурации:, а также в aaa.example.org's vhost: . Таким же образом для bbb и ccc.

Однако вместо этого можно предпочесть альтернативную простую установку Manual:Image Administration, где *.example.org/images/ только указывает на ту же самую директорию. В качестве примера: *.example.org/$wgDBname/images/.

Добавление новых вики
Добавление новых wiki к существующему семейству wiki
 * 1) добавьте конфигурацию в свой web сервер
 * 2) временно закомментируйте  проверьте наличие config/index.php и затем выполните его
 * 3) merge the config/LocalSettings.php produced into LocalSettings.php
 * 4) add some pages

Удаление старых вики
Удаление wiki из семейства wiki-проектов
 * 1) удалите его конфигурацию из
 * 2) web server
 * 3) LocalSettings.php
 * 4) DROP DATABASE

Wiki использование расширений (Farmer Extension)
см. Extension:Farmer

Метод, используемый фондом Wikimedia
Еще возможно использовать метод, который использует фонд Wikimedia. Ниже упоминаются приблизительные шаги. Этот метод не для слабонервных, но он дает довольно хорошие результаты. Фонд Wikimedia добился успеха при использовании этого метода :-)  Сконфигурируйте шаблонную копию MediaWiki через онлайн мастер конфигурации. Отредактируйте Заглавную страницу если Вы хотите Заглавную страницу, которая будет использоваться по умолчанию, создать на своей ферме. После этого, экспортируйте свою базу данных с, phpMyAdmin, и т.д. Сохраните это на своем сервере в maintenance/ directory примерно как наподобие  . Теперь, напишите несколько быстрых сценариев, чтобы создать новую wiki. В сущности, Вы должны добавить это в список wiki-проектов, который может быть на основе простого неструктурированного файла или на базе MySQL/SQLite, затем импортировать дамп базы данных об эталонах назад в базу данных под именем новой wiki. Используйте стандартную приставку после нового имени базы данных (то есть, если wiki-проект называется например meta.yourdomain.net, то Вы могли бы выбрать metawiki в качестве имени базы данных). В Вашем файле конфигурации, добавьте что-то вроде нижеследующего, устанавливая префикс базы данных и Ваш домен в случае необходимости:  Сконфигурируйте свой DNS с подстановочным знаком А запись, и apache с псевдонимом сервера (like ), и можете вести бизнес. Configure your DNS with a wildcard A record, and apache with a server alias (like ) and you should be in business.</li> </ol>

Скрипт maintenance/update.php может быть запущен из другого php скрипта, например update_farm.php, и этот внешний скрипт установит различные параметры сервера, которые необходимы вашему LocalSettings.php чтобы установить корректный $wgDBname: и, чтобы обновить meta.yourdomain.net, запустите из вашего уникального mediawiki каталога следующую командную строку: php update_farm.php meta.yourdomain.net Ваш уникальный LocalSettings.php (который обычно состоит из нескольких строк, включающий в себя CommonSettings.php, не непосредственно доступный с сервера) декодирует переменную meta и установит $wgDBname в соответствии с этим.

The DOCUMENT ROOT directory (аналогичный набору значений в вашем httpd.conf) может также использоваться в вашем CommonSettings.php, чтобы иметь больше приспособляемости при использовании тестового сервера.

Вы должны также указать местоположение каталогов загрузки, если вы хотите (не хотите), чтобы каждая wiki использовала те же самые файлы. Как сказано выше, это - вероятно, один из самых трудных методов в выполнении и он требует большего технического опыта, но он может дать действительно хорошие, чистые результаты.

Пошаговая инструкция
На Сисадминвики есть несколько пошаговых инструкций по созданию и настройке вики фермы (семьи).

См. также

 * Configuration database
 * Extension:CentralAuth