Commit 1e2c700
committed
Consolidate docs into one Sphinx project with language subdirectories
Adopt WebRunner's docs layout: a single Sphinx project under
docs/source/ with per-language subdirectories (Eng/, Zh-TW/, Zh-CN/)
and a language-neutral API/ tree. The top-level index.rst is a slim
hero with four toctrees pointing at chapter sub-indexes
(eng_index, zh_tw_index, zh_cn_index, api_index); each sub-index
has chapter sections that toctree to the chapter docs.
Cross-language navigation now works through normal Sphinx toctrees
inside the same build — relative ../html-zh-TW/ links and per-
language RTD projects are no longer needed. Drop the per-language
.readthedocs.zh-*.yaml files, drop the source.zh-TW/ and
source.zh-CN/ source trees, drop the per-language conf.py + index,
and simplify make.bat / Makefile to a single html target.
Single API tree built once from English autodoc avoids the
duplicate object descriptions warnings the three-tree layout
produced.1 parent 5bf51c3 commit 1e2c700
96 files changed
Lines changed: 930 additions & 1813 deletions
File tree
- docs
- source.zh-CN
- api
- source.zh-TW
- api
- source
- API
- Eng
- usage
- Zh-CN
- usage
- Zh-TW
- usage
- api
Some content is hidden
Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | | - | |
3 | | - | |
4 | | - | |
5 | | - | |
6 | | - | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
7 | 6 | | |
8 | | - | |
9 | 7 | | |
10 | 8 | | |
11 | 9 | | |
| |||
16 | 14 | | |
17 | 15 | | |
18 | 16 | | |
19 | | - | |
| 17 | + | |
20 | 18 | | |
21 | 19 | | |
22 | 20 | | |
| |||
This file was deleted.
This file was deleted.
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
7 | | - | |
| 7 | + | |
8 | 8 | | |
9 | 9 | | |
10 | 10 | | |
11 | 11 | | |
12 | 12 | | |
13 | 13 | | |
14 | 14 | | |
15 | | - | |
16 | | - | |
17 | | - | |
18 | | - | |
19 | | - | |
20 | | - | |
21 | | - | |
22 | | - | |
23 | 15 | | |
24 | 16 | | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
18 | 18 | | |
19 | 19 | | |
20 | 20 | | |
21 | | - | |
22 | | - | |
23 | | - | |
24 | | - | |
25 | 21 | | |
26 | 22 | | |
27 | 23 | | |
28 | | - | |
29 | | - | |
30 | | - | |
31 | | - | |
32 | | - | |
33 | | - | |
34 | | - | |
35 | | - | |
36 | | - | |
37 | | - | |
38 | | - | |
39 | | - | |
40 | | - | |
41 | | - | |
42 | 24 | | |
43 | 25 | | |
44 | 26 | | |
| |||
This file was deleted.
This file was deleted.
This file was deleted.
This file was deleted.
This file was deleted.
0 commit comments