跳到内容

官方 Ansible 文档网站

antsibull-docs 用于 docs.ansible.com/ansible/develdocs.ansible.com/ansible/latest 官方 Ansible 文档网站的构建管道中,以生成 Ansible 中包含的所有集合的文档。它也用于 ansible-core 文档中,以生成 ansible.builtin (ansible-core 包含的集合) 的文档。

Ansible 文档网站所有其他文件的 RST 源文件可以在 ansible/ansible-documentation GitHub 仓库中找到。此仓库还包含文档网站的构建脚本。antsibull-docs 是从 hacking/build_library/build_ansible/command_plugins/docs_build.py 调用的。它使用 antsibull-docs 的 develstable 子命令。其输入数据来自 ansible-community/ansible-build-data GitHub 仓库。为了构建 Ansible 主要版本 $X 的稳定文档,将使用 ansible-build-data$X/ 目录下的最新的 ansible-$X.$Y.$Z.deps 文件。为了构建 devel 文档,将使用 ansible-build-data 中最新的 $Y/ansible.in 文件中列出的集合,其中 $Y 是仓库中可以找到的最大值。然后使用 $Y/ansible.in 中列出的每个集合的最新版本。

有关确切的构建过程,请参考 ansible-documentation 仓库中的构建过程。