frontend/i18n: adding french, italian and russian

Author: haraldschilly

src/packages/frontend/app/localize.tsx

@@ -140,6 +140,12 @@ function loadAntdLocale(locale: Locale): Promise<AntdLocale> {
         return import("antd/locale/zh_CN");
       case "es":
         return import("antd/locale/es_ES");
+      case "ru":
+        return import("antd/locale/ru_RU");
+      case "fr":
+        return import("antd/locale/fr_FR");
+      case "it":
+        return import("antd/locale/it_IT");
       default:
         unreachable(locale);
         throw new Error(`Unknown locale '${locale}.`);

src/packages/frontend/i18n/README.md

@@ -82,6 +82,31 @@ We discussed this internally on 2024-08-19 and came to the conclusion that we sh
 - Example: translating the "Run" button in Jupyter to German or Russian, which both have more or less the meaning of "running in the street", is extremely awkward. It's also a well recognizable element, which users are used to, even without knowing what it really means. Same holds for "Kernel", which is even in English a pretty weird choice. Therefore, we do not translate elements like the "Run" button or "Kernel" for Jupyter Kernels. A "Run" menu however, in general, could be translated (e.g. in German it is called "Ausführen").
 - However, what we should translate (or add) are hover text explanations. So, in the case of the "Run" button, there should be a tooltip, which explains in the current language, what this button really does.
 
+## SimpleLocalize configuration
+
+This is about auto-translations, in "Settings → Auto-translation":
+
+- To start: when you add a new language, set its full code, e.g. "fr_FR", name "French" and language "French". Translation provider: OpenAI.
+- You need the API key, it's in Integrations → REST API. See notes above.
+- In the Auto-translate configuration, OpenAI → Configure:
+
+  - API key: a separate one to track usage, it's fine to restrict its capabilities to list and use models.
+  - GPT-4o
+  - System prompt: here, the key point is to give some context and to instruct it to retain those ICU messages. That's what I came up with after a few tests and iterations:
+
+        Translation of strings in the user-interface of the online platform "CoCalc".
+
+        Stay close to the original meaning of the source text and match the length and style. In particular, short labels of commands must stay short.
+
+        If a label ends with "...", keep those dots in the translation.
+
+        Retain the syntax of ICU formatted messages. They could contain variables like `some text {variable} more text` or conditionals like `{variable, select, option1 {...} other {...}}`.
+
+  - add description as context: Yes. (I assume this uses the "code description")
+
+- Exclusion dialect: ICU messages
+- Excluded words or phrases: CoCalc
+
 ## Examples
 
 Here are examples of how to use this:
@@ -134,6 +159,7 @@ other {}
   - Ref: ICU Messages: https://unicode-org.github.io/icu/userguide/format_parse/messages/
 - **okText**: That's a simple string, where the English variant is defined right here. Note, that the ID of the OK text and the title are very similar.
 - **cancelText**: That references a common message, which is used in many places. It's the "Cancel" text on the button. The `labels` object comes from `import { labels } from "@cocalc/frontend/i18n"`.
+  - There is also a tiny component as an example, for how to translate a bit via a component: `i18n/components.tsx` → `<CancelText />`
 
 ## Menu entries
 
@@ -163,3 +189,5 @@ build_on_save: {
   label: ({ intl }) => intl.formatMessage({ id: "...",  defaultMessage: "..."}, { ...values })
 }
 ```
+
+Many of those messages are actually defined in `i18n/common.ts`. There are groups of messages, e.g. `jupyter.commands`. Messages are only extracted from `*.tsx` and some `*.ts` files – check the code of `i18n/bin/extract.sh` to see what's going on. This file is accompanied by `i18n.test.ts`, which checks the prefixes of all IDs!

src/packages/frontend/i18n/bin/common.sh

@@ -1 +1 @@
-LANGS="de_DE zh_CN es_ES"
+LANGS="de_DE zh_CN es_ES fr_FR ru_RU it_IT"

src/packages/frontend/i18n/de_DE.compiled.json

@@ -959,12 +959,30 @@
       "value": "Englisch"
     }
   ],
+  "i18n.localization.lang.french": [
+    {
+      "type": 0,
+      "value": "Französisch"
+    }
+  ],
   "i18n.localization.lang.german": [
     {
       "type": 0,
       "value": "Deutsch"
     }
   ],
+  "i18n.localization.lang.italian": [
+    {
+      "type": 0,
+      "value": "Italienisch"
+    }
+  ],
+  "i18n.localization.lang.russian": [
+    {
+      "type": 0,
+      "value": "Russisch"
+    }
+  ],
   "i18n.localization.lang.spanish": [
     {
       "type": 0,
@@ -2074,7 +2092,7 @@
       "children": [
         {
           "type": 0,
-          "value": "TimeTravel-Historie"
+          "value": "ZeitReise-Historie"
         }
       ],
       "type": 8,

src/packages/frontend/i18n/de_DE.json

@@ -89,7 +89,10 @@
   "frame_editors.frame_tree.title_bar.minimize": "Alle Fenster anzeigen",
   "i18n.localization.lang.chinese": "Chinesisch",
   "i18n.localization.lang.english": "Englisch",
+  "i18n.localization.lang.french": "Französisch",
   "i18n.localization.lang.german": "Deutsch",
+  "i18n.localization.lang.italian": "Italienisch",
+  "i18n.localization.lang.russian": "Russisch",
   "i18n.localization.lang.spanish": "Spanisch",
   "jupyter.commands.cell_toolbar_none": "Keine Zellen-Werkzeugleiste",
   "jupyter.commands.cell_toolbar_none_menu": "Keine",
@@ -260,7 +263,7 @@
   "menu.generic.run.label": "Ausführen",
   "menu.generic.split.button": "Teilen",
   "menu.generic.view.label": "Ansicht",
-  "new.file-type-page.header.description": "Was möchten Sie erstellen? Dokumente können gleichzeitig von mehreren Personen bearbeitet werden, führen eine vollständige <A>TimeTravel-Historie</A> der Änderungen und unterstützen die Auswertung von Code.",
+  "new.file-type-page.header.description": "Was möchten Sie erstellen? Dokumente können gleichzeitig von mehreren Personen bearbeitet werden, führen eine vollständige <A>ZeitReise-Historie</A> der Änderungen und unterstützen die Auswertung von Code.",
   "new.file-type-page.header.intro": "Benennen Sie Ihre Datei, Ihren Ordner oder fügen Sie einen Link ein. Beenden Sie den Namen mit /, um einen Ordner zu erstellen.",
   "new.file-type-selector.folder.tooltip": "Erstellen Sie einen Ordner (Unterverzeichnis), in dem Sie Ihre Dateien speichern und organisieren können. CoCalc bietet ein voll ausgestattetes Dateisystem. Sie können auch einen Pfad im obigen Eingabefeld eingeben, der mit einem Schrägstrich / endet, und die Eingabetaste drücken.",
   "new.file-type-selector.latex.tooltip": "Erstellen Sie ein technisches Papier in professioneller Qualität, das anspruchsvolle mathematische Formeln enthält und Python-, R- und Sage-Code ausführen kann.",

src/packages/frontend/i18n/es_ES.compiled.json

@@ -959,12 +959,30 @@
       "value": "Inglés"
     }
   ],
+  "i18n.localization.lang.french": [
+    {
+      "type": 0,
+      "value": "Francés"
+    }
+  ],
   "i18n.localization.lang.german": [
     {
       "type": 0,
       "value": "Alemán"
     }
   ],
+  "i18n.localization.lang.italian": [
+    {
+      "type": 0,
+      "value": "Italiano"
+    }
+  ],
+  "i18n.localization.lang.russian": [
+    {
+      "type": 0,
+      "value": "Ruso"
+    }
+  ],
   "i18n.localization.lang.spanish": [
     {
       "type": 0,

src/packages/frontend/i18n/es_ES.json

@@ -89,7 +89,10 @@
   "frame_editors.frame_tree.title_bar.minimize": "Mostrar todos los marcos",
   "i18n.localization.lang.chinese": "Chino",
   "i18n.localization.lang.english": "Inglés",
+  "i18n.localization.lang.french": "Francés",
   "i18n.localization.lang.german": "Alemán",
+  "i18n.localization.lang.italian": "Italiano",
+  "i18n.localization.lang.russian": "Ruso",
   "i18n.localization.lang.spanish": "Español",
   "jupyter.commands.cell_toolbar_none": "Sin barra de herramientas de celda",
   "jupyter.commands.cell_toolbar_none_menu": "Ninguno",

src/packages/frontend/i18n/extracted.json

@@ -284,9 +284,18 @@
   "i18n.localization.lang.english": {
     "defaultMessage": "English"
   },
+  "i18n.localization.lang.french": {
+    "defaultMessage": "French"
+  },
   "i18n.localization.lang.german": {
     "defaultMessage": "German"
   },
+  "i18n.localization.lang.italian": {
+    "defaultMessage": "Italian"
+  },
+  "i18n.localization.lang.russian": {
+    "defaultMessage": "Russian"
+  },
   "i18n.localization.lang.spanish": {
     "defaultMessage": "Spanish"
   },