Add toc.integrate and unlink content tabs

Netdocs · Copilot · Netdocs · commit b4eeb8a002f5 · 2026-07-21T23:22:43.000-05:00
- Implement Material's toc.integrate: when the feature is set, the page
  table of contents is nested under the active page inside the left
  navigation and the separate right-hand TOC sidebar is dropped, so a
  single sidebar drives navigation. Enable it on the docs-site.
- Remove content.tabs.link: matching tab labels (Result/Markdown) were
  being synced site-wide, so switching one example's tab switched them
  all. Tab sets are now independent.

Co-authored-by: Copilot &lt;223556219+Copilot@users.noreply.github.com&gt;
diff --git a/docs-site/appsettings.json b/docs-site/appsettings.json
@@ -37,8 +37,8 @@
         "search.highlight",
         "search.share",
         "content.code.copy",
-        "content.tabs.link",
-        "toc.follow"
+        "toc.follow",
+        "toc.integrate"
       ]
     },
 
diff --git a/src/Netdocs.Theme.Material/templates/main.html b/src/Netdocs.Theme.Material/templates/main.html
@@ -48,13 +48,15 @@
             {{ render_nav c (path + "_" + (for.index + 1)) (level + 1) }}
           {{~ end ~}}
         </ul>
+        {{~ if toc_integrate && node.section_index && node.section_index.url == page.url ~}}{{ render_integrated_toc }}{{~ end ~}}
       </nav>
     </li>
   {{~ else ~}}
     <li class="md-nav__item{{ if active }} md-nav__item--active{{ end }}">
       <a href="{{ base_url }}{{ node.url }}" class="md-nav__link{{ if active }} md-nav__link--active{{ end }}">
         <span class="md-ellipsis">{{ node.title }}</span>
       </a>
+      {{~ if toc_integrate && node.url == page.url ~}}{{ render_integrated_toc }}{{~ end ~}}
     </li>
   {{~ end
 end
@@ -69,7 +71,22 @@
     </nav>
     {{~ end ~}}
   </li>
-{{~ end ~}}
+{{~ end
+func render_integrated_toc()
+  toc_root = toc
+  if toc && (array.size toc) > 0 && toc[0].level == 1
+    toc_root = toc[0].children
+  end
+  if toc_root && (array.size toc_root) > 0 ~}}
+  <nav class="md-nav md-nav--secondary" aria-label="Table of contents" data-md-level="0">
+    <label class="md-nav__title" for="__toc"><span class="md-nav__icon md-icon"></span>Table of contents</label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      {{~ for entry in toc_root ~}}{{ render_toc entry }}{{~ end ~}}
+    </ul>
+  </nav>
+  {{~ end
+end
+toc_integrate = features | array.contains "toc.integrate" ~}}
 <!doctype html>
 <html lang="{{ config.theme.language }}" class="no-js">
   <head>
@@ -143,13 +160,15 @@
               </div>
             </div>
           </div>
+          {{~ if !toc_integrate ~}}
           <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc">
             <div class="md-sidebar__scrollwrap">
               <div class="md-sidebar__inner">
                 {{ include "partials/toc.html" }}
               </div>
             </div>
           </div>
+          {{~ end ~}}
           <div class="md-content" data-md-component="content">
             <article class="md-content__inner md-typeset">
 {{~ if (features | array.contains "navigation.path") && breadcrumbs && (array.size breadcrumbs) > 0 ~}}
