quickstart guide

Author: AndreiKingsley

build.gradle.kts

@@ -150,6 +150,7 @@ val modulesUsingJava11 = with(projects) {
         dataframeJupyter,
         dataframeGeo,
         examples.ideaExamples.titanic,
+        tests,
     )
 }.map { it.path }
 

docs/StardustDocs/cfg/buildprofiles.xml

@@ -16,6 +16,7 @@
         <analytics-head-script-file>resize-iframes.js</analytics-head-script-file>
         <enable-browser-edits>true</enable-browser-edits>
         <browser-edits-url>https://github.com/Kotlin/dataframe/edit/master/docs/StardustDocs/</browser-edits-url>
+        <include-in-head>include-head.html</include-in-head>
     </variables>
     <sitemap change-frequency="monthly"/>
     <build-profile instance="d">

docs/StardustDocs/cfg/include-head.html

@@ -0,0 +1 @@
+<script src="static/custom.js"></script>

docs/StardustDocs/cfg/static/custom.js

@@ -0,0 +1,76 @@
+window.addEventListener('load', function () {
+    function sendTheme(theme, iframe) {
+        const maxAttempts = 10;
+        const interval = 200; // 200ms
+        let attempts = 0;
+
+        function attemptSend() {
+            if (attempts >= maxAttempts) return;
+            iframe.contentWindow.postMessage({ type: 'setTheme', theme }, '*');
+            attempts++;
+        }
+
+        attemptSend();
+        const intervalId = setInterval(() => {
+            attemptSend();
+            if (attempts >= maxAttempts) clearInterval(intervalId);
+        }, interval);
+    }
+
+    function setIframeHeight(iframe, height) {
+        iframe.style.height = height + 'px';
+    }
+
+    const htmlElement = document.documentElement;
+
+    function getCurrentTheme() {
+        return htmlElement.classList.contains('theme-light') ? 'light' : 'dark';
+    }
+
+    window.addEventListener('message', (event) => {
+        if (event.data.type === 'iframeHeight') {
+            document.querySelectorAll('iframe').forEach((iframe) => {
+                if (iframe.contentWindow === event.source) {
+                    setIframeHeight(iframe, event.data.height);
+                }
+            });
+        }
+    });
+
+    function updateAllIframeThemes() {
+        const theme = getCurrentTheme();
+        document.querySelectorAll('iframe').forEach((iframe) => {
+            if (iframe.contentWindow) {
+                sendTheme(theme, iframe);
+            }
+        });
+    }
+
+    const observer = new MutationObserver(() => {
+        updateAllIframeThemes();
+    });
+
+    observer.observe(htmlElement, { attributes: true });
+
+    function observeIframeLoad(iframe) {
+        iframe.addEventListener('load', () => sendTheme(getCurrentTheme(), iframe));
+        if (iframe.contentDocument && iframe.contentDocument.readyState === 'complete') {
+            sendTheme(getCurrentTheme(), iframe);
+        }
+    }
+
+    document.querySelectorAll('iframe').forEach(observeIframeLoad);
+
+    const bodyObserver = new MutationObserver((mutations) => {
+        mutations.forEach((mutation) => {
+            mutation.addedNodes.forEach((node) => {
+                if (node.tagName === 'IFRAME') observeIframeLoad(node);
+                else if (node.querySelectorAll) node.querySelectorAll('iframe').forEach(observeIframeLoad);
+            });
+        });
+    });
+
+    bodyObserver.observe(document.body, { childList: true, subtree: true });
+
+    updateAllIframeThemes();
+});

docs/StardustDocs/d.tree

@@ -5,8 +5,14 @@
 <instance-profile id="d"
                  name="Dataframe"
                  status="release"
-                 start-page="overview.md">
+                 start-page="Home.topic">
+    <toc-element topic="Home.topic"/>
+    <toc-element topic="Guides.md">
+        <toc-element topic="quickstart.md"/>
+    </toc-element>
+
     <toc-element topic="gettingStarted.md" accepts-web-file-names="installation.html">
+        <toc-element topic="gettingStartedKotlinNotebook.md"/>
         <toc-element topic="gettingStartedGradle.md"/>
         <toc-element topic="gettingStartedJupyterNotebook.md"/>
         <toc-element topic="gettingStartedDatalore.md"/>
@@ -192,4 +198,5 @@
         <toc-element topic="Trobleshooting.md"/>
     </toc-element>
     <toc-element href="https://github.com/Kotlin/dataframe/tree/master/examples" toc-title="Examples"/>
+    <toc-element topic="_shadow_resources.md" hidden="true"/>
 </instance-profile>