Заметки про MediaWiki #1
Плагины
Плагины (Extentions) - позволяют добавить движку какой-либо дополнительный функционал. Например возможность встраивания в статьи видео с youtube-а. Для установки этого плагина необходимо:
- Закинуть файл (или папку с файлами, что реже) в директорию /extensions
- Открыть файл LocalSettings.php и добавить в конец require_once("$IP/extensions/YouTube.php"); где в скобках указывается главный файл плагина
В случае youtube плагина, видео можно встроить в статью просто применив конструкцию <youtube>ссылка на ролик</youtube> в своей статье. Есть и более функциональные плагины для этой цели, которые поддерживают сразу несколько видео-хостингов, да и к тому же позволяют менять размер встраиваемого объекта, но в моём случае они почему то взбунтовались... В прочем это отдельная история. Рекомендую также установить плагин ParserFunctions, он понадобиться вам для написания шаблонов (мини-программирование), и Cite, который позволит легко и красиво организовать список сносок, разбрасывая их посреди статьи.
Шаблоны
Шаблоны — это такие же страницы, как и обычные статьи, но в отличие от последних, могут быть использованы как внешняя процедура, которой можно передать параметры. По ссылке неплохое руководство по их созданию и применению (хотя, стоит отметить, далеко не полное). Очень удобная штука, позволит вам систематизировать и одинаково оформить похожие элементы информации или организовать статью как сборную солярку. Например в качестве шаблона может выступать табличка для показа параметров города или игры. Вот небольшой пример. Нажмите просмотр чтобы увидеть его код. В нём используются шаблон условия {{#if}}, который отсутствует в базовой комплектации, но необходим для задания хотя бы элементарной логики. Его и многое другое добавляет в вики плагин ParserFunctions. Думаю нет особого резона расписывать здесь то же, что вы можете найти в статье. Однако вам наверняка пригодиться это - {{:название_статьи}}. Именно таким образом можно встроить в одну статью содержимое другой. На пару с шаблонами можно организовать какую никакую динамичную главную страницу.
Панель редактирования статьей
Думаю многих не устраивает стандартная панель редактирования статей в mediawiki. Мягко говоря, она убога и даже близко не покрывает возможности базовой сборки движка. Да и к тому же оформление просто туши свет. С него и начну. Я несколько изменил стандартные кнопки, скачать их можно здесь.
На мой взгляд они получились более скромными и понятными. Хотя о вкусах не спорят конечно. В архиве есть и нестандартные кнопки, о которых речь пойдёт позднее. Почти все изображения кнопок хранятся в папке /common/images, размер (23х22) к сожалению без бубна изменить нельзя, да и не особо нужно.
Так как же добавить новые кнопки? Если вас устроит простая подстановка, то достаточно открыть файл /skins/common/edit.js и добавить туда следующую функцию:
function addInsertButton(img, speedTip, tagOpen, tagClose, sampleText) {
mwCustomEditButtons[mwCustomEditButtons.length] =
{
'imageFile': '/skins/common/images/' + img,
'speedTip': speedTip,
'tagOpen': tagOpen,
'tagClose': tagClose,
'sampleText': sampleText
};
}
- img — рисунок, загрузите его в папку /skins/common/images/ и назовите (желательно) button_а_тут_по_смыслу.png (ну или .gif)
- speedTip — всплывающая подсказка кнопки
- tagOpen и tagClose — встраиваемые куски текста слева и справа от курсора (или выделенного текста)
- sampleText — в случае, если никакой текст не выделен, указанное здесь значение подставится между tagOpen и tagClose
Вот примеры готовых кнопок:
addInsertButton('button_redirect.png','Перенаправление','#Перенаправление [[',']]','');
addInsertButton('button_category.png','Категория','[[Категория:',']]','');
addInsertButton('inner_link_separated.png','Внутренняя ссылка','[[','|]]','');
addInsertButton(«button_flag.png„,'Флаг','{{Флаг|','|}}' ,'');
addInsertButton('button-dash.png','Тире','—','','');
addInsertButton('button_quotes.png','Кавычки','„','»','');
addInsertButton(«button_comment.png»,'Комментарий','<!--','-->' ,'');
addInsertButton(«button_youtube.png»,'Видео с youtube','<youtube>','</youtube>' ,'');
addInsertButton(«button_gallery.png»,'Галерея','<gallery>\nИзображение:|',
'\nИзображение:|\nИзображение:|\nИзображение:|\n</gallery>' ,'');
addInsertButton(«button_footnote.png»,'Сноска','<ref>[',']</ref>' ,'');
addInsertButton(«button_footnote_sector.png»,'Список сносок','<references/>','','');