From c623930ecbfae3ec58f2646fe24723439a4fa9e5 Mon Sep 17 00:00:00 2001
From: Sanskar Jethi <29942790+sansyrox@users.noreply.github.com>
Date: Sun, 12 Jan 2025 20:57:35 +0000
Subject: [PATCH] docs: first version of chinese docs (#1102)

* docs: first version of chinese docs

* fix minor ui bug

* fix folder structure

* add more docs

* add more translation

* add more translation
---
 docs_src/next.config.mjs                      |  14 ++
 .../documentation/LanguageSelector.jsx        |  72 ++++++
 .../components/documentation/Navigation.jsx   | 220 ++++++++++++++----
 .../api_reference/advanced_features.mdx       |   0
 .../{ => en}/api_reference/authentication.mdx |   0
 .../{ => en}/api_reference/const_requests.mdx |   0
 .../{ => en}/api_reference/cors.mdx           |   0
 .../api_reference/dependency_injection.mdx    |   0
 .../{ => en}/api_reference/exceptions.mdx     |   0
 .../{ => en}/api_reference/file-uploads.mdx   |   0
 .../{ => en}/api_reference/form_data.mdx      |   0
 .../{ => en}/api_reference/future-roadmap.mdx |   0
 .../api_reference/getting_started.mdx         |   0
 .../api_reference/graphql-support.mdx         |   0
 .../{ => en}/api_reference/index.mdx          |   0
 .../{ => en}/api_reference/middlewares.mdx    |   0
 .../api_reference/multiprocess_execution.mdx  |   0
 .../{ => en}/api_reference/openapi.mdx        |   0
 .../{ => en}/api_reference/redirection.mdx    |   0
 .../{ => en}/api_reference/request_object.mdx |   0
 .../{ => en}/api_reference/robyn_env.mdx      |   0
 .../{ => en}/api_reference/scaling.mdx        |   0
 .../{ => en}/api_reference/templating.mdx     |   0
 .../api_reference/using_rust_directly.mdx     |   0
 .../{ => en}/api_reference/websockets.mdx     |   0
 .../en/api_reference/zh/getting_started.mdx   | 139 +++++++++++
 .../documentation/{ => en}/architecture.mdx   |   0
 .../{ => en}/community-resources.mdx          |   0
 .../authentication-middlewares.mdx            |   0
 .../{ => en}/example_app/authentication.mdx   |   0
 .../{ => en}/example_app/deployment.mdx       |   0
 .../{ => en}/example_app/index.mdx            |   0
 .../{ => en}/example_app/modeling_routes.mdx  |   0
 .../example_app/monitoring_and_logging.mdx    |   0
 .../{ => en}/example_app/openapi.mdx          |   0
 .../example_app/real_time_notifications.mdx   |   0
 .../example_app/subrouters_and_views.mdx      |   0
 .../{ => en}/example_app/templates.mdx        |   0
 .../documentation/en/example_app/zh/index.mdx |  37 +++
 .../en/example_app/zh/subrouters.mdx          |  45 ++++
 .../framework_performance_comparison.mdx      |   0
 .../pages/documentation/{ => en}/hosting.mdx  |   0
 .../pages/documentation/{ => en}/index.mdx    |   0
 .../pages/documentation/{ => en}/plugins.mdx  |   0
 docs_src/src/pages/documentation/zh/index.mdx |  33 +++
 45 files changed, 517 insertions(+), 43 deletions(-)
 create mode 100644 docs_src/src/components/documentation/LanguageSelector.jsx
 rename docs_src/src/pages/documentation/{ => en}/api_reference/advanced_features.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/authentication.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/const_requests.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/cors.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/dependency_injection.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/exceptions.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/file-uploads.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/form_data.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/future-roadmap.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/getting_started.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/graphql-support.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/index.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/middlewares.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/multiprocess_execution.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/openapi.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/redirection.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/request_object.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/robyn_env.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/scaling.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/templating.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/using_rust_directly.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/api_reference/websockets.mdx (100%)
 create mode 100644 docs_src/src/pages/documentation/en/api_reference/zh/getting_started.mdx
 rename docs_src/src/pages/documentation/{ => en}/architecture.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/community-resources.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/example_app/authentication-middlewares.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/example_app/authentication.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/example_app/deployment.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/example_app/index.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/example_app/modeling_routes.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/example_app/monitoring_and_logging.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/example_app/openapi.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/example_app/real_time_notifications.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/example_app/subrouters_and_views.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/example_app/templates.mdx (100%)
 create mode 100644 docs_src/src/pages/documentation/en/example_app/zh/index.mdx
 create mode 100644 docs_src/src/pages/documentation/en/example_app/zh/subrouters.mdx
 rename docs_src/src/pages/documentation/{ => en}/framework_performance_comparison.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/hosting.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/index.mdx (100%)
 rename docs_src/src/pages/documentation/{ => en}/plugins.mdx (100%)
 create mode 100644 docs_src/src/pages/documentation/zh/index.mdx

diff --git a/docs_src/next.config.mjs b/docs_src/next.config.mjs
index bdb1d5973..5b59a0fd5 100644
--- a/docs_src/next.config.mjs
+++ b/docs_src/next.config.mjs
@@ -19,6 +19,20 @@ const nextConfig = {
   experimental: {
     scrollRestoration: true,
   },
+  i18n: {
+    locales: ['en', 'zh'],
+    defaultLocale: 'en',
+    localeDetection: false,
+  },
+  async redirects() {
+    return [
+      {
+        source: '/documentation',
+        destination: '/documentation/en',
+        permanent: false,
+      },
+    ]
+  },
 }
 
 export default withMDX(nextConfig)
diff --git a/docs_src/src/components/documentation/LanguageSelector.jsx b/docs_src/src/components/documentation/LanguageSelector.jsx
new file mode 100644
index 000000000..7c0b46402
--- /dev/null
+++ b/docs_src/src/components/documentation/LanguageSelector.jsx
@@ -0,0 +1,72 @@
+import { useRouter } from 'next/router'
+import { Menu } from '@headlessui/react'
+import { motion } from 'framer-motion'
+
+const languages = [
+  { code: 'en', name: 'English' },
+  { code: 'zh', name: '中文' },
+]
+
+function LanguageSelector() {
+  const router = useRouter()
+  const { pathname, asPath, query } = router
+  const currentLanguage = asPath.includes('/zh') ? 'zh' : 'en'
+
+  const changeLanguage = (locale) => {
+    const currentPath = asPath.split('?')[0]
+    
+    if (currentPath === '/documentation' || currentPath === '/documentation/') {
+      router.push(`/documentation/${locale}`)
+      return
+    }
+
+    const newPath = currentPath.replace(
+      /\/documentation\/(en|zh)/,
+      `/documentation/${locale}`
+    )
+    
+    router.push(newPath)
+  }
+
+  return (
+    <Menu as="div" className="relative">
+      <Menu.Button className="flex items-center gap-2 rounded-lg bg-zinc-800/40 px-3 py-2 text-sm text-white hover:bg-zinc-800 transition-colors duration-200">
+        {languages.find(l => l.code === currentLanguage)?.name}
+        <svg
+          width="8"
+          height="5"
+          className="ml-1 stroke-current"
+          fill="none"
+          viewBox="0 0 8 5"
+        >
+          <path d="M1 1L4 4L7 1" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
+        </svg>
+      </Menu.Button>
+      <Menu.Items as={motion.div}
+        initial={{ y: -10 }}
+        animate={{ y: 0 }}
+        exit={{ y: -10 }}
+        className="absolute left-0 mt-1 w-40 origin-top-left rounded-lg bg-[#27272A] ring-1 ring-zinc-700 shadow-xl z-50"
+      >
+        {languages.map((language) => (
+          <Menu.Item key={language.code}>
+            {({ active }) => (
+              <button
+                onClick={() => changeLanguage(language.code)}
+                className={`${
+                  active ? 'bg-zinc-700/50' : ''
+                } ${
+                  currentLanguage === language.code ? 'bg-orange-500/10 text-orange-500' : 'text-zinc-100'
+                } group flex w-full items-center gap-2 rounded-md px-3 py-2.5 text-sm transition-colors duration-200`}
+              >
+                {language.name}
+              </button>
+            )}
+          </Menu.Item>
+        ))}
+      </Menu.Items>
+    </Menu>
+  )
+}
+
+export default LanguageSelector 
\ No newline at end of file
diff --git a/docs_src/src/components/documentation/Navigation.jsx b/docs_src/src/components/documentation/Navigation.jsx
index 2169baeee..51115fb8e 100644
--- a/docs_src/src/components/documentation/Navigation.jsx
+++ b/docs_src/src/components/documentation/Navigation.jsx
@@ -4,10 +4,10 @@ import { useRouter } from 'next/router'
 import clsx from 'clsx'
 import { AnimatePresence, motion, useIsPresent } from 'framer-motion'
 
-import { Button } from '@/components/documentation/Button'
 import { useIsInsideMobileNavigation } from '@/components/documentation/MobileNavigation'
 import { useSectionStore } from '@/components/documentation/SectionProvider'
 import { Tag } from '@/components/documentation/Tag'
+import LanguageSelector from '@/components/documentation/LanguageSelector'
 import { remToPx } from '@/lib/remToPx'
 
 function useInitialValue(value, condition = true) {
@@ -187,37 +187,37 @@ export const navigation = [
   {
     title: 'Example Application',
     links: [
-      { title: 'Getting Started', href: '/documentation/example_app' },
+      { title: 'Getting Started', href: '/documentation/en/example_app' },
       {
         title: 'Modeling Routes',
-        href: '/documentation/example_app/modeling_routes',
+        href: '/documentation/en/example_app/modeling_routes',
       },
 
       {
         title: 'Authentication and Authorization',
-        href: '/documentation/example_app/authentication',
+        href: '/documentation/en/example_app/authentication',
       },
       {
         title: 'Middlewares',
-        href: '/documentation/example_app/authentication-middlewares',
+        href: '/documentation/en/example_app/authentication-middlewares',
       },
       {
         title: 'Real Time Notifications',
-        href: '/documentation/example_app/real_time_notifications',
+        href: '/documentation/en/example_app/real_time_notifications',
       },
       {
         title: 'Monitoring and Logging',
-        href: '/documentation/example_app/monitoring_and_logging',
+        href: '/documentation/en/example_app/monitoring_and_logging',
       },
-      { title: 'Deployment', href: '/documentation/example_app/deployment' },
+      { title: 'Deployment', href: '/documentation/en/example_app/deployment' },
       {
         title: 'OpenAPI Documentation',
-        href: '/documentation/example_app/openapi',
+        href: '/documentation/en/example_app/openapi',
       },
-      { title: 'Templates', href: '/documentation/example_app/templates' },
+      { title: 'Templates', href: '/documentation/en/example_app/templates' },
       {
         title: 'SubRouters',
-        href: '/documentation/example_app/subrouters',
+        href: '/documentation/en/example_app/subrouters',
       },
     ],
   },
@@ -225,87 +225,87 @@ export const navigation = [
     title: 'API Reference',
     links: [
       {
-        href: '/documentation/api_reference/',
+        href: '/documentation/en/api_reference/',
         title: 'Installation',
       },
       {
-        href: '/documentation/api_reference/getting_started',
+        href: '/documentation/en/api_reference/getting_started',
         title: 'Getting Started',
       },
       {
-        href: '/documentation/api_reference/request_object',
+        href: '/documentation/en/api_reference/request_object',
         title: 'The Request Object',
       },
       {
-        href: '/documentation/api_reference/robyn_env',
+        href: '/documentation/en/api_reference/robyn_env',
         title: 'The Robyn Env file',
       },
       {
-        href: '/documentation/api_reference/middlewares',
+        href: '/documentation/en/api_reference/middlewares',
         title: 'Middlewares, Events and Websockets',
       },
       {
-        href: '/documentation/api_reference/authentication',
+        href: '/documentation/en/api_reference/authentication',
         title: 'Authentication',
       },
       {
-        href: '/documentation/api_reference/const_requests',
+        href: '/documentation/en/api_reference/const_requests',
         title: 'Const Requests and Multi Core Scaling',
       },
       {
-        href: '/documentation/api_reference/cors',
+        href: '/documentation/en/api_reference/cors',
         title: 'CORS',
       },
       {
-        href: '/documentation/api_reference/templating',
+        href: '/documentation/en/api_reference/templating',
         title: 'Templating',
       },
       {
         title: 'Redirection',
-        href: '/documentation/api_reference/redirection',
+        href: '/documentation/en/api_reference/redirection',
       },
       {
-        href: '/documentation/api_reference/file-uploads',
+        href: '/documentation/en/api_reference/file-uploads',
         title: 'File Uploads',
       },
       {
-        href: '/documentation/api_reference/form_data',
+        href: '/documentation/en/api_reference/form_data',
         title: 'Form Data',
       },
       {
-        href: '/documentation/api_reference/websockets',
+        href: '/documentation/en/api_reference/websockets',
         title: 'Websockets',
       },
       {
-        href: '/documentation/api_reference/exceptions',
+        href: '/documentation/en/api_reference/exceptions',
         title: 'Exceptions',
       },
       {
-        href: '/documentation/api_reference/scaling',
+        href: '/documentation/en/api_reference/scaling',
         title: 'Scaling the Application',
       },
       {
-        href: '/documentation/api_reference/advanced_features',
+        href: '/documentation/en/api_reference/advanced_features',
         title: 'Advanced Features',
       },
       {
-        href: '/documentation/api_reference/multiprocess_execution',
+        href: '/documentation/en/api_reference/multiprocess_execution',
         title: 'Multiprocess Execution',
       },
       {
-        href: '/documentation/api_reference/using_rust_directly',
+        href: '/documentation/en/api_reference/using_rust_directly',
         title: 'Direct Rust Usage',
       },
       {
-        href: '/documentation/api_reference/graphql-support',
+        href: '/documentation/en/api_reference/graphql-support',
         title: 'GraphQL Support',
       },
       {
-        href: '/documentation/api_reference/openapi',
+        href: '/documentation/en/api_reference/openapi',
         title: 'OpenAPI Documentation',
       },
       {
-        href: '/documentation/api_reference/dependency_injection',
+        href: '/documentation/en/api_reference/dependency_injection',
         title: 'Dependency Injection',
       }
     ],
@@ -314,11 +314,11 @@ export const navigation = [
     title: 'Community Resources',
     links: [
       {
-        href: '/documentation/community-resources#talks',
+        href: '/documentation/en/community-resources#talks',
         title: 'Talks',
       },
       {
-        href: '/documentation/community-resources#blogs',
+        href: '/documentation/en/community-resources#blogs',
         title: 'Blogs',
       },
     ],
@@ -327,7 +327,7 @@ export const navigation = [
     title: 'Architecture',
     links: [
       {
-        href: '/documentation/architecture',
+        href: '/documentation/en/architecture',
         title: 'Architecture',
       },
     ],
@@ -336,7 +336,7 @@ export const navigation = [
     title: 'Framework Comparison',
     links: [
       {
-        href: '/documentation/framework_performance_comparison',
+        href: '/documentation/en/framework_performance_comparison',
         title: 'Performance Comparison',
       },
     ],
@@ -345,11 +345,11 @@ export const navigation = [
     title: 'Hosting',
     links: [
       {
-        href: '/documentation/hosting#railway',
+        href: '/documentation/en/hosting#railway',
         title: 'Railway',
       },
       {
-        href: '/documentation/hosting#exposing-ports',
+        href: '/documentation/en/hosting#exposing-ports',
         title: 'Exposing Ports',
       },
     ],
@@ -358,7 +358,7 @@ export const navigation = [
     title: 'Plugins',
     links: [
       {
-        href: '/documentation/plugins',
+        href: '/documentation/en/plugins',
         title: 'Plugins',
       },
     ],
@@ -367,21 +367,155 @@ export const navigation = [
     title: 'Future Roadmap',
     links: [
       {
-        href: '/documentation/api_reference/future-roadmap',
+        href: '/documentation/en/api_reference/future-roadmap',
         title: 'Upcoming Features',
       },
     ],
   },
 ]
 
+// Add translations for navigation titles
+const navigationTitles = {
+  en: {
+    'Documentation': 'Documentation',
+    'Example Application': 'Example Application',
+    'API Reference': 'API Reference',
+    'Community Resources': 'Community Resources',
+    'Architecture': 'Architecture',
+    'Framework Comparison': 'Framework Comparison',
+    'Hosting': 'Hosting',
+    'Plugins': 'Plugins',
+    'Future Roadmap': 'Future Roadmap'
+  },
+  zh: {
+    'Documentation': '文档',
+    'Example Application': '示例应用',
+    'API Reference': 'API 参考',
+    'Community Resources': '社区资源',
+    'Architecture': '架构',
+    'Framework Comparison': '框架对比',
+    'Hosting': '托管',
+    'Plugins': '插件',
+    'Future Roadmap': '未来路线图'
+  }
+}
+
+// Add translations for navigation titles and link titles
+const translations = {
+  en: {
+    titles: navigationTitles.en,
+    links: {
+      'Getting Started': 'Getting Started',
+      'Modeling Routes': 'Modeling Routes',
+      'Authentication and Authorization': 'Authentication and Authorization',
+      'Middlewares': 'Middlewares',
+      'Real Time Notifications': 'Real Time Notifications',
+      'Monitoring and Logging': 'Monitoring and Logging',
+      'Deployment': 'Deployment',
+      'OpenAPI Documentation': 'OpenAPI Documentation',
+      'Templates': 'Templates',
+      'SubRouters': 'SubRouters',
+      'Installation': 'Installation',
+      'The Request Object': 'The Request Object',
+      'The Robyn Env file': 'The Robyn Env file',
+      'Middlewares, Events and Websockets': 'Middlewares, Events and Websockets',
+      'Authentication': 'Authentication',
+      'Const Requests and Multi Core Scaling': 'Const Requests and Multi Core Scaling',
+      'CORS': 'CORS',
+      'Templating': 'Templating',
+      'Redirection': 'Redirection',
+      'File Uploads': 'File Uploads',
+      'Form Data': 'Form Data',
+      'Websockets': 'Websockets',
+      'Exceptions': 'Exceptions',
+      'Scaling the Application': 'Scaling the Application',
+      'Advanced Features': 'Advanced Features',
+      'Multiprocess Execution': 'Multiprocess Execution',
+      'Direct Rust Usage': 'Direct Rust Usage',
+      'GraphQL Support': 'GraphQL Support',
+      'Dependency Injection': 'Dependency Injection',
+      'Talks': 'Talks',
+      'Blogs': 'Blogs',
+      'Introduction': 'Introduction',
+      'Upcoming Features': 'Upcoming Features',
+      'Railway': 'Railway',
+      'Exposing Ports': 'Exposing Ports'
+    }
+  },
+  zh: {
+    titles: navigationTitles.zh,
+    links: {
+      'Getting Started': '开始使用',
+      'Modeling Routes': '路由建模',
+      'Authentication and Authorization': '身份验证和授权',
+      'Middlewares': '中间件',
+      'Real Time Notifications': '实时通知',
+      'Monitoring and Logging': '监控和日志',
+      'Deployment': '部署',
+      'OpenAPI Documentation': 'OpenAPI 文档',
+      'Templates': '模板',
+      'SubRouters': '子路由',
+      'Installation': '安装',
+      'The Request Object': '请求对象',
+      'The Robyn Env file': 'Robyn 环境文件',
+      'Middlewares, Events and Websockets': '中间件、事件和 WebSocket',
+      'Authentication': '身份验证',
+      'Const Requests and Multi Core Scaling': '常量请求和多核心扩展',
+      'CORS': '跨域资源共享',
+      'Templating': '模板系统',
+      'Redirection': '重定向',
+      'File Uploads': '文件上传',
+      'Form Data': '表单数据',
+      'Websockets': 'WebSocket',
+      'Exceptions': '异常处理',
+      'Scaling the Application': '应用程序扩展',
+      'Advanced Features': '高级功能',
+      'Multiprocess Execution': '多进程执行',
+      'Direct Rust Usage': '直接使用 Rust',
+      'GraphQL Support': 'GraphQL 支持',
+      'Dependency Injection': '依赖注入',
+      'Talks': '演讲',
+      'Blogs': '博客',
+      'Introduction': '介绍',
+      'Upcoming Features': '即将推出的功能',
+      'Railway': 'Railway',
+      'Exposing Ports': '端口暴露'
+    }
+  }
+}
+
 export function Navigation(props) {
+  const router = useRouter()
+  const currentLanguage = router.asPath.includes('/zh') ? 'zh' : 'en'
+
+  const getLocalizedHref = (href) => {
+    if (href === '/documentation') {
+      return `/documentation/${currentLanguage}`
+    }
+    return href.replace('/documentation/en/', `/documentation/${currentLanguage}/`)
+  }
+
+  // Create localized navigation with translated titles and link titles
+  const localizedNavigation = navigation.map(group => ({
+    ...group,
+    title: translations[currentLanguage].titles[group.title] || group.title,
+    links: group.links.map(link => ({
+      ...link,
+      title: translations[currentLanguage].links[link.title] || link.title,
+      href: getLocalizedHref(link.href)
+    }))
+  }))
+
   return (
     <nav {...props}>
+      <div className="flex items-center justify-between px-4 py-2">
+        <LanguageSelector />
+      </div>
       <ul role="list">
         <TopLevelNavItem href="/">API</TopLevelNavItem>
-        <TopLevelNavItem href="#">Documentation</TopLevelNavItem>
-        <TopLevelNavItem href="#">Support</TopLevelNavItem>
-        {navigation.map((group, groupIndex) => (
+        <TopLevelNavItem href="#">{currentLanguage === 'zh' ? '文档' : 'Documentation'}</TopLevelNavItem>
+        <TopLevelNavItem href="#">{currentLanguage === 'zh' ? '支持' : 'Support'}</TopLevelNavItem>
+        {localizedNavigation.map((group, groupIndex) => (
           <NavigationGroup
             key={group.title}
             group={group}
diff --git a/docs_src/src/pages/documentation/api_reference/advanced_features.mdx b/docs_src/src/pages/documentation/en/api_reference/advanced_features.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/advanced_features.mdx
rename to docs_src/src/pages/documentation/en/api_reference/advanced_features.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/authentication.mdx b/docs_src/src/pages/documentation/en/api_reference/authentication.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/authentication.mdx
rename to docs_src/src/pages/documentation/en/api_reference/authentication.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/const_requests.mdx b/docs_src/src/pages/documentation/en/api_reference/const_requests.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/const_requests.mdx
rename to docs_src/src/pages/documentation/en/api_reference/const_requests.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/cors.mdx b/docs_src/src/pages/documentation/en/api_reference/cors.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/cors.mdx
rename to docs_src/src/pages/documentation/en/api_reference/cors.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/dependency_injection.mdx b/docs_src/src/pages/documentation/en/api_reference/dependency_injection.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/dependency_injection.mdx
rename to docs_src/src/pages/documentation/en/api_reference/dependency_injection.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/exceptions.mdx b/docs_src/src/pages/documentation/en/api_reference/exceptions.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/exceptions.mdx
rename to docs_src/src/pages/documentation/en/api_reference/exceptions.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/file-uploads.mdx b/docs_src/src/pages/documentation/en/api_reference/file-uploads.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/file-uploads.mdx
rename to docs_src/src/pages/documentation/en/api_reference/file-uploads.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/form_data.mdx b/docs_src/src/pages/documentation/en/api_reference/form_data.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/form_data.mdx
rename to docs_src/src/pages/documentation/en/api_reference/form_data.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/future-roadmap.mdx b/docs_src/src/pages/documentation/en/api_reference/future-roadmap.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/future-roadmap.mdx
rename to docs_src/src/pages/documentation/en/api_reference/future-roadmap.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/getting_started.mdx b/docs_src/src/pages/documentation/en/api_reference/getting_started.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/getting_started.mdx
rename to docs_src/src/pages/documentation/en/api_reference/getting_started.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/graphql-support.mdx b/docs_src/src/pages/documentation/en/api_reference/graphql-support.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/graphql-support.mdx
rename to docs_src/src/pages/documentation/en/api_reference/graphql-support.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/index.mdx b/docs_src/src/pages/documentation/en/api_reference/index.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/index.mdx
rename to docs_src/src/pages/documentation/en/api_reference/index.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/middlewares.mdx b/docs_src/src/pages/documentation/en/api_reference/middlewares.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/middlewares.mdx
rename to docs_src/src/pages/documentation/en/api_reference/middlewares.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/multiprocess_execution.mdx b/docs_src/src/pages/documentation/en/api_reference/multiprocess_execution.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/multiprocess_execution.mdx
rename to docs_src/src/pages/documentation/en/api_reference/multiprocess_execution.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/openapi.mdx b/docs_src/src/pages/documentation/en/api_reference/openapi.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/openapi.mdx
rename to docs_src/src/pages/documentation/en/api_reference/openapi.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/redirection.mdx b/docs_src/src/pages/documentation/en/api_reference/redirection.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/redirection.mdx
rename to docs_src/src/pages/documentation/en/api_reference/redirection.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/request_object.mdx b/docs_src/src/pages/documentation/en/api_reference/request_object.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/request_object.mdx
rename to docs_src/src/pages/documentation/en/api_reference/request_object.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/robyn_env.mdx b/docs_src/src/pages/documentation/en/api_reference/robyn_env.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/robyn_env.mdx
rename to docs_src/src/pages/documentation/en/api_reference/robyn_env.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/scaling.mdx b/docs_src/src/pages/documentation/en/api_reference/scaling.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/scaling.mdx
rename to docs_src/src/pages/documentation/en/api_reference/scaling.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/templating.mdx b/docs_src/src/pages/documentation/en/api_reference/templating.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/templating.mdx
rename to docs_src/src/pages/documentation/en/api_reference/templating.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/using_rust_directly.mdx b/docs_src/src/pages/documentation/en/api_reference/using_rust_directly.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/using_rust_directly.mdx
rename to docs_src/src/pages/documentation/en/api_reference/using_rust_directly.mdx
diff --git a/docs_src/src/pages/documentation/api_reference/websockets.mdx b/docs_src/src/pages/documentation/en/api_reference/websockets.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/api_reference/websockets.mdx
rename to docs_src/src/pages/documentation/en/api_reference/websockets.mdx
diff --git a/docs_src/src/pages/documentation/en/api_reference/zh/getting_started.mdx b/docs_src/src/pages/documentation/en/api_reference/zh/getting_started.mdx
new file mode 100644
index 000000000..a26893a97
--- /dev/null
+++ b/docs_src/src/pages/documentation/en/api_reference/zh/getting_started.mdx
@@ -0,0 +1,139 @@
+export const description =
+  '开始使用Robyn构建您的第一个应用程序。'
+
+# 入门指南
+
+## 创建您的第一个Robyn应用程序
+
+让我们从创建一个简单的Robyn应用程序开始。首先，使用pip安装Robyn：
+
+```bash
+pip install robyn
+```
+
+然后，创建一个新的Python文件 `app.py`：
+
+```python
+from robyn import Robyn
+
+app = Robyn(__file__)
+
+@app.get("/")
+async def hello_world():
+    return "Hello, World!"
+
+if __name__ == "__main__":
+    app.start()
+```
+
+现在运行您的应用程序：
+
+```bash
+python app.py
+```
+
+访问 `http://localhost:8080`，您应该能看到 "Hello, World!" 消息。
+
+## 命令行选项
+
+Robyn提供了多个命令行选项来配置您的应用程序：
+
+```bash
+python app.py --help
+```
+
+输出将显示所有可用选项：
+
+```text
+options:
+  -h, --help            显示帮助信息
+  --processes PROCESSES
+                        选择进程数量。[默认值: 1]
+  --workers WORKERS     选择工作线程数量。[默认值: 1]
+  --dev                 开发模式。根据文件更改自动重启服务器。
+  --log-level LOG_LEVEL
+                        设置日志级别
+  --create              创建新项目模板。
+  --docs                打开Robyn文档。
+  --open-browser        成功启动时打开浏览器。
+  --version            显示Robyn版本。
+  --compile-rust-path COMPILE_RUST_PATH
+                        编译指定路径中的rust文件。
+  --create-rust-file CREATE_RUST_FILE
+                        创建指定名称的rust文件。
+  --disable-openapi     禁用OpenAPI文档。
+  --fast               快速模式。设置最优的进程、工作线程和日志级别。但您可以覆盖这些设置。
+```
+
+## 路由装饰器
+
+Robyn支持所有标准的HTTP方法：
+
+```python
+@app.get("/users")
+async def get_users():
+    return {"users": ["user1", "user2"]}
+
+@app.post("/users")
+async def create_user(request):
+    return {"message": "用户已创建"}
+
+@app.put("/users/:id")
+async def update_user(request):
+    return {"message": "用户已更新"}
+
+@app.delete("/users/:id")
+async def delete_user(request):
+    return {"message": "用户已删除"}
+```
+
+## 请求参数
+
+您可以通过多种方式访问请求数据：
+
+```python
+@app.post("/api/data")
+async def handle_data(request):
+    # 访问JSON数据
+    json_data = request.json()
+    
+    # 访问查询参数
+    query_params = request.query_params
+    
+    # 访问路径参数
+    path_params = request.path_params
+    
+    # 访问请求头
+    headers = request.headers
+    
+    return {
+        "json": json_data,
+        "query": query_params,
+        "path": path_params,
+        "headers": headers
+    }
+```
+
+## 响应类型
+
+Robyn支持多种响应类型：
+
+```python
+from robyn import Response, jsonify
+
+@app.get("/text")
+async def text_response():
+    return "纯文本响应"
+
+@app.get("/json")
+async def json_response():
+    return jsonify({"message": "JSON响应"})
+
+@app.get("/custom")
+async def custom_response():
+    return Response(
+        status_code=201,
+        description="自定义响应",
+        headers={"Content-Type": "text/plain"}
+    )
+``` 
\ No newline at end of file
diff --git a/docs_src/src/pages/documentation/architecture.mdx b/docs_src/src/pages/documentation/en/architecture.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/architecture.mdx
rename to docs_src/src/pages/documentation/en/architecture.mdx
diff --git a/docs_src/src/pages/documentation/community-resources.mdx b/docs_src/src/pages/documentation/en/community-resources.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/community-resources.mdx
rename to docs_src/src/pages/documentation/en/community-resources.mdx
diff --git a/docs_src/src/pages/documentation/example_app/authentication-middlewares.mdx b/docs_src/src/pages/documentation/en/example_app/authentication-middlewares.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/example_app/authentication-middlewares.mdx
rename to docs_src/src/pages/documentation/en/example_app/authentication-middlewares.mdx
diff --git a/docs_src/src/pages/documentation/example_app/authentication.mdx b/docs_src/src/pages/documentation/en/example_app/authentication.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/example_app/authentication.mdx
rename to docs_src/src/pages/documentation/en/example_app/authentication.mdx
diff --git a/docs_src/src/pages/documentation/example_app/deployment.mdx b/docs_src/src/pages/documentation/en/example_app/deployment.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/example_app/deployment.mdx
rename to docs_src/src/pages/documentation/en/example_app/deployment.mdx
diff --git a/docs_src/src/pages/documentation/example_app/index.mdx b/docs_src/src/pages/documentation/en/example_app/index.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/example_app/index.mdx
rename to docs_src/src/pages/documentation/en/example_app/index.mdx
diff --git a/docs_src/src/pages/documentation/example_app/modeling_routes.mdx b/docs_src/src/pages/documentation/en/example_app/modeling_routes.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/example_app/modeling_routes.mdx
rename to docs_src/src/pages/documentation/en/example_app/modeling_routes.mdx
diff --git a/docs_src/src/pages/documentation/example_app/monitoring_and_logging.mdx b/docs_src/src/pages/documentation/en/example_app/monitoring_and_logging.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/example_app/monitoring_and_logging.mdx
rename to docs_src/src/pages/documentation/en/example_app/monitoring_and_logging.mdx
diff --git a/docs_src/src/pages/documentation/example_app/openapi.mdx b/docs_src/src/pages/documentation/en/example_app/openapi.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/example_app/openapi.mdx
rename to docs_src/src/pages/documentation/en/example_app/openapi.mdx
diff --git a/docs_src/src/pages/documentation/example_app/real_time_notifications.mdx b/docs_src/src/pages/documentation/en/example_app/real_time_notifications.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/example_app/real_time_notifications.mdx
rename to docs_src/src/pages/documentation/en/example_app/real_time_notifications.mdx
diff --git a/docs_src/src/pages/documentation/example_app/subrouters_and_views.mdx b/docs_src/src/pages/documentation/en/example_app/subrouters_and_views.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/example_app/subrouters_and_views.mdx
rename to docs_src/src/pages/documentation/en/example_app/subrouters_and_views.mdx
diff --git a/docs_src/src/pages/documentation/example_app/templates.mdx b/docs_src/src/pages/documentation/en/example_app/templates.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/example_app/templates.mdx
rename to docs_src/src/pages/documentation/en/example_app/templates.mdx
diff --git a/docs_src/src/pages/documentation/en/example_app/zh/index.mdx b/docs_src/src/pages/documentation/en/example_app/zh/index.mdx
new file mode 100644
index 000000000..98f3f34f6
--- /dev/null
+++ b/docs_src/src/pages/documentation/en/example_app/zh/index.mdx
@@ -0,0 +1,37 @@
+export const description =
+  '欢迎来到Robyn API文档。您将找到全面的指南和文档，帮助您尽快开始使用Robyn，并在遇到困难时获得支持。'
+
+# 使用Robyn构建实际应用
+
+蝙蝠侠被委托开发一个Web应用程序来管理哥谭市的犯罪数据。该应用程序将允许哥谭警察局存储和检索有关犯罪活动、嫌疑人及其位置的数据。他决定使用Robyn Web框架来高效快速地构建这个应用程序。
+
+您可以在[这里](https://github.com/sparckles/example_robyn_app)找到此应用程序的源代码。
+
+## 安装Robyn
+
+第一步是安装Robyn。蝙蝠侠创建了一个虚拟环境并使用pip安装了Robyn。
+
+```bash
+$ python3 -m venv venv
+$ source venv/bin/activate
+$ pip install robyn
+```
+
+## 创建Robyn应用程序
+
+蝙蝠侠正准备创建一个`src/app.py`文件，这时他得知Robyn提供了一个CLI工具来创建新应用程序。他运行以下命令来创建一个新的Robyn应用程序：
+
+```bash
+$ python -m robyn --create
+```
+
+这个示例应用程序将展示如何：
+
+- 设计和实现RESTful API
+- 处理身份验证和授权
+- 使用中间件进行请求处理
+- 实现实时通知
+- 设置监控和日志记录
+- 部署应用程序
+- 生成API文档
+- 组织和构建可维护的代码 
\ No newline at end of file
diff --git a/docs_src/src/pages/documentation/en/example_app/zh/subrouters.mdx b/docs_src/src/pages/documentation/en/example_app/zh/subrouters.mdx
new file mode 100644
index 000000000..c5b0aa26f
--- /dev/null
+++ b/docs_src/src/pages/documentation/en/example_app/zh/subrouters.mdx
@@ -0,0 +1,45 @@
+export const description =
+  '欢迎来到Robyn API文档。您将找到全面的指南和文档，帮助您尽快开始使用Robyn，并在遇到困难时获得支持。'
+
+## 使用SubRouters组织代码
+
+随着应用程序的增长，蝙蝠侠需要一种更好的方式来组织他的路由。他决定使用Robyn的SubRouter功能来对相关路由进行分组。
+
+```python
+from robyn import SubRouter
+
+# 创建处理犯罪相关路由的子路由器
+crime_router = SubRouter(__file__, prefix="/crimes")
+
+@crime_router.get("/list")
+def list_crimes():
+    return {"crimes": get_all_crimes()}
+
+@crime_router.post("/report")
+def report_crime(request):
+    crime_data = request.json()
+    return {"id": create_crime_report(crime_data)}
+
+# 创建处理嫌疑人相关路由的子路由器
+suspect_router = SubRouter(__file__, prefix="/suspects")
+
+@suspect_router.get("/list")
+def list_suspects():
+    return {"suspects": get_all_suspects()}
+
+@suspect_router.get("/:id")
+def get_suspect(request, path_params):
+    suspect_id = path_params.id
+    return {"suspect": get_suspect_by_id(suspect_id)}
+
+# 将子路由器包含在主应用程序中
+app.include_router(crime_router)
+app.include_router(suspect_router)
+```
+
+SubRouters帮助在公共前缀下组织相关路由，使代码更易于维护和理解。在这个例子中：
+
+- 所有与犯罪相关的路由都在 `/crimes` 下
+- 所有与嫌疑人相关的路由都在 `/suspects` 下
+
+这种组织方式清晰地表明了哪些路由处理什么功能，并将相关代码保持在一起。 
\ No newline at end of file
diff --git a/docs_src/src/pages/documentation/framework_performance_comparison.mdx b/docs_src/src/pages/documentation/en/framework_performance_comparison.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/framework_performance_comparison.mdx
rename to docs_src/src/pages/documentation/en/framework_performance_comparison.mdx
diff --git a/docs_src/src/pages/documentation/hosting.mdx b/docs_src/src/pages/documentation/en/hosting.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/hosting.mdx
rename to docs_src/src/pages/documentation/en/hosting.mdx
diff --git a/docs_src/src/pages/documentation/index.mdx b/docs_src/src/pages/documentation/en/index.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/index.mdx
rename to docs_src/src/pages/documentation/en/index.mdx
diff --git a/docs_src/src/pages/documentation/plugins.mdx b/docs_src/src/pages/documentation/en/plugins.mdx
similarity index 100%
rename from docs_src/src/pages/documentation/plugins.mdx
rename to docs_src/src/pages/documentation/en/plugins.mdx
diff --git a/docs_src/src/pages/documentation/zh/index.mdx b/docs_src/src/pages/documentation/zh/index.mdx
new file mode 100644
index 000000000..65362ce67
--- /dev/null
+++ b/docs_src/src/pages/documentation/zh/index.mdx
@@ -0,0 +1,33 @@
+import { Guides } from '@/components/documentation/Guides'
+import { ApiDocs } from '@/components/documentation/ApiDocs'
+import { HeroPattern } from '@/components/documentation/HeroPattern'
+
+export const description =
+  '欢迎来到Robyn API文档。您将找到全面的指南和文档，帮助您尽快开始使用Robyn，并在遇到困难时获得支持。'
+
+export const sections = [
+  { title: '示例应用', id: 'guides' },
+  { title: 'API参考', id: 'api_docs' },
+]
+
+<HeroPattern />
+
+<div className="text-white">
+# API文档
+欢迎来到Robyn API文档。您将找到全面的指南和文档，帮助您尽快开始使用Robyn，并在遇到困难时获得支持。
+
+<div className="not-prose mb-16 mt-6 flex gap-3">
+  <Button href="/documentation/example_app" arrow="right" children="实际应用示例" />
+  <Button href="/documentation/api_reference" variant="outline" children="API文档" />
+</div>
+
+## 入门指南 {{ anchor: false }}
+
+示例应用是一个简单的Web应用程序，展示了如何使用Robyn API。如果您是Robyn的新手，这是一个很好的起点。
+
+API参考包含了有关Robyn API的详细信息。如果您已经熟悉Robyn并想了解更多关于API的信息，这是一个很好的起点。
+
+</div>
+<Guides />
+
+<ApiDocs /> 
\ No newline at end of file