From 85ee549f68449bc70a7f1271a93ad26a8207ee40 Mon Sep 17 00:00:00 2001
From: 魏曹先生 <1992414357@qq.com>
Date: Tue, 28 Apr 2026 22:39:59 +0800
Subject: Rebuild and rewrite the documentation site infrastructure
---
docs/TRANSLATION_RULE.md | 21 +
docs/_sidebar.md | 13 -
docs/index.html | 13 +-
docs/pages/.gitignore | 1 +
docs/pages/1-get-started.md | 278 +++++++++++--
docs/pages/1-get-started_zh_CN.md | 256 ++++++++++++
docs/pages/2-basic.md | 16 -
docs/pages/2-basic/1-program.md | 114 ------
docs/pages/2-basic/2-setup.md | 150 -------
docs/pages/2-basic/3-dispatcher.md | 95 -----
docs/pages/2-basic/4-chain.md | 75 ----
docs/pages/2-basic/5-renderer.md | 73 ----
docs/pages/3-features.md | 15 -
docs/pages/3-features/1-parser.md | 376 -----------------
docs/pages/3-features/2-general-renderer.md | 75 ----
docs/pages/3-features/3-comp.md | 118 ------
docs/pages/3-features/4-async.md | 6 -
docs/pages/3-features/5-clap-parser.md | 6 -
docs/scripts/docsify-plugin-flexible-alerts.js | 9 +
docs/scripts/docsify.min.js | 1 +
docs/scripts/prism-bash.min.js | 1 +
docs/scripts/prism-rust.js | 128 ++++++
docs/scripts/prism-toml.min.js | 1 +
docs/scripts/search.js | 540 +++++++++++++++++++++++++
docs/scripts/zoom-image.min.js | 1 +
25 files changed, 1203 insertions(+), 1179 deletions(-)
create mode 100644 docs/TRANSLATION_RULE.md
create mode 100644 docs/pages/.gitignore
create mode 100644 docs/pages/1-get-started_zh_CN.md
delete mode 100644 docs/pages/2-basic.md
delete mode 100644 docs/pages/2-basic/1-program.md
delete mode 100644 docs/pages/2-basic/2-setup.md
delete mode 100644 docs/pages/2-basic/3-dispatcher.md
delete mode 100644 docs/pages/2-basic/4-chain.md
delete mode 100644 docs/pages/2-basic/5-renderer.md
delete mode 100644 docs/pages/3-features.md
delete mode 100644 docs/pages/3-features/1-parser.md
delete mode 100644 docs/pages/3-features/2-general-renderer.md
delete mode 100644 docs/pages/3-features/3-comp.md
delete mode 100644 docs/pages/3-features/4-async.md
delete mode 100644 docs/pages/3-features/5-clap-parser.md
create mode 100644 docs/scripts/docsify-plugin-flexible-alerts.js
create mode 100644 docs/scripts/docsify.min.js
create mode 100644 docs/scripts/prism-bash.min.js
create mode 100644 docs/scripts/prism-rust.js
create mode 100644 docs/scripts/prism-toml.min.js
create mode 100644 docs/scripts/search.js
create mode 100644 docs/scripts/zoom-image.min.js
(limited to 'docs')
diff --git a/docs/TRANSLATION_RULE.md b/docs/TRANSLATION_RULE.md
new file mode 100644
index 0000000..9c77faa
--- /dev/null
+++ b/docs/TRANSLATION_RULE.md
@@ -0,0 +1,21 @@
+# Translation Style Guide
+
+## 1. Tone & Voice
+- **保持原语气** (Preserve original tone): Maintain the author's attitude, formality, and emotional register exactly as in the source.
+- **近似词替换** (Synonymous substitution): Use words with close or equivalent meaning where direct translation is awkward or unnatural.
+
+## 2. Vocabulary & Abbreviation
+- **缩写** (Abbreviation): Apply standard English abbreviations (e.g., *info* for information, *dept* for department) to avoid overlong words, but only when clarity is not sacrificed.
+- **简明表述** (Concise expression): Prefer shorter, more common alternatives (e.g., *use* over *utilize*, *help* over *facilitate*) unless the original tone demands formality.
+
+## 3. Structural Rules
+- **段落一致** (Paragraph integrity): Keep the original paragraph breaks and line spacing.
+- **标记保留** (Tag preservation): Any inline Markdown formatting (bold, italic, code, links, lists) must be replicated exactly in translation.
+- **例示** (Example):
+ - 原句: “请保持专业语气,但避免使用过长的学术词汇。”
+ - 译文: “Keep a prof. tone, but avoid long academic words.”
+- **最小化改动** (Minimal diff): When translating or syncing English content against a known Chinese original, if the Chinese original's meaning is extremely close to the current English meaning, do not modify the English text. This is to keep git diffs friendly (only modify parts that have truly changed).
+
+## 4. Exceptions
+- If a term has no common abbreviation, use the full word.
+- If preserving tone requires a longer phrase, prioritize tone over brevity.
diff --git a/docs/_sidebar.md b/docs/_sidebar.md
index c893e72..8c3581a 100644
--- a/docs/_sidebar.md
+++ b/docs/_sidebar.md
@@ -1,15 +1,2 @@
- [Welcome!](README)
- [Get Started](./pages/1-get-started)
-
-- [Basic](./pages/2-basic)
- - [Program](./pages/2-basic/1-program)
- - [Setup](./pages/2-basic/2-setup)
- - [Dispatcher](./pages/2-basic/3-dispatcher)
- - [Chain](./pages/2-basic/4-chain)
- - [Renderer](./pages/2-basic/5-renderer)
-
-- [Features](./pages/3-features)
- - [Parser](./pages/3-features/1-parser)
- - [General Renderer](./pages/3-features/2-general-renderer)
- - [Completion](./pages/3-features/3-comp)
- - [Async](./pages/3-features/4-async)
diff --git a/docs/index.html b/docs/index.html
index 4e43fc0..f69ff05 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -59,13 +59,20 @@
};
-
+
+
-
+
+
+
+
+
+
+