How to become a MediaWiki hacker/cs

Tento článek je napsán, aby pomohl vývojářům naučit se základní dovednosti potřebné k tomu, aby přispěli k vývoji jádra MediaWiki a rozšíření MediaWiki.

Hlavní cestou, jak začít s vývojem Wikimedie, je přispívat do projektů Wikimedie, které nabízejí mentoring. Alternativou bez mentoringu je opravit dobře první chybu.

Pokud jste zkušený vývojář, který už je obeznámen s používáním MediaWiki, navštivte místo toho .

Další způsoby, jak se zapojit do komunity Wikimedie, najdete na stránce .

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

Přestože je MediaWiki napsána v PHP programovacím jazyce, některé podpůrné nástroje jsou napsány v jiných jazycích, včetně dávkových souborů, shell skriptů, makefiles a Python. Jako klientskou knihovnu JavaScript 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 nebo 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 probíhá na různých emailových konferencích a IRC kanálech. Hlavní seznam vývojářů je wikitech-l. Hlavní vývojářské IRC kanály jsou a.
 * Zdrojový kód je uložen na a spravován pomocí systému kontroly revizí Git a lze jej zobrazit zde
 * Recenze kódu se provádí na a lze ji zobrazit zde. Postupujte podle tohoto návodu a nastavte Git a Gerrit za účelem odesílání záplat.
 * Hlášení o chybách se ukládají a projekty jsou koordinovány na a lze je zobrazit zde

Tato stránka by vám měla pomoci stát se přispěvatelem do MediaWiki. Není to návod. Jen vás nasměruje na různá místa, kde se můžete naučit, co je potřeba.



Nastavte si vývojové prostředí
You can install and develop MediaWiki on Linux, Windows, or macOS using any of the three solutions below.

Většina projektů používá Git a Gerrit. Postupujte podle návodu Gerritu a nastavte si svůj vývojářský účet. Poté můžete přejít ke stažení našeho kódu, provádění změn, jejich testování a odesílání oprav. Existují dva způsoby, jak nastavit vývojové prostředí: Pomocí předkonfigurovaného nastavení virtuálního stroje (Docker nebo Vagrant) nebo pomocí ruční konfigurace.

Vývojové prostředí Docker

 * MediaWiki Docker – spusťte MediaWiki pomocí Dockeru (lze použít na hostitelích Linux, Windows nebo macOS).

Generally this method is recommanded, and it's come with the MediaWiki repository. However, it can be very slow on Windows if you are using WSL2 based engine, due to the poor performance of its shared directory implementation. You can switch to the Hyper-V backend on the setting of Docker Desktop for better filesystem performance.

You can also try the experimental mwcli tool which provides basic orchestration functionality for MediaWiki docker containers.

Virtuální stroj s Vagrantem

 * MediaWiki Vagrant – Run MediaWiki on a Linux virtual machine using Vagrant.

Vagrant allows you start a MediaWiki instance you can develop as well as allowing you to add and develop any of 250+ extensions - all with a single command. This saves you installation and configuration time compared to manually installing but has the downside of running slower. You may also experience shared directory performance issues if you are using VirtualBox.



Ruční instalace
MediaWiki can be developed by installing it natively on your system and editing its code. Installing it natively means it will run the fastest, but will take more time to configure than Docker or Vagrant.


 * 1)  — Check hardware requirements and install dependencies
 * 2)  — stáhněte si nejnovější zdrojový kód z Gitu.
 * 3)  — pokračujte v instalaci a počáteční konfiguraci.
 * 4) * Nastavte ve svém prostředí různé režimy ladění, aby se varování a chyby zobrazovaly včas.



PHP
MediaWiki je napsána v PHP, takže se budete muset seznámit s PHP, abyste mohli hacknout jádro MediaWiki.


 * Naučte se PHP
 * Návod PHP — Dostupný v mnoha různých jazycích. Pokud nemáte žádné znalosti PHP, ale umíte programovat v jiných objektově orientovaných programovacích jazycích, PHP se snadno naučíte.
 * PHP Programming at Wikibooks.
 * PHP at Wikiversity.


 * Zdroje PHP:
 * Příručka PHP — Dostupná v mnoha různých jazycích.
 * Konvence kódování PHP v rámci komunity MediaWiki.


 * Poznání:
 * Skript  v MediaWiki poskytuje základní interpret PHP s načtenými objekty a třídami MediaWiki.
 * Skript  v MediaWiki také nahrazuje skript   založený na PsySH, viz

Databáze
Mnoho funkcí vyžaduje určité množství manipulace s databází, takže často budete muset znát MySQL/MariaDB.


 * Naučte se MySQL/MariaDB
 * Návod MySQL — Z referenční příručky MySQL.
 * MySQL at Wikibooks.


 * Zdroje MySQL/MariaDB
 * Referenční příručka MySQL — Dostupná v mnoha různých jazycích.
 * Databáze znalostí MariaDB
 * Konvence kódování databáze v rámci komunity MediaWiki.


 * Poznání:
 * Otestujte svůj kód pomocí MySQL/MariaDB.
 * MediaWiki v současné době používá MySQL a MariaDB jako primární back-end databáze. Podporuje také další DBMS, jako je PostgreSQL a SQLite. Téměř všichni vývojáři však používají MySQL/MariaDB a netestují jiné databáze, které se následně pravidelně porušují. Proto se doporučuje při testování oprav používat MySQL/MariaDB, pokud se konkrétně nesnažíte zlepšit podporu pro jinou DB. V druhém případě se ujistěte, že jste opatrní, abyste nerozbili MySQL/MariaDB (nebo v ní nepsali dotazy, které jsou strašně neefektivní), protože MySQL/MariaDB používají všichni ostatní.



JavaScript a CSS
JavaScript a CSS se staly v kódu front-endu všudypřítomné. Abyste mohli pracovat na MediaWiki, musíte znát JavaScript, jQuery a CSS, ale možná je budete potřebovat, v závislosti na tom, na čem se rozhodnete pracovat.


 * Naučte se JavaScript a CSS
 * JavaScript and CSS at Wikibooks.
 * Začínáme s jQuery — Výukový program jQuery.
 * Learning JavaScript — references and sources.


 * Zdroje JavaScriptu a CSS
 * Konvence kódování JavaScriptu v rámci komunity MediaWiki.
 * Konvence kódování CSS v rámci komunity MediaWiki.

MediaWiki
Základ kódu MediaWiki je velký a některé části jsou nevzhledné. Nenech se tím zahltit. Když začínáte, snažte se napsat funkce nebo opravit chyby, které se dotýkají pouze malé oblasti kódu.


 * Základy MediaWiki a povinné čtení:
 *  — Přehled hlavních komponent MediaWiki na vysoké úrovni a jejich vzájemné spolupráce.
 *  — Přehled toho, proč a jak psát bezpečný kód.


 * Zdroje MediaWiki:
 * — Seznam důležitých souborů a odkazy na podrobnější informace.
 * — Seznam háčků. Pokud se snažíte zjistit, která část kódové základny něco dělá, často je dobré začít hledáním souvisejících háčků.
 * — Přehled obecných konvencí kódování v rámci komunity MediaWiki.


 * Dokumentace kódu (odkaz na třídu) — Automaticky generovaná dokumentace z kódu a komentářů ke kódu.
 * — Průvodce laděním MediaWiki.
 * — Nástroj pro živou interakci s objekty MediaWiki.



Rozšíření MediaWiki
Pokud se rozhodnete pracovat s kódem rozšíření MediaWiki, další informace poskytnou následující odkazy.


 * Základy rozšíření MediaWiki:
 * Vývoj rozšíření — Jak napsat rozšíření pro MediaWiki.
 * Výukový program pro psaní rozšíření


 * Zdroje rozšíření MediaWiki:
 * Doporučené postupy pro rozšíření
 * Stručný úvod do vývoje rozšíření MediaWiki — Videoprezentace o tom, jak vytvořit rozšíření MediaWiki (slides).
 * Vytvoření rozšíření MediaWiki — Vysvětluje, jak vyvinout rozšíření pro MediaWiki, osvědčené postupy a jak zapojit komunitu MediaWiki. Od února 2011.
 * Nápověda pro vývojáře rozšíření ve Vývojářském centru



Související odkazy

 * Hledejte kód napříč repozitáři
 * – Pokud jste si důkladně přečetli informace v tomto článku, je čas přejít k informacím ve vývojářském centru.