build_docs.yml

---
  - name: Build multi-vendor docs
    hosts: all
    connection: local
    gather_facts: no

    tasks:

    - name: Clean residual Vendor folders
      file: name=docs/{{ vendor }} state=absent
      ignore_errors: true

    - name: Recreate Vendor folders
      file: name=docs/{{ vendor }} state=directory mode=0755

    - name: Create Vendor pages
      template: src=templates/vendor_page.tmpl dest=docs/{{ vendor }}/vendor_page.rst

    - set_fact:
        repo_path=repos/{{ url | basename | replace('.git', '') }}

    - name: Get Ansible Repo
      git: repo={{ url }} dest={{ repo_path }} update=yes

    - name: Make Ansible Docs
      docgen:
        module_dir: "{{ repo_path }}/{{ module_path }}"
        output_dir: docs/{{ vendor }}/{{ inventory_hostname }}
        make_index: false
        modules_title: "{{ inventory_hostname }}"

    - name: Add Source Link
      lineinfile:
        dest: docs/{{ vendor }}/{{ inventory_hostname }}/modules_list.rst
        insertbefore: '.. toctree::'
        line: 'These docs were dynamically created from the modules that can be found `here\n<{{ url }}>`_.\n'

    - name: Link Ansible Docs to Vendor Page
      lineinfile:
        dest: docs/{{ vendor }}/vendor_page.rst
        line: '   {{ inventory_hostname }}<{{ inventory_hostname }}/modules_list>'
        insertafter: EOF

    - name: Create Index File
      template: src=templates/index.tmpl dest=docs/index.rst
      run_once: true

    - name: Make Clean
      command: /usr/bin/make clean chdir=docs/
      run_once: true

    - name: Make HTML
      command: /usr/bin/make html chdir=docs/
      run_once: true