Gerrit/Nová úložiště
Tato 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 chcete používat Gerrit nebo zda 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)
- Repository name – * 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. Zkontrolujte seznam existujících názvů úložišť. - Projekt Phabricator – Zde by měly být hlášeny úkoly týkající se vašeho úložiště, např.
MediaWiki-extensions-Example.
Pokud ještě žádný nemáte, nejprve odešlete žádost o projekt Phabricator.
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í - 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ě