MediaWiki - Настройка и расширения
Статья посвящена всему тому, с чем пришлось столкнуться в процессе использования MediaWiki. Такая своеобразная записная книжка.
Настройка MediaWiki
Изменение стиля wikitable
По умолчанию у класса таблиц wikitable
ничтожно маленькое значение отступа от границ ячейки, из-за чего таблицы не радуют глаз. Для установки собственного значения отступа необходимо внести изменения в файл skins\common\shared.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
.
Расширения
Они же extensions. Позволяют расширить функционал вики. Например, добавить поддержку TeX формул и подсветку синтаксиса фрагментов исходного кода на том или ином языке программирования.
Устанавливаются все одинаково:
- загрузить архив с расширением:
- распаковать его в каталог
extensions
корневого каталога; - в файле
LocalSettings.php
из корневого каталога вики добавить строку подключения расширения.
Подсветка синтаксиса
У нас используется SyntaxHighlight GeSHi.
Использование TeX формул
Обновление MediaWiki
Сам процесс уже подробнейше описан, добавить нечего. Приведём лишь сюрпризы, ожидавшие нас при обновлении с 1.17 до 1.19.2. Конечно, скорее всего, их бы не было, если бы мы тщательней изучили документацию перед обновлением.
Запрет включения статей в категории шаблонов
Тег <noinclude>
, препятствующий добавлению категории шаблона в статью, где он используется, перестал работать должным образом, и статьи с шаблонами моментально оказались в их категориях. Не смертельно, но неприятно. Оказалось, что теперь "невключаемость" в категорию шаблона следует оформлять немного по-другому.
Как работало в 1.17:
<noinclude>[[Категория:Преподаватели]]</noinclude>
Как работает теперь в 1.19.2:
<noinclude>:[[Категория:Преподаватели]]</noinclude>
Как видите, разница всего лишь в двоеточии. Но оно стоило определённого количества нервов.
Выравнивание таблицы на странице
Конструкция, например, align="right"
для выравнивая таблицы по правому краю страницы перестала обрабатываться, потому как за её обработку теперь вроде как отвечает CSS. Оказалось, что мы всё проспали: и такой способ устарел и считается плохой практикой в вёрстке. Вместо этого следует использовать следующее:
Тип выравнивания | Код разметки |
---|---|
По левому краю | style="float:left;"
|
По правому краю | style="float:right;"
|
По центру | style="margin:auto;"
|
Важные мелочи
Небольшие, но важные советы:
- при создании шаблонов ни в коем случае не оставляйте пустых строк сверху (и снизу) конструкции <noinclude>. В противном случае пустая строка перенесётся в статью вместе с шаблоном и устроит там содомию;