DOCN-129: prep kapa widget

custom_theme/main.html

@@ -8,15 +8,6 @@
 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
 })(window,document,'script','dataLayer','GTM-PG938LS');</script>
 <!-- End Google Tag Manager -->
-<!-- Delighted survey tool -->
-<script type="text/javascript">
- !function(e,t,r,n){if(!e[n]){for(var a=e[n]=[],i=["survey","reset","config","init","set","get","event","identify","track","page","screen","group","alias"],s=0;s<i.length;s++){var c=i[s];a[c]=a[c]||function(e){return function(){var t=Array.prototype.slice.call(arguments);a.push([e,t])}}(c)}a.SNIPPET_VERSION="1.0.1";var o=t.createElement("script");o.type="text/javascript",o.async=!0,o.src="https://d2yyd1h5u9mauk.cloudfront.net/integrations/web/v1/library/"+r+"/"+n+".js";var u=t.getElementsByTagName("script")[0];u.parentNode.insertBefore(o,u)}}(window,document,"X3fUmYn77WW3rfAz","delightedThumbsK");
- delightedThumbsK.survey({
-  properties: { // extra context (optional)
-   product: "KDB-q"
-  }
- });
-</script>
-<!-- End Delighted survey tool -->
+
 {% endblock %}
 

docs/learn/install.md

@@ -9,40 +9,21 @@ _You can run kdb+ on Linux, macOS, or Windows_
 
 ## :fontawesome-solid-download: Step 1: Download
 
-=== "Non-commercial users"
+Commercial versions of kdb+ are available to customers from [downloads.kx.com](https://downloads.kx.com). Credentials are available from the customer's [Designated Contacts](licensing.md#obtain-a-license-key-file).
 
-    <button style="background: #0088ff; border-radius: 5px; box-shadow: 0 3px 1px -2px rgba(0, 0, 0, 0.2), 0 2px 2px 0 rgba(0, 0, 0, 0.14), 0 1px 5px 0 rgba(0, 0, 0, 0.12); padding: 10px;" type="button">
-      <a href="https://kx.com/kdb-personal-edition-download/" style="color: white">
-        <span style="font-size: 2em;">:fontawesome-solid-download: Get kdb+</span><br/>Personal, non-commercial
-        :fontawesome-brands-linux:
-        :fontawesome-brands-apple:
-        :fontawesome-brands-windows:
-      </a>
-    </button>
-
-    The 64-bit kdb+ Personal Edition interpreter is licensed for non-commercial use. 
-    It is not licensed for use on cloud servers.
-
-    The provided license-key file (`kc.lic`) requires an always-on Internet connection. 
-
-
-=== "Commercial users"
-
-    Commercial versions of kdb+ are available to customers from [downloads.kx.com](https://downloads.kx.com). Credentials are available from the customer's [Designated Contacts](licensing.md#obtain-a-license-key-file).
-
-    Requires a 64-bit interpreter and a `k4.lic` or `kc.lic` license-key file 
+Requires a 64-bit interpreter and a `k4.lic` or `kc.lic` license-key file 
 
-    OR
+OR
 
-    a 32-bit interpreter.
+a 32-bit interpreter.
 
-    !!! warning "32-bit applications will not run in macOS 10.15+ (Catalina and later)"
+!!! warning "32-bit applications will not run in macOS 10.15+ (Catalina and later)"
 
-    !!! tip "Internal distribution at customer sites"
+!!! tip "Internal distribution at customer sites"
 
-        Most customers download the latest release of kdb+ (along with the accompanying `README.txt`, the detailed change list) and make a limited number of approved kdb+ versions available from a central file server.
+    Most customers download the latest release of kdb+ (along with the accompanying `README.txt`, the detailed change list) and make a limited number of approved kdb+ versions available from a central file server.
 
-        Designated Contacts should encourage developers to keep production systems up to date with these versions of kdb+. This can greatly simplify development, deployment and debugging.
+    Designated Contacts should encourage developers to keep production systems up to date with these versions of kdb+. This can greatly simplify development, deployment and debugging.
 
 
 !!! info "Platforms and versions"

docs/learn/licensing.md

@@ -18,23 +18,6 @@ If both are found, the `kc.lic` file is used.
 
 ## Obtain a license key file
 
-A license file can be a commercial license or an on-demand person license (for non-commercial use).
-
-### On-Demand License
-
-It requires a `kc.lic` license key file and an always-on internet connection to operate.
-
-#### Licensing server
-
-If kdb+ with an on-demand license cannot contact the KX license server it will abort with a timestamped message.
-
-```q
-'2018.03.28T11:20:03.831 couldn't connect to license daemon -- exiting
-```
-
-If an HTTP proxy is required, the environment variables `http_proxy` or `HTTP_PROXY` define the URL of the HTTP proxy to use.
-Since 4.1t 2022.11.01,4.0 2022.10.26,4.0ce 2022.09.16 the on-demand system honours the NO_PROXY/no_proxy environment variables, with the lowercase version taking precedence.
-
 ### Commercial License
 
 Use of commercial kdb+ is covered by your license agreement with KX.

docs/scripts/init_kapa_widget.js

@@ -0,0 +1,52 @@
+document.addEventListener("DOMContentLoaded", function () {
+  var script = document.createElement("script");
+  script.src = "https://widget.kapa.ai/kapa-widget.bundle.js";
+  script.setAttribute("data-website-id", "90e95ec3-2524-43ab-93da-3e94fdd01d59");
+  script.setAttribute("data-project-name", "KX");
+  script.setAttribute("data-modal-title", "Ask AI");  
+  script.setAttribute("data-project-color", "#FFC300");
+  //script.setAttribute("data-project-color-dark", "#00B0F0");
+  //script.setAttribute("data-color-scheme-selector", "[data-md-color-scheme='slate']");
+  script.setAttribute("data-color-scheme", "light"); 
+  script.setAttribute("data-surface-color", "#ffffff");
+  script.setAttribute("data-surface-elevated-color", "#f8f9fa");
+  script.setAttribute("data-surface-hover-color", "#f1f3f5");
+  script.setAttribute("data-text-color", "#111111");
+  script.setAttribute("data-text-muted-color", "#666666");
+  script.setAttribute("data-border-color", "#dee2e6");
+  script.setAttribute("data-anchor-color", "#2563eb");
+  //script.setAttribute("data-surface-color-dark", "#17171a");
+  //script.setAttribute("data-surface-elevated-color-dark", "#25252a");
+  //script.setAttribute("data-surface-hover-color-dark", "#32323a");
+  //script.setAttribute("data-text-color-dark", "#e4e4e7");
+  //script.setAttribute("data-text-muted-color-dark", "#a1a1aa");
+  //script.setAttribute("data-border-color-dark", "#3f3f45");
+  //script.setAttribute("data-anchor-color-dark", "#60a5fa");
+  script.setAttribute("data-modal-header-background-color", "#ffffff");
+  script.setAttribute("data-modal-header-color", "#1a1a1a");    
+  //script.setAttribute("data-modal-header-background-color-dark", "#1a1a1a");
+  //script.setAttribute("data-modal-header-color-dark", "#ffffff");  
+  script.setAttribute("data-project-logo", "https://images.seeklogo.com/logo-png/45/2/kx-logo-png_seeklogo-454185.png");
+  script.setAttribute('data-modal-override-open-id', 'ask-ai-input');
+  script.setAttribute('data-modal-override-open-class', 'search-input');
+  script.setAttribute('data-modal-open-by-default', 'false');
+  //script.setAttribute('data-user-analytics-fingerprint-enabled', 'true');  
+  script.setAttribute("data-modal-z-index", "10001");
+  script.setAttribute("data-modal-size", "800px"); 
+  script.setAttribute("data-scale-factor", "0.8");   
+  script.setAttribute("data-modal-title-font-size", "18px");  
+  script.setAttribute("data-button-text-color", "#060000");
+  script.setAttribute("data-modal-disclaimer", "This is an experimental custom LLM for answering technical questions about KX products. Answers are based **only** on KX documentation and support sources, but may not be fully accurate so please use your best judgement. Don't forget to rate the answers and give feedback!");  
+  script.setAttribute("data-modal-example-questions", "How do I get started with kdb+?,What's the latest Insights features?,How do I learn q?,How do I enable kdb+ compression?");  
+  script.setAttribute("data-mcp-enabled", "true");  
+  script.setAttribute("data-mcp-server-url", "https://kx.mcp.kapa.ai");  
+  script.setAttribute("data-search-mode-enabled", "true");  
+  //script.setAttribute("data-consent-required", "true");
+  //script.setAttribute("data-user-analytics-cookie-enabled", "true");
+  //script.setAttribute("data-consent-screen-title", "Help us improve our AI assistant");
+  //script.setAttribute("data-consent-screen-disclaimer", "By clicking 'Allow tracking', you consent to anonymous user tracking which helps us improve our service. We don't collect any personally identifiable information.");
+  //script.setAttribute("data-consent-screen-accept-button-text", "Allow tracking");
+  //script.setAttribute("data-consent-screen-reject-button-text", "No, thanks");
+  script.async = true;
+  document.head.appendChild(script);
+});

mkdocs.yml

@@ -17,6 +17,7 @@ extra_javascript:
   - https://code.kx.com/scripts/tex-mml-chtml.js
   - scripts/qsearch.js # site-specific search engine
   - scripts/strip-repl-prompts.js # Removes q), >>>, and ... prompts from copied code blocks (keeps prompts visible in docs)
+  - scripts/init_kapa_widget.js    
 
 markdown_extensions:
   - abbr