vi: Translate TOC from Running the course to the end of Chromium

[ichxorya]

I tried to translate the table of contents into Vietnamese.

• Some keywords are hard to translate, or to clarify my translation, I used parentheses "( )".
• I don't know if I should keep some keywords in English or not. In this pr I chose to translate them into Vietnamese and keep their original English counterparts in parentheses.
• I could mention some of them like: build, type inference, trait, move semantics, iterator, panic, unsafe...
• Some parts overlap with this pr: Translate Day 1 index and Running the course content to Vietnamese #1947

[google-cla]

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

[mgeisler]

Hi @ichxorya, thanks a lot for helping out here!

I believe you need to install dprint so you can correct the formatting of the vi.po file. See TRANSLATIONS.md.

@daivinhtran, will be you be able to review this PR? You can also help @ichxorya by reformatting it on your machine (use gh to checkout the branch) and then the correct formatting to the branch. This is possible because @ichxorya kindly enabled the Maintainers are allowed to edit this pull request. setting on the PR.

[ichxorya]

Hi @ichxorya, thanks a lot for helping out here!

I believe you need to install dprint so you can correct the formatting of the vi.po file. See TRANSLATIONS.md.

@daivinhtran, will be you be able to review this PR? You can also help @ichxorya by reformatting it on your machine (use gh to checkout the branch) and then the correct formatting to the branch. This is possible because @ichxorya kindly enabled the Maintainers are allowed to edit this pull request. setting on the PR.

Hello, I believe that I used dprint to format the file (ichxorya@a8f9b5e)

And yes, I'd set the PR setting.

[mgeisler]

• Some keywords are hard to translate, or to clarify my translation, I used parentheses "( )".

Yes, it's very difficult or impossible to translate everything. We don't have a unified approach to this: I think it's fine to keep the English word in parenthesis after the translated word. Perhaps like this:

Translated (English) more translated

where the English word is in italics and the rest is normal.

[daivinhtran]

@ichxorya To distribute the work easier, would mind splitting the PR into smaller PRs to avoid spanning the translation across too many .md files? For best practice, it's better to focus the translation per .md file so that we don't run into merge conflicts. See #1957 (comment) for some instruction.

[ichxorya]

@ichxorya To distribute the work easier, would mind splitting the PR into smaller PRs to avoid spanning the translation across too many .md files? For best practice, it's better to focus the translation per .md file so that we don't run into merge conflicts. See #1957 (comment) for some instruction.

How should I do that? Can you suggest? This pr is already too large from the beginning.

For now I could close this pr and restart on a smaller range of translation like other pr, if it helps.

[daivinhtran]

Yeah I think opening a new PR with translation for a small set of .md files will be useful. Also update the spreadsheet so others don't attempt what you have already translated.

[mgeisler]

How should I do that? Can you suggest? This pr is already too large from the beginning.

If you need to split up the work, then I know two approaches:

• You can just open the PO file in a plain text editor and copy-paste the entries you want to different working copies or branches. This works okay if all the changes are in the same region of the very large file.
• You can use Gettext's msggrep to extract a subset of a PO file into a new PO file. Something like

  msggrep -N src/android.md -N 'src/android/*'
  

  will extract just the messages related to the Android part of the course. After extracting the messages, you will need to put them back into the big PO file, use msgcat and msgmerge for that.

The Gettext tools are a bit clunky, but they can be good if you want to operate on hundreds of entries spread across the PO file. If you only want to deal with a few hand-fulls of messages, then I suggest lots of copy-paste 😄