DSPy: The framework for programming—not prompting—language models
Python
better tutorial navbar (#8912)
Chen Qiane9c36ab570d9
diff --git a/docs/docs/js/tutorial-nav.js b/docs/docs/js/tutorial-nav.jsnew file mode 100644index 000000000..e8f63bca8--- /dev/null+++ b/docs/docs/js/tutorial-nav.js@@ -0,0 +1,77 @@+document.addEventListener('DOMContentLoaded', function () {+ // Only run on the tutorials page+ const isTutorialsPage = window.location.pathname.includes('/tutorials');++ if (isTutorialsPage) {+ collapseTutorialNav();+ }++ function collapseTutorialNav() {+ // Find the navigation sidebar+ const navSidebar = document.querySelector('.md-sidebar--primary');+ if (!navSidebar) return;++ // Find the 'Tutorials' section in the navigation+ const tutorialsSection = Array.from(+ navSidebar.querySelectorAll('.md-nav__item')+ ).find((item) => {+ const linkSpan = item.querySelector('.md-nav__link .md-ellipsis');+ return linkSpan && linkSpan.textContent.trim() === 'Tutorials';+ });++ if (!tutorialsSection) return;++ // Find all nested subsections under Tutorials (level 2)+ const tutorialsNav = tutorialsSection.querySelector(+ '.md-nav[data-md-level="1"]'+ );+ if (!tutorialsNav) return;++ const subsections = tutorialsNav.querySelectorAll(+ ':scope > .md-nav__list > .md-nav__item.md-nav__item--nested'+ );++ subsections.forEach((subsection) => {+ // Find the nested navigation (level 2)+ const nestedNav = subsection.querySelector('.md-nav[data-md-level="2"]');+ if (!nestedNav) return;++ const nestedList = nestedNav.querySelector('.md-nav__list');+ if (!nestedList) return;++ const items = Array.from(+ nestedList.querySelectorAll(':scope > .md-nav__item')+ );++ // Limit to 3 items visible+ const maxVisibleItems = 3;++ if (items.length > maxVisibleItems) {+ // Hide items beyond the limit+ items.slice(maxVisibleItems).forEach((item) => {+ item.style.display = 'none';+ });++ // Get the category link to determine the 'More tutorials' URL+ const categoryLink = subsection.querySelector(+ ':scope > .md-nav__container > a.md-nav__link, :scope > a.md-nav__link'+ );+ const categoryUrl = categoryLink+ ? categoryLink.getAttribute('href')+ : '#';++ // Create and add 'More tutorials' link+ const moreTutorialsItem = document.createElement('li');+ moreTutorialsItem.className = 'md-nav__item learn-more-item';++ const moreTutorialsLink = document.createElement('a');+ moreTutorialsLink.className = 'md-nav__link';+ moreTutorialsLink.href = categoryUrl;+ moreTutorialsLink.textContent = 'More tutorials →';++ moreTutorialsItem.appendChild(moreTutorialsLink);+ nestedList.appendChild(moreTutorialsItem);+ }+ });+ }+});diff --git a/docs/docs/stylesheets/extra.css b/docs/docs/stylesheets/extra.cssindex 88f361d14..fc1c3cf78 100644--- a/docs/docs/stylesheets/extra.css+++ b/docs/docs/stylesheets/extra.css@@ -235,3 +235,16 @@ h2.doc-heading {color: var(--md-accent-fg-color);}+/* Tutorial navigation "Learn more" styling */+.learn-more-item .md-nav__link {+ font-style: italic;+ opacity: 0.85;+ font-size: 0.9em;+ transition: opacity 0.2s ease;+}++.learn-more-item .md-nav__link:hover {+ opacity: 1;+ text-decoration: underline;+}+diff --git a/docs/mkdocs.yml b/docs/mkdocs.ymlindex e66539821..ac983a75b 100644--- a/docs/mkdocs.yml+++ b/docs/mkdocs.yml@@ -299,6 +299,7 @@ extra:extra_javascript:- "js/runllm-widget.js"+ - "js/tutorial-nav.js"markdown_extensions:- toc: