Просмотр кода страницы MediaWiki в кратце

== Установка MediaWiki ==

Установка крайне проста: скачиваем последнюю версию с официального сайта http://www.mediawiki.org и распаковываем в нужный каталог сайта (например <tt>/var/www/site/w/</tt>); далее настраиваем через веб-интерфейс. Точка входа: <code><nowiki>http://domain.ru/w/mw-config/</nowiki></code>

Подробно об установке можно узнать из [http://www.mediawiki.org/wiki/Manual:Installation_guide/ru официальной инструкции], и ещё одна [http://www.mediawiki.org/wiki/Manual:Configuring_MediaWiki/ru здесь].

Вики движок лучше не размещать в корне сайта. Почему, кратко объяснено в [http://www.mediawiki.org/wiki/Manual:Wiki_in_site_root_directory спец. статье].

После  установки хорошо бы ознакомиться с [http://www.mediawiki.org/wiki/Manual:System_administration/ru задачами администратора MediaWiki], где сказано что ещё можно доделать.

== Как сделать (краткие ЧаВО) ==

Хорошие краткие инструкции (ЧаВО или FAQ) есть на официальном сайте MediaWiki как на [http://www.mediawiki.org/wiki/Manual:FAQ/ru русском языке], так и на [http://www.mediawiki.org/wiki/Manual:FAQ английском].


=== Запрещаем редактирование не авторизованным пользователям: ===
<pre>
$wgGroupPermissions['*']['createaccount'] = true;
$wgGroupPermissions['*']['read'] = true;
$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['*']['createpage'] = false;
$wgGroupPermissions['*']['createtalk'] = false;
</pre>

Полный список прав см. в [http://www.mediawiki.org/wiki/Manual:User_rights_management официальном руководстве]

=== Делаем ссылки короткими ===

По умолчанию ссылки выглядят так: <code><nowiki>http://domain.ru/wiki/index.php?title=article</nowiki></code>. Чтобы сделать их такими же короткими и наглядными, как в Википедии, есть [http://www.mediawiki.org/wiki/Manual:Short_URL много способов]. Один из них - это добавить в '''LocalSettings.php''':<br> 
<pre>$wgScriptPath   = "/w";  
$wgArticlePath  = "/wiki/$1";
$wgUsePathInfo  = true;
</pre> 

где '''$wgScriptPath''' - каталог установки вики-сайта,
:'''$wgArticlePath''' - виртуальный каталог,&nbsp;который нужно будет указать в URL при обращении к статье, имя не должно совпадать с реальным каталогом.

Затем, в корневом каталоге сайта (т.е. рядом с каталогом "w") нужно создать файл '''.htaccess''':<br> 
<pre>
RewriteEngine On
RewriteRule ^wiki/(.*)$ /w/index.php?title=$1 [PT,L,QSA]
RewriteRule ^wiki/*$ /w/index.php [L,QSA]
RewriteRule ^/*$ /w/index.php [L,QSA]
</pre> 

Для лучшего понимания этого кода можно подробней ознакомиться с [http://www.shtogrin.com/library/web/mod_rewrite/doc/RewriteRule/ синтаксисом директивы RewriteRule].

Если на сервере установлено несколько виртуальных хостов, то нужно ещё добавить&nbsp; настройку виртуального хоста в секцию '''&lt;VirtualHost&gt;''': 

<pre>
AllowOverride All
RewriteEngine On
RewriteOptions Inherit
</pre> 

и подключить модуль rewrite, после чего перезагрузить apache. В Debian это делается следующим образом: 
<pre>
ln -s /etc/apache2/mods-available/rewrite.load /etc/apache2/mods-enabled
/etc/init.d/apache2 restart
</pre>

=== Меняем права пользователей ===

Права пользователя можно поменять на '''Special:Userrights'''. Подробно описано в [http://www.mediawiki.org/wiki/Manual:User_rights_management официальном руководстве].

За изменение прав отвечает тип разрешения ''userrights''. Дав это разрешение какой-либо группе в конфигурационном файле LocalSettings.php, мы позволяем участникам этой группы изменять права всех участников вики. Например, чтобы дать всем возможность управлять правами нужно добавить такую строчку:

 $wgGroupPermissions['user']['userrights'] = true;

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

=== Меняем пароль пользователя ===

1. '''Пользователь''' может запросить забытый пароль на странице  '''Special:UserLogin'''


2. '''Администратор''' может поменять пароль любого пользователя следующими способами:

2.1) скриптом из каталога maintenance:
 php changePassword.php --user=example --password=newpassword

2.2) на странице '''Special:PasswordReset'''

2.3) SQL командой:

 UPDATE user SET user_password = MD5(CONCAT(user_id, '-', MD5('Новый_Пароль'))) WHERE user_name = 'Имя_Пользователя';

Читайте [http://www.mediawiki.org/wiki/Manual:Resetting_passwords подробней] на официальном сайте. См также статью о [[MySQL]].

===Разрешаем включать страницы из других вики===

Чтобы включить страницу или шаблон из другой вики, она должна быть описана в таблице интервики ссылок и в LocalSettings.php нужно добавить параметр [http://www.mediawiki.org/wiki/Manual:$wgEnableScaryTranscluding $wgEnableScaryTranscluding]:

 $wgEnableScaryTranscluding = true;

Можно прочитать подбробней про включения ([http://www.mediawiki.org/wiki/Transclusion transclusion]) вообще и про [http://www.mediawiki.org/wiki/Manual:Interwiki_table включения из других вики] в частности.

=== Разрешаем загружать файлы ===

<syntaxhighlight lang=bash>
# Позволяем загружать файлы
$wgEnableUploads = true;

# Определяем макс. размер файла
$wgMaxUploadSize = 5000000; 

# Отключаем проверку расширения файла
$wgCheckFileExtensions = false;
$wgStrictFileExtensions = false;

# Отключаем проверку MIME-типов
$wgVerifyMimeType = false;
</syntaxhighlight>

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

Чтобы самостоятельно задать тип файлов указываем:
<syntaxhighlight lang=bash>
$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg', 'pdf', 'doc', 'docx', 'xls', 'xlsx','ods','odg','odt');
</syntaxhighlight>

Для того, чтобы файлы могли быть загруженными, должен быть настроен и сам PHP. Максимальный размер загружаемого файла задаётся в php.ini (напр. /etc/php5/apache2/php.ini) параметром '''upload_max_filesize'''. Т.е. одной установки '''$wgMaxUploadSize''' будет мало.


Подробней см. [http://www.mediawiki.org/wiki/Manual:Configuring_file_uploads/ru официальную документацию].

=== Добавляем классы таблиц ===

{|class="mw-collapsible mw-collapsed wikitable" align=right
! код для shared.css
|-
|
<syntaxhighlight lang=css>
/* -pm- as wikitable but without a table */
/*background and darker header background*/
table.standard {
    margin: 1em 1em 1em 0;
    border: 1px #aaa solid;
    border-collapse: collapse;
}
.standard th, .standard td {
    border: 1px #aaa solid;
    padding: 0.2em;
}
.standard th {
    background: #d2d2d2;
    text-align: center;
}
.standard caption {
    font-weight: bold;
}

/* -pm- as standart but with frame only */
table.frame {
    margin: 1em 1em 1em 0;
    border: 1px #aaa solid;
    border-collapse: collapse;
}
.frame th .frame td {
    padding: 0.2em;
}
.frame th {
    background: #d2d2d2;
    text-align: center;
}
.frame caption {
    font-weight: bold;
}

/* -pm- as standart but wide (100%) */
table.wide {
    margin: 1em 1em 1em 0;
    border: 1px #aaa solid;
    border-collapse: collapse;
    width: 100%;
}
.wide th, .wide td {
    border: 1px #aaa solid;
    padding: 0.2em;
}
.wide th {
    background: #d2d2d2;
    text-align: center;
}
.wide caption {
    font-weight: bold;
}

/* -pm- as wide but with frame only*/
table.wide-frame {
    margin: 1em 1em 1em 0;
    border: 1px #aaa solid;
    border-collapse: collapse;
    width: 100%;
}
.wide-frame th .wide-frame td {
    padding: 0.2em;
}
.wide-frame th {
    background: #d2d2d2;
    text-align: center;
}
.wide-frame caption {
    font-weight: bold;
}
</syntaxhighlight>
|}

По умолчанию в движке MediaWiki определён только один класс таблиц wikitable. 

* Чтобы определить свои классы нужно отредактировать файл <tt>skins/common/shared.css</tt>. Вставьте в любое место приведённый справа код.


Пример классов таблиц:

{| class=frame 
|- 
! вид

|
{| class="wikitable"
|+ wikitable
|-
!Заголовок 1||Заголовок 2 
|-
|Ячейка 1*1||Ячейка 2*1
|-
|Ячейка 1*2||Ячейка 2*2
|-
|Ячейка 1*3||Ячейка 2*3
|}

|
{| class="standard sortable"
|+ standard
|-
!Заголовок 1||Заголовок 2 
|-
| 1 Ячейка || 2 Ячейка
|-
| 2 Ячейка || 1 Ячейка 
|-
| 3 Ячейка || 3 Ячейка
|}

|
{| class="frame sortable"
|+ frame
|-
!Латиница||Кириллица||class="unsortable"|Цифры
|-
| D || Г || 3 
|-
| E || Щ || 2
|-
| F || Б || 11
|}


|-
! код

|<pre>
{| class="wikitable"
|-
!Заголовок 1||Заголовок 2 
|-
|Ячейка 1*1||Ячейка 2*1
|-
|Ячейка 1*2||Ячейка 2*2
|-
|Ячейка 1*3||Ячейка 2*3
|}
</pre>

|<pre>
{| class="standard sortable"
|-
!Заголовок 1||Заголовок 2 
|-
| 1 Ячейка || 2 Ячейка
|-
| 2 Ячейка || 1 Ячейка 
|-
| 3 Ячейка || 3 Ячейка
|}
</pre>

|<pre>
{| class="frame sortable"
|-
!Латиница||Кириллица||class="unsortable"|Цифры
|-
| D || Г || 3 
|-
| E || Щ || 2
|-
| F || Б || 11
|}
</pre>
|}

{| class=frame width=600
|-
! width=50|широкие

|
{| class="wide" 
|+ wide
|-
!Заголовок 1||Заголовок 2 
|-
|Ячейка 1*1||Ячейка 2*1
|-
|Ячейка 1*2||Ячейка 2*2
|-
|Ячейка 1*3||Ячейка 2*3
|}

|-
! 
|
{| class="wide-frame" 
|+ wide-frame
|-
!Заголовок 1||Заголовок 2 
|-
|Ячейка 1*1||Ячейка 2*1
|-
|Ячейка 1*2||Ячейка 2*2
|-
|Ячейка 1*3||Ячейка 2*3
|}
|}


===Сортируем данные в колонках===

Для добавления возможности сортировки данных в колонках достаточно в заголовке добавить к названию класса слово "sortable". Например:
<pre>{| class="wikitable sortable"</pre>

См. подробнее на английском на [https://meta.wikimedia.org/wiki/Help:Table#Sorting официальном сайте].


=== Переносим статьи и шаблоны из другой вики ===

* '''Special:Export''' - выгружаем требуемую статью или шаблон в промежуточный XML файл
* '''Special:Import''' - загружаем на новой вики XML файл

Подробнее в [https://www.mediawiki.org/wiki/Help:Templates/ru официальной документации]. Иногда, в случае со сложными зависимостями, когда шаблон использует несколько других (как часто бывает в Википедии, например), проще переносить шаблон вручную, отредактировав его и убрав зависимости, заменив их на более простые конструкции (облегчённые шаблоны или просто текст).

=== Скрываем большие и незначительные блоки текста ===

* Можно добавить возможность [http://www.mediawiki.org/wiki/Manual:Collapsible_tables сворачивать таблицы и фрагменты текста]. 

* Начиная с 1.18 для всех элементов добавлен класс "mw-collapsible", который можно указать не только для таблиц, но и для любого текста. Подробней см. [[Справка:Справка_по_редактированию#Скрывайте незначительные блоки текста|справку по редактированию]]

* '''До версии 1.18''' в официальной инструкции рекомендуется создать в вики страницы '''MediaWiki:Common.js''' и '''MediaWiki:Common.css''' Такое решение имеет свой плюс (при обновлении движка настройка останется) и минус (в случае вики фермы - страницу нужно будет создавать в каждой вики). Для вики фермы можно добавить код в конец следующих файлов в каталоге <tt>skins/common/</tt>:
** код для Common.js добавил в <tt>ajax.js</tt>
** код для Common.css добавил в <tt>shared.css</tt>

* Сворачивать можно также '''разделы, таблицы, ячейки в таблицах и удалённые от кнопки сворачивания блоки'''. Примеры можно посмотреть на '''[https://test.wikipedia.org/wiki/Test_suite_for_mw-collapsible сайте тестирования MediaWiki]'''

===Перевод сайта в режим только для чтения===

Перевести сайт в режим только для чтения можно определив переменную '''[http://www.mediawiki.org/wiki/$wgReadOnly $wgReadOnly]''':

 $wgReadOnly = 'Внимание! Идёт обновление движка сайта. Редактирование временно будет не доступно!';


=== Меняем название заглавной страницы ===
Если в URL не указать страницу сайта, то мы попадём на страницу "Заглавная страница". Название "Заглавной страницы" можно поменять как и любой другой - переименованием, но чтобы избежать сообщения о перенаправлении, нужно изменить системное сообщение '''MediaWiki:Mainpage'''. Подробнее в [https://www.mediawiki.org/wiki/Manual:Main_Page оф. документации].

=== Включаем обработку подстраниц ===

При '''включенной обработке подстраниц''', если в заголовке страницы встречается косая черта (/), то система начинает распознавать всё, что за ней как подстраницу. То есть если есть в названии страницы эта косая черта, то она считается подстраницей, если нет - то это корневая (родительская) страница. Сколько косых черт в заголовке - таков и уровень подстраницы.

При '''выключенной обработке подстраниц''' все страницы считаются корневыми.

Обработка включается и выключается для каждого пространства имён отдельно:

<syntaxhighlight lang=php>
# Включаем обработку подстраниц
$wgNamespacesWithSubpages[NS_MAIN] = true;

# Выключаем обработку подстраниц
$wgNamespacesWithSubpages[NS_TEMPLATE] = false;
</syntaxhighlight>

или для всех сразу:

<syntaxhighlight lang=php>
# Включаем обработку подстраниц для всех пространств имён
$wgNamespacesWithSubpages = array_fill(
 	0, 200, true
 	);
</syntaxhighlight>

При включенной обработке на подстраницах под заголовком появляется строка ссылок на все родительские страницы. Также можно вывести список всех дочерних страниц (подстраниц) с помощью запроса:
<pre>
{{Special:PrefixIndex/MediaWiki/ |hideredirects=1 |stripprefix=1}}
</pre>

где 
* '''hideredirects=1''' скрывает страницы с перенаправлением, а 
* '''stripprefix=1''' удаляет из полного названия страницы названия родительских страниц; 1 - удаляет только самого первого родителя, 2 - первого и второго и т.д.


'''Подробнее смотрите на официальных страницах:'''
* [https://www.mediawiki.org/wiki/Help:Subpages/ru Подстраницы]
* [https://www.mediawiki.org/wiki/Manual:$wgNamespacesWithSubpages $wgNamespacesWithSubpages]

== Добавление расширений ==

Этому посвящена статья [[MediaWiki/Расширения]]

== Резервное копирование  ==

Чтобы узнать, как скачать дампы базы данных со статьями Википедии, см. [http://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Linux/ru статью Википедии]

Для создания собственного дампа локального сайта, использующего MediaWiki, есть [http://www.mediawiki.org/wiki/Manual:Backing_up_a_wiki/ru подробная инструкция]. 

Если кратко, то полная резервная копия - это дамп из СУБД (у меня MySQL) в виде SQL выражений, а частичная в виде xml файла. Особенности последней в том, что она не зависит от структуры базы данных и может быть перенесена, например, на нувую версию MediaWiki с изменнённой структурой БД, но в xml не выгружаются информация о логинаx пользователей, журналы и метаданные изображений.

*Для '''SQL''' дампа выполняем:
<pre>
mysqldump -h $SERVER -u $USER -p$PASSWORD --default-character-set=$CHARSET $DATABASE -c \
| /bin/gzip -9 > ~/backup/wiki-$(date '+%a').sql.gz
</pre>

:параметры '''$USER''', '''$PASSWORD''' и '''$DATABASE''' берём из LocalSettings.php
:<pre>cat ./LocalSettings.php  | grep wgDB</pre>

:параметр '''--default-character-set=$CHARSET''' нужен, если возникли проблемы с кодировкой (подробней см. статью выше)

:параметр '''-h $SERVER''' нужен если подключаемся не через сокет, иначе получим ошибку:
:<pre>mysqldump: Got error: 2002: Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2) when trying to connect</pre>


*Для '''XML''' дампа используем скрипт [http://www.mediawiki.org/wiki/Manual:DumpBackup.php dumpBackup.php], расположенный в каталоге '''maintenance''':
<pre>
php maintenance\dumpBackup.php --full > full.xml 
</pre>
Список параметров dumpBackup.php можно получить, вызвав его без параметров, однако, в исходном коде этого скрипта есть ещё несколько недокументированных опций.


== Редактировние статей ==

Об этом можно подробно узнать из [[Справка:Справка по редактированию|Справки по редактированию]].

== Поиск в Firefox по своей вики ==

В Firefox с помощью шаблона '''%s''' и "Краткого имени" (keyword) в закладке можно настроить быстрый доступ к любому сайту. 

Отрываем ''Закладки - Управление закладками'' (Bookmark/Manage bookmarks), создаём отдельную папку для быстрого поиска, скажем "Быстрый поиск"; создаём новую закладку, где указываем:

* '''Имя:''' Поиск по СисадминВики
* '''Адрес:''' <nowiki>http://sysadminwiki.ru/wiki/%s</nowiki>
* '''Краткое имя:''' св

Обратите внимание, что краткое имя может быть и на русском языке.

Теперь в адресной строке набираем: "св MediaWiki" и попадаем на эту страницу.

Если наберём просто "св", то попадём на начальную страницу сайта.

==Почта==

Разрешаем пересылку почты пользователям и устанавиваем ограничение на запрос напоминания пароля не чаще чем один в час.

<syntaxhighlight lang=php>
## UPO means: this is also a user preference option
$wgEnableEmail      = true;
$wgEnableUserEmail  = true; # UPO
$wgEnotifUserTalk = true; # UPO
$wgEnotifWatchlist = true; # UPO
$wgEmailAuthentication = true;
$wgPasswordReminderResendTime = 1;

$wgEmergencyContact = "wiki_admin@domain.ru";
$wgPasswordSender = "wiki_admin@domain.ru";
</syntaxhighlight>

Чтобы задать особые настройки почтового сервера, с которого будут посылаться сообщения, определяем массив $wgSMTP. 

<syntaxhighlight lang=php>
$wgSMTP = array(
 'host'     => "mail.domain.ru", //could also be an IP address
 'IDHost'   => "domain.ru",
 'port'     => 25,
 'auth'     => false,
 'username' => "wiki_admin@domain.ru",
 'password' => "пароль"
);
</syntaxhighlight>

Но в этом случае нам понадобиться установленный пакет Mail из репозитория PEAR. Ставится командой 
 pear install MAIL Net_SMTP

Если же не установлен сам PEAR, то в Debian этом можно сделать так:
 apt-get install php-pear

==Отображение файлов SVG==

Движок MediaWiki преобразует все изображения '''SVG''' (а также WMF, OpenEXR, DjVu и Graphviz) в формат '''PNG'''. Поэтому, для отображения файлов векторной графики в формате SVG необходимо доустановить утилиту конвертации графических файлов. На время выхода версии 1.27 поддерживаются следующие:  ImageMagick, ImagickExt, sodipodi, inkscape, batik, rsvg, и imgserv.

Подробнее читайте на [http://www.mediawiki.org/wiki/SVG официальном сайте].

==Дополнительные настройки==

* Описание переменных конфигурационного файла [http://www.mediawiki.org/wiki/Manual:Configuration_settings на английском].

* [http://www.mediawiki.org/wiki/Manual:Interwiki/ru Интервики] (interwiki) - это ссылки, оформленные как внутренние ссылки с использованием специального префикса, но ведущие на страницы других проектов. Интервики-ссылки позволяют сделать ссылку на страницы других вики-проектов, например Википедии, Викиучебника, Викиновостей и т.д., или, к примеру, на разделы вашего вики-проекта на разных языках.
** расширение [http://www.mediawiki.org/wiki/Extension:SpecialInterwiki SpecialInterwiki] позволяет редактировать таблицу интервики ссылок через веб-интерфейс
** расширение [http://www.mediawiki.org/wiki/Extension:Interwiki Interwiki] позволяет редактировать таблицу интервики через текстовый файл.
** [http://www.mediawiki.org/wiki/Manual:Configuration_settings#Interwiki Описание параметров интервики]

* На странице '''MediaWiki:Tagline''' можно изменить подпись "'''Материал из НазваниеВики'''". Подробнее в описании о настройке вида: [http://www.mediawiki.org/wiki/Manual:Tagline_(Site_Subtitle) Tagline]

* Можно использовать [http://www.mediawiki.org/wiki/Help:Magic_words/ru "волшебные слова"] (переключатели и переменные), например, для настройки отображение содержания, или вставки даты в определённом формате, или отображения статистики.

* Можно изменить некоторые умолчальные настройки профиля пользователя переменной [http://www.mediawiki.org/wiki/Manual:$wgDefaultUserOptions $wgDefaultUserOptions]. Например, чтобы не показывать ссылку '''"Правка"''' для секций для незарегистрированных пользователей, нужно добавить в LocalSettings.php
 $wgDefaultUserOptions ['editsection'] = 0;

== См. также ==

Тематические подстраницы для этой:
{{Special:PrefixIndex/MediaWiki/ |hideredirects=1 |stripprefix=1}}

А также:
* [[Семантика]] - как установить, настроить и использовать её
* В [[:Категория:MediaWiki|категории MediaWiki]] есть ещё несколько статей, которые помогут настроить движок соответсвенно нуждам.

== Полезные ссылки ==

'''Документация:'''
* http://meta.wikimedia.org/wiki/Помощь:Содержание
* http://ru.wikibooks.org/wiki/Вики -- небольшой Викиучебник
* http://workingwithmediawiki.com/book/ -- подробная книга о движке MediaWiki на англ.

'''Справочники:'''
* https://www.mediawiki.org/wiki/Manual:FAQ/ru -- частые вопросы
* https://www.mediawiki.org/wiki/Help:Magic_words/ru -- "волшебные словам" в движке, а также встроенные служебные шаблоны для отображения статистики, даты и времени и т.д.

'''Форум:'''
* http://mediawiki.ru/forum/

'''Описание движка MediaWiki:'''
* http://www.mediawiki.org/wiki/Developer_hub/ru -- Официальные материалы для разработчика
* http://www.mediawiki.org/wiki/API:Main_page/ru -- Описание API движка для тех, кто решил программировать под MediaWiki (например, [http://en.wikipedia.org/wiki/Wikipedia:Creating_a_bot создать бот])
* http://www.mediawiki.org/wiki/Category:MediaWiki_database_tables -- Информация по таблицам БД
* https://www.mediawiki.org/wiki/Version_lifecycle -- Жизненный цикл версий движка MediaWiki

[[Категория: MediaWiki]]