Nápověda:Rozšíření:Translate/Getting started with development

This page is a translated version of the page Help:Extension:Translate/Getting started with development and the translation is 100% complete.

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:

  1. Různé součásti rozšíření Translate
  2. Glosář: Popisuje použitou terminologii
  3. Struktura jmenného prostoru PHP
  4. Translate podporuje různé možnosti konfigurace
  5. Úlohy MediaWiki používané v Translate

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.

  1. 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
  2. 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"
  3. Spusťte testovací případy rozšíření Translate: docker-compose exec mediawiki sh -c "php tests/phpunit/phpunit.php extensions/Translate/tests/phpunit/"

Další užitečné odkazy