add the ability to localize help pages for docs

microsoft · Dec 5, 2024 · 717f6b6 · 717f6b6
1 parent 405808c
commit 717f6b6
Showing 1 changed file with 38 additions and 4 deletions.
diff --git a/webapp/src/blocks.tsx b/webapp/src/blocks.tsx
@@ -1034,10 +1034,9 @@ export class Editor extends toolboxeditor.ToolboxEditor {
                         if (/^github:/.test(url)) {
                             // strip 'github:', add '.md' file extension if necessary
                             url = url.replace(/^github:\/?/, '') + (/\.md$/i.test(url) ? "" : ".md");
-                            const readme = pkg.getEditorPkg(pkg.mainPkg).lookupFile(url);
-                            const readmeContent = readme?.content?.trim();
-                            if (readmeContent) {
-                                this.parent.setSideMarkdown(readmeContent);
+                            const content = resolveLocalizedMarkdown(url);
+                            if (content) {
+                                this.parent.setSideMarkdown(content);
                                 this.parent.setSideDocCollapsed(false);
                             }
                         } else if (/^\//.test(url)) {
@@ -2003,3 +2002,38 @@ function shouldEventHideFlyout(ev: Blockly.Events.Abstract) {
 
     return true;
 }
+
+function resolveLocalizedMarkdown(url: string) {
+    const editorPackage = pkg.getEditorPkg(pkg.mainPkg);
+
+    const [initialLang, baseLang, initialLangLowerCase] = pxt.Util.normalizeLanguageCode(pxt.Util.userLanguage());
+
+    const splitPath = url.split("/");
+    const fileName = splitPath.pop();
+    const dirName = splitPath.join("/");
+
+    let pathsToTest: string[];
+
+    if (initialLang && baseLang && initialLangLowerCase) {
+        pathsToTest = [
+            `${dirName}/_locales/${initialLang}/${fileName}`,
+            `${dirName}/_locales/${initialLangLowerCase}/${fileName}`,
+            `${dirName}/_locales/${baseLang}/${fileName}`,
+            url
+        ];
+    }
+    else {
+        pathsToTest = [url];
+    }
+
+    for (const path of pathsToTest) {
+        const file = editorPackage.lookupFile(path);
+        const content = file?.content?.trim();
+
+        if (content) {
+            return content;
+        }
+    }
+
+    return undefined;
+}