Update link target attributes in livescript htmls

docs/source/_static/html/tutorials/basicUsage.html

@@ -428,4 +428,13 @@
 end
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

docs/source/_static/html/tutorials/behavior.html

@@ -366,4 +366,13 @@
 fprintf('Exported NWB file to "%s"\n', 'behavior_tutorial.nwb')
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

docs/source/_static/html/tutorials/dimensionMapNoDataPipes.html

@@ -89,4 +89,13 @@
 %
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

docs/source/_static/html/tutorials/dimensionMapWithDataPipes.html

@@ -107,4 +107,13 @@
 %
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

docs/source/_static/html/tutorials/dynamic_tables.html

@@ -574,4 +574,13 @@
 %
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

docs/source/_static/html/tutorials/dynamically_loaded_filters.html

@@ -138,4 +138,13 @@
 %
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

docs/source/_static/html/tutorials/ecephys.html

@@ -1353,4 +1353,13 @@
 %%
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

docs/source/_static/html/tutorials/icephys.html

@@ -506,4 +506,13 @@
 %
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

docs/source/_static/html/tutorials/images.html

@@ -368,4 +368,13 @@
 nwbExport(nwb, "images_test.nwb");
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

docs/source/_static/html/tutorials/intro.html

@@ -304,4 +304,13 @@
 % documentation> to learn what data types are available.
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

docs/source/_static/html/tutorials/ogen.html

@@ -198,4 +198,13 @@
 nwbExport(nwb, 'ogen_tutorial.nwb');
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

docs/source/_static/html/tutorials/ophys.html

@@ -476,4 +476,13 @@
 %%
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

docs/source/_static/html/tutorials/read_demo.html

@@ -353,4 +353,13 @@
 % out the DANDI breakout session later in this event.
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

docs/source/_static/html/tutorials/remote_read.html

@@ -55,4 +55,13 @@
 %
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

docs/source/_static/html/tutorials/scratch.html

@@ -161,4 +161,13 @@
 %
 ##### SOURCE END #####
 -->
-</div></body></html>
+</div><script>
+    // Update all links with href starting with "https:" to have target="top"
+    document.addEventListener("DOMContentLoaded", function() {
+        const links = document.querySelectorAll('a[href^="https:"]');
+        links.forEach(link => {
+            link.setAttribute("target", "top");
+        });
+    });
+</script>
+</body></html>

tools/documentation/private/postProcessLivescriptHtml.m

@@ -0,0 +1,54 @@
+function postProcessLivescriptHtml(htmlFile)
+    %POSTPROCESSLIVESCRIPHTML Update links in an HTML file to open in the top frame
+    % 
+    % This function reads an HTML file and updates all <a> tags with an 
+    % href attribute starting with "https:" by adding or updating the 
+    % target attribute to "top". The modified HTML content is written 
+    % back to the same file.
+    %
+    % Syntax:
+    %   postProcessLivescriptHtml(htmlFile)
+    %
+    % Input:
+    %   htmlFile - (1,1) string: Path to the HTML file to process.
+    %
+    % Example:
+    %   postProcessLivescriptHtml("example.html");
+    %
+    % This will ensure that links in "example.html" with href="https:" 
+    % open in the top frame when clicked.
+
+    % The purpose of this function is to ensure links open in the top frame
+    % and not an iframe if tutorial htmls are embedded in an iframe.
+
+    arguments
+        htmlFile (1,1) string {mustBeFile}
+    end
+
+    % Read the content of the HTML file
+    htmlContent = fileread(htmlFile);
+
+    % % Add target="top" to links with href starting with https
+    % updatedHtmlContent = regexprep(htmlContent, ...
+    %     '<a href="https://', ...
+    %     '<a target="top" href="https://');
+    % updatedHtmlContent = regexprep(updatedHtmlContent, ...
+    %     '<a href = "https://', ...
+    %     '<a target = "top" href = "https://');
+    str = fileread('update_link_target_js.html');
+    updatedHtmlContent = regexprep(htmlContent, ...
+        "</div></body></html>", ...
+        sprintf("</div>%s</body></html>", str));
+
+    % Write the modified content back to the HTML file
+    try
+        fid = fopen(htmlFile, 'wt');
+        if fid == -1
+            error('Could not open the file for writing: %s', htmlFile);
+        end
+        fwrite(fid, updatedHtmlContent, 'char');
+        fclose(fid);
+    catch
+        error('Could not write to the file: %s', htmlFile);
+    end
+end