Nápověda:Rozšíření:Translate/Začínáme s vývojem

Dokumentace pro Extension:Translate

Pro překladatele (hlavní stránka nápovědy )

• Jak se překládá
• Osvědčené postupy
• Statistika a hlášení
• Záruka kvality
• Přehled o stavu překladu zpráv
• Offline překlad
• Slovníček

Pro správce překladů

• Jak připravit stránku k překladu
• Správa překladu stránky
• Překlad nestrukturovaných prvků
• Správa skupin
• Přesun překládané stránky
• Import překladů přes CSV
• Práce se svazky zpráv

Pro systémové administrátory a vývojáře

• Instalace
• Konfigurace
• Než začnete s vývojem
• Průvodce pro vývojáře
• Rozšíření Překladače
• Validátory (ověřovače)
• Zástupné prvky
• Konfigurace skupiny
• Příklad konfigurace skupiny
• Překladové paměti
• Nápověda překladatele
• Povolení balíčků zpráv
• Háčky PHP

Přeložte tuto šablonu

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, související pokyny MediaWiki-Docker.

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 "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.