Rozcestník pro vývojáře

• Uživatelé
• Správci wikiserverů
• Vývojáři
• Překladatelé

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

• Pokud chcete používat webová rozhraní Wikimedie, navštivte API:Web APIs hub (nedokončená práce).
• Chcete-li přispět k vývoji software Wikimedie, podívejte se na Noví vývojáři .
• Úvodního průvodce vývojem MediaWiki a rozšíření MediaWiki najdete na stránce Jak se stát vývojářem MediaWiki .
• Pokud chcete spolupracovat s dalšími uživateli MediaWiki třetích stran, potom MediaWiki Stakeholders' Group (MWStake) je uživatelská skupina MediaWiki sestávající z vývojářů MediaWiki, správců systému, uživatelů, konzultantů a poskytovatelů hostingu.

Přehled

MediaWiki je software, na kterém běží Wikipedie, její sesterské projekty a tisíce dalších wiki po celém světě.

MediaWiki je napsána v programovacím jazyce PHP. Jako knihovnu JavaScriptu používá jQuery.

MediaWiki je primárně psána pro platformu LAMP a běží na většině operačních systémů. MediaWiki primárně používá databázové servery MySQL a MariaDB.

Vývoj probíhá ve stylu otevřeného zdroje . Je do značné míry koordinován online a je podporován nadací Wikimedia Foundation. I když vývojáři dobrovolnických komunit hrají také velkou roli.

• Diskuse o vývoji se děje na různých mailing listech a IRC kanálech. Hlavní seznam vývojářů je na stránce wikitech-l. Hlavní kanál IRC pro vývojáře je na stránce #mediawiki ^{připojit se}.
• Zdrojový kód je řízen pomocí řídicího systému verze Git.
• Kontrola kódu se pro většinu projektů provádí na Gerrit u. Postupujte podle tohoto návodu a nastavte si Git a Gerrit pro zasílání oprav.
• Hlášení chyb a úkoly pro většinu projektů jsou spravovány na Phabricator u.
• Vývojáři rozšiření nebo propojení s MediaWiki (místo práce na základním kódu) mají několik výhodných bodů rozšíření, včetně API, systém háčků a zobrazení – přehled naleznete v části #Extending MediaWiki na této stránce.

Klíčové dokumenty

Kód, jeho vývoj a konvence

• Development policy – přehled základních pravidel pro vývojáře.
• Konvence pro psaní kódu vás seznámí s tím, jak má vypadat kód pro MediaWiki.
• Security for developers – vám pomůže napsat kód, který do MediaWiki nezavleče bezpečnostní díry.
• Manual:Pre-commit checklist – před potvrzením kódu si přečtěte tento kontrolní seznam.
• Kontrola kódu v Gerritu – základní průvodce pro kontrolory změn před jejich odesláním do zdrojového kódu MediaWiki.
• Technical Decision Making Process – přečtěte si o postupu a rozhodněte se o provedení větších technických změn.

Testování a odstraňování chyb

• Jak odstraňovat chyby – návod k vychytávání chyb v MediaWiki.
• Manual:Errors and symptoms – přehled běžných chyb a jejich příznaků vyskytujících se na MediaWiki.
• Testování prohlížečů – naučte se psát testy UI pro MediaWiki s použitím Selenia
• Testování jednotky – naučí vás jak psát unit testy pro MediaWiki s využitím PHPUnitu.
• Testy integrace API – naučí vás psát testy API integrace pro MediaWiki pomocí Mocha.
• Security for developers – naučí vás jak psát bezpečný kód.

Architektura

• MediaWiki architecture – úvod do architektury MediaWiki.
• Návod: Kód – přehled klíčových funkcí a proměnných, s nimiž se můžete setkat ve zdrojovém kódu MediaWiki.
• Příručka:Databázové schéma – přehled databázových schémat s nimiž pracuje MediaWiki.
• Návod:Objekty v globálních proměnných – seznam vybraných klíčových globálních proměnných.
• Lokalizace – vás seznámí s tím jak funguje internacionalizace u MediaWiki.
• Návod je jmenný prostor na této wiki – dokumentace pro vývojáře.
• Reference třídy MediaWiki (MediaWiki Class Reference) – technická dokumentace, generovaná přímo ze zdrojového kódu MediaWiki. (Poznámka: Vzájemné reference tříd (class) jsou poměrně komplikované, takže se tyto stránky mohou načítat velmi pomalu.)

Subsystémy

• API – API MediaWiki umožňuje přímý přístup k datům uloženým v databázích MediaWiki, na té nejvyšší úrovni.
• ContentHandler – je MediaWiki framework, který umožňuje obsah wiki stránky interpretovat různým způsobem podle typu obsahu.
• Příručka:Přístup k databázi – přehled využití databází MediaWiki, včetně stručného průvodce, který vás provede, jak s nimi pracovat.
• Příručka:Fronta úloh – MediaWiki framework pro asynchronní zpracovávání náročných úloh.
• Messages API – MediaWiki framework pro lokalizaci zpráv v PHP či JavaScriptu.

Doplňky do MediaWiki

MediaWiki byla navržena tak, aby ji bylo možno přizpůsobit beze změn "kódu jádra". Tím je zajištěno, ž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 webového API.
• Návod:Háčky (hooks) – umožňují něco provést vždy, když se zavolají.
• Návod:Parsovací funkce – vytvoří nový příkaz, například: {{#if:...|...|...}}.
• Zobrazení – mění vzhled a chování uživatelského rozhraní MediaWiki.
• Návod:Speciální stránky – přidá novou speciální stránku.
• Návod:Rozšíření značek (tagů) – vytvoří nový tag, například: ‎<newtag>...‎</newtag>.
• Extending wiki markup – přidá k parseru nový háček, kterým lze upravit obsah wikitextu.

Nápověda pro vývojáře rozšíření

• Příručka:Vývoj rozšíření – průvodce vývojem rozšíření.
• Extensions FAQ
• Seznam rozšíření naleznete na stránce Kategorie:Rozšíření .
• Extension:BoilerPlate - prázdná šablona rozšíření.

Nápověda pro tvorbu témat

• Příručka:Jak vytvořit vzhled MediaWiki – postup jak vytvořit zobrazení pro MediaWiki.
• Příručka:konfigurace zobrazení – průvodce konfigurací zobrazení pro wiki.

Nápověda pro přebírání kódu knihoven

• Manual:Developing libraries – návod jak zabalit knihovny třetích stran pro použití v MediaWiki

Použití wiki třetí strany

• Enterprise hub — pro podnikové wiki
• Akademické centrum — Pro akademické wiki