From fba9d76ddd12db2aaeee333408bbae509927504e Mon Sep 17 00:00:00 2001 From: sanbuphy Date: Wed, 25 Mar 2026 08:37:27 +0800 Subject: [PATCH] docs(readme): add english navigation links to localized readmes add secondary english navigation links in smaller font to all localized readme files for better accessibility fix incorrect internal links in english documentation --- docs-readme/ar-SA/README.md | 7 ++++++- docs-readme/de-DE/README.md | 7 ++++++- docs-readme/es-ES/README.md | 7 ++++++- docs-readme/fr-FR/README.md | 7 ++++++- docs-readme/ja-JP/README.md | 7 ++++++- docs-readme/ko-KR/README.md | 7 ++++++- docs-readme/vi-VN/README.md | 7 ++++++- docs-readme/zh-TW/README.md | 7 ++++++- docs/.vitepress/config.mjs | 8 ++++---- docs/en/appendix/index.md | 4 ++-- docs/en/stage-1/1.1-introduction-to-ai-ide/index.md | 8 ++++---- 11 files changed, 58 insertions(+), 18 deletions(-) diff --git a/docs-readme/ar-SA/README.md b/docs-readme/ar-SA/README.md index 7886bd2..ba6289c 100644 --- a/docs-readme/ar-SA/README.md +++ b/docs-readme/ar-SA/README.md @@ -23,7 +23,12 @@

القراءة عبر الإنترنت · خريطة التعلم · - المجتمع + المجتمع
+ + Read Online · + Learning Map · + Community +

diff --git a/docs-readme/de-DE/README.md b/docs-readme/de-DE/README.md index 4f6631d..b2b9276 100644 --- a/docs-readme/de-DE/README.md +++ b/docs-readme/de-DE/README.md @@ -23,7 +23,12 @@

Online lesen · Lernkarte · - Community + Community
+ + Read Online · + Learning Map · + Community +

diff --git a/docs-readme/es-ES/README.md b/docs-readme/es-ES/README.md index fb24de5..27571fd 100644 --- a/docs-readme/es-ES/README.md +++ b/docs-readme/es-ES/README.md @@ -23,7 +23,12 @@

Leer en línea · Mapa de aprendizaje · - Comunidad + Comunidad
+ + Read Online · + Learning Map · + Community +

diff --git a/docs-readme/fr-FR/README.md b/docs-readme/fr-FR/README.md index d5f2d6e..3933ff5 100644 --- a/docs-readme/fr-FR/README.md +++ b/docs-readme/fr-FR/README.md @@ -23,7 +23,12 @@

Lire en ligne · Carte d'apprentissage · - Communauté + Communauté
+ + Read Online · + Learning Map · + Community +

diff --git a/docs-readme/ja-JP/README.md b/docs-readme/ja-JP/README.md index f8403e0..19a8009 100644 --- a/docs-readme/ja-JP/README.md +++ b/docs-readme/ja-JP/README.md @@ -23,7 +23,12 @@

オンラインで読む · 学習マップ · - コミュニティ交流 + コミュニティ交流
+ + Read Online · + Learning Map · + Community +

diff --git a/docs-readme/ko-KR/README.md b/docs-readme/ko-KR/README.md index 6992bec..a20cdef 100644 --- a/docs-readme/ko-KR/README.md +++ b/docs-readme/ko-KR/README.md @@ -23,7 +23,12 @@

온라인 읽기 · 학습 지도 · - 커뮤니티 교류 + 커뮤니티 교류
+ + Read Online · + Learning Map · + Community +

diff --git a/docs-readme/vi-VN/README.md b/docs-readme/vi-VN/README.md index 1d7aeba..8cb355a 100644 --- a/docs-readme/vi-VN/README.md +++ b/docs-readme/vi-VN/README.md @@ -23,7 +23,12 @@

Đọc trực tuyến · Bản đồ học tập · - Cộng đồng + Cộng đồng
+ + Read Online · + Learning Map · + Community +

diff --git a/docs-readme/zh-TW/README.md b/docs-readme/zh-TW/README.md index 1bba55d..3f79fac 100644 --- a/docs-readme/zh-TW/README.md +++ b/docs-readme/zh-TW/README.md @@ -23,7 +23,12 @@

在線閱讀 · 學習地圖 · - 社區交流 + 社區交流
+ + Read Online · + Learning Map · + Community +

diff --git a/docs/.vitepress/config.mjs b/docs/.vitepress/config.mjs index 25fdc64..d01f717 100644 --- a/docs/.vitepress/config.mjs +++ b/docs/.vitepress/config.mjs @@ -395,11 +395,11 @@ const productManagerSidebarEn = [ }, { text: 'Comparison of Seven AI Programming Tools', - link: '/zh-cn/stage-1/appendix-articles/example0-1/vibe-coding-tools-snake-game-tutorial' + link: '/en/stage-1/appendix-articles/example0-1/vibe-coding-tools-snake-game-tutorial' }, { text: 'Design Websites with Agents', - link: '/zh-cn/stage-1/appendix-articles/example0-2/vibe-coding-tools-build-website-with-ai-coding-and-design-agents' + link: '/en/stage-1/appendix-articles/example0-2/vibe-coding-tools-build-website-with-ai-coding-and-design-agents' } ] } @@ -706,7 +706,7 @@ const appendixSidebarEn = [ items: [ { text: 'IDE Basics', - link: '/zh-cn/appendix/2-development-tools/ide-basics' + link: '/en/appendix/2-development-tools/ide-basics' }, { text: 'Command Line & Shell', @@ -2169,7 +2169,7 @@ Sitemap: ${siteUrl}/sitemap.xml }, { text: 'Appendix', - link: '/zh-cn/appendix/index', + link: '/en/appendix/index', activeMatch: '/en/appendix/' } ], diff --git a/docs/en/appendix/index.md b/docs/en/appendix/index.md index f8622f5..b36cc4f 100644 --- a/docs/en/appendix/index.md +++ b/docs/en/appendix/index.md @@ -14,7 +14,7 @@ Understand the core concepts, development history, and cutting-edge technical pr description="Master the art of efficient dialogue with AI to unlock the potential of large models" /> @@ -150,7 +150,7 @@ Basic knowledge of software development: description="Basic knowledge of API interface design and development" /> diff --git a/docs/en/stage-1/1.1-introduction-to-ai-ide/index.md b/docs/en/stage-1/1.1-introduction-to-ai-ide/index.md index 2989438..9b6887d 100644 --- a/docs/en/stage-1/1.1-introduction-to-ai-ide/index.md +++ b/docs/en/stage-1/1.1-introduction-to-ai-ide/index.md @@ -64,7 +64,7 @@ That's why you need an IDE (Integrated Development Environment). It displays cod ## 2. What Is an IDE, and Why Do You Need One ::: info Pre-reading Tip -If you're not yet familiar with what an IDE is or what each interface element does, we recommend reading [IDE Basics](/zh-cn/appendix/2-development-tools/ide-basics) first to learn the basic concepts and common features. +If you're not yet familiar with what an IDE is or what each interface element does, we recommend reading [IDE Basics](/en/appendix/2-development-tools/ide-basics) first to learn the basic concepts and common features. ::: In the early days of programming, all we needed was a simple text editor and a language processor. But as projects grew more complex, developers urgently needed a tool that could efficiently manage files, support syntax highlighting, and enable debugging — and thus the Integrated Development Environment (IDE) was born. @@ -99,7 +99,7 @@ You can even use it to edit Markdown documents. In short, an IDE is a set of tools that helps developers write code and run programs efficiently. -For more detailed explanations, check out the [Virtual IDE Visualization section in the Appendix](/zh-cn/appendix/2-development-tools/ide-basics). +For more detailed explanations, check out the [Virtual IDE Visualization section in the Appendix](/en/appendix/2-development-tools/ide-basics). ## 3. How Is an AI IDE Different from a Regular IDE @@ -503,7 +503,7 @@ The specific function of each part is: - **Panel**: Contains terminal and output windows. - **Status Bar**: Displays current environment status. -For more detailed explanations, please refer to the [Virtual IDE Visualization section in the Appendix](/zh-cn/appendix/2-development-tools/ide-basics). +For more detailed explanations, please refer to the [Virtual IDE Visualization section in the Appendix](/en/appendix/2-development-tools/ide-basics).

@@ -757,7 +757,7 @@ In the next chapter, we'll shift focus from "knowing how to use tools" to "makin When you see computer terms you don't understand, quickly look up their meanings here. Recommended to read through once. - Appendix 2: Visual Studio Code Menu Bar Analysis
+ Appendix 2: Visual Studio Code Menu Bar Analysis
When you don't know what the AI IDE interface is for, use the following content to consult with AI, or view directly.