Skip to content

Commit c128c91

Browse files
maikebingmaikebing
committed
docs: unify bilingual entry sections across pages
1 parent f8e6a16 commit c128c91

File tree

8 files changed

+254
-7
lines changed

8 files changed

+254
-7
lines changed

‎README.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,11 @@
99
- 中文首页：`docs/index.md`
1010
- 英文首页：`docs/index.en.md`
1111
- CI 文档：`docs/ci-workflows.md`
12+
- 英文 CI 文档：`docs/ci-workflows.en.md`
13+
- 中文导航：`docs/navigation.md`
14+
- 英文导航：`docs/navigation.en.md`
15+
- 中文博客索引：`docs/blog/index.md`
16+
- 英文博客索引：`docs/blog/index.en.md`
1217

1318
> ⚠️ 项目目前处于试验阶段，尚不可用于生产环境。
1419

‎README_en.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,12 @@
88

99
- Chinese home: `docs/index.md`
1010
- English home: `docs/index.en.md`
11-
- CI documentation: `docs/ci-workflows.md`
11+
- Chinese CI documentation: `docs/ci-workflows.md`
12+
- English CI documentation: `docs/ci-workflows.en.md`
13+
- Chinese navigation: `docs/navigation.md`
14+
- English navigation: `docs/navigation.en.md`
15+
- Chinese blog index: `docs/blog/index.md`
16+
- English blog index: `docs/blog/index.en.md`
1217

1318
> ⚠️ This project is currently in the experimental phase and is not yet suitable for production use.
1419

‎docs/blog/index.en.md‎

Lines changed: 34 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,31 @@
22

33
This page collects the currently available `LVGLSharp.Forms` articles and serves as the blog entry page for GitHub Pages.
44

5+
## Bilingual Entry Points
6+
7+
**Current language: English**
8+
9+
- Home: [`../index.md`](../index.md) · [`../index.en.md`](../index.en.md)
10+
- Navigation: [`../navigation.md`](../navigation.md) · [`../navigation.en.md`](../navigation.en.md)
11+
- Blog: [`index.md`](./index.md) · [`index.en.md`](./index.en.md)
12+
13+
> Tip: share `blog/index.en.md` with English readers, and start from the navigation pages when you want a bilingual comparison path.
14+
515
---
616

717
## Article Cards
818

19+
### Chinese / English article cards
20+
21+
| English article | 中文文章 |
22+
|---|---|
23+
| [Why WinForms over LVGL](./why-winforms-over-lvgl.en.md) | [为什么要做 WinForms over LVGL](../blog-winforms-over-lvgl.md) |
24+
| [Architecture Breakdown](./architecture.en.md) | [项目架构拆解](../blog-architecture.md) |
25+
| [NativeAOT and GUI](./nativeaot-gui.en.md) | [NativeAOT 与 GUI](../blog-nativeaot-gui.md) |
26+
| [Linux Host Strategy](./linux-hosts.en.md) | [Linux 图形宿主路线](../blog-linux-hosts.md) |
27+
28+
---
29+
930
### [Why WinForms over LVGL](./why-winforms-over-lvgl.en.md)
1031

1132
Best for readers who want to understand why this project exists in the first place.
@@ -38,13 +59,24 @@ Best for readers following the Linux desktop/device host roadmap and runtime evo
3859

3960
If this is your first time exploring the project, a good order is:
4061

41-
1. [Why WinForms over LVGL](../blog-winforms-over-lvgl.md)
62+
1. [Why WinForms over LVGL](./why-winforms-over-lvgl.en.md)
4263
2. [Architecture Breakdown](./architecture.en.md)
4364
3. [NativeAOT and GUI](./nativeaot-gui.en.md)
4465
4. [Linux Host Strategy](./linux-hosts.en.md)
4566

4667
## Related Entry Points
4768

4869
- [Home](../index.en.md)
70+
- [Chinese Home](../index.md)
4971
- [Navigation](../navigation.en.md)
50-
- [CI Workflow Guide](../ci-workflows.md)
72+
- [Chinese Navigation](../navigation.md)
73+
- [CI Workflow Guide](../ci-workflows.en.md)
74+
- [CI 工作流说明](../ci-workflows.md)
75+
76+
## Bilingual Reading Entry Points
77+
78+
- [Chinese Blog Index](./index.md)
79+
- [为什么要做 WinForms over LVGL](../blog-winforms-over-lvgl.md)
80+
- [项目架构拆解](../blog-architecture.md)
81+
- [NativeAOT 与 GUI](../blog-nativeaot-gui.md)
82+
- [Linux 图形宿主路线](../blog-linux-hosts.md)

‎docs/blog/index.md‎

Lines changed: 33 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,31 @@
22

33
这里汇总 `LVGLSharp.Forms` 当前已经整理好的专题文章，适合作为 GitHub Pages 博客入口页。
44

5+
## 双语入口
6+
7+
**当前语言：中文**
8+
9+
- 首页：[`../index.md`](../index.md) · [`../index.en.md`](../index.en.md)
10+
- 导航：[`../navigation.md`](../navigation.md) · [`../navigation.en.md`](../navigation.en.md)
11+
- 博客：[`index.md`](./index.md) · [`index.en.md`](./index.en.md)
12+
13+
> 建议：分享给中文读者可直接发送 `blog/index.md`，需要双语对照时优先从导航页进入。
14+
515
---
616

717
## 文章卡片
818

19+
### 中文 / English article cards
20+
21+
| 中文文章 | English article |
22+
|---|---|
23+
| [为什么要做 WinForms over LVGL](../blog-winforms-over-lvgl.md) | [Why WinForms over LVGL](./why-winforms-over-lvgl.en.md) |
24+
| [项目架构拆解](../blog-architecture.md) | [Architecture Breakdown](./architecture.en.md) |
25+
| [NativeAOT 与 GUI](../blog-nativeaot-gui.md) | [NativeAOT and GUI](./nativeaot-gui.en.md) |
26+
| [Linux 图形宿主路线](../blog-linux-hosts.md) | [Linux Host Strategy](./linux-hosts.en.md) |
27+
28+
---
29+
930
### [为什么要做 WinForms over LVGL](../blog-winforms-over-lvgl.md)
1031

1132
适合第一次了解项目定位的读者，重点回答“为什么这个项目值得做”。
@@ -46,5 +67,16 @@
4667
## 相关入口
4768

4869
- [站点首页](../index.md)
70+
- [英文首页](../index.en.md)
4971
- [文档导航](../navigation.md)
50-
- [CI 工作流说明](../ci-workflows.md)
72+
- [英文导航](../navigation.en.md)
73+
- [CI 工作流说明](../ci-workflows.md)
74+
- [CI Workflow Guide](../ci-workflows.en.md)
75+
76+
## 对照阅读入口
77+
78+
- [英文博客索引](./index.en.md)
79+
- [Why WinForms over LVGL](./why-winforms-over-lvgl.en.md)
80+
- [Architecture Breakdown](./architecture.en.md)
81+
- [NativeAOT and GUI](./nativeaot-gui.en.md)
82+
- [Linux Host Strategy](./linux-hosts.en.md)

‎docs/index.en.md‎

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,19 @@
22

33
> Bringing a WinForms-style development experience to LVGL-powered cross-platform UI.
44
5-
English | [Chinese](./index.md) | [Navigation](./navigation.en.md)
5+
[Chinese Home](./index.md) ¡¤ [English Home](./index.en.md) ¡¤ [Chinese Navigation](./navigation.md) ¡¤ [English Navigation](./navigation.en.md)
6+
7+
---
8+
9+
## Bilingual Entry Points
10+
11+
**Current language: English**
12+
13+
- Home: [`index.md`](./index.md) ¡¤ [`index.en.md`](./index.en.md)
14+
- Navigation: [`navigation.md`](./navigation.md) ¡¤ [`navigation.en.md`](./navigation.en.md)
15+
- Blog: [`blog/index.md`](./blog/index.md) ¡¤ [`blog/index.en.md`](./blog/index.en.md)
16+
17+
> Tip: share `index.en.md` with English readers, and start from the navigation pages when you want a bilingual comparison path.
618
719
---
820

@@ -33,6 +45,34 @@ English | [Chinese](./index.md) | [Navigation](./navigation.en.md)
3345
3446
---
3547

48+
## Start Reading by Role
49+
50+
### First-Time Readers
51+
52+
- [English Home](./index.en.md)
53+
- [Why WinForms over LVGL](./blog/why-winforms-over-lvgl.en.md)
54+
- [Chinese Home](./index.md)
55+
56+
### Architecture and Engineering Readers
57+
58+
- [Architecture Breakdown](./blog/architecture.en.md)
59+
- [CI Workflow Guide](./ci-workflows.en.md)
60+
- [CI Workflow Guide (Chinese)](./ci-workflows.md)
61+
62+
### Linux and Runtime-Host Readers
63+
64+
- [Linux Host Strategy](./blog/linux-hosts.en.md)
65+
- [WSL Developer Guide](./WSL-Developer-Guide.en.md)
66+
- [WSL Developer Guide (Chinese)](./WSL-Developer-Guide.md)
67+
68+
### AOT and Release Readers
69+
70+
- [NativeAOT and GUI](./blog/nativeaot-gui.en.md)
71+
- [Changelog](../CHANGELOG.md)
72+
- [Roadmap](../ROADMAP.md)
73+
74+
---
75+
3676
## Quick Entry Points
3777

3878
## Start Here

‎docs/index.md‎

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,19 @@
22

33
> 用 WinForms 的开发体验，连接 LVGL 的跨平台渲染能力。
44
5-
[English](./index.en.md) | 中文 | [文档导航](./navigation.md)
5+
[中文首页](./index.md) · [English Home](./index.en.md) · [中文导航](./navigation.md) · [English Navigation](./navigation.en.md)
6+
7+
---
8+
9+
## 双语入口
10+
11+
**当前语言：中文**
12+
13+
- 首页：[`index.md`](./index.md) · [`index.en.md`](./index.en.md)
14+
- 导航：[`navigation.md`](./navigation.md) · [`navigation.en.md`](./navigation.en.md)
15+
- 博客：[`blog/index.md`](./blog/index.md) · [`blog/index.en.md`](./blog/index.en.md)
16+
17+
> 建议：分享给中文读者可直接发送 `index.md`，需要双语对照时优先从导航页进入。
618
719
---
820

@@ -34,6 +46,34 @@
3446
3547
---
3648

49+
## 按角色开始阅读
50+
51+
### 第一次了解项目
52+
53+
- [项目首页](./index.md)
54+
- [为什么要做 WinForms over LVGL](./blog-winforms-over-lvgl.md)
55+
- [英文首页](./index.en.md)
56+
57+
### 架构与工程读者
58+
59+
- [项目架构拆解](./blog-architecture.md)
60+
- [CI 工作流说明](./ci-workflows.md)
61+
- [CI Workflow Guide](./ci-workflows.en.md)
62+
63+
### Linux / 运行时宿主读者
64+
65+
- [Linux 图形宿主路线](./blog-linux-hosts.md)
66+
- [WSL 开发指南](./WSL-Developer-Guide.md)
67+
- [WSL Developer Guide](./WSL-Developer-Guide.en.md)
68+
69+
### AOT / 发布读者
70+
71+
- [NativeAOT 与 GUI](./blog-nativeaot-gui.md)
72+
- [更新记录](../CHANGELOG.md)
73+
- [路线图](../ROADMAP.md)
74+
75+
---
76+
3777
## 快速入口
3878

3979
## Start Here

‎docs/navigation.en.md‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,59 @@
22

33
Welcome to the `LVGLSharp.Forms` documentation site.
44

5+
## Bilingual Entry Points
6+
7+
**Current language: English**
8+
9+
- Home: [`index.md`](./index.md) · [`index.en.md`](./index.en.md)
10+
- Navigation: [`navigation.md`](./navigation.md) · [`navigation.en.md`](./navigation.en.md)
11+
- Blog: [`blog/index.md`](./blog/index.md) · [`blog/index.en.md`](./blog/index.en.md)
12+
13+
> Tip: share `navigation.en.md` with English readers, and start from the navigation pages when you want a bilingual comparison path.
14+
15+
---
16+
517
## Home
618

719
- [Chinese Home](./index.md)
820
- [English Home](./index.en.md)
921
- [Chinese Navigation](./navigation.md)
22+
- [English Navigation](./navigation.en.md)
1023

1124
## Project Documentation
1225

1326
- [Roadmap](../ROADMAP.md)
1427
- [Changelog](../CHANGELOG.md)
1528
- [CI Workflow Guide (Chinese)](./ci-workflows.md)
1629
- [WSL Developer Guide (Chinese)](./WSL-Developer-Guide.md)
30+
- [CI Workflow Guide](./ci-workflows.en.md)
31+
- [WSL Developer Guide](./WSL-Developer-Guide.en.md)
32+
33+
## Navigation by Reader Type
34+
35+
### First-Time Readers
36+
37+
- [English Home](./index.en.md)
38+
- [Why WinForms over LVGL](./blog/why-winforms-over-lvgl.en.md)
39+
- [Chinese Home](./index.md)
40+
41+
### Architecture and Engineering Readers
42+
43+
- [Architecture Breakdown](./blog/architecture.en.md)
44+
- [CI Workflow Guide](./ci-workflows.en.md)
45+
- [CI Workflow Guide (Chinese)](./ci-workflows.md)
46+
47+
### Linux and Runtime-Host Readers
48+
49+
- [Linux Host Strategy](./blog/linux-hosts.en.md)
50+
- [WSL Developer Guide](./WSL-Developer-Guide.en.md)
51+
- [WSL Developer Guide (Chinese)](./WSL-Developer-Guide.md)
52+
53+
### AOT and Release Readers
54+
55+
- [NativeAOT and GUI](./blog/nativeaot-gui.en.md)
56+
- [Changelog](../CHANGELOG.md)
57+
- [Roadmap](../ROADMAP.md)
1758

1859
## Blog Articles
1960

@@ -23,6 +64,13 @@ Welcome to the `LVGLSharp.Forms` documentation site.
2364
- [Linux Host Strategy](./blog/linux-hosts.en.md)
2465
- [Architecture Breakdown](./blog/architecture.en.md)
2566

67+
## Chinese Blog Articles
68+
69+
- [为什么要做 WinForms over LVGL](./blog-winforms-over-lvgl.md)
70+
- [NativeAOT 与 GUI](./blog-nativeaot-gui.md)
71+
- [Linux 图形宿主路线](./blog-linux-hosts.md)
72+
- [项目架构拆解](./blog-architecture.md)
73+
2674
## Repository Entry Points
2775

2876
- [README](../README.md)

‎docs/navigation.md‎

Lines changed: 46 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,23 @@
22

33
欢迎来到 `LVGLSharp.Forms` 文档站点。
44

5+
## 双语入口
6+
7+
**当前语言：中文**
8+
9+
- 首页：[`index.md`](./index.md) · [`index.en.md`](./index.en.md)
10+
- 导航：[`navigation.md`](./navigation.md) · [`navigation.en.md`](./navigation.en.md)
11+
- 博客：[`blog/index.md`](./blog/index.md) · [`blog/index.en.md`](./blog/index.en.md)
12+
13+
> 建议：分享给中文读者可直接发送 `navigation.md`，需要双语对照时优先从导航页进入。
14+
15+
---
16+
517
## 首页
618

719
- [项目首页](./index.md)
820
- [English Home](./index.en.md)
21+
- [English Navigation](./navigation.en.md)
922

1023
## 项目文档
1124

@@ -15,7 +28,32 @@
1528
- [WSL 开发指南](./WSL-Developer-Guide.md)
1629
- [CI Workflow Guide](./ci-workflows.en.md)
1730
- [WSL Developer Guide](./WSL-Developer-Guide.en.md)
18-
- [英文文档导航](./navigation.en.md)
31+
32+
## 按读者类型导航
33+
34+
### 第一次了解项目
35+
36+
- [项目首页](./index.md)
37+
- [为什么要做 WinForms over LVGL](./blog-winforms-over-lvgl.md)
38+
- [English Home](./index.en.md)
39+
40+
### 关注架构与工程化
41+
42+
- [项目架构拆解](./blog-architecture.md)
43+
- [CI 工作流说明](./ci-workflows.md)
44+
- [CI Workflow Guide](./ci-workflows.en.md)
45+
46+
### 关注 Linux / 运行时宿主
47+
48+
- [Linux 图形宿主路线](./blog-linux-hosts.md)
49+
- [WSL 开发指南](./WSL-Developer-Guide.md)
50+
- [WSL Developer Guide](./WSL-Developer-Guide.en.md)
51+
52+
### 关注 AOT / 发布
53+
54+
- [NativeAOT 与 GUI](./blog-nativeaot-gui.md)
55+
- [更新记录](../CHANGELOG.md)
56+
- [路线图](../ROADMAP.md)
1957

2058
## 专题博客
2159

@@ -25,6 +63,13 @@
2563
- [项目架构拆解](./blog-architecture.md)
2664
- [英文博客索引](./blog/index.en.md)
2765

66+
## 英文专题博客
67+
68+
- [Why WinForms over LVGL](./blog/why-winforms-over-lvgl.en.md)
69+
- [NativeAOT and GUI](./blog/nativeaot-gui.en.md)
70+
- [Linux Host Strategy](./blog/linux-hosts.en.md)
71+
- [Architecture Breakdown](./blog/architecture.en.md)
72+
2873
## 仓库入口
2974

3075
- [README](../README.md)

0 commit comments

Comments
 (0)