Arabic translation is not exist

Question

Arabic translation is not exist

alighali85 opened this issue 4 years ago · comments

Im the main website there is no Arabic option within the languages you offer,
would be great to offer Arabic option.

Joel Denning · Answer 1 · Fri Jun 12 2020 23:58:34 GMT+0800 (China Standard Time)

Hi @alighali85, would you be interested in helping translate the documentation to Arabic? Do you know others who would help in the translation? We have a process for setting up new languages, but need help with the translations.

Ali Ghali · Answer 2 · Wed Jun 17 2020 15:54:48 GMT+0800 (China Standard Time)

Hey @joeldenning, where can I see the process of adding the translations? I may be able to help, I can search for other participants as well :)

Joel Denning · Answer 3 · Wed Jun 17 2020 23:11:04 GMT+0800 (China Standard Time)

Here is the issue where we set up the portuguese translations. I am happy to help get some of the initial work set up, once we are ready.

#183 (comment)

Joel Denning · Answer 4 · Wed Jun 17 2020 23:14:16 GMT+0800 (China Standard Time)

Technical tasks

Decide on a language code to use. Maybe ar? The React translations have only ar, and doesn't have regional variants of Arabic.
Create a new repo called ar.single-spa.js.org. Manually initialize it to be the same git tree as single-spa.js.org. Do not do this by forking the repo -- a fork has a separate git tree. You can do this by initializing to empty repo (no readme, no gitignore) and then adding that as a remote to your local copy of single-spa.js.org:

cd single-spa.js.org
git remote add ar git@github.com:single-spa/ar.single-spa.js.org.git
git push ar master:master

Set up the bot to automatically commit to ar.single-spa.js.org whenever a PR is merged into single-spa.js.org. When a merge conflict happens, a pull request is created instead of a commit to master. We're currently doing this with https://github.com/guguji5/sync-fork-repo
Update docusaurus config to correct domain
Update CircleCI badge in readme to correct url
Enable builds in CircleCI. Add the GITHUB_TOKEN env variable
Modify /website/static/CNAME in to be the correct domain.
Force HTTPS in the repository settings in Github. This takes a day or so after the CNAME is set for the SSL cert to be set up.
Create a pull request to the js.org repo, adding the subdomain. Should be similar to this: js-org/js.org#3747
Add Arabic to translations.js, so that it appears in the list at https://single-spa.js.org/languages

Organizational tasks

Find at least one other person besides yourself who can help with the translations.
Evaluate time commitment of maintaining the translations.
Translate the files /website/versioned_docs/version-5.x directory.

Joel Denning · Answer 5 · Wed Jun 17 2020 23:15:40 GMT+0800 (China Standard Time)

Can you confirm whether ar makes sense as the language code and subdomain to use? If so, I will proceed to create the repository. I will also mention @guguji5 here, since he will be the one to set up the bot that keeps the repo in sync.

Joel Denning · Answer 6 · Wed Jun 17 2020 23:29:34 GMT+0800 (China Standard Time)

Also, please join the single-spa slack workspace. The #maintainers and #translations channels are two good ones to join. And feel free to message me directly there to say hi. The single-spa core team uses that slack workspace to communicate and coordinate on projects like this.

Damon · Answer 7 · Wed Jun 17 2020 23:53:18 GMT+0800 (China Standard Time)

I am pleased to set the bot working for this.

Ali Ghali · Answer 8 · Thu Jun 18 2020 02:09:05 GMT+0800 (China Standard Time)

hey, thank you for initializing all the setup so fast, I am still trying yo find out whether I have enough time to start this now, for the time being I posted in a developers group I am in, calling for participants, will see if someone else is interested in helping us translate single-spa, will back to you in 2-4 days,

for language code according to ISO mentioned here (ar) should be the correct code, Arabic variants and dialects are not important at all in any official documentation, its just fine and better to use standard Arabic.
source for the language code: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

Damon · Answer 9 · Thu Jun 18 2020 11:38:18 GMT+0800 (China Standard Time)

Hi @alighali85 , The bot need some information as this link, the language, the code and the reviewer name in github.

Ali Ghali · Answer 10 · Thu Jun 18 2020 20:37:29 GMT+0800 (China Standard Time)

@guguji5 we can use
{ "name": "Standard Arabic", "code": "Ar-ar", "reviewers": ["@youOrMe"] }

Joel Denning · Answer 11 · Fri Jun 19 2020 00:46:23 GMT+0800 (China Standard Time)

will see if someone else is interested in helping us translate single-spa, will back to you in 2-4 days,

👍 sounds good. I will hold off on creating the github repo until that time.

Damon · Answer 12 · Fri Jun 19 2020 09:45:32 GMT+0800 (China Standard Time)

reviewers

the fields of reviewers should be a github account, this one will receive the PR email if new change in document happens.

I find @youOrMe is not a github account, so could you be the one to review all change (that may include some conflict ) ?

Damon · Answer 13 · Sat Jun 20 2020 23:21:52 GMT+0800 (China Standard Time)

@joeldenning Could you give me a message after creating a git repository single-spa in Ar-ar ? otherwise the bot will cause an error to sync a nonexistent repo.

Joel Denning · Answer 14 · Tue Jun 23 2020 00:32:35 GMT+0800 (China Standard Time)

Could you give me a message after creating a git repository single-spa in Ar-ar ?

Sure. Like I said in my previous comment, I am waiting for confirmation that there are multiple translators interested and able in helping out with the Arabic translation. Once that is confirmed, I will create the repo.