Skip to content

docs: 新增空地一体协同智能载具虚拟仿真实验(Ubuntu)教程 - #520

Closed
heshuyun9 wants to merge 1 commit into
OpenHUTB:masterfrom
heshuyun9:docs/air-ground-ubuntu-tutorial
Closed

heshuyun9 wants to merge 1 commit into
OpenHUTB:masterfrom
heshuyun9:docs/air-ground-ubuntu-tutorial

Conversation

@heshuyun9

Copy link
Copy Markdown

变更内容

  • 新增《空地一体协同智能载具虚拟仿真实验教程(Ubuntu / OpenHUTB)》。
  • 覆盖 6 个实验模块:环境与数字孪生、感知决策控制、无人机、空地协同、交通场景、协作与 AI 辅助开发。
  • 明确区分两套脚本根目录:
    • hutb/PythonAPI/examples/air/:空地一体展示与 8 个分步教程;
    • OpenHUTB/doc 的 src/examples/、src/course/:相机、点云、检测、轨迹、交通指标等脚本。
  • 更正 config.py、traffic_indicators.py、spectator.py 等路径,补充 hero 车辆、YOLO 权重、湖工商场景等前置条件。
  • 保留 OpenHUTB 主页 https://openhutb.github.io/dl.sh 作为模拟器下载入口。

核对依据

  • OpenHUTB/doc 仓库 18c96b97 快照,docs/*.md 共 388 篇;
  • air_doc 的 Carla-Air 0.1.7、quick_start、multi_vehicle、image_apis 等页面;
  • OpenHUTB/.github 的 CONTRIBUTING 指南。

说明

本 PR 只新增教程文档,不修改模拟器代码、下载脚本或现有页面。

@donghaiwang donghaiwang left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

先用mkdocs serve 在本地验证生成的效果正确再打开PR

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

文件名必须为英文,下划线分隔。

且需要从首页有链接跳转过来

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👌

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这种不需要回复,默认是收到的,以免订阅该PR的人收到不必要的邮件

@heshuyun9

Copy link
Copy Markdown
Author

已按评审意见处理(最新 commit 7e6fec8):

  1. 文件名改为英文 + 下划线:docs/tutorial/air_ground_ubuntu_tutorial.md,原中文文件名已删除。
  2. 首页增加入口:在 docs/index.md 的“载具”下新增“空地一体 Ubuntu 教程”,链接到 tutorial/air_ground_ubuntu_tutorial.md。
  3. 本地验证生成效果:
    • 使用 MkDocs 1.6.1 + Read the Docs 主题构建;
    • 首页 / 返回 200,教程页 /tutorial/air_ground_ubuntu_tutorial/ 返回 200;
    • 首页链接可跳转;教程页标题、4 个表格、19 个代码块均正常渲染,未出现未解析的 Markdown 表格或代码围栏。

说明:当前执行环境的 mkdocs serve 在清理临时目录时被沙箱权限拦截,因此改用 mkdocs build 生成同一套站点,再用本地 HTTP 服务打开生成结果做上述检查;渲染器和主题与 mkdocs serve 一致。

@heshuyun9
heshuyun9 force-pushed the docs/air-ground-ubuntu-tutorial branch from 7e6fec8 to c918ecd Compare October 29, 2026 12:24
@heshuyun9

heshuyun9 commented Oct 29, 2026 •

Copy link
Copy Markdown
Author

补充:已把分支压缩为单个 commit c918ecd,内容与上面的验证一致。当前 diff:docs/index.md +1 行,新增 docs/tutorial/air_ground_ubuntu_tutorial.md。

@donghaiwang

donghaiwang commented Oct 29, 2026 •

Copy link
Copy Markdown
Member

抱歉,刚才看错了,你需求没看清,是在air_doc仓库中添加教材,而不是doc仓库

OpenHUTB/air_doc#42

@heshuyun9

Copy link
Copy Markdown
Author

教程应归入 OpenHUTB/air_doc,已改提:OpenHUTB/air_doc#45 。本 PR 关闭。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants