Developer hub/ru



Это общий обзор материалов о разработке MediaWiki, включающий ссылки на основные документы, ресурсы и инструменты для разработчиков MediaWiki. Они ориентированы на квалифицированных разработчиков LAMP, имеющих опыт использования MediaWiki.

Вводное руководство по разработке MediaWiki можно почерпнуть на странице «Как стать хакером MediaWiki» (eng.).

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

Обзор
MediaWiki разрабатывается в стиле открытого ПО с использованием языка программирования PHP в первую очередь для платформы LAMP. Разработка ядра в основном координируется в онлайне.


 * Обсуждения разработки происходят в различных почтовых рассылках и IRC-каналы. Основной список рассылки разработчиков — это wikitech-l. Основной IRC-канал разработчиков — это #mediawiki. Ознакомьтесь со списком разработчиков, чтобы понять, что за люди участвуют в этих списках рассылки и IRC-каналах.


 * Управление исходным кодом осуществляется посредством системы контроля версий Git. Прочтите статьи Git и Git/Tutorial (eng.) с обзором того, как разработчики MediaWiki используют эту систему. Прочтите также статью labsconsole Help:Access (eng.) если хотите получить доступ.


 * Проверка кода выполняется с помощью Gerrit, см. все подробности на странице this workflow (eng.).


 * Разработчикам расширений и интерфейса MediaWiki (в отличие от работающих над кодом ядра), предоставляется несколько удобных точек расширения, в том числе API, система обработчиков (Hooks) и стилей или «шкурок» оформления (Skins) — см. обзор в разделе на этой странице.

Основные документы


Код, разработка и стиль

 * Принципы разработки (eng.) — обзор основных правил разработки.


 * Соглашения по кодированию (eng.) — о том, как научиться писать код PHP в стиле MediaWiki.


 * Вопросы безопасности для разработчиков (eng.) — о том, как сохранять безопасность MediaWiki.


 * Контрольный список проверок кода перед отправкой (eng.) — изучите этот контрольный список перед отправкой кода.


 * Руководство по проверке кода (eng.) — руководство по анализу дополнений к исходному коду MediaWiki.


 * Запросы комментариев (Requests for Comment, RfC) — прочесть о новых функциях и возможностях экосистемы MediaWiki или предложить свои идеи.

Отладка и тестирование

 * Bugs/ru — обзор процедуры отслеживания ошибок в проекте MediaWiki.


 * Как выполнять отладку (eng.) — руководство по отладке MediaWiki.


 * Manual:Errors and Symptoms (eng.) — обзор типичных ошибок MediaWiki и соответствующих им симптомов.


 * Selenium Framework (eng.) — о том, как научиться писать UI-тесты для MediaWiki, используя Selenium.


 * Юнит-тесты (eng.) — о том, ка научиться писать юнит-тесты для MediaWiki, используя PHPUnit.


 * Безопасность (eng.) — вопросы безопасности, о которых приходят сообщения на [mailto:security@wikimedia.org security@wikimedia.org].



Архитектура

 * Manual:Code/ru — обзор основных частей исходного кода MediaWiki.


 * Формат базы данных (eng.) — обзор схемы БД MediaWiki.


 * Объекты, определяемые глобальными переменными (eng.) — неполный список основных глобальных переменных.


 * Локализация (eng.) — для изучения системы интернационализации MediaWiki.


 * Manual (eng.) — пространство имён в этой вики, где располагается документация для разработчиков.


 * Документация к классам MediaWiki (MediaWiki Class Reference) (eng.) — автоматически генерируемая техническая документация на классы и другие функции, используемые в MediaWiki. (Замечание: Документация классов весьма обширна, так что страницы могут загружаться довольно медленно.)


 * MediaWiki Virtual Library (eng.) — справочники. руководства, коллекция избранных статей.

Подсистемы

 * API – внешнее API MediaWiki обеспечивает прямой высокоуровневый доступ к данным, содержащимся в БД MediaWiki.


 * ContentHandler – MediaWiki's framework for supporting custom types of page content.


 * Доступ к данным (eng.) — обзор использования БД в MediaWiki, включая краткое руководство по работе на уровне абстракции БД (database abstraction layer).


 * Очередь заданий — специальный компонент MediaWiki's для асинхронного выполнения долгоиграющих задач.


 * API для сообщений — компонента MediaWiki для предоставления локализованных сообщений движка в PHP или JavaScript.

Расширение MediaWiki
MediaWiki была спроектирована так, чтобы позволить вносить изменения без изменения основного кода. Это облегчает обновление при переходе на новую версию MediaWiki, так как исчезает необходимость при обновлении вручную править код существующих модулей расширения, заново приводя их в соответствие с основным кодом. Предусмотрено 5 основных способов, позволяющих разработчикам MediaWiki добавлять новые возможности, а также изменять существующие. Способы расширения следующие:


 * API — доступ к данным и метаданным конкретной инсталляции MediaWiki через высокопроизводительное веб-API.


 * Перехваты — каждый раз, когда нужно сделать нечто...


 * Функции парсера — создание новой команды наподобие:


 * Шкурки («скины») — изменение стиля оформления MediaWiki.


 * Служебные страницы — добавление новой служебной страницы.


 * Расширения тэгов — создание нового тэга наподобие:

Помощь создателям расширений

 * Manual:Developing extensions — руководство по разработке расширений.
 * Project:WikiProject Extensions
 * Extensions FAQ
 * Матрица расширений — автоматически генерируемый список расширений. См. также Category:Extensions, менее полный перечень существующих расширений.
 * Manual:$wgExtensionFunctions – use to defer setup (or run other callbacks) for extensions until after the MediaWiki core is setup.
 * Extension:BoilerPlate - пустое расширение шаблона

Помощь разработчикам стилей оформления

 * Manual:Skinning/ru — инструкции по созданию стилей оформления MediaWiki.
 * Manual:Skin configuration — руководство по настройке стилей оформления вики.

Использование собственных вики

 * Enterprise hub — для корпоративных вики
 * Academic hub — для учебных вики