docs: update documentation localization and versioning system

- Migrated `UpdateWritersideVersionTask` to `UpdateDocsVersionTask`
- Added `version.json` for dynamic version management in documentation
- Improved localization support with Chinese translations
- Enhanced UI components with `Translate` usage
- Updated Gradle snippets to use dynamic version retrieval
- Minor style updates in custom CSS

Author: ForteScarlet

build.gradle.kts

@@ -52,4 +52,4 @@ tasks.create("createChangelog") {
     }
 }
 
-tasks.register<UpdateWritersideVersionTask>("updateWritersideVersion")
+tasks.register<UpdateDocsVersionTask>("updateDocsVersion")

buildSrc/src/main/kotlin/UpdateDocsVersionTask.kt

@@ -0,0 +1,24 @@
+import org.gradle.api.DefaultTask
+import org.gradle.api.tasks.TaskAction
+
+abstract class UpdateDocsVersionTask : DefaultTask() {
+    /**
+     * Update version in docs/src/version.json file with current project version
+     */
+    @TaskAction
+    fun action() {
+        val currentVersion = project.version.toString()
+        
+        // Update version in docs JSON file
+        val versionJsonFile = project.file("docs/src/version.json")
+        
+        // Ensure parent directory exists
+        versionJsonFile.parentFile.mkdirs()
+        
+        // Directly write the JSON content with current version
+        val jsonContent = """{"version": "$currentVersion"}"""
+        versionJsonFile.writeText(jsonContent)
+        
+        project.logger.info("Updated version to {} in {}", currentVersion, versionJsonFile.path)
+    }
+}

buildSrc/src/main/kotlin/UpdateWritersideVersionTask.kt

@@ -1,12 +1,22 @@
 import {themes as prismThemes} from 'prism-react-renderer';
 import type {Config} from '@docusaurus/types';
 import type * as Preset from '@docusaurus/preset-classic';
+import versionInfo from './src/version.json';
 
 // This runs in Node.js - Don't use client-side code here (browser APIs, JSX...)
+/**
+ * @see https://github.com/facebook/docusaurus/issues/4542#issuecomment-1434839071
+ */
+function getSiteTagline() {
+  switch(process.env.DOCUSAURUS_CURRENT_LOCALE) {
+    case "zh-CN": return '让 suspend 不再害羞';
+    default: return 'Make suspend no longer shy';
+  }
+}
 
 const config: Config = {
   title: 'Kotlin Suspend Transform Compiler Plugin',
-  tagline: 'Make suspend less shy',
+  tagline: getSiteTagline(), // 'Make suspend less shy',
   favicon: 'img/favicon.ico',
 
   // Future flags, see https://docusaurus.io/docs/api/docusaurus-config#future
@@ -53,32 +63,21 @@ const config: Config = {
           sidebarPath: './sidebars.ts',
           // Please change this to your repo.
           // Remove this to remove the "edit this page" links.
-          editUrl:
-            'https://github.com/ForteScarlet/kotlin-suspend-transform-compiler-plugin/tree/dev/docs/',
+          editUrl: ({locale, docPath}) => {
+            if (locale === 'zh-CN') {
+              return `https://github.com/ForteScarlet/kotlin-suspend-transform-compiler-plugin/tree/dev/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/${docPath}`;
+            }
+            return `https://github.com/ForteScarlet/kotlin-suspend-transform-compiler-plugin/tree/dev/docs/${docPath}`;
+          },
           showLastUpdateTime: true,
           lastVersion: 'current',
           versions: {
             current: {
               badge: true,
-              label: 'Latest',
+              label: 'v' + versionInfo.version,
             },
           }
         },
-        // blog: {
-        //   showReadingTime: true,
-        //   feedOptions: {
-        //     type: ['rss', 'atom'],
-        //     xslt: true,
-        //   },
-        //   // Please change this to your repo.
-        //   // Remove this to remove the "edit this page" links.
-        //   editUrl:
-        //     'https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/',
-        //   // Useful options to enforce blogging best practices
-        //   onInlineTags: 'warn',
-        //   onInlineAuthors: 'warn',
-        //   onUntruncatedBlogPosts: 'warn',
-        // },
         theme: {
           customCss: './src/css/custom.css',
         },
@@ -88,7 +87,7 @@ const config: Config = {
 
   themeConfig: {
     // Replace with your project's social card
-    image: 'img/docusaurus-social-card.jpg',
+    // image: 'img/docusaurus-social-card.jpg',
     navbar: {
       title: 'Kotlin Suspend Transform Compiler Plugin',
       // logo: {
@@ -102,10 +101,15 @@ const config: Config = {
           position: 'left',
           label: 'Documentation',
         },
+        {
+          type: 'docsVersionDropdown',
+          position: 'right',
+          versions: ['current'],
+        },
         {
           href: 'https://github.com/ForteScarlet/kotlin-suspend-transform-compiler-plugin',
-          label: 'GitHub',
           position: 'right',
+          className: 'header-github-link',
           'aria-label': 'GitHub repository',
         },
         {