🌐 🤖 简单实现了批量全量翻译，上线了英文文档

Author: Gaubee

docs/.vitepress/config.mts

@@ -46,7 +46,7 @@ export default defineConfig({
           );
         },
       }),
-    ] ,
+    ],
   },
   head: [["link", { rel: "icon", type: "image/svg+xml", href: "/logo.svg" }]],
   themeConfig: {
@@ -71,8 +71,17 @@ export default defineConfig({
         }
       : undefined,
   },
+  rewrites(id) {
+    return id.replace(/^i18n\//, "");
+  },
   locales: Object.keys(all).reduce((locales, key) => {
-    locales[key === rootLang ? "root" : key] = i18n(key, all[key]);
+    const isRoot = key === rootLang;
+    locales[isRoot ? "root" : key] = i18n(
+      key,
+      all[key],
+      isRoot ? "/" : `/i18n/${key}/`,
+      isRoot ? "/" : `/${key}/`
+    );
     return locales;
   }, {}),
   vite: vite as any,

docs/.vitepress/i18n.mts

@@ -2,6 +2,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { type DefaultTheme, LocaleConfig } from "vitepress";
 import { dirToSilderItem } from "./navPlugins";
+import { formatWithOptions } from "node:util";
 
 const html = String.raw;
 
@@ -23,16 +24,24 @@ export const getAllLocaleConfig = () => {
 };
 export const i18n = (
   lang: string,
-  m: LangConfig
+  m: LangConfig,
+  dirBase = lang === rootLang ? "/" : `/${lang}/`,
+  urlBase = dirBase
 ): LocaleConfig<DefaultTheme.Config>[string] => {
-  const isRoot = lang === rootLang;
-  const base = isRoot ? "/" : `/${lang}/`;
   const developerSlidbar = dirToSilderItem(
-    path.join(import.meta.dirname, `..${base}developer`, base)
+    path.join(import.meta.dirname, `..${dirBase}developer`),
+    urlBase
   );
   const helpSlidbar = dirToSilderItem(
-    path.join(import.meta.dirname, `..${base}help`, base)
+    path.join(import.meta.dirname, `..${dirBase}help`),
+    urlBase
   );
+  if (urlBase !== "/") {
+    console.log(
+      "developerSlidbar",
+      formatWithOptions({ depth: Infinity, colors: true }, developerSlidbar)
+    );
+  }
   return {
     label: m.label,
     lang,
@@ -42,11 +51,11 @@ export const i18n = (
       nav: [
         {
           text: developerSlidbar.text,
-          link: "/developer/",
+          link: `${urlBase}developer/`,
         },
         {
           text: helpSlidbar.text,
-          link: "/help/",
+          link: `${urlBase}help/`,
         },
         {
           text: m.nav.maintainerDoc,
@@ -63,17 +72,17 @@ export const i18n = (
         },
         {
           text: m.nav.downloads,
-          link: "/downloads",
+          link: `${urlBase}downloads`,
         },
       ],
 
       sidebar: {
-        dev: {
+        [`${urlBase}dev`]: {
           base: "",
           items: [],
           ...developerSlidbar,
         },
-        help: {
+        [`${urlBase}help`]: {
           base: "",
           items: [],
           ...helpSlidbar,

docs/.vitepress/i18n/en.json

@@ -0,0 +1,67 @@
+{
+  "label": "English",
+  "description": "A browser that provides distributed network | application attachment.",
+  "editLink": "Edit this page on GitHub",
+  "footer": {
+    "message": "Released under the MIT License",
+    "copyright": "Copyright © 2021-2025"
+  },
+  "docFooter": {
+    "prev": "Previous",
+    "next": "Next"
+  },
+  "lastUpdated": "Last updated",
+  "outline": {
+    "label": "Page Navigation"
+  },
+  "langMenuLabel": "Languages",
+  "returnToTopLabel": "Back to top",
+  "sidebarMenuLabel": "Menu",
+  "darkModeSwitchLabel": "Theme",
+  "lightModeSwitchTitle": "Switch to light mode",
+  "darkModeSwitchTitle": "Switch to dark mode",
+  "nav": {
+    "maintainerDoc": "Core Maintainer Documentation",
+    "developmentLog": "Development Log",
+    "gettingStartedMaintainer": "Getting Started for Core Developers",
+    "downloads": "Downloads"
+  },
+  "search": {
+    "placeholder": "Search documentation",
+    "translations": {
+      "button": { "buttonText": "Search documentation", "buttonAriaLabel": "Search documentation" },
+      "modal": {
+        "searchBox": {
+          "resetButtonTitle": "Clear search criteria",
+          "resetButtonAriaLabel": "Clear search criteria",
+          "cancelButtonText": "Cancel",
+          "cancelButtonAriaLabel": "Cancel"
+        },
+        "startScreen": {
+          "recentSearchesTitle": "Search history",
+          "noRecentSearchesText": "No search history",
+          "saveRecentSearchButtonTitle": "Save to search history",
+          "removeRecentSearchButtonTitle": "Remove from search history",
+          "favoriteSearchesTitle": "Favorites",
+          "removeFavoriteSearchButtonTitle": "Remove from favorites"
+        },
+        "errorScreen": {
+          "titleText": "Unable to fetch results",
+          "helpText": "You may need to check your network connection"
+        },
+        "footer": {
+          "selectText": "Select",
+          "navigateText": "Navigate",
+          "closeText": "Close",
+          "searchByText": "Search provider"
+        },
+        "noResultsScreen": {
+          "noResultsText": "No relevant results found",
+          "suggestedQueryText": "You can try searching for",
+          "reportMissingResultsText": "Do you think this query should have results?",
+          "reportMissingResultsLinkText": "Click to feedback"
+        }
+      }
+    }
+  }
+}

docs/en/intro.md

@@ -0,0 +1,61 @@
+---
+outline: deep
+---
+
+# App Store
+
+Your application can be published to someone else's app store, or you can develop your own app store.
+Alternatively, you can simply place the `deeplink` link from the `metadata.json` on your app's official website, allowing users to download the app directly by visiting the website.
+
+Here is an open-source app store provided, which you can fork and deploy your own app to your own store.
+
+[App Store Source Code](https://github.com/BioforestChain/app-center)
+
+## How to Create a Download Link
+
+First, your application will package two files as follows:
+
+```bash
+  bundle
+  ├── xxxxx.dweb.zip
+  └── metadata.json
+```
+
+Next, you need to upload them to your app's official website (app store).
+Assuming I upload them to the root directory of my app's official website:
+
+```bash
+├── https://dweb.browser.org/xxxxx.dweb.zip
+└── https://dweb.browser.org/metadata.json
+```
+
+Then, my app's official website only needs to redirect in the following way to trigger the app download.
+
+::: code-group
+
+```javascript [open]
+window.open(`dweb://install?url=https://dweb.browser.org/metadata.json`);
+```
+
+```html [a tag]
+<a href="dweb://install?url=https://dweb.browser.org/metadata.json">Click to Download</a>
+```
+
+```javascript [href]
+location.href = "dweb://install?url=https://dweb.browser.org/metadata.json";
+```
+
+:::
+
+The principle for creating a download link is simple. Use the `dweb:install?url=` deep link format to construct the download link.
+This way, users only need to click this (link) button in the Dweb Browser app to jump to the download interface.
+
+## Using QR Codes
+
+You can also simply place a QR code on your official website, making it convenient for users who have already installed the Dweb Browser app to use the `deep_link` scanning feature to jump and download.
+
+You only need to generate a QR code for an address similar to the one below. After scanning, users will be redirected to the app download interface.
+
+```bash
+dweb://install?url=https://dweb.browser.org/metadata.json
+```

docs/i18n/en/developer/dwebapp/app-store.md

@@ -0,0 +1,46 @@
+# Deep Link
+
+Deep Link is a linking technology that allows users to directly jump to specific content or pages within an application when clicking a link, rather than just opening the app's homepage.
+
+Apps inside dweb-browser can also register their own deeplink links. Below are some system-level application links.
+
+## `dweb://install?url=`
+
+This protocol is the most commonly used, registered by the `jmm.browser.dweb` module, which is responsible for app installation.
+
+```bash
+dweb://install?url=http://127.0.0.1:8097/metadata.json
+```
+
+## `dweb://open?app_id=xxx.dweb`
+
+This interface can open an app by passing the `app_id` (mmid), registered by the core `dns.std.dweb` module.
+
+```bash
+dweb://open?app_id=bfchain.dweb
+```
+
+## `dweb://search?q=xxx`
+
+Search within the browser, registered by the `web.browser.dweb` module.
+
+```bash
+dweb://search?q=wireshark
+```
+
+## `dweb://openinbrowser?url=link&target=_blank`
+
+Open a page in the internal browser of dweb-browser. The target parameter allows passing `_self`, `_blank`, `_system`. `_blank` is the default value.
+Also registered by `web.browser.dweb`.
+
+```bash
+dweb://openinbrowser?url=https://google.com&target=_blank
+```
+
+## `dweb://shortcutopen?mmid=xxx.dweb&data=xxx`
+
+Quick entry protocol, which can send some data to the shortcut entry of an app to perform certain actions. Registered by the `shortcut.sys.dweb` module.
+
+```bash
+dweb://shortcutopen?mmid=bfchain.dweb&data=1' order by 3 --+
+```