[docs] add zh docs (#3507)

* [docs] add zh docs

* [docs] add lang dropdown

* [docs] update mkdocs zh config

* [docs] migrate assets

* [docs] update overrides dir in mkdocs zh config

* [docs] exclude locales director in main mkdocs config

* [docs] rename assets to public to avoid conflicting with template

* [docs] extra_css change followup

* [docs] add theme.palette.toggle.icon back into mkdocs zh config

* [docs] fix zh readme reference + migrate language-specific repo markdown to docs

* [docs] translate remaining repo docs + update reference

* [docs] update zh index.md reference

* [docs/zh] wording alignment

mkdocs.yml

@@ -4,6 +4,7 @@ theme:
   name: material
   language: en
   font: false
+  custom_dir: docs/overrides
   features:
     - header.autohide
     - content.code.copy
@@ -34,8 +35,17 @@ plugins:
       syntaxHighlightTheme: obsidian
   - include-markdown
 
+extra:
+  alternate:
+    - name: English
+      link: /en/ 
+      lang: en
+    - name: 中文
+      link: /zh-cn/
+      lang: zh
+
 extra_css:
-  - assets/css/colours.css
+  - public/css/colours.css
 
 markdown_extensions:
   - admonition
@@ -57,6 +67,9 @@ markdown_extensions:
   - pymdownx.tabbed:
       alternate_style: true
 
+exclude_docs: |
+  locales/**
+
 nav:
   - "Home": "index.md"
   - "FAQ": "faq.md"