Rozcestník pro vývojáře

UživateléUser hub

Správci wikiserverůSysadmin hub

VývojářiDeveloper hub

Toto je vysokoúrovňový přehled vývoje MediaWiki, obsahující odkazy na klíčové dokumenty, zdroje a nástroje dostupné vývojářům MediaWiki. Je vytvořena pro zkušené LAMP vývojáře, kteří mají zkušenosti s používáním MediaWiki.

• Pokud chcete použít Wikimedia web APIs, navštivte Web APIs hub
• Úvodního průvodce vývojem MediaWiki najdete na stránce how to become a MediaWiki hacker.
• Pokud potřebujete pomoc s instalací či nastavením MediaWiki, vizte Rozcestník pro správce wikiserverůSysadmin hub.
• Pomoc s používáním MediaWiki najdete na Uživatelský rozcestníkUser hub.

Přehled

MediaWiki is developed in an open source style using the PHP programming language primarily for the LAMP platform. Core development is largely coordinated online.

• Development discussion happens on various mailing lists and IRC channels. The main developer list is wikitech-l. The main developer IRC channels are #mediawiki and #wikimedia-dev. Read the Developers article to get a sense for who the people on the mailing lists and IRC channels are.
• Source code is managed using the Git revision control system. Read the Git article for an overview of how the MediaWiki developers use Git. Read the wikitech:Help:Access#Access FAQ article if you'd like access.
• Code review is performed on GerritGerrit, see this tutorial to get set up with git and gerrit in order to submit patches.
• Developers extending or interfacing with MediaWiki (instead of working on the core code) have several convenient extension points, including the API, the Hooks system and Skins – see the #Extending MediaWiki section of this page for an overview.

Klíčové dokumenty

Code, development and style

• Development policy – an overview of key development policies.
• Coding conventions – learn how to write code in the MediaWiki style.
• Security for developers – learn how to help keep MediaWiki secure.
• Pre-commit checklist – read this checklist before committing code.
• Code review guide – a guide for reviewers of commits to the MediaWiki source code.
• Requests for Comment (RfC) – read about or suggest new features for the MediaWiki ecosystem

Debugging and testing

• PhabricatorPhabricator – an overview of bug tracking in the MediaWiki project.
• How to debug – a guide to debugging MediaWiki.
• Manual:Errors and symptoms – an overview of common MediaWiki errors and their correlating symptoms.
• Browser testingQuality Assurance/Browser testing – learn to write UI tests for MediaWiki using Selenium.
• Unit testing – learn to write unit tests for MediaWiki using PHPUnit.
• SecuritySecurity – security issues are reported to security@wikimedia.org.

Architecture

• Manual:Code – an overview of the key parts of MediaWiki's source code.
• Database layout – an overview of MediaWiki's database schemas.
• Global object variables – a partial list of key global variables.
• Localisation – Technický popis internacionalizačních vlastností MediaWiki
• Manuál na wiki – dokumentace pro vývojáře
• MediaWiki Class Reference – technical documentation generated from the MediaWiki source code. (Note: The class reference is a large, slow-to-load page.)
• MediaWiki Virtual Library (MVL)Category:MediaWiki Virtual Library (MVL) – manuals, guides, collections of selected articles.

Subsystémy

• API – API MediaWiki pro přímý přístup s vysokými oprávněními k datové vrstvě v MediaWiki databázích
• ContentHandler – MediaWiki's framework for supporting custom types of page content.
• Database accessManual:Database access – an overview of using databases in MediaWiki, including a brief guide to the database abstraction layer.
• Job queueManual:Job queue – MediaWiki's framework for processing long-running tasks asynchronously.
• Messages APIManual:Messages API – MediaWiki's framework for providing localized application messages with PHP or JavaScript.

Doplňky do MediaWiki

MediaWiki bylo navrženo tak, aby je bylo možno přizpůsobit bez změn „kódu jádra“. To zajišťuje, že lze upgradovat na novější verzi bez potřeby slučovat uživatelské úpravy do nové verze. V MediaWiki existuje šest hlavních bodů, kde mohou vývojáři přidávat nové funkce nebo měnit stávající vlastnosti. Těmito body jsou:

• API – Přístup k datům a metadatům v instanci MediaWiki prostřednictvím silného webového API.
• Hooks – Zajistí, že se něco provede pokaždé, když…
• Parser Functions – Vytvoří nový příkaz, např. {{#if|...|...|...}}
• Skins – Změní vzhled a chování uživatelského rozhraní MediaWiki.
• Special Pages – Přidá novou speciální stránku
• Tag Extensions – create a new tag like: <newtag>...</newtag>

Nápověda pro tvůrce doplňků

• Manual:Developing extensions – a guide to developing extensions.
• Project:WikiProject Extensions
• Extensions FAQ
• See Category:Extensions, for a list of extensions.
• Manual:$wgExtensionFunctions – use to defer setup (or run other callbacks) for extensions until after the MediaWiki core is setup.
• Extension:BoilerPlate - a blank extension template

Help for skin developers

• Manual:Skinning Part 1 – instructions on how to create a skin for MediaWiki.
• Manual:Skin configuration – a guide to configuring skins for a wiki.

Help for library code reuse

• Manual:Developing librariesManual:Developing libraries – a guide to packaging third-party libraries for use with MediaWiki

Third-party wiki uses

• Enterprise hubEnterprise hub - For Enterprise wikis
• Academic hubAcademic hub - For Academic wikis