Gerrit/Nová úložiště
Tahle stránka by měla soustředit odpovědi na otázky ohledně vytvoření nového úložiště. Pro všechny nová úložiště se používá Git, v kombinaci s aplikací Gerrit .
Chcete-li se tedy stát vlastníkem nového projektu (který bude mít během schvalovacího procesu nového patche váhu +2 a navíc možnost svoje změny do stávajícího kódu ihned začlenit) s repozitářem udržovaným přes +2, přečtěte si nejprve stránku Gerrit/Pravidla přednostního práva .
Krok 0: Zamyšlení
Rozmyslete si, zda-li chcete používat Gerrit, nebo zda-li upřednostníte GitLab (který je k dispozici od roku 2021).
GitLab má výhodu v tom, že dovoluje založit vlastní repozitář, aniž by bylo nutné o jeho založení požádat.
Krok 1: Získání přístup do Gitu
My používáme pro schvalování patchů (review) a přenášení změn (commit) do kódu Gerrit, do kterého se můžete přihlásit přes vývojářský účet (Wikimedia developer account).
Vývojářský účet si může založit každý, tedy i vy, pokud ho ještě založený nemáte.
Krok 2: Žádost o Git repozitář
Než podáte svou žádost, měli byste mít:
- Vývojářský účet (Wikimedia developer account)
- Jasno v tom, jaký bude název nového repozitáře (a podstránky v rámci jmenného prostoru Gerrit), např.
mediawiki/extensions/NoveRozsireni
- A založený projekt v rámci aplikace Phabricator. Viz zakládání nových projektů.
Krok 3: Odeslání vašich souborů do repozitáře
Jakmile budete mít nějaké soubory, můžete je svěřit a pokračovat ve své práci pomocí Gitu.
Krok 4: Publikování stránky rozšíření
Chcete-li automaticky kategorizovat a standardizovat dokumentaci vašeho stávajícího rozšíření, přečtěte si prosím Template:Extension . Chcete-li přidat nové rozšíření do této wiki:
Šablony k použití
- {{Extension }}
- {{WikimediaDownload }}
- {{ExtensionInstall }}
- {{Git repo }}
- {{MW file }} - použité v Příručce
- ...
Krok 5: Pokračujte ve vývoji a užívejte si!
Můžete také zkusit najít pár zavedených vývojářů MediaWiki, aby se podívali na váš kód a poukázali na případné nedostatky v něm, například dotazem na mailing listu wikitech-l .
Upozorňování na změny ve vašem úložišti
Ostatní lidé mohou odesílat záplaty do vašeho úložiště, které byste měli recenze.
Gerrit si můžete nechat poslat e-mailem nové změny ve vašem úložišti. Podívejte se na stránku Gerrit/watched projects . Pokud chcete být automaticky přidáni jako recenzenti do každé nové sady patchů (nebo podmnožiny podle regulárního výrazu), přidejte se do robota recenzenta Gerrit.
Související odkazy
- Příručka:Rozšíření - Příručka:Rozšíření – pokyny pro vývoj rozšíření nebo knihoven (konvence kódování, architektura, licence, zabezpečení atd.)
- Git/Creating new repositories - technické pokyny pro správce Gerritu, kteří vytvářejí úložiště