docs: translate and correct documents (#1525)

* feat(website): write english translations

* docs(website): delete unnecessary files

* feat(website): update term translations

* docs(website): add Chinese documents

* chore(crowdin): update crowdin config

* docs(filename): keep the new document filename consistent with the old filename style

* chore: add documentation issue template

.github/ISSUE_TEMPLATE/documentation.yml

@@ -0,0 +1,39 @@
+name: Documentation
+description: Report an issue related to documentation.
+# title: ""
+labels: ["documentation"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This template is only used for documentation related requests, including:
+
+        - Log undocumented APIs
+        - Update link
+        - Documentation other than non-project code
+
+        If you followed the documentation but things don't work, take some time to consider if it's the documentation or the code that's wrong. In the latter, prefer using the "[Bug Report](https://github.com/wailsapp/wails/issues/new?assignees=&labels=bug&template=bug_report.yml)" template.
+
+  - type: checkboxes
+    attributes:
+      label: Have you read the Documentation Contribution Guidelines?
+      options:
+        - label: I have read the [Documentation Contribution Guidelines](https://wails.io/docs/next/contributing/documenting).
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Description
+      description: A clear and concise description of what the issue is.
+    validations:
+      required: true
+
+  - type: checkboxes
+    attributes:
+      label: Self-service
+      description: |
+        If you feel like you could contribute to this issue, please check the box below. This would tell us and other people looking for contributions that someone's working on it.
+        If you do check this box, please send a pull request within 7 days so we can still delegate this to someone else.
+      options:
+        - label: I'd be willing to address this documentation request myself.

crowdin.yml

@@ -1,9 +1,33 @@
+project_id: 527906
+api_token_env: CROWDIN_PERSONAL_TOKEN
+
 files:
-  - source: website/docs
-    translation: /website/i18n/%locale%/docusaurus-plugin-content-docs/current/%original_file_name%
-  - source: website/blog
+  # Docs
+  - source: /website/docs/**/*
+    translation: /website/i18n/%locale%/docusaurus-plugin-content-docs/current/**/%original_file_name%
+    ignore: [/**/*.json]
+
+  # Blog
+  - source: /website/blog/*
     translation: /website/i18n/%locale%/docusaurus-plugin-content-blog/%original_file_name%
-  - source: website/src/pages
-    translation: /website/i18n/%locale%/docusaurus-plugin-content-pages/%original_file_name%
-  - source: website/i18n/en/docusaurus-theme-classic
-    translation: /website/i18n/%locale%/docusaurus-theme-classic/%original_file_name%s
+
+  # Pages
+  - source: /website/src/pages/**/*
+    translation: /website/i18n/%locale%/docusaurus-plugin-content-pages/**/%original_file_name%
+    ignore: [/**/*.json, /**/*.js, /**/*.jsx, /**/*.ts, /**/*.tsx, /**/*.css]
+
+  # Configuration files
+  # - source: /website/i18n/en/docusaurus-plugin-content-blog/*
+  #   translation: /website/i18n/%locale%/docusaurus-plugin-content-blog/%original_file_name%
+
+  # - source: /website/i18n/en/docusaurus-plugin-content-docs/*
+  #   translation: /website/i18n/%locale%/docusaurus-plugin-content-docs/%original_file_name%
+
+  # - source: /website/i18n/en/docusaurus-theme-classic/*
+  #   translation: /website/i18n/%locale%/docusaurus-theme-classic/%original_file_name%
+
+  # - source: /website/i18n/en/*
+  #   translation: /website/i18n/%locale%/%original_file_name%
+
+  - source: /website/i18n/en/**/*.json
+    translation: /website/i18n/%locale%/**/%original_file_name%

website/blog/authors.yml

@@ -5,7 +5,7 @@ leaanthony:
   image_url: https://github.com/leaanthony.png
 
 misitebao:
-  name: Misitebao
+  name: Misite Bao
   title: Architect
   url: https://github.com/misitebao
   image_url: https://github.com/misitebao.png

website/i18n/en/code.json

@@ -287,5 +287,17 @@
   "theme.tags.tagsPageTitle": {
     "message": "Tags",
     "description": "The title of the tag list page"
+  },
+  "theme.docs.breadcrumbs.home": {
+    "message": "Home page",
+    "description": "The ARIA label for the home page in the breadcrumbs"
+  },
+  "theme.docs.breadcrumbs.navAriaLabel": {
+    "message": "Breadcrumbs",
+    "description": "The ARIA label for the breadcrumbs"
+  },
+  "theme.CodeBlock.wordWrapToggle": {
+    "message": "Toggle word wrap",
+    "description": "The title attribute for toggle word wrapping button of code block lines"
   }
 }

website/i18n/en/docusaurus-plugin-content-docs/current.json

@@ -26,5 +26,13 @@
   "sidebar.tutorialSidebar.category.Guides": {
     "message": "Guides",
     "description": "The label for category Guides in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Tutorials": {
+    "message": "Tutorials",
+    "description": "The label for category Tutorials in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Contributing": {
+    "message": "Contributing",
+    "description": "The label for category Contributing in sidebar tutorialSidebar"
   }
 }

website/i18n/en/docusaurus-plugin-content-docs/version-v2.0.0-beta.38.json

@@ -1,30 +1,30 @@
 {
   "version.label": {
-    "message": "v2.0.0-beta.34",
-    "description": "The label for version v2.0.0-beta.34"
+    "message": "v2.0.0-beta.38",
+    "description": "The label for version v2.0.0-beta.38"
   },
   "sidebar.tutorialSidebar.category.Getting Started": {
-    "message": "快速入门",
+    "message": "Getting Started",
     "description": "The label for category Getting Started in sidebar tutorialSidebar"
   },
   "sidebar.tutorialSidebar.category.Reference": {
-    "message": "参考",
+    "message": "Reference",
     "description": "The label for category Reference in sidebar tutorialSidebar"
   },
   "sidebar.tutorialSidebar.category.Runtime": {
-    "message": "运行时",
+    "message": "Runtime",
     "description": "The label for category Runtime in sidebar tutorialSidebar"
   },
   "sidebar.tutorialSidebar.category.Community": {
-    "message": "社区",
+    "message": "Community",
     "description": "The label for category Community in sidebar tutorialSidebar"
   },
   "sidebar.tutorialSidebar.category.Showcase": {
-    "message": "项目展示",
+    "message": "Showcase",
     "description": "The label for category Showcase in sidebar tutorialSidebar"
   },
   "sidebar.tutorialSidebar.category.Guides": {
-    "message": "指南",
+    "message": "Guides",
     "description": "The label for category Guides in sidebar tutorialSidebar"
   }
 }

website/i18n/en/docusaurus-plugin-content-docs/version-v2.0.0-beta.39.json

@@ -0,0 +1,38 @@
+{
+  "version.label": {
+    "message": "v2.0.0-beta.39",
+    "description": "The label for version v2.0.0-beta.39"
+  },
+  "sidebar.tutorialSidebar.category.Getting Started": {
+    "message": "Getting Started",
+    "description": "The label for category Getting Started in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Reference": {
+    "message": "Reference",
+    "description": "The label for category Reference in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Runtime": {
+    "message": "Runtime",
+    "description": "The label for category Runtime in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Community": {
+    "message": "Community",
+    "description": "The label for category Community in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Showcase": {
+    "message": "Showcase",
+    "description": "The label for category Showcase in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Guides": {
+    "message": "Guides",
+    "description": "The label for category Guides in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Tutorials": {
+    "message": "Tutorials",
+    "description": "The label for category Tutorials in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Contributing": {
+    "message": "Contributing",
+    "description": "The label for category Contributing in sidebar tutorialSidebar"
+  }
+}

website/i18n/en/docusaurus-theme-classic/footer.json

@@ -46,5 +46,9 @@
   "copyright": {
     "message": "Copyright © 2022 Lea Anthony. Built with Docusaurus.",
     "description": "The footer copyright"
+  },
+  "link.item.label.Awesome": {
+    "message": "Awesome",
+    "description": "The label of footer link with label=Awesome linking to https://github.com/wailsapp/awesome-wails"
   }
 }

website/i18n/en/docusaurus-theme-classic/navbar.json

@@ -14,5 +14,29 @@
   "item.label.GitHub": {
     "message": "GitHub",
     "description": "Navbar item with label GitHub"
+  },
+  "item.label.About": {
+    "message": "About",
+    "description": "Navbar item with label About"
+  },
+  "item.label.FAQ": {
+    "message": "FAQ",
+    "description": "Navbar item with label FAQ"
+  },
+  "item.label.Changelog": {
+    "message": "Changelog",
+    "description": "Navbar item with label Changelog"
+  },
+  "item.label.Community Guide": {
+    "message": "Community Guide",
+    "description": "Navbar item with label Community Guide"
+  },
+  "item.label.Credits": {
+    "message": "Credits",
+    "description": "Navbar item with label Credits"
+  },
+  "item.label.Stats": {
+    "message": "Stats",
+    "description": "Navbar item with label Stats"
   }
 }

website/i18n/zh-Hans/code.json

@@ -287,5 +287,17 @@
   "theme.tags.tagsPageTitle": {
     "message": "标签",
     "description": "The title of the tag list page"
+  },
+  "theme.docs.breadcrumbs.home": {
+    "message": "主页面",
+    "description": "The ARIA label for the home page in the breadcrumbs"
+  },
+  "theme.docs.breadcrumbs.navAriaLabel": {
+    "message": "页面路径",
+    "description": "The ARIA label for the breadcrumbs"
+  },
+  "theme.CodeBlock.wordWrapToggle": {
+    "message": "切换自动换行",
+    "description": "The title attribute for toggle word wrapping button of code block lines"
   }
 }

website/i18n/zh-Hans/docusaurus-plugin-content-blog/authors.yml

@@ -5,7 +5,7 @@ leaanthony:
   image_url: https://github.com/leaanthony.png
 
 misitebao:
-  name: Misitebao
+  name: 米司特包
   title: 架构师
   url: https://github.com/misitebao
   image_url: https://github.com/misitebao.png

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current.json

@@ -26,5 +26,13 @@
   "sidebar.tutorialSidebar.category.Guides": {
     "message": "指南",
     "description": "The label for category Guides in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Tutorials": {
+    "message": "教程",
+    "description": "The label for category Tutorials in sidebar tutorialSidebar"
+  },
+  "sidebar.tutorialSidebar.category.Contributing": {
+    "message": "参与贡献",
+    "description": "The label for category Contributing in sidebar tutorialSidebar"
   }
 }

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/community/showcase/october.mdx

@@ -0,0 +1,11 @@
+# October
+
+<p style={{"text-align": "center"}}>
+   <img src="/img/showcase/october.png"></img><br/>
+</p>
+
+[October](https://october.utf9k.net) is a small Wails application that makes it really easy to extract highlights from [Kobo eReaders](https://en.wikipedia.org/wiki/Kobo_eReader) and then forward them to [Readwise](https://readwise.io).
+
+It has a relatively small scope with all platform versions weighing in under 10MB, and that's without enabling [UPX compression](https://upx.github.io/)!
+
+In contrast, the author's previous attempts with Electron quickly bloated to several hundred megabytes.

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/community/showcase/restic-browser.mdx

@@ -0,0 +1,11 @@
+
+# Restic Browser
+
+<p style={{"text-align": "center"}}>
+   <img src="/img/showcase/restic-browser-2.png"></img><br/>
+</p>
+
+[Restic-Browser](https://github.com/emuell/restic-browser) - A simple, cross-platform [restic](https://github.com/restic/restic) backup GUI for browsing and restoring restic repositories.
+
+
+

website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/contributing/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "Contributing",
+  "position": 99
+}