Missing French translation support in documentaton

Question

Missing French translation support in documentaton

exaucae opened this issue 3 years ago · comments

It is a widely spoken language and would help lower entry barriers for many french devs. See https://single-spa.js.org/languages

Joel Denning · Answer 1 · Wed Jan 05 2022 05:41:53 GMT+0800 (China Standard Time)

Hi @exaucae, can you help with the French translation? Do you know anyone else who can help with the translation? We prefer having at least two people helping with the translation.

For reference, here was the issue for adding the Russian translation: #369

Here's the checklist for what needs to be done. Once we confirm there are at least two people willing to help with the translation, I'll start doing them.

Tasks for me

Decide on a language code to use. I think that fr is good.
Create a new repo called fr.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 fr git@github.com:single-spa/fr.single-spa.js.org.git
git push fr master:master

Update docusaurus config to correct domain (example at single-spa/ru.single-spa.js.org@b809789)
Update CircleCI badge in readme to correct url (example at single-spa/ru.single-spa.js.org@e6660e0)
Modify /website/static/CNAME in to be the correct domain. single-spa/fr.single-spa.js.org@7bd77eb
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 French to translations.js, so that it appears in the list at https://single-spa.js.org/languages

Tasks for @exaucae

Find at least one other person who can help with the translations.
Watch the fr.single-spa.js.org Github repository for all activity
Translate the files /website/versioned_docs/version-5.x directory. Do not translate the /docs directory. Also, translate each of the pages in /website/pages

Tasks for @guguji5

Set up the bot to automatically commit to fr.single-spa.js.org whenever a PR is merged into single-spa.js.org.

Chrys Exaucet · Answer 2 · Wed Jan 05 2022 08:30:48 GMT+0800 (China Standard Time)

Hey @joeldenning,

I'd be glad to help, yes. Î'll let you know when I find the second person.

Chrys Exaucet · Answer 3 · Mon Jan 10 2022 02:31:09 GMT+0800 (China Standard Time)

@joeldenning , unofrtunately I have not found a second person. If that's okay for you, we can start just with me. I'll be waiting for the french repo to be set up ( or to have access to it, since https://github.com/single-spa/fr.single-spa.js.org redirect me to Github's 404 page) . I'll also keep looking for a second person meanwhile.

Joel Denning · Answer 4 · Fri Jan 14 2022 07:15:41 GMT+0800 (China Standard Time)

Sure @exaucae, I've created https://github.com/single-spa/fr.single-spa.js.org and started the process. The remaining steps require a couple days to go through, so I'll plan on coming back to this over time. Feel free to mention me if I do not finish out the remaining steps.

In the meantime while we're waiting on Github and js.org, you can boot up the french translation site locally and start translating the documentation (as described in my original post of this issue). You don't need to wait for my approval or anyone else's on PRs - just merge them.

Also, feel free to mention me here if i forget to finish out the remaining steps and don't come back to it in a few days

Joel Denning · Answer 5 · Fri Jan 14 2022 07:31:11 GMT+0800 (China Standard Time)

Created #520 to add the link to the French documentation

Joel Denning · Answer 6 · Fri Jan 14 2022 07:34:11 GMT+0800 (China Standard Time)

Created js-org/js.org#6794 for js.org subdomain