update data and templates

otc_metadata/data/services.yaml

@@ -389,12 +389,14 @@ documents:
     service_type: ecs
     title: User Guide
     type: umn
-  - html_location: docs/ed/umn
-    pdf_name: edb-umn
-    rst_location: umn/source
-    service_type: edb
+  - rst_location: api-ref/source
+    service_type: ed
+    title: API Reference
+    type: api-ref
+  - rst_location: umn/source
+    service_type: ed
     title: User Guide
-    type: manual
+    type: umn
   - hc_location: api/eip
     html_location: docs/eip/api-ref
     link: /elastic-ip/api-ref/

otc_metadata/templates/tox.ini.j2

@@ -22,12 +22,15 @@ deps =
 commands = {posargs}
 
 [testenv:docs]
+deps = -r{toxinidir}/doc/requirements.txt
 commands =
 {%- for doc in docs %}
   {[testenv:{{ doc.type }}]commands}
+  {[testenv:json-{{ doc.type }}]commands}
 {%- endfor %}
 
 [testenv:docs-pdf]
+deps = -r{toxinidir}/doc/requirements.txt
 whitelist_externals =
   mkdir
 commands =
@@ -40,7 +43,9 @@ commands =
 
 {% for doc in docs -%}
 {% set loc = doc.rst_location | replace('/source', '') %}
+# HTML version
 [testenv:{{ doc.type }}]
+deps = -r{toxinidir}/doc/requirements.txt
 whitelist_externals =
   cp
   mkdir
@@ -57,8 +62,32 @@ commands =
   cp -av doc/build/html/dev-guide dev_guide/build/html
 {%- endif %}
 
+# Json version (for search)
+[testenv:json-{{ doc.type }}]
+deps = -r{toxinidir}/doc/requirements.txt
+whitelist_externals =
+  cp
+  mkdir
+  find
+commands =
+  sphinx-build -W --keep-going -b json {{ loc }}/source doc/build/json/{{ doc.type }}
+  # Drop data useless for the search
+  find doc/build/json -type d -and ( -name '_images' -or -name '_static' -or -name '_sources' ) -exec rm {:} ;
+{%- if doc.type == 'api-ref' %}
+  mkdir -p api-ref/build/json
+  cp -av doc/build/json/api-ref api-ref/build/json
+{%- elif doc.type == 'umn' %}
+  mkdir -p umn/build/json
+  cp -av doc/build/json/umn umn/build/json
+{%- elif doc.type == 'dev-guide' %}
+  mkdir -p dev_guide/build/json
+  cp -av doc/build/json/dev-guide dev_guide/build/json
+{%- endif %}
+
 {% if doc.pdf_name -%}
+# PDF version
 [testenv:{{ doc.type }}-pdf-docs]
+deps = -r{toxinidir}/doc/requirements.txt
 whitelist_externals =
   rm
   mkdir