Use i18n for common strings

[avivkeller]

While we can't translate the docs themselves, we can translate some of our constant strings.

Now that i18n is publishable, we can add a --lang flag to the CLI to generate docs with different languages.

[flakey5]

How would these be distributed in releases? Putting them into subfolders like https://nodejs.org/docs/latest/api/<locale>/buffer.html?

[AugustinMauroy]

If I recall correctly, the TSC completely vetoed the translation.

[avivkeller]

Can you link that? I thought they vetoed translating the docs themselves, (the files in core), not the strings we use to generate them (the files here).

While we can't provide fully translated docs, we can at least translate some of the commonly used phrases (I.e. "Source Code: ", "Added in: ", etc.)

[AugustinMauroy]

cc @ovflowd

[avivkeller]

I'll work on adding a --locale flag today.

[ovflowd]

The TSC vettoed translation for the API docs. Navigation cues (and other common strings) should be translateable. Unfortunately due to the nature of API docs, these need to be purely on the client-side. In other words the "content" should not be translated, but anything that is layout/component should be translateable.

Meaning:

• Static generated JSON files part of the JS bundle
• React does a client-side switch (and stores translation key on a local storage)
• next-intl also works that way on a client-side-only mode; But since we don't use Next.js here, we gotta use use-intl (https://www.npmjs.com/package/use-intl) which is the underlying core of next-intl

[flakey5]

Just confirming- we can do this on the client side w/o requiring js to run in the client's browser, correct?

[ovflowd]

Just confirming- we can do this on the client side w/o requiring js to run in the client's browser, correct?

wdym? React is client side JavaScript running on the Client-Side browser.

[flakey5]

wdym? React is client side JavaScript running on the Client-Side browser.

Re nodejs/node#52343 (comment)

[ovflowd]

wdym? React is client side JavaScript running on the Client-Side browser.

Re nodejs/node#52343 (comment)

Ah yes, then it just goes to English :)

[ovflowd]

But without JS you will also not be able to open the history and other features. Rendering the docs will still work but interactible elements maybe not. I guess we can do the history one with pure CSS maybe.

[ovflowd]

Even the language seledctor could be pure CSS and just triggers elements with certain language to render based on class name.

[flakey5]

Sgtm - js is definitely needed for some of the features but I still wanna make sure it's not made necessary for the entire page

[avivkeller]

Right now (in the draft generator) it is, but I'm actively working on getting React's dehydration to work, allowing the page to render without JS