Help:Extension:Translate/Getting started with development/cs

<translate> Documentation for <tvar|ext>Rozšíření:Translate</></translate>

<translate> Translators</translate> (<translate> main help page</translate> )

<translate> Translation administrators</translate>

<translate> Sysadmins and developers</translate>

<translate> Translate this template</translate>

Děkujeme za váš zajímavý příspěvek do rozšíření Translate. Cílem tohoto dokumentu je usnadnit zahájení práce na vývoji rozšíření Translate.

Vývoj rozšíření Translate vyžaduje znalost PHP, JavaScript nebo jQuery a CSS nebo LESS. V závislosti na úkolu, na kterém jste se rozhodli pracovat, mohou být vyžadovány určité znalosti MySQL.

Seznámení s kódem

Následující stránky by vám měly pomoci získat přehled o kódu:

Nastavení místního rozvoje

Nejjednodušší způsob, jak začít s vývojem na rozšíření Translate, je použít MediaWiki-Docker . Přečtěte si, prosím, tyto pokyny.

Chcete-li spustit některé kódové sniffy specifické pro rozšíření Translate, můžete spustit composer install v adresáři rozšíření Translate. Můžete použít následující příkaz: docker-compose exec mediawiki sh -c "cd extensions/Translate && composer install"

Konvence kódování

Překladač se řídí stávajícími konvencemi kódování MediaWiki. Liší se podle programovacích jazyků, takže si projděte příslušné stránky.

Je třeba mít na paměti několik dalších pokynů specifických pro Translate.

Výběr toho, na čem pracovat

Přejděte na Translate Phabricator Board a vyhledejte úkoly s tagem: good first tasks (dobré první úkoly).

Protože na rozšíření se aktivně pracuje, před zahájením práce na úkolu doporučujeme zanechat komentář o dalších problémech, které se v úkolu aktuálně neprojevují.

Poté, co obdržíte zelenou, můžete pokračovat a přiřadit úkol sami sobě a začít pracovat.

Kontrolní seznam pro odeslání opravy

Je důležité vědět, jak pracovat s Gerritem. Je také důležité se seznámit s pokyny pro zprávy o závazcích.

Před odesláním opravy se doporučuje spustit liniové nástroje a lokálně testovat případy, aby bylo možné včas identifikovat a opravit jednoduché problémy. To pomáhá od začátku do konce při kontrole kódu.

Spusťte phpcbf, abyste lokálně opravili snadno opravitelné problémy s liningem. To lze provést pomocí: docker-compose exec mediawiki composer fix extensions/Translate
Spusťte další linters a identifikujte všechny problémy, které nebylo možné opravit automaticky. To lze provést pomocí: docker-compose exec mediawiki sh -c "cd extensions/Translate && composer test"
Spusťte testovací případy rozšíření Translate: docker-compose exec mediawiki sh -c "composer phpunit:entrypoint -- extensions/Translate/tests/phpunit/"

Další užitečné odkazy

Vyhledávání kódu MediaWiki - užitečné, abyste viděli, jak se určité háčky nebo funkce používají v jiných rozšířeních.
Otevřete záplaty na Gerrit - mohl bys pomoci revidovat.