Merge branch 'main' into feature/synonyms_as_code

# Conflicts:
#	config/synonyms.yml

Author: cotti

config/synonyms.yml

@@ -1,24 +1,32 @@
 synonyms:
-  - ".net,.NET,c#,csharp,dotnet,net,NET,DOTNET"
-  - "esql,es|ql"
-  - "motlp,managed otlp,Managed OTLP"
-  - "s3,aws s3,amazon s3"
-  - "es,elasticsearch"
-  - "Elastic Learned Sparse EncodeR,elser"
-  - "ccs,cross cluster search,cross-cluster search,spaghetti"
-  - "apm,application performance monitoring"
-  - "ecctl,Elastic Cloud Control"
-  - "opentelemetry,otel"
-  - "eck,Elastic Cloud on Kubernetes"
-  - "ece,Elastic Cloud Enterprise"
-  - "ELv2,Elastic License v2"
-  - "kql,Kibana Query Language"
-  - "ccr,cross-cluster replication,cross cluster replication"
-  - "ESaaS,Elastic Stack as a service"
-  - "knn,k-Nearest Neighbors"
-  - "ech,Elastic Cloud Hosted,ess"
-  - "aws,amazon"
-  - "ilm,index lifecycle management"
-  - "javascript,js,node,nodejs,node.js"
-  - "edot,elastic distribution of opentelemetry"
-  - "k8s,kubernetes"
+  - [ ".net", "c#", "csharp", "dotnet", "net" ]
+  - [ "esql", "es|ql" ]
+  - [ "motlp", "managed otlp" ]
+  - [ "s3", "aws s3", "amazon s3" ]
+  - [ "es", "elasticsearch" ]
+  - [ "elastic learned sparse encoder", "elser" ]
+  - [ "ccs", "cross cluster search", "cross-cluster search", "spaghetti" ]
+  - [ "cps", "cross project search", "cross-project search" ]
+  - [ "apm", "application performance monitoring" ]
+  - [ "ecctl", "elastic cloud control" ]
+  - [ "opentelemetry", "otel" ]
+  - [ "elastic distributions of opentelemetry", "edot" ]
+  - [ "eck", "elastic cloud on kubernetes" ]
+  - [ "ece", "elastic cloud enterprise" ]
+  - [ "elv2", "elastic license v2" ]
+  - [ "kql", "kibana query language" ]
+  - [ "ccr", "cross-cluster replication", "cross cluster replication" ]
+  - [ "esaas", "elastic stack as a service" ]
+  - [ "knn", "k-nearest neighbors" ]
+  - [ "ech", "elastic cloud hosted", "ess" ]
+  - [ "elasticsearch service", "elastic cloud" ]
+  - [ "aws", "amazon" ]
+  - [ "gcp", "google cloud platform" ]
+  - [ "ilm", "index lifecycle management" ]
+  - [ "javascript", "js", "node", "nodejs", "node.js" ]
+  - [ "edot", "elastic distribution of opentelemetry" ]
+  - [ "k8s", "kubernetes" ]
+  - [ "ecs", "elastic common schema" ]
+  - [ "ml", "machine learning" ]
+  - [ "eis", "elastic inference service" ]
+  - [ "traffic filter", "network security" ]

docs/_docset.yml

@@ -103,6 +103,7 @@ toc:
       - file: icons.md
       - file: images.md
       - file: kbd.md
+      - file: math.md
       - file: lists.md
       - file: line_breaks.md
       - file: links.md

docs/syntax/directives.md

@@ -10,19 +10,67 @@ import { initTabs } from './tabs'
 import { initTocNav } from './toc-nav'
 import 'htmx-ext-head-support'
 import 'htmx-ext-preload'
+import katex from 'katex'
+import 'katex/dist/katex.min.css'
 import { $, $$ } from 'select-dom'
 import { UAParser } from 'ua-parser-js'
 
 const { getOS } = new UAParser()
 const isLazyLoadNavigationEnabled =
     $('meta[property="docs:feature:lazy-load-navigation"]')?.content === 'true'
 
+/**
+ * Initialize KaTeX math rendering for elements with class 'math'
+ */
+function initMath() {
+    const mathElements = $$('.math')
+    mathElements.forEach((element) => {
+        try {
+            const content = element.textContent?.trim()
+            if (!content) return
+
+            // Determine if this is display math based on content and element type
+            const isDisplayMath =
+                element.tagName === 'DIV' ||
+                content.includes('\\[') ||
+                content.includes('$$') ||
+                content.includes('\\begin{') ||
+                content.includes('\n')
+
+            // Clean up common LaTeX delimiters
+            const cleanContent = content
+                .replace(/^\$\$|\$\$$/g, '') // Remove $$ delimiters
+                .replace(/^\\\[|\\\]$/g, '') // Remove \[ \] delimiters
+                .trim()
+
+            // Clear the element content before rendering
+            element.innerHTML = ''
+
+            katex.render(cleanContent, element, {
+                throwOnError: false,
+                displayMode: isDisplayMath,
+                strict: false, // Allow some LaTeX extensions
+                trust: false, // Security: don't trust arbitrary commands
+                output: 'mathml', // Only render MathML, not HTML
+                macros: {
+                    // Add common macros if needed
+                },
+            })
+        } catch (error) {
+            console.warn('KaTeX rendering error:', error)
+            // Fallback: keep the original content
+            element.innerHTML = element.textContent || ''
+        }
+    })
+}
+
 document.addEventListener('htmx:load', function (event) {
     initTocNav()
     initHighlight()
     initCopyButton()
     initTabs()
     initAppliesSwitch()
+    initMath()
 
     // We do this so that the navigation is not initialized twice
     if (isLazyLoadNavigationEnabled) {

docs/syntax/math.md

@@ -224,3 +224,7 @@ body {
 	user-select: none;
 	pointer-events: none;
 }
+
+math {
+	margin-top: 1.5rem;
+}