Skip to content

Comments

Bump version to 0.4.1#227

Merged
svekars merged 1 commit intopytorch_sphinx_theme2from
create-new-version-0.4
Feb 11, 2026
Merged

Bump version to 0.4.1#227
svekars merged 1 commit intopytorch_sphinx_theme2from
create-new-version-0.4

Conversation

@svekars
Copy link
Contributor

@svekars svekars commented Feb 11, 2026

pytorch_sphinx_theme2 v0.4.1

New Features

  • Dropdown Navigation Menus — The horizontal navbar now supports hierarchical dropdown menus. Top-level toctree entries with children display hover-activated dropdowns on desktop. Overflow items collapse into a "More" dropdown. External URLs are supported with target="_blank" and an external link icon. Configurable via enable_navbar_dropdowns theme option (default: true).

  • LLM Discovery Support (llms.txt + Meta Tags) — Automatically generates an llms.txt file at build time listing all documentation pages as Markdown links, following the llms.txt standard. Every page also includes machine-readable tags (site-type, framework, description, version, page-type, navigation-file, sitemap). Configured via llm_domain, llm_base_path, llm_description, and llm_disabled theme options.

  • RunLLM Widget Integration — AI-powered documentation assistant widget. Enable by setting runllm_assistant_id in theme options. Additional options: runllm_name, runllm_position, runllm_keyboard_shortcut.

  • Sphinx-Tippy Parallel Build Fix — Fixes tooltip data loss when using sphinx-tippy with parallel Sphinx builds. Glossary terms are now extracted during the read phase and properly merged across workers. Configurable glossary page via tippy_glossary_page setting.

UI/Layout Improvements

  • Responsive Layout Overhaul — Wide screen content capped at max-width: 1800px with auto centering. Progressive navbar font/padding compaction across three breakpoints to prevent wrapping. Adaptive header padding (2rem desktop, 0.1rem mobile).
  • Auto-Hide Empty Sidebar — Left sidebar automatically hides via CSS when it contains no navigation items, with main content padding adjusted accordingly.
  • Smooth Scroll with TOC Locking — Custom smooth scroll animation (150ms ease-out-cubic). Clicking an anchor link locks the TOC highlight to that target until the user manually scrolls.

Bug Fixes

  • Fixed broken external links in the navigation bar
  • Fixed top padding layout issue on mobile
  • Updated PyTorch library links to include only libraries in the official PyTorch GitHub org (ExecuTorch, Helion, torchao, kineto, torchtitan, TorchRL, torchvision, torchaudio, tensordict, PyTorch on XLA Devices)

Documentation

  • Added comprehensive configuration reference documentation (~800 lines) covering all theme options with examples
    Infrastructure

Modernized CI workflows

  • Added theme build job
  • Added Netlify documentation preview support
  • Added S3 documentation preview upload

@netlify
Copy link

netlify bot commented Feb 11, 2026

Deploy Preview for pytorchsphinxtheme ready!

Name Link
🔨 Latest commit 4964c40
🔍 Latest deploy log https://app.netlify.com/projects/pytorchsphinxtheme/deploys/698cdfde9438f40008f4f297
😎 Deploy Preview https://deploy-preview-227--pytorchsphinxtheme.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@meta-cla meta-cla bot added the cla signed label Feb 11, 2026
@svekars svekars changed the title Bump version to 0.4.0 Bump version to 0.4.1 Feb 11, 2026
@svekars svekars merged commit c96442f into pytorch_sphinx_theme2 Feb 11, 2026
7 checks passed
@svekars svekars deleted the create-new-version-0.4 branch February 11, 2026 21:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants