Adds translate support

.github/workflows/docs.yaml

@@ -0,0 +1,75 @@
+name: Split Docs
+
+on:
+  push:
+    paths:
+      - 'docs/**'
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  translate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.1
+          tools: phpize
+          extensions: swoole, redis
+          ini-values: extension=opencc
+
+      - name: Install OpenCC
+        run: |
+          sudo apt-get install libopencc-dev -y
+
+      - name: Build opencc4php
+        run: |
+          git clone https://github.com/nauxliu/opencc4php.git --depth 1
+          cd opencc4php
+          phpize
+          ./configure
+          make
+          sudo make install
+          php --ri opencc
+          cd ..
+          rm -rf opencc4php
+
+      - name: Setup Dependencies
+        run: composer install
+
+      - name: Start Translate
+        run: php bin/doc-translate
+
+      - name: Commit Updated
+        uses: stefanzweifel/git-auto-commit-action@v4
+        with:
+          commit_message: Update docs and translate
+  split:
+    needs: translate
+    name: Split on branch ${{ github.ref }}
+    if: github.repository == 'friendsofhyperf/components'
+    runs-on: ubuntu-22.04
+    env:
+      SSH_PRIVATE_KEY: ${{ secrets.SPLIT_PRIVATE_KEY }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Setup Private Key
+        run: |
+          mkdir -p ~/.ssh
+          echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_rsa
+          chmod 600 ~/.ssh/id_rsa
+          echo "StrictHostKeyChecking no" >> ~/.ssh/config
+      - name: Split And Push
+        run: |
+          git config pull.rebase true
+          git config --global user.email "huangdijia@gmail.com"
+          git config --global user.name "Deeka Wong"
+          ./bin/split-docs.sh

bin/doc-translate

@@ -0,0 +1,63 @@
+#!/usr/bin/env php
+<?php
+
+declare(strict_types=1);
+/**
+ * This file is part of friendsofhyperf/components.
+ *
+ * @link     https://github.com/friendsofhyperf/components
+ * @document https://github.com/friendsofhyperf/components/blob/main/README.md
+ * @contact  huangdijia@gmail.com
+ */
+! defined('BASE_PATH') && define('BASE_PATH', dirname(__DIR__, 1));
+
+require BASE_PATH . '/vendor/autoload.php';
+
+use Symfony\Component\Finder\Finder;
+
+$config = [
+    'zh-tw' => [
+        'targetDir' => BASE_PATH . '/docs/zh-tw/',
+        'rule' => 's2twp.json',
+    ],
+    'zh-hk' => [
+        'targetDir' => BASE_PATH . '/docs/zh-hk/',
+        'rule' => 's2hk.json',
+    ],
+    // 'en' => [
+    //     'targetDir' => BASE_PATH . '/docs/en/',
+    //     'rule' => 's2en.json',
+    // ],
+];
+
+$finder = new Finder();
+$finder->files()->in(BASE_PATH . '/docs/zh-cn');
+
+foreach ($config as $key => $item) {
+    $od = opencc_open($item['rule']);
+    foreach ($finder as $fileInfo) {
+        $targetDir = $item['targetDir'];
+        $targetPath = $targetDir . $fileInfo->getRelativePath();
+        $isCreateDir = false;
+        if (! is_dir($targetPath)) {
+            mkdir($targetPath, 0777, true);
+            chmod($targetPath, 0777);
+            $isCreateDir = true;
+        }
+        if (! is_writable($targetPath)) {
+            echo sprintf('Target path %s is not writable.' . PHP_EOL, $targetPath);
+        }
+        if ($fileInfo->getExtension() === 'md') {
+            $translated = opencc_convert($fileInfo->getContents(), $od);
+            $translated = str_replace('](zh-cn/', '](' . $key . '/', $translated);
+            $translated = str_replace('](/zh-cn/', '](/' . $key . '/', $translated);
+            $translated = str_replace('](./zh-cn/', '](./' . $key . '/', $translated);
+            $targetTranslatedPath = $targetDir . $fileInfo->getRelativePathname();
+            @file_put_contents($targetTranslatedPath, $translated);
+        } else {
+            $targetTranslatedPath = $targetDir . $fileInfo->getRelativePathname();
+            @copy($fileInfo->getRealPath(), $targetTranslatedPath);
+        }
+    }
+    opencc_close($od);
+}

docs/.vitepress/config.mts

@@ -1,10 +1,21 @@
 import { defineConfig } from 'vitepress'
+
 import enGetConfig from "./src/en/config";
 import enGetNavs from "./src/en/nav";
 import enGetSidebar from "./src/en/sidebars";
-import zhGetConfig from "./src/zh/config";
-import zhGetNavs from "./src/zh/nav";
-import zhGetSidebar from "./src/zh/sidebars";
+
+import cnGetConfig from "./src/zh-cn/config";
+import cnGetNavs from "./src/zh-cn/nav";
+import cnGetSidebar from "./src/zh-cn/sidebars";
+
+import hkGetConfig from "./src/zh-hk/config";
+import hkGetNavs from "./src/zh-hk/nav";
+import hkGetSidebar from "./src/zh-hk/sidebars";
+
+import twGetConfig from "./src/zh-tw/config";
+import twGetNavs from "./src/zh-tw/nav";
+import twGetSidebar from "./src/zh-tw/sidebars";
+
 import taskLists from 'markdown-it-task-lists' 
 
 // https://vitepress.dev/reference/site-config
@@ -40,9 +51,37 @@ export default defineConfig({
   ],
   locales:{
     root:{
-      label:"中文",
+      label:"简体中文",
       lang:"zh",
-      ...zhGetConfig,
+      ...cnGetConfig,
+    },
+    "zh-hk":{
+      label:"繁體中文（港）",
+      lang:"zh-hk",
+      link:"/zh-hk/index",
+      ...hkGetConfig,
+      themeConfig:{
+        logo: '/logo.svg',
+        nav: hkGetNavs,
+        sidebar:hkGetSidebar,
+        outline:{
+          level:[2 ,4],
+        },
+      }
+    },
+    "zh-tw":{
+      label:"繁體中文（臺）",
+      lang:"zh-tw",
+      link:"/zh-tw/index",
+      ...twGetConfig,
+      themeConfig:{
+        logo: '/logo.svg',
+        nav: twGetNavs,
+        sidebar:twGetSidebar,
+        outline:{
+          level:[2 ,4],
+        },
+      }
     },
     en:{
       label:"English",
@@ -128,9 +167,9 @@ export default defineConfig({
     i18nRouting:false,
     // https://vitepress.dev/reference/default-theme-config
 
-    nav: zhGetNavs,
+    nav: cnGetNavs,
 
-    sidebar: zhGetSidebar,
+    sidebar: cnGetSidebar,
 
     socialLinks: [
       { icon: 'github', link: 'https://github.com/friendsofhyperf/components' },

docs/.vitepress/src/zh/nav.ts → docs/.vitepress/src/zh-cn/nav.ts

@@ -1,9 +1,8 @@
 import {DefaultTheme} from "vitepress";
 
 const nav:DefaultTheme.NavItem[] = [
-    // { text: '入门', link: '/zh_CN/guide/' },
-    { text: '组件', link: '/zh_CN/components/' },
-    { text: 'FAQ', link: '/zh_CN/faq/index' },
+    { text: '组件', link: '/zh-cn/components/' },
+    { text: 'FAQ', link: '/zh-cn/faq/index' },
     { text: '更多', items:[
             { text: 'Hyperf', link: 'https://hyperf.wiki/' },
             { text: 'MineAdmin', link: 'https://www.mineadmin.com/' }