Add exclude-doctools option (#1069)

Author: dgarcia360

docs/source/configuration/page.rst

@@ -88,3 +88,14 @@ If set, hides the version warning from the page.
 .. code-block:: none
 
    :hide-version-warning:
+
+Exclude doctools
+----------------
+
+Excludes ``doctools.js`` from specific documentation pages.
+
+Required to make the toolchain compatible with Swagger UI.
+
+.. code-block:: none
+
+   :exclude-doctools:

sphinx_scylladb_theme/__init__.py

@@ -51,6 +51,7 @@ def update_context(app, pagename, templatename, context, doctree):
     context["hide_version_warning"] = "hide-version-warning" in file_meta
     context["hide_sidebar"] = "hide-sidebar" in file_meta
     context["hide_secondary_sidebar"] = "hide-secondary-sidebar" in file_meta
+    context["exclude_doctools"] = "exclude-doctools" in file_meta
     context["landing"] = "landing" in file_meta
 
     if (

sphinx_scylladb_theme/layout.html

@@ -6,7 +6,9 @@
         <script type="text/javascript" src="{{ pathto('_static/js/runtime.bundle.js', 1) }}"></script>
         <script type="text/javascript" src="{{ pathto('_static/js/main.bundle.js', 1) }}"></script>
         {% for js in script_files %}
-            {{ js_tag(js) }}
+            {% if not (exclude_doctools and 'doctools.js' in js_tag(js)) %}
+                {{ js_tag(js) }}
+            {% endif %}
         {% endfor %}
     {% endmacro %}
     {% macro css() %}