Merge pull request #391 from UiPath/docs/google-analytics

feat(docs): add google analytics

Author: gheorghitahurmuz

docs/hooks.py

@@ -1,8 +1,9 @@
 import os
+import re
 import shutil
 
 
-def redirect_index(*args, **kwargs):
+def on_pre_build(config):
     if not os.path.exists("docs/quick_start_images"):
         shutil.copy(
             "docs/plugins/uipath-langchain-python/docs/quick_start.md", "docs/index.md"
@@ -11,3 +12,9 @@ def redirect_index(*args, **kwargs):
             "docs/plugins/uipath-langchain-python/docs/quick_start_images",
             "docs/quick_start_images",
         )
+
+
+def on_post_page(output, page, config):
+    pattern = r"(<body[^>]*>)"
+    replacement = rf"\1\n<noscript><iframe src='https://www.googletagmanager.com/ns.html?id={config['google_tag_manager_id']}' height='0' width='0' style='display:none;visibility:hidden'></iframe></noscript>"
+    return re.sub(pattern, replacement, output)

docs/overrides/main.html

@@ -0,0 +1,14 @@
+{% extends "base.html" %}
+
+{% block extrahead %}
+<!-- Google Tag Manager -->
+<script>(function (w, d, s, l, i) {
+        w[l] = w[l] || []; w[l].push({
+            'gtm.start':
+                new Date().getTime(), event: 'gtm.js'
+        }); var f = d.getElementsByTagName(s)[0],
+            j = d.createElement(s), dl = l != 'dataLayer' ? '&l=' + l : ''; j.async = true; j.src =
+                'https://www.googletagmanager.com/gtm.js?id=' + i + dl; f.parentNode.insertBefore(j, f);
+    })(window, document, 'script', 'dataLayer', '{{ config.google_tag_manager_id }}');</script>
+<!-- End Google Tag Manager -->
+{% endblock %}

mkdocs.yml

@@ -12,6 +12,8 @@ extra_css:
 extra_javascript:
   - javascripts/extra.js
 
+google_tag_manager_id: GTM-PLLP8P
+
 theme:
   name: material
   custom_dir: docs/overrides
@@ -96,7 +98,8 @@ plugins:
             show_bases: false
   - mkdocs-simple-hooks:
       hooks:
-        on_pre_build: "docs.hooks:redirect_index"
+        on_pre_build: "docs.hooks:on_pre_build"
+        on_post_page: "docs.hooks:on_post_page"
   - termynal:
       prompt_literal_start:
         - "$"