docs(dragon/q8b): add Docker / Conda virtual-env tutorials#1869
Merged
Milir-Radxa merged 1 commit intoJun 23, 2026
Merged
Conversation
Add four wrappers under dragon/q8b/app-dev/virtual-env/, importing the shared templates from common/radxa-os/application-dev/virtual-env/: - docker-install.md -> DockerInstall board="dragon-q8b" - docker-use.md -> DockerUse board="dragon-q8b" - conda-install.md -> CondaInstall board="dragon-q8b" - conda-use.md -> CondaUse board="dragon-q8b" Each wrapper passes board="dragon-q8b" so terminal prompts in the rendered code blocks show radxa@dragon-q8b$. This depends on the template change that adds props?.board ?? 'device' fallback, which is submitted as a separate PR; once that PR merges the prompt will render correctly. Without that PR, the new Conda pages will still fall back to radxa@device$ until the template is updated. Mirror all four files in i18n/en to keep Chinese / English in sync. Existing venv-usage.md (Python venv) is unchanged.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
给 Dragon Q8B 补齐应用开发下的虚拟环境教程，对齐 Q6A 已经有的 Docker / Conda 教程。
复用
common/radxa-os/application-dev/virtual-env/下的公共模板，每个新 wrapper 显式传入board="dragon-q8b"。等配套的 #1868 模板改动合并后，渲染出来的终端提示会显示radxa@dragon-q8b$；在那之前，Conda 教程会回退到默认的radxa@device$，但页面结构 / 文档内容是正确的。新增文件
docs/dragon/q8b/app-dev/virtual-env/docker-install.md-><DockerInstall board="dragon-q8b" />docs/dragon/q8b/app-dev/virtual-env/docker-use.md-><DockerUse board="dragon-q8b" />docs/dragon/q8b/app-dev/virtual-env/conda-install.md-><CondaInstall board="dragon-q8b" />docs/dragon/q8b/app-dev/virtual-env/conda-use.md-><CondaUse board="dragon-q8b" />i18n/en/.../dragon/q8b/app-dev/virtual-env/下同样 4 个英文版已有的
venv-usage.md（Python venv）保持不动。依赖
tip改成props?.board ?? 'device'之后，wrapper 传board="dragon-q8b"才会真正渲染出radxa@dragon-q8b$board的 wrapper（cubie a5e / a7a / a7s / a7z、som cm4 等）行为不变验证
bash scripts/agent-doc-lint.sh <files>通过bash scripts/agent-doc-translation-guard.sh docs/dragon/q8b/app-dev/virtual-env/通过python3 scripts/github_pr_guard.py check通过（1 scope / 8 files）