Setup i18n for docusaurus

[Kevan-Y]

Issue This PR Addresses

fixes: #2922

Type of Change

• Bugfix: Change which fixes an issue
• New Feature: Change which adds functionality
• Documentation Update: Change which improves documentation
• UI: Change which improves UI

Description

Setup i18n for docusaurus, I only put languages that we are going to translate based on the table of this issue #2962

Note: Only the overview page is overwritten, the rest is gonna stay in English

Steps to test the PR

Option 1: Run build

• cd src/docs
• pnpm build && pnpm serve

Option 2: Run dev

• cd src/doc
• pnpm start -- --locale <LOCAL_CODE> e.g. pnpm start -- --locale fr(For the french version)

2022-02-24.11-36-27.mp4

Checklist

• Quality: This PR builds and passes our npm test and works locally
• Tests: This PR includes thorough tests or an explanation of why it does not
• Screenshots: This PR includes screenshots or GIFs of the changes made or an explanation of why it does not (if applicable)
• Documentation: This PR includes updated/added documentation to user exposed functionality or configuration variables are added/changed or an explanation of why it does not(if applicable)

[gitpod-io]

[Kevan-Y]

To add a new language later, we have to add the LOCAL_CODE in docusaurus.config.js in i18n
Then create your i18n folder.
mkdir -p i18n/<LOCAL_CODE>/docusaurus-plugin-content-docs/current
Then put your translated file in there. I believe it matches the structure of the docs file (where we contain all our original docs )

[aserputov]

Sounds good for me.

[tcvan0707]

Tested locally, it worked for me. Later on, we would add the translation version in to the file inside src/docs/i18n, is that correct?

[Kevan-Y]

Tested locally, it worked for me. Later on, we would add the translation version in to the file inside src/docs/i18n, is that correct?

yes, if you looked at the structure there is a folder for each languages we are translating for

[humphd]

fr-CA? 🇨🇦

[Kevan-Y]

I don't know about the difference between fr-CA and fr-fr. I'm translating this page, so my French is from France

[aserputov]

@Kevan-Y what do you mean ? I think it meant to be en-CA, en-FR?

[Kevan-Y]

I was following this, https://www.fincher.org/Utilities/CountryLanguageList.shtml.