Как изменить главную страницу mediawiki

Общее

Внешний вид сайтов построенных на движке MediaWiki можно поменять просто сменив тему (шаблон, шкурку, скин). Список бесплатных тем см ниже в «ссылках».

Если нужны незначительные изменения, то их можно сделать редактируя специальные страницы:

• MediaWiki:Common.css — для изменений CSS всех тем
• MediaWiki:Common.js — для изменений JavaScript
• MediaWiki:Vector.css — изменение только темы Vector
• Special:Allmessages — изменение сообщений в интерфейсе

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

Добавляем логотип

Картинку не более 135х135 пикселей с прозрачным фоном загружаем в папку images и добавляем в LocalSettings.php:

$wgLogo = “{$wgScriptPath}/images/logofinal.png”;

Меняем ссылку логотипа

При нажатии на логотип, по умолчанию попадаем на Заглавную страницу, но это поведением можно изменить. Настраивается это в главном файле темы, например VectorTemplate.php для темы Vector. Темы находятся в каталоге skins. Находим в файле фрагмент отвечающий за вывод логотипа. Как правило в название div класса отвечающего за это входит слово «logo».

Для примера изменения смотрите описание темы Vector.

Меняем favicon

Это изображение появляется возле адреса страницы в адресной строке сайта, а также в закладках. Его размер должен быть либо 16×16 либо 32×32 пикселей. Не все браузеры поддерживают формат favicon отличный от ico, подробней читайте на http://en.wikipedia.org/wiki/Favicon#Browser_support

Чтобы добавить favicon.ico можно

• положить традиционно в корневой каталог сайта, т.е. на одном уровне с каталогом «w/» или
• скопировать изображение в папку images и добавить в LocalSettings.php:

$wgFavicon = "$wgScriptPath/images/favicon.ico";

Изменение в веб-интерфейсе

Боковое меню — это одно из системных сообщений, задаваемых в пространстве имён MediaWiki. Его содержимое описывается на странице MediaWiki:Sidebar.

Синтаксис:

* <название блока 1>
** <ссылка 1>|<отображаемый текст 1>
** <ссылка 2>|<отображаемый текст 2>
* <название блока 2>
** <ссылка 3>|<отображаемый текст 3>
** <ссылка 4>|<отображаемый текст 4>

Пример:

* navigation
** mainpage|Начальная
** Служебная:AllPages|Все статьи
** Служебная:Categories|Все категории
** portal-url|Сообщество
** https://ru.wikipedia.org | Википедия
** helppage|help
* Популярное
** Служебная:PopularPages|Статьи
** Служебная:MostLinkedCategories|Категории
** recentchanges-url|recentchanges
** randompage-url|randompage
* SEARCH
* TOOLBOX

Изменение в теме оформления

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

Пример изменения темы смотрите на странице темы Вектор.

Добавляем слева ссылки на другие вики

В случае многоязыковых проектов достаточно добавить в статью

[[lang:Имя статьи]]

где lang — префикс языка. См. файл languages/Names.php

В случае, если нужно добавить ссылку на любой другой сайт, нужно создать интервики ссылку (см. ниже) и с таким же именем запись в languages/Names.php

Например, в таблице ссылок интервики создали ссылку my-wiki, тогда в Names.php добавляем строчку (в рамках объявления массива):

'my-wiki' => 'My Wiki',  # Link to my wiki

Теперь, в статью можно поместить строку:

[[my-wiki:Имя статьи]]

Подробней читать на офиц. сайте.

Прячем таблицу содержания

• Для одной страницы помещаем в текст «волшебное слово» __NOTOC__
• Для всех страниц редактируем CSS файл, где находим тэг для таблицы содержания и добавляем строку «display: none;»
• Для пользователя определяется самим пользователем на странице настроек Special:Preferences

Прячем заголовок статьи

Для того, чтобы спрятать название определённой страницы (в примере ниже это «Заглавная_страница») добавляем на страницу MediaWiki:Common.css следующий код:

body.page-Заглавная_страница #siteSub,
body.page-Заглавная_страница #contentSub,
body.page-Заглавная_страница h1.firstHeading
{display:none !important}

Также можно использовать магическое слово DISPLAYTITLE:

{{DISPLAYTITLE:<span style="display:none">{{FULLPAGENAME}}</span>}}

но для этого нужно отключить в LocalSettings.php ограничения на заголовки:

$wgRestrictDisplayTitle = false;

Подробнее можно прочесть в официальном ЧаВо.

Меняем текст сообщений

Любое сообщение в интерфейсе вики можно изменить, отредактировав специальную страницу с ним. Например:

• MediaWiki:Noarticletext — Этот текст появляется, если в адресной строке (URL) был передан параметр title на несуществующую страницу.
• MediaWiki:Copyrightwarning, MediaWiki:Copyrightwarning2 — предупреждения об авторском праве под окнами редактирования
• MediaWiki:Sitenotice — добавляет сообщение на каждую страницу выше заголовка
• MediaWiki:Edittools — дополнительные инструменты для страницы редактирования (см. расширение CharInsert)
• MediaWiki:Tagline — надпись «Материал из…» под названием сайта
• MediaWiki:Talk, MediaWiki:Talkpagelinktext —

Список всех сообщений приведён на Special:Allmessages, а также в файле ru.json в каталоге i18n.

Изменяем подвал

Подвал (футер, footer) — это общая со всеми нижняя часть страницы (ссылки и банеры). См Manual:Footer и по изменению кнопок $wgFooterIcons.

• Чтобы отключить вывод кнопки с логотипом MediaWiki указываем в LocalSettings.php:

unset( $wgFooterIcons['poweredby'] );

А для кнопки с авторскими правами:

$wgRightsIcon = null;

• Чтобы добавить произвольный банер (кнопку) нужно изменить переменную $wgFooterIcons — добавить элемент в этот массив. Например для добавления счётчика Яндекс:

$wgFooterIcons['poweredby']['yandex'] = [
	"src" => "https://yandex.ru/cycounter?https://mysite.ru&theme=dark&lang=en",
	"url" => "https://webmaster.yandex.ru/siteinfo/?site=https://mysite.ru",
	"alt" => "Счётчик Яндекс",
	"height" => "31",
	"width" => "88",
];

Добавлять можно как в столбец poweredby так и в copyright, т.е. первая строка может быть такой:

$wgFooterIcons['copyright']['yandex'] = [

• Изменяем текст и ссылки вставляющиеся внизу каждой страницы на специальных служебных страницах (чтобы убрать удаляем весь текст):
  • Политика конфиденциальности: MediaWiki:Privacy
  • Отказ от ответственности: MediaWiki:Disclaimers

Разные темы для участников и посетителей

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

Например, для отображения посетителям темы VectorLight (облегчённой темы Вектор) указываем в LocalSettings.php:

$wgDefaultSkin = "vectorlight";

Для зарегистрировавшихся участников используем полновесную тему Вектор, устанавливая её принудительно для каждого участника. Заходим в папку maintenance и выполняем команду:

php userOptions.php skin —old «vectorlight» —new «vector» —nowarn

После этого все посетители будут видеть сайт в теме VectorLight, а если зарегистрироваться, то тема сменится на Vector.

Сноска во всплывающей подсказке

Всплывающая подсказка (reference Tooltips) делается с помощью гаджета (JavaScript кода), который использует расширение Cite (должно быть включено). Подсказка всплывает только если текст сноски не виден на экране.

Настройка:

• Включить расширение Gadgets
• Скопировать из русской Википедии страницы MediaWiki:Gadget-referenceTooltips.css и MediaWiki:Gadget-referenceTooltips.jsв одноимённые страницы на новой вики
• Включить гаджет, скопировав строку подключения со страницы MediaWiki:Gadgets-definition на одноимённую страницу на новой вики. Строка имеет вид:

* referenceTooltips[ResourceLoader|default|type=general|dependencies=jquery.client,mediawiki.cookie,mediawiki.notify]|referenceTooltips.js|referenceTooltips.css

Проверка:

• На странице Служебная:Гаджеты должна появиться запись для ⧼gadget-referenceTooltips⧽
• В настройках пользователя на закладке «Гаджеты» должна стоять галочка напротив этого гаджета.

Ссылки:

• Подробнее о возможностях гаджета от автора

Визуальный редактор (Visual Editor)

В панель инструментов Визуального редактора можно дополнять свои ниспадающие списки (например для вставки шаблонов) и кнопки быстрой вставки (например кавычки). Для этого нужно разместить на странице MediaWiki:Common.js соответсвующий код на яваскрипте.

• Список (вид) иконок для кнопок, загруженных участниками на сайт MediaWiki, которые можно подключить в своём проекте.

Редактор WikiEditor

• Изменение панели иснтрументов в WikiEditor происходит в MediaWiki:Common.js:
  • шаблоны и символы: https://www.mediawiki.org/wiki/Extension:WikiEditor/Toolbar_customization#Modifying_things
  • кнопки: https://www.mediawiki.org/wiki/Extension:WikiEditor/Toolbar_customization/Library#Math_button

Ссылки

Шаблоны (скины):

• Инструкции как сделать свой скин
  • на русском языке
  • на английском
  • официальная документация на русском и английском.

• Сайты со скинами:
  • Список на MediaWiki.org

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования MediaWiki. Такая своеобразная записная книжка.

Речь пойдёт о MediaWiki, размещённой на Linix-сервере. Подробнее о версиях установленного ПО можно узнать здесь.

Термины и сокращения

BPoD

Blank Page of Death (BPoD) — белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:

• неверные настройки в файле LocalSettings.php;
• некорректно работающее свежеустановленное расширение.

Для поиска причины рекомендуем включить функцию debug MediaWiki, добавив в самый низ файла LocalSettings.php следующие строки:

error_reporting( -1 );
ini_set( 'display_errors', 1 );

Потом это лучше убрать, чтобы пользователи не увидели лишнего.

Нулевая правка

Null edit — это если зайти в режим Правки страницы и тут же нажать Записать страницу (Save page), хотя изменений никаких внесено не было. Как бы ни казалось на первый взгляд, но это вовсе не бессмысленное действие.

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

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

Настройка MediaWiki

В основном, вся проводится правкой файла LocalSettings.php. Он находится в корневой директории сайта.

Первичная настройка

Задание названия

В файле LocalSettings.php задать переменную:

$wgSitename = "Ваше название вики";

Установка логотипа

Логотип можно загрузить через интерфейс самой вики, но тогда он окажется доступным для изменения, потому лучше положить его в каталог к дефолтному: skins/common/images/. Однако, тогда при обновлении MediaWiki логотип сбросится вновь на дефолтный или вовсе не будет отображаться.

Логотип должен быть квадратным, с размерами 135×135. Чтобы он смотрелся аккуратно и не выделялся своим фоном на фоне страниц вики, нужно сделать ему прозрачный фон.

После того, как логотип загружен на сервер, нужно задать следующую переменную в файле LocalSettings.php:

$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";

Установка иконки

Иконка сайта отображается на вкладке браузера, благодаря чему его (сайт) проще отыскать в массе открытых вкладок.

Загружать иконку рекомундуется туда же, куда и логотип. Размеры её должны быть 16×16, а формат — ICO. Так же можно сделать ей прозрачный фон. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

Имя рекомендуется использовать стандартное: favicon.ico.

После того, как иконка загружена на сервер, нужно задать следующую переменную в файле LocalSettings.php:

$wgFavicon = "$wgStylePath/common/images/favicon.ico";

Изменение навигационного блока

Навигационный блок, расположенный на левой части каждой страницы вики, можно изменять: удалять существующие пункты, добавлять свои. Делается это на спецстранице вашавики.net/index.php/MediaWiki:Sidebar

Разрешение загрузки изображений

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

Разрешить загрузку файлов на сервер:

Установить разрешённые расширения файлов:

$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');

Также для работы некоторых расширений может потребоваться редактор изображений ImageMagick:

$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert"; # у вас может находиться в иной директории

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

Ошибка создания миниатюры: public_html/bin/ulimit4.sh: line 4: /usr/bin/convert: Permission denied

В этом случае помогает отключение использования ImageMagick:

$wgUseImageMagick = false;

Вы спросите, а что делать, если возникли проблемы с миниатюрами, но ImageMagick необходим для работы расширения? И мы не ответим на этот вопрос.

Изменение стиля wikitable

По умолчанию у класса таблиц wikitable ничтожно маленькое значение отступа от границ ячейки, из-за чего таблицы не радуют глаз. Для установки собственного значения отступа необходимо внести изменения в файл skinscommonshared.css. Скажем, 5px будет достаточно:

table.wikitable {
	margin: 1em 1em 1em 0;
	background: #f9f9f9;
	border: 1px #aaa solid;
	border-collapse: collapse;
	color: black;
}
.wikitable th, .wikitable td {
	border: 1px #aaa solid;
	padding: 5px;}

Если у вас другая версия MediaWiki, код класса может выглядеть иначе, но суть одна — нужно изменить значение параметра padding.

Установка счётчиков

Для установки счётчика надо включить его код в код каждой страницы вики, но вообще достаточно включить его лишь в код темы оформления (скина). Так как по умолчанию используется Vector, то рассмотрим на его примере.

Код счётчика лучше сохранить в файле с расширением .php и загрузить на сервер в каталог skins, после чего в файле темы оформления (Vector.php) надо будет включить в определённом месте имя этого файла. Не забывайте, что кодировка файла с кодом счётчика должна совпадать с кодировкой, используемой на вашем сайте, иначе вместо кириллицы будет отображаться кракозябра.

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

Мы используем счётчик от Яндекса. Код его сохранён в файле skins/counter_yandex.php.

Для добавления счётчика редактируем файл skins/Vector.php:

После этого счётчик заработает, и должна стать видна его пиктограмма. Если же она не видна, то возможно её блокирует ваш браузер, его расширения или что-то ещё.

Расширения MediaWiki

Они же extensions. Позволяют расширить функционал вики. Например, добавить поддержку TeX формул и подсветку синтаксиса фрагментов исходного кода на том или ином языке программирования.

Устанавливаются все одинаково:

1. загрузить архив с расширением:
2. распаковать его в каталог extensions корневого каталога;
3. в файле LocalSettings.php из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и через SSH.

Подсветка синтаксиса

SyntaxHighlight GeSHi

У нас используется SyntaxHighlight GeSHi. Установка ничем не примечательна, однако на версии MediaWiki 1.17 расширение работать отказывалось — браузер выдавал лишь белую страницу смерти. Из-за этого до обновления приходилось использовать SyntaxHighlighter — более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

Когда же после обновления MediaWIki удалось установить SyntaxHighlight GeSHi, то оказалось, что по умолчанию им используется довольно мелкий шрифт. По крайней мере, такое наблюдалось в Firefox, а Opera и IE отображали блоки кода с шрифтом нормальных размеров.

Правка MediaWiki:Geshi.css

Это не файл (в каталоге с расширением вы его не найдёте), а спецстраница вашей Вики: вашавики.net/index.php/MediaWiki:Geshi.css.

Изначально страница пустая, её необходимо создать. Всё, что здесь будет вноситься, будет дополнительно использоваться в стилях подсветки синтаксиса (расширение будет брать настройки отображения отсюда, в дополнение к своим).

Следующая конструкция управляет размером шрифта:

div.mw-geshi {
font-size: 16px
}

Однако, на нашей вики это эффекта не дало.

Правка SyntaxHighlight_GeSHi.class.php

Вот это уже действительно файл, который находится в каталоге самого расширения.

Нужно изменить строку:

$css[] = ".source-$lang {line-height: normal;}";

следующим образом (добавить запись про размер шрифта):

$css[] = ".source-$lang {line-height: normal; font-size: 16px;}";

После этого блоки с кодом стали отображаться удобочитаемыми и вообще радующими глаз.

Использование TeX формул

Так как мы технари, то нам просто необходима поддержка $TeX$. Любые «псевдоформулы» набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку $TeX$ разметки, нужно было бороться до конца.

Math

Начали мы с расширения Math. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог math).

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

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты texvc. Нужно зайти в этот каталог и выполнить команду make. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и назначьте им права 755:

• images/math;
• images/tmp.

Далее необходимо задать следующие три переменных в файле настроек LocalSettings.php:

$wgUseTeX = "true"; 
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";

Также должна быть разрешена загрузка изображений.

После этого вики будет способна обрабатывать $TeX$ формулы, заключённые в теге <math></math>. Вкратце обработка происходит следующим образом: latex обрабатывает формулу, заключённую в теге <math></math>, ImageMagic создаёт из этого картинку и помещает её на страницу. Таким образом, готовые формулы представляют собой растровые изображения.

Однако, простые формулы, вроде x + 2 = 4, вики по умолчанию отображает текстом, отчего они выглядят не как «картиночные». За это отвечает переменная в настройках внешнего вида вики для каждого зарегистрированного пользователя, но можно задать её по умолчанию для всех. Для этого надо изменить в LocalSettings.php следующую переменную:

$wgDefaultUserOptions['math'] = 0;

MathJax

После обновления MediaWiki до версии 1.19.2 расширение Math работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение MathJax.

Самым главным его отличием является то, что оно не использует (соответственно, и не требует) наличия на сервере пакетов latex и dvips, и итоговые формулы являются не растровыми изображениями, а векторными объектами, которые можно сколь угодно масштабировать без потери качества их отображения на странице.

Устанавливается расширение стандартно.

Для обработки формул помимо стандартного тега <math></math> можно (и удобнее) использовать родные символы $$ из $TeX$.

Единственное что — формулы отображаются с тем размером шрифта, в окружении какого они используются, и потому выглядят довольно мелко. Эту проблему мы решили введением шаблона Формула. Идея в том, чтобы окружить формулу тегом увеличения размера шрифта:

<span style="font-size:130%">$x + 2 = 4$</span>

Сноски

Они же примечания. Для их создания используется расширение Cite. Пример использования сносок можно посмотреть в Песочнице.

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

<cite_references_prefix> <cite_references_link_one> <cite_references_link_one> <cite_references_suffix>

То есть, какие-то действия производились, но результат был не тот, что должен был.

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

Обновление MediaWiki

Сам процесс подробнейше описан в официальной документации. Там же приводится несколько способов выполнения обновления. Обратите внимание на требования к ПО, особенно на версию PHP.

Мы же обновляем так:

1. загружаем архив с дистрибутивом отсюда;
2. распаковываем его в каталог с вики: tar xvzf mediawiki-1.20.2.tar.gz -C path/to/our/wiki/ --strip-components=1. С таким ключом распаковка пройдёт с заменой файлов, не трогая наши расширения, картинки и файл настроек;
3. идём в path/to/our/wiki/maintenance/ и выполняем там php5 update.php.

Всё, можно идти проверять версию MW.

Обновление с MediaWiki 1.17 до MediaWiki 1.19.2

Приведём сюрпризы, ожидавшие нас при обновлении с 1.17 до 1.19.2. Конечно, скорее всего, их бы не было, если бы мы тщательней изучили документацию перед обновлением.

Кстати, весьма вероятно, эти проблемы могут возникать не только при обновлении 1.17 до 1.19.2, но и при обновлении до других версий.

Логотип и иконка

Так как мы забыли, что размещённые по пути skins/common/images/ логотип и иконка сбросятся на дефолтные при обновлении, то они и сбросились. Пришлось заливать их обратно.

Запрет включения статей в категории шаблонов

Тег <noinclude>, препятствующий добавлению категории шаблона в статью, где он используется, перестал работать должным образом, и статьи с шаблонами моментально оказались в их категориях. Оказалось, что теперь «невключаемость» в категорию шаблона следует оформлять немного по-другому.

Как работало в 1.17:

<noinclude>[[Категория:Преподаватели]]</noinclude>

Как работает теперь в 1.19.2:

<noinclude>:[[Категория:Преподаватели]]</noinclude>

А через некоторое время стало работать и как раньше, потому мы вернули всё как было. Непонятно, что это случилось. Возможно, ненадолго сбилась категоризация, а после правок всё «перекатегоризировалось», так что, выходит, это двоеточие никак не влияло.

Выравнивание и таблицы

Конструкция, например, align="right" для выравнивая таблицы по правому краю страницы перестала обрабатываться, потому как за её обработку теперь вроде как отвечает CSS. В результате информационные таблицы, которые были удобно размещены справа, уехали влево.

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

Перевод некоторых служебных страниц

Слетел, (а скорее всего, в версии 1.19.2 просто отсутствует) перевод некоторых служебных страниц. Чтобы «доперевести» их, надо править страницы из пространства имён MediaWiki по тем именам, какими они сейчас отображаются.

Например, в служебных страницах висит уродливого вида ссылка:

Значит, надо открыть страницу MediaWiki:Changeemail и внести в неё правку — написать перевод: «Изменить адрес электронной почты«.

Для перевода надписей (подписей и иного текста), находящегося на этих страницах, править нужно эту же страницу в пространстве имён MediaWiki, но добавляя постфикс с именем надписи, под которым она сейчас отображается.

Например, на всё той же странице MediaWiki:Changeemail находится надпись с именем <changeemail-header>. Значит, надо открыть страницу MediaWiki:Changeemail-header и внести правку с переводом: «Изменение адреса электронной почты«.

Важно учитывать регистр. Если переводимый элемент принадлежит, например, странице BlockList, то правку надо вносить не в MediaWiki:BlockList, а в MediaWiki:Blocklist.

Обновление с MediaWiki 1.19.2 до MediaWiki 1.20.2

Выполнив всё по инструкции мы получили Fatal exception of type MWException при открытии любой страницы сайта.

Решение было найдено на доске поддержки MediaWiki. В итоге, обновление прошло следующим образом:

1. загружаем архив с дистрибутивом отсюда;
2. распаковываем его в каталог с вики: tar xvzf mediawiki-1.20.2.tar.gz -C path/to/our/wiki/ --strip-components=1. С таким ключом распаковка пройдёт с заменой файлов, не трогая наши расширения, картинки и файл настроек;
3. идём в path/to/our/wiki/maintenance/ и выполняем там: php5 update.php.
4. здесь же выполняем: php5 rebuildLocalisationCache.php --force.

Также данная ошибка может возникнуть при переносе MediaWiki между системами. В таком случае необходимо убедиться, что стоит расширение APC от PHP.

Важные мелочи

Небольшие, но важные советы:

• при создании шаблонов ни в коем случае не оставляйте пустых строк сверху (и снизу) конструкции <noinclude>. В противном случае пустая строка перенесётся в статью вместе с шаблоном и устроит там содомию.

Установка MediaWiki

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

Подробно об установке можно узнать из официальной инструкции, и ещё одна здесь.

Вики движок лучше не размещать в корне сайта. Почему, кратко объяснено в спец. статье.

После установки хорошо бы ознакомиться с задачами администратора MediaWiki, где сказано что ещё можно доделать.

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

Хорошие краткие инструкции (ЧаВО или FAQ) есть на официальном сайте MediaWiki как на русском языке, так и на английском.

Запрещаем редактирование не авторизованным пользователям:

$wgGroupPermissions['*']['createaccount'] = true;
$wgGroupPermissions['*']['read'] = true;
$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['*']['createpage'] = false;
$wgGroupPermissions['*']['createtalk'] = false;

Полный список прав см. в официальном руководстве

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

По умолчанию ссылки выглядят так: http://domain.ru/wiki/index.php?title=article. Чтобы сделать их такими же короткими и наглядными, как в Википедии, есть много способов. Один из них — это добавить в LocalSettings.php:

$wgScriptPath   = "/w";  
$wgArticlePath  = "/wiki/$1";
$wgUsePathInfo  = true;

где $wgScriptPath — каталог установки вики-сайта,

$wgArticlePath — виртуальный каталог, который нужно будет указать в URL при обращении к статье, имя не должно совпадать с реальным каталогом.

Затем, в корневом каталоге сайта (т.е. рядом с каталогом «w») нужно создать файл .htaccess:

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]

Для лучшего понимания этого кода можно подробней ознакомиться с синтаксисом директивы RewriteRule.

Если на сервере установлено несколько виртуальных хостов, то нужно ещё добавить  настройку виртуального хоста в секцию <VirtualHost>:

AllowOverride All
RewriteEngine On
RewriteOptions Inherit

и подключить модуль rewrite, после чего перезагрузить apache. В Debian это делается следующим образом:

ln -s /etc/apache2/mods-available/rewrite.load /etc/apache2/mods-enabled
/etc/init.d/apache2 restart

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

Права пользователя можно поменять на Special:Userrights. Подробно описано в официальном руководстве.

За изменение прав отвечает тип разрешения 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 = 'Имя_Пользователя';

Читайте подробней на официальном сайте. См также статью о MySQL.

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

Чтобы включить страницу или шаблон из другой вики, она должна быть описана в таблице интервики ссылок и в LocalSettings.php нужно добавить параметр $wgEnableScaryTranscluding:

$wgEnableScaryTranscluding = true;

Можно прочитать подбробней про включения (transclusion) вообще и про включения из других вики в частности.

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

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

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

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

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

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

Чтобы самостоятельно задать тип файлов указываем:

$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg', 'pdf', 'doc', 'docx', 'xls', 'xlsx','ods','odg','odt');

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

Подробней см. официальную документацию.

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

/* -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;
}

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

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

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

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

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

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

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

Для добавления возможности сортировки данных в колонках достаточно в заголовке добавить к названию класса слово «sortable». Например:

{| class="wikitable sortable"

См. подробнее на английском на официальном сайте.

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

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

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

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

• Можно добавить возможность сворачивать таблицы и фрагменты текста.

• Начиная с 1.18 для всех элементов добавлен класс «mw-collapsible», который можно указать не только для таблиц, но и для любого текста. Подробней см. справку по редактированию

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

• Сворачивать можно также разделы, таблицы, ячейки в таблицах и удалённые от кнопки сворачивания блоки. Примеры можно посмотреть на сайте тестирования MediaWiki

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

Перевести сайт в режим только для чтения можно определив переменную $wgReadOnly:

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

Меняем название заглавной страницы

Если в URL не указать страницу сайта, то мы попадём на страницу «Заглавная страница». Название «Заглавной страницы» можно поменять как и любой другой — переименованием, но чтобы избежать сообщения о перенаправлении, нужно изменить системное сообщение MediaWiki:Mainpage. Подробнее в оф. документации.

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

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

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

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

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

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

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

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

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

{{Special:PrefixIndex/MediaWiki/ |hideredirects=1 |stripprefix=1}}

где

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

Подробнее смотрите на официальных страницах:

• Подстраницы
• $wgNamespacesWithSubpages

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

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

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

Чтобы узнать, как скачать дампы базы данных со статьями Википедии, см. статью Википедии

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

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

• Для SQL дампа выполняем:

mysqldump -h $SERVER -u $USER -p$PASSWORD --default-character-set=$CHARSET $DATABASE -c 
| /bin/gzip -9 > ~/backup/wiki-$(date '+%a').sql.gz

параметры $USER, $PASSWORD и $DATABASE берём из LocalSettings.php

cat ./LocalSettings.php  | grep wgDB

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

параметр -h $SERVER нужен если подключаемся не через сокет, иначе получим ошибку:

mysqldump: Got error: 2002: Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2) when trying to connect

• Для XML дампа используем скрипт dumpBackup.php, расположенный в каталоге maintenance:

php maintenancedumpBackup.php --full > full.xml 

Список параметров dumpBackup.php можно получить, вызвав его без параметров, однако, в исходном коде этого скрипта есть ещё несколько недокументированных опций.

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

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

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

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

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

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

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

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

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

Почта

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

## 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";

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

$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' => "пароль"
);

Но в этом случае нам понадобиться установленный пакет 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.

Подробнее читайте на официальном сайте.

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

• Описание переменных конфигурационного файла на английском.

• Интервики (interwiki) — это ссылки, оформленные как внутренние ссылки с использованием специального префикса, но ведущие на страницы других проектов. Интервики-ссылки позволяют сделать ссылку на страницы других вики-проектов, например Википедии, Викиучебника, Викиновостей и т.д., или, к примеру, на разделы вашего вики-проекта на разных языках.
  • расширение SpecialInterwiki позволяет редактировать таблицу интервики ссылок через веб-интерфейс
  • расширение Interwiki позволяет редактировать таблицу интервики через текстовый файл.
  • Описание параметров интервики

• На странице MediaWiki:Tagline можно изменить подпись «Материал из НазваниеВики«. Подробнее в описании о настройке вида: Tagline

• Можно использовать «волшебные слова» (переключатели и переменные), например, для настройки отображение содержания, или вставки даты в определённом формате, или отображения статистики.

• Можно изменить некоторые умолчальные настройки профиля пользователя переменной $wgDefaultUserOptions. Например, чтобы не показывать ссылку «Правка» для секций для незарегистрированных пользователей, нужно добавить в LocalSettings.php

$wgDefaultUserOptions ['editsection'] = 0;

См. также

Тематические подстраницы для этой:

А также:

• Семантика — как установить, настроить и использовать её
• В категории 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://www.mediawiki.org/wiki/Category:MediaWiki_database_tables — Информация по таблицам БД
• https://www.mediawiki.org/wiki/Version_lifecycle — Жизненный цикл версий движка MediaWiki