Missing Portuguese (Brazil) translation support in documentaton
saratiedt opened this issue · comments
It is a widely spoken language and would help to lower entry barriers for many Brazilian developers.
Hi @saratiedt, can you help with the Portuguese (Brazil) 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
pt-brmight be good? - Create a new repo called
pt-br.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 ofsingle-spa.js.org:
cd single-spa.js.org
git remote add pt-br git@github.com:single-spa/pt-br.single-spa.js.org.git
git push pt-br 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)
- Enable builds in CircleCI. Add the GITHUB_TOKEN env variable
- Modify
/website/static/CNAMEin to be the correct domain. https://github.com/single-spa/pt-br.single-spa.js.org/commit/7bd77eb4e50f607dbbb32faca64db052feb0ce3e - 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 Indonesian to translations.js, so that it appears in the list at https://single-spa.js.org/languages
Tasks for @saratiedt
- Find at least one other person who can help with the translations.
- Watch the pt-br.single-spa.js.org Github repository for all activity
- Translate the files
/website/versioned_docs/version-5.xdirectory. Do not translate the/docsdirectory. Also, translate each of the pages in/website/pages
Tasks for @guguji5
- Set up the bot to automatically commit to pt-br.single-spa.js.org whenever a PR is merged into single-spa.js.org.
Can I join in?
Hi @zeyuri, sure, do you know of one more person who can help?
Hi! I can help too!