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

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

Extension:翻译的帮助文档

翻譯人員 (主要說明頁面 )

翻译管理员

系統管理員與開發人員

翻譯此模板

感謝您有興趣為翻譯擴展做出貢獻。本文檔的目的是讓 Translate 擴充功能的開發更容易上手。

Developing the Translate extension requires knowledge of PHP, JavaScript/jQuery and CSS/LESS. Some knowledge in MySQL may be required depending on the task that you choose to work on.

Getting familiar with the code

The following pages should help you get an overview of the code:

Local development setup

The easiest way to get started with development on Translate extension is to use the MediaWiki-Docker . 请参阅相关 MediaWiki-Docker 说明。

To run some code sniffs specific to Translate extension, you can run composer install inside the Translate extension directory. You can use the following command: docker-compose exec mediawiki sh -c "cd extensions/Translate && composer install"

Coding conventions

Translate follows the existing MediaWiki Coding conventions. These differ based on the programming languages, so ensure you go through the appropriate pages.

There are a few other guidelines specific to Translate to keep in mind.

Picking what to work on

Go to the Translate Phabricator Board and look for tasks with the tag: good first tasks.

Because the extension is actively being worked on, before you start work on a task, we recommend leaving a comment about any additional concerns that are not reflected in the task currently.

After you receive the green light, you can go ahead and assign the task to yourself and start working.

Patch submission checklist

It is important to be familiar with how to work with Gerrit. It is also important to be familiar with the commit message guidelines.

Before submitting the patch, it's recommended to run linting tools and test cases locally to ensure that simple issues can be identified and fixed early. This helps reduce the back and forth during code reviews.

Run phpcbf to fix easily fixable linting issues locally. This can be done using: docker-compose exec mediawiki composer fix extensions/Translate
Run other linters to identify any issues that could not be fixed automatically. This can be done using: docker-compose exec mediawiki sh -c "cd extensions/Translate && composer test"
Run Translate extension test cases: docker-compose exec mediawiki sh -c "composer phpunit:entrypoint -- extensions/Translate/tests/phpunit/"