Manual:System administration/ru

На этой странице описаны задачи администратора, которые необходимо выполнить после завершения установки MediaWiki.

Включение/отключение загрузки файлов

 * Смотрите справку по настройке функции загрузки файлов

Назначение полномочий пользователям
MediaWiki - система, основанная на разделении прав. Это означает, что каждый пользователь может делать лишь то, что ему разрешено. Назначение прав отдельно каждому пользователю - слишком нудная процедура, поэтому, предпочтительнее, использовать группы доступа. Назначение групп можно производить по средствам редактирования БД таблицы user_groups, где user_groups.ug_user - Идентификатор пользователя, а user_groups.ug_group - идентификатор группы пользователей. Для стандартных настроек это: bureaucrat, sysop, bot и user. Вы можете использовать, как встроенные группы, так и создавать новые (некоторым расширениям необходимо создание новой группы доступа).

Редактирование групп пользователей производится с помощью соответствующей настройки параметра $wgGroupPermissions в файле LocalSettings.php.


 * meta:Help:Setting user rights in MediaWiki
 * Manual:Preventing access
 * Paranoid Permissions

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

Администратор
Наиболее частый случай использования. Пользователь, наделённый флагом администратора ('sysop') может удалять и восстанавливать статьи, блокировать и разблокировать IP/пользователей, выполнять SQL-запросы на чтение к базе данных, а также использовать функцию откатить к предыдущей версии пользователя при просмотре вклада участника. (Для подробной информации смотрите Wikipedia:Administrators.)

Бот
Зарегистрированный аккаунт бота. Правки с этого аккаунта не будут отображаться на спецстранице свежих правок (при настройках по-умолчанию). Подобные аккаунты используются для массового редактирования (чаще всего 'заливок') статей, при этом все правки скрыты от обычных участников (чтобы всё-таки увидеть подобные правки, добавьте к веб-адресу страницы списка свежих правок параметр &hidebots=0, как здесь).

Изменение оформления
На данный момент, доступные следующие стили оформления:

Для изменения темы оформления по-умолчанию, отредактируйте параметр $wgDefaultSkin в файле LocalSettings.php. Некоторые другие настройки также относятся к стилям оформления.

Локализация
Интерфейс MediaWiki переведён более чем на 100 языков, но, при необходимости, вы можете создать собственный вариант локализации. Все интернациональные сообщения расположены в пространстве имён MediaWiki: вы можете найти нужную вам страницу и отредактировать её (ваша учётная запись должна обладать правом 'editinterface', которое, по-умолчанию, есть у администраторов).

Если вы просто хотите изменить язык вашего вики-проекта на один из имеющихся, измените соответствующий параметр в настройках. Если вы выбрали неверный язык при установке MediaWiki, измените $wgLanguageCode в LocalSettings.php.

В MediaWiki постоянно добавляются новые возможности, поэтому некоторые сообщения могут быть не переведены. Если вы перевели часть интерфейса, пожалуйста отправьте ваши изменения Bugzilla, чтобы другие пользователи могли их использовать.

Обновление MediaWiki

 * Смотрите Manual:Upgrading/ru

Наполнение вики-проекта: импортирование дампа базы данных
Если вы хотите импортировать какие-либо статьи в ваш локальный вики-проект, вы можете воспользоваться дампами (снимками) базы данных различных сайтов Wikimedia. Некоторую информацию вы можете найти здесь, а сами дампы можно скачать с download.wikipedia.org.

Установка необходимого ПО
Для распаковки архивов вам потребуется утилита ru:bzip2 (также подойдёт ru:WinRAR или ru:7-zip).

bzip2 можно совершенно бесплатно скачать со следующих сайтов:
 * Microsoft Windows: Windows-версия bzip2, работающая в режиме командной строки доступна под лицензией BSD . Архиватор 7-zip с графическим интерфейсом, распространяемый под лицензией LGPL, способен открывать запакованные bz2 файлы.
 * GNU/Linux: большинство дистрибутивов уже имеют утилиту bzip2. К примеру, пользователи Debian/GNU Linux могут установить bzip2 с помощью apt-get.
 * MacOS X: имеет встроенную утилиту bzip2.

Скачивание дампов
Дампы базы данных Википедии и других сайтов WikiMedia доступны на download.wikipedia.org (смотрите meta:Data dumps для более подробной информации). Вы можете скачивать их бесплатно и использовать на основе лицензии GNU Free Documentation License.

Дампы создаются несколько раз в месяц, однако, создание полных дампов самых крупных проектов может продолжать несколько недель, а размер базы данных при этом достигает десятков гигабайт.

На download.wikipedia.org размещён алфавитный список проектов WikiMedia. Для каждого проекта доступны как полные дампы со всеми версиями статей, так и дампы только текущих версий.

Заметьте, что в дампы попадают только страницы описаний изображений, но не сами изображения или звуковые файлы.

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

9aa19d3a871071f4895431f19d674650 enwiki-20080103-pages-meta-current.xml.bz2

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

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


 * GNU/Linux: md5sum - часть текстовых утилит GNU (называемых теперь утилиты ядра GNU); их можно загрузить с сайта www.gnu.org, однако, они и так включаются в каждый дистрибутив GNU/Linux.
 * Microsoft Windows: например: md5sum.exe (48 кб) или ;
 * MacOS X: имеет встроенную утилиту /sbin/md5.

Другая широко известная утилита, openssl, также может генерировать контрольные суммы MD5: openssl md5 the_filename

Если контрольные суммы файлов совпадают - распакуйте архивы, в противном случае, скачайте их заново.

Импортирование дампа базы данных
Для правильного отображения интервики-ссылок необходимо импортировать соответствующий дамп:

mysql -u wikiadmin -padminpass wikidb < interwiki.sql.gz

Далее импортирование дампа собственно страниц:

php maintenance\importDump.php < maintenance\ruwiki-20080109-pages-meta-current.xml

В зависимости от мощности компьютера, этот процесс может занять от нескольких минут до нескольких часов.

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

Перейдите в корневой каталог вашего вики-проекта, переименуйте файл AdminSettings.sample в AdminSettings.php. Замените в нём wikiadmin и adminpass на ваши логин и пароль от базы данных. Затем выполните следующую команду:

php maintenance\rebuildall.php

Процесс переиндексации занимает очень много времени, но не следует его прерывать.

Изображения и загруженные файлы
Архивы изображений и файлов с сайтов Wikimedia в данный момент не создаются по лицензионным соображениям, однако, вы можете использовать утилиты для полуавтоматической загрузки файлов - см. meta:Data_dumps.

Резервное копирование данных: создание дампа базы данных
Вы можете создать резервную копию работающей базы данных используя программу mysqldump. Пример строки запуска: mysqldump --user= --password= \  > wiki-mysql-dump.txt где параметры запуска mysqldump должны соответствовать параметрам из вашего файла LocalSettings.php следующим образом:

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

Для избежания этого я написал небольшой скрипт, делающий "горячее копирование" базы данных.

OLDAGE=10d CURDATE=`date "+%Y.%m.%d"` DESTDIR=/path/to/backup/destination WIKIWEB=/path/to/html/wiki echo "================================" echo "Backing up the database files..." cd $DESTDIR /usr/local/bin/mysqlhotcopy -u wikiuser -p wikipass wikidb $DESTDIR mv wikidb wikidb.$CURDATE echo "================================" echo "Checking for database corruption..." cd wikidb.$CURDATE /usr/local/bin/myisamchk -e -s *.MYI cd .. echo "================================" echo "Creating tarball..." tar -czpf wikidb.$CURDATE.tgz wikidb.$CURDATE rm -rf wikidb.$CURDATE echo "================================" echo "Copying LocalSettings.php (if needed)..." cp -nv $WIKIWEB/LocalSettings.php. echo "================================" echo "Incrementally copying the images..." /usr/local/bin/rsync -av $WIKIWEB/images. echo "================================" echo "Removing old backups" find $DESTDIR -name "wikidb.*.tgz" -ctime +$OLDAGE | xargs rm
 * 1) !/bin/sh
 * 1) cp -Rpnv $WIKIWEB/images.
 * 1) the above will try to return rm file not find when the find return nothing
 * 2) its better to use
 * 3) find $DESTDIR -name "wikidb.*.tgz" -ctime +$OLDAGE -exec rm -f {} \;

echo "================================" echo -n "backup script completed " date

(Может содержать незначительные ошибки. Я хочу сделать скрипт более универсальным перед публикацией) --NickT 01:04, 1 Sep 2004 (UTC)

Если у вас возникли проблемы при использовании этого скрипта, действуйте следующим образом:


 * Проверьте пути (`which mysqlhotcopy myisamchk')
 * Удалите опцию -n в cp.
 * Подключитесь к wikidb как mysql root user, или назначьте привилегии LOCK TABLES для wikiuser
 * Запустите скрипт из под пользователя root, или любого другого пользователя с правами доступа к файлам mysql

Замечание: этот mysqlhotcopy скрипт нужно запускать из под пользователя root, или любого другого пользователя с правами доступа к файлам mysql. Так же mysqlhotcopy скрипт блокирует таблицы базы данных, но mediawiki инсталлер не выдает привилегии LOCK TABLES для wikiuser. Для выдачи привилегий выполните следующие команды:

mysql> grant lock tables on wikidb.* to wikiuser; mysql> flush privileges;

-- 84.188.216.116 02:39, 18 August 2005 (UTC)

Extending the database: Converting (importing) existing content
For existing sites it is always a tough task to migrate to a Wiki structure; the process of wikifying existing content from text files, HTML websites, or even office documents can be automated, but you'll have to write appropriate scripts on your own. As far as we know, there are no general-user ready-to-run scripts available for this purpose. Opposed to commercial Content Management Systems like Hyperwave or HTML editors like Microsoft FrontPage, MediaWiki and other Open Source WikiWiki software does not include import filters. There are some exceptions which will be discussed in the following sections.

Converting content from a UseMod Wiki
Prior to MediaWiki (Wikipedia Software Phase III and Phase II), the Wikipedia utilized the UseMod Wiki software written by Clifford Adams. UseModWiki is a Perl script which uses a database of text files to generate a WikiWiki site. Its primary access method is through CGI via the Web, but can be called directly by other Perl programs. To convert an existing UseMod Wiki site, there is a script available in the /maintenance subdirectory of your MediaWiki source folder.

The storage format of UseMod Wiki is well documented: DataBase.

tbd

Converting content from a PHPWiki
If you only have a few pages to convert, and the content isn't sensitive, you might want to try WebForce's online markup converter.

For larger PHPWikis, Isaac Wilcox has written a Perl script to do the conversion. It converts all the commonly used markup (still not 100% of markup, but most PHPWikis will only need minor tweaks after conversion; patches are welcome). It's written for the Mediawiki 1.4.x database schema, though updating it to handle 1.5.x should be fairly easy (again, patches welcome).

The above script works well, but the schema has changed quite a bit since it was written. I found it easier to install the last stable 1.4.x version, import my data, then upgrade mediawiki. The script did an excellent job of preserving almost all of the formatting.

Also see PhpWiki conversion for a solution that uses "sed".

Converting JSPWiki format to MediaWiki format
You can use jspwiki2mediawiki.pl to convert JSPWiki pages to MediaWiki format. The basis for this tool is php2mediawiki by Isaac Wilcox. php2mediawiki provided a convenient basis for this converter and the modifications added to it were introduced to support the conversion of the JSPWiki format.

Converting TracWiki format to MediaWiki format
You can use tracwiki2mediawiki.pl to convert TracWiki pages to MediaWiki format. The basis for this tool is php2mediawiki by Isaac Wilcox. php2mediawiki provided a convenient basis for this converter and the modifications added to it were introduced to support the conversion of the TracWiki format.

Converting MoinMoin format to MediaWiki format
There are various scripts for this, all dodgy. See mw:MoinMoin.

Converting content from a database dump
tbd

Converting content from a CSV text file
tbd

Converting content from HTML text file
If you have only a HTML excerpt or a few pages to convert, you might want to try Diberri's html2wiki converter, which uses HTML::WikiConverter Perl module from CPAN. For larger collection of files one should probably use the module itself.

There are probably other HTML to Wiki markup converters.

See the section below for importing into MediaWiki.

Converting content from a MS-Word document
Try: Word2MediaWikiPlus.

The OpenOffice.org office suite also does a good job of reading MS Word and a usable job of exporting as MediaWiki wikitext.

Converting content from other sources
If you are able and willing to do some scripting by yourself, it is possible to import almost any existing textual content with a documented file format into MediaWiki.

The key to this is to insert rows into the cur table. Specifically, you need to fill the fields cur.cur_title and cur.cur_text. They contain the page titles and the wiki text, respectively. This is enough to start at. However, link tables must still be updated so the "What links here" etc. pages will work.


 * Note: As of version 1.5.0, the text above is incorrect; the database schema for handling revisions has changed significantly. I might be inclined to work upon some conversion scripts in the future, however. Rob Church Talk 12:06, 12 October 2005 (UTC)

As an example there might be the following script of some interest, which imports the public domain data from the CIA World Factbook 2002 into MediaWiki. It has been written by Evan Prodromou (E-Mail: evan(at)wikitravel(dot)org) for his own use on Wikitravel - The free, complete, up-to-date and reliable world-wide travel guide. It is licensed under the GNU General Public License and is available for download.

Please note that it's a one-time script; most paths and stuff are hard-coded, and lots of the code is for parsing the CIA World Factbook print pages, but it might serve as a good example of what can be done.


 * Does anybody know where this script is available? Matthewsim 23:27, 27 Aug 2004 (UTC)
 * found it on Wikitravel site Renmiri 21:57, 16 February 2006 (UTC)

Changing the tagline
A way to change the tagline that appears on top of every page just below the page title (but by default is hidden in Monobook skin except when printing pages) is to modify the MediaWiki:Tagline system message that if undefined defaults to.

Add the following to MediaWiki:Common.css if you want the taglin to display in all skins, or to MediaWiki:Monobook.css if you want to adjust only the Monobook skin:

#siteSub { display:block; }

If you don't like the way it looks (the HTML displaying the text is H3 that displays bold by default in most browsers) add some CSS style declarations to that, eg:

#siteSub { display:block; font-weight:normal; font-size:normal;}

Maintenance scripts

 * See Manual:Maintenance scripts