BUG-029: Run commands in the rst_to_html role directly to build examples.

Author: mvousden

roles/fidimag_examples/meta/main.yml

@@ -1,4 +1,4 @@
 ---
 dependencies:
   - { role: fidimag }
-  - { role: rst_to_html, BUILD_DIR: "{{ EXAMPLES_DOC_FOLDER }}", SOURCE_PATH: "{{ EXAMPLES_RST_FILE }}", BUILD_NAME: "{{ EXAMPLES_OUTPUT_NAME }}" }
+  - { role: rst_to_html }

roles/fidimag_examples/tasks/main.yml

@@ -2,9 +2,21 @@
 # This Ansible role prepares Fidimag examples and places some documentation on
 # the Desktop.
 
+# Create examples documentation.
+- name: Create documentation build directory.
+  file:
+    name={{ EXAMPLES_DOC_FOLDER }}
+    state=directory
+  sudo: yes
+
+- name: Convert to HTML and place in the build directory.
+  shell: rst2html.py {{ EXAMPLES_RST_FILE }} {{ EXAMPLES_OUTPUT_NAME }}
+    chdir={{ EXAMPLES_DOC_FOLDER }}
+    creates={{ EXAMPLES_DOC_FOLDER }}/{{ EXAMPLES_OUTPUT_NAME }}
+  sudo: yes
+
 # This task is not very robust, but I can't think of a better way of doing
 # this.
-
 - name: Copy fidimag examples to a more accessible location.
   command: cp -r /opt/fidimag/examples {{ FIDIMAG_EXAMPLES_FOLDER }}
     creates={{ FIDIMAG_EXAMPLES_FOLDER }}

roles/magpar_examples/meta/main.yml

@@ -1,4 +1,4 @@
 ---
 dependencies:
   - { role: magpar }
-  - { role: rst_to_html, BUILD_DIR: "{{ EXAMPLES_DOC_FOLDER }}", SOURCE_PATH: "{{ EXAMPLES_RST_FILE }}", BUILD_NAME: "{{ EXAMPLES_OUTPUT_NAME }}" }
+  - { role: rst_to_html }

roles/magpar_examples/tasks/main.yml

@@ -2,6 +2,20 @@
 # This Ansible role prepares Magpar examples and places some documentation on
 # the Desktop.
 
+# Create examples documentation.
+- name: Create documentation build directory.
+  file:
+    name={{ EXAMPLES_DOC_FOLDER }}
+    state=directory
+  sudo: yes
+
+- name: Convert to HTML and place in the build directory.
+  shell: rst2html.py {{ EXAMPLES_RST_FILE }} {{ EXAMPLES_OUTPUT_NAME }}
+    chdir={{ EXAMPLES_DOC_FOLDER }}
+    creates={{ EXAMPLES_DOC_FOLDER }}/{{ EXAMPLES_OUTPUT_NAME }}
+  sudo: yes
+
+# Install examples
 - name: Download magpar examples tarball.
   get_url:
     url={{ MAGPAR_EXAMPLES_URL }}

roles/nmag_examples/meta/main.yml

@@ -1,4 +1,4 @@
 ---
 dependencies:
   - { role: nmag }
-  - { role: rst_to_html, BUILD_DIR: "{{ EXAMPLES_DOC_FOLDER }}", SOURCE_PATH: "{{ EXAMPLES_RST_FILE }}", BUILD_NAME: "{{ EXAMPLES_OUTPUT_NAME }}" }
+  - { role: rst_to_html }

roles/nmag_examples/tasks/main.yml

@@ -2,6 +2,19 @@
 # This Ansible role prepares Nmag examples and places some documentation on the
 # Desktop.
 
+# Create examples documentation.
+- name: Create documentation build directory.
+  file:
+    name={{ EXAMPLES_DOC_FOLDER }}
+    state=directory
+  sudo: yes
+
+- name: Convert to HTML and place in the build directory.
+  shell: rst2html.py {{ EXAMPLES_RST_FILE }} {{ EXAMPLES_OUTPUT_NAME }}
+    chdir={{ EXAMPLES_DOC_FOLDER }}
+    creates={{ EXAMPLES_DOC_FOLDER }}/{{ EXAMPLES_OUTPUT_NAME }}
+  sudo: yes
+
 # This following task is not very robust, but I can't think of a better way of
 # doing this.
 - name: Copy nmag examples to a more accessible location.

roles/oommf_examples/meta/main.yml

@@ -1,4 +1,4 @@
 ---
 dependencies:
   - { role: oommf }
-  - { role: rst_to_html, BUILD_DIR: "{{ EXAMPLES_DOC_FOLDER }}", SOURCE_PATH: "{{ EXAMPLES_RST_FILE }}", BUILD_NAME: "{{ EXAMPLES_OUTPUT_NAME }}" }
+  - { role: rst_to_html }

roles/oommf_examples/tasks/main.yml

@@ -2,6 +2,19 @@
 # This Ansible role prepares OOMMF examples and places some documentation on
 # the Desktop.
 
+# Create examples documentation.
+- name: Create documentation build directory.
+  file:
+    name={{ EXAMPLES_DOC_FOLDER }}
+    state=directory
+  sudo: yes
+
+- name: Convert to HTML and place in the build directory.
+  shell: rst2html.py {{ EXAMPLES_RST_FILE }} {{ EXAMPLES_OUTPUT_NAME }}
+    chdir={{ EXAMPLES_DOC_FOLDER }}
+    creates={{ EXAMPLES_DOC_FOLDER }}/{{ EXAMPLES_OUTPUT_NAME }}
+  sudo: yes
+
 # This task is not very robust, but I can't think of a better way of doing
 # this.
 - name: Copy oommf examples to a more accessible location.