| [Docs] Optimize document Chinese and English switching experience
Co-authored-by: blian6<bin.lian@outlook.com>
Co-authored-by: blian<lianbin@huawei.com>
# message auto-generated for no-merge-commit merge:
!267 merge dev into dev
[Docs] Optimize document Chinese and English switching experience
Created-by: blian
Commit-by: blian6;blian
Merged-by: ascend-robot
Description: # Which issue(s) this PR fixes or accomplishes
1. 优化文档内容,并提供网页的中英文切换能力
2. 添加关键融合算子和关键API的说明文档
3. 后续优化点:
a. 图片的路径需要移到公有路径(docs/figures),否则,会产生无法找到的问题,但是这个修改涉及面较多,后续提交PR。
b. 中文界面的切换按钮最好是英文。
# Purpose
# Test Plan
本地生成 HTML 文档可使用以下命令:
```bash
python -m pip install -r docs/requirements-docs.txt
# 构建中英文
python docs/build_docs.py
# 仅构建中文
SPHINX_LANGUAGE=zh sphinx-build -b html -c docs docs/zh docs/_build/zh/html
# 仅构建英文
SPHINX_LANGUAGE=en sphinx-build -b html -c docs docs/en docs/_build/en/html
```
本地预览方法:
```
python -m http.server 8080 --directory docs/_build
```
- http://localhost:8080 → 自动跳转中文版
- http://localhost:8080/zh/html/index.html → 中文
- http://localhost:8080/en/html/index.html → 英文
# Test Report


See merge request: Ascend/MindIE-SD!267 | 1 个月前 |