阿里云Ansible 模块文档

207 阅读1分钟

工具与资源中心

帮助开发者更加高效的工作,提供围绕开发者全生命周期的工具与资源

developer.aliyun.com/tool?spm=a1…

Aliyun Ansible 模块文档

本项目包含 Aliyun Ansible 模块文档的源代码。按照以下说明从DOCUMENTATION模块中的字符串生成文档。

先决条件(Ubuntu 操作系统)

  • make实用

    程序 生成 html 文档需要 Make 实用程序。make通过在 Ubuntu 上运行以下命令来安装实用程序。
sudo apt-get -y install make 

python版本 2.7.X

运行下面的命令来安装python.

sudo apt-get -y install python2.7

通过运行以下命令检查 python 安装。

python --version
  • 安装pip

    运行下面的命令来安装pip和其他包。
sudo apt-get -y install python-pip python-dev dos2unix
  • 安装 sphinx 和主题:
pip install sphinx==1.4.8 sphinx_rtd_theme

构建文档

要构建模块文档,您需要在ansible-provider-docs/docs/docsite文件夹中运行以下命令

cd docs/docsite
make webdocs 

生成的html文件在_build/html/文件夹中

本文转自:developer.aliyun.com/article/789…