add clarity

Author: jackgerrits

.github/workflows/docs.yml

@@ -196,10 +196,42 @@ jobs:
         with:
           dotnet-version: '8.0.x'
           global-json-file: dotnet/global.json
+      - run: dotnet tool update -g docfx
       - run: |
           mkdir -p ./build/dotnet/dev/
           docfx build docfx.json --output ./build/dotnet/dev/
         working-directory: ./docs/dotnet
+      - name: insert clarity snippet to *.html
+        working-directory: ./docs/dotnet/build/dotnet/dev/
+        shell: python
+        run: |
+          import os
+          clarity_script = """
+          <script type="text/javascript">
+              (function(c,l,a,r,i,t,y){
+                  c[a]=c[a]||function(){(c[a].q=c[a].q||[]).push(arguments)};
+                  t=l.createElement(r);t.async=1;t.src="https://www.clarity.ms/tag/"+i;
+                  y=l.getElementsByTagName(r)[0];y.parentNode.insertBefore(t,y);
+              })(window, document, "clarity", "script", "lnxpe6skj1");
+          </script>
+          """
+
+          site_folder = '.'
+
+          for root, dirs, files in os.walk(site_folder):
+              for file in files:
+                  if file.endswith('.html'):
+                      html_path = os.path.join(root, file)
+
+                      # insert the script into the html's head section
+                      with open(html_path, 'r') as file:
+                          html = file.read()
+                          html = html.replace('</head>', clarity_script + '</head>')
+
+                      with open(html_path, 'w') as file:
+                          file.write(html)
+
+                      print(f'Clarity script inserted into {html_path}')
       - uses: actions/upload-artifact@v4
         with:
           path: "./docs/dotnet/build"