Кафедра ИУ5 МГТУ им. Н.Э.Баумана, студенческое сообщество - Вклад [ru]

MediaWiki - Настройка и расширения

2013-01-28T10:28:09Z

Penny: /* Обновление с MediaWiki 1.17 до MediaWiki 1.19.2 */ общие проблемы

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования [http://www.mediawiki.org/ MediaWiki]. Такая своеобразная записная книжка.

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

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

=== BPoD ===

Blank Page of Death (BPoD) - белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:
* неверные настройки в файле <code>LocalSettings.php</code>;
* некорректно работающее свежеустановленное расширение.

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

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

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

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

== Настройка MediaWiki ==

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

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

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

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

<syntaxhighlight lang="php">$wgSitename = "Ваше название вики";</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php">$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";</syntaxhighlight>

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

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

Загружать иконку рекомундуется туда же, куда и [[#Установка логотипа | логотип]]. Размеры её должны быть 16x16, а формат - {{Википедия|ICO_(формат_файлов)|ICO}}. Так же можно [[Прозрачный фон изображения | сделать ей прозрачный фон]]. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

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

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

<syntaxhighlight lang="php">$wgFavicon = "$wgStylePath/common/images/favicon.ico";</syntaxhighlight>

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

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

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

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

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

<syntaxhighlight lang="php">$wgEnableUploads = true;</syntaxhighlight>

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

<syntaxhighlight lang="php">$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php" highlight="10">
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;
}
</syntaxhighlight>

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

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

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

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

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

Мы используем счётчик от [http://metrika.yandex.ru/add/ Яндекса]. Код его сохранён в файле <code>skins/counter_yandex.php</code>.

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

<syntaxhighlight line enclose="div" highlight="13" lang=php>

<div id="footer"<?php $this->html( 'userlangattributes' ) ?>>
<?php foreach( $this->getFooterLinks() as $category => $links ): ?>
<ul id="footer-<?php echo $category ?>">
<?php foreach( $links as $link ): ?>
<li id="footer-<?php echo $category ?>-<?php echo $link ?>"><?php $this->html( $link ) ?></li>
<?php endforeach; ?>
</ul>
<?php endforeach; ?>
<?php $footericons = $this->getFooterIcons("icononly");
if ( count( $footericons ) > 0 ): ?>
<ul id="footer-icons" class="noprint">
<li><?php include("counter_yandex.php"); ?></li> 
<?php foreach ( $footericons as $blockName => $footerIcons ): ?>
<li id="footer-<?php echo htmlspecialchars( $blockName ); ?>ico">
<?php foreach ( $footerIcons as $icon ): ?>
<?php echo $this->getSkin()->makeFooterIcon( $icon ); ?>

<?php endforeach; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
<div style="clear:both"></div>
</div>

</syntaxhighlight>

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

== Расширения MediaWiki ==

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

Устанавливаются все одинаково:
# загрузить архив с расширением:
# распаковать его в каталог <code>extensions</code> корневого каталога;
# в файле <code>LocalSettings.php</code> из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и [[Работа с Linux-сервером | через SSH]].

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

==== SyntaxHighlight GeSHi ====

У нас используется [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi]. Установка [[#Расширения MediaWiki | ничем не примечательна]], однако на версии MediaWiki 1.17 расширение работать отказывалось - браузер выдавал лишь [[#BPoD | белую страницу смерти]]. Из-за этого до обновления приходилось использовать [http://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter] - более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

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

===== Правка MediaWiki:Geshi.css =====

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

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

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

<syntaxhighlight lang="css">div.mw-geshi {
font-size: 15px
}</syntaxhighlight>

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

===== Правка SyntaxHighlight_GeSHi.class.php =====

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

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal;}";</syntaxhighlight>

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal; font-size: 12px;}";</syntaxhighlight>

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

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

Так как мы технари, то нам просто необходима поддержка {{Формула|f=\TeX}}. Любые "псевдоформулы" набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку {{Формула|f=\TeX}} разметки, нужно было бороться до конца.

==== Math ====

Начали мы с расширения [http://www.mediawiki.org/wiki/Extension:Math Math]. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог <code>math</code>).

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

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты <code>texvc</code>. Нужно [[Работа с Linux-сервером | зайти в этот каталог и выполнить команду]] <code>make</code>. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и [[Работа с Linux-сервером | назначьте им права 755]]:
* <code>images/math</code>;
* <code>images/tmp</code>.

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

<syntaxhighlight lang=php>$wgUseTeX = "true";
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";</syntaxhighlight>

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

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

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

<syntaxhighlight lang=php>$wgDefaultUserOptions['math'] = 0;</syntaxhighlight>

==== MathJax ====

После обновления MediaWiki до версии 1.19.2 расширение [http://www.mediawiki.org/wiki/Extension:Math Math] работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение [http://www.mediawiki.org/wiki/Extension:MathJax MathJax].

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

Устанавливается расширение [[#Расширения MediaWiki | стандартно]].

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

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

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

=== Сноски ===

Они же ''примечания''. Для их создания используется расширение [https://www.mediawiki.org/wiki/Extension:Cite Cite]. Пример использования сносок можно посмотреть в [[Песочница#Сноски | Песочнице]].

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

<code><nowiki><cite_references_prefix> <cite_references_link_one> <cite_references_link_one> <cite_references_suffix></nowiki></code>

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

В итоге, всё решилось примерно так же, как и с [[#Перевод некоторых служебных страниц | недопереведёнными служебными страницами]]. Просто поочерёдно открывали одноимённые служебные страницы из пространства имён <code>MediaWiki</code> в Википедии и копировали текст оттуда на свои.

== Обновление MediaWiki ==

Сам процесс [http://www.mediawiki.org/wiki/Manual:Upgrading подробнейше описан] в официальной документации. Там же приводится несколько способов выполнения обновления. Обратите внимание на требования к ПО, особенно на версию PHP.

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

Всё, можно идти проверять [[Special:Version | версию MW]].

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

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

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

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

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

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

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

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

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

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

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

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

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

{| class="wikitable"
|- align="center"
! colspan="2" | Для всей таблицы
|- align="center"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="float:left;"</code>
|- align="center"
| По правому краю || <code>style="float:right;"</code>
|- align="center"
| По центру || <code>style="margin:auto;"</code>
|- align="center"
! colspan="2" | Для текста в ячейке
|- align="center"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="text-align:left;"</code>
|- align="center"
| По правому краю || <code>style="text-align:right;"</code>
|- align="center"
| По центру || <code>style="text-align:center;"</code>
|}

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

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

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

<syntaxhighlight lang="sql"><changeemail></syntaxhighlight>

Значит, надо открыть страницу <code>MediaWiki:Changeemail</code> и внести в неё правку - написать перевод: "<code>Изменить адрес электронной почты</code>".

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

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

Важно учитывать регистр. Если переводимый элемент принадлежит, например, странице <code>BlockList</code>, то правку надо вносить не в <code>MediaWiki:Block<span style="color:red">'''L'''</span>ist</code>, а в <code>MediaWiki:Block<span style="color:green">'''l'''</span>ist</code>.

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

Выполнив всё по [[#Обновление MediaWiki | инструкции]] мы получили <font color="red">'''Fatal exception of type MWException'''</font> при открытии любой страницы сайта.

Решение было найдено на [http://mediawiki.org/wiki/Project:Support_desk доске поддержки MediaWiki]. В итоге, обновление прошло следующим образом:
# загружаем архив с дистрибутивом [http://www.mediawiki.org/wiki/Download отсюда];
# распаковываем его в каталог с вики: <code>tar xvzf mediawiki-1.20.2.tar.gz -C path/to/our/wiki/ --strip-components=1</code>. С таким ключом распаковка пройдёт с заменой файлов, не трогая наши расширения, картинки и файл настроек;
# идём в <code>path/to/our/wiki/maintenance/</code> и выполняем там: <code>php5 update.php</code>.
# здесь же выполняем: <code>php5 rebuildLocalisationCache.php --force</code>.

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

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

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

MediaWiki - Настройка и расширения

2013-01-28T10:23:32Z

Penny: /* Обновление MediaWiki */ про требования к ПО

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования [http://www.mediawiki.org/ MediaWiki]. Такая своеобразная записная книжка.

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

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

=== BPoD ===

Blank Page of Death (BPoD) - белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:
* неверные настройки в файле <code>LocalSettings.php</code>;
* некорректно работающее свежеустановленное расширение.

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

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

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

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

== Настройка MediaWiki ==

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

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

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

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

<syntaxhighlight lang="php">$wgSitename = "Ваше название вики";</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php">$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";</syntaxhighlight>

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

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

Загружать иконку рекомундуется туда же, куда и [[#Установка логотипа | логотип]]. Размеры её должны быть 16x16, а формат - {{Википедия|ICO_(формат_файлов)|ICO}}. Так же можно [[Прозрачный фон изображения | сделать ей прозрачный фон]]. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

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

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

<syntaxhighlight lang="php">$wgFavicon = "$wgStylePath/common/images/favicon.ico";</syntaxhighlight>

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

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

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

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

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

<syntaxhighlight lang="php">$wgEnableUploads = true;</syntaxhighlight>

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

<syntaxhighlight lang="php">$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php" highlight="10">
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;
}
</syntaxhighlight>

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

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

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

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

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

Мы используем счётчик от [http://metrika.yandex.ru/add/ Яндекса]. Код его сохранён в файле <code>skins/counter_yandex.php</code>.

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

<syntaxhighlight line enclose="div" highlight="13" lang=php>

<div id="footer"<?php $this->html( 'userlangattributes' ) ?>>
<?php foreach( $this->getFooterLinks() as $category => $links ): ?>
<ul id="footer-<?php echo $category ?>">
<?php foreach( $links as $link ): ?>
<li id="footer-<?php echo $category ?>-<?php echo $link ?>"><?php $this->html( $link ) ?></li>
<?php endforeach; ?>
</ul>
<?php endforeach; ?>
<?php $footericons = $this->getFooterIcons("icononly");
if ( count( $footericons ) > 0 ): ?>
<ul id="footer-icons" class="noprint">
<li><?php include("counter_yandex.php"); ?></li> 
<?php foreach ( $footericons as $blockName => $footerIcons ): ?>
<li id="footer-<?php echo htmlspecialchars( $blockName ); ?>ico">
<?php foreach ( $footerIcons as $icon ): ?>
<?php echo $this->getSkin()->makeFooterIcon( $icon ); ?>

<?php endforeach; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
<div style="clear:both"></div>
</div>

</syntaxhighlight>

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

== Расширения MediaWiki ==

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

Устанавливаются все одинаково:
# загрузить архив с расширением:
# распаковать его в каталог <code>extensions</code> корневого каталога;
# в файле <code>LocalSettings.php</code> из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и [[Работа с Linux-сервером | через SSH]].

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

==== SyntaxHighlight GeSHi ====

У нас используется [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi]. Установка [[#Расширения MediaWiki | ничем не примечательна]], однако на версии MediaWiki 1.17 расширение работать отказывалось - браузер выдавал лишь [[#BPoD | белую страницу смерти]]. Из-за этого до обновления приходилось использовать [http://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter] - более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

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

===== Правка MediaWiki:Geshi.css =====

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

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

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

<syntaxhighlight lang="css">div.mw-geshi {
font-size: 15px
}</syntaxhighlight>

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

===== Правка SyntaxHighlight_GeSHi.class.php =====

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

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal;}";</syntaxhighlight>

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal; font-size: 12px;}";</syntaxhighlight>

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

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

Так как мы технари, то нам просто необходима поддержка {{Формула|f=\TeX}}. Любые "псевдоформулы" набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку {{Формула|f=\TeX}} разметки, нужно было бороться до конца.

==== Math ====

Начали мы с расширения [http://www.mediawiki.org/wiki/Extension:Math Math]. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог <code>math</code>).

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

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты <code>texvc</code>. Нужно [[Работа с Linux-сервером | зайти в этот каталог и выполнить команду]] <code>make</code>. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и [[Работа с Linux-сервером | назначьте им права 755]]:
* <code>images/math</code>;
* <code>images/tmp</code>.

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

<syntaxhighlight lang=php>$wgUseTeX = "true";
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";</syntaxhighlight>

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

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

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

<syntaxhighlight lang=php>$wgDefaultUserOptions['math'] = 0;</syntaxhighlight>

==== MathJax ====

После обновления MediaWiki до версии 1.19.2 расширение [http://www.mediawiki.org/wiki/Extension:Math Math] работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение [http://www.mediawiki.org/wiki/Extension:MathJax MathJax].

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

Устанавливается расширение [[#Расширения MediaWiki | стандартно]].

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

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

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

=== Сноски ===

Они же ''примечания''. Для их создания используется расширение [https://www.mediawiki.org/wiki/Extension:Cite Cite]. Пример использования сносок можно посмотреть в [[Песочница#Сноски | Песочнице]].

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

<code><nowiki><cite_references_prefix> <cite_references_link_one> <cite_references_link_one> <cite_references_suffix></nowiki></code>

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

В итоге, всё решилось примерно так же, как и с [[#Перевод некоторых служебных страниц | недопереведёнными служебными страницами]]. Просто поочерёдно открывали одноимённые служебные страницы из пространства имён <code>MediaWiki</code> в Википедии и копировали текст оттуда на свои.

== Обновление MediaWiki ==

Сам процесс [http://www.mediawiki.org/wiki/Manual:Upgrading подробнейше описан] в официальной документации. Там же приводится несколько способов выполнения обновления. Обратите внимание на требования к ПО, особенно на версию PHP.

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

Всё, можно идти проверять [[Special:Version | версию MW]].

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

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

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

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

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

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

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

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

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

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

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

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

{| class="wikitable"
|- align="center"
! colspan="2" | Для всей таблицы
|- align="center"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="float:left;"</code>
|- align="center"
| По правому краю || <code>style="float:right;"</code>
|- align="center"
| По центру || <code>style="margin:auto;"</code>
|- align="center"
! colspan="2" | Для текста в ячейке
|- align="center"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="text-align:left;"</code>
|- align="center"
| По правому краю || <code>style="text-align:right;"</code>
|- align="center"
| По центру || <code>style="text-align:center;"</code>
|}

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

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

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

<syntaxhighlight lang="sql"><changeemail></syntaxhighlight>

Значит, надо открыть страницу <code>MediaWiki:Changeemail</code> и внести в неё правку - написать перевод: "<code>Изменить адрес электронной почты</code>".

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

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

Важно учитывать регистр. Если переводимый элемент принадлежит, например, странице <code>BlockList</code>, то правку надо вносить не в <code>MediaWiki:Block<span style="color:red">'''L'''</span>ist</code>, а в <code>MediaWiki:Block<span style="color:green">'''l'''</span>ist</code>.

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

Выполнив всё по [[#Обновление MediaWiki | инструкции]] мы получили <font color="red">'''Fatal exception of type MWException'''</font> при открытии любой страницы сайта.

Решение было найдено на [http://mediawiki.org/wiki/Project:Support_desk доске поддержки MediaWiki]. В итоге, обновление прошло следующим образом:
# загружаем архив с дистрибутивом [http://www.mediawiki.org/wiki/Download отсюда];
# распаковываем его в каталог с вики: <code>tar xvzf mediawiki-1.20.2.tar.gz -C path/to/our/wiki/ --strip-components=1</code>. С таким ключом распаковка пройдёт с заменой файлов, не трогая наши расширения, картинки и файл настроек;
# идём в <code>path/to/our/wiki/maintenance/</code> и выполняем там: <code>php5 update.php</code>.
# здесь же выполняем: <code>php5 rebuildLocalisationCache.php --force</code>.

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

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

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

MediaWiki - Настройка и расширения

2013-01-28T10:21:17Z

Penny: /* Обновление с MediaWiki 1.19.2 до MediaWiki 1.20.2 */ пунктуация

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования [http://www.mediawiki.org/ MediaWiki]. Такая своеобразная записная книжка.

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

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

=== BPoD ===

Blank Page of Death (BPoD) - белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:
* неверные настройки в файле <code>LocalSettings.php</code>;
* некорректно работающее свежеустановленное расширение.

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

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

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

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

== Настройка MediaWiki ==

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

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

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

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

<syntaxhighlight lang="php">$wgSitename = "Ваше название вики";</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php">$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";</syntaxhighlight>

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

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

Загружать иконку рекомундуется туда же, куда и [[#Установка логотипа | логотип]]. Размеры её должны быть 16x16, а формат - {{Википедия|ICO_(формат_файлов)|ICO}}. Так же можно [[Прозрачный фон изображения | сделать ей прозрачный фон]]. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

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

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

<syntaxhighlight lang="php">$wgFavicon = "$wgStylePath/common/images/favicon.ico";</syntaxhighlight>

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

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

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

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

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

<syntaxhighlight lang="php">$wgEnableUploads = true;</syntaxhighlight>

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

<syntaxhighlight lang="php">$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php" highlight="10">
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;
}
</syntaxhighlight>

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

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

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

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

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

Мы используем счётчик от [http://metrika.yandex.ru/add/ Яндекса]. Код его сохранён в файле <code>skins/counter_yandex.php</code>.

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

<syntaxhighlight line enclose="div" highlight="13" lang=php>

<div id="footer"<?php $this->html( 'userlangattributes' ) ?>>
<?php foreach( $this->getFooterLinks() as $category => $links ): ?>
<ul id="footer-<?php echo $category ?>">
<?php foreach( $links as $link ): ?>
<li id="footer-<?php echo $category ?>-<?php echo $link ?>"><?php $this->html( $link ) ?></li>
<?php endforeach; ?>
</ul>
<?php endforeach; ?>
<?php $footericons = $this->getFooterIcons("icononly");
if ( count( $footericons ) > 0 ): ?>
<ul id="footer-icons" class="noprint">
<li><?php include("counter_yandex.php"); ?></li> 
<?php foreach ( $footericons as $blockName => $footerIcons ): ?>
<li id="footer-<?php echo htmlspecialchars( $blockName ); ?>ico">
<?php foreach ( $footerIcons as $icon ): ?>
<?php echo $this->getSkin()->makeFooterIcon( $icon ); ?>

<?php endforeach; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
<div style="clear:both"></div>
</div>

</syntaxhighlight>

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

== Расширения MediaWiki ==

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

Устанавливаются все одинаково:
# загрузить архив с расширением:
# распаковать его в каталог <code>extensions</code> корневого каталога;
# в файле <code>LocalSettings.php</code> из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и [[Работа с Linux-сервером | через SSH]].

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

==== SyntaxHighlight GeSHi ====

У нас используется [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi]. Установка [[#Расширения MediaWiki | ничем не примечательна]], однако на версии MediaWiki 1.17 расширение работать отказывалось - браузер выдавал лишь [[#BPoD | белую страницу смерти]]. Из-за этого до обновления приходилось использовать [http://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter] - более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

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

===== Правка MediaWiki:Geshi.css =====

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

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

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

<syntaxhighlight lang="css">div.mw-geshi {
font-size: 15px
}</syntaxhighlight>

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

===== Правка SyntaxHighlight_GeSHi.class.php =====

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

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal;}";</syntaxhighlight>

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal; font-size: 12px;}";</syntaxhighlight>

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

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

Так как мы технари, то нам просто необходима поддержка {{Формула|f=\TeX}}. Любые "псевдоформулы" набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку {{Формула|f=\TeX}} разметки, нужно было бороться до конца.

==== Math ====

Начали мы с расширения [http://www.mediawiki.org/wiki/Extension:Math Math]. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог <code>math</code>).

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

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты <code>texvc</code>. Нужно [[Работа с Linux-сервером | зайти в этот каталог и выполнить команду]] <code>make</code>. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и [[Работа с Linux-сервером | назначьте им права 755]]:
* <code>images/math</code>;
* <code>images/tmp</code>.

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

<syntaxhighlight lang=php>$wgUseTeX = "true";
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";</syntaxhighlight>

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

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

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

<syntaxhighlight lang=php>$wgDefaultUserOptions['math'] = 0;</syntaxhighlight>

==== MathJax ====

После обновления MediaWiki до версии 1.19.2 расширение [http://www.mediawiki.org/wiki/Extension:Math Math] работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение [http://www.mediawiki.org/wiki/Extension:MathJax MathJax].

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

Устанавливается расширение [[#Расширения MediaWiki | стандартно]].

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

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

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

=== Сноски ===

Они же ''примечания''. Для их создания используется расширение [https://www.mediawiki.org/wiki/Extension:Cite Cite]. Пример использования сносок можно посмотреть в [[Песочница#Сноски | Песочнице]].

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

<code><nowiki><cite_references_prefix> <cite_references_link_one> <cite_references_link_one> <cite_references_suffix></nowiki></code>

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

В итоге, всё решилось примерно так же, как и с [[#Перевод некоторых служебных страниц | недопереведёнными служебными страницами]]. Просто поочерёдно открывали одноимённые служебные страницы из пространства имён <code>MediaWiki</code> в Википедии и копировали текст оттуда на свои.

== Обновление MediaWiki ==

Сам процесс [http://www.mediawiki.org/wiki/Manual:Upgrading подробнейше описан] в официальной документации. Там же приводится несколько способов выполнения обновления.

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

Всё, можно идти проверять [[Special:Version | версию MW]].

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

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

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

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

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

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

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

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

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

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

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

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

{| class="wikitable"
|- align="center"
! colspan="2" | Для всей таблицы
|- align="center"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="float:left;"</code>
|- align="center"
| По правому краю || <code>style="float:right;"</code>
|- align="center"
| По центру || <code>style="margin:auto;"</code>
|- align="center"
! colspan="2" | Для текста в ячейке
|- align="center"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="text-align:left;"</code>
|- align="center"
| По правому краю || <code>style="text-align:right;"</code>
|- align="center"
| По центру || <code>style="text-align:center;"</code>
|}

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

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

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

<syntaxhighlight lang="sql"><changeemail></syntaxhighlight>

Значит, надо открыть страницу <code>MediaWiki:Changeemail</code> и внести в неё правку - написать перевод: "<code>Изменить адрес электронной почты</code>".

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

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

Важно учитывать регистр. Если переводимый элемент принадлежит, например, странице <code>BlockList</code>, то правку надо вносить не в <code>MediaWiki:Block<span style="color:red">'''L'''</span>ist</code>, а в <code>MediaWiki:Block<span style="color:green">'''l'''</span>ist</code>.

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

Выполнив всё по [[#Обновление MediaWiki | инструкции]] мы получили <font color="red">'''Fatal exception of type MWException'''</font> при открытии любой страницы сайта.

Решение было найдено на [http://mediawiki.org/wiki/Project:Support_desk доске поддержки MediaWiki]. В итоге, обновление прошло следующим образом:
# загружаем архив с дистрибутивом [http://www.mediawiki.org/wiki/Download отсюда];
# распаковываем его в каталог с вики: <code>tar xvzf mediawiki-1.20.2.tar.gz -C path/to/our/wiki/ --strip-components=1</code>. С таким ключом распаковка пройдёт с заменой файлов, не трогая наши расширения, картинки и файл настроек;
# идём в <code>path/to/our/wiki/maintenance/</code> и выполняем там: <code>php5 update.php</code>.
# здесь же выполняем: <code>php5 rebuildLocalisationCache.php --force</code>.

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

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

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

MediaWiki - Настройка и расширения

2013-01-28T10:20:32Z

Penny: /* Обновление с MediaWiki 1.19.2 до MediaWiki 1.20.2 */ уточнение

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования [http://www.mediawiki.org/ MediaWiki]. Такая своеобразная записная книжка.

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

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

=== BPoD ===

Blank Page of Death (BPoD) - белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:
* неверные настройки в файле <code>LocalSettings.php</code>;
* некорректно работающее свежеустановленное расширение.

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

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

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

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

== Настройка MediaWiki ==

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

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

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

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

<syntaxhighlight lang="php">$wgSitename = "Ваше название вики";</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php">$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";</syntaxhighlight>

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

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

Загружать иконку рекомундуется туда же, куда и [[#Установка логотипа | логотип]]. Размеры её должны быть 16x16, а формат - {{Википедия|ICO_(формат_файлов)|ICO}}. Так же можно [[Прозрачный фон изображения | сделать ей прозрачный фон]]. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

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

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

<syntaxhighlight lang="php">$wgFavicon = "$wgStylePath/common/images/favicon.ico";</syntaxhighlight>

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

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

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

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

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

<syntaxhighlight lang="php">$wgEnableUploads = true;</syntaxhighlight>

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

<syntaxhighlight lang="php">$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php" highlight="10">
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;
}
</syntaxhighlight>

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

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

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

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

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

Мы используем счётчик от [http://metrika.yandex.ru/add/ Яндекса]. Код его сохранён в файле <code>skins/counter_yandex.php</code>.

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

<syntaxhighlight line enclose="div" highlight="13" lang=php>

<div id="footer"<?php $this->html( 'userlangattributes' ) ?>>
<?php foreach( $this->getFooterLinks() as $category => $links ): ?>
<ul id="footer-<?php echo $category ?>">
<?php foreach( $links as $link ): ?>
<li id="footer-<?php echo $category ?>-<?php echo $link ?>"><?php $this->html( $link ) ?></li>
<?php endforeach; ?>
</ul>
<?php endforeach; ?>
<?php $footericons = $this->getFooterIcons("icononly");
if ( count( $footericons ) > 0 ): ?>
<ul id="footer-icons" class="noprint">
<li><?php include("counter_yandex.php"); ?></li> 
<?php foreach ( $footericons as $blockName => $footerIcons ): ?>
<li id="footer-<?php echo htmlspecialchars( $blockName ); ?>ico">
<?php foreach ( $footerIcons as $icon ): ?>
<?php echo $this->getSkin()->makeFooterIcon( $icon ); ?>

<?php endforeach; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
<div style="clear:both"></div>
</div>

</syntaxhighlight>

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

== Расширения MediaWiki ==

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

Устанавливаются все одинаково:
# загрузить архив с расширением:
# распаковать его в каталог <code>extensions</code> корневого каталога;
# в файле <code>LocalSettings.php</code> из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и [[Работа с Linux-сервером | через SSH]].

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

==== SyntaxHighlight GeSHi ====

У нас используется [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi]. Установка [[#Расширения MediaWiki | ничем не примечательна]], однако на версии MediaWiki 1.17 расширение работать отказывалось - браузер выдавал лишь [[#BPoD | белую страницу смерти]]. Из-за этого до обновления приходилось использовать [http://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter] - более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

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

===== Правка MediaWiki:Geshi.css =====

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

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

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

<syntaxhighlight lang="css">div.mw-geshi {
font-size: 15px
}</syntaxhighlight>

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

===== Правка SyntaxHighlight_GeSHi.class.php =====

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

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal;}";</syntaxhighlight>

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal; font-size: 12px;}";</syntaxhighlight>

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

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

Так как мы технари, то нам просто необходима поддержка {{Формула|f=\TeX}}. Любые "псевдоформулы" набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку {{Формула|f=\TeX}} разметки, нужно было бороться до конца.

==== Math ====

Начали мы с расширения [http://www.mediawiki.org/wiki/Extension:Math Math]. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог <code>math</code>).

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

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты <code>texvc</code>. Нужно [[Работа с Linux-сервером | зайти в этот каталог и выполнить команду]] <code>make</code>. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и [[Работа с Linux-сервером | назначьте им права 755]]:
* <code>images/math</code>;
* <code>images/tmp</code>.

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

<syntaxhighlight lang=php>$wgUseTeX = "true";
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";</syntaxhighlight>

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

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

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

<syntaxhighlight lang=php>$wgDefaultUserOptions['math'] = 0;</syntaxhighlight>

==== MathJax ====

После обновления MediaWiki до версии 1.19.2 расширение [http://www.mediawiki.org/wiki/Extension:Math Math] работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение [http://www.mediawiki.org/wiki/Extension:MathJax MathJax].

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

Устанавливается расширение [[#Расширения MediaWiki | стандартно]].

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

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

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

=== Сноски ===

Они же ''примечания''. Для их создания используется расширение [https://www.mediawiki.org/wiki/Extension:Cite Cite]. Пример использования сносок можно посмотреть в [[Песочница#Сноски | Песочнице]].

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

<code><nowiki><cite_references_prefix> <cite_references_link_one> <cite_references_link_one> <cite_references_suffix></nowiki></code>

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

В итоге, всё решилось примерно так же, как и с [[#Перевод некоторых служебных страниц | недопереведёнными служебными страницами]]. Просто поочерёдно открывали одноимённые служебные страницы из пространства имён <code>MediaWiki</code> в Википедии и копировали текст оттуда на свои.

== Обновление MediaWiki ==

Сам процесс [http://www.mediawiki.org/wiki/Manual:Upgrading подробнейше описан] в официальной документации. Там же приводится несколько способов выполнения обновления.

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

Всё, можно идти проверять [[Special:Version | версию MW]].

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

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

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

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

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

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

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

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

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

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

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

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

{| class="wikitable"
|- align="center"
! colspan="2" | Для всей таблицы
|- align="center"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="float:left;"</code>
|- align="center"
| По правому краю || <code>style="float:right;"</code>
|- align="center"
| По центру || <code>style="margin:auto;"</code>
|- align="center"
! colspan="2" | Для текста в ячейке
|- align="center"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="text-align:left;"</code>
|- align="center"
| По правому краю || <code>style="text-align:right;"</code>
|- align="center"
| По центру || <code>style="text-align:center;"</code>
|}

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

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

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

<syntaxhighlight lang="sql"><changeemail></syntaxhighlight>

Значит, надо открыть страницу <code>MediaWiki:Changeemail</code> и внести в неё правку - написать перевод: "<code>Изменить адрес электронной почты</code>".

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

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

Важно учитывать регистр. Если переводимый элемент принадлежит, например, странице <code>BlockList</code>, то правку надо вносить не в <code>MediaWiki:Block<span style="color:red">'''L'''</span>ist</code>, а в <code>MediaWiki:Block<span style="color:green">'''l'''</span>ist</code>.

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

Выполнив всё по [[#Обновление MediaWiki | инструкции]] мы получили <font color="red">'''Fatal exception of type MWException'''</font> при открытии любой страницы сайта.

Решение было найдено на [http://mediawiki.org/wiki/Project:Support_desk доске поддержки MediaWiki]. В итоге, обновление прошло следующим образом:
# загружаем архив с дистрибутивом [http://www.mediawiki.org/wiki/Download отсюда];
# распаковываем его в каталог с вики: <code>tar xvzf mediawiki-1.20.2.tar.gz -C path/to/our/wiki/ --strip-components=1</code>. С таким ключом распаковка пройдёт с заменой файлов, не трогая наши расширения, картинки и файл настроек;
# идём в <code>path/to/our/wiki/maintenance/</code> и выполняем там <code>php5 update.php</code>.
# здесь же выполняем: <code>php5 rebuildLocalisationCache.php --force</code>.

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

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

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

MediaWiki - Настройка и расширения

2013-01-28T10:07:12Z

Penny: /* Обновление MediaWiki */ с 1.19.2 до 1.20.2

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования [http://www.mediawiki.org/ MediaWiki]. Такая своеобразная записная книжка.

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

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

=== BPoD ===

Blank Page of Death (BPoD) - белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:
* неверные настройки в файле <code>LocalSettings.php</code>;
* некорректно работающее свежеустановленное расширение.

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

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

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

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

== Настройка MediaWiki ==

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

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

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

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

<syntaxhighlight lang="php">$wgSitename = "Ваше название вики";</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php">$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";</syntaxhighlight>

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

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

Загружать иконку рекомундуется туда же, куда и [[#Установка логотипа | логотип]]. Размеры её должны быть 16x16, а формат - {{Википедия|ICO_(формат_файлов)|ICO}}. Так же можно [[Прозрачный фон изображения | сделать ей прозрачный фон]]. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

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

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

<syntaxhighlight lang="php">$wgFavicon = "$wgStylePath/common/images/favicon.ico";</syntaxhighlight>

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

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

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

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

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

<syntaxhighlight lang="php">$wgEnableUploads = true;</syntaxhighlight>

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

<syntaxhighlight lang="php">$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php" highlight="10">
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;
}
</syntaxhighlight>

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

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

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

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

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

Мы используем счётчик от [http://metrika.yandex.ru/add/ Яндекса]. Код его сохранён в файле <code>skins/counter_yandex.php</code>.

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

<syntaxhighlight line enclose="div" highlight="13" lang=php>

<div id="footer"<?php $this->html( 'userlangattributes' ) ?>>
<?php foreach( $this->getFooterLinks() as $category => $links ): ?>
<ul id="footer-<?php echo $category ?>">
<?php foreach( $links as $link ): ?>
<li id="footer-<?php echo $category ?>-<?php echo $link ?>"><?php $this->html( $link ) ?></li>
<?php endforeach; ?>
</ul>
<?php endforeach; ?>
<?php $footericons = $this->getFooterIcons("icononly");
if ( count( $footericons ) > 0 ): ?>
<ul id="footer-icons" class="noprint">
<li><?php include("counter_yandex.php"); ?></li> 
<?php foreach ( $footericons as $blockName => $footerIcons ): ?>
<li id="footer-<?php echo htmlspecialchars( $blockName ); ?>ico">
<?php foreach ( $footerIcons as $icon ): ?>
<?php echo $this->getSkin()->makeFooterIcon( $icon ); ?>

<?php endforeach; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
<div style="clear:both"></div>
</div>

</syntaxhighlight>

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

== Расширения MediaWiki ==

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

Устанавливаются все одинаково:
# загрузить архив с расширением:
# распаковать его в каталог <code>extensions</code> корневого каталога;
# в файле <code>LocalSettings.php</code> из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и [[Работа с Linux-сервером | через SSH]].

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

==== SyntaxHighlight GeSHi ====

У нас используется [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi]. Установка [[#Расширения MediaWiki | ничем не примечательна]], однако на версии MediaWiki 1.17 расширение работать отказывалось - браузер выдавал лишь [[#BPoD | белую страницу смерти]]. Из-за этого до обновления приходилось использовать [http://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter] - более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

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

===== Правка MediaWiki:Geshi.css =====

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

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

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

<syntaxhighlight lang="css">div.mw-geshi {
font-size: 15px
}</syntaxhighlight>

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

===== Правка SyntaxHighlight_GeSHi.class.php =====

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

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal;}";</syntaxhighlight>

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal; font-size: 12px;}";</syntaxhighlight>

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

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

Так как мы технари, то нам просто необходима поддержка {{Формула|f=\TeX}}. Любые "псевдоформулы" набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку {{Формула|f=\TeX}} разметки, нужно было бороться до конца.

==== Math ====

Начали мы с расширения [http://www.mediawiki.org/wiki/Extension:Math Math]. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог <code>math</code>).

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

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты <code>texvc</code>. Нужно [[Работа с Linux-сервером | зайти в этот каталог и выполнить команду]] <code>make</code>. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и [[Работа с Linux-сервером | назначьте им права 755]]:
* <code>images/math</code>;
* <code>images/tmp</code>.

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

<syntaxhighlight lang=php>$wgUseTeX = "true";
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";</syntaxhighlight>

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

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

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

<syntaxhighlight lang=php>$wgDefaultUserOptions['math'] = 0;</syntaxhighlight>

==== MathJax ====

После обновления MediaWiki до версии 1.19.2 расширение [http://www.mediawiki.org/wiki/Extension:Math Math] работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение [http://www.mediawiki.org/wiki/Extension:MathJax MathJax].

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

Устанавливается расширение [[#Расширения MediaWiki | стандартно]].

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

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

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

=== Сноски ===

Они же ''примечания''. Для их создания используется расширение [https://www.mediawiki.org/wiki/Extension:Cite Cite]. Пример использования сносок можно посмотреть в [[Песочница#Сноски | Песочнице]].

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

<code><nowiki><cite_references_prefix> <cite_references_link_one> <cite_references_link_one> <cite_references_suffix></nowiki></code>

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

В итоге, всё решилось примерно так же, как и с [[#Перевод некоторых служебных страниц | недопереведёнными служебными страницами]]. Просто поочерёдно открывали одноимённые служебные страницы из пространства имён <code>MediaWiki</code> в Википедии и копировали текст оттуда на свои.

== Обновление MediaWiki ==

Сам процесс [http://www.mediawiki.org/wiki/Manual:Upgrading подробнейше описан] в официальной документации. Там же приводится несколько способов выполнения обновления.

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

Всё, можно идти проверять [[Special:Version | версию MW]].

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

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

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

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

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

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

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

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

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

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

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

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

{| class="wikitable"
|- align="center"
! colspan="2" | Для всей таблицы
|- align="center"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="float:left;"</code>
|- align="center"
| По правому краю || <code>style="float:right;"</code>
|- align="center"
| По центру || <code>style="margin:auto;"</code>
|- align="center"
! colspan="2" | Для текста в ячейке
|- align="center"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="text-align:left;"</code>
|- align="center"
| По правому краю || <code>style="text-align:right;"</code>
|- align="center"
| По центру || <code>style="text-align:center;"</code>
|}

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

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

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

<syntaxhighlight lang="sql"><changeemail></syntaxhighlight>

Значит, надо открыть страницу <code>MediaWiki:Changeemail</code> и внести в неё правку - написать перевод: "<code>Изменить адрес электронной почты</code>".

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

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

Важно учитывать регистр. Если переводимый элемент принадлежит, например, странице <code>BlockList</code>, то правку надо вносить не в <code>MediaWiki:Block<span style="color:red">'''L'''</span>ist</code>, а в <code>MediaWiki:Block<span style="color:green">'''l'''</span>ist</code>.

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

Выполнив всё по [[#Обновление MediaWiki | инструкции]] мы получили <font color="red">'''Fatal exception of type MWException'''</font> при открытии любой страницы сайта.

Решение было найдено на [http://mediawiki.org/wiki/Project:Support_desk доске поддержки MediaWiki]. В итоге, обновление прошло следующим образом:
# загружаем архив с дистрибутивом [http://www.mediawiki.org/wiki/Download отсюда];
# распаковываем его в каталог с вики: <code>tar xvzf mediawiki-1.20.2.tar.gz -C path/to/our/wiki/ --strip-components=1</code>. С таким ключом распаковка пройдёт с заменой файлов, не трогая наши расширения, картинки и файл настроек;
# идём в <code>path/to/our/wiki/maintenance/</code> и выполняем там <code>php5 update.php</code>.
# тут же выполняем: <code>php5 rebuildLocalisationCache.php --force</code>.

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

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

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

IRC

2013-01-21T04:24:29Z

Penny: /* Дополнительно */ справка по командам

IRC - это чат. А точнее - протокол, разработанный для обмена сообщениями. Выглядит всё как обычная чат-комната: люди заходят, пишут друг другу. Такая [[IRC-канал | комната]] есть и у нас.

== Достоинства ==

Так как создавался он ради обмена сообщениями и более ни для чего другого, то:
* он адски быстр. Ничто в интернете не даёт такой скорости при обмене сообщениями. Он просто молниеносен;
* трафика ему надо ничтожно мало. Ничтожно. Потому прекрасно можно им пользоваться и на мобильных устройствах.

Был создан в 1988 году, почти за двадцать лет до появления вКонтацка и прочих. Построен с {{Википедия|RFC|RFC}}, а не как накодит похапо-обезьяна.

Чаты в социальных сетях в ужасе падают ниц перед величием и могуществом IRC.

== Как пользоваться ==

=== Приложение ===

Нужно приложение-клиент. Их очень много, можно выделить пять:
* [http://www.hexchat.org/ HexChat] (Windows, Linux);
* {{Википедия|mIRC|mIRC}} (Windows);
* встроенный в браузер [http://www.opera.com/ Opera] (Windows, Linux, Mac OS);
* [https://play.google.com/store/apps/details?id=org.yaaic&feature=search_result#?t=W251bGwsMSwxLDEsIm9yZy55YWFpYyJd Yaaic] (Android);
* [http://irc.senet.ru/files/ SnIRC] (Java).

=== Настройка подключения ===

Для подключения необходимо знать лишь две вещи:
* сервер;
* порт.

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

== Дополнительно ==

Подробнее об IRC можно почитать {{Луркмоар|IRC|здесь}}, [http://wiki.ircnet.su/IRC тут] и {{Википедия|IRC|там}}.

И справка по командам регистрации:
* [http://docs.dal.net/docs/nickservru.html ник];
* [http://docs.dal.net/docs/chanservru.html канал].

[[Категория:Этого нельзя не знать]]

IRC-канал

2013-01-20T10:28:01Z

Penny: новый сервер

У нас есть свой [[IRC]]-канал:

{|
! align="right" | Сеть:
| [https://webchat.freenode.net/ freenode]
|-
! align="right" | Сервер:
| irc.freenode.net
|-
! align="right" | Порт:
| можно не указывать
|-
! align="right" | Канал:
| #iu5
|-
! align="right" | Кодировка:
| UTF-8
|}

Для слабых духом есть [https://webchat.freenode.net/ веб-гейт].

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

Qt - Сигналы и слоты

2012-12-14T09:11:23Z

Penny: /* Дополнительно */ видео

[[Файл:Qt-logo.png|right|150px]]

Сигналы и слоты - это то, как в Qt взаимодействуют между собой объекты разных классов.

== Как это работает в теории ==

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

Потому, соединив сигнал первого объекта и слот второго, мы получаем следующее: каждый раз, когда первый объект посылает свой сигнал, второй объект принимает его в свой слот и выполняет его функцию.

Таким образом, чтобы соединить два объекта, нужно:
# создать у одного сигнал, а у второго слот;
# соединить сигнал первого и слот второго.

Это можно изобразить вот так:

[[Файл:Qt signls.and.slots pic1.png|800px|link=Файл:Qt signls.and.slots pic1.svg]]

На рисунке:
:а) два изначальных объекта, ничем ни с кем не соединены;
:б) у первого объекта появился сигнал, а у второго - слот. Теперь им есть чем соединяться, но они всё ещё ни с кем не соединены;
:в) сигнал первого объекта соединён со слотом второго.

Каждый объект может иметь больше одного сигнала и больше одного слота. Соединяться могут также более двух объектов:

[[Файл:Qt signls.and.slots pic2.png|500px|link=Файл:Qt signls.and.slots pic2.svg]]

Как видно, кроме очевидных соединений, при отправке Объектом 4 сигнала выполнятся слот Объекта 3 и слот Объекта 1.

=== Примеры ===

Немного поясняющих картинок:
<gallery widths="400px" heights="250">
Файл:Signals.and.slots.start.jpg|Один сигнал соединён с одинаковыми слотами разных объектов (наследников одного класса)
Файл:Signals.and.slots.abe.jpg|Один сигнал соединён с разными слотами разных объектов
</gallery>

Картинка с мудакенами может внести некоторую путаницу, потому её следует сопроводить разъяснением.

Каждый мудакен (из пяти слева) имеет набор слотов, будем считать, что у всех одинаковый (потому что все они унаследованы от одного класса <code>Мудакен</code>). То есть, у каждого из них есть следующие:
* <code>здарова()</code>;
* <code>сам_привет()</code>;
* <code>ну_привет()</code>;
* <code>хай()</code>;
* <code>пошёл_ты()</code>.

Эйб может подать сигнал <code>привет()</code>.

Можно было бы соединить его сигнал с каким-то одним слотом, одинаковым для всех пяти остальных мудакенов, к которым он обращается, но такая ситуация уже показана на картинке со стометровкой. Потому мы соединили сигнал Эйба с различными слотами ответов мудакенов.

Путаница могла возникнуть такая, что можно было подумать, что <code>пошёл_ты()</code> (ну и остальные) - это уже реакция на приветствие Эйба. Но это не так, это лишь ''имя реакции'' (имя слота), а реализация у неё может быть какой угодно.

Например, очевидной:
<syntaxhighlight lang="cpp-qt">
QString MudakenAngry::пошёл_ты()
{
QString answer = "Да пошёл ты. Пива не принёс, ничего не принёс, ещё хочет чего-то. Вообще охренеть.";
return answer;
}
</syntaxhighlight>

или не очень:
<syntaxhighlight lang="cpp-qt">
QString MudakenAngry::пошёл_ты()
{
QString answer = "Ну наконец-то! Где тебя носило? Пошли за пивом уже!";
return answer;
}
</syntaxhighlight>

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

== Как это сделать в Qt ==

=== QObject ===

Необходимое условие - при описании класса должен быть использован макрос <code>Q_OBJECT</code>, а сами классы должны так или иначе происходить от класса <code>QObject</code>:

<syntaxhighlight lang="cpp-qt" line highlight="3">
class MeClass : public QObject
{
Q_OBJECT

public:
MeClass();

...

};
</syntaxhighlight>

=== Сигналы ===

Создать сигнал можно так:

<syntaxhighlight lang="cpp-qt" line highlight="9">
class MeClass : public QObject
{
Q_OBJECT

public:
MeClass();

signals:
void someSignal();

...

};
</syntaxhighlight>

Теперь сигнал можно отправить в любом месте:

<syntaxhighlight lang="cpp-qt">
emit someSignal();
</syntaxhighlight>

=== Слоты ===

Создать слот можно так:

<syntaxhighlight lang="cpp-qt" line highlight="12">
class MeClass : public QObject
{
Q_OBJECT

public:
MeClass();

signals:
void someSignal();

public slots:
void someSlot();

...

};
</syntaxhighlight>

=== Сигналы и слоты с параметрами ===

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

<syntaxhighlight lang="cpp-qt" line highlight="11, 27">
// первый класс, отправитель
class MeClass : public QObject
{
Q_OBJECT

public:
MeClass();

signals:
// сигнал будет передавать переменную типа int
void someSignal(int value2send);

...

};

// второй класс, получатель
class YaClass : public QObject
{
Q_OBJECT

public:
YaClass();

public slots:
// слот будет принимать переменную типа int
void someSlot(int value2get);

...

};
</syntaxhighlight>

=== Соединение ===

Функция соединения сигнала первого объекта и слота второго объекта имеет четыре параметра:
# отправитель сигнала;
# его сигнал;
# получатель сигнала;
# его слот.

Соединение сигнала <code>meClass</code> и слота <code>yaClass</code>:

<syntaxhighlight lang="cpp-qt" line highlight="4">
MeClass meClass();
YaClass yaClass();

connect(meClass, SIGNAL(someSignal(int)), yaClass, SLOT(someSlot(int)));
</syntaxhighlight>

Теперь при каждой отправке сигнала <code>someSignal(int)</code> объекта <code>meClass</code> будет выполняться слот <code>someSlot(int)</code> объекта <code>yaClass</code>.

== Демонстрационный пример ==

Приложение состоит из главного окна Сигналы и слоты, Первого окна и Второго окна.

[[Файл:Qt signls.and.slots pic3.png]]

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

Главное окно также соединяется сигналом своего закрытия (уничтожения) со слотами закрытия Первого и Второго окон.

Проект приложения можно загрузить [http://yadi.sk/d/Csajnu040IX5Z здесь].

=== Главное окно ===

<code>mainwindow.h:</code>
<syntaxhighlight lang="cpp-qt" line>
...

protected:
// событие закрытия главного окна, будет посылать всем сигнал закрытия
/// это стандартная виртуальная функция класса, поэтому мы её лишь переопределяем
virtual void closeEvent(QCloseEvent *event);

...

</syntaxhighlight>

<code>mainwindow.cpp:</code>
<syntaxhighlight lang="cpp-qt" line>
...

// реализация переопределённой функции
void MainWindow::closeEvent(QCloseEvent *event)
{
emit destroyed(); // отправить сигнал о закрытии (уничтожении) окна
}

...

// соединение сигнала от главного окна со слотом первого окна
connect(this, SIGNAL(destroyed()), frst, SLOT(close()));
// соединение сигнала от главного окна со слотом второго окна
connect(this, SIGNAL(destroyed()), scnd, SLOT(close()));
// слоты close() являются стандартными, потому объявлять в классах окон их не нужно

...

// соединение сигнала от первого окна со слотом второго окна
connect(frst, SIGNAL(sendMessage(QString)),
scnd, SLOT(receiveMessage(QString)));

// соединение сигнала от второго окна со слотом первого окна
connect(scnd, SIGNAL(sendMessage(QString)),
frst, SLOT(receiveMessage(QString)));
</syntaxhighlight>

=== Первое окно ===

<code>frst.h:</code>
<syntaxhighlight lang="cpp-qt" line>
...

signals:
/// @brief сигнал отправки сообщения второму окну
/// @param msg2send - отправляемая в сигнале строка
void sendMessage(QString msg2send);

public slots:
/// @brief слот, в которой будет приходить сигнал от второго окна
/// @param msg2recieve - получаемая из сигнала второго окна строка
void receiveMessage(QString msg2recieve);

...

</syntaxhighlight>

<code>frst.cpp:</code>
<syntaxhighlight lang="cpp-qt" line>
...

// обработчик нажатия кнопки отправки
void Frst::on_btn_sendToSecond_clicked()
{
// посылает сигнал, содержащий строку из поля ввода
emit sendMessage(ui->lineEdit_first->text());
}

// слот получения сигнала
void Frst::receiveMessage(QString msg2recieve)
{
// принимает строку из сигнала и вставляет её в надпись
ui->label_received_first->setText(msg2recieve);
}

...
</syntaxhighlight>

=== Второе окно ===

<code>scnd.h:</code>
<syntaxhighlight lang="cpp-qt" line>
...

signals:
/// @brief сигнал отправки сообщения первому окну
/// @param msg2send - отправляемая в сигнале строка
void sendMessage(QString msg2send);

public slots:
/// @brief слот, в которой будет приходить сигнал от первого окна
/// @param msg2recieve - получаемая из сигнала первого окна строка
void receiveMessage(QString msg2recieve);

...

</syntaxhighlight>

<code>scnd.cpp:</code>
<syntaxhighlight lang="cpp-qt" line>
...

// обработчик нажатия кнопки отправки
void Scnd::on_btn_sendToFirst_clicked()
{
// посылает сигнал, содержащий строку из поля ввода
emit sendMessage(ui->lineEdit_second->text());
}

// слот получения сигнала
void Scnd::receiveMessage(QString msg2recieve)
{
// принимает строку из сигнала и вставляет её в надпись
ui->label_received_second->setText(msg2recieve);
}

...
</syntaxhighlight>

== Дополнительно ==

Более подробно про механизм сигналов и слотов можно прочитать [[Qt#Книги | в книгах по Qt]] и в следующих статьях:
* [http://doc.crossplatform.ru/qt/4.3.2/signalsandslots.html CrossPlatform.RU - Сигналы и слоты];
* [http://www.developer.nokia.com/Community/Wiki/%D0%9C%D0%B5%D1%85%D0%B0%D0%BD%D0%B8%D0%B7%D0%BC_%D1%81%D0%B8%D0%B3%D0%BD%D0%B0%D0%BB%D0%BE%D0%B2_%D0%B8_%D1%81%D0%BB%D0%BE%D1%82%D0%BE%D0%B2_%D0%B2_Qt NOKIA Developer - Механизм сигналов и слотов в Qt].

Видео:
* [http://www.youtube.com/watch?v=JtyCM4BTbYo C++ Qt 04 - Signals and Slots] (на английском языке).

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

Обсуждение:Песочница

2012-12-12T14:21:57Z

Penny:

== [сделано] Установка подсветки синтаксиса ==

Призывается кто-нибудь, кто расскажет, как поставить [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight], а то мы отчаялись.<br>
Английский мы знаем, все шаги из руководства выполнили.<br>
Проблема в том, что попытка записи изменений страницы (содержащей тег <nowiki><syntaxhighlight></syntaxhighlight></nowiki>) или просто предпросмотра изменений такой страницы выдаёт лишь пустую, чистую, белую страницу. [[Участник:Penny|Penny]] 14:33, 9 сентября 2012 (MSK)

:Надо было обновить MediaWiki с 1.17 до последней (1.19.2). [[Участник:ILobster|iLobster]] 03:30, 20 сентября 2012 (MSK)

== SVG ==

Интересует, почему не рендерится SVG. [[Участник:ILobster|iLobster]] 10:03, 12 сентября 2012 (MSK)

== [сделано] Сноски ==

Что происходит со сносками? Расширение [http://www.mediawiki.org/wiki/Extension:Cite Cite]. [[Участник:ILobster|iLobster]] 18:48, 20 сентября 2012 (MSK)
:опять были недопереведённые страницы, точнее вообще пустые, без текста и тегов, без ничего. [[Участник:Penny|Penny]] 22:20, 1 ноября 2012 (MSK)

Twitter-лента

2012-11-28T04:05:50Z

Penny: RSS для Твиттер-ленты

У нас есть свой [https://twitter.com/iu5bmstu Твиттер]. Несмотря на то, что некоторые яростно противились его появлению.

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

Итак, вот они:
{| class="wikitable"
! Курс !! Хэш-тег
|-
|- align="center"
| 1 курс || [https://twitter.com/search/?q=%23iu5_1k&src=hash ссылка]
|- align="center"
| 2 курс || [https://twitter.com/search/?q=%23iu5_2k&src=hash ссылка]
|- align="center"
| 3 курс || [https://twitter.com/search/?q=%23iu5_3k&src=hash ссылка]
|- align="center"
| 4 курс || [https://twitter.com/search/?q=%23iu5_4k&src=hash ссылка]
|- align="center"
| 5 курс || [https://twitter.com/search/?q=%23iu5_5k&src=hash ссылка]
|- align="center"
| 6 курс || [https://twitter.com/search/?q=%23iu5_6k&src=hash ссылка]
|}

Соответственно, если у вас есть какая-либо новость, то напишите твит с нужным хэш-тегом. Просто прелесть, до чего всё оказалось просто. Однако имейте в виду, что поиск по хэш-тегу не всегда показывает все твиты - таковы особенности самого Твиттера: их "сверхбыстрой БД", механизма индексации и системы антиспама.

Читать ленту можно и [https://api.twitter.com/1/statuses/user_timeline.rss?screen_name=iu5bmstu через RSS].

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

История портала

2012-11-26T13:55:32Z

Penny: /* Хостинг на BeGet */ партнёрская ссылка на хостера

Решили собрать тут всю нашу небольшую историю. По мере развития будет дописывать.

== Как всё началось ==

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

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

== Хронология событий ==

=== Хостинг на Народе ===

[[Файл:Narod.gif|left]] <u>27 января 2012 года</u> была создана [http://iu5-2014.narod.ru/ первая страница сайта] на хостинге [http://narod.yandex.ru/ Народа]. Это было наше первое появление в интернетах, будем считать его '''Днём рождения портала'''. Там мы просуществовали некоторое время - примерно полгода. Причём, мы создавались как сайт одного лишь потока ИУ5, выпуска 2014 года.

Никакой CMS - голый HTML и загрузка по FTP. Но то уже было гораздо лучше вКонтацка. Страница и сейчас доступна по этому адресу, но обновляться больше не будет. Удалять тоже не будем - послужит резервной копией старых материалов.

Тут к проекту присоединился ещё один человек.

=== Хостинг на BeGet ===

[[Файл:Beget.jpg|left]] Хостинг на Народе был хорош всем: от бесплатности до отсутствия ограничений на занимаемый сайтом объём дискового пространства на сервере. Но статичный HTML стеснял полёт фантазии, а ужасающая скорость загрузки файлов на сервер зверски тормозила творческий процесс.

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

Кроме того, домен третьего уровня - это несолидно для студентов ИУ5. Так что было решено создать свой и съехать на другой хостинг.

В результате, <u>28 июня 2012 года</u> было зарегистрировано доменное имя: "'''iu5bmstu.ru'''" и выбран новый хостер: [http://www.beget.ru?id=32200 BeGet]. Где мы сейчас и находимся. Одновременно с этим пришло осознание, что незачем ограничиваться одним потоком 2014, так что теперь это портал для всей кафедры ИУ5, нынешнего и будущих поколений студентов.

Теперь к проекту может присоединиться сколько угодно человек.

=== Канал на YouTude ===

<u>9 июля 2012 года</u> был зарегистрирован [http://www.youtube.com/user/iu5bmstu канал на YouTube].

=== IRC-канал ===

<u>23 сентября 2012 года</u> был создан [[IRC-канал]].

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

Шаблон:Tabli4ka warning undone summary

2012-11-26T13:39:35Z

Penny:

{| style="margin:auto; width:70%;" border="1" cellpadding="5" cellspacing="0"
|-
| style="width:1px; background:#4682B4;" | || style="background:#F0FFFF;" | '''Этот конспект ещё не дописан.'''<br>Здесь не хватает:<br>{{{text}}}
|}<noinclude>[[Категория:Шаблоны]]</noinclude>

Шаблон:Tabli4ka warning undone summary

2012-11-26T13:28:51Z

Penny: Новая страница: «{| style="margin:auto; width:70%;" border="1" cellpadding="5" cellspacing="0" |- | style="width:1px; background:#0000FF;" | || style="background:#87CEEB;" | '''{{...»

{| style="margin:auto; width:70%;" border="1" cellpadding="5" cellspacing="0"
|-
| style="width:1px; background:#0000FF;" | || style="background:#87CEEB;" | '''{{{header}}}'''<br>{{{text}}}
|}<noinclude>[[Категория:Шаблоны]]</noinclude>

MediaWiki - Настройка и расширения

2012-11-26T13:17:54Z

Penny: /* Выравнивание таблицы на странице */ заголовок

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования [http://www.mediawiki.org/ MediaWiki]. Такая своеобразная записная книжка.

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

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

=== BPoD ===

Blank Page of Death (BPoD) - белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:
* неверные настройки в файле <code>LocalSettings.php</code>;
* некорректно работающее свежеустановленное расширение.

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

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

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

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

== Настройка MediaWiki ==

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

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

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

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

<syntaxhighlight lang="php">$wgSitename = "Ваше название вики";</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php">$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";</syntaxhighlight>

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

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

Загружать иконку рекомундуется туда же, куда и [[#Установка логотипа | логотип]]. Размеры её должны быть 16x16, а формат - {{Википедия|ICO_(формат_файлов)|ICO}}. Так же можно [[Прозрачный фон изображения | сделать ей прозрачный фон]]. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

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

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

<syntaxhighlight lang="php">$wgFavicon = "$wgStylePath/common/images/favicon.ico";</syntaxhighlight>

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

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

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

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

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

<syntaxhighlight lang="php">$wgEnableUploads = true;</syntaxhighlight>

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

<syntaxhighlight lang="php">$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php" highlight="10">
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;
}
</syntaxhighlight>

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

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

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

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

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

Мы используем счётчик от [http://metrika.yandex.ru/add/ Яндекса]. Код его сохранён в файле <code>skins/counter_yandex.php</code>.

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

<syntaxhighlight line enclose="div" highlight="13" lang=php>

<div id="footer"<?php $this->html( 'userlangattributes' ) ?>>
<?php foreach( $this->getFooterLinks() as $category => $links ): ?>
<ul id="footer-<?php echo $category ?>">
<?php foreach( $links as $link ): ?>
<li id="footer-<?php echo $category ?>-<?php echo $link ?>"><?php $this->html( $link ) ?></li>
<?php endforeach; ?>
</ul>
<?php endforeach; ?>
<?php $footericons = $this->getFooterIcons("icononly");
if ( count( $footericons ) > 0 ): ?>
<ul id="footer-icons" class="noprint">
<li><?php include("counter_yandex.php"); ?></li> 
<?php foreach ( $footericons as $blockName => $footerIcons ): ?>
<li id="footer-<?php echo htmlspecialchars( $blockName ); ?>ico">
<?php foreach ( $footerIcons as $icon ): ?>
<?php echo $this->getSkin()->makeFooterIcon( $icon ); ?>

<?php endforeach; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
<div style="clear:both"></div>
</div>

</syntaxhighlight>

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

== Расширения MediaWiki ==

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

Устанавливаются все одинаково:
# загрузить архив с расширением:
# распаковать его в каталог <code>extensions</code> корневого каталога;
# в файле <code>LocalSettings.php</code> из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и [[Работа с Linux-сервером | через SSH]].

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

==== SyntaxHighlight GeSHi ====

У нас используется [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi]. Установка [[#Расширения MediaWiki | ничем не примечательна]], однако на версии MediaWiki 1.17 расширение работать отказывалось - браузер выдавал лишь [[#BPoD | белую страницу смерти]]. Из-за этого до обновления приходилось использовать [http://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter] - более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

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

===== Правка MediaWiki:Geshi.css =====

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

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

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

<syntaxhighlight lang="css">div.mw-geshi {
font-size: 15px
}</syntaxhighlight>

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

===== Правка SyntaxHighlight_GeSHi.class.php =====

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

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal;}";</syntaxhighlight>

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal; font-size: 12px;}";</syntaxhighlight>

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

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

Так как мы технари, то нам просто необходима поддержка {{Формула|f=\TeX}}. Любые "псевдоформулы" набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку {{Формула|f=\TeX}} разметки, нужно было бороться до конца.

==== Math ====

Начали мы с расширения [http://www.mediawiki.org/wiki/Extension:Math Math]. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог <code>math</code>).

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

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты <code>texvc</code>. Нужно [[Работа с Linux-сервером | зайти в этот каталог и выполнить команду]] <code>make</code>. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и [[Работа с Linux-сервером | назначьте им права 755]]:
* <code>images/math</code>;
* <code>images/tmp</code>.

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

<syntaxhighlight lang=php>$wgUseTeX = "true";
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";</syntaxhighlight>

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

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

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

<syntaxhighlight lang=php>$wgDefaultUserOptions['math'] = 0;</syntaxhighlight>

==== MathJax ====

После обновления MediaWiki до версии 1.19.2 расширение [http://www.mediawiki.org/wiki/Extension:Math Math] работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение [http://www.mediawiki.org/wiki/Extension:MathJax MathJax].

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

Устанавливается расширение [[#Расширения MediaWiki | стандартно]].

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

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

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

=== Сноски ===

Они же ''примечания''. Для их создания используется расширение [https://www.mediawiki.org/wiki/Extension:Cite Cite]. Пример использования сносок можно посмотреть в [[Песочница#Сноски | Песочнице]].

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

<code><nowiki><cite_references_prefix> <cite_references_link_one> <cite_references_link_one> <cite_references_suffix></nowiki></code>

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

В итоге, всё решилось примерно так же, как и с [[#Перевод некоторых служебных страниц | недопереведёнными служебными страницами]]. Просто поочерёдно открывали одноимённые служебные страницы из пространства имён <code>MediaWiki</code> в Википедии и копировали текст оттуда на свои.

== Обновление MediaWiki ==

Сам процесс уже [http://www.mediawiki.org/wiki/Manual:Upgrading подробнейше описан], добавить нечего. Приведём лишь сюрпризы, ожидавшие нас при обновлении с 1.17 до 1.19.2. Конечно, скорее всего, их бы не было, если бы мы тщательней изучили документацию перед обновлением.

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

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

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

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

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

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

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

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

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

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

{| class="wikitable"
|- align="center"
! colspan="2" | Для всей таблицы
|- align="center"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="float:left;"</code>
|- align="center"
| По правому краю || <code>style="float:right;"</code>
|- align="center"
| По центру || <code>style="margin:auto;"</code>
|- align="center"
! colspan="2" | Для текста в ячейке
|- align="center"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="text-align:left;"</code>
|- align="center"
| По правому краю || <code>style="text-align:right;"</code>
|- align="center"
| По центру || <code>style="text-align:center;"</code>
|}

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

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

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

<syntaxhighlight lang="sql"><changeemail></syntaxhighlight>

Значит, надо открыть страницу <code>MediaWiki:Changeemail</code> и внести в неё правку - написать перевод: "<code>Изменить адрес электронной почты</code>".

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

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

Важно учитывать регистр. Если переводимый элемент принадлежит, например, странице <code>BlockList</code>, то правку надо вносить не в <code>MediaWiki:Block<span style="color:red">'''L'''</span>ist</code>, а в <code>MediaWiki:Block<span style="color:green">'''l'''</span>ist</code>.

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

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

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

MediaWiki - Настройка и расширения

2012-11-26T13:17:10Z

Penny: /* Выравнивание таблицы на странице */ выравнивание для ячеек

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования [http://www.mediawiki.org/ MediaWiki]. Такая своеобразная записная книжка.

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

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

=== BPoD ===

Blank Page of Death (BPoD) - белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:
* неверные настройки в файле <code>LocalSettings.php</code>;
* некорректно работающее свежеустановленное расширение.

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

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

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

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

== Настройка MediaWiki ==

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

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

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

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

<syntaxhighlight lang="php">$wgSitename = "Ваше название вики";</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php">$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";</syntaxhighlight>

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

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

Загружать иконку рекомундуется туда же, куда и [[#Установка логотипа | логотип]]. Размеры её должны быть 16x16, а формат - {{Википедия|ICO_(формат_файлов)|ICO}}. Так же можно [[Прозрачный фон изображения | сделать ей прозрачный фон]]. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

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

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

<syntaxhighlight lang="php">$wgFavicon = "$wgStylePath/common/images/favicon.ico";</syntaxhighlight>

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

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

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

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

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

<syntaxhighlight lang="php">$wgEnableUploads = true;</syntaxhighlight>

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

<syntaxhighlight lang="php">$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php" highlight="10">
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;
}
</syntaxhighlight>

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

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

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

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

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

Мы используем счётчик от [http://metrika.yandex.ru/add/ Яндекса]. Код его сохранён в файле <code>skins/counter_yandex.php</code>.

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

<syntaxhighlight line enclose="div" highlight="13" lang=php>

<div id="footer"<?php $this->html( 'userlangattributes' ) ?>>
<?php foreach( $this->getFooterLinks() as $category => $links ): ?>
<ul id="footer-<?php echo $category ?>">
<?php foreach( $links as $link ): ?>
<li id="footer-<?php echo $category ?>-<?php echo $link ?>"><?php $this->html( $link ) ?></li>
<?php endforeach; ?>
</ul>
<?php endforeach; ?>
<?php $footericons = $this->getFooterIcons("icononly");
if ( count( $footericons ) > 0 ): ?>
<ul id="footer-icons" class="noprint">
<li><?php include("counter_yandex.php"); ?></li> 
<?php foreach ( $footericons as $blockName => $footerIcons ): ?>
<li id="footer-<?php echo htmlspecialchars( $blockName ); ?>ico">
<?php foreach ( $footerIcons as $icon ): ?>
<?php echo $this->getSkin()->makeFooterIcon( $icon ); ?>

<?php endforeach; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
<div style="clear:both"></div>
</div>

</syntaxhighlight>

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

== Расширения MediaWiki ==

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

Устанавливаются все одинаково:
# загрузить архив с расширением:
# распаковать его в каталог <code>extensions</code> корневого каталога;
# в файле <code>LocalSettings.php</code> из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и [[Работа с Linux-сервером | через SSH]].

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

==== SyntaxHighlight GeSHi ====

У нас используется [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi]. Установка [[#Расширения MediaWiki | ничем не примечательна]], однако на версии MediaWiki 1.17 расширение работать отказывалось - браузер выдавал лишь [[#BPoD | белую страницу смерти]]. Из-за этого до обновления приходилось использовать [http://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter] - более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

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

===== Правка MediaWiki:Geshi.css =====

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

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

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

<syntaxhighlight lang="css">div.mw-geshi {
font-size: 15px
}</syntaxhighlight>

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

===== Правка SyntaxHighlight_GeSHi.class.php =====

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

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal;}";</syntaxhighlight>

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal; font-size: 12px;}";</syntaxhighlight>

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

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

Так как мы технари, то нам просто необходима поддержка {{Формула|f=\TeX}}. Любые "псевдоформулы" набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку {{Формула|f=\TeX}} разметки, нужно было бороться до конца.

==== Math ====

Начали мы с расширения [http://www.mediawiki.org/wiki/Extension:Math Math]. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог <code>math</code>).

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

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты <code>texvc</code>. Нужно [[Работа с Linux-сервером | зайти в этот каталог и выполнить команду]] <code>make</code>. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и [[Работа с Linux-сервером | назначьте им права 755]]:
* <code>images/math</code>;
* <code>images/tmp</code>.

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

<syntaxhighlight lang=php>$wgUseTeX = "true";
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";</syntaxhighlight>

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

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

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

<syntaxhighlight lang=php>$wgDefaultUserOptions['math'] = 0;</syntaxhighlight>

==== MathJax ====

После обновления MediaWiki до версии 1.19.2 расширение [http://www.mediawiki.org/wiki/Extension:Math Math] работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение [http://www.mediawiki.org/wiki/Extension:MathJax MathJax].

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

Устанавливается расширение [[#Расширения MediaWiki | стандартно]].

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

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

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

=== Сноски ===

Они же ''примечания''. Для их создания используется расширение [https://www.mediawiki.org/wiki/Extension:Cite Cite]. Пример использования сносок можно посмотреть в [[Песочница#Сноски | Песочнице]].

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

<code><nowiki><cite_references_prefix> <cite_references_link_one> <cite_references_link_one> <cite_references_suffix></nowiki></code>

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

В итоге, всё решилось примерно так же, как и с [[#Перевод некоторых служебных страниц | недопереведёнными служебными страницами]]. Просто поочерёдно открывали одноимённые служебные страницы из пространства имён <code>MediaWiki</code> в Википедии и копировали текст оттуда на свои.

== Обновление MediaWiki ==

Сам процесс уже [http://www.mediawiki.org/wiki/Manual:Upgrading подробнейше описан], добавить нечего. Приведём лишь сюрпризы, ожидавшие нас при обновлении с 1.17 до 1.19.2. Конечно, скорее всего, их бы не было, если бы мы тщательней изучили документацию перед обновлением.

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

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

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

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

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

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

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

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

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

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

{| class="wikitable"
|- align="center"
! colspan="2" | Для всей таблицы
|- align="center"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="float:left;"</code>
|- align="center"
| По правому краю || <code>style="float:right;"</code>
|- align="center"
| По центру || <code>style="margin:auto;"</code>
|- align="center"
! colspan="2" | Для текста в ячейке
|- align="center"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="text-align:left;"</code>
|- align="center"
| По правому краю || <code>style="text-align:right;"</code>
|- align="center"
| По центру || <code>style="text-align:center;"</code>
|}

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

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

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

<syntaxhighlight lang="sql"><changeemail></syntaxhighlight>

Значит, надо открыть страницу <code>MediaWiki:Changeemail</code> и внести в неё правку - написать перевод: "<code>Изменить адрес электронной почты</code>".

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

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

Важно учитывать регистр. Если переводимый элемент принадлежит, например, странице <code>BlockList</code>, то правку надо вносить не в <code>MediaWiki:Block<span style="color:red">'''L'''</span>ist</code>, а в <code>MediaWiki:Block<span style="color:green">'''l'''</span>ist</code>.

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

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

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

Обсуждение:Песочница

2012-11-01T18:21:42Z

Penny: /* Сноски */

== [сделано] Установка подсветки синтаксиса ==

Призывается кто-нибудь, кто расскажет, как поставить [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight], а то мы отчаялись.<br>
Английский мы знаем, все шаги из руководства выполнили.<br>
Проблема в том, что попытка записи изменений страницы (содержащей тег <nowiki><syntaxhighlight></syntaxhighlight></nowiki>) или просто предпросмотра изменений такой страницы выдаёт лишь пустую, чистую, белую страницу. [[Участник:Penny|Penny]] 14:33, 9 сентября 2012 (MSK)

:Надо было обновить MediaWiki с 1.17 до последней (1.19.2). [[Участник:ILobster|iLobster]] 03:30, 20 сентября 2012 (MSK)

== SVG ==

Интересует, почему не рендерится SVG. [[Участник:ILobster|iLobster]] 10:03, 12 сентября 2012 (MSK)

== Сноски ==

Что происходит со сносками? Расширение [http://www.mediawiki.org/wiki/Extension:Cite Cite]. [[Участник:ILobster|iLobster]] 18:48, 20 сентября 2012 (MSK)
:опять были недопереведённые страницы, точнее вообще пустые, без текста и тегов, без ничего. [[Участник:Penny|Penny]] 22:20, 1 ноября 2012 (MSK)

Обсуждение:Песочница

2012-11-01T18:20:59Z

Penny: /* Сноски */

== [сделано] Установка подсветки синтаксиса ==

Призывается кто-нибудь, кто расскажет, как поставить [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight], а то мы отчаялись.<br>
Английский мы знаем, все шаги из руководства выполнили.<br>
Проблема в том, что попытка записи изменений страницы (содержащей тег <nowiki><syntaxhighlight></syntaxhighlight></nowiki>) или просто предпросмотра изменений такой страницы выдаёт лишь пустую, чистую, белую страницу. [[Участник:Penny|Penny]] 14:33, 9 сентября 2012 (MSK)

:Надо было обновить MediaWiki с 1.17 до последней (1.19.2). [[Участник:ILobster|iLobster]] 03:30, 20 сентября 2012 (MSK)

== SVG ==

Интересует, почему не рендерится SVG. [[Участник:ILobster|iLobster]] 10:03, 12 сентября 2012 (MSK)

== Сноски ==

Что происходит со сносками? Расширение [http://www.mediawiki.org/wiki/Extension:Cite Cite]. [[Участник:ILobster|iLobster]] 18:48, 20 сентября 2012 (MSK)
:опять были недопереведённые страницы. [[Участник:Penny|Penny]] 22:20, 1 ноября 2012 (MSK)

MediaWiki - Настройка и расширения

2012-11-01T18:08:14Z

Penny:

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования [http://www.mediawiki.org/ MediaWiki]. Такая своеобразная записная книжка.

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

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

=== BPoD ===

Blank Page of Death (BPoD) - белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:
* неверные настройки в файле <code>LocalSettings.php</code>;
* некорректно работающее свежеустановленное расширение.

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

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

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

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

== Настройка MediaWiki ==

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

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

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

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

<syntaxhighlight lang="php">$wgSitename = "Ваше название вики";</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php">$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";</syntaxhighlight>

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

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

Загружать иконку рекомундуется туда же, куда и [[#Установка логотипа | логотип]]. Размеры её должны быть 16x16, а формат - {{Википедия|ICO_(формат_файлов)|ICO}}. Так же можно [[Прозрачный фон изображения | сделать ей прозрачный фон]]. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

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

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

<syntaxhighlight lang="php">$wgFavicon = "$wgStylePath/common/images/favicon.ico";</syntaxhighlight>

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

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

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

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

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

<syntaxhighlight lang="php">$wgEnableUploads = true;</syntaxhighlight>

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

<syntaxhighlight lang="php">$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php" highlight="10">
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;
}
</syntaxhighlight>

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

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

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

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

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

Мы используем счётчик от [http://metrika.yandex.ru/add/ Яндекса]. Код его сохранён в файле <code>skins/counter_yandex.php</code>.

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

<syntaxhighlight line enclose="div" highlight="13" lang=php>

<div id="footer"<?php $this->html( 'userlangattributes' ) ?>>
<?php foreach( $this->getFooterLinks() as $category => $links ): ?>
<ul id="footer-<?php echo $category ?>">
<?php foreach( $links as $link ): ?>
<li id="footer-<?php echo $category ?>-<?php echo $link ?>"><?php $this->html( $link ) ?></li>
<?php endforeach; ?>
</ul>
<?php endforeach; ?>
<?php $footericons = $this->getFooterIcons("icononly");
if ( count( $footericons ) > 0 ): ?>
<ul id="footer-icons" class="noprint">
<li><?php include("counter_yandex.php"); ?></li> 
<?php foreach ( $footericons as $blockName => $footerIcons ): ?>
<li id="footer-<?php echo htmlspecialchars( $blockName ); ?>ico">
<?php foreach ( $footerIcons as $icon ): ?>
<?php echo $this->getSkin()->makeFooterIcon( $icon ); ?>

<?php endforeach; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
<div style="clear:both"></div>
</div>

</syntaxhighlight>

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

== Расширения MediaWiki ==

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

Устанавливаются все одинаково:
# загрузить архив с расширением:
# распаковать его в каталог <code>extensions</code> корневого каталога;
# в файле <code>LocalSettings.php</code> из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и [[Работа с Linux-сервером | через SSH]].

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

==== SyntaxHighlight GeSHi ====

У нас используется [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi]. Установка [[#Расширения MediaWiki | ничем не примечательна]], однако на версии MediaWiki 1.17 расширение работать отказывалось - браузер выдавал лишь [[#BPoD | белую страницу смерти]]. Из-за этого до обновления приходилось использовать [http://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter] - более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

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

===== Правка MediaWiki:Geshi.css =====

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

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

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

<syntaxhighlight lang="css">div.mw-geshi {
font-size: 15px
}</syntaxhighlight>

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

===== Правка SyntaxHighlight_GeSHi.class.php =====

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

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal;}";</syntaxhighlight>

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal; font-size: 12px;}";</syntaxhighlight>

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

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

Так как мы технари, то нам просто необходима поддержка {{Формула|f=\TeX}}. Любые "псевдоформулы" набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку {{Формула|f=\TeX}} разметки, нужно было бороться до конца.

==== Math ====

Начали мы с расширения [http://www.mediawiki.org/wiki/Extension:Math Math]. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог <code>math</code>).

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

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты <code>texvc</code>. Нужно [[Работа с Linux-сервером | зайти в этот каталог и выполнить команду]] <code>make</code>. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и [[Работа с Linux-сервером | назначьте им права 755]]:
* <code>images/math</code>;
* <code>images/tmp</code>.

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

<syntaxhighlight lang=php>$wgUseTeX = "true";
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";</syntaxhighlight>

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

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

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

<syntaxhighlight lang=php>$wgDefaultUserOptions['math'] = 0;</syntaxhighlight>

==== MathJax ====

После обновления MediaWiki до версии 1.19.2 расширение [http://www.mediawiki.org/wiki/Extension:Math Math] работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение [http://www.mediawiki.org/wiki/Extension:MathJax MathJax].

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

Устанавливается расширение [[#Расширения MediaWiki | стандартно]].

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

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

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

=== Сноски ===

Они же ''примечания''. Для их создания используется расширение [https://www.mediawiki.org/wiki/Extension:Cite Cite]. Пример использования сносок можно посмотреть в [[Песочница#Сноски | Песочнице]].

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

<code><nowiki><cite_references_prefix> <cite_references_link_one> <cite_references_link_one> <cite_references_suffix></nowiki></code>

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

В итоге, всё решилось примерно так же, как и с [[#Перевод некоторых служебных страниц | недопереведёнными служебными страницами]]. Просто поочерёдно открывали одноимённые служебные страницы из пространства имён <code>MediaWiki</code> в Википедии и копировали текст оттуда на свои.

== Обновление MediaWiki ==

Сам процесс уже [http://www.mediawiki.org/wiki/Manual:Upgrading подробнейше описан], добавить нечего. Приведём лишь сюрпризы, ожидавшие нас при обновлении с 1.17 до 1.19.2. Конечно, скорее всего, их бы не было, если бы мы тщательней изучили документацию перед обновлением.

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

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

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

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

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

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

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

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

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

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

{| class="wikitable"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="float:left;"</code>
|- align="center"
| По правому краю || <code>style="float:right;"</code>
|- align="center"
| По центру || <code>style="margin:auto;"</code>
|}

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

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

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

<syntaxhighlight lang="sql"><changeemail></syntaxhighlight>

Значит, надо открыть страницу <code>MediaWiki:Changeemail</code> и внести в неё правку - написать перевод: "<code>Изменить адрес электронной почты</code>".

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

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

Важно учитывать регистр. Если переводимый элемент принадлежит, например, странице <code>BlockList</code>, то правку надо вносить не в <code>MediaWiki:Block<span style="color:red">'''L'''</span>ist</code>, а в <code>MediaWiki:Block<span style="color:green">'''l'''</span>ist</code>.

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

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

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

MediaWiki - Настройка и расширения

2012-10-28T06:04:09Z

Penny: /* Перевод некоторых служебных страниц */ про учёт регистра в именах страниц

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования [http://www.mediawiki.org/ MediaWiki]. Такая своеобразная записная книжка.

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

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

=== BPoD ===

Blank Page of Death (BPoD) - белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:
* неверные настройки в файле <code>LocalSettings.php</code>;
* некорректно работающее свежеустановленное расширение.

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

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

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

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

== Настройка MediaWiki ==

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

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

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

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

<syntaxhighlight lang="php">$wgSitename = "Ваше название вики";</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php">$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";</syntaxhighlight>

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

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

Загружать иконку рекомундуется туда же, куда и [[#Установка логотипа | логотип]]. Размеры её должны быть 16x16, а формат - {{Википедия|ICO_(формат_файлов)|ICO}}. Так же можно [[Прозрачный фон изображения | сделать ей прозрачный фон]]. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

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

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

<syntaxhighlight lang="php">$wgFavicon = "$wgStylePath/common/images/favicon.ico";</syntaxhighlight>

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

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

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

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

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

<syntaxhighlight lang="php">$wgEnableUploads = true;</syntaxhighlight>

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

<syntaxhighlight lang="php">$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php" highlight="10">
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;
}
</syntaxhighlight>

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

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

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

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

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

Мы используем счётчик от [http://metrika.yandex.ru/add/ Яндекса]. Код его сохранён в файле <code>skins/counter_yandex.php</code>.

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

<syntaxhighlight line enclose="div" highlight="13" lang=php>

<div id="footer"<?php $this->html( 'userlangattributes' ) ?>>
<?php foreach( $this->getFooterLinks() as $category => $links ): ?>
<ul id="footer-<?php echo $category ?>">
<?php foreach( $links as $link ): ?>
<li id="footer-<?php echo $category ?>-<?php echo $link ?>"><?php $this->html( $link ) ?></li>
<?php endforeach; ?>
</ul>
<?php endforeach; ?>
<?php $footericons = $this->getFooterIcons("icononly");
if ( count( $footericons ) > 0 ): ?>
<ul id="footer-icons" class="noprint">
<li><?php include("counter_yandex.php"); ?></li> 
<?php foreach ( $footericons as $blockName => $footerIcons ): ?>
<li id="footer-<?php echo htmlspecialchars( $blockName ); ?>ico">
<?php foreach ( $footerIcons as $icon ): ?>
<?php echo $this->getSkin()->makeFooterIcon( $icon ); ?>

<?php endforeach; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
<div style="clear:both"></div>
</div>

</syntaxhighlight>

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

== Расширения MediaWiki ==

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

Устанавливаются все одинаково:
# загрузить архив с расширением:
# распаковать его в каталог <code>extensions</code> корневого каталога;
# в файле <code>LocalSettings.php</code> из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и [[Работа с Linux-сервером | через SSH]].

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

==== SyntaxHighlight GeSHi ====

У нас используется [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi]. Установка [[#Расширения MediaWiki | ничем не примечательна]], однако на версии MediaWiki 1.17 расширение работать отказывалось - браузер выдавал лишь [[#BPoD | белую страницу смерти]]. Из-за этого до обновления приходилось использовать [http://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter] - более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

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

===== Правка MediaWiki:Geshi.css =====

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

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

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

<syntaxhighlight lang="css">div.mw-geshi {
font-size: 15px
}</syntaxhighlight>

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

===== Правка SyntaxHighlight_GeSHi.class.php =====

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

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal;}";</syntaxhighlight>

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal; font-size: 12px;}";</syntaxhighlight>

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

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

Так как мы технари, то нам просто необходима поддержка {{Формула|f=\TeX}}. Любые "псевдоформулы" набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку {{Формула|f=\TeX}} разметки, нужно было бороться до конца.

==== Math ====

Начали мы с расширения [http://www.mediawiki.org/wiki/Extension:Math Math]. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог <code>math</code>).

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

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты <code>texvc</code>. Нужно [[Работа с Linux-сервером | зайти в этот каталог и выполнить команду]] <code>make</code>. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и [[Работа с Linux-сервером | назначьте им права 755]]:
* <code>images/math</code>;
* <code>images/tmp</code>.

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

<syntaxhighlight lang=php>$wgUseTeX = "true";
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";</syntaxhighlight>

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

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

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

<syntaxhighlight lang=php>$wgDefaultUserOptions['math'] = 0;</syntaxhighlight>

==== MathJax ====

После обновления MediaWiki до версии 1.19.2 расширение [http://www.mediawiki.org/wiki/Extension:Math Math] работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение [http://www.mediawiki.org/wiki/Extension:MathJax MathJax].

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

Устанавливается расширение [[#Расширения MediaWiki | стандартно]].

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

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

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

== Обновление MediaWiki ==

Сам процесс уже [http://www.mediawiki.org/wiki/Manual:Upgrading подробнейше описан], добавить нечего. Приведём лишь сюрпризы, ожидавшие нас при обновлении с 1.17 до 1.19.2. Конечно, скорее всего, их бы не было, если бы мы тщательней изучили документацию перед обновлением.

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

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

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

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

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

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

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

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

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

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

{| class="wikitable"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="float:left;"</code>
|- align="center"
| По правому краю || <code>style="float:right;"</code>
|- align="center"
| По центру || <code>style="margin:auto;"</code>
|}

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

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

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

<syntaxhighlight lang="sql"><changeemail></syntaxhighlight>

Значит, надо открыть страницу <code>MediaWiki:Changeemail</code> и внести в неё правку - написать перевод: "<code>Изменить адрес электронной почты</code>".

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

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

Важно учитывать регистр. Если переводимый элемент принадлежит, например, странице <code>BlockList</code>, то правку надо вносить не в <code>MediaWiki:Block<span style="color:red">'''L'''</span>ist</code>, а в <code>MediaWiki:Block<span style="color:green">'''l'''</span>ist</code>.

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

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

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

Песочница

2012-10-13T09:34:11Z

Penny:

Тут можно готовить куличики и строить замки.

== Формулы ==

{{Формула|f=\int\limits_a^x f\left(\frac{\alpha}{2}\,\right)\,dx}}

<math>x^2-y=z</math>

<math>e=mc^2</math>

{{Формула|f=72\cdot\sigma^2-23=\beta_3\cdot\frac{2+2\cdot2}{f^2-g^3} }}

{{Формула|f=3x-y^{23}=3}}

== Подсветка кода ==

<syntaxhighlight line lang="cpp-qt">
#include <QtGui/QApplication>
#include <QTextCodec>
#include "mainwindow.h"

int main(int argc, char *argv[])
{
QApplication a(argc, argv);
QTextCodec::setCodecForTr(QTextCodec::codecForName("UTF-8"));

MainWindow w;
w.setWindowTitle(QString::fromUtf8("Суперское мегоприложение"));
w.show();

return a.exec();
}
</syntaxhighlight>

== SVG ==

[[Файл:Svg.svg]]

== Сноски ==

According to scientists, the Sun is pretty big.<ref>E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.</ref>

The Moon, however, is not so big.<ref>R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44-6.</ref>

== Примечания ==

<references />

== Всякие эксперименты ==

<font size="1px">1px</font>

<font size="3px">3px</font>

<font size="5px">5px</font>

<font size="7px">7px</font>

{{Lalettre|u=mail|d2=domain|d1=.net}}

Шаблон:Lalettre

2012-10-13T09:33:02Z

Penny:

<email>{{{u}}}@{{{d2}}}{{{d1}}}</email><noinclude>[[Категория:Шаблоны]]</noinclude>

Шаблон:Lalettre

2012-10-13T09:08:22Z

Penny:

<email>{{{u}}}{{{d2}}}{{{d1}}}</email><noinclude>[[Категория:Шаблоны]]</noinclude>

Twitter-лента

2012-10-07T08:18:53Z

Penny: особенности поиска по хэш-тегу

Twitter-лента

2012-10-06T04:39:10Z

Penny:

Новости

2012-10-05T18:37:43Z

Penny:

Здесь размещаются новости с разделением по курсам, чтобы вся кафедра не читала про то, как у второго курса перенесли лекцию и какого числа первокурсники будут получать банковские карточки. В свою очередь, новости на [[Заглавная_страница | главной странице]] предназначены для всех и с этими не пересекаются.

Всё публикуется в нашем [[Твиттер | Твиттере]] с разделением на курсы с помощью хэш-тегов. А эта страница будет использоваться для расширенного описания новостей, которые не влезают в длину твита.

== Первый курс ==

''новостей нет.''

== Второй курс ==

''новостей нет.''

== Третий курс ==

''новостей нет.''

== Четвёртый курс ==

''новостей нет.''

== Пятый курс ==

''новостей нет.''

== Шестой курс ==

''новостей нет.''

[[Категория:Информация]]

Twitter-лента

2012-10-05T18:37:03Z

Penny: Новая страница: «У нас есть свой [https://twitter.com/iu5bmstu Твиттер]. Несмотря на то, что некоторые яростно противили...»

У нас есть свой [https://twitter.com/iu5bmstu Твиттер]. Несмотря на то, что некоторые яростно противились его появлению.

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

Итак, вот они:
{| class="wikitable"
! Курс !! Хэш-тег
|-
|- align="center"
| 1 курс || [https://twitter.com/search/?q=%23iu5_1k&src=hash ссылка]
|- align="center"
| 2 курс || [https://twitter.com/search/?q=%23iu5_2k&src=hash ссылка]
|- align="center"
| 3 курс || [https://twitter.com/search/?q=%23iu5_3k&src=hash ссылка]
|- align="center"
| 4 курс || [https://twitter.com/search/?q=%23iu5_4k&src=hash ссылка]
|- align="center"
| 5 курс || [https://twitter.com/search/?q=%23iu5_5k&src=hash ссылка]
|- align="center"
| 6 курс || [https://twitter.com/search/?q=%23iu5_6k&src=hash ссылка]
|}

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

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

IRC-канал

2012-10-04T12:57:56Z

Penny: всё-таки RusNet

У нас есть свой [[IRC]]-канал:

{|
! align="right" | Сеть:
| [http://www.rusnet.org.ru/ RusNet] ([http://www.rusnet.org.ru/rules.html правила сети])
|-
! align="right" | Сервер:
| utf.rusnet.org.ru
|-
! align="right" | Порт:
| 7770
|-
! align="right" | Канал:
| #iu5
|-
! align="right" | Кодировка:
| UTF-8
|}

Для слабых духом есть [http://www.rus-net.org/irc/ веб-гейт].

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

IRC

2012-10-03T19:20:29Z

Penny: /* Как пользоваться */ ни к чему эти примеры настроек клиентов

IRC - это чат. А точнее - протокол, разработанный для обмена сообщениями. Выглядит всё как обычная чат-комната: люди заходят, пишут друг другу. Такая [[IRC-канал | комната]] есть и у нас.

== Достоинства ==

Так как создавался он ради обмена сообщениями и более ни для чего другого, то:
* он адски быстр. Ничто в интернете не даёт такой скорости при обмене сообщениями. Он просто молниеносен;
* трафика ему надо ничтожно мало. Ничтожно. Потому прекрасно можно им пользоваться и на мобильных устройствах.

Был создан в 1988 году, почти за двадцать лет до появления вКонтацка и прочих. Построен с {{Википедия|RFC|RFC}}, а не как накодит похапо-обезьяна.

Чаты в социальных сетях в ужасе падают ниц перед величием и могуществом IRC.

== Как пользоваться ==

=== Приложение ===

Нужно приложение-клиент. Их очень много, можно выделить пять:
* {{Википедия|XChat|XChat}} (Windows, Linux);
* {{Википедия|mIRC|mIRC}} (Windows);
* встроенный в браузер [http://www.opera.com/ Opera] (Windows, Linux, Mac OS);
* [https://play.google.com/store/apps/details?id=org.yaaic&feature=search_result#?t=W251bGwsMSwxLDEsIm9yZy55YWFpYyJd Yaaic] (Android);
* [http://irc.senet.ru/files/ SnIRC] (Java).

=== Настройка подключения ===

Для подключения необходимо знать лишь две вещи:
* сервер;
* порт.

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

== Дополнительно ==

Подробнее об IRC можно почитать {{Луркмоар|IRC|здесь}}, [http://wiki.ircnet.su/IRC тут] и на {{Википедия|IRC|там}}.

[[Категория:Этого нельзя не знать]]

IRC-канал

2012-10-03T19:18:32Z

Penny: всё-таки на DALnet

У нас есть свой [[IRC]]-канал:

{|
! align="right" | Сеть:
| [http://www.dal.net/ DALnet]
|-
! align="right" | Сервер:
| irc.dal.net
|-
! align="right" | Порт:
| 7000
|-
! align="right" | Канал:
| #iu5
|-
! align="right" | Кодировка:
| UTF-8
|}

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

Песочница

2012-10-03T08:30:52Z

Penny:

MediaWiki - Настройка и расширения

2012-10-03T06:27:38Z

Penny: /* Обновление MediaWiki */ непереведённые страницы

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования [http://www.mediawiki.org/ MediaWiki]. Такая своеобразная записная книжка.

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

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

=== BPoD ===

Blank Page of Death (BPoD) - белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:
* неверные настройки в файле <code>LocalSettings.php</code>;
* некорректно работающее свежеустановленное расширение.

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

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

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

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

== Настройка MediaWiki ==

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

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

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

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

<syntaxhighlight lang="php">$wgSitename = "Ваше название вики";</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php">$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";</syntaxhighlight>

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

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

Загружать иконку рекомундуется туда же, куда и [[#Установка логотипа | логотип]]. Размеры её должны быть 16x16, а формат - {{Википедия|ICO_(формат_файлов)|ICO}}. Так же можно [[Прозрачный фон изображения | сделать ей прозрачный фон]]. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

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

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

<syntaxhighlight lang="php">$wgFavicon = "$wgStylePath/common/images/favicon.ico";</syntaxhighlight>

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

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

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

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

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

<syntaxhighlight lang="php">$wgEnableUploads = true;</syntaxhighlight>

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

<syntaxhighlight lang="php">$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');</syntaxhighlight>

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

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

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

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

<syntaxhighlight lang="php" highlight="10">
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;
}
</syntaxhighlight>

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

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

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

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

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

Мы используем счётчик от [http://metrika.yandex.ru/add/ Яндекса]. Код его сохранён в файле <code>skins/counter_yandex.php</code>.

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

<syntaxhighlight line enclose="div" highlight="13" lang=php>

<div id="footer"<?php $this->html( 'userlangattributes' ) ?>>
<?php foreach( $this->getFooterLinks() as $category => $links ): ?>
<ul id="footer-<?php echo $category ?>">
<?php foreach( $links as $link ): ?>
<li id="footer-<?php echo $category ?>-<?php echo $link ?>"><?php $this->html( $link ) ?></li>
<?php endforeach; ?>
</ul>
<?php endforeach; ?>
<?php $footericons = $this->getFooterIcons("icononly");
if ( count( $footericons ) > 0 ): ?>
<ul id="footer-icons" class="noprint">
<li><?php include("counter_yandex.php"); ?></li> 
<?php foreach ( $footericons as $blockName => $footerIcons ): ?>
<li id="footer-<?php echo htmlspecialchars( $blockName ); ?>ico">
<?php foreach ( $footerIcons as $icon ): ?>
<?php echo $this->getSkin()->makeFooterIcon( $icon ); ?>

<?php endforeach; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
<div style="clear:both"></div>
</div>

</syntaxhighlight>

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

== Расширения MediaWiki ==

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

Устанавливаются все одинаково:
# загрузить архив с расширением:
# распаковать его в каталог <code>extensions</code> корневого каталога;
# в файле <code>LocalSettings.php</code> из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и [[Работа с Linux-сервером | через SSH]].

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

==== SyntaxHighlight GeSHi ====

У нас используется [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi]. Установка [[#Расширения MediaWiki | ничем не примечательна]], однако на версии MediaWiki 1.17 расширение работать отказывалось - браузер выдавал лишь [[#BPoD | белую страницу смерти]]. Из-за этого до обновления приходилось использовать [http://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter] - более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

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

===== Правка MediaWiki:Geshi.css =====

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

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

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

<syntaxhighlight lang="css">div.mw-geshi {
font-size: 15px
}</syntaxhighlight>

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

===== Правка SyntaxHighlight_GeSHi.class.php =====

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

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal;}";</syntaxhighlight>

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

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal; font-size: 12px;}";</syntaxhighlight>

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

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

Так как мы технари, то нам просто необходима поддержка {{Формула|f=\TeX}}. Любые "псевдоформулы" набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку {{Формула|f=\TeX}} разметки, нужно было бороться до конца.

==== Math ====

Начали мы с расширения [http://www.mediawiki.org/wiki/Extension:Math Math]. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог <code>math</code>).

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

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты <code>texvc</code>. Нужно [[Работа с Linux-сервером | зайти в этот каталог и выполнить команду]] <code>make</code>. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и [[Работа с Linux-сервером | назначьте им права 755]]:
* <code>images/math</code>;
* <code>images/tmp</code>.

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

<syntaxhighlight lang=php>$wgUseTeX = "true";
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";</syntaxhighlight>

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

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

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

<syntaxhighlight lang=php>$wgDefaultUserOptions['math'] = 0;</syntaxhighlight>

==== MathJax ====

После обновления MediaWiki до версии 1.19.2 расширение [http://www.mediawiki.org/wiki/Extension:Math Math] работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение [http://www.mediawiki.org/wiki/Extension:MathJax MathJax].

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

Устанавливается расширение [[#Расширения MediaWiki | стандартно]].

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

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

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

== Обновление MediaWiki ==

Сам процесс уже [http://www.mediawiki.org/wiki/Manual:Upgrading подробнейше описан], добавить нечего. Приведём лишь сюрпризы, ожидавшие нас при обновлении с 1.17 до 1.19.2. Конечно, скорее всего, их бы не было, если бы мы тщательней изучили документацию перед обновлением.

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

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

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

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

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

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

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

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

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

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

{| class="wikitable"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="float:left;"</code>
|- align="center"
| По правому краю || <code>style="float:right;"</code>
|- align="center"
| По центру || <code>style="margin:auto;"</code>
|}

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

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

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

<syntaxhighlight lang="sql"><changeemail></syntaxhighlight>

Значит, надо открыть страницу <code>MediaWiki:Changeemail</code> и внести в неё правку - написать перевод: "<code>Изменить адрес электронной почты</code>".

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

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

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

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

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

IRC

2012-09-24T14:04:09Z

Penny: Новая страница: «Категория:Этого нельзя не знать»

[[Категория:Этого нельзя не знать]]

IRC-канал

2012-09-24T12:30:38Z

Penny:

У нас есть свой [[IRC]]-канал:

{|
! align="right" | Сеть:
| [http://ircnet.ru/ IrcNet.ru] ([http://wiki.ircnet.su/Общие_правила_сети правила сети])
|-
! align="right" | Сервер:
| irc.ircnet.ru
|-
! align="right" | Порт:
| 6667
|-
! align="right" | Канал:
| #iu5
|-
! align="right" | Кодировка:
| UTF-8
|}

Для слабых духом есть [http://ircnet.ru/cgi-bin/irc.cgi web-гейт]. Только не забудьте сменить канал.

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

IRC-канал

2012-09-24T12:04:00Z

Penny:

IRC-канал

2012-09-24T12:02:31Z

Penny:

У нас есть свой [[IRC]]-канал:

{|
! align="right" | Сеть:
| [http://ircnet.ru/ IrcNet.ru] ([http://wiki.ircnet.su/Общие_правила_сети правила сети])
|-
! align="right" | Сервер:
| irc.ircnet.ru
|-
! align="right" | Порт:
| 6667
|-
! align="right" | Канал:
| #iu5
|-
! align="right" | Кодировка:
| UTF-8
|}

Есть [http://ircnet.ru/cgi-bin/irc.cgi web-гейт].

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

Категория:Архив

2012-09-24T11:52:13Z

Penny:

Сюда складывается устаревшее, но не потерявшее ценности что-нибудь.

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

Новости

2012-09-24T11:50:09Z

Penny:

Здесь размещаются новости с разделением по курсам, чтобы вся кафедра не читала про то, как у второго курса перенесли лекцию и какого числа первокурсники будут получать банковские карточки. В свою очередь, новости на [[Заглавная_страница | главной странице]] предназначены для всех и с этими не пересекаются.

Страница ещё в проекте. Позднее будут добавлены RSS-ленты для каждого курса отдельно.

== Первый курс ==

== Второй курс ==

== Третий курс ==

== Четвёртый курс ==

== Пятый курс ==

== Шестой курс ==

[[Категория:Информация]]

Категория:Портал

2012-09-24T11:48:59Z

Penny: Новая страница: «Всё связанное с деятельностью и развитием нашего портала.»

Всё связанное с деятельностью и развитием нашего портала.

Новости

2012-09-24T11:48:28Z

Penny:

Здесь размещаются новости с разделением по курсам, чтобы вся кафедра не читала про то, как у второго курса перенесли лекцию и какого числа первокурсники будут получать банковские карточки. В свою очередь, новости на [[Заглавная_страница | главной странице]] предназначены для всех и с этими не пересекаются.

Страница ещё в проекте. Позднее будут добавлены RSS-ленты для каждого курса отдельно.

== Первый курс ==

== Второй курс ==

== Третий курс ==

== Четвёртый курс ==

== Пятый курс ==

== Шестой курс ==

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

История портала

2012-09-24T11:48:08Z

Penny:

Решили собрать тут всю нашу небольшую историю. По мере развития будет дописывать.

== Как всё началось ==

Началось всё как у всех - с хаотичного разбрасывания всякого добра по всевозможным файлообменникам и выкладыванием ссылок в группе вКонтацке. Ссылки со временем умирали, материалы пропадали, всё было плохо. Подрастающим поколениям, таким образом, ничего не оставалось в наследство.

Надо было организоваться где-то самостоятельно, потому было решено поднять свой сайт. На этом этапе в деле было всего два человека.

== Хостинг на Народе ==

[[Файл:Narod.gif|left]] <u>27 января 2012 года</u> была создана [http://iu5-2014.narod.ru/ первая страница сайта] на хостинге [http://narod.yandex.ru/ Народа]. Это было наше первое появление в интернетах, будем считать его '''Днём рождения портала'''. Там мы просуществовали некоторое время - примерно полгода. Причём, мы создавались как сайт одного лишь потока ИУ5, выпуска 2014 года.

Никакой CMS - голый HTML и загрузка по FTP. Но то уже было гораздо лучше вКонтацка. Страница и сейчас доступна по этому адресу, но обновляться больше не будет. Удалять тоже не будем - послужит резервной копией старых материалов.

Тут к проекту присоединился ещё один человек.

== Хостинг на BeGet ==

[[Файл:Beget.jpg|left]] Хостинг на Народе был хорош всем: от бесплатности до отсутствия ограничений на занимаемый сайтом объём дискового пространства на сервере. Но статичный HTML стеснял полёт фантазии, а ужасающая скорость загрузки файлов на сервер зверски тормозила творческий процесс.

Но самое главное - добавлять новые материалы и страницы могли только администраторы (всё те же три человека), но так не охватывалось и одной сотой всего объёма материалов, которые можно было сохранить и выложить. И вот тут кто-то высказал здравую идею - обосноваться на вики-движке, чтобы в наполнении портала могли участвовать ''все желающие''. К чему всех и призываем.

Кроме того, домен третьего уровня - это несолидно для студентов ИУ5. Так что было решено создать свой и съехать на другой хостинг.

В результате, <u>28 июня 2012 года</u> было зарегистрировано доменное имя: "'''iu5bmstu.ru'''" и выбран новый хостер: [http://www.beget.ru/ BeGet]. Где мы сейчас и находимся. Одновременно с этим пришло осознание, что незачем ограничиваться одним потоком 2014, так что теперь это портал для всей кафедры ИУ5, нынешнего и будущих поколений студентов.

Теперь к проекту может присоединиться сколько угодно человек.

[[Категория:Портал]]

IRC-канал

2012-09-24T11:47:42Z

Penny:

У нас есть свой [[IRC]]-канал:

{|
! align="right" | Сеть:
| [http://ircnet.ru/ IrcNet.ru]
|-
! align="right" | Сервер:
| irc.ircnet.ru
|-
! align="right" | Порт:
| 6667
|-
! align="right" | Канал:
| #iu5
|-
! align="right" | Кодировка:
| UTF-8
|}

[[Категория:Портал]]

IRC-канал

2012-09-24T11:46:20Z

Penny: Новая страница: «У нас есть свой IRC-канал: {| ! align="right" | Сеть: | [http://ircnet.ru/ IrcNet.ru] |- ! align="right" | Сервер: | irc.ircn...»

MediaWiki - Настройка и расширения

2012-09-23T11:38:41Z

Penny: /* Установка счётчиков */

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования [http://www.mediawiki.org/ MediaWiki]. Такая своеобразная записная книжка.

Речь пойдёт об MediaWiki, размещённой на Linix-сервере. Подробнее о версиях установленного ПО можно узнать [[Служебная:Version | здесь]].

== Термины и сокращения ==

=== BPoD ===

Blank Page of Death (BPoD) - белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:
* неверные настройки в файле <code>LocalSettings.php</code>;
* некорректно работающее свежеустановленное расширение.

=== Нулевая правка ===

Null edit - это если зайти в режим ''Правки'' страницы и тут же нажать ''Записать страницу'' (''Save page''), хотя изменений никаких внесено не было. Как бы ни казалось на первый взгляд, но это вовсе не бессмысленное действие.

Нулевая правка принуждает вики пересобрать страницу из исходников и показать её самую последнюю версию. Так вы можете быть уверены, что перед вами не версия из кэша, а актуальная версия страницы.

Также это вызывает сиюминутную категоризацию страницы. Это полезно, когда категория страницы была изменена одним из используемых ей шаблонов, потому как сама вики в этом случае обновит категорию страницы лишь через некоторое время.

== Настройка MediaWiki ==

В основном, вся проводится правкой файла <code>LocalSettings.php</code>. Он находится в корневой директории сайта.

=== Первичная настройка ===

==== Задание названия ====

В файле <code>LocalSettings.php</code> задать переменную:

<syntaxhighlight lang="php">$wgSitename = "Ваше название вики";</syntaxhighlight>

==== Установка логотипа ====

Логотип можно загрузить через интерфейс самой вики, но тогда он окажется доступным для изменения, потому лучше положить его в каталог к дефолтному: <code>skins/common/images/</code>. Однако, тогда при обновлении MediaWiki логотип сбросится вновь на дефолтный или вовсе не будет отображаться.

Логотип должен быть квадратным, с размерами 135x135. Чтобы он смотрелся аккуратно и не выделялся своим фоном на фоне страниц вики, нужно [[Прозрачный фон изображения | сделать ему прозрачный фон]].

После того, как логотип загружен на сервер, нужно задать следующую переменную в файле <code>LocalSettings.php</code>:

<syntaxhighlight lang="php">$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";</syntaxhighlight>

==== Установка иконки ====

Иконка сайта отображается на вкладке браузера, благодаря чему его (сайт) проще отыскать в массе открытых вкладок.

Загружать иконку рекомундуется туда же, куда и [[#Установка логотипа | логотип]]. Размеры её должны быть 16x16, а формат - {{Википедия|ICO_(формат_файлов)|ICO}}. Так же можно [[Прозрачный фон изображения | сделать ей прозрачный фон]]. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

Имя рекомендуется использовать стандартное: <code>favicon.ico</code>.

После того, как иконка загружена на сервер, нужно задать следующую переменную в файле <code>LocalSettings.php</code>:

<syntaxhighlight lang="php">$wgFavicon = "$wgStylePath/common/images/favicon.ico";</syntaxhighlight>

==== Изменение навигационного блока ====

Навигационный блок, расположенный на левой части каждой страницы вики, можно изменять: удалять существующие пункты, добавлять свои. Делается это на спецстранице <code>вашавики.net/index.php/MediaWiki:Sidebar</code>

=== Разрешение загрузки изображений ===

Чтобы пользователи могли загружать изображения, а также для работы некоторых расширений необходимо внести в <code>LocalSettings.php</code> следующие изменения:

Разрешить загрузку файлов на сервер:

<syntaxhighlight lang="php">$wgEnableUploads = true;</syntaxhighlight>

Установить разрешённые расширения файлов:

<syntaxhighlight lang="php">$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');</syntaxhighlight>

Также для работы некоторых расширений может потребоваться редактор изображений ImageMagick:

<syntaxhighlight lang="php">
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert"; # у вас может находиться в иной директории
</syntaxhighlight>

=== Изменение стиля wikitable ===

По умолчанию у класса таблиц <code>wikitable</code> ничтожно маленькое значение отступа от границ ячейки, из-за чего таблицы не радуют глаз. Для установки собственного значения отступа необходимо внести изменения в файл <code>skins\common\shared.css</code>. Скажем, <code>5px</code> будет достаточно:

<syntaxhighlight lang="php" highlight="10">
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;
}
</syntaxhighlight>

Если у вас другая версия MediaWiki, код класса может выглядеть иначе, но суть одна - нужно изменить значение параметра <code>padding</code>.

=== Установка счётчиков ===

Для установки счётчика надо включить его код в код каждой страницы вики, но вообще достаточно включить его лишь в код темы оформления (скина). Так как по умолчанию используется <code>Vector</code>, то рассмотрим на его примере.

Код счётчика лучше сохранить в файле с расширением <code>.php</code> и загрузить на сервер в каталог <code>skins</code>, после чего в файле темы оформления (<code>Vector.php</code>) надо будет включить в определённом месте имя этого файла. Не забывайте, что кодировка файла с кодом счётчика должна совпадать с кодировкой, используемой на вашем сайте, иначе вместо кириллицы будет отображаться кракозябра.

Счётчики могут отображать на странице свою пиктограммку с некоторыми данными, а могут не отображать. Но в обоих случаях они будут отправлять статистику посещений на свой сервер, где её можно будет подробно изучить.

Мы используем счётчик от [http://metrika.yandex.ru/add/ Яндекса]. Код его сохранён в файле <code>skins/counter_yandex.php</code>.

Для добавления счётчика редактируем файл <code>skins/Vector.php</code>:

<syntaxhighlight line enclose="div" highlight="13" lang=php>

<div id="footer"<?php $this->html( 'userlangattributes' ) ?>>
<?php foreach( $this->getFooterLinks() as $category => $links ): ?>
<ul id="footer-<?php echo $category ?>">
<?php foreach( $links as $link ): ?>
<li id="footer-<?php echo $category ?>-<?php echo $link ?>"><?php $this->html( $link ) ?></li>
<?php endforeach; ?>
</ul>
<?php endforeach; ?>
<?php $footericons = $this->getFooterIcons("icononly");
if ( count( $footericons ) > 0 ): ?>
<ul id="footer-icons" class="noprint">
<li><?php include("counter_yandex.php"); ?></li> 
<?php foreach ( $footericons as $blockName => $footerIcons ): ?>
<li id="footer-<?php echo htmlspecialchars( $blockName ); ?>ico">
<?php foreach ( $footerIcons as $icon ): ?>
<?php echo $this->getSkin()->makeFooterIcon( $icon ); ?>

<?php endforeach; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
<div style="clear:both"></div>
</div>

</syntaxhighlight>

После этого счётчик заработает, и должна стать видна его пиктограмма. Если же она не видна, то возможно её блокирует ваш браузер, его расширения или что-то ещё.

== Расширения MediaWiki ==

Они же ''extensions''. Позволяют расширить функционал вики. Например, добавить поддержку TeX формул и подсветку синтаксиса фрагментов исходного кода на том или ином языке программирования.

Устанавливаются все одинаково:
# загрузить архив с расширением:
# распаковать его в каталог <code>extensions</code> корневого каталога;
# в файле <code>LocalSettings.php</code> из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и [[Работа с Linux-сервером | через SSH]].

=== Подсветка синтаксиса ===

==== SyntaxHighlight GeSHi ====

У нас используется [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi]. Установка [[#Расширения MediaWiki | ничем не примечательна]], однако на версии MediaWiki 1.17 расширение работать отказывалось - браузер выдавал лишь [[#BPoD | белую страницу смерти]]. Из-за этого до обновления приходилось использовать [http://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter] - более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

Когда же после обновления MediaWIki удалось установить SyntaxHighlight GeSHi, то оказалось, что по умолчанию им используется довольно мелкий шрифт. По крайней мере, такое наблюдалось в Firefox, а Opera и IE отображали блоки кода с шрифтом нормальных размеров.

===== Правка MediaWiki:Geshi.css =====

Это не файл (в каталоге с расширением вы его не найдёте), а спецстраница вашей Вики: <code>вашавики.net/index.php/MediaWiki:Geshi.css</code>.

Изначально страница пустая, её необходимо создать. Всё, что здесь будет вноситься, будет дополнительно использоваться в стилях подсветки синтаксиса (расширение будет брать настройки отображения отсюда, в дополнение к своим).

Следующая конструкция управляет размером шрифта:

<syntaxhighlight lang="css">div.mw-geshi {
font-size: 15px
}</syntaxhighlight>

Однако, на нашей вики это эффекта не дало.

===== Правка SyntaxHighlight_GeSHi.class.php =====

Вот это уже действительно файл, который находится в каталоге самого расширения.

Нужно изменить строку:

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal;}";</syntaxhighlight>

следующим образом (добавить запись про размер шрифта):

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal; font-size: 12px;}";</syntaxhighlight>

После этого блоки с кодом стали отображаться удобочитаемыми и вообще радующими глаз.

=== Использование TeX формул ===

Так как мы технари, то нам просто необходима поддержка {{Формула|f=\TeX}}. Любые "псевдоформулы" набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку {{Формула|f=\TeX}} разметки, нужно было бороться до конца.

==== Math ====

Начали мы с расширения [http://www.mediawiki.org/wiki/Extension:Math Math]. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог <code>math</code>).

Для работы расширения на сервере должны быть установлены пакеты <code>latex</code> и <code>dvips</code>. Если хостер отказывает в установке этих пакетов на сервере, то просите установить их в вашу домашнюю директорию, в ущерб выделенному вам на сервере дисковому пространству, или же меняйте хостера.

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты <code>texvc</code>. Нужно [[Работа с Linux-сервером | зайти в этот каталог и выполнить команду]] <code>make</code>. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и [[Работа с Linux-сервером | назначьте им права 755]]:
* <code>images/math</code>;
* <code>images/tmp</code>.

Далее необходимо задать следующие три переменных в файле настроек <code>LocalSettings.php</code>:

<syntaxhighlight lang=php>$wgUseTeX = "true";
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";</syntaxhighlight>

Также должна быть [[#Разрешение загрузки изображений | разрешена загрузка изображений]].

После этого вики будет способна обрабатывать {{Формула|f=\TeX}} формулы, заключённые в теге <nowiki><math></math></nowiki>. Вкратце обработка происходит следующим образом: <code>latex</code> обрабатывает формулу, заключённую в теге <nowiki><math></math></nowiki>, <code>ImageMagic</code> создаёт из этого картинку и помещает её на страницу. Таким образом, готовые формулы представляют собой растровые изображения.

Однако, простые формулы, вроде x + 2 = 4, вики по умолчанию отображает текстом, отчего они выглядят не как "картиночные". За это отвечает переменная в настройках внешнего вида вики для каждого зарегистрированного пользователя, но можно задать её по умолчанию для всех. Для этого надо изменить в <code>LocalSettings.php</code> следующую переменную:

<syntaxhighlight lang=php>$wgDefaultUserOptions['math'] = 0;</syntaxhighlight>

==== MathJax ====

После обновления MediaWiki до версии 1.19.2 расширение [http://www.mediawiki.org/wiki/Extension:Math Math] работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение [http://www.mediawiki.org/wiki/Extension:MathJax MathJax].

Самым главным его отличием является то, что оно не использует (соответственно, и не требует) наличия на сервере пакетов <code>latex</code> и <code>dvips</code>, и итоговые формулы являются не растровыми изображениями, а векторными объектами, которые можно сколь угодно масштабировать без потери качества их отображения на странице.

Устанавливается расширение [[#Расширения MediaWiki | стандартно]].

Для обработки формул помимо стандартного тега <nowiki><math></math></nowiki> можно (и удобнее) использовать родные символы <nowiki>$$</nowiki> из {{Формула|f=\TeX}}.

Единственное что - формулы отображаются с тем размером шрифта, в окружении какого они используются, и потому выглядят довольно мелко. Эту проблему мы решили введением шаблона [[Шаблон:Формула | Формула]]. Идея в том, чтобы окружить формулу тегом увеличения размера шрифта:

<syntaxhighlight lang=html4strict><span style="font-size:130%">$x + 2 = 4$</span></syntaxhighlight>

== Обновление MediaWiki ==

Сам процесс уже [http://www.mediawiki.org/wiki/Manual:Upgrading подробнейше описан], добавить нечего. Приведём лишь сюрпризы, ожидавшие нас при обновлении с 1.17 до 1.19.2. Конечно, скорее всего, их бы не было, если бы мы тщательней изучили документацию перед обновлением.

=== Логотип и иконка ===

Так как мы забыли, что размещённые по пути <code>skins/common/images/</code> [[#Установка логотипа | логотип]] и [[#Установка иконки | иконка]] сбросятся на дефолтные при обновлении, то они и сбросились. Пришлось заливать их обратно.

=== Запрет включения статей в категории шаблонов ===

Тег <code><nowiki><noinclude></nowiki></code>, препятствующий добавлению категории шаблона в статью, где он используется, перестал работать должным образом, и статьи с шаблонами моментально оказались в их категориях. Оказалось, что теперь "невключаемость" в категорию шаблона следует оформлять немного по-другому.

Как работало в 1.17:
<nowiki><noinclude>[[Категория:Преподаватели]]</noinclude></nowiki>

Как работает теперь в 1.19.2:
<nowiki><noinclude>:[[Категория:Преподаватели]]</noinclude></nowiki>

А через некоторое время стало работать и как раньше, потому мы вернули всё как было. Непонятно, что это случилось. Возможно, ненадолго сбилась категоризация, а после правок всё "перекатегоризировалось", так что, выходит, это двоеточие никак не влияло.

=== Выравнивание таблицы на странице ===

Конструкция, например, <code>align="right"</code> для выравнивая таблицы по правому краю страницы перестала обрабатываться, потому как за её обработку теперь вроде как отвечает CSS. В результате информационные таблицы, которые были удобно размещены справа, уехали влево.

Оказалось, что мы всё проспали: такой способ устарел и вообще считается плохой практикой в вёрстке. Вместо этого следует использовать следующее:

{| class="wikitable"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="float:left;"</code>
|- align="center"
| По правому краю || <code>style="float:right;"</code>
|- align="center"
| По центру || <code>style="margin:auto;"</code>
|}

== Важные мелочи ==

Небольшие, но важные советы:
* при создании шаблонов ни в коем случае не оставляйте пустых строк сверху (и снизу) конструкции <nowiki><noinclude></nowiki>. В противном случае пустая строка перенесётся в статью вместе с шаблоном и устроит там содомию.

[[Категория:WWW]]

MediaWiki - Настройка и расширения

2012-09-23T11:28:46Z

Penny: /* Расширения MediaWiki */

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования [http://www.mediawiki.org/ MediaWiki]. Такая своеобразная записная книжка.

Речь пойдёт об MediaWiki, размещённой на Linix-сервере. Подробнее о версиях установленного ПО можно узнать [[Служебная:Version | здесь]].

== Термины и сокращения ==

=== BPoD ===

Blank Page of Death (BPoD) - белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:
* неверные настройки в файле <code>LocalSettings.php</code>;
* некорректно работающее свежеустановленное расширение.

=== Нулевая правка ===

Null edit - это если зайти в режим ''Правки'' страницы и тут же нажать ''Записать страницу'' (''Save page''), хотя изменений никаких внесено не было. Как бы ни казалось на первый взгляд, но это вовсе не бессмысленное действие.

Нулевая правка принуждает вики пересобрать страницу из исходников и показать её самую последнюю версию. Так вы можете быть уверены, что перед вами не версия из кэша, а актуальная версия страницы.

Также это вызывает сиюминутную категоризацию страницы. Это полезно, когда категория страницы была изменена одним из используемых ей шаблонов, потому как сама вики в этом случае обновит категорию страницы лишь через некоторое время.

== Настройка MediaWiki ==

В основном, вся проводится правкой файла <code>LocalSettings.php</code>. Он находится в корневой директории сайта.

=== Первичная настройка ===

==== Задание названия ====

В файле <code>LocalSettings.php</code> задать переменную:

<syntaxhighlight lang="php">$wgSitename = "Ваше название вики";</syntaxhighlight>

==== Установка логотипа ====

Логотип можно загрузить через интерфейс самой вики, но тогда он окажется доступным для изменения, потому лучше положить его в каталог к дефолтному: <code>skins/common/images/</code>. Однако, тогда при обновлении MediaWiki логотип сбросится вновь на дефолтный или вовсе не будет отображаться.

Логотип должен быть квадратным, с размерами 135x135. Чтобы он смотрелся аккуратно и не выделялся своим фоном на фоне страниц вики, нужно [[Прозрачный фон изображения | сделать ему прозрачный фон]].

После того, как логотип загружен на сервер, нужно задать следующую переменную в файле <code>LocalSettings.php</code>:

<syntaxhighlight lang="php">$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";</syntaxhighlight>

==== Установка иконки ====

Иконка сайта отображается на вкладке браузера, благодаря чему его (сайт) проще отыскать в массе открытых вкладок.

Загружать иконку рекомундуется туда же, куда и [[#Установка логотипа | логотип]]. Размеры её должны быть 16x16, а формат - {{Википедия|ICO_(формат_файлов)|ICO}}. Так же можно [[Прозрачный фон изображения | сделать ей прозрачный фон]]. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

Имя рекомендуется использовать стандартное: <code>favicon.ico</code>.

После того, как иконка загружена на сервер, нужно задать следующую переменную в файле <code>LocalSettings.php</code>:

<syntaxhighlight lang="php">$wgFavicon = "$wgStylePath/common/images/favicon.ico";</syntaxhighlight>

==== Изменение навигационного блока ====

Навигационный блок, расположенный на левой части каждой страницы вики, можно изменять: удалять существующие пункты, добавлять свои. Делается это на спецстранице <code>вашавики.net/index.php/MediaWiki:Sidebar</code>

=== Разрешение загрузки изображений ===

Чтобы пользователи могли загружать изображения, а также для работы некоторых расширений необходимо внести в <code>LocalSettings.php</code> следующие изменения:

Разрешить загрузку файлов на сервер:

<syntaxhighlight lang="php">$wgEnableUploads = true;</syntaxhighlight>

Установить разрешённые расширения файлов:

<syntaxhighlight lang="php">$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');</syntaxhighlight>

Также для работы некоторых расширений может потребоваться редактор изображений ImageMagick:

<syntaxhighlight lang="php">
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert"; # у вас может находиться в иной директории
</syntaxhighlight>

=== Изменение стиля wikitable ===

По умолчанию у класса таблиц <code>wikitable</code> ничтожно маленькое значение отступа от границ ячейки, из-за чего таблицы не радуют глаз. Для установки собственного значения отступа необходимо внести изменения в файл <code>skins\common\shared.css</code>. Скажем, <code>5px</code> будет достаточно:

<syntaxhighlight lang="php" highlight="10">
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;
}
</syntaxhighlight>

Если у вас другая версия MediaWiki, код класса может выглядеть иначе, но суть одна - нужно изменить значение параметра <code>padding</code>.

=== Установка счётчиков ===

Для установки счётчика надо включить его код в код каждой страницы вики, но вообще достаточно включить его лишь в код темы оформления (скина). Так как по умолчанию используется <code>Vector</code>, то рассмотрим на его примере.

Код счётчика лучше сохранить в файле с расширением <code>.php</code> и загрузить на сервер в каталог <code>skins</code>, после чего в файле темы оформления (<code>Vector.php</code>) надо будет включить в определённом месте имя этого файла. Не забывайте, что кодировка файла с кодом счётчика должна совпадать с кодировкой, используемой на вашем сайте, иначе вместо кириллицы будет отображаться кракозябра.

Счётчики могут отображать на странице свою пиктограммку с некоторыми данными, а могут не отображать. Но в обоих случаях они будут отправлять статистику посещений на свой сервер, где её можно будет подробно изучить.

Мы используем счётчик от [http://metrika.yandex.ru/add/ Яндекса]. Код его сохранён в файле <code>skins/counter_yandex.php</code>.

Для добавления счётчика редактируем файл <code>skins/Vector.php</code>:

<syntaxhighlight line enclose="div" highlight="13" lang=php>

<div id="footer"<?php $this->html( 'userlangattributes' ) ?>>
<?php foreach( $this->getFooterLinks() as $category => $links ): ?>
<ul id="footer-<?php echo $category ?>">
<?php foreach( $links as $link ): ?>
<li id="footer-<?php echo $category ?>-<?php echo $link ?>"><?php $this->html( $link ) ?></li>
<?php endforeach; ?>
</ul>
<?php endforeach; ?>
<?php $footericons = $this->getFooterIcons("icononly");
if ( count( $footericons ) > 0 ): ?>
<ul id="footer-icons" class="noprint">
<li><?php include("counter_yandex.php"); ?></li> 
<?php foreach ( $footericons as $blockName => $footerIcons ): ?>
<li id="footer-<?php echo htmlspecialchars( $blockName ); ?>ico">
<?php foreach ( $footerIcons as $icon ): ?>
<?php echo $this->getSkin()->makeFooterIcon( $icon ); ?>

<?php endforeach; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
<div style="clear:both"></div>
</div>

</syntaxhighlight>

После этого счётчик заработает, и должна стать видна его пиктограмма. Если же она не видна, то возможно её блокирует ваш браузер, его расширения или что-то ещё.

== Расширения MediaWiki ==

Они же ''extensions''. Позволяют расширить функционал вики. Например, добавить поддержку TeX формул и подсветку синтаксиса фрагментов исходного кода на том или ином языке программирования.

Устанавливаются все одинаково:
# загрузить архив с расширением:
# распаковать его в каталог <code>extensions</code> корневого каталога;
# в файле <code>LocalSettings.php</code> из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и [[Работа с Linux-сервером | через SSH]].

=== Подсветка синтаксиса ===

==== SyntaxHighlight GeSHi ====

У нас используется [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi]. Установка [[#Расширения MediaWiki | ничем не примечательна]], однако на версии MediaWiki 1.17 расширение работать отказывалось - браузер выдавал лишь [[#BPoD | белую страницу смерти]]. Из-за этого до обновления приходилось использовать [http://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter] - более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

Когда же после обновления MediaWIki удалось установить SyntaxHighlight GeSHi, то оказалось, что по умолчанию им используется довольно мелкий шрифт. По крайней мере, такое наблюдалось в Firefox, а Opera и IE отображали блоки кода с шрифтом нормальных размеров.

===== Правка MediaWiki:Geshi.css =====

Это не файл (в каталоге с расширением вы его не найдёте), а спецстраница вашей Вики: <code>вашавики.net/index.php/MediaWiki:Geshi.css</code>.

Изначально страница пустая, её необходимо создать. Всё, что здесь будет вноситься, будет дополнительно использоваться в стилях подсветки синтаксиса (расширение будет брать настройки отображения отсюда, в дополнение к своим).

Следующая конструкция управляет размером шрифта:

<syntaxhighlight lang="css">div.mw-geshi {
font-size: 15px
}</syntaxhighlight>

Однако, на нашей вики это эффекта не дало.

===== Правка SyntaxHighlight_GeSHi.class.php =====

Вот это уже действительно файл, который находится в каталоге самого расширения.

Нужно изменить строку:

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal;}";</syntaxhighlight>

следующим образом (добавить запись про размер шрифта):

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal; font-size: 12px;}";</syntaxhighlight>

После этого блоки с кодом стали отображаться удобочитаемыми и вообще радующими глаз.

=== Использование TeX формул ===

Так как мы технари, то нам просто необходима поддержка {{Формула|f=\TeX}}. Любые "псевдоформулы" набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку {{Формула|f=\TeX}} разметки, нужно было бороться до конца.

==== Math ====

Начали мы с расширения [http://www.mediawiki.org/wiki/Extension:Math Math]. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог <code>math</code>).

Для работы расширения на сервере должны быть установлены пакеты <code>latex</code> и <code>dvips</code>. Если хостер отказывает в установке этих пакетов на сервере, то просите установить их в вашу домашнюю директорию, в ущерб выделенному вам на сервере дисковому пространству, или же меняйте хостера.

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты <code>texvc</code>. Нужно [[Работа с Linux-сервером | зайти в этот каталог и выполнить команду]] <code>make</code>. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и [[Работа с Linux-сервером | назначьте им права 755]]:
* <code>images/math</code>;
* <code>images/tmp</code>.

Далее необходимо задать следующие три переменных в файле настроек <code>LocalSettings.php</code>:

<syntaxhighlight lang=php>$wgUseTeX = "true";
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";</syntaxhighlight>

Также должна быть [[#Разрешение загрузки изображений | разрешена загрузка изображений]].

После этого вики будет способна обрабатывать {{Формула|f=\TeX}} формулы, заключённые в теге <nowiki><math></math></nowiki>. Вкратце обработка происходит следующим образом: <code>latex</code> обрабатывает формулу, заключённую в теге <nowiki><math></math></nowiki>, <code>ImageMagic</code> создаёт из этого картинку и помещает её на страницу. Таким образом, готовые формулы представляют собой растровые изображения.

Однако, простые формулы, вроде x + 2 = 4, вики по умолчанию отображает текстом, отчего они выглядят не как "картиночные". За это отвечает переменная в настройках внешнего вида вики для каждого зарегистрированного пользователя, но можно задать её по умолчанию для всех. Для этого надо изменить в <code>LocalSettings.php</code> следующую переменную:

<syntaxhighlight lang=php>$wgDefaultUserOptions['math'] = 0;</syntaxhighlight>

==== MathJax ====

После обновления MediaWiki до версии 1.19.2 расширение [http://www.mediawiki.org/wiki/Extension:Math Math] работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение [http://www.mediawiki.org/wiki/Extension:MathJax MathJax].

Самым главным его отличием является то, что оно не использует (соответственно, и не требует) наличия на сервере пакетов <code>latex</code> и <code>dvips</code>, и итоговые формулы являются не растровыми изображениями, а векторными объектами, которые можно сколь угодно масштабировать без потери качества их отображения на странице.

Устанавливается расширение [[#Расширения MediaWiki | стандартно]].

Для обработки формул помимо стандартного тега <nowiki><math></math></nowiki> можно (и удобнее) использовать родные символы <nowiki>$$</nowiki> из {{Формула|f=\TeX}}.

Единственное что - формулы отображаются с тем размером шрифта, в окружении какого они используются, и потому выглядят довольно мелко. Эту проблему мы решили введением шаблона [[Шаблон:Формула | Формула]]. Идея в том, чтобы окружить формулу тегом увеличения размера шрифта:

<syntaxhighlight lang=html4strict><span style="font-size:130%">$x + 2 = 4$</span></syntaxhighlight>

== Обновление MediaWiki ==

Сам процесс уже [http://www.mediawiki.org/wiki/Manual:Upgrading подробнейше описан], добавить нечего. Приведём лишь сюрпризы, ожидавшие нас при обновлении с 1.17 до 1.19.2. Конечно, скорее всего, их бы не было, если бы мы тщательней изучили документацию перед обновлением.

=== Логотип и иконка ===

Так как мы забыли, что размещённые по пути <code>skins/common/images/</code> [[#Установка логотипа | логотип]] и [[#Установка иконки | иконка]] сбросятся на дефолтные при обновлении, то они и сбросились. Пришлось заливать их обратно.

=== Запрет включения статей в категории шаблонов ===

Тег <code><nowiki><noinclude></nowiki></code>, препятствующий добавлению категории шаблона в статью, где он используется, перестал работать должным образом, и статьи с шаблонами моментально оказались в их категориях. Оказалось, что теперь "невключаемость" в категорию шаблона следует оформлять немного по-другому.

Как работало в 1.17:
<nowiki><noinclude>[[Категория:Преподаватели]]</noinclude></nowiki>

Как работает теперь в 1.19.2:
<nowiki><noinclude>:[[Категория:Преподаватели]]</noinclude></nowiki>

А через некоторое время стало работать и как раньше, потому мы вернули всё как было. Непонятно, что это случилось. Возможно, ненадолго сбилась категоризация, а после правок всё "перекатегоризировалось", так что, выходит, это двоеточие никак не влияло.

=== Выравнивание таблицы на странице ===

Конструкция, например, <code>align="right"</code> для выравнивая таблицы по правому краю страницы перестала обрабатываться, потому как за её обработку теперь вроде как отвечает CSS. В результате информационные таблицы, которые были удобно размещены справа, уехали влево.

Оказалось, что мы всё проспали: такой способ устарел и вообще считается плохой практикой в вёрстке. Вместо этого следует использовать следующее:

{| class="wikitable"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="float:left;"</code>
|- align="center"
| По правому краю || <code>style="float:right;"</code>
|- align="center"
| По центру || <code>style="margin:auto;"</code>
|}

== Важные мелочи ==

Небольшие, но важные советы:
* при создании шаблонов ни в коем случае не оставляйте пустых строк сверху (и снизу) конструкции <nowiki><noinclude></nowiki>. В противном случае пустая строка перенесётся в статью вместе с шаблоном и устроит там содомию.

[[Категория:WWW]]

MediaWiki - Настройка и расширения

2012-09-23T11:26:25Z

Penny: /* Установка счётчиков */

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования [http://www.mediawiki.org/ MediaWiki]. Такая своеобразная записная книжка.

Речь пойдёт об MediaWiki, размещённой на Linix-сервере. Подробнее о версиях установленного ПО можно узнать [[Служебная:Version | здесь]].

== Термины и сокращения ==

=== BPoD ===

Blank Page of Death (BPoD) - белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:
* неверные настройки в файле <code>LocalSettings.php</code>;
* некорректно работающее свежеустановленное расширение.

=== Нулевая правка ===

Null edit - это если зайти в режим ''Правки'' страницы и тут же нажать ''Записать страницу'' (''Save page''), хотя изменений никаких внесено не было. Как бы ни казалось на первый взгляд, но это вовсе не бессмысленное действие.

Нулевая правка принуждает вики пересобрать страницу из исходников и показать её самую последнюю версию. Так вы можете быть уверены, что перед вами не версия из кэша, а актуальная версия страницы.

Также это вызывает сиюминутную категоризацию страницы. Это полезно, когда категория страницы была изменена одним из используемых ей шаблонов, потому как сама вики в этом случае обновит категорию страницы лишь через некоторое время.

== Настройка MediaWiki ==

В основном, вся проводится правкой файла <code>LocalSettings.php</code>. Он находится в корневой директории сайта.

=== Первичная настройка ===

==== Задание названия ====

В файле <code>LocalSettings.php</code> задать переменную:

<syntaxhighlight lang="php">$wgSitename = "Ваше название вики";</syntaxhighlight>

==== Установка логотипа ====

Логотип можно загрузить через интерфейс самой вики, но тогда он окажется доступным для изменения, потому лучше положить его в каталог к дефолтному: <code>skins/common/images/</code>. Однако, тогда при обновлении MediaWiki логотип сбросится вновь на дефолтный или вовсе не будет отображаться.

Логотип должен быть квадратным, с размерами 135x135. Чтобы он смотрелся аккуратно и не выделялся своим фоном на фоне страниц вики, нужно [[Прозрачный фон изображения | сделать ему прозрачный фон]].

После того, как логотип загружен на сервер, нужно задать следующую переменную в файле <code>LocalSettings.php</code>:

<syntaxhighlight lang="php">$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";</syntaxhighlight>

==== Установка иконки ====

Иконка сайта отображается на вкладке браузера, благодаря чему его (сайт) проще отыскать в массе открытых вкладок.

Загружать иконку рекомундуется туда же, куда и [[#Установка логотипа | логотип]]. Размеры её должны быть 16x16, а формат - {{Википедия|ICO_(формат_файлов)|ICO}}. Так же можно [[Прозрачный фон изображения | сделать ей прозрачный фон]]. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

Имя рекомендуется использовать стандартное: <code>favicon.ico</code>.

После того, как иконка загружена на сервер, нужно задать следующую переменную в файле <code>LocalSettings.php</code>:

<syntaxhighlight lang="php">$wgFavicon = "$wgStylePath/common/images/favicon.ico";</syntaxhighlight>

==== Изменение навигационного блока ====

Навигационный блок, расположенный на левой части каждой страницы вики, можно изменять: удалять существующие пункты, добавлять свои. Делается это на спецстранице <code>вашавики.net/index.php/MediaWiki:Sidebar</code>

=== Разрешение загрузки изображений ===

Чтобы пользователи могли загружать изображения, а также для работы некоторых расширений необходимо внести в <code>LocalSettings.php</code> следующие изменения:

Разрешить загрузку файлов на сервер:

<syntaxhighlight lang="php">$wgEnableUploads = true;</syntaxhighlight>

Установить разрешённые расширения файлов:

<syntaxhighlight lang="php">$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');</syntaxhighlight>

Также для работы некоторых расширений может потребоваться редактор изображений ImageMagick:

<syntaxhighlight lang="php">
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert"; # у вас может находиться в иной директории
</syntaxhighlight>

=== Изменение стиля wikitable ===

По умолчанию у класса таблиц <code>wikitable</code> ничтожно маленькое значение отступа от границ ячейки, из-за чего таблицы не радуют глаз. Для установки собственного значения отступа необходимо внести изменения в файл <code>skins\common\shared.css</code>. Скажем, <code>5px</code> будет достаточно:

<syntaxhighlight lang="php" highlight="10">
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;
}
</syntaxhighlight>

Если у вас другая версия MediaWiki, код класса может выглядеть иначе, но суть одна - нужно изменить значение параметра <code>padding</code>.

=== Установка счётчиков ===

Для установки счётчика надо включить его код в код каждой страницы вики, но вообще достаточно включить его лишь в код темы оформления (скина). Так как по умолчанию используется <code>Vector</code>, то рассмотрим на его примере.

Код счётчика лучше сохранить в файле с расширением <code>.php</code> и загрузить на сервер в каталог <code>skins</code>, после чего в файле темы оформления (<code>Vector.php</code>) надо будет включить в определённом месте имя этого файла. Не забывайте, что кодировка файла с кодом счётчика должна совпадать с кодировкой, используемой на вашем сайте, иначе вместо кириллицы будет отображаться кракозябра.

Счётчики могут отображать на странице свою пиктограммку с некоторыми данными, а могут не отображать. Но в обоих случаях они будут отправлять статистику посещений на свой сервер, где её можно будет подробно изучить.

Мы используем счётчик от [http://metrika.yandex.ru/add/ Яндекса]. Код его сохранён в файле <code>skins/counter_yandex.php</code>.

Для добавления счётчика редактируем файл <code>skins/Vector.php</code>:

<syntaxhighlight line enclose="div" highlight="13" lang=php>

<div id="footer"<?php $this->html( 'userlangattributes' ) ?>>
<?php foreach( $this->getFooterLinks() as $category => $links ): ?>
<ul id="footer-<?php echo $category ?>">
<?php foreach( $links as $link ): ?>
<li id="footer-<?php echo $category ?>-<?php echo $link ?>"><?php $this->html( $link ) ?></li>
<?php endforeach; ?>
</ul>
<?php endforeach; ?>
<?php $footericons = $this->getFooterIcons("icononly");
if ( count( $footericons ) > 0 ): ?>
<ul id="footer-icons" class="noprint">
<li><?php include("counter_yandex.php"); ?></li> 
<?php foreach ( $footericons as $blockName => $footerIcons ): ?>
<li id="footer-<?php echo htmlspecialchars( $blockName ); ?>ico">
<?php foreach ( $footerIcons as $icon ): ?>
<?php echo $this->getSkin()->makeFooterIcon( $icon ); ?>

<?php endforeach; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
<div style="clear:both"></div>
</div>

</syntaxhighlight>

После этого счётчик заработает, и должна стать видна его пиктограмма. Если же она не видна, то возможно её блокирует ваш браузер, его расширения или что-то ещё.

== Расширения MediaWiki ==

Они же ''extensions''. Позволяют расширить функционал вики. Например, добавить поддержку TeX формул и подсветку синтаксиса фрагментов исходного кода на том или ином языке программирования.

Устанавливаются все одинаково:
# загрузить архив с расширением:
# распаковать его в каталог <code>extensions</code> корневого каталога;
# в файле <code>LocalSettings.php</code> из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и [[Работа с Linux-сервером | через SSH]].

=== Подсветка синтаксиса ===

У нас используется [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi]. Установка ничем не примечательная, однако на версии MediaWiki 1.17 расширение работать отказывалось - браузер выдавал лишь [[#BPoD | белую страницу смерти]]. Из-за этого до обновления приходилось использовать [http://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter] - более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

==== SyntaxHighlight GeSHi ====

Когда же после обновления MediaWIki удалось установить SyntaxHighlight GeSHi, то оказалось, что по умолчанию им используется довольно мелкий шрифт. По крайней мере, такое наблюдалось в Firefox, а Opera и IE отображали блоки кода с шрифтом нормальных размеров.

===== Правка MediaWiki:Geshi.css =====

Это не файл (в каталоге с расширением вы его не найдёте), а спецстраница вашей Вики: <code>вашавики.net/index.php/MediaWiki:Geshi.css</code>.

Изначально страница пустая, её необходимо создать. Всё, что здесь будет вноситься, будет дополнительно использоваться в стилях подсветки синтаксиса (расширение будет брать настройки отображения отсюда, в дополнение к своим).

Следующая конструкция управляет размером шрифта:

<syntaxhighlight lang="css">div.mw-geshi {
font-size: 15px
}</syntaxhighlight>

Однако, на нашей вики это эффекта не дало.

===== Правка SyntaxHighlight_GeSHi.class.php =====

Вот это уже действительно файл, который находится в каталоге самого расширения.

Нужно изменить строку:

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal;}";</syntaxhighlight>

следующим образом (добавить запись про размер шрифта):

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal; font-size: 12px;}";</syntaxhighlight>

После этого блоки с кодом стали отображаться удобочитаемыми и вообще радующими глаз.

=== Использование TeX формул ===

Так как мы технари, то нам просто необходима поддержка {{Формула|f=\TeX}}. Любые "псевдоформулы" набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку {{Формула|f=\TeX}} разметки, нужно было бороться до конца.

==== Math ====

Начали мы с расширения [http://www.mediawiki.org/wiki/Extension:Math Math]. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог <code>math</code>).

Для работы расширения на сервере должны быть установлены пакеты <code>latex</code> и <code>dvips</code>. Если хостер отказывает в установке этих пакетов на сервере, то просите установить их в вашу домашнюю директорию, в ущерб выделенному вам на сервере дисковому пространству, или же меняйте хостера.

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты <code>texvc</code>. Нужно [[Работа с Linux-сервером | зайти в этот каталог и выполнить команду]] <code>make</code>. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и [[Работа с Linux-сервером | назначьте им права 755]]:
* <code>images/math</code>;
* <code>images/tmp</code>.

Далее необходимо задать следующие три переменных в файле настроек <code>LocalSettings.php</code>:

<syntaxhighlight lang=php>$wgUseTeX = "true";
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";</syntaxhighlight>

Также должна быть [[#Разрешение загрузки изображений | разрешена загрузка изображений]].

После этого вики будет способна обрабатывать {{Формула|f=\TeX}} формулы, заключённые в теге <nowiki><math></math></nowiki>. Вкратце обработка происходит следующим образом: <code>latex</code> обрабатывает формулу, заключённую в теге <nowiki><math></math></nowiki>, <code>ImageMagic</code> создаёт из этого картинку и помещает её на страницу. Таким образом, готовые формулы представляют собой растровые изображения.

Однако, простые формулы, вроде x + 2 = 4, вики по умолчанию отображает текстом, отчего они выглядят не как "картиночные". За это отвечает переменная в настройках внешнего вида вики для каждого зарегистрированного пользователя, но можно задать её по умолчанию для всех. Для этого надо изменить в <code>LocalSettings.php</code> следующую переменную:

<syntaxhighlight lang=php>$wgDefaultUserOptions['math'] = 0;</syntaxhighlight>

==== MathJax ====

После обновления MediaWiki до версии 1.19.2 расширение [http://www.mediawiki.org/wiki/Extension:Math Math] работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение [http://www.mediawiki.org/wiki/Extension:MathJax MathJax].

Самым главным его отличием является то, что оно не использует (соответственно, и не требует) наличия на сервере пакетов <code>latex</code> и <code>dvips</code>, и итоговые формулы являются не растровыми изображениями, а векторными объектами, которые можно сколь угодно масштабировать без потери качества их отображения на странице.

Устанавливается расширение [[#Расширения MediaWiki | стандартно]].

Для обработки формул помимо стандартного тега <nowiki><math></math></nowiki> можно (и удобнее) использовать родные символы <nowiki>$$</nowiki> из {{Формула|f=\TeX}}.

Единственное что - формулы отображаются с тем размером шрифта, в окружении какого они используются, и потому выглядят довольно мелко. Эту проблему мы решили введением шаблона [[Шаблон:Формула | Формула]]. Идея в том, чтобы окружить формулу тегом увеличения размера шрифта:

<syntaxhighlight lang=html4strict><span style="font-size:130%">$x + 2 = 4$</span></syntaxhighlight>

== Обновление MediaWiki ==

Сам процесс уже [http://www.mediawiki.org/wiki/Manual:Upgrading подробнейше описан], добавить нечего. Приведём лишь сюрпризы, ожидавшие нас при обновлении с 1.17 до 1.19.2. Конечно, скорее всего, их бы не было, если бы мы тщательней изучили документацию перед обновлением.

=== Логотип и иконка ===

Так как мы забыли, что размещённые по пути <code>skins/common/images/</code> [[#Установка логотипа | логотип]] и [[#Установка иконки | иконка]] сбросятся на дефолтные при обновлении, то они и сбросились. Пришлось заливать их обратно.

=== Запрет включения статей в категории шаблонов ===

Тег <code><nowiki><noinclude></nowiki></code>, препятствующий добавлению категории шаблона в статью, где он используется, перестал работать должным образом, и статьи с шаблонами моментально оказались в их категориях. Оказалось, что теперь "невключаемость" в категорию шаблона следует оформлять немного по-другому.

Как работало в 1.17:
<nowiki><noinclude>[[Категория:Преподаватели]]</noinclude></nowiki>

Как работает теперь в 1.19.2:
<nowiki><noinclude>:[[Категория:Преподаватели]]</noinclude></nowiki>

А через некоторое время стало работать и как раньше, потому мы вернули всё как было. Непонятно, что это случилось. Возможно, ненадолго сбилась категоризация, а после правок всё "перекатегоризировалось", так что, выходит, это двоеточие никак не влияло.

=== Выравнивание таблицы на странице ===

Конструкция, например, <code>align="right"</code> для выравнивая таблицы по правому краю страницы перестала обрабатываться, потому как за её обработку теперь вроде как отвечает CSS. В результате информационные таблицы, которые были удобно размещены справа, уехали влево.

Оказалось, что мы всё проспали: такой способ устарел и вообще считается плохой практикой в вёрстке. Вместо этого следует использовать следующее:

{| class="wikitable"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="float:left;"</code>
|- align="center"
| По правому краю || <code>style="float:right;"</code>
|- align="center"
| По центру || <code>style="margin:auto;"</code>
|}

== Важные мелочи ==

Небольшие, но важные советы:
* при создании шаблонов ни в коем случае не оставляйте пустых строк сверху (и снизу) конструкции <nowiki><noinclude></nowiki>. В противном случае пустая строка перенесётся в статью вместе с шаблоном и устроит там содомию.

[[Категория:WWW]]

MediaWiki - Настройка и расширения

2012-09-23T11:15:58Z

Penny: /* Использование TeX формул */

Статья посвящена всему тому, с чем нам пришлось столкнуться в процессе использования [http://www.mediawiki.org/ MediaWiki]. Такая своеобразная записная книжка.

Речь пойдёт об MediaWiki, размещённой на Linix-сервере. Подробнее о версиях установленного ПО можно узнать [[Служебная:Version | здесь]].

== Термины и сокращения ==

=== BPoD ===

Blank Page of Death (BPoD) - белая страница смерти, когда вместо страницы вики браузер выдаёт лишь пустую страницу, на которой нет вообще ничего. Причиной может быть:
* неверные настройки в файле <code>LocalSettings.php</code>;
* некорректно работающее свежеустановленное расширение.

=== Нулевая правка ===

Null edit - это если зайти в режим ''Правки'' страницы и тут же нажать ''Записать страницу'' (''Save page''), хотя изменений никаких внесено не было. Как бы ни казалось на первый взгляд, но это вовсе не бессмысленное действие.

Нулевая правка принуждает вики пересобрать страницу из исходников и показать её самую последнюю версию. Так вы можете быть уверены, что перед вами не версия из кэша, а актуальная версия страницы.

Также это вызывает сиюминутную категоризацию страницы. Это полезно, когда категория страницы была изменена одним из используемых ей шаблонов, потому как сама вики в этом случае обновит категорию страницы лишь через некоторое время.

== Настройка MediaWiki ==

В основном, вся проводится правкой файла <code>LocalSettings.php</code>. Он находится в корневой директории сайта.

=== Первичная настройка ===

==== Задание названия ====

В файле <code>LocalSettings.php</code> задать переменную:

<syntaxhighlight lang="php">$wgSitename = "Ваше название вики";</syntaxhighlight>

==== Установка логотипа ====

Логотип можно загрузить через интерфейс самой вики, но тогда он окажется доступным для изменения, потому лучше положить его в каталог к дефолтному: <code>skins/common/images/</code>. Однако, тогда при обновлении MediaWiki логотип сбросится вновь на дефолтный или вовсе не будет отображаться.

Логотип должен быть квадратным, с размерами 135x135. Чтобы он смотрелся аккуратно и не выделялся своим фоном на фоне страниц вики, нужно [[Прозрачный фон изображения | сделать ему прозрачный фон]].

После того, как логотип загружен на сервер, нужно задать следующую переменную в файле <code>LocalSettings.php</code>:

<syntaxhighlight lang="php">$wgLogo = "$wgStylePath/common/images/vashlogotip.gif";</syntaxhighlight>

==== Установка иконки ====

Иконка сайта отображается на вкладке браузера, благодаря чему его (сайт) проще отыскать в массе открытых вкладок.

Загружать иконку рекомундуется туда же, куда и [[#Установка логотипа | логотип]]. Размеры её должны быть 16x16, а формат - {{Википедия|ICO_(формат_файлов)|ICO}}. Так же можно [[Прозрачный фон изображения | сделать ей прозрачный фон]]. Так же следует помнить, что после обновления MediaWiki она может сброситься на дефолтную.

Имя рекомендуется использовать стандартное: <code>favicon.ico</code>.

После того, как иконка загружена на сервер, нужно задать следующую переменную в файле <code>LocalSettings.php</code>:

<syntaxhighlight lang="php">$wgFavicon = "$wgStylePath/common/images/favicon.ico";</syntaxhighlight>

==== Изменение навигационного блока ====

Навигационный блок, расположенный на левой части каждой страницы вики, можно изменять: удалять существующие пункты, добавлять свои. Делается это на спецстранице <code>вашавики.net/index.php/MediaWiki:Sidebar</code>

=== Разрешение загрузки изображений ===

Чтобы пользователи могли загружать изображения, а также для работы некоторых расширений необходимо внести в <code>LocalSettings.php</code> следующие изменения:

Разрешить загрузку файлов на сервер:

<syntaxhighlight lang="php">$wgEnableUploads = true;</syntaxhighlight>

Установить разрешённые расширения файлов:

<syntaxhighlight lang="php">$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'svg');</syntaxhighlight>

Также для работы некоторых расширений может потребоваться редактор изображений ImageMagick:

<syntaxhighlight lang="php">
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert"; # у вас может находиться в иной директории
</syntaxhighlight>

=== Изменение стиля wikitable ===

По умолчанию у класса таблиц <code>wikitable</code> ничтожно маленькое значение отступа от границ ячейки, из-за чего таблицы не радуют глаз. Для установки собственного значения отступа необходимо внести изменения в файл <code>skins\common\shared.css</code>. Скажем, <code>5px</code> будет достаточно:

<syntaxhighlight lang="php" highlight="10">
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;
}
</syntaxhighlight>

Если у вас другая версия MediaWiki, код класса может выглядеть иначе, но суть одна - нужно изменить значение параметра <code>padding</code>.

=== Установка счётчиков ===

Для установки счётчиков надо включить их код в код страниц вики, а точнее в код темы оформления (скина). Так как по умолчанию используется <code>Vector</code>, то рассмотрим на его примере.

Код счётчика лучше сохранить в файле с расширением <code>.php</code> и загрузить на сервер в каталог <code>skins</code>, после чего в файле темы оформления (<code>Vector.php</code>) надо будет включить в определённом месте имя этого файла. Не забывайте, что кодировка файла с кодом счётчика должна совпадать с кодировкой, используемой на вашем сайте, иначе вместо кириллицы будет отображаться кракозябра.

Счётчики могут отображать на странице свою пиктограммку с некоторыми данными, а могут не отображать. Но в обоих случаях они будут отправлять статистику посещений на свой сервер, где её можно будет подробно изучить.

Мы используем два счётчика: [http://metrika.yandex.ru/add/ Яндекс] и [http://www.liveinternet.ru/stat/ LiveInternet]. Код каждого сохранён соответственно в файлах <code>skins/counter_yandex.php</code> и <code>skins/counter_li.php</code>.

Для добавления счётчиков редактируем файл <code>skins/Vector.php</code>:

<syntaxhighlight line enclose="div" highlight=13,14 lang=php>

<div id="footer"<?php $this->html( 'userlangattributes' ) ?>>
<?php foreach( $this->getFooterLinks() as $category => $links ): ?>
<ul id="footer-<?php echo $category ?>">
<?php foreach( $links as $link ): ?>
<li id="footer-<?php echo $category ?>-<?php echo $link ?>"><?php $this->html( $link ) ?></li>
<?php endforeach; ?>
</ul>
<?php endforeach; ?>
<?php $footericons = $this->getFooterIcons("icononly");
if ( count( $footericons ) > 0 ): ?>
<ul id="footer-icons" class="noprint">
<li><?php include("counter_li.php"); ?></li> 
<li><?php include("counter_yandex.php"); ?></li> 
<?php foreach ( $footericons as $blockName => $footerIcons ): ?>
<li id="footer-<?php echo htmlspecialchars( $blockName ); ?>ico">
<?php foreach ( $footerIcons as $icon ): ?>
<?php echo $this->getSkin()->makeFooterIcon( $icon ); ?>

<?php endforeach; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
<div style="clear:both"></div>
</div>

</syntaxhighlight>

После этого счётчики заработают, и должны стать видны их пиктограммы. Если они не видны, то возможно их блокирует ваш браузер, его расширения или что-то ещё.

== Расширения MediaWiki ==

Они же ''extensions''. Позволяют расширить функционал вики. Например, добавить поддержку TeX формул и подсветку синтаксиса фрагментов исходного кода на том или ином языке программирования.

Устанавливаются все одинаково:
# загрузить архив с расширением:
# распаковать его в каталог <code>extensions</code> корневого каталога;
# в файле <code>LocalSettings.php</code> из корневого каталога вики добавить строку подключения расширения.

Выполнить эти операции можно как по FTP, так и [[Работа с Linux-сервером | через SSH]].

=== Подсветка синтаксиса ===

У нас используется [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi]. Установка ничем не примечательная, однако на версии MediaWiki 1.17 расширение работать отказывалось - браузер выдавал лишь [[#BPoD | белую страницу смерти]]. Из-за этого до обновления приходилось использовать [http://www.mediawiki.org/wiki/Extension:SyntaxHighlighter SyntaxHighlighter] - более скромное расширение, поддерживающее гораздо меньше языков, зато работающее. Но сейчас всё в порядке.

==== SyntaxHighlight GeSHi ====

Когда же после обновления MediaWIki удалось установить SyntaxHighlight GeSHi, то оказалось, что по умолчанию им используется довольно мелкий шрифт. По крайней мере, такое наблюдалось в Firefox, а Opera и IE отображали блоки кода с шрифтом нормальных размеров.

===== Правка MediaWiki:Geshi.css =====

Это не файл (в каталоге с расширением вы его не найдёте), а спецстраница вашей Вики: <code>вашавики.net/index.php/MediaWiki:Geshi.css</code>.

Изначально страница пустая, её необходимо создать. Всё, что здесь будет вноситься, будет дополнительно использоваться в стилях подсветки синтаксиса (расширение будет брать настройки отображения отсюда, в дополнение к своим).

Следующая конструкция управляет размером шрифта:

<syntaxhighlight lang="css">div.mw-geshi {
font-size: 15px
}</syntaxhighlight>

Однако, на нашей вики это эффекта не дало.

===== Правка SyntaxHighlight_GeSHi.class.php =====

Вот это уже действительно файл, который находится в каталоге самого расширения.

Нужно изменить строку:

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal;}";</syntaxhighlight>

следующим образом (добавить запись про размер шрифта):

<syntaxhighlight lang=php>$css[] = ".source-$lang {line-height: normal; font-size: 12px;}";</syntaxhighlight>

После этого блоки с кодом стали отображаться удобочитаемыми и вообще радующими глаз.

=== Использование TeX формул ===

Так как мы технари, то нам просто необходима поддержка {{Формула|f=\TeX}}. Любые "псевдоформулы" набранные доступными с клавиатуры символами покрыли бы нас несмываемым позором. Потому за корректную работу расширения, обеспечивающего поддержку {{Формула|f=\TeX}} разметки, нужно было бороться до конца.

==== Math ====

Начали мы с расширения [http://www.mediawiki.org/wiki/Extension:Math Math]. Тогда у нас стояла MediaWiki 1.17, и оно уже было включено в её состав. Располагалось оно не в обычном каталоге для расширений, а прямо в корневой директории сайта (каталог <code>math</code>).

Для работы расширения на сервере должны быть установлены пакеты <code>latex</code> и <code>dvips</code>. Если хостер отказывает в установке этих пакетов на сервере, то просите установить их в вашу домашнюю директорию, в ущерб выделенному вам на сервере дисковому пространству, или же меняйте хостера.

Итак, в каталоге с расширением лежат готовые к сборке исходники утилиты <code>texvc</code>. Нужно [[Работа с Linux-сервером | зайти в этот каталог и выполнить команду]] <code>make</code>. Однако, если вы проделываете это не на своём сервере (и прав на выполнение этой команды у вас нет), то об этом нужно попросить вашего хостера, обратившись в его техподдержку.

Затем создайте следующие каталоги и [[Работа с Linux-сервером | назначьте им права 755]]:
* <code>images/math</code>;
* <code>images/tmp</code>.

Далее необходимо задать следующие три переменных в файле настроек <code>LocalSettings.php</code>:

<syntaxhighlight lang=php>$wgUseTeX = "true";
$wgMathDirectory = "images/math";
$wgTmpDirectory = "images/tmp";</syntaxhighlight>

Также должна быть [[#Разрешение загрузки изображений | разрешена загрузка изображений]].

После этого вики будет способна обрабатывать {{Формула|f=\TeX}} формулы, заключённые в теге <nowiki><math></math></nowiki>. Вкратце обработка происходит следующим образом: <code>latex</code> обрабатывает формулу, заключённую в теге <nowiki><math></math></nowiki>, <code>ImageMagic</code> создаёт из этого картинку и помещает её на страницу. Таким образом, готовые формулы представляют собой растровые изображения.

Однако, простые формулы, вроде x + 2 = 4, вики по умолчанию отображает текстом, отчего они выглядят не как "картиночные". За это отвечает переменная в настройках внешнего вида вики для каждого зарегистрированного пользователя, но можно задать её по умолчанию для всех. Для этого надо изменить в <code>LocalSettings.php</code> следующую переменную:

<syntaxhighlight lang=php>$wgDefaultUserOptions['math'] = 0;</syntaxhighlight>

==== MathJax ====

После обновления MediaWiki до версии 1.19.2 расширение [http://www.mediawiki.org/wiki/Extension:Math Math] работать перестало. Восстановить его работу не удалось. Мы стали искать альтернативу и нашли не просто альтернативу, а прекрасное расширение [http://www.mediawiki.org/wiki/Extension:MathJax MathJax].

Самым главным его отличием является то, что оно не использует (соответственно, и не требует) наличия на сервере пакетов <code>latex</code> и <code>dvips</code>, и итоговые формулы являются не растровыми изображениями, а векторными объектами, которые можно сколь угодно масштабировать без потери качества их отображения на странице.

Устанавливается расширение [[#Расширения MediaWiki | стандартно]].

Для обработки формул помимо стандартного тега <nowiki><math></math></nowiki> можно (и удобнее) использовать родные символы <nowiki>$$</nowiki> из {{Формула|f=\TeX}}.

Единственное что - формулы отображаются с тем размером шрифта, в окружении какого они используются, и потому выглядят довольно мелко. Эту проблему мы решили введением шаблона [[Шаблон:Формула | Формула]]. Идея в том, чтобы окружить формулу тегом увеличения размера шрифта:

<syntaxhighlight lang=html4strict><span style="font-size:130%">$x + 2 = 4$</span></syntaxhighlight>

== Обновление MediaWiki ==

Сам процесс уже [http://www.mediawiki.org/wiki/Manual:Upgrading подробнейше описан], добавить нечего. Приведём лишь сюрпризы, ожидавшие нас при обновлении с 1.17 до 1.19.2. Конечно, скорее всего, их бы не было, если бы мы тщательней изучили документацию перед обновлением.

=== Логотип и иконка ===

Так как мы забыли, что размещённые по пути <code>skins/common/images/</code> [[#Установка логотипа | логотип]] и [[#Установка иконки | иконка]] сбросятся на дефолтные при обновлении, то они и сбросились. Пришлось заливать их обратно.

=== Запрет включения статей в категории шаблонов ===

Тег <code><nowiki><noinclude></nowiki></code>, препятствующий добавлению категории шаблона в статью, где он используется, перестал работать должным образом, и статьи с шаблонами моментально оказались в их категориях. Оказалось, что теперь "невключаемость" в категорию шаблона следует оформлять немного по-другому.

Как работало в 1.17:
<nowiki><noinclude>[[Категория:Преподаватели]]</noinclude></nowiki>

Как работает теперь в 1.19.2:
<nowiki><noinclude>:[[Категория:Преподаватели]]</noinclude></nowiki>

А через некоторое время стало работать и как раньше, потому мы вернули всё как было. Непонятно, что это случилось. Возможно, ненадолго сбилась категоризация, а после правок всё "перекатегоризировалось", так что, выходит, это двоеточие никак не влияло.

=== Выравнивание таблицы на странице ===

Конструкция, например, <code>align="right"</code> для выравнивая таблицы по правому краю страницы перестала обрабатываться, потому как за её обработку теперь вроде как отвечает CSS. В результате информационные таблицы, которые были удобно размещены справа, уехали влево.

Оказалось, что мы всё проспали: такой способ устарел и вообще считается плохой практикой в вёрстке. Вместо этого следует использовать следующее:

{| class="wikitable"
! Тип выравнивания !! Код разметки
|- align="center"
| По левому краю || <code>style="float:left;"</code>
|- align="center"
| По правому краю || <code>style="float:right;"</code>
|- align="center"
| По центру || <code>style="margin:auto;"</code>
|}

== Важные мелочи ==

Небольшие, но важные советы:
* при создании шаблонов ни в коем случае не оставляйте пустых строк сверху (и снизу) конструкции <nowiki><noinclude></nowiki>. В противном случае пустая строка перенесётся в статью вместе с шаблоном и устроит там содомию.

[[Категория:WWW]]

MediaWiki - Настройка и расширения

2012-09-23T10:48:59Z

Penny: /* Установка счётчиков */

MediaWiki - Настройка и расширения

2012-09-23T10:48:18Z

Penny: /* Установка счётчиков */

MediaWiki - Настройка и расширения

2012-09-23T10:47:48Z

Penny: /* Установка счётчиков */

MediaWiki - Настройка и расширения

2012-09-23T10:45:39Z

Penny: /* Установка счётчиков */